From 36ba0482c02eedbf3aaddddd777342ff5b1bead9 Mon Sep 17 00:00:00 2001 From: Francesco Domenico Servidio Date: Fri, 15 Nov 2024 11:43:14 +0100 Subject: [PATCH] doc: 54H EngB + C support drop Updated docs to mention end of support for 54H20 EngB EngC. Signed-off-by: Francesco Domenico Servidio --- .../nrf54h/ug_nrf54h20_gs.rst | 23 +++++---------- .../abi_compatibility.rst | 2 ++ .../migration/migration_guide_2.9.rst | 29 +++++++++++++++++++ doc/nrf/shortcuts.txt | 3 +- 4 files changed, 39 insertions(+), 18 deletions(-) diff --git a/doc/nrf/app_dev/device_guides/working_with_nrf/nrf54h/ug_nrf54h20_gs.rst b/doc/nrf/app_dev/device_guides/working_with_nrf/nrf54h/ug_nrf54h20_gs.rst index f5378d123c1b..9d19636c6fd9 100644 --- a/doc/nrf/app_dev/device_guides/working_with_nrf/nrf54h/ug_nrf54h20_gs.rst +++ b/doc/nrf/app_dev/device_guides/working_with_nrf/nrf54h/ug_nrf54h20_gs.rst @@ -20,13 +20,13 @@ Make sure you have all the required hardware and that your computer has one of t Hardware ======== -* nRF54H20 DK version PCA10175: - - * Engineering B - ranging from v0.8.0 to 0.8.2 - * Engineering C - v0.8.3 and later revisions +* nRF54H20 DK version PCA10175 Engineering C - v0.8.3 and later revisions Check the version number on your DK's sticker to verify its compatibility with the |NCS|. +.. note:: + |54H_engb_2_8| + * USB-C cable. Software @@ -241,10 +241,7 @@ Programming the nRF54H20 SoC binaries After programming the BICR, the nRF54H20 SoC requires the provisioning of the nRF54H20 SoC binaries, a bundle containing the precompiled firmware for the Secure Domain and System Controller. To program the nRF54H20 SoC binaries to the nRF54H20 DK, do the following: -1. Download the nRF54H20 SoC binaries v0.7.0: - - * `nRF54H20 SoC Binaries v0.7.0 for EngC DKs`_, compatible with the nRF54H20 DK v0.8.3 and later revisions - * `nRF54H20 SoC Binaries v0.7.0 for EngB DKs`_, compatible with the nRF54H20 DKs ranging from v0.8.0 to v0.8.2. +1. Download the `nRF54H20 SoC Binaries v0.7.0 for EngC DKs`_, compatible with the nRF54H20 DK v0.8.3 and later revisions. .. note:: On MacOS, ensure that the ZIP file is not unpacked automatically upon download. @@ -288,15 +285,9 @@ 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. -#. Build the sample for application and radio cores by running the following commands: - - * For Engineering C (DKs 0.8.3 and later revisions):: - - west build -p -b nrf54h20dk/nrf54h20/cpuapp -T sample.sysbuild.hello_world.nrf54h20dk_cpuapp_cpurad . - - * For Engineering B (DKs from v0.8.0 to 0.8.2):: +#. Build the sample for application and radio cores by running the following command:: - west build -p -b nrf54h20dk@0.8.0/nrf54h20/cpuapp -T sample.sysbuild.hello_world.nrf54h20dk_cpuapp_cpurad . + west build -p -b nrf54h20dk/nrf54h20/cpuapp -T sample.sysbuild.hello_world.nrf54h20dk_cpuapp_cpurad . You can now program the sample. If you have multiple Nordic Semiconductor devices, make sure that only the nRF54H20 DK you want to program is connected. diff --git a/doc/nrf/releases_and_maturity/abi_compatibility.rst b/doc/nrf/releases_and_maturity/abi_compatibility.rst index e8e5e9185569..bfaceb3529e2 100644 --- a/doc/nrf/releases_and_maturity/abi_compatibility.rst +++ b/doc/nrf/releases_and_maturity/abi_compatibility.rst @@ -28,6 +28,8 @@ The following table illustrates ABI compatibility between different versions of * - |NCS| versions - Compatible nRF54H20 SoC binaries version + * - |NCS| v2.9.0 + - `nRF54H20 SoC Binaries v0.7.0 for EngC DKs`_, compatible with the nRF54H20 DK v0.8.3 and later revisions. * - |NCS| v2.8.0 - `nRF54H20 SoC Binaries v0.7.0 for EngC DKs`_, compatible with the nRF54H20 DK v0.8.3 and later revisions. `nRF54H20 SoC Binaries v0.7.0 for EngB DKs`_, compatible with the nRF54H20 DKs ranging from v0.8.0 to v0.8.2. diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_2.9.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_2.9.rst index 35c51418034b..f1e18fccd236 100644 --- a/doc/nrf/releases_and_maturity/migration/migration_guide_2.9.rst +++ b/doc/nrf/releases_and_maturity/migration/migration_guide_2.9.rst @@ -28,6 +28,28 @@ 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|. +For more information on changes related to samples and applications usage on the nRF54H20 DK, see :ref:`migration_2.9_required_nrf54h`. + +DK compatibility +---------------- + +.. toggle:: + + * The |NCS| v2.9.0 is compatible only with the following versions of the nRF54H20 DK, PCA10175: Engineering C - v0.8.3 and later revisions. + The nRF54H20 DK Engineering A and Engineering B (up to v0.8.2) are no longer compatible with the |NCS| v2.9.0. + + 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. + + Samples and applications ======================== @@ -35,6 +57,13 @@ This section describes the changes related to samples and applications. |no_changes_yet_note| +.. _migration_2.9_required_nrf54h: + +nRF54H20 +-------- + +|no_changes_yet_note| + Libraries ========= diff --git a/doc/nrf/shortcuts.txt b/doc/nrf/shortcuts.txt index 42f1e4776764..3924554d7291 100644 --- a/doc/nrf/shortcuts.txt +++ b/doc/nrf/shortcuts.txt @@ -262,5 +262,4 @@ .. |filter_samples_by_board| replace:: If you want to list samples available for one or more specific boards, `use the nRF Connect for Visual Studio Code extension to filter them `_. -.. |54H_engb_2_8| replace:: When using the nRF54H20 DK Engineering B (from v0.8.0 to 0.8.2), you must build samples and applications using the board revision 0.8.0 with the ``@`` syntax. - For example, ``nrf54h20dk@0.8.0/nrf54h20/cpuapp`` when building for the application core, or ``nrf54h20dk@0.8.0/nrf54h20/cpurad`` when building for the radio core. +.. |54H_engb_2_8| replace:: The nRF54H20 DK Engineering A and B (up to version 0.8.2) are no longer supported starting with |NCS| v2.9.0.