Merge branch 'TexasInstruments:master' into j742s2_lpm

uditkumarti · web-flow · commit b4b35473fbfb · 2025-12-25T10:33:14.000+05:30
diff --git a/.github/component-owners.yml b/.github/component-owners.yml
@@ -1,4 +1,5 @@
 ---
+# yamllint disable rule:line-length
 # Each component identified by its path prefix has a list of owners
 components:
 
@@ -68,14 +69,14 @@ components:
     - jeevantelukula
     - praneethbajjuri
     - uditkumarti
-    - gehariprasath  
+    - gehariprasath
 
   source/linux/Foundational_Components:
     - devarsht
     - praneethbajjuri
     - r-vignesh
     - uditkumarti
-    - gehariprasath  
+    - gehariprasath
 
   source/linux/Foundational_Components/IPC:
     - 3V3RYONE
@@ -92,7 +93,7 @@ components:
     - praneethbajjuri
     - r-vignesh
     - uditkumarti
-    - gehariprasath  
+    - gehariprasath
 
   source/linux/Foundational_Components/Power_Management:
     - DhruvaG2000
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
@@ -1,7 +1,7 @@
 ---
 name: "build"
 
-on:
+on:  # yamllint disable-line rule:truthy
   push:
     branches: [master]
 
diff --git a/.github/workflows/check-files.yml b/.github/workflows/check-files.yml
@@ -1,7 +1,7 @@
 ---
 name: "check-files"
 
-on:
+on:  # yamllint disable-line rule:truthy
   pull_request:
     branches: [master]
     paths:
diff --git a/.github/workflows/check_toc_txt.yml b/.github/workflows/check_toc_txt.yml
@@ -1,7 +1,7 @@
 ---
 name: "check_toc_txt"
 
-on:
+on:  # yamllint disable-line rule:truthy
   pull_request:
     branches: [master]
     paths:
diff --git a/.github/workflows/comment.yml b/.github/workflows/comment.yml
@@ -1,7 +1,7 @@
 ---
 name: "comment"
 
-on:
+on:  # yamllint disable-line rule:truthy
   workflow_run:
     workflows:
       - rstcheck
diff --git a/.github/workflows/commit-check.yml b/.github/workflows/commit-check.yml
@@ -1,6 +1,6 @@
 ---
 name: Commit Check
-on:
+on:  # yamllint disable-line rule:truthy
   pull_request:
     branches: ['master']
 
diff --git a/.github/workflows/component-owners.yml b/.github/workflows/component-owners.yml
@@ -1,7 +1,7 @@
 ---
 name: "component-owners"
 
-on:
+on:  # yamllint disable-line rule:truthy
   # It's insecure to use pull_request_target if you intend to check out code
   # from that PR. This just reads the config file in the pull request base, and
   # is not an issue currently. We will need to use this to comment on PRs coming
diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
@@ -1,7 +1,7 @@
 ---
 name: "deploy"
 
-on:
+on:  # yamllint disable-line rule:truthy
   workflow_run:
     workflows:
       - build
diff --git a/.github/workflows/docker.yml b/.github/workflows/docker.yml
@@ -1,6 +1,6 @@
 ---
 name: Docker Workflow
-on:
+on:  # yamllint disable-line rule:truthy
   push:
     branches: [master]
     paths:
diff --git a/.github/workflows/rstcheck.yml b/.github/workflows/rstcheck.yml
@@ -1,7 +1,7 @@
 ---
 name: "rstcheck"
 
-on:
+on:  # yamllint disable-line rule:truthy
   pull_request:
     branches: [master]
     paths:
diff --git a/.github/workflows/vale.yml b/.github/workflows/vale.yml
@@ -1,7 +1,7 @@
 ---
 name: "vale"
 
-on: [pull_request]
+on: [pull_request]  # yamllint disable-line rule:truthy
 
 defaults:
   run:
diff --git a/.github/workflows/yamllint.yml b/.github/workflows/yamllint.yml
@@ -0,0 +1,23 @@
+---
+name: "yamllint"
+
+on:  # yamllint disable-line rule:truthy
+  pull_request:
+    branches: [master]
+    paths:
+      - '**.yaml'
+      - '**.yml'
+
+jobs:
+  yamllint:
+    name: yamllint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: yamllint
+        uses: reviewdog/action-yamllint@v1
+        with:
+          fail_level: any
+          filter_mode: nofilter
diff --git a/.yamllint.yml b/.yamllint.yml
@@ -0,0 +1,3 @@
+---
+extends: default
+ignore-from-file: .gitignore
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -164,6 +164,35 @@ in this case:
 replace_b
 ```
 
+### Headings / sections
+
+We are trying to move to the [Python Developer's Guide for
+documenting](https://devguide.python.org/documentation/markup/#sections)
+standard of section hierarchy. This means that section definitions should use
+the following pattern:
+
+```rst
+#########
+Section 1
+#########
+
+*********
+Section 2
+*********
+
+Section 3
+=========
+
+Section 4
+---------
+
+Section 5
+^^^^^^^^^
+
+Section 6
+"""""""""
+```
+
 ## Licensing
 
 ### Community
diff --git a/source/devices/AM335X/linux/Release_Specific_Release_Notes.rst b/source/devices/AM335X/linux/Release_Specific_Release_Notes.rst
@@ -59,6 +59,7 @@ Processor SDK 11.02 Release has following new features:
  - ARM Analytics AI stack enabled in the filesystem
  - LVGL (Light and Versatile Graphics Library) based interactive demo as out-of-the-box (OOB) on display
  - Web-based dashboard (port 3000) for real-time CPU performance and Arm Audio analytics demo via standard web browser
+ - Added support for McASP async mode: independent transmit (playback) and receive (capture) clocking
 
 .. rubric:: SDK Components & Versions
    :name: sdk-components-versions
diff --git a/source/devices/AM437X/linux/Release_Specific_Release_Notes.rst b/source/devices/AM437X/linux/Release_Specific_Release_Notes.rst
@@ -60,6 +60,7 @@ Processor SDK 11.02 Release has following new features:
  - HDMI suport in Linux
  - ARM Analytics AI stack enabled in the filesystem
  - LVGL (Light and Versatile Graphics Library) based interactive demo as out-of-the-box (OOB) on display
+ - Added support for McASP async mode: independent transmit (playback) and receive (capture) clocking
 
 .. rubric:: SDK Components & Versions
    :name: sdk-components-versions
diff --git a/source/devices/AM57X/linux/Release_Specific_Yocto_layer_Configuration.rst b/source/devices/AM57X/linux/Release_Specific_Yocto_layer_Configuration.rst
@@ -1,22 +1,27 @@
 .. _yocto-layer-configuration:
 
-**************************
+#########################
 Yocto Layer Configuration
-**************************
+#########################
 
-.. http://processors.wiki.ti.com/index.php/Processor_SDK_Building_The_SDK#Layer_Configuration
+Processor SDK uses oe-layersetup configuration files to initialize the
+Yocto build environment. Configure your build with the following command:
 
-Processor SDK uses the following oe-layersetup configs to configure the
-meta layers. These are the <config> used in the command:
+.. code-block:: console
 
-``$ ./oe-layertool-setup.sh -f <config>``
+   $ ./oe-layertool-setup.sh -f <config>
 
-|
-| The following config files are located in the **yocto-build/configs/processor-sdk-linux**
-  directory.
+Replace ``<config>`` with one of the following configuration files.
 
-+-------------------------------------+----------------------------------------------------+--------------------------------+
-|      Config File                    |                    Description                     | Supported machines             |
-+=====================================+====================================================+================================+
-| processor-sdk-linux-11_01_02_01.txt | Processor SDK Linux 11_01 Release                  | am57xx-evm, am57xx-hs-evm      |
-+-------------------------------------+----------------------------------------------------+--------------------------------+
+The :file:`yocto-build/configs/processor-sdk-linux` directory has the following configuration files.
+
+.. list-table:: Yocto Layer Configuration
+   :widths: 50 50 30
+   :header-rows: 1
+
+   * - Config File
+     - Description
+     - Supported machines/platforms
+   * - :file:`processor-sdk-linux-11_01_02_01.txt`
+     - Processor SDK Linux 11_01 Release
+     - |__SDK_BUILD_MACHINE__|, am57xx-hs-evm
diff --git a/source/devices/AM62AX/linux/Release_Specific_Yocto_layer_Configuration.rst b/source/devices/AM62AX/linux/Release_Specific_Yocto_layer_Configuration.rst
@@ -1,25 +1,33 @@
 .. _yocto-layer-configuration:
 
-*************************
+#########################
 Yocto Layer Configuration
-*************************
+#########################
 
-Processor SDK uses the following oe-layersetup configs to configure the
-meta layers. These are the <config> used in the command:
+Processor SDK uses oe-layersetup configuration files to initialize the
+Yocto build environment. Configure your build with the following command:
 
 .. code-block:: console
 
    $ ./oe-layertool-setup.sh -f <config>
 
-The following config files are located in the :file:`configs/processor-sdk-analytics`
-directory of the `oe-layersetup git repo <https://git.ti.com/cgit/arago-project/oe-layersetup/>`_.
+Replace ``<config>`` with one of the following configuration files.
 
-+-------------------------------------------------------------------+------------------------------------------------------+------------------------------+
-| Config File                                                       | Description                                          | Supported machines/platforms |
-+===================================================================+======================================================+==============================+
-| processor-sdk-analytics-11.01.07.05-config.txt                    | Used for building EdgeAI filesystem                  | am62axx-evm                  |
-+-------------------------------------------------------------------+------------------------------------------------------+------------------------------+
-| processor-sdk-analytics-selinux-11.01.07.05-config.txt            | Used for building SELinux enabled EdgeAI filesystem  | am62axx-evm                  |
-+-------------------------------------------------------------------+------------------------------------------------------+------------------------------+
+The `oe-layersetup git repository <https://git.ti.com/cgit/arago-project/oe-layersetup/>`__
+has the following configuration files in the :file:`configs/processor-sdk` directory.
+
+.. list-table:: Yocto Layer Configuration
+   :widths: 50 50 30
+   :header-rows: 1
+
+   * - Config File
+     - Description
+     - Supported machines/platforms
+   * - :file:`processor-sdk-analytics-11.01.07.05-config.txt`
+     - Used for building EdgeAI filesystem
+     - |__SDK_BUILD_MACHINE__|
+   * - :file:`processor-sdk-analytics-selinux-11.01.07.05-config.txt`
+     - Used for building SELinux enabled EdgeAI filesystem
+     - |__SDK_BUILD_MACHINE__|
 
 The oe-layersetup configuration, as defined in :file:`processor-sdk-analytics-11.01.07.05-config.txt` is used for configuring the meta layers in the yocto SD card image available on |__SDK_DOWNLOAD_URL__|.
diff --git a/source/devices/AM62DX/linux/Linux_Performance_Guide.rst b/source/devices/AM62DX/linux/Linux_Performance_Guide.rst
@@ -475,6 +475,19 @@ CPSW/CPSW2g/CPSW3g Ethernet Driver
 
 |
 
+Linux OSPI Flash Driver
+-----------------------
+
+RAW
+
+.. csv-table:: OSPI Raw Flash Driver
+    :header: "File size (Mbytes)","am62dxx_evm-fs: Raw Read Throughput (Mbytes/sec)"
+
+    "10","227.27"
+    "50","217.39"
+
+|
+
 USB Driver
 ----------
 
diff --git a/source/devices/AM62DX/linux/Release_Specific_Yocto_layer_Configuration.rst b/source/devices/AM62DX/linux/Release_Specific_Yocto_layer_Configuration.rst
@@ -1,22 +1,28 @@
 .. _yocto-layer-configuration:
 
-*************************
+#########################
 Yocto Layer Configuration
-*************************
+#########################
 
-Processor SDK uses the following oe-layersetup configs to configure the
-meta layers. These are the <config> used in the command:
+Processor SDK uses oe-layersetup configuration files to initialize the
+Yocto build environment. Configure your build with the following command:
 
 .. code-block:: console
 
    $ ./oe-layertool-setup.sh -f <config>
 
-The following config files are located in the ``configs/processor-sdk``
-directory of the `oe-layersetup git repo <https://git.ti.com/cgit/arago-project/oe-layersetup/>`_.
+Replace ``<config>`` with one of the following configuration files.
 
-+---------------------------------------------------------------+-----------------------------------+-------------------------------+
-| Config File                                                   | Description                       | Supported machines/platforms  |
-+===============================================================+===================================+===============================+
-|      processor-sdk-scarthgap-nonqt-11.02.08.02-config.txt     | Processor SDK 11.02.08.02 Release |          am62dxx-evm          |
-+---------------------------------------------------------------+-----------------------------------+-------------------------------+
+The `oe-layersetup git repository <https://git.ti.com/cgit/arago-project/oe-layersetup/>`__
+has the following configuration files in the :file:`configs/processor-sdk` directory.
 
+.. list-table:: Yocto Layer Configuration
+   :widths: 50 50 30
+   :header-rows: 1
+
+   * - Config File
+     - Description
+     - Supported machines/platforms
+   * - :file:`processor-sdk-scarthgap-nonqt-11.02.08.02-config.txt`
+     - Used for building Yocto based filesystem
+     - |__SDK_BUILD_MACHINE__|
diff --git a/source/devices/AM62LX/linux/Release_Specific_Yocto_layer_Configuration.rst b/source/devices/AM62LX/linux/Release_Specific_Yocto_layer_Configuration.rst
@@ -1,22 +1,28 @@
 .. _yocto-layer-configuration:
 
-*************************
+#########################
 Yocto Layer Configuration
-*************************
+#########################
 
-Processor SDK uses the following oe-layersetup configs to configure the
-meta layers. These are the <config> used in the command:
+Processor SDK uses oe-layersetup configuration files to initialize the
+Yocto build environment. Configure your build with the following command:
 
 .. code-block:: console
 
    $ ./oe-layertool-setup.sh -f <config>
 
-The following config files are located in the ``configs/processor-sdk``
-directory of the `oe-layersetup git repo <https://git.ti.com/cgit/arago-project/oe-layersetup/>`_.
+Replace ``<config>`` with one of the following configuration files.
 
-+---------------------------------------------------------------+-----------------------------------+-------------------------------+
-| Config File                                                   | Description                       | Supported machines/platforms  |
-+===============================================================+===================================+===============================+
-|      processor-sdk-scarthgap-nonqt-11.02.08.02-config.txt     | Processor SDK 11.02.08.02 Release |  |__SDK_BUILD_MACHINE__|      |
-+---------------------------------------------------------------+-----------------------------------+-------------------------------+
+The `oe-layersetup git repository <https://git.ti.com/cgit/arago-project/oe-layersetup/>`__
+has the following configuration files in the :file:`configs/processor-sdk` directory.
 
+.. list-table:: Yocto Layer Configuration
+   :widths: 50 50 30
+   :header-rows: 1
+
+   * - Config File
+     - Description
+     - Supported machines/platforms
+   * - :file:`processor-sdk-scarthgap-nonqt-11.02.08.02-config.txt`
+     - Used for building Yocto based filesystem
+     - |__SDK_BUILD_MACHINE__|
diff --git a/source/devices/AM62PX/linux/Release_Specific_Yocto_layer_Configuration.rst b/source/devices/AM62PX/linux/Release_Specific_Yocto_layer_Configuration.rst
diff --git a/source/devices/AM62X/linux/Release_Specific_Yocto_layer_Configuration.rst b/source/devices/AM62X/linux/Release_Specific_Yocto_layer_Configuration.rst
diff --git a/source/devices/AM64X/linux/Release_Specific_Yocto_layer_Configuration.rst b/source/devices/AM64X/linux/Release_Specific_Yocto_layer_Configuration.rst
diff --git a/source/devices/AM65X/linux/Release_Specific_Release_Notes.rst b/source/devices/AM65X/linux/Release_Specific_Release_Notes.rst
diff --git a/source/devices/DRA821A/linux/Release_Specific_Yocto_layer_Configuration.rst b/source/devices/DRA821A/linux/Release_Specific_Yocto_layer_Configuration.rst
diff --git a/source/devices/J7_Family/linux/Release_Specific_Release_Notes.rst b/source/devices/J7_Family/linux/Release_Specific_Release_Notes.rst
diff --git a/source/linux/Foundational_Components/Power_Management/pm_low_power_modes.rst b/source/linux/Foundational_Components/Power_Management/pm_low_power_modes.rst
