From b2383c42d7866cd6294e002ebcb21b9efcf8c782 Mon Sep 17 00:00:00 2001 From: Udit Kumar Date: Wed, 24 Dec 2025 14:54:41 +0530 Subject: [PATCH] chore(linux): Update jacinto lpm doc Add flow diagram, hardware details to excercise LPM mode. Signed-off-by: Udit Kumar --- source/images/jacinto_s2r_entry.png | Bin 0 -> 38145 bytes source/images/jacinto_s2r_exit.png | Bin 0 -> 30504 bytes .../pm_low_power_modes_socoff.rst | 120 ++++++++++++++++-- 3 files changed, 109 insertions(+), 11 deletions(-) create mode 100644 source/images/jacinto_s2r_entry.png create mode 100644 source/images/jacinto_s2r_exit.png diff --git a/source/images/jacinto_s2r_entry.png b/source/images/jacinto_s2r_entry.png new file mode 100644 index 0000000000000000000000000000000000000000..e895e16310df92dad961500870698b43ec526ef3 GIT binary patch literal 38145 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 . + +.. ifconfig:: CONFIG_part_variant in ('J784S4') + + board/ti/j784s4/pm-cfg.yaml + `J784s4 board config `_ . + +In above board config file, default lpm_mode is 0x5 (SOC_OFF) and suspend_initiator is 0xA (A72_0 host). + +To set the LPM mode as IO_RET_PLUS_DDR, change lpm_mode to 0x2. + +Sample code is available at +https://gist.github.com/uditkumarti/fd0dfe8aa3dc094aadafecab67048307 + +The lpm mode value can be picked up from: +https://software-dl.ti.com/tisci/esd/latest/2_tisci_msgs/pm/lpm.html + +Testing +======= +Below section explains, how to test supported LPM modes -******* SoC off -******* +------- In SoC off low power mode, DDR retains partial software context (Mainly HLOS - High Level Operating System, Linux in this case) powering off the rest of SoC. This can save a significant amount of boot time, because it does not reinitialize whole kernel as it is already present in DDR. @@ -57,10 +146,10 @@ To exit from SoC off, Press SW15 push button on J784S4 evm. -***************** -I/O only Plus DDR -***************** +IO_ONLY_PLUS_DDR mode +--------------------- +Use u-boot build after changing lpm_mode to 0x2, in boardconfig file. In I/O only plus DDR, only the I/O pins remain active while the system turns off the rest of SoC. #. Low power consumption: IO Only Plus DDR mode can save a significant amount of power, especially in battery-powered @@ -143,3 +232,12 @@ Resume flow, [ 41.416506] PM: suspend exit root@-evm:~# root@-evm:~# + +***************** +Known limitations +***************** +1. Only A core as suspend master supported and tested with Linux. +2. The LPM feature is not supported on HS-SE variant J784S4. +3. If PCIe is being used, the resume latency increases by 1 sec for every PCIe instance, If EP is not connected. +4. Remote core firmwares are getting loaded by Linux on resume. +5. MCU domain R5 core, cannot be used in split mode.