Skip to content

Commit 1114bcf

Browse files
committed
doc: ironside: Consolidate release archive info
Programming steps are discussed in the update docs, as that process is either part of the manual update or provisioning; the latter being documented elsewhere. Describing the ZIP archive is expanded into a release deliverable section and moved into the update context. Default configurations aren't strictly related to either but are still important to discuss in general ISE. Ref: NCSDK-33336 Signed-off-by: Stephen Stauts <stephen.stauts@nordicsemi.no>
1 parent a6d1e83 commit 1114bcf

File tree

2 files changed

+54
-31
lines changed

2 files changed

+54
-31
lines changed

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

Lines changed: 21 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -30,48 +30,34 @@ See the following pages for details on some |ISE| features and subsystems.
3030

3131
ug_nrf54h20_ironside_update
3232

33-
.. _ug_nrf54h20_ironside_se_programming:
33+
Default policies
34+
****************
3435

35-
Programming |ISE| on the nRF54H20 SoC
36-
*************************************
37-
38-
|ISE| is released independently of the |NCS| release cycle and is provided as a ZIP archive that contains the following components:
36+
By default, |ISE| uses the following memory and access configurations on the nRF54H20 SoC:
3937

4038
.. list-table::
4139
:header-rows: 1
4240
:widths: auto
4341

44-
* - Component
45-
- File
46-
- Description
47-
* - IronSide SE firmware
48-
- :file:`ironside_se.hex`
49-
- Used when bringing up a new DK and programming both the recovery firmware and |ISE| for the first time.
50-
* - IronSide SE update firmware
51-
- :file:`ironside_se_update.hex`
52-
- Used when updating |ISE|.
53-
* - IronSide SE Recovery update firmware
54-
- :file:`ironside_se_recovery_update.hex`
55-
- The recovery firmware, reserved for future recovery operations. Currently, it does not provide user-facing functionality. Used when updating the recovery firmware.
56-
* - Update application
57-
- :file:`update_application.hex`
58-
- The local domain :zephyr:code-sample:`update application <nrf_ironside_update>` that is used to perform an |ISE| update. See :ref:`ug_nrf54h20_ironside_se_update_manual`.
59-
60-
For instructions on how to program |ISE|, see :ref:`ug_nrf54h20_SoC_binaries`.
61-
62-
By default, the nRF54H20 SoC uses the following memory and access configurations:
63-
64-
* MRAMC configuration: MRAM operates in Direct Write mode with READYNEXTTIMEOUT disabled.
65-
* MPC configuration: All memory not reserved by Nordic firmware is accessible with read, write, and execute (RWX) permissions by any domain.
66-
* TAMPC configuration: The access ports (AP) for the local domains are enabled, allowing direct programming of all the memory not reserved by Nordic firmware in the default configuration.
67-
42+
* - Configuration
43+
- Policy
44+
* - MRAMC
45+
- MRAM operates in Direct Write mode with READYNEXTTIMEOUT disabled.
46+
* - MPC
47+
- All memory not reserved by Nordic firmware is accessible with read, write, and execute (RWX) permissions by any domain.
48+
* - TAMPC
49+
- Access ports (AP) for the local domains are enabled, allowing direct programming of all the memory not reserved by Nordic firmware in the default configuration.
6850

6951
.. note::
7052
* The Radio Domain AP is only usable when the Radio domain has booted.
7153
* Access to external memory (EXMIF) requires a non-default configuration of the GPIO.CTRLSEL register.
7254

73-
You can protect global domain memory from write operations by configuring the UICR registers.
74-
To remove these protections and disable all other protection mechanisms enforced through UICR settings, perform an ``ERASEALL`` operation.
55+
Restricting default memory access
56+
=================================
57+
58+
Global domain memory can be protected from write operations by configuring the :ref:`UICR.PROTECTEDMEM <ug_nrf54h20_ironside_se_protected_memory>` registers.
59+
60+
Performing an ``ERASEALL`` operation will remove the memory protections and disable all other protection mechanisms enforced through default UICR settings.
7561

7662
.. _ug_nrf54h20_ironside_se_uicr:
7763

@@ -311,6 +297,8 @@ However, it does not prevent erase operations initiated through other means, suc
311297
If this configuration is enabled and :kconfig:option:`CONFIG_GEN_UICR_LOCK` is also set, it is no longer possible to modify the UICR in any way.
312298
Therefore, this configuration should only be enabled during the final stages of production.
313299

300+
.. _ug_nrf54h20_ironside_se_protected_memory:
301+
314302
UICR.PROTECTEDMEM
315303
=================
316304

@@ -1123,6 +1111,8 @@ See the following table for a summary of the available boot commands:
11231111

11241112
The following chapters describe each command in detail.
11251113

1114+
.. _ug_nrf54h20_ironside_se_eraseall:
1115+
11261116
``ERASEALL`` command
11271117
====================
11281118

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

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,39 @@ Updating the |ISE| is possible after it has been initially :ref:`provisioned <ug
1111

1212
The update operation is initiated through its :ref:`update service <ug_nrf54h20_ironside_se_update_service>` at runtime by application firmware.
1313

14+
.. _ug_nrf54h20_ironside_se_deliverables:
15+
16+
Release package
17+
***************
18+
19+
The |ISE| is released independently of the |NCS| release cycle and is provided as a ZIP archive.
20+
21+
The archive is used to update the existing |ISE| firmware on the nRF54H20 and consists of the following components:
22+
23+
.. list-table::
24+
:header-rows: 1
25+
:widths: auto
26+
27+
* - Component
28+
- File
29+
- Description
30+
* - IronSide SE firmware
31+
- :file:`ironside_se.hex`
32+
- Used when bringing up a new DK and programming both the recovery firmware and |ISE| for the first time.
33+
* - IronSide SE update firmware
34+
- :file:`ironside_se_update.hex`
35+
- Used when updating |ISE|.
36+
* - IronSide SE Recovery update firmware
37+
- :file:`ironside_se_recovery_update.hex`
38+
- The recovery firmware, reserved for future recovery operations. Currently, it does not provide user-facing functionality. Used when updating the recovery firmware.
39+
* - Update application
40+
- :file:`update_application.hex`
41+
- The local domain :zephyr:code-sample:`update application <nrf_ironside_update>` that is used to perform an |ISE| update. See :ref:`ug_nrf54h20_ironside_se_update_architecture` for details on its role.
42+
43+
For more information on |ISE| release binaries, see :ref:`abi_compatibility`.
44+
45+
For instructions on how to provision the nRF54H20 with |ISE| for the first time, see :ref:`ug_nrf54h20_SoC_binaries`.
46+
1447
.. _ug_nrf54h20_ironside_se_updating:
1548

1649
Performing an update

0 commit comments

Comments
 (0)