doc: Updated nRF54H20 PM optimization guide #25445

FrancescoSer · 2025-11-06T08:51:39Z

Updated nRF54H20 PM optimization guide.

Copilot

Pull Request Overview

This PR enhances the nRF54H20 power management optimization guide by adding comprehensive technical documentation about the device's power management architecture and optimization strategies.

Key changes:

Added detailed explanation of logical domains, power domains, and the locality principle
Documented peripheral access strategies, DMA constraints, and system-off entry prerequisites
Included practical integration guidelines and optimization checklists

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_pm_optimization.rst

NordicBuilder · 2025-11-06T08:57:10Z

CI Information

^{To view the history of this post, click the 'edited' button above}
Build number: 10

Inputs:

Sources:

sdk-nrf: PR head: 724649aa4ab6ebefe15fe16c2fd584bfa12ede6a

more details

sdk-nrf:

PR head: 724649aa4ab6ebefe15fe16c2fd584bfa12ede6a
merge base: 619d1660fa866e88fe4c5c302f5af099b85a093c
target head (main): 0c79406a493836eff01af3bf4a75b49a5a47ca16
Diff

Github labels

Enabled	Name	Description
	ci-disabled	Disable the ci execution
	ci-all-test	Run all of ci, no test spec filtering will be done
	ci-force-downstream	Force execution of downstream even if twister fails
	ci-run-twister	Force run twister
	ci-run-zephyr-twister	Force run zephyr twister

List of changed files detected by CI (2)

doc
│  ├── nrf
│  │  ├── app_dev
│  │  │  ├── device_guides
│  │  │  │  ├── nrf54h
│  │  │  │  │  │ ug_nrf54h20_pm_optimization.rst
│  │  ├── releases_and_maturity
│  │  │  ├── releases
│  │  │  │  │ release-notes-changelog.rst

Outputs:

Toolchain

Version:
Build docker image:

Test Spec & Results: ✅ Success; ❌ Failure; 🟠 Queued; 🟡 Progress; ◻️ Skipped; ⚠️ Quarantine

◻️ Toolchain
◻️ Build twister
◻️ Integration tests

Disabled integration tests

- test-fw-nrfconnect-nrf_lrcs_positioning
- desktop52_verification
- test_ble_nrf_config
- test-fw-nrfconnect-apps
- test-fw-nrfconnect-ble_mesh
- test-fw-nrfconnect-ble_samples
- test-fw-nrfconnect-chip
- test-fw-nrfconnect-fem
- test-fw-nrfconnect-nfc
- test-fw-nrfconnect-nrf-iot_libmodem-nrf
- test-fw-nrfconnect-nrf-iot_lwm2m
- test-fw-nrfconnect-nrf-iot_samples
- test-fw-nrfconnect-nrf-iot_thingy91
- test-fw-nrfconnect-nrf-iot_zephyr_lwm2m
- test-fw-nrfconnect-nrf_crypto
- test-fw-nrfconnect-ps-main
- test-fw-nrfconnect-rpc
- test-fw-nrfconnect-rs
- test-fw-nrfconnect-tfm
- test-fw-nrfconnect-thread-main
- test-low-level
- test-sdk-audio
- test-sdk-dfu
- test-sdk-find-my
- test-sdk-mcuboot
- test-sdk-wifi
- test-secdom-samples-public

Note: This message is automatically posted and updated by the CI

github-actions · 2025-11-06T09:33:15Z

You can find the documentation preview for this PR here.

Preview links for modified nRF Connect SDK documents:

https://ncsdoc.z6.web.core.windows.net/PR-25445/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_pm_optimization.html
https://ncsdoc.z6.web.core.windows.net/PR-25445/nrf/releases_and_maturity/releases/release-notes-changelog.html

Copilot

Pull Request Overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 3 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_pm_optimization.rst

Copilot

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_pm_optimization.rst

FrancescoSer · 2025-11-25T17:31:14Z

doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_pm_optimization.rst

@@ -353,32 +353,62 @@ When choosing between single-core and dual-core architectures (using either the
        return 0;
      }

-Deep-sleep policy
-=================
+Disabling power management


@bjarki-andreasen @nordic-krch Need input

Splitting this into a new PR

doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_pm_optimization.rst

pizi-nordic

This looks good. I have mostly pointed minor things, which IMHO makes text more clear.
Part about DMA and MRAM interaction needs to be changed, as suggested usage of MRAM in DMA transaction sounds strange. See relevant comment for details.

nordic-krch · 2025-11-26T12:47:59Z

doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_pm_optimization.rst

+The :c:func:`pm_policy_latency_request_add`, :c:func:`pm_policy_latency_request_update`, and :c:func:`pm_policy_latency_request_remove` functions allow you to set a maximum latency requirement.
+The system will not enter any power state that would cause the wake-up latency to exceed the specified value.
+
+Setting a latency of ``0`` microseconds effectively disables all power management, as no power state can meet a zero-latency requirement.


nrfconnect/sdk-zephyr#3542 adds functionality that allows locking all power states in a much faster way. To lock all power states pm_policy_state_all_lock_get() is used and pm_policy_state_all_lock_put() to unlock. It has reference counter so lock is released when last user releases the lock.
Locking all states with this API overcomes a PM specific locking so if full lock is taken unlocking a specific state will keep it locked until full lock is released.

Ok, I'll clarify this later on, for now I'm separating PM disabling edits from the rest of the PR

Copilot

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 6 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_pm_optimization.rst

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

doc/nrf/releases_and_maturity/releases/release-notes-changelog.rst

doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_pm_optimization.rst

Updated nRF54H20 PM optimization guide. Signed-off-by: Francesco Domenico Servidio <[email protected]>

Copilot AI review requested due to automatic review settings November 6, 2025 08:51

NordicBuilder added doc-required PR must not be merged without tech writer approval. changelog-entry-required Update changelog before merge. Remove label if entry is not needed or already added. labels Nov 6, 2025

Copilot AI reviewed Nov 6, 2025

View reviewed changes

doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_pm_optimization.rst Outdated Show resolved Hide resolved

doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_pm_optimization.rst Outdated Show resolved Hide resolved

FrancescoSer requested a review from pizi-nordic November 20, 2025 08:57

FrancescoSer force-pushed the 54h_pmopt_upd branch from 14ca9f8 to 2d6f923 Compare November 20, 2025 08:57

Copilot AI review requested due to automatic review settings November 20, 2025 08:59

FrancescoSer force-pushed the 54h_pmopt_upd branch from 2d6f923 to b4631a7 Compare November 20, 2025 08:59

FrancescoSer requested a review from wiba-nordic November 20, 2025 08:59

FrancescoSer marked this pull request as ready for review November 20, 2025 08:59

Copilot AI reviewed Nov 20, 2025

View reviewed changes

carlescufi requested review from anangl and nordic-krch November 20, 2025 12:31

FrancescoSer force-pushed the 54h_pmopt_upd branch from b4631a7 to 522688b Compare November 25, 2025 14:00

FrancescoSer added this to the 3.2.0 milestone Nov 25, 2025

Copilot AI review requested due to automatic review settings November 25, 2025 17:24

Copilot AI reviewed Nov 25, 2025

View reviewed changes

doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_pm_optimization.rst Show resolved Hide resolved

doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_pm_optimization.rst Outdated Show resolved Hide resolved

FrancescoSer force-pushed the 54h_pmopt_upd branch from b7436ed to 50248ca Compare November 25, 2025 17:29

FrancescoSer commented Nov 25, 2025

View reviewed changes

wiba-nordic requested changes Nov 26, 2025

View reviewed changes

pizi-nordic reviewed Nov 26, 2025

View reviewed changes

doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_pm_optimization.rst Outdated Show resolved Hide resolved

pizi-nordic reviewed Nov 26, 2025

View reviewed changes

doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_pm_optimization.rst Outdated Show resolved Hide resolved

pizi-nordic reviewed Nov 26, 2025

View reviewed changes

doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_pm_optimization.rst Outdated Show resolved Hide resolved

pizi-nordic requested changes Nov 26, 2025

View reviewed changes

nordic-krch reviewed Nov 26, 2025

View reviewed changes

Copilot AI review requested due to automatic review settings November 27, 2025 12:44

FrancescoSer force-pushed the 54h_pmopt_upd branch from 50248ca to 7cba226 Compare November 27, 2025 12:44

NordicBuilder requested a review from a team November 27, 2025 12:44

Copilot AI reviewed Nov 27, 2025

View reviewed changes

FrancescoSer force-pushed the 54h_pmopt_upd branch from 7cba226 to 67df456 Compare November 27, 2025 14:33

FrancescoSer requested review from nordic-krch, pizi-nordic and wiba-nordic November 27, 2025 14:41

wiba-nordic approved these changes Nov 27, 2025

View reviewed changes

Copilot AI review requested due to automatic review settings November 27, 2025 14:45

FrancescoSer force-pushed the 54h_pmopt_upd branch from 67df456 to 7abee32 Compare November 27, 2025 14:45

FrancescoSer requested a review from a team as a code owner November 27, 2025 14:45

NordicBuilder removed the changelog-entry-required Update changelog before merge. Remove label if entry is not needed or already added. label Nov 27, 2025

Copilot AI reviewed Nov 27, 2025

View reviewed changes

doc: Updated nRF54H20 PM optimization guide

724649a

Updated nRF54H20 PM optimization guide. Signed-off-by: Francesco Domenico Servidio <[email protected]>

FrancescoSer force-pushed the 54h_pmopt_upd branch from 7abee32 to 724649a Compare November 27, 2025 14:48

pizi-nordic approved these changes Nov 27, 2025

View reviewed changes

doc: Updated nRF54H20 PM optimization guide #25445

Are you sure you want to change the base?

doc: Updated nRF54H20 PM optimization guide #25445

Uh oh!

Conversation

FrancescoSer commented Nov 6, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

NordicBuilder commented Nov 6, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

CI Information

Inputs:

Sources:

Github labels

Outputs:

Toolchain

Test Spec & Results: ✅ Success; ❌ Failure; 🟠 Queued; 🟡 Progress; ◻️ Skipped; ⚠️ Quarantine

Uh oh!

github-actions bot commented Nov 6, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

FrancescoSer Nov 25, 2025

Choose a reason for hiding this comment

Uh oh!

FrancescoSer Nov 27, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

pizi-nordic left a comment

Choose a reason for hiding this comment

Uh oh!

nordic-krch Nov 26, 2025

Choose a reason for hiding this comment

Uh oh!

FrancescoSer Nov 27, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

NordicBuilder commented Nov 6, 2025 •

edited

Loading

github-actions bot commented Nov 6, 2025 •

edited

Loading