You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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>
Copy file name to clipboardExpand all lines: doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_ironside.rst
+21-31Lines changed: 21 additions & 31 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -30,48 +30,34 @@ See the following pages for details on some |ISE| features and subsystems.
30
30
31
31
ug_nrf54h20_ironside_update
32
32
33
-
.. _ug_nrf54h20_ironside_se_programming:
33
+
Default policies
34
+
****************
34
35
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:
39
37
40
38
.. list-table::
41
39
:header-rows: 1
42
40
:widths: auto
43
41
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.
68
50
69
51
.. note::
70
52
* The Radio Domain AP is only usable when the Radio domain has booted.
71
53
* Access to external memory (EXMIF) requires a non-default configuration of the GPIO.CTRLSEL register.
72
54
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.
75
61
76
62
.. _ug_nrf54h20_ironside_se_uicr:
77
63
@@ -311,6 +297,8 @@ However, it does not prevent erase operations initiated through other means, suc
311
297
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.
312
298
Therefore, this configuration should only be enabled during the final stages of production.
313
299
300
+
.. _ug_nrf54h20_ironside_se_protected_memory:
301
+
314
302
UICR.PROTECTEDMEM
315
303
=================
316
304
@@ -1123,6 +1111,8 @@ See the following table for a summary of the available boot commands:
1123
1111
1124
1112
The following chapters describe each command in detail.
Copy file name to clipboardExpand all lines: doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_ironside_update.rst
+33Lines changed: 33 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,6 +11,39 @@ Updating the |ISE| is possible after it has been initially :ref:`provisioned <ug
11
11
12
12
The update operation is initiated through its :ref:`update service <ug_nrf54h20_ironside_se_update_service>` at runtime by application firmware.
13
13
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`.
0 commit comments