feat(linux): Power_Management: add AM62D support

kwillis01 · praneethbajjuri · commit 7fd3c4d7b59d · 2026-04-17T21:36:33.000-05:00
For all Power_Management files that apply to AM62D, make sure that to
add AM62D to any applicable ifconfig or create a new ifconfig for AM62D
if needed.

Signed-off-by: Kendall Willis &lt;k-willis@ti.com&gt;
diff --git a/configs/AM62DX/AM62DX_linux_toc.txt b/configs/AM62DX/AM62DX_linux_toc.txt
@@ -70,7 +70,15 @@ linux/Foundational_Components/Machine_Learning/nnstreamer
 linux/Foundational_Components/Machine_Learning/onnxrt
 linux/Foundational_Components/Machine_Learning/tflite
 
-#linux/Foundational_Components_Power_Management
+linux/Foundational_Components_Power_Management
+linux/Foundational_Components/Power_Management/pm_overview
+linux/Foundational_Components/Power_Management/pm_dfs
+linux/Foundational_Components/Power_Management/pm_cpuidle
+linux/Foundational_Components/Power_Management/pm_runtime_pm
+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_Kernel_Users_Guide
 linux/Foundational_Components_Kernel_LTP-DDT_Validation
diff --git a/source/linux/Foundational_Components/Power_Management/pm_cpuidle.rst b/source/linux/Foundational_Components/Power_Management/pm_cpuidle.rst
@@ -16,7 +16,7 @@ C-state. Governor decides whether to continue in current state/
 transition to a different state. Current 'driver' is called to
 transition to the selected state.
 
-.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'J722S')
+.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'J722S', 'AM62DX')
 
     .. rubric:: Standby Mode
 
diff --git a/source/linux/Foundational_Components/Power_Management/pm_dfs.rst b/source/linux/Foundational_Components/Power_Management/pm_dfs.rst
@@ -197,7 +197,7 @@ To view supported OPP's (frequency in kHz),
       $ cat /sys/devices/system/cpu/cpu0/cpufreq/scaling_available_frequencies
       750000000 1000000000 1500000000 2000000000
 
-.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'J722S')
+.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'J722S', 'AM62DX')
 
    .. code-block:: console
 
@@ -248,7 +248,7 @@ table.
               };
       };
 
-.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX')
+.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'AM62DX')
 
    The OPP table defined in the following files
    allows defining of a different set of OPPs for each different SoC:
@@ -257,7 +257,7 @@ table.
 
       :file:`arch/arm64/boot/dts/ti/k3-am625.dtsi`
 
-   .. ifconfig:: CONFIG_part_variant in ('AM62AX')
+   .. ifconfig:: CONFIG_part_variant in ('AM62AX', 'AM62DX')
 
       :file:`arch/arm64/boot/dts/ti/k3-am62a7.dtsi`
 
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
@@ -54,6 +54,19 @@ Partial I/O supports wakeup sources mcu_mcan0 and mcu_mcan1. For more
 information about enabling CAN wakeup, see
 :ref:`CAN I/O Daisy Chain<pm_wakeup_sources_can>`.
 
+.. ifconfig:: CONFIG_part_variant in ('AM62DX')
+
+   .. important::
+
+      Currently, wakeup from CAN is not available on AM62D EVM, but CAN
+      wakeup still needs to be **enabled** to enter Partial I/O. To wakeup
+      from Partial I/O, enable WKUP UART wakeup by entering the following
+      command:
+
+      .. code-block:: console
+
+         root@<machine>:~# devmem2 0x4084024 w 0x20050000  # MCU_PADCONFIG9 for wkup_uart0
+
 Enter Partial I/O mode with the following command:
 
 .. code-block:: console
@@ -83,7 +96,7 @@ I/O Only Plus DDR
 
    This mode is not applicable for AM62X.
 
-.. ifconfig:: CONFIG_part_variant in ('AM62AX' , 'AM62PX')
+.. ifconfig:: CONFIG_part_variant in ('AM62AX' , 'AM62PX', 'AM62DX')
 
    This mode is similar to Partial I/O mode, with the major distinction being
    that the DDR memory is kept in self refresh to save context. All the processor
@@ -108,6 +121,10 @@ I/O Only Plus DDR
 
       .. important:: Jumper J12 should be connected on SK to enable system to enter I/O Only plus DDR mode.
 
+   .. ifconfig:: CONFIG_part_variant in ('AM62DX')
+
+      .. important:: Jumper J16 should be connected on SK to enable system to enter I/O Only plus DDR mode.
+
    I/O Only Plus DDR supports wakeup sources mcu_uart0, mcu_mcan0,
    mcu_mcan1 and wkup_uart0. To use the mcu_mcan0 and mcu_mcan1 wakeup
    sources, see
@@ -137,7 +154,7 @@ I/O Only Plus DDR
                Main UART, USB0, and USB1 as these wakeup sources are not
                supported for this mode.
 
-   .. ifconfig:: CONFIG_part_variant in ('AM62AX')
+   .. ifconfig:: CONFIG_part_variant in ('AM62AX', 'AM62DX')
 
       .. code-block:: console
 
@@ -157,7 +174,7 @@ I/O Only Plus DDR
 
    .. rubric:: Then, configure PMIC register bit to turn off only selected rails for this mode.
 
-   .. ifconfig:: CONFIG_part_variant in ('AM62AX')
+   .. ifconfig:: CONFIG_part_variant in ('AM62AX', 'AM62DX')
 
       .. code-block:: console
 
@@ -247,7 +264,7 @@ In order to enter Deep Sleep, use the following command:
       [  444.826567] psci: CPU2 killed (polled 0 ms)
       [  444.830170] psci: CPU3 killed (polled 0 ms)
 
-.. ifconfig:: CONFIG_part_variant in ('AM62AX' , 'AM62PX')
+.. ifconfig:: CONFIG_part_variant in ('AM62AX' , 'AM62PX', 'AM62DX')
 
    .. code-block:: console
 
diff --git a/source/linux/Foundational_Components/Power_Management/pm_overview.rst b/source/linux/Foundational_Components/Power_Management/pm_overview.rst
@@ -31,7 +31,7 @@ The dynamic power management features enabled on |__PART_FAMILY_DEVICE_NAMES__|
    #. DVFS
    #. CPUIdle
 
-.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX')
+.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'AM62DX')
 
    #. Dynamic Frequency Scaling
    #. CPUIdle
@@ -56,7 +56,7 @@ duration. This is accomplished by leveraging the low power modes supported
 by the SoC and the `System Sleep States <https://docs.kernel.org/admin-guide/pm/sleep-states.html>`__
 supported by the Linux kernel.
 
-.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX')
+.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'AM62DX')
 
    The static power management features on |__PART_FAMILY_DEVICE_NAMES__| are:
 
diff --git a/source/linux/Foundational_Components/Power_Management/pm_runtime_pm.rst b/source/linux/Foundational_Components/Power_Management/pm_runtime_pm.rst
@@ -30,6 +30,10 @@ The following drivers have been validated for Runtime PM in this release:
 
     DSS, GPU, McASP, OSPI, MCAN, Video Codec.
 
+.. ifconfig:: CONFIG_part_variant in ('AM62DX')
+
+    DSS, McASP, OSPI, MCAN.
+
 .. rubric:: Driver Usage
 
 Linux provides the following sysfs interface (/sys/devices/.../power/)
diff --git a/source/linux/Foundational_Components/Power_Management/pm_sw_arch.rst b/source/linux/Foundational_Components/Power_Management/pm_sw_arch.rst
@@ -230,7 +230,7 @@ If constraint is put on MAIN devgroup devices, then no low power mode is possibl
    `Devgroup section <https://software-dl.ti.com/tisci/esd/latest/5_soc_doc/am62x/soc_devgrps.html#am62x-device-group-descriptions>`__
    of TISCI documentation.
 
-.. ifconfig:: CONFIG_part_variant in ('AM62AX')
+.. ifconfig:: CONFIG_part_variant in ('AM62AX', 'AM62DX')
 
    For detailed description for devgroup of these devices, refer to
    `Devgroup section <https://software-dl.ti.com/tisci/esd/latest/5_soc_doc/am62ax/soc_devgrps.html#am62ax-device-group-descriptions>`__
diff --git a/source/linux/Foundational_Components/Power_Management/pm_wakeup_sources.rst b/source/linux/Foundational_Components/Power_Management/pm_wakeup_sources.rst
@@ -30,7 +30,7 @@ valid for given low power modes:
    | CAN I/O Daisy Chain                            | Yes        | Yes      | Yes         |
    +------------------------------------------------+------------+----------+-------------+
 
-.. ifconfig:: CONFIG_part_variant in ('AM62AX', 'AM62PX')
+.. ifconfig:: CONFIG_part_variant in ('AM62AX', 'AM62PX', 'AM62DX')
 
    +------------------------------------------------+-------+------+---------+----------+
    |  Wakeup Source                                 | Deep  | MCU  | Partial | I/O Only |
@@ -155,7 +155,7 @@ For example, to wakeup from Deep Sleep in 10 seconds, use the command like this:
       [ 34.645777] PM: suspend exit
       root@am62xx-evm:~#
 
-.. ifconfig:: CONFIG_part_variant in ('AM62AX')
+.. ifconfig:: CONFIG_part_variant in ('AM62AX', 'AM62DX')
 
    .. code-block:: console
 
@@ -309,7 +309,7 @@ For example, to wakeup from Deep Sleep in 10 seconds, use the command like this:
       [   28.378392] random: crng reseeded on system resumption
       [   28.384269] PM: suspend exit
 
-.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX')
+.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'AM62DX')
 
    .. note::
 
@@ -325,7 +325,7 @@ MCU GPIO
 
    MCU GPIO wakeup is not supported on AM62LX.
 
-.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX')
+.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'AM62DX')
 
    One of the most common ways to wakeup a system is by using some I/O activity.
    I/O activity on the MCU GPIOs can wakeup the system when the MCU GPIO
@@ -487,7 +487,7 @@ WKUP GPIO
    :ref:`LPM section<lpm_modes>`, wakeup from WKUP_UART0_RXD can be triggered
    by entering a keypress on the WKUP UART (/dev/ttyUSB2).
 
-.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX')
+.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'AM62DX')
 
    Setup of WKUP GPIO is the same process of MCU GPIO. Refer to the
    :ref:`MCU GPIO section<pm_mcu_gpio_wakeup>` on how to configure wakeup from
@@ -514,7 +514,7 @@ register.
 For detailed information and sequence please refer to I/O Power Management and
 Daisy Chaining section in the TRM.
 
-.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX')
+.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'AM62DX')
 
    .. note::
 
@@ -681,6 +681,41 @@ Main UART
          bootph-all;
       };
 
+.. ifconfig:: CONFIG_part_variant in ('AM62DX')
+
+   To configure UART as an I/O daisy chain wakeup, refer to the
+   main_uart0 node in `k3-am62d2-evm.dts <https://git.ti.com/cgit/ti-linux-kernel/ti-linux-kernel/tree/arch/arm64/boot/dts/ti/k3-am62d2-evm.dts?h=12.00.00.07>`_
+
+   .. code-block:: dts
+
+      &main_pmx0 {
+         main_uart0_pins_default: main-uart0-default-pins {
+            pinctrl-single,pins = <
+               AM62DX_IOPAD(0x01c8, PIN_INPUT, 0) /* (E14) UART0_RXD */
+               AM62DX_IOPAD(0x01cc, PIN_OUTPUT, 0) /* (D15) UART0_TXD */
+            >;
+            bootph-all;
+         };
+
+         main_uart0_pins_wakeup: main-uart0-wakeup-pins {
+            pinctrl-single,pins = <
+               AM62DX_IOPAD(0x01c8, PIN_INPUT | PIN_WKUP_EN, 0) /* (E14) UART0_RXD */
+               AM62DX_IOPAD(0x01cc, PIN_OUTPUT, 0) /* (D15) UART0_TXD */
+            >;
+         };
+      };
+
+      &main_uart0 {
+         status = "okay";
+         pinctrl-names = "default", "wakeup";
+         pinctrl-0 = <&main_uart0_pins_default>;
+         pinctrl-1 = <&main_uart0_pins_wakeup>;
+         wakeup-source = <&system_deep_sleep>,
+                         <&system_mcu_only>,
+                         <&system_standby>;
+         bootph-all;
+      };
+
 In the above code, a "wakeup" pinctrl state is defined for main_uart0. The
 "wakeup" pinctrl state sets the  WKUP_EN flag on the desired padconfig register,
 which allows the pad to act as a wakeup source. During suspend, the Linux
@@ -701,7 +736,7 @@ combination of gpio-keys with a chained IRQ in the pinctrl driver. Setting the
 29th bit in the desired padconfig register, allows the pad to act as a wakeup
 source by triggering a wake IRQ in Deep Sleep states.
 
-.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX')
+.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'AM62DX')
 
    The reference configuration for Main GPIO wakeup can be found under
    gpio_key node in
@@ -796,7 +831,7 @@ in a generic way using the ti-sysc interconnect target module driver.
 The reference configuration can be found under target-module in
 `k3-am62-wakeup.dtsi <https://git.ti.com/cgit/ti-linux-kernel/ti-linux-kernel/tree/arch/arm64/boot/dts/ti/k3-am62-wakeup.dtsi?h=12.00.00.07#n46>`__
 
-.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX')
+.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'AM62DX')
 
    WKUP UART is generally available on the third serial port
    (/dev/ttyUSB2) and by default it only shows output from DM R5.
@@ -925,7 +960,7 @@ MCU IPC based Wakeup
 
    MCU IPC wakeup is not supported on AM62LX.
 
-.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX')
+.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'AM62DX')
 
    It's possible to use IPC based wakeup events from the MCU core. For details on how to implement this
    from the firmware side, please refer to the relevant documentation:
@@ -934,7 +969,7 @@ MCU IPC based Wakeup
 
       `MCU+ SDK for AM62x <https://software-dl.ti.com/mcu-plus-sdk/esd/AM62X/11_01_00_16/exports/docs/api_guide_am62x/index.html>`__
 
-   .. ifconfig:: CONFIG_part_variant in ('AM62AX')
+   .. ifconfig:: CONFIG_part_variant in ('AM62AX', 'AM62DX')
 
       `MCU+ SDK for AM62Ax <https://software-dl.ti.com/mcu-plus-sdk/esd/AM62AX/11_01_00_16/exports/docs/api_guide_am62ax/index.html>`__
 
@@ -971,7 +1006,7 @@ CAN I/O Daisy Chain
 
    CAN wakeup is not supported on AM62LX.
 
-.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX')
+.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'AM62DX')
 
    CAN pins can be used to wake the system from any supported low power mode.
    To enable this, in the device tree configure a "wakeup" pinctrl state that sets
@@ -1032,7 +1067,7 @@ CAN I/O Daisy Chain
 RTC Ext Pin
 ***********
 
-.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX')
+.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'AM62DX')
 
    This is not applicable for |__PART_FAMILY_DEVICE_NAMES__|.
 
@@ -1050,7 +1085,7 @@ Confirming the Wakeup event type
 
    This is not applicable for AM62LX.
 
-.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX')
+.. ifconfig:: CONFIG_part_variant in ('AM62X', 'AM62AX', 'AM62PX', 'AM62DX')
 
    When the SoC wakes up from any Low Power Mode, the Device Manager logs the wake
    reason, the pin number that triggered the wakeup, and the last low power mode
