Skip to content

Commit e6d9e89

Browse files
FrancescoSerrlubos
authored andcommitted
doc: Improvements to nRF54H documentation
Improvements to nRF54H documentation. Signed-off-by: Francesco Domenico Servidio <[email protected]> (cherry picked from commit 893b0b6)
1 parent e636ef6 commit e6d9e89

File tree

4 files changed

+33
-7
lines changed

4 files changed

+33
-7
lines changed

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

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -135,6 +135,10 @@ nRF54H20 DK bring-up
135135

136136
The following sections describe the steps required for the nRF54H20 bring-up.
137137

138+
.. note::
139+
To program the nRF54H20 SoC binaries based on IronSide SE on your nRF54H20 SoC-based device, your device must be in lifecycle state (LCS) ``EMPTY``.
140+
Devices already provisioned using SUIT-based binaries and in LCS RoT cannot be transitioned back to LCS EMPTY.
141+
138142
.. rst-class:: numbered-step
139143

140144
Programming the BICR

doc/nrf/releases_and_maturity/abi_compatibility.rst

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,11 @@ Additionally, maintaining ABI compatibility allows the nRF54H20 SoC binary compo
5757
The nRF54H20 SoC binaries only support specific versions of the |NCS| and do not support rollbacks to previous versions.
5858
Upgrading the nRF54H20 SoC binaries on your development kit might break the DK's compatibility with applications developed for earlier versions of the |NCS|.
5959

60+
Provisioning the nRF54H20 SoC
61+
*****************************
62+
63+
To provision the nRF54H20 SoC using the nRF54H20 SoC binaries, see :ref:`ug_nrf54h20_gs_bringup`.
64+
6065
nRF54H20 SoC binaries v22.2.0+14 changelog
6166
******************************************
6267

doc/nrf/releases_and_maturity/migration/migration_3.1_54h_suit_ironside.rst

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@
22

33
.. _migration_3.1_54h_suit_ironside:
44

5-
Migration from SUIT to IronSide SE for the nRF54H20 SoC
6-
#######################################################
5+
Migrating applications from |NCS| v3.0.0 (SUIT) to |NCS| v3.1.0 (IronSide SE) on the nRF54H20 SoC
6+
#################################################################################################
77

88
.. contents::
99
:local:
@@ -17,9 +17,13 @@ To follow this guide, you must meet the following prerequisites:
1717
* You have installed the |NCS| v3.1.0 and its toolchain.
1818
For more information, see :ref:`install_ncs`.
1919

20+
Moreover, to program your modified application on the nRF54H20 SoC, your nRF54H20-based device must be provisioned with the relevant nRF54H20 SoC binaries version.
21+
For more information, see :ref:`abi_compatibility`.
22+
2023
.. note::
21-
To program IronSide SE on your nRF54H20 SoC-based device, your device must be in lifecycle state (LCS) ``EMPTY``.
22-
Devices using SUIT in LCS RoT cannot be transitioned back to LCS EMPTY.
24+
To program the nRF54H20 SoC binaries based on IronSide SE on your nRF54H20 SoC-based device, your device must be in lifecycle state (LCS) ``EMPTY``.
25+
Devices already provisioned using SUIT-based binaries and in LCS RoT cannot be transitioned back to LCS EMPTY.
26+
For more information on provisioning new devices, see :ref:`ug_nrf54h20_gs_bringup`.
2327

2428
Breaking changes
2529
****************
@@ -74,7 +78,7 @@ To update your devicetree files, complete the following steps:
7478
In your board's DTS overlay, remove any node that defined the ``uicr`` partition.
7579

7680
#. Add the PERIPHCONF array.
77-
In your devicetree, under the ``mram1x`` partitions node, define a partition node labeled ``peripconf_partition`` with a size of at least 8 KB to embed the generated address-value blob.
81+
In your devicetree, under the ``mram1x`` partitions node, define a partition node labeled ``periphconf_partition`` with a size of at least 8 KB to embed the generated address-value blob.
7882

7983
#. Remove IPC-shared-memory reservation.
8084
As IronSide relocates the IPC buffer to a fixed RAM20 address, you can delete any manual reservation in RAM0.
@@ -132,7 +136,7 @@ When the following Kconfig options are set:
132136

133137
the script does the following:
134138

135-
1. It reads the ``peripconf_partition`` node in the devicetree to discover the partition's address and size.
139+
1. It reads the ``periphconf_partition`` node in the devicetree to discover the partition's address and size.
136140
#. It extracts the address/value pairs from the ``PERIPHCONF`` section of the Zephyr ELF image.
137141
#. It generates two Intel HEX files:
138142

@@ -170,7 +174,7 @@ With IronSide SE, the memory map changed as follows:
170174
Remove memory access groups, such as ``cpuapp_rx_partitions``, ``cpurad_rx_partitions``, ``cpuapp_rw_partitions`` and define partitions under the ``partitions`` node under the ``mram1x`` node.
171175
Refer to the `nRF54H20 DK memory map`_ for details.
172176

173-
To enable ``UICR/PERIPHCONF`` generation, ensure a DTS partition labeled ``peripconf_partition`` exists with sufficient size (for example, 8 KBs) to embed the generated address-value blob.
177+
To enable ``UICR/PERIPHCONF`` generation, ensure a DTS partition labeled ``periphconf_partition`` exists with sufficient size (for example, 8 KBs) to embed the generated address-value blob.
174178

175179
DFU support with MCUboot
176180
========================

doc/nrf/releases_and_maturity/migration/migration_guide_3.1.rst

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,19 @@ nRF54H20
7474

7575
This section describes the changes specific to the nRF54H20 SoC and DK support in the |NCS|.
7676

77+
nRF54H20 SoC binaries
78+
---------------------
79+
80+
.. toggle::
81+
82+
* The nRF54H20 SoC binaries have been updated to version v22.2.0+14, and are now based on IronSide SE.
83+
For more information, see :ref:`abi_compatibility`.
84+
85+
.. note::
86+
To program the nRF54H20 SoC binaries based on IronSide SE on your nRF54H20 SoC-based device, your device must be in lifecycle state (LCS) ``EMPTY``.
87+
Devices already provisioned using SUIT-based binaries and in LCS RoT cannot be transitioned back to LCS EMPTY.
88+
For more information on provisioning new devices, see :ref:`ug_nrf54h20_gs_bringup`.
89+
7790
SUIT to IronSide SE migration
7891
-----------------------------
7992

0 commit comments

Comments
 (0)