Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: 54H EngB + C support drop #18912

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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.
Expand Down Expand Up @@ -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.
Expand Down
2 changes: 2 additions & 0 deletions doc/nrf/releases_and_maturity/abi_compatibility.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
29 changes: 29 additions & 0 deletions doc/nrf/releases_and_maturity/migration/migration_guide_2.9.rst
Original file line number Diff line number Diff line change
Expand Up @@ -28,13 +28,42 @@ 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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is something missing here?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not really, just preparing the section for later edits



Samples and applications
========================

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
=========

Expand Down
3 changes: 1 addition & 2 deletions doc/nrf/shortcuts.txt
Original file line number Diff line number Diff line change
Expand Up @@ -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 <Browse samples_>`_.

.. |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 ``<board>@<revision>`` 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.
Loading