-
Notifications
You must be signed in to change notification settings - Fork 1.2k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
doc: Release notes for 2.9.0-nRF54H20
Added release notes for 2.9.0-nRF54H20 Added migration guide for 2.9.0-nRF54H20 Added other minor release edits for 2.9.0-nRF54H20 Signed-off-by: Francesco Domenico Servidio <[email protected]>
- Loading branch information
1 parent
6862306
commit ed98a65
Showing
3 changed files
with
620 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
162 changes: 162 additions & 0 deletions
162
doc/nrf/releases_and_maturity/migration/migration_guide_2.9.0-nrf54h20.rst
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,162 @@ | ||
| .. _migration_2.9.0-nrf54h20: | ||
|
|
||
| Migration guide for |NCS| v2.9.0-nRF54H20 | ||
| ######################################### | ||
|
|
||
| .. contents:: | ||
| :local: | ||
| :depth: 3 | ||
|
|
||
| This document describes the changes required or recommended when migrating your nRF54H20 application from the |NCS| v2.8.0 to the |NCS| v2.9.0-nRF54H20. | ||
|
|
||
| .. HOWTO | ||
| Add changes in the following format: | ||
| Component (for example, application, sample or libraries) | ||
| ********************************************************* | ||
| .. toggle:: | ||
| * Change1 and description | ||
| * Change2 and description | ||
| .. _migration_2.9.0-nrf54h20_required: | ||
|
|
||
| Required changes | ||
| **************** | ||
|
|
||
| The following changes are mandatory to make your application work in the same way as in previous releases. | ||
|
|
||
| nRF54H20 | ||
| ======== | ||
|
|
||
| This section describes the changes specific to the nRF54H20 SoC and DK support in the |NCS|. | ||
|
|
||
| DK compatibility | ||
| ---------------- | ||
|
|
||
| .. toggle:: | ||
|
|
||
| * The |NCS| v2.9.0-nRF54H20 is compatible only with the Engineering C - v0.9.0 and later revisions of the nRF54H20 DK, PCA10175. | ||
| Check the version number on your DK's sticker to verify its compatibility with the |NCS|. | ||
|
|
||
| Dependencies | ||
| ------------ | ||
|
|
||
| The following required dependencies for the nRF54H20 SoC and DK have been updated. | ||
|
|
||
| SDK and toolchain | ||
| +++++++++++++++++ | ||
|
|
||
| .. toggle:: | ||
|
|
||
| * To update the SDK and the toolchain, do the following: | ||
|
|
||
| 1. Open Toolchain Manager in nRF Connect for Desktop. | ||
| #. Click :guilabel:`SETTINGS` in the navigation bar to specify where you want to install the |NCS|. | ||
| #. In :guilabel:`SDK ENVIRONMENTS`, click the :guilabel:`Install` button next to the |NCS| version |release|. | ||
|
|
||
| nRF54H20 SoC binaries | ||
| +++++++++++++++++++++ | ||
|
|
||
| .. toggle:: | ||
|
|
||
| * The *nRF54H20 SoC binaries* bundle has been updated to version 0.8.0. | ||
|
|
||
| To update the SoC binaries bundle of your development kit while in Root of Trust, do the following: | ||
|
|
||
| 1. Download the `nRF54H20 SoC Binaries v0.8.0`_. | ||
|
|
||
| .. note:: | ||
| On macOS, ensure that the ZIP file is not unpacked automatically upon download. | ||
|
|
||
| #. Purge the device as follows:: | ||
|
|
||
| nrfutil device recover --core Application --serial-number <serial_number> | ||
| nrfutil device recover --core Network --serial-number <serial_number> | ||
|
|
||
| #. Erase the device as follows:: | ||
|
|
||
| nrfutil device erase --all --core Network --serial-number <snr> | ||
| nrfutil device erase --all --core Application --serial-number <snr> | ||
| nrfutil device reset --reset-kind RESET_PIN --serial-number <snr> | ||
|
|
||
| #. Run ``west update``. | ||
| #. Move the correct :file:`.zip` bundle to a folder of your choice, then run nRF Util to program the binaries using the following command:: | ||
|
|
||
| nrfutil device x-suit-dfu --firmware nrf54h20_soc_binaries_v0.8.0.zip --serial-number <serial_number> | ||
|
|
||
| #. Erase the device again as follows:: | ||
|
|
||
| nrfutil device erase --all --core Network --serial-number <snr> | ||
| nrfutil device erase --all --core Application --serial-number <snr> | ||
| nrfutil device reset --reset-kind RESET_PIN --serial-number <snr> | ||
|
|
||
| nrfutil | ||
| +++++++ | ||
|
|
||
| .. toggle:: | ||
|
|
||
| * ``nrfutil`` has been updated to version 7.13.0. | ||
|
|
||
| Install nRF Util version 7.13.0 as follows: | ||
|
|
||
| 1. Download the nRF Util executable file from the `nRF Util development tool`_ product page. | ||
| #. Add nRF Util to the system path on Linux and macOS, or environment variables on Windows, to run it from anywhere on the system. | ||
| On Linux and macOS, use one of the following options: | ||
|
|
||
| * Add nRF Util's directory to the system path. | ||
| * Move the file to a directory in the system path. | ||
|
|
||
| #. On macOS and Linux, give ``nrfutil`` execute permissions by typing ``chmod +x nrfutil`` in a terminal or using a file browser. | ||
| This is typically a checkbox found under file properties. | ||
| #. On macOS, to run the nRF Util executable, you need to allow it in the system settings. | ||
| #. Verify the version of the nRF Util installation on your machine by running the following command:: | ||
|
|
||
| nrfutil --version | ||
|
|
||
| #. If your version is below 7.13.0, run the following command to update nRF Util:: | ||
|
|
||
| nrfutil self-upgrade | ||
|
|
||
| For more information, see the `nRF Util`_ documentation. | ||
|
|
||
| nrfutil device | ||
| ++++++++++++++ | ||
|
|
||
| .. toggle:: | ||
|
|
||
| * ``nrfutil device`` has been updated to version 2.7.8. | ||
|
|
||
| Install the nRF Util ``device`` command version 2.7.8 as follows:: | ||
|
|
||
| nrfutil install device=2.7.8 --force | ||
|
|
||
| For more information, consult the `nRF Util`_ documentation. | ||
|
|
||
| nrfutil trace | ||
| +++++++++++++ | ||
|
|
||
| .. toggle:: | ||
|
|
||
| * ``nrfutil trace`` has been updated to version 3.10.0. | ||
|
|
||
| Install the nRF Util ``trace`` command version 3.10.0 as follows:: | ||
|
|
||
| nrfutil install trace=3.10.0 --force | ||
|
|
||
| For more information, consult the `nRF Util`_ documentation. | ||
|
|
||
| nrfutil suit | ||
| ++++++++++++ | ||
|
|
||
| .. toggle:: | ||
|
|
||
| * ``nrfutil suit`` has been updated to version 0.9.0. | ||
|
|
||
| Install the nRF Util ``suit`` command version 0.9.0 as follows:: | ||
|
|
||
| nrfutil install suit=0.9.0 --force | ||
|
|
||
| For more information, consult the `nRF Util`_ documentation. |
Oops, something went wrong.