Skip to content

Commit 127888c

Browse files
greg-ferrlubos
authored andcommitted
doc: tf-m: nRF54LM20 support update
Updated docs with information about support for TF-M on nRF54LM20. NCSDK-35013. Signed-off-by: Grzegorz Ferenc <[email protected]>
1 parent 0fd3d0d commit 127888c

File tree

10 files changed

+99
-89
lines changed

10 files changed

+99
-89
lines changed

doc/nrf/app_dev/board_names.rst

Lines changed: 81 additions & 75 deletions
Large diffs are not rendered by default.

doc/nrf/app_dev/device_guides/nrf54l/index.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,13 +24,15 @@ Refer to the following information for the list of supported development kits (D
2424
* - :zephyr:board:`nrf54lm20dk`
2525
- PCA10184
2626
- | ``nrf54lm20dk/nrf54lm20a/cpuapp``
27+
| ``nrf54lm20dk/nrf54lm20a/cpuapp/ns`` (:ref:`TF-M <app_boards_spe_nspe>`)
2728
| ``nrf54lm20dk/nrf54lm20a/cpuflpr``
2829
| ``nrf54lm20dk/nrf54lm20a/cpuflpr/xip``
2930
- --
3031
- --
3132
* - :zephyr:board:`nrf54l15dk`
3233
- PCA10156
3334
- | ``nrf54l15dk/nrf54l15/cpuapp``
35+
| ``nrf54l15dk/nrf54l15/cpuapp/ns`` (:ref:`TF-M <app_boards_spe_nspe>`)
3436
| ``nrf54l15dk/nrf54l15/cpuflpr``
3537
| ``nrf54l15dk/nrf54l15/cpuflpr/xip``
3638
- | `Datasheet <nRF54L15 Datasheet_>`_

doc/nrf/protocols/thread/configuring.rst

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -411,8 +411,6 @@ Minimal Thread Device (MTD)
411411
Trusted Firmware-M support options
412412
==================================
413413

414-
To configure your Thread application to run with Trusted Firmware-M, use the following board target:
414+
Thread currently supports Trusted Firmware-M (TF-M) on the nRF54L15 DK.
415415

416-
* ``nrf54l15dk/nrf54l15/cpuapp/ns``` for the nRF54L15 DK
417-
418-
For more Trusted Firmware-M documentation, see :ref:`ug_tfm` and the official `TF-M documentation`_.
416+
To configure your Thread application to run with Trusted Firmware-M, use the ``nrf54l15dk/nrf54l15/cpuapp/ns`` board target and follow the instructions in :ref:`ug_tfm_building`.

doc/nrf/protocols/thread/overview/security.rst

Lines changed: 2 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -40,16 +40,10 @@ The Thread stack requires the following cryptographic operations:
4040
Secure processing environment
4141
*****************************
4242

43-
Depending on the board target, Thread samples can use the :ref:`secure processing environment <ug_tfm_security_by_separation>` with Trusted Firmware-M (TF-M).
44-
45-
nRF54L with Trusted Firmware-M (TF-M)
46-
=====================================
47-
48-
On the nRF54L SoC, all cryptographic operations within the Thread stack are performed by utilizing the `Platform Security Architecture (PSA)`_ API and executed in the secure TF-M environment using the :ref:`TF-M Crypto Service implementation <ug_crypto_architecture_implementation_standards_tfm>`.
43+
When building for the nRF54L15 DK using the :ref:`board target <app_boards_names>` with the ``/ns`` variant (``nrf54l15dk/nrf54l15/cpuapp/ns``), Thread samples can use the :ref:`secure processing environment <ug_tfm_security_by_separation>` with Trusted Firmware-M (TF-M).
44+
In such cases, all cryptographic operations within the Thread stack are performed using the `Platform Security Architecture (PSA)`_ API and executed in the secure TF-M environment using the :ref:`TF-M Crypto Service implementation <ug_crypto_architecture_implementation_standards_tfm>`.
4945
The secure materials like Thread network key are stored in the TF-M secure storage using the :ref:`tfm_encrypted_its` module.
5046

51-
To build a Thread sample with the TF-M support, :ref:`build <building>` for the :ref:`board target <app_boards_names>` with the ``/ns`` variant.
52-
5347
For example, to build the Thread CLI sample for the nRF54L15 DK with the TF-M support, run the following command:
5448

5549
.. code-block:: console

doc/nrf/releases_and_maturity/software_maturity.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2252,13 +2252,13 @@ Trusted Firmware-M support
22522252
- --
22532253
- --
22542254
- Experimental
2255-
- --
2255+
- Experimental (with :ref:`limitations <tfm_encrypted_its>`)
22562256
* - :ref:`Minimal <ug_tfm_supported_services_profiles_minimal>`
22572257
- --
22582258
- --
22592259
- --
22602260
- Experimental
2261-
- --
2261+
- Experimental (with :ref:`limitations <tfm_encrypted_its>`)
22622262

22632263
.. tab:: nRF91 Series
22642264

doc/nrf/security/tfm/tfm_building.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ The :ref:`boards supported by the SDK <app_boards_names>` distinguish entries ac
2525
To build with TF-M in the |NCS|, you must use a board target with the ``*/ns`` variant.
2626
The following platforms are currently supported:
2727

28+
* nRF54LM20A
2829
* nRF54L15
2930
* nRF5340
3031
* nRF91 Series

doc/nrf/security/tfm/tfm_services.rst

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,9 @@ Encrypted ITS
5959

6060
TF-M ITS encryption is a data protection mechanism in Internal Trusted Storage. It provides transparent encryption using a Master Key Encryption Key (MKEK) stored in hardware, with unique encryption keys derived for each file.
6161

62+
.. note::
63+
|encrypted_its_not_supported_on_nrf54lm20|
64+
6265
To enable TF-M ITS encryption, set the :kconfig:option:`CONFIG_TFM_ITS_ENCRYPTED` Kconfig option.
6366

6467
On Nordic Semiconductor devices, the hardware-accelerated AEAD scheme ChaChaPoly1305 is used with a 256-bit key.

doc/nrf/security/tfm/tfm_supported_services.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -225,6 +225,7 @@ Core features
225225
Security services
226226
=================
227227

228+
* |encrypted_its_not_supported_on_nrf54lm20|
228229
* Firmware Update service is not supported.
229230
* Firmware verification is not supported.
230231
* Firmware encryption is not supported.

doc/nrf/shortcuts.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -220,6 +220,8 @@
220220
.. |samples_tfm_info| replace:: Starting from the |NCS| v2.0.0, TF-M is the only way to use :ref:`security by separation <ug_tfm_security_by_separation>` with ARM TrustZone.
221221
In addition, the TF-M implementation is enabled by default for all samples and applications in the |NCS| when you build for the ``*/ns`` :ref:`variant <app_boards_names>` of the boards.
222222

223+
.. |encrypted_its_not_supported_on_nrf54lm20| replace:: The encrypted ITS service is not supported on nRF54LM20 as it :ref:`does not support the full set of AEAD algorithm features <ug_crypto_supported_features_aead_algorithms>`.
224+
223225
.. |plusminus| unicode:: U+000B1 .. PLUS-MINUS SIGN
224226
:rtrim:
225227

samples/crypto/persistent_key_usage/README.rst

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,9 @@ The sample supports the following development kits:
2525

2626
.. include:: /includes/tfm.txt
2727

28+
.. note::
29+
|encrypted_its_not_supported_on_nrf54lm20|
30+
2831
Overview
2932
********
3033

0 commit comments

Comments
 (0)