Skip to content

Commit e4a47d5

Browse files
FrancescoSerrlubos
authored andcommitted
doc: Miscellaneous doc updates
Miscellaneous doc updates and fixes. Signed-off-by: Francesco Domenico Servidio <[email protected]>
1 parent d013a2d commit e4a47d5

11 files changed

+45
-47
lines changed

doc/nrf/app_dev/device_guides/working_with_nrf/nrf54h/ug_nrf54h20_custom_pcb.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ We highly recommend using the PCB layouts and component values provided by Nordi
2222
* For optimal performance, the output impedance of the **P6** and **P7** ports should match the PCB and external device pin impedance.
2323
* Use one of the following power supply options:
2424

25-
* VDDH higher than 2.2V
25+
* VDDH higher than 2.05V.
2626
* VDDH shorted to VDD at 1.8V
2727

2828
Prepare the configuration files for your custom board in the |NCS|

doc/nrf/links.txt

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1690,10 +1690,9 @@
16901690

16911691
.. _`curl`: https://curl.se/
16921692

1693-
.. _`nRF54H20 firmware bundle`: https://files.nordicsemi.com/artifactory/SDSC/external/nrf54h20_soc_binaries_v0.5.0.zip
1694-
.. _`nRF54H20 firmware bundle v0.3.3`: https://files.nordicsemi.com/artifactory/SDSC/external/nrf54h20_soc_binaries_v0.3.3.zip
1695-
.. _`nRF54H20 firmware bundle v0.5.0`: https://files.nordicsemi.com/artifactory/SDSC/external/nrf54h20_soc_binaries_v0.5.0.zip
1696-
.. _`nRF54H20 firmware bundle v0.6.2`: https://files.nordicsemi.com/artifactory/SDSC/external/nrf54h20_soc_binaries_v0.6.2.zip
1693+
.. _`nRF54H20 SoC Binaries v0.3.3`: https://files.nordicsemi.com/artifactory/SDSC/external/nrf54h20_soc_binaries_v0.3.3.zip
1694+
.. _`nRF54H20 SoC Binaries v0.5.0`: https://files.nordicsemi.com/artifactory/SDSC/external/nrf54h20_soc_binaries_v0.5.0.zip
1695+
.. _`nRF54H20 SoC Binaries v0.6.2`: https://files.nordicsemi.com/artifactory/SDSC/external/nrf54h20_soc_binaries_v0.6.2.zip
16971696
.. _`nRF54H20 SoC binaries v0.6.5`: https://files.nordicsemi.com/artifactory/SDSC/external/nrf54h20_soc_binaries_v0.6.5.zip
16981697

16991698
.. _`BICR binary file`: https://files.nordicsemi.com/artifactory/SDSC/external/bicr_ext_loadcap.hex

doc/nrf/releases_and_maturity/abi_compatibility.rst

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -18,24 +18,24 @@ When ABI compatibility is maintained, binaries of one component can interface co
1818
For example, adding a new function to a library is typically an ABI-compatible change, as existing binaries remain functional.
1919
However, changes that affect data structure layouts, such as altering field order or size, break ABI compatibility as they change the memory layout expected by existing binaries.
2020

21-
ABI Compatibility Matrix for the nrf54h20_soc_binary bundle
22-
===========================================================
21+
ABI Compatibility Matrix for the nRF54H20 SoC Binaries
22+
======================================================
2323

24-
The following table illustrates ABI compatibility between different versions of the nRF54H20 SoC binaries bundle and the |NCS|:
24+
The following table illustrates ABI compatibility between different versions of the nRF54H20 SoC binaries and the |NCS|:
2525

2626
.. list-table::
2727
:header-rows: 1
2828

2929
* - |NCS| versions
3030
- Compatible nRF54H20 SoC binaries version
3131
* - |NCS| v2.7.99-cs2
32-
- nrf54h20_soc_binaries v0.6.5
32+
- `nRF54H20 SoC Binaries v0.6.5`_
3333
* - |NCS| v2.7.99-cs1
34-
- nrf54h20_soc_binaries v0.6.2
34+
- `nRF54H20 SoC Binaries v0.6.2`_
3535
* - |NCS| v2.7.0
36-
- nrf54h20_soc_binaries v0.5.0
36+
- `nRF54H20 SoC Binaries v0.5.0`_
3737
* - |NCS| v2.6.99-cs2
38-
- nrf54h20_soc_binaries v0.3.3
38+
- `nRF54H20 SoC Binaries v0.3.3`_
3939

4040
ABI compatibility ensures that the Secure Domain and System Controller firmware binaries do not need to be recompiled each time the Application, Radio binaries, or both are recompiled, as long as they are based on a compatible NCS version.
4141
Additionally, maintaining ABI compatibility allows the nRF54H20 SoC binaries components to work together without recompilation when updating to newer |NCS| versions.

doc/nrf/releases_and_maturity/migration/2.4.99-cs3_to_2.6.99-cs2/migration_guide_2.4.99-cs3_to_2.6.99-cs2_environment.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ The main development environment changes introduced by 2.6.99-cs2 for the nRF54H
1616
* nRF Util has now replaced nRF Command Line Tools.
1717
The bootstrap script will now install and update nRF Util.
1818
* SDFW and SCFW are now provided as precompiled binaries.
19-
The Secure Domain Firmware (SDFW) and System Controller Firmware (SCFW) are no longer built from the source during the application build process, but they must be provisioned as binaries from the provided firmware bundle before the DK can be used.
19+
The Secure Domain Firmware (SDFW) and System Controller Firmware (SCFW) are no longer built from the source during the application build process, but they must be provisioned as binaries from the provided SoC binaries before the DK can be used.
2020
See the details in the `nRF54H20 DK bring-up`_ section below.
2121
* The nRF54H20 SoC lifecycle state must now be set to Root of Trust (RoT).
2222
See the details in the `Transitioning the nRF54H20 SoC to RoT`_ section.
@@ -272,9 +272,9 @@ Programming the SDFW and SCFW
272272
=============================
273273

274274
After programming the BICR, the nRF54H20 SoC requires the provisioning of a bundle ( :file:`nrf54h20_soc_binaries_v0.3.3.zip`) containing the precompiled firmware for the Secure Domain and System Controller.
275-
To program the Secure Domain Firmware (SDFW, also known as ``urot``) and the System Controller Firmware (SCFW) from the firmware bundle to the nRF54H20 DK, do the following:
275+
To program the Secure Domain Firmware (SDFW, also known as ``urot``) and the System Controller Firmware (SCFW) from the SoC binaries to the nRF54H20 DK, do the following:
276276

277-
1. Download the `nRF54H20 firmware bundle`_.
277+
1. Download the `nRF54H20 SoC binaries v0.3.3`_.
278278
#. Move the :file:`ZIP` bundle to a folder of your choice, then run nRF Util to program the binaries using the following command::
279279

280280
nrfutil device x-provision-nrf54h --firmware <path-to_bundle_zip_file> --serial-number <serial_number>
@@ -284,7 +284,7 @@ To program the Secure Domain Firmware (SDFW, also known as ``urot``) and the Sys
284284
Updating the FICR
285285
=================
286286

287-
After programming the SDFW and SCFW from the firmware bundle, you must update the Factory Information Configuration Registers (FICR) to correctly configure some trims of the nRF54H20 SoC.
287+
After programming the SDFW and SCFW from the SoC binaries, you must update the Factory Information Configuration Registers (FICR) to correctly configure some trims of the nRF54H20 SoC.
288288
To update the FICR, you must run a J-Link script:
289289

290290
1. Get the Jlink script that updates the FICR::

doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7.rst

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -29,9 +29,8 @@ See the following documents, based on the version you are migrating from.
2929
nRF54H20_migration_2.7/migration_guide_2.6.99-cs2_to_2_7_environment
3030
nRF54H20_migration_2.7/migration_guide_2.6.99-cs2_to_2.7_application
3131

32-
.. toctree::
33-
:maxdepth: 1
34-
:caption: Other relevant migration documents
3532

36-
migration_hwmv2
37-
migration_sysbuild
33+
Consult also the following pages about *Hardware model v2* and *Sysbuild*:
34+
35+
* :ref:`hwmv1_to_v2_migration`
36+
* :ref:`child_parent_to_sysbuild_migration`

doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7_99-cs1.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -47,14 +47,14 @@ nRF54H20 BICR
4747
nrfutil device program --options chip_erase_mode=ERASE_NONE --firmware <path_to_bicr.hex> --core Application --serial-number <serialnumber>
4848

4949
SDFW and SCFW firmwares
50-
The *nRF54H20 firmware bundle* has been updated to version 0.6.2.
50+
The *nRF54H20 SoC binaries* have been updated to version 0.6.2.
5151

5252
.. caution::
53-
Before proceeding with the firmware bundle update, you must first update the BICR as described in the previous chapter.
53+
Before proceeding with the SoC binaries update, you must first update the BICR as described in the previous chapter.
5454

55-
To update the firmware bundle of your development kit while in Root of Trust, do the following:
55+
To update the SoC binaries of your development kit while in Root of Trust, do the following:
5656

57-
1. Download the `nRF54H20 firmware bundle v0.6.2`_.
57+
1. Download the `nRF54H20 SoC binaries v0.6.2`_.
5858

5959
.. note::
6060
On MacOS, ensure that the ZIP file is not unpacked automatically upon download.

doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7_99-cs2.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ SDFW and SCFW firmwares
6262
The *nRF54H20 SoC binaries* bundle has been updated to version 0.6.5.
6363

6464
.. caution::
65-
If migrating from |NCS| v2.7.0, before proceeding with the firmware bundle update, you must first update the BICR as described in the previous chapter.
65+
If migrating from |NCS| v2.7.0, before proceeding with the SoC binaries update, you must first update the BICR as described in the previous chapter.
6666

6767
To update the SoC binaries bundle of your development kit while in Root of Trust, do the following:
6868

doc/nrf/releases_and_maturity/migration/nRF54H20_migration_2.7/migration_guide_2.4.99-cs3_to_2.7_application.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -31,10 +31,10 @@ DTS changes
3131
The layout of DTS files and the names of DTS nodes related to the updated board names have been updated, which also affects overlay files from applications and samples.
3232
If your application required a specific custom board, you must update the custom board files to match the changes done to the nRF54H20 SoC DTS files.
3333

34-
SDFW and SCFW firmware bundle
34+
nRF54H20 SoC binaries
3535
The Secure Domain Firmware (SDFW) and System Controller Firmware (SCFW) are no longer built from the source during the application build process.
36-
They are provided as a firmware bundle (v0.5.0) and provisioned to the nRF54H20 during the bring-up steps.
37-
The nRF54H20 DK must be in lifecycle state ``EMPTY`` to be provisioned with the new firmware bundle.
36+
They are provided as a SoC binaries bundle (v0.5.0) and provisioned to the nRF54H20 during the bring-up steps.
37+
The nRF54H20 DK must be in lifecycle state ``EMPTY`` to be provisioned with the new SoC binaries.
3838
For additional details, see :ref:`transition_cs3_to_2_7_env_bringup`.
3939

4040
nRF Util is now the main command line backend utility.

doc/nrf/releases_and_maturity/migration/nRF54H20_migration_2.7/migration_guide_2.6.99-cs2_to_2.7_application.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -28,10 +28,10 @@ Hardware Model v2
2828
A new hardware model was recently introduced in the |NCS|.
2929
For more information, see :ref:`hwmv1_to_v2_migration`.
3030

31-
SDFW and SCFW firmware bundle
32-
A new version (v0.5.0) of the SDFW and SCFW firmware bundle was released.
31+
nRF54H20 SoC binaries
32+
A new version (v0.5.0) of the nRF54H20 SoC binaries was released.
3333
This is the only version compatible with the |NCS| v2.7.0.
34-
The nRF54H20 DK must be in lifecycle state ``EMPTY`` to be provisioned with the new firmware bundle.
34+
The nRF54H20 DK must be in lifecycle state ``EMPTY`` to be provisioned with the new SoC binaries.
3535

3636
DTS changes
3737
The layout of DTS files and the names of DTS nodes related to the updated board names have been updated, which also affects overlay files from applications and samples.

doc/nrf/releases_and_maturity/migration/nRF54H20_migration_2.7/migration_guide_2.6.99-cs2_to_2_7_environment.rst

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -18,10 +18,10 @@ The following is a summary of the most important ones:
1818
Updated |NCS| toolchain
1919
The |NCS| toolchain has been updated.
2020

21-
SDFW and SCFW firmware bundle
22-
A new version (v0.5.0) of the SDFW and SCFW firmware bundle was released.
21+
SDFW and SCFW SoC binaries
22+
A new version (v0.5.0) of the nRF54H20 SoC binaries bundle was released.
2323
This is the only version compatible with the |NCS| v2.7.0.
24-
The nRF54H20 DK must be in lifecycle state ``EMPTY`` to be provisioned with the new firmware bundle.
24+
The nRF54H20 DK must be in lifecycle state ``EMPTY`` to be provisioned with the new SoC binaries.
2525

2626
Minimum requirements
2727
********************
@@ -155,7 +155,7 @@ Verify the LCS of the device
155155

156156
The current nRF54H20 DK is delivered with its lifecycle state (LCS) set to ``EMPTY``.
157157
To correctly operate, its lifecycle state must be transitioned to Root of Trust (``RoT``) through the bring-up steps.
158-
To be compatible with |NCS| v2.7.0, the SDFW and SCFW firmware bundle programmed on the nRF54H20 DK during through the bring-up steps must be v0.5.0.
158+
To be compatible with |NCS| v2.7.0, the nRF54H20 SoC binaries programmed on the nRF54H20 DK during through the bring-up steps must be v0.5.0.
159159

160160
.. note::
161161
The forward transition to LCS ``RoT`` is permanent.
@@ -187,11 +187,11 @@ The output will look similar to the following::
187187
If the lifecycle state (``psa_lifecycle``) shown is not ``RoT`` (``LIFECYCLE_EMPTY (0x1000)`` means the LCS is set to ``EMPTY``) you can follow the bring-up steps in the next chapter.
188188
If the lifecycle state (``psa_lifecycle``) shown is ``RoT`` (``LIFECYCLE_ROT (0x2000)``), the device is in Root of Trust:
189189

190-
* If your nRF54H20 DK was already programmed with the SDFW and SCFW firmware bundle version 0.5.0, you can jump to the :ref:`migration_cs2_to_2_7_env_nextsteps` chapter.
191-
* If your current nRF54H20 DK was programmed with a firmware bundle version 0.3.x:
190+
* If your nRF54H20 DK was already programmed with the nRF54H20 SoC binaries version 0.5.0, you can jump to the :ref:`migration_cs2_to_2_7_env_nextsteps` chapter.
191+
* If your current nRF54H20 DK was programmed with the SoC binaries version 0.3.x:
192192

193193
* Use a different nRF54H20 DK with LCS ``EMPTY`` and continue to the nRF54H20 bring-up.
194-
* Use a different nRF54H20 DK with LCS ``RoT`` and already programmed with the firmware bundle version 0.5.0.
194+
* Use a different nRF54H20 DK with LCS ``RoT`` and already programmed with the SoC binaries version 0.5.0.
195195

196196
nRF54H20 DK bring-up
197197
********************
@@ -231,9 +231,9 @@ Provisioning the SDFW and SCFW
231231
==============================
232232

233233
After programming the BICR, the nRF54H20 SoC requires the provisioning of a bundle ( :file:`nrf54h20_soc_binaries_v0.5.0.zip`) containing the precompiled firmware for the Secure Domain and System Controller.
234-
To program the Secure Domain Firmware (SDFW, also known as ``urot``) and the System Controller Firmware (SCFW) from the firmware bundle to the nRF54H20 DK, do the following:
234+
To program the Secure Domain Firmware (SDFW, also known as ``urot``) and the System Controller Firmware (SCFW) from the SoC binaries to the nRF54H20 DK, do the following:
235235

236-
1. Download the `nRF54H20 firmware bundle v0.5.0`_.
236+
1. Download the `nRF54H20 SoC binaries v0.5.0`_.
237237

238238
.. note::
239239
On MacOS, ensure that the ZIP file is not unpacked automatically upon download.
@@ -251,7 +251,7 @@ Updating the FICR
251251
This step is required only if your nRF54H20 DK is version PCA10175 v0.7.2 or v0.8.0 ES3.3.
252252
Jump to the next step if your DK is version ES4, meaning v0.8.0 with no ES markings.
253253

254-
After programming the SDFW and SCFW from the firmware bundle, you must update the Factory Information Configuration Registers (FICR) to correctly configure some trims of the nRF54H20 SoC.
254+
After programming the SDFW and SCFW from the SoC binaries, you must update the Factory Information Configuration Registers (FICR) to correctly configure some trims of the nRF54H20 SoC.
255255
To update the FICR, you must run a J-Link script:
256256

257257
1. Get the Jlink script that updates the FICR::

0 commit comments

Comments
 (0)