feat(linux): Initial documentation support for AM62L platform. #161

sadik-smd · 2025-02-11T09:17:45Z

This PR adds the necessary source files in configs/ and sources/
and the README for AM62L platform. Taking reference
from existing AM62Px platform structure and updating it
accordingly for the AM62L.

Signed-off-by: sadik <s-sadik@ti.com>

github-actions · 2025-02-11T09:18:48Z

New warnings found with rstcheck:

source/devices/AM62L/index.rst:9: (SEVERE/4) Problems with "include" directive path:
source/devices/AM62L/index.rst:26: (SEVERE/4) Problems with "include" directive path:
source/devices/AM62L/linux/Release_Specific_Release_Notes.rst:5: (INFO/1) Duplicate implicit target name: "u-boot".
source/devices/AM62L/linux/Release_Specific_Workarounds.rst:4: (INFO/1) Duplicate implicit target name: "workarounds".
source/devices/AM62L/linux/Release_Specific_Migration_Guide.rst:27: (INFO/1) Duplicate implicit target name: "processor sdk 11.00".
source/devices/AM62L/linux/Overview/Download_and_Install_the_SDK.rst:11: (ERROR/3) Malformed table.

cshilwant · 2025-02-11T13:59:30Z

configs/AM62L/AM62L_linux_config.txt

+'__SDK_SHORT_NAME__'             : 'PSDK'
+'__SDK_INSTALL_FILE__'           : 'ti-processor-sdk-linux-am62lxx-evm-<version>-Linux-x86-Install.bin'
+'__SDK_INSTALL_DIR__'            : 'ti-processor-sdk-linux-am62lxx-evm-<version>'
+'__SDK_DOWNLOAD_URL__'           : '`AM62L-SDK-Download-page <https://www.ti.com/tool/PROCESSOR-SDK-AM62L>`__'


This won't be PROCESSOR-SDK-AM62L. It would be AM62L-LINUX-SDK as per new convention

@VeeruPrudhvi Can you confirm the above

cshilwant · 2025-02-11T14:00:09Z

configs/AM62L/AM62L_linux_config.txt

+'CONFIG_image_type'       : 'default'
+'CONFIG_icss_support'     : 'yes'
+'CONFIG_rt_linux_support' : 'yes'
+'CONFIG_gpu_ip'           : 'Rogue_BXS'


CONFIG_gpu_ip can be dropped as AM62L doesn't have a GPU

cshilwant · 2025-02-11T14:01:17Z

configs/AM62L/AM62L_linux_tags.py

+# 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 AM62L'


I guess this would be Linux SDK for AM62L as per the new convention

@praneethbajjuri @VeeruPrudhvi to confirm

cshilwant · 2025-02-11T14:02:44Z

configs/AM62L/AM62L_linux_toc.txt

+linux/Foundational_Components/Virtualization/Docker
+linux/Foundational_Components_Hypervisor
+linux/Foundational_Components/Hypervisor/Jailhouse
+


Graphics is not applicable for AM62L.
So, Line 117 to 128 can be dropped

cshilwant · 2025-02-11T14:03:55Z

configs/AM62L/AM62L_linux_toc.txt

+linux/How_to_Guides/FAQ/How_to_Integrate_Open_Source_Software
+linux/How_to_Guides_Hardware_Setup_with_CCS
+linux/How_to_Guides/Hardware_Setup_with_CCS/AM62L_EVM_Hardware_Setup
+


system/Demo_User_Guides/TI_Apps_Launcher_User_Guide

system/Demo_User_Guides/Seva_Store

system/Demo_User_Guides/Display_Cluster_User_Guide

system/Demo_User_Guides/Chromium_Browser

All above can be dropped

cshilwant · 2025-02-11T14:06:15Z

source/devices/AM62L/linux/Overview/Run_Setup_Scripts.rst

+    .. code-block:: text
+
+        In which directory do you want to install the target filesystem?(if this directory does not exist it will be created)
+        [ /home/user/ti-processor-sdk-linux-am62pxx-evm-<version>/targetNFS ]


Suggested change

[ /home/user/ti-processor-sdk-linux-am62pxx-evm-<version>/targetNFS ]

[ /home/user/ti-processor-sdk-linux-am62lxx-evm-<version>/targetNFS ]

cshilwant · 2025-02-11T14:08:03Z

source/devices/AM62L/linux/Release_Specific_Release_Notes.rst

+-  Linux Manifest:  :file:`<PSDK_PATH>/docs/software_manifest.html`
+
+
+Release 11.00


Drop everything from Line 39 until end.
This will be added at the time of release

cshilwant · 2025-02-11T14:08:55Z

source/devices/AM62L/linux/Release_Specific_Migration_Guide.rst

+
+This page covers migration information for applications built on top
+of the Processor SDK Linux AM62L.
+


Drop everything from Line 12 until end.
This will be added at the time of release

cshilwant · 2025-02-11T14:09:19Z

source/devices/AM62L/linux/Release_Specific_Workarounds.rst

Drop this file

cshilwant · 2025-02-11T14:09:45Z

source/devices/AM62L/linux/_Release_Specific_PLL.rst

Drop this file

praneethbajjuri · 2025-02-11T14:20:45Z

@jmenti , @sskartheekadivi , @bryanbrattlof
To review

cshilwant · 2025-02-11T14:23:15Z

@paresh-bhagat12 @jsuhaas22 @jeevantelukula @VeeruPrudhvi for reviews

cshilwant · 2025-02-11T16:54:16Z

source/devices/AM62L/linux/Overview/Download_and_Install_the_SDK.rst

+
+.. note::
+   Processor SDK Linux AM62Px contains only the Linux specific source and application intended
+   to runs on A53/Linux core. For R5F and RTOS/NO-RTOS side source and applications, refer **MCU+ SDK**


There's no R5 core in AM62L.

This can be reframed as,

Suggested change

to runs on A53/Linux core. For R5F and RTOS/NO-RTOS side source and applications, refer **MCU+ SDK**

to run on A53/Linux core. For A53 based FreeRTOS side source and applications, refer **MCU+ SDK**

jeevantelukula · 2025-02-12T05:48:32Z

configs/AM62L/AM62L_buildroot_toc.txt

@@ -0,0 +1,6 @@
+devices/AM62X/buildroot/index
+devices/AM62X/buildroot/Getting_Started_Guide
+


It should be devices/AM62L here.

jeevantelukula · 2025-02-12T05:51:19Z

configs/AM62X/AM62X_buildroot_toc.txt

-devices/AM62X/buildroot/index
-devices/AM62X/buildroot/Getting_Started_Guide
+devices/AM62L/buildroot/index
+devices/AM62L/buildroot/Getting_Started_Guide



No changes required for this file

jeevantelukula · 2025-02-12T05:53:39Z

source/devices/AM62L/index_Applications.rst

+   /system/Demo_User_Guides/TI_Apps_Launcher_User_Guide
+   /system/Demo_User_Guides/Seva_Store
+   /system/Demo_User_Guides/Display_Cluster_User_Guide
+   /system/Demo_User_Guides/Chromium_Browser


#161 (comment)

jeevantelukula · 2025-02-12T05:55:53Z

source/devices/AM62L/index_RTOS.rst

+
+**For MCU+ SDK RTOS/NO-RTOS documentation, refer below links**
+
+-  `MCU+ SDK Documentation <https://software-dl.ti.com/mcu-plus-sdk/esd/AM62PX/10_01_00_33/exports/docs/api_guide_am62px/index.html>`__


I dont think this file is needed.

bryanbrattlof · 2025-02-12T20:19:35Z

source/devices/AM62L/linux/RT_Linux_Performance_Guide.rst

+----------------+---------------------------------------------------------------------------------------------------+
+| Name           | Description                                                                                       |
+================+===================================================================================================+
+| AM62L EVM      | AM62L Starter Kit rev E1 with ARM running at 1200MHz, LPDDR4 data rate 3200 MT/S                  |


s/Starter Kit/Evaluation Module/

3200MT/s is a little fast. You may want to double check this line

bryanbrattlof · 2025-02-12T20:21:42Z

source/devices/AM62L/linux/RT_Linux_Performance_Guide.rst

+
+   "Minimum (usec)","5","5","5","5"
+   "Average (usec)","6","6","5","6"
+   "Maximum (usec)","30","33","31","35"


ah ok I think I get what happened. Feel free to drop the RT performance stuff until we get some numbers tested. This looks like it came from 62P or 62A

feat(linux): Initial documentation support for AM62L platform.

7d6679a

Signed-off-by: sadik <s-sadik@ti.com>

sadik-smd requested review from cshilwant, StaticRocket, praneethbajjuri, uditkumarti, aniket-l and VeeruPrudhvi as code owners February 11, 2025 09:17

cshilwant requested changes Feb 11, 2025

View reviewed changes

jeevantelukula reviewed Feb 12, 2025

View reviewed changes

bryanbrattlof reviewed Feb 12, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(linux): Initial documentation support for AM62L platform. #161

feat(linux): Initial documentation support for AM62L platform. #161

sadik-smd commented Feb 11, 2025

github-actions bot commented Feb 11, 2025

cshilwant Feb 11, 2025

cshilwant Feb 11, 2025

cshilwant Feb 11, 2025

cshilwant Feb 11, 2025

cshilwant Feb 11, 2025

cshilwant Feb 11, 2025

cshilwant Feb 11, 2025

cshilwant Feb 11, 2025

cshilwant Feb 11, 2025

cshilwant Feb 11, 2025

praneethbajjuri commented Feb 11, 2025

cshilwant commented Feb 11, 2025

cshilwant Feb 11, 2025 •

edited

Loading

jeevantelukula Feb 12, 2025

jeevantelukula Feb 12, 2025

jeevantelukula Feb 12, 2025

jeevantelukula Feb 12, 2025

bryanbrattlof Feb 12, 2025

bryanbrattlof Feb 12, 2025

	[ /home/user/ti-processor-sdk-linux-am62pxx-evm-<version>/targetNFS ]
	[ /home/user/ti-processor-sdk-linux-am62lxx-evm-<version>/targetNFS ]

		- Linux Manifest: :file:`<PSDK_PATH>/docs/software_manifest.html`


		Release 11.00


		This page covers migration information for applications built on top
		of the Processor SDK Linux AM62L.

	to runs on A53/Linux core. For R5F and RTOS/NO-RTOS side source and applications, refer MCU+ SDK
	to run on A53/Linux core. For A53 based FreeRTOS side source and applications, refer MCU+ SDK

		@@ -0,0 +1,6 @@
		devices/AM62X/buildroot/index
		devices/AM62X/buildroot/Getting_Started_Guide


		For MCU+ SDK RTOS/NO-RTOS documentation, refer below links

		- `MCU+ SDK Documentation <https://software-dl.ti.com/mcu-plus-sdk/esd/AM62PX/10_01_00_33/exports/docs/api_guide_am62px/index.html>`__

feat(linux): Initial documentation support for AM62L platform. #161

Are you sure you want to change the base?

feat(linux): Initial documentation support for AM62L platform. #161

Conversation

sadik-smd commented Feb 11, 2025

github-actions bot commented Feb 11, 2025

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

praneethbajjuri commented Feb 11, 2025

cshilwant commented Feb 11, 2025

cshilwant Feb 11, 2025 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

cshilwant Feb 11, 2025 •

edited

Loading