From ddddef5ed7e0d66f851f2b56e19cab25a1a58ce3 Mon Sep 17 00:00:00 2001 From: Francesco Domenico Servidio Date: Thu, 27 Nov 2025 16:50:51 +0100 Subject: [PATCH] doc: Misc doc edits pre 3.2.0-rc1 release Miscellaneous doc updates -for the upcoming 3.2.0-rc1 release. Signed-off-by: Francesco Domenico Servidio --- .../device_guides/nrf54h/ug_nrf54h20_gs.rst | 59 ++++++++++++++++++- .../migration/migration_guide_3.2.rst | 2 +- .../releases/release-notes-changelog.rst | 1 + doc/nrf/shortcuts.txt | 4 +- 4 files changed, 60 insertions(+), 6 deletions(-) diff --git a/doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_gs.rst b/doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_gs.rst index 70d8a2b0563..aef5c036412 100644 --- a/doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_gs.rst +++ b/doc/nrf/app_dev/device_guides/nrf54h/ug_nrf54h20_gs.rst @@ -39,7 +39,7 @@ To follow this guide, make sure you have all the required hardware: Installing the |NCS| ******************** -Install the |NCS| following the instructions in the :ref:`install_ncs` documentation page. +Install the |NCS| following the instructions for both Visual Studio Code and the command line in the :ref:`install_ncs` documentation page. .. rst-class:: numbered-step @@ -60,6 +60,8 @@ Using the nRF54H20 DK with the |NCS| version |release| also requires the followi +----------------------------------------------+-------------------------------------+ | nRF Util ``trace`` command | version |54H_nrfutil_trace_ver| | +----------------------------------------------+-------------------------------------+ +| nRF Util ``sdk-manager`` command | Latest | ++----------------------------------------------+-------------------------------------+ To install the required versions of the nRF Util commands, complete the following steps: @@ -82,6 +84,7 @@ To install the required versions of the nRF Util commands, complete the followin nrfutil install device=\ |54H_nrfutil_device_ver|\ --force nrfutil install trace=\ |54H_nrfutil_trace_ver|\ --force + nrfutil install sdk-manager For more information, see the `Installing specific versions of nRF Util commands`_ documentation. @@ -91,6 +94,7 @@ To install the required versions of the nRF Util commands, complete the followin nrfutil device --version nrfutil trace --version + nrfutil sdk-manager --version The output will show the installed versions. Ensure they match the required versions. @@ -194,8 +198,57 @@ It uses the ``nrf54h20dk/nrf54h20/cpuapp`` board target. To build and program the sample to the nRF54H20 DK, complete the following steps: 1. Connect the nRF54H20 DK to your computer using the **DEBUGGER** port on the DK. -#. Open nRF Connect for Desktop, navigate to the Toolchain Manager, select the version |release| toolchain, and click the :guilabel:`Open terminal` button. -#. In the terminal window, navigate to the :file:`zephyr/samples/sysbuild/hello_world` folder containing the sample. +#. Start the toolchain environment for your operating system using the following command pattern, with ``--ncs-version`` corresponding to the |NCS| version you have installed: + + .. tabs:: + + .. tab:: Windows + + .. parsed-literal:: + :class: highlight + + nrfutil sdk-manager toolchain launch --ncs-version *version* --terminal + + For example: + + .. parsed-literal:: + :class: highlight + + nrfutil sdk-manager toolchain launch --ncs-version |release| --terminal + + This example command starts the toolchain environment for the |NCS| |release|. + + .. tab:: Linux + + .. parsed-literal:: + :class: highlight + + nrfutil sdk-manager toolchain launch --ncs-version *version* --shell + + For example: + + .. parsed-literal:: + :class: highlight + + nrfutil sdk-manager toolchain launch --ncs-version |release| --shell + + This example command starts the toolchain environment for the |NCS| |release|. + + .. tab:: macOS + + .. parsed-literal:: + :class: highlight + + nrfutil sdk-manager toolchain launch --ncs-version *version* --shell + + For example: + + .. parsed-literal:: + :class: highlight + + nrfutil sdk-manager toolchain launch --ncs-version |release| --shell + + This example command starts the toolchain environment for the |NCS| |release|.#. In the terminal window, navigate to the :file:`zephyr/samples/sysbuild/hello_world` folder containing the sample. #. Run the following command to build the sample for application and radio cores:: west build -p -b nrf54h20dk/nrf54h20/cpuapp -T sample.sysbuild.hello_world.nrf54h20dk_cpuapp_cpurad . diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_3.2.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_3.2.rst index 986223daa8a..78f53aedaca 100644 --- a/doc/nrf/releases_and_maturity/migration/migration_guide_3.2.rst +++ b/doc/nrf/releases_and_maturity/migration/migration_guide_3.2.rst @@ -34,7 +34,7 @@ nRF54H20 IronSide SE binaries .. toggle:: - * The nRF54H20 IronSide SE binaries have been updated to version v23.0.1+16. + * The nRF54H20 IronSide SE binaries have been updated to version v23.1.0+19. Starting from the |NCS| v3.2.0, you should always upgrade your nRF54H20 IronSide SE binaries to the latest version. For more information, see: diff --git a/doc/nrf/releases_and_maturity/releases/release-notes-changelog.rst b/doc/nrf/releases_and_maturity/releases/release-notes-changelog.rst index cbc5ec521c8..4e5ff20b9e6 100644 --- a/doc/nrf/releases_and_maturity/releases/release-notes-changelog.rst +++ b/doc/nrf/releases_and_maturity/releases/release-notes-changelog.rst @@ -1236,3 +1236,4 @@ Documentation * The :ref:`app_power_opt_nRF91` page by moving it under the :ref:`ug_lte` section. * The nRF54H20 SoC binaries are now called nRF54H20 IronSide SE binaries. * The :ref:`ug_nrf54h20_custom_pcb` documentation to clarify how to configure the BICR for a custom PCB based on the nRF54H20 SoC. + * The :ref:`ug_nrf54h20_gs` page to update the getting started instructions for the nRF54H20 DK. diff --git a/doc/nrf/shortcuts.txt b/doc/nrf/shortcuts.txt index a66e28b6751..26603b1a2d5 100644 --- a/doc/nrf/shortcuts.txt +++ b/doc/nrf/shortcuts.txt @@ -8,8 +8,8 @@ .. |jlink_ver| replace:: v8.76 -.. |54H_nrfutil_device_ver| replace:: 2.13.1 -.. |54H_nrfutil_trace_ver| replace:: 4.0.1 +.. |54H_nrfutil_device_ver| replace:: 2.15.2 +.. |54H_nrfutil_trace_ver| replace:: 4.4.0 .. ### Config shortcuts