Skip to content

Commit f64785d

Browse files
annwojrlubos
authored andcommitted
doc: L05 and L10 target small adjustments
Made few doc changes to reflect the support Signed-off-by: Anna Wojdylo <[email protected]>
1 parent 5dd7c73 commit f64785d

File tree

8 files changed

+33
-53
lines changed

8 files changed

+33
-53
lines changed

doc/_utils/redirects.py

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -204,8 +204,9 @@
204204
("app_dev/device_guides/working_with_nrf/nrf54l/features", "app_dev/device_guides/nrf54l/features"),
205205
("device_guides/working_with_nrf/nrf54l/nrf54l15_gs", "gsg_guides"), # Getting started with nRF54L15 PDK (removed after 2.8.0)
206206
("app_dev/device_guides/working_with_nrf/nrf54l/nrf54l15_gs", "gsg_guides"),
207-
("device_guides/working_with_nrf/nrf54l/testing_dfu", "app_dev/device_guides/nrf54l/testing_dfu"), # Testing the DFU solution
208-
("app_dev/device_guides/working_with_nrf/nrf54l/testing_dfu", "app_dev/device_guides/nrf54l/testing_dfu"),
207+
("device_guides/working_with_nrf/nrf54l/testing_dfu", "app_dev/device_guides/nrf54l/fota_update"), # Testing the DFU solution (removed after 2.8.0)
208+
("app_dev/device_guides/working_with_nrf/nrf54l/testing_dfu", "app_dev/device_guides/nrf54l/fota_update"),
209+
("app_dev/device_guides/nrf54l/testing_dfu", "app_dev/device_guides/nrf54l/fota_update"),
209210
("ug_nrf53", "app_dev/device_guides/nrf53/index"), # Developing with nRF53 Series (landing)
210211
("nrf53", "app_dev/device_guides/nrf53/index"),
211212
("device_guides/nrf53", "app_dev/device_guides/nrf53/index"),

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

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ Building and programming with nRF54L15 DK
99

1010
.. note::
1111
The FLPR core support in the |NCS| is currently :ref:`experimental<software_maturity>`.
12+
Additionally, it is not yet available for the nRF54L05 and nRF54L10 SoCs.
1213

1314
This guide provides instructions on how to build and program the nRF54L15 development kit.
1415
Whether you are working with single or multi-image builds, the following sections will guide you through the necessary steps.

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

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -123,8 +123,7 @@ See the :ref:`nfc_samples` and :ref:`lib_nfc` for the samples and libraries that
123123
MCUboot bootloader support
124124
**************************
125125

126-
The nRF54L15 DK supports MCUboot as its bootloader.
127-
The following features are supported:
126+
Devices in the nRF54L Series support MCUboot as their bootloader and offer the following features:
128127

129128
* Software and hardware-based :ref:`cryptography<ug_nrf54l_cryptography>`
130129
* Hardware key management
@@ -139,4 +138,4 @@ Supported DFU protocols
139138
The DFU process in the nRF54L15 DK uses the MCUmgr protocol.
140139
It can be used for performing updates over Bluetooth® Low Energy (LE) and serial connections.
141140

142-
For instructions on testing, see :ref:`nrf54l_testing_dfu`.
141+
For details, see :ref:`ug_nrf54l_developing_ble_fota`.

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

Lines changed: 21 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -13,9 +13,12 @@ FOTA updates on nRF54L Series devices
1313
You can also use FOTA updates to replace the application.
1414
See the :ref:`app_dfu` page for general Device Firmware Update (DFU) information, such as supported methods for sending and receiving updates on the device.
1515
Currently, FOTA updates are supported only for the application core.
16+
For more information about introducing immutable MCUboot bootloader, refer to :ref:`ug_bootloader_adding_sysbuild_immutable_mcuboot`.
1617

1718
.. note::
18-
For more information about introducing immutable MCUboot bootloader, refer to :ref:`ug_bootloader_adding_sysbuild_immutable_mcuboot`.
19+
The nRF54L SoC's support hardware Key Management Unit (KMU), designed to provide authentication keys for DFU purposes.
20+
Ensure you complete the :ref:`KMU provisioning<ug_nrf54l_developing_provision_kmu>` during your device's DFU setup with KMU enabled.
21+
Failing to do so may prevent your application from booting properly.
1922

2023
.. fota_upgrades_intro_end
2124
@@ -139,20 +142,20 @@ In |NCS|, you can build and program the :zephyr:code-sample:`smp-svr` as any oth
139142

140143
.. tabs::
141144

142-
.. group-tab:: nRF54L15 SoCs
145+
.. group-tab:: nRF54L SoCs
143146

144147
.. parsed-literal::
145148
:class: highlight
146149
147-
west build -b *board_name*/nrf54l15/cpuapp -- -DEXTRA_CONF_FILE=overlay-bt.conf
150+
west build -b *board_target* -- -DEXTRA_CONF_FILE=overlay-bt.conf
148151
west flash
149152
150-
.. group-tab:: nRF54L15 SoCs with HW cryptography support
153+
.. group-tab:: nRF54L SoCs with HW cryptography support
151154

152155
.. parsed-literal::
153156
:class: highlight
154157
155-
west build -b *board_name*/nrf54l15/cpuapp -- -DEXTRA_CONF_FILE=overlay-bt.conf -DSB_CONFIG_BOOT_SIGNATURE_TYPE_ED25519=y -DSB_CONFIG_BOOT_SIGNATURE_TYPE_PURE=y -Dmcuboot_CONFIG_PM_PARTITION_SIZE_MCUBOOT=0x10000 -DSB_CONFIG_MCUBOOT_SIGNATURE_USING_KMU=y
158+
west build -b *board_target* -- -DEXTRA_CONF_FILE=overlay-bt.conf -DSB_CONFIG_BOOT_SIGNATURE_TYPE_ED25519=y -DSB_CONFIG_BOOT_SIGNATURE_TYPE_PURE=y -Dmcuboot_CONFIG_PM_PARTITION_SIZE_MCUBOOT=0x10000 -DSB_CONFIG_MCUBOOT_SIGNATURE_USING_KMU=y
156159
west flash
157160
158161
@@ -164,6 +167,15 @@ In |NCS|, you can build and program the :zephyr:code-sample:`smp-svr` as any oth
164167
west build -b nrf54l15dk/nrf54l15/cpuapp -T sample.mcumgr.smp_svr.bt.nrf54l15dk.ext_flash
165168
west flash
166169
170+
.. group-tab:: nRF54l15 DK with SPI Flash as update image (DTS partitioning)
171+
172+
To build with the DTS partitioning, run the following command:
173+
174+
.. parsed-literal::
175+
:class: highlight
176+
177+
west build -b nrf54l15dk/nrf54l15/cpuapp -d build/smp_svr_54l_d zephyr/samples/subsys/mgmt/mcumgr/smp_svr -T sample.mcumgr.smp_svr.bt.nrf54l15dk.ext_flash.pure_dts
178+
167179
Make sure to indicate the :file:`overlay-bt.conf` overlay configuration for the Bluetooth transport like in the command example.
168180
This configuration was carefully selected to achieve the maximum possible throughput of the FOTA update transport over Bluetooth with the help of the following features:
169181

@@ -193,13 +205,12 @@ Build configuration additions for MCUboot in the direct-xip mode
193205
FOTA updates are also supported when MCUboot is in the direct-xip mode.
194206
In this mode, the MCUboot bootloader boots an image directly from a given slot, so the swap operation is not needed.
195207
It can be used either with or without the revert mechanism support.
196-
For more information about the direct-xip mode and the revert mechanism support, go to the Equal slots (direct-xip) section on the :doc:`mcuboot:design` page.
197-
198-
.. note::
199-
direct-xip mode can not be combined with the image encryption.
208+
For more information about the direct-xip mode and the revert mechanism support, go to the *Equal slots* (direct-xip) section on the :doc:`mcuboot:design` page.
200209

201210
.. note::
202-
building a project with direct-xip for nRF54l15 SoC target mode requires static partition manager file for partitioning, see known issues.
211+
Direct-xip mode cannot be combined with image encryption.
212+
In addition, when building a project with direct-xip for the nRF54L SoC targets, a static partition manager file is required for partitioning.
213+
See NCSDK-30119 issue on the :ref:`known_issues` page.
203214

204215
To use MCUboot in the direct-xip mode together with FOTA updates, do the following:
205216

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

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ Zephyr and the |NCS| provide support and contain board definitions for developin
2525
| `Quick Start app`_
2626
| `User Guide <nRF54L15 DK User Guide_>`_
2727
- | `nRF54L15 DK product page <nRF54L15 DK_>`_
28-
| `nRF54L15 System-on-Chip (SoC) <nRF54L05_>`_
28+
| `nRF54L15 System-on-Chip (SoC) <nRF54L15 System-on-Chip_>`_
2929
* - nRF54L10 emulation on the nRF54L15 DK
3030
- PCA10156
3131
- ``nrf54l15dk/nrf54l10/cpuapp``
@@ -35,7 +35,7 @@ Zephyr and the |NCS| provide support and contain board definitions for developin
3535
- PCA10156
3636
- ``nrf54l15dk/nrf54l05/cpuapp``
3737
- | `Datasheet <nRF54L15 Datasheet_>`_
38-
- | `nRF54L05 System-on-Chip (SoC) <nRF54L15 System-on-Chip_>`_
38+
- | `nRF54L05 System-on-Chip (SoC) <nRF54L05_>`_
3939

4040
.. _ug_nrf54L15_revision:
4141

@@ -64,7 +64,6 @@ Ensure to check the revision of your nRF54L15 device to see if it is supported:
6464
features
6565
zms
6666
cryptography
67-
testing_dfu
6867
vpr_flpr
6968
building_nrf54l
7069
nrf54l_signing_with_payload

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

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,13 @@
11
.. _ug_nrf54l_developing_provision_kmu:
22

3-
4-
nRF54L15 KMU provisioning
5-
#########################
3+
Performing KMU provisioning
4+
###########################
65

76
.. contents::
87
:local:
98
:depth: 2
109

11-
The nRF54L15 DK is equipped with Hardware Key Management Unit (KMU), that requires provisioning when in use.
10+
The nRF54L devices are equipped with Hardware Key Management Unit (KMU), that requires provisioning when in use.
1211
The |NCS| provides a west command, ``ncs-provision``, allowing to upload keys to the device though the Serial Write Debug (SWD) interface.
1312

1413
Prerequisites
@@ -66,7 +65,6 @@ Once you have an unprovisioned SoC, upload keys to the board by running the foll
6665
west ncs-provision upload -s nrf54l15 -k ed25519.pem -k ed25519-1.pem -k ed25519-2.pem
6766
6867
* Parameter ``-s (-–soc)`` specifies the target device.
69-
Currently, only the nRF54L15 DK is supported.
7068

7169
* Parameter ``-k (-–key)`` specifies the private key PEM files to be provisioned to the SoC.
7270
You can specify up to three keys.

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

Lines changed: 0 additions & 30 deletions
This file was deleted.

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

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ Working with the FLPR core
99

1010
.. note::
1111
The FLPR core support in the |NCS| is currently :ref:`experimental<software_maturity>`.
12+
Additionally, it is not yet available for the nRF54L05 and nRF54L10 SoCs.
1213

1314
The nRF54L15 SoC has a dedicated VPR CPU (RISC-V architecture), named *fast lightweight peripheral processor* (FLPR).
1415
The following peripherals are available for use with the FLPR core, and can be accessed through the appropriate Zephyr Device Driver API:

0 commit comments

Comments
 (0)