Pull request #1880: J742s2 config

Merge in PROCESSOR-SDK/processor-sdk-doc from PROCESSOR-SDK-VISION/psdk-doc-jacinto-fork:j742s2_config to master

* commit 'af0414c49e4f922c048d7e7f4296ff7d8a5f5538':
  J742S2: Add a new CONFIG_part_variant to differentiate from J784S4
  J742S2: Introduce new DEVFAMILY
  source: Kernel_Drivers: SERDES: Fix Clock Ids link for j784s4
  source: Kernel_Drivers: SERDES: Fix indentation

Author: aniket-l

configs/J742S2/J742S2_linux_config.txt

@@ -0,0 +1,43 @@
+# Jacinto 7 replacement variables and configuration values for Linux build
+
+# This file is processed by Python scripts to define both replacement
+# variable and configuration values for a device family build.
+# For replacement variables, all variables should be listed on a single
+# line, and all the variables should be listed on consecutive lines
+# (i.e. no additional blank lines between the replacement variables).
+# Similarly, all the configuration values should be listed on individual,
+# consecutive lines (with no blank linues between the configuration values).
+#
+# Note that neither replacement variables nor configuration values may contain
+# a colon (i.e. ":") in their name.  However, values may contain colons.
+
+Replacement Variables
+---------------------
+'__PART_FAMILY_NAME__'           : 'J742S2'
+'__PART_FAMILY_DEVICE_NAMES__'   : 'J742S2'
+'__PRODUCT_LINE_NAME__'          : 'Jacinto'
+'__SDK_BUILD_MACHINE__'          : 'j742s2-evm'
+'__SDK_FULL_NAME__'              : 'Processor SDK Linux J742s2'
+'__SDK_SHORT_NAME__'             : 'JACINTO'
+'__SDK_INSTALL_FILE__'           : 'ti-processor-sdk-linux-j742s2-evm-<version>-Linux-x86-Install.bin'
+'__SDK_INSTALL_DIR__'            : 'ti-processor-sdk-linux-j742s2-evm-<version>'
+'__SDK_DOWNLOAD_URL__'           : '`Jacinto7-Linux-SDK-Download-page <http://software-dl.ti.com/jacinto7/esd/processor-sdk-linux-j742s2/latest/index_FDS.html>`__'
+'__LINUX_UBUNTU_VERSION_LONG__'  : '22.04 (64-bit)'
+'__LINUX_UBUNTU_VERSION_SHORT__' : '22.04'
+'__OPTEE_PLATFORM_FLAVOR__'      : 'j784s4'
+'__RTOS_UBUNTU_VERSION_LONG__'   : '22.04 (64-bit)'
+'__WINDOWS_SUPPORTED_LONG__'     : '7 (64-bit)'
+'__FEATURINGMATRIX__'            : \
+'__SYSFW_CORE_NAME__'            : 'TIFS'
+'__PCIE_BASE_ADDRESS__'          : '2900000'
+'__PCIE_DEVICE_ID__'             : '0xb00d'
+
+Configuration Values
+--------------------
+'CONFIG_part_family'      : 'J7_family'
+'CONFIG_part_variant'     : 'J742S2'
+'CONFIG_sdk'              : 'JACINTO'
+'CONFIG_icss_support'     : 'no'
+'CONFIG_rt_linux_support' : 'yes'
+'CONFIG_gpu_ip'           : 'Rogue_BXS'
+'CONFIG_crypto'           : 'sa2ul'

configs/J742S2/J742S2_linux_tags.py

@@ -0,0 +1,17 @@
+# Device Family is J742S2
+fam_name = 'J742S2'
+
+# Project name and HTML title
+sdk_product = 'null' #todo: remove after the new structure is used for all device families
+project = u'Processor SDK Linux for J742s2'
+html_title = 'Processor SDK Linux for J742s2 Documentation'
+
+# The master toctree document.
+master_doc = 'devices/J7_Family/linux/index'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ['rtos', 'android', 'linux/index.rst', 'devices/AM335X', 'devices/AM437X', 'devices/AM64X', 'devices/AM65X', 'devices/DRA821A', 'devices/AM62X', 'devices/AM62AX', 'devices/AM62PX']
+
+# OS for the build. Sphinx uses source/{sdk_os} when looking for doc inputs
+sdk_os = 'linux'

configs/J742S2/J742S2_linux_toc.txt

@@ -0,0 +1,132 @@
+linux/Overview
+linux/Overview_Getting_Started_Guide
+linux/Overview_Building_the_SDK
+linux/Overview_Top_Level_Makefile
+linux/Overview_Directory_Structure_Overview
+linux/Overview_PSDKLA_PSDKRA_Summary
+linux/Overview_Technical_Support
+linux/Overview_GPLv3_Disclaimer
+linux/Overview/Download_and_Install_the_SDK
+linux/Overview/Run_Setup_Scripts
+linux/Overview/GCC_ToolChain
+linux/Overview/Processor_SDK_Linux_create_SD_card
+devices/J7_Family/linux/index
+devices/J7_Family/linux/Release_Specific
+devices/J7_Family/linux/Release_Specific_Release_Notes
+devices/J7_Family/linux/Release_Specific_Yocto_layer_Configuration
+devices/J7_Family/linux/Release_Specific_Migration_Guide
+devices/J7_Family/linux/Release_Specific_Performance_Guide
+devices/J7_Family/linux/Release_Specific_Supported_Platforms_and_Versions
+devices/J7_Family/linux/Release_Specific_QSG
+linux/Foundational_Components
+linux/Foundational_Components_U-Boot
+linux/Foundational_Components/U-Boot/Release-Notes
+linux/Foundational_Components/U-Boot/Users-Guide
+linux/Foundational_Components/U-Boot/UG-General-Info
+linux/Foundational_Components/U-Boot/UG-DFU
+linux/Foundational_Components/U-Boot/UG-Network
+linux/Foundational_Components/U-Boot/UG-NAND
+linux/Foundational_Components/U-Boot/UG-Memory
+linux/Foundational_Components/U-Boot/UG-SPI
+linux/Foundational_Components/U-Boot/UG-QSPI
+linux/Foundational_Components/U-Boot/UG-NOR
+linux/Foundational_Components/U-Boot/UG-UART
+linux/Foundational_Components/U-Boot/UG-SATA
+linux/Foundational_Components/U-Boot/UG-UFS
+linux/Foundational_Components/U-Boot/UG-DDRSS-J7
+linux/Foundational_Components/U-Boot/UG-HyperBus
+linux/Foundational_Components/U-Boot/UG-RemoteProc
+linux/Foundational_Components/U-Boot/Applications
+linux/Foundational_Components/U-Boot/Apps-SPL-Debug
+linux/Foundational_Components/U-Boot/Apps-Load-in-CCS
+linux/Foundational_Components/U-Boot/Apps-TroubleShooting
+linux/Foundational_Components_Kernel
+linux/Foundational_Components_Kernel_Drivers
+linux/Foundational_Components/Kernel/Kernel_Drivers/ADC
+linux/Foundational_Components/Kernel/Kernel_Drivers/Audio
+linux/Foundational_Components/Kernel/Kernel_Drivers/Camera/CSI2RX
+linux/Foundational_Components/Kernel/Kernel_Drivers/Crypto
+linux/Foundational_Components/Kernel/Kernel_Drivers/Display/DSS7
+linux/Foundational_Components/Kernel/Kernel_Drivers/GPIO
+linux/Foundational_Components/Kernel/Kernel_Drivers/HYPERFLASH
+linux/Foundational_Components/Kernel/Kernel_Drivers/I2C
+linux/Foundational_Components/Kernel/Kernel_Drivers/MCAN
+linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSW-Ethernet
+linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSW2g
+linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSWng
+linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSW-Proxy-Client
+linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSWng-Native-Ethernet
+linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSW-TSN
+linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSW-PTP
+linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSW-EST
+linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSW-CBS
+linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSW-IET
+linux/Foundational_Components/Kernel/Kernel_Drivers/Network/CPSW-TSN-Tuning
+linux/Foundational_Components/Kernel/Kernel_Drivers/PCIe/PCIe_End_Point
+linux/Foundational_Components/Kernel/Kernel_Drivers/PCIe/PCIe_Backplane
+linux/Foundational_Components/Kernel/Kernel_Drivers/PCIe/PCIe_Root_Complex
+linux/Foundational_Components/Kernel/Kernel_Drivers/PMIC/pmic_tps6594
+linux/Foundational_Components/Kernel/Kernel_Drivers/Power_Management
+linux/Foundational_Components/Kernel/Kernel_Drivers/Power_Management/pm_dfs
+linux/Foundational_Components/Kernel/Kernel_Drivers/QSPI
+linux/Foundational_Components/Kernel/Kernel_Drivers/SERDES/SERDES
+linux/Foundational_Components/Kernel/Kernel_Drivers/SPI
+linux/Foundational_Components/Kernel/Kernel_Drivers/Storage/NAND
+linux/Foundational_Components/Kernel/Kernel_Drivers/Storage/MMC-SD
+linux/Foundational_Components/Kernel/Kernel_Drivers/UART
+linux/Foundational_Components/Kernel/Kernel_Drivers/UFS
+linux/Foundational_Components/Kernel/Kernel_Drivers/USB/CDNS3
+linux/Foundational_Components/Kernel/Kernel_Drivers/VTM
+linux/Foundational_Components_Kernel_Users_Guide
+linux/Foundational_Components_Kernel_LTP-DDT_Validation
+linux/Foundational_Components_Kernel_FAQs
+linux/Foundational_Components_Filesystem
+linux/Foundational_Components_Tools
+linux/Foundational_Components/Tools/Development_Tools
+linux/Foundational_Components/Tools/Flash_Tools
+linux/Foundational_Components/Tools/SysConfig_Tools
+linux/Foundational_Components/Tools/Code_Composer_Studio
+linux/Foundational_Components_IPC_J742S2
+linux/Foundational_Components_Virtualization
+linux/Foundational_Components/Virtualization/Docker
+linux/Foundational_Components_OPTEE
+linux/Foundational_Components_ATF
+linux/Foundational_Components_Multimedia_Other_Tools
+linux/Foundational_Components_Multimedia_wave5
+
+linux/Foundational_Components_Graphics
+linux/Foundational_Components/Graphics/Common/Display
+linux/Foundational_Components/Graphics/Common/GTK+_Graphics_Framework
+linux/Foundational_Components/Graphics/Common/OpenGL_ES
+linux/Foundational_Components/Graphics/Common/PVR_Tools
+linux/Foundational_Components/Graphics/Common/QT_Graphics_Framework
+linux/Foundational_Components/Graphics/Common/Vulkan
+linux/Foundational_Components/Graphics/Common/Weston
+linux/Foundational_Components/Graphics/Rogue/Overview
+linux/Foundational_Components/Graphics/Rogue/Rogue_Debug_Info
+linux/Foundational_Components/Graphics/Rogue/Rogue_Power_Management_Info
+
+linux/How_to_Guides
+linux/How_to_Guides_Developer_Notes
+linux/How_to_Guides/Host/Connect_to_an_EVM_via_Telnet
+linux/How_to_Guides/Host/How_to_Setup_a_Samba_Server
+linux/How_to_Guides/Host/Boot_Sequence
+linux/How_to_Guides/Host/Moving_Files_to_the_Target_System
+linux/How_to_Guides/Host/How_to_Flash_Linux_System_from_U-boot
+linux/How_to_Guides/Host/K3_Resource_Partitioning_Tool
+linux/How_to_Guides/Target/Processor_SDK_Linux_File_System_Optimization_Customization
+linux/How_to_Guides/Target/How_to_Change_dtb_File
+linux/How_to_Guides/Target/How_to_enable_DT_overlays_in_linux
+linux/How_to_Guides/Target/How_to_flash_emmc_device
+linux/How_to_Guides/Target/How_to_visualize_statistics_data
+linux/How_to_Guides/Target/How_to_Use_K3Conf_Tool
+linux/How_to_Guides/Target/How_to_Tune_Real_Time_Linux
+linux/How_to_Guides/FAQ/How_to_Verify_Ipc_Linux_R5
+linux/How_to_Guides/FAQ/How_to_Configure_MSMC_memory
+linux/How_to_Guides/FAQ/How_to_Check_Device_Tree_Info
+linux/How_to_Guides/FAQ/Tda4_Latest_FAQs
+linux/How_to_Guides/FAQ/How_to_Integrate_Open_Source_Software
+linux/How_to_Guides/Host/How_to_Build_a_Ubuntu_Linux_host_under_VMware
+linux/How_to_Guides_Hardware_Setup_with_CCS
+linux/How_to_Guides/Hardware_Setup_with_CCS/J742S2_EVM_Hardware_Setup
+linux/Documentation_Tarball

source/common/EVM_Hardware_Setup/_J742S2_EVM_Hardware_Setup.rst

@@ -0,0 +1,114 @@
+J742S2 EVM Hardware Setup
+====================================================
+
+.. rubric:: Description
+
+The J742S2 Evaluation Module provides an affordable platform to quickly
+start evaluation of Jacinto™ DRA8xx Processors and accelerate development
+for ADAS, Gateway and many other edge analytics applications.
+
+.. rubric:: J742S2 EVM
+
+Whereas other J7 family boards consist of a Common Processor Board plus SOM, the J742S2 Evaluation Module (EVM) has these
+two components combined into a single board. The J742S2 EVM is the main board which includes the following:
+
+- J742S2 SoC
+- Leo PMIC (Power controller)
+- 16 (2x8) GiB LPDDR4 RAM
+- XSPI NOR flash
+
+In addition, the J742S2 EVM has peripherals to provide most common functionality. It has expander ports to
+connect to different adapter cards. Following is the image of the EVM with the J742S2 SoC:
+
+.. figure:: /images/j742s2_evm_front.png
+   :scale: 75%
+
+   J742S2 EVM Front
+
+.. figure:: /images/j742s2_evm_back.png
+   :scale: 75%
+
+   J742S2 EVM Back
+
+Contents of the board
+
+#. 4xUART to USB port for Main uarts
+
+   - Port0 from this is used this for Linux, RTOS UART terminal from A72
+
+#. 2xUART to USB port MCU domain uarts
+
+   - Port0 from this is used for Cortex M4F UART
+   - Port1 from this is used for MCU R5F UART
+
+#. 6x CAN FD Interfaces
+#. MCU Domain Ethernet (CPSW2G) port
+#. Main Domain Ethernet (CPSW2G) port
+#. MIPI JTAG connector
+#. SD card slot
+#. XDS110 on board USB JTAG connector
+#. USB Host ports
+#. Quad Port Ethernet daughter card (bottom of EVM) **sold separately**
+#. 2x Display (eDP/DP) ports
+
+   - Display0 is used by software for eDP/DP output
+
+#. USBC port
+#. 12V Power input
+#. Power switch
+
+Refer to `EVM connections <J742S2_EVM_Hardware_Setup.html#evm-connections>`__
+for detailed information regarding connecting peripherals to the EVM
+
+.. rubric:: Switch settings
+
+Bootmodes are selected using the SW11 and SW7 switches on the EVM.
+Most common boot method is to use SD card. Following are the switch settings to
+set the boot mode to SD for the EVM.
+
+   SW11[1-8] = 1000 0010
+   SW7[1-8]  = 0000 0000
+
+.. Image:: /images/K3-J784S4-EVM-Switch-SD-boot.png
+
+When you want the binaries to be loaded from a debugger like CCS, the common
+processor boards has to be set in the NO boot mode.  Following are the switch settings
+to do the same.
+
+   SW11[1-8] = 1000 1000
+   SW7[1-8]  = 0111 0000
+
+.. Image:: /images/K3-J784S4-EVM-Switch-NO-boot.png
+
+.. rubric:: EVM connections
+
+Connect Following peripherals for working with processor SDK Linux
+
+1. MAIN_UART is a USB connector to connect 4x main UART devices,
+   this will register /dev/ttyUSB[0-3] in your Linux machine.
+2. MCU_UART is a USB connector to connect 2x mcu UART devices.
+   this will register /dev/ttyUSB[4-5] in your Linux machine.
+
+.. note::
+    Connect the MAIN_UART and MCU_UART in order so that the device numbers
+    are assigned correctly.
+
+3. Connect a Display Port 1080p monitor to the Display0 port of the
+   commonProcBoard.
+
+.. note::
+    Only the monitor with preferred resolution as 1080p shall
+    be used, any other resolution is not supported.
+
+4. Connect ethernet at the RJ45 connector in the commonProcBoard as shown.
+5. Insert micro SD card at the slot shown in the "J742S2 EVM Back" image
+6. Connect the XDS110 connector if you want to run RTOS demos or use CCS.
+7. Connect a 1080p HDMI monitor to the HDMI port on the Infotainment
+   daughter card.
+
+.. note::
+    For Linux demos, keep the bootswitch settings in SD mode
+    For Gateway demos, keep the bootswitch settings in noboot mode
+
+8. Connect a 12V power supply
+9. Power on the board

source/devices/J7_Family/linux/Release_Specific_Supported_Platforms_and_Versions.rst

@@ -98,6 +98,15 @@ The following platforms and EVMs are supported with Processor SDK.
       |    AM69A     | AM69A SK   |   Alpha   | Hardware User's Guide | Y                 | Y                |
       +--------------+------------+-----------+-----------------------+-------------------+------------------+
 
+   .. ifconfig:: CONFIG_part_variant in ('J742S2')
+
+      +--------------+------------+-----------+-----------------------+-------------------+------------------+
+      | **Platform** | **EVM**    | **Tested  | **Document**          | **Processor SDK   | **Processor SDK  |
+      |              |            | Version** |                       | Linux**           | RTOS**           |
+      +--------------+------------+-----------+-----------------------+-------------------+------------------+
+      |    J742s2    | J742s2 EVM |   Alpha   | Hardware User's Guide | Y                 | Y                |
+      +--------------+------------+-----------+-----------------------+-------------------+------------------+
+
    .. ifconfig:: CONFIG_part_variant in ('J722S')
 
       +--------------+------------+-----------+-----------------------+-------------------+------------------+

source/devices/J7_Family/linux/_Release_Specific_QSG.rst

@@ -29,14 +29,14 @@ Detailed steps are described at :ref:`run-setup-scripts`
 
 .. ifconfig:: CONFIG_sdk in ('JACINTO')
 
-   .. ifconfig:: CONFIG_part_variant not in ('J784S4')
+   .. ifconfig:: CONFIG_part_variant not in ('J784S4','J742S2')
 
       The J7 EVM comes with a SoM (System on Chip) based on which J7 variant is being used,
       a common processor board, a PMIC and a few optional daughter cards.
 
-   .. ifconfig:: CONFIG_part_variant in ('J784S4')
+   .. ifconfig:: CONFIG_part_variant in ('J784S4','J742S2')
 
-      The J784S4 EVM comes with the main J784S4 EVM board, a PMIC and a few optional daughter cards.
+      The |__PART_FAMILY_NAME__| EVM comes with the main |__PART_FAMILY_NAME__| EVM board, a PMIC and a few optional daughter cards.
 
 Detailed instructions for EVM setup with image illustration can be found at
 :ref:`hardware-evm-setup`.

source/images/j742s2_evm_back.png

@@ -18,6 +18,7 @@ Foundational Components
    Foundational_Components_IPC_J7200
    Foundational_Components_IPC_J721E
    Foundational_Components_IPC_J784S4
+   Foundational_Components_IPC_J742S2
    Foundational_Components_IPC_J722S
    Foundational_Components_IPC62x
    Foundational_Components_IPC62ax