Skip to content

feat(pm_upstream): add page to track upstream status of LPM #762

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
cshilwant merged 1 commit into from
Jul 31, 2026
Merged

feat(pm_upstream): add page to track upstream status of LPM #762

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions configs/AM62AX/AM62AX_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -94,6 +94,7 @@ linux/Foundational_Components/Power_Management/pm_low_power_modes
linux/Foundational_Components/Power_Management/pm_wakeup_sources
linux/Foundational_Components/Power_Management/pm_sw_arch
linux/Foundational_Components/Power_Management/pm_debug
linux/Foundational_Components/Power_Management/pm_upstream

linux/Foundational_Components/System_Security/Security_overview
linux/Foundational_Components/System_Security/SELinux
Expand Down
1 change: 1 addition & 0 deletions configs/AM62DX/AM62DX_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,7 @@ linux/Foundational_Components/Power_Management/pm_low_power_modes
linux/Foundational_Components/Power_Management/pm_wakeup_sources
linux/Foundational_Components/Power_Management/pm_sw_arch
linux/Foundational_Components/Power_Management/pm_debug
linux/Foundational_Components/Power_Management/pm_upstream

linux/Foundational_Components_Kernel_Users_Guide
linux/Foundational_Components_Kernel_LTP-DDT_Validation
Expand Down
1 change: 1 addition & 0 deletions configs/AM62LX/AM62LX_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,7 @@ linux/Foundational_Components/Power_Management/pm_am62lx_low_power_modes
linux/Foundational_Components/Power_Management/pm_psci_s2idle
linux/Foundational_Components/Power_Management/pm_wakeup_sources
linux/Foundational_Components/Power_Management/pm_am62lx_debug
linux/Foundational_Components/Power_Management/pm_upstream

linux/Foundational_Components/System_Security/Security_overview
#linux/Foundational_Components/System_Security/SELinux
Expand Down
1 change: 1 addition & 0 deletions configs/AM62PX/AM62PX_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -99,6 +99,7 @@ linux/Foundational_Components/Power_Management/pm_low_power_modes
linux/Foundational_Components/Power_Management/pm_wakeup_sources
linux/Foundational_Components/Power_Management/pm_sw_arch
linux/Foundational_Components/Power_Management/pm_debug
linux/Foundational_Components/Power_Management/pm_upstream

linux/Foundational_Components/System_Security/Security_overview
linux/Foundational_Components/System_Security/SELinux
Expand Down
1 change: 1 addition & 0 deletions configs/AM62X/AM62X_linux_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -96,6 +96,7 @@ linux/Foundational_Components/Power_Management/pm_low_power_modes
linux/Foundational_Components/Power_Management/pm_wakeup_sources
linux/Foundational_Components/Power_Management/pm_sw_arch
linux/Foundational_Components/Power_Management/pm_debug
linux/Foundational_Components/Power_Management/pm_upstream

linux/Foundational_Components/System_Security/Security_overview
linux/Foundational_Components/System_Security/SELinux
Expand Down
331 changes: 331 additions & 0 deletions source/linux/Foundational_Components/Power_Management/pm_upstream.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,331 @@
.. _pm_upstream:

Check warning on line 1 in source/linux/Foundational_Components/Power_Management/pm_upstream.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.ReadabilityGrade] Simplify your language. The calculated Flesch–Kincaid grade level of 10.10 is above the recommended reading grade level of 9.

Raw Output:
{"message": "[RedHat.ReadabilityGrade] Simplify your language. The calculated Flesch–Kincaid grade level of 10.10 is above the recommended reading grade level of 9.", "location": {"path": "source/linux/Foundational_Components/Power_Management/pm_upstream.rst", "range": {"start": {"line": 1, "column": 1}}}, "severity": "INFO"}

###############
Upstream Status

Check warning on line 4 in source/linux/Foundational_Components/Power_Management/pm_upstream.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Headings] Use sentence-style capitalization in 'Upstream Status'.

Raw Output:
{"message": "[RedHat.Headings] Use sentence-style capitalization in 'Upstream Status'.", "location": {"path": "source/linux/Foundational_Components/Power_Management/pm_upstream.rst", "range": {"start": {"line": 4, "column": 1}}}, "severity": "INFO"}
###############

At TI, developers practice an upstream-first mindset where all patches in the
SDK should be available in the upstream repositories as soon as possible.
However, because of the extensive community review process, getting patches
into the upstream repositories can take a long time, so features might appear
in the SDK before upstream.

This page tracks the status of all low power features in upstream. We encourage
users to review any pending series listed.

We update this page with each SDK release, so it might fall out of date as the
upstream community accepts new patches.

.. note::

Upstream support for a wakeup source does not guarantee device tree
configuration. Refer to the
:ref:`"Wakeup Sources" <pm_wakeup_sources>` section for more information
about how to configure wakeup sources.

.. ifconfig:: CONFIG_part_variant in ('AM62X')

.. list-table:: Feature Upstream Status
:widths: auto
:header-rows: 1

* - Feature
- Upstream
- Notes
* - DeepSleep
- Yes
- Remoteproc graceful shutdown is not upstream. See additional steps below.
* - MCU Only
- Yes
- Same remoteproc limitation as DeepSleep.
* - Partial I/O
- Yes
-
* - Dynamic Frequency Scaling
- Yes
-
* - Standby
- No
-
* - Runtime PM
- Yes
-

.. list-table:: Wakeup Source Upstream Status
:widths: auto
:header-rows: 1

* - Wakeup Source
- DeepSleep
- MCU Only
- Partial I/O
- Notes
* - Real-Time Clock (RTC)
- Yes
- Yes
-
-
* - MCU (WKUP) GPIO
- Yes
- Yes
-
-
* - Main I/O Daisy Chain
- Partial
- Partial
-
- Upstream includes Main UART wakeup but not Main GPIO wakeup.
* - USB
- Yes
- Yes
-
-
* - WKUP UART
- Yes
- Yes
-
-
* - MCU IPC
-
- Yes
-
-
* - CAN I/O Daisy Chain
- No
- No
- Yes
-

.. ifconfig:: CONFIG_part_variant in ('AM62AX', 'AM62DX', 'AM62PX')

.. list-table:: Feature Upstream Status
:widths: auto
:header-rows: 1

* - Feature
- Upstream
- Notes
* - DeepSleep
- Yes
-
* - MCU Only
- Yes
-
* - Partial I/O
- Yes
-
* - I/O Only Plus DDR
- In progress
- Linux and U-Boot patches are pending review.
* - Dynamic Frequency Scaling
- Yes
-
* - Standby
- No
-
* - Runtime PM
- Yes
-

.. list-table:: Wakeup Source Upstream Status
:widths: auto
:header-rows: 1

* - Wakeup Source
- DeepSleep
- MCU Only
- Partial I/O
- I/O Only Plus DDR
- Notes
* - Real-Time Clock (RTC)
- Yes
- Yes
-
-
-
* - WKUP GPIO
- Yes
- Yes
-
-
-
* - Main I/O Daisy Chain
- Partial
- Partial
-
-
- Upstream includes Main UART wakeup but not Main GPIO wakeup.
* - USB
- Yes
- Yes
-
-
-
* - WKUP UART
- Yes
- Yes
-
-
-
* - MCU IPC
-
- Yes
-
-
-
* - CAN I/O Daisy Chain
- No
- No
- Yes
- In progress
- I/O Only Plus DDR patches are in progress.

.. ifconfig:: CONFIG_part_variant in ('AM62LX')

.. important::

TI has not yet upstreamed all low power mode features in Arm Trusted
Firmware. The following list applies to upstream Linux only when using
the TI fork for TF-A. Refer to
:ref:`Arm Trusted Firmware <foundational-components-atf>` section for how

Check warning on line 190 in source/linux/Foundational_Components/Power_Management/pm_upstream.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.UserReplacedValues] Separate words by underscores in user-replaced values.

Raw Output:
{"message": "[RedHat.UserReplacedValues] Separate words by underscores in user-replaced values.", "location": {"path": "source/linux/Foundational_Components/Power_Management/pm_upstream.rst", "range": {"start": {"line": 190, "column": 34}}}, "severity": "INFO"}
to use the TI TF-A fork.

.. list-table:: Feature Upstream Status
:widths: auto
:header-rows: 1

* - Feature
- Upstream
- Notes
* - DeepSleep
- Yes
-
* - RTC + I/O + DDR
- In progress
- Linux patches pending review.
* - RTC Only
- In progress
-
* - Standby
- In progress
- Linux patches pending review.
* - Dynamic Frequency Scaling
- Yes
-
* - Runtime PM
- Yes
-
* - Wakeup source detection
- No
-

.. list-table:: Wakeup Source Upstream Status
:widths: auto
:header-rows: 1

* - Wakeup Source
- DeepSleep
- RTC + I/O + DDR
- RTC Only
- Notes
* - Real-Time Clock (RTC)
- No
- No
- No
-
* - WKUP GPIO
- Yes
-
-
-
* - Main I/O Daisy Chain
- Partial
-
-
- Upstream includes Main UART wakeup but not Main GPIO wakeup.
* - WKUP I/O Daisy Chain
- Yes
- Yes
-
-
* - WKUP UART
- Yes
-
-
-
* - USB
- Yes
-
-
-
* - RTC I/O
- No
- No
- No
-

***********************
Pending Upstream Series

Check warning on line 268 in source/linux/Foundational_Components/Power_Management/pm_upstream.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Headings] Use sentence-style capitalization in 'Pending Upstream Series'.

Raw Output:
{"message": "[RedHat.Headings] Use sentence-style capitalization in 'Pending Upstream Series'.", "location": {"path": "source/linux/Foundational_Components/Power_Management/pm_upstream.rst", "range": {"start": {"line": 268, "column": 1}}}, "severity": "INFO"}
***********************

.. ifconfig:: CONFIG_part_variant in ('AM62X')

Currently, there are no pending upstream series for
|__PART_FAMILY_DEVICE_NAMES__|.

.. ifconfig:: CONFIG_part_variant in ('AM62AX', 'AM62DX', 'AM62PX')

.. list-table:: Pending Upstream Series
:widths: auto
:header-rows: 1

* - Series
- Feature Covered
- Codebase
* - `arm64: dts: ti: k3-am62a7-sk: Split r5f memory region <https://lore.kernel.org/all/20260701-topic-am62a-ioddr-dt-v6-19-v7-0-e9db8b16821a@baylibre.com/>`__
- I/O Only Plus DDR
- `Linux <https://github.com/torvalds/linux>`__
* - `am62: IO+DDR resume support <https://lore.kernel.org/all/20260105-topic-am62-ioddr-v2025-04-rc1-v9-0-7e33f2c77dbf@baylibre.com/>`__
- I/O Only Plus DDR
- `U-Boot <https://git.u-boot-project.org/u-boot/u-boot/-/tree/main>`__
* - `IO+DDR low power mode bugfixes for AM62P and AM62A <https://lore.kernel.org/u-boot/20260310100614.951573-1-a-kaur@ti.com/>`__
- I/O Only Plus DDR
- `U-Boot <https://git.u-boot-project.org/u-boot/u-boot/-/tree/main>`__

Enable I/O Only Plus DDR in upstream by applying these patches to the
corresponding codebase.

.. ifconfig:: CONFIG_part_variant in ('AM62LX')

.. list-table:: Pending Upstream Series
:widths: auto
:header-rows: 1

* - Series
- Feature Covered
- Codebase
* - `PM: QoS/pmdomains: support resume latencies for system-wide PM <https://lore.kernel.org/linux-pm/20260611-topic-lpm-pmdomain-device-constraints-v3-0-75d69438518b@baylibre.com/>`__
- RTC + I/O + DDR, standby
- `Linux <https://github.com/torvalds/linux>`__

This is not the complete list of patches needed to enable RTC + I/O + DDR
and standby. Additional series will be sent in the future.

***********
Workarounds
***********

.. ifconfig:: CONFIG_part_variant in ('AM62X')

Remoteproc suspend/resume and graceful shutdown are not present upstream,
which prevents Linux from suspend/resume to low power states. To enable
suspend/resume on Linux remove the M4 remoteproc module by entering the
following command into the Linux console of the EVM:

.. code-block:: console

root@am62xx-evm:~# rmmod ti_k3_m4_remoteproc

.. ifconfig:: CONFIG_part_variant in ('AM62AX', 'AM62DX', 'AM62PX', 'AM62LX')

No workarounds are needed for |__PART_FAMILY_DEVICE_NAMES__|.
1 change: 1 addition & 0 deletions source/linux/Foundational_Components_Power_Management.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,3 +20,4 @@ Power Management
Foundational_Components/Power_Management/pm_sw_arch
Foundational_Components/Power_Management/pm_debug
Foundational_Components/Power_Management/pm_am62lx_debug
Foundational_Components/Power_Management/pm_upstream