Skip to content

Commit 1562d6f

Browse files
MarekPietanordicjm
authored andcommitted
applications: nrf_desktop: Document nRF54L05/nRF54L10 support
Change adds documentation for nRF54L05/nRF54L10 support. It also introduces some minor doc improvements from tech-writers' review. Jira: NCSDK-30311 Signed-off-by: Marek Pieta <[email protected]> Signed-off-by: Pekka Niskanen <[email protected]> Signed-off-by: Divya Pillai <[email protected]>
1 parent d0ae4f6 commit 1562d6f

File tree

3 files changed

+47
-4
lines changed

3 files changed

+47
-4
lines changed

applications/nrf_desktop/board_configuration.rst

Lines changed: 43 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -103,8 +103,48 @@ Sample dongle (``nrf5340dk/nrf5340``)
103103
Input data comes from Bluetooth and is retransmitted to USB.
104104
* The configuration with the B0 bootloader is set as default.
105105

106+
Sample mouse or keyboard (``nrf54l15dk/nrf54l05/cpuapp``)
107+
* The configuration emulates the nRF54L05 SoC on the nRF54L15 Development Kit.
108+
* The build types allow to build the application as a mouse or a keyboard.
109+
* Inputs are simulated based on the hardware button presses.
110+
* On the nRF54L05 SoC, you can only use the **GPIO1** port for PWM hardware peripheral output.
111+
Because of that, on the DK PCA10156 revision v0.8.1, **LED 0** and **LED 2** cannot be used for PWM output.
112+
You can still use these LEDs with the PWM LED driver, but you must set the LED color to ``LED_COLOR(255, 255, 255)`` or ``LED_COLOR(0, 0, 0)``.
113+
This ensures the PWM peripheral is not used for the mentioned LEDs.
114+
* Only Bluetooth LE transport is enabled.
115+
Bluetooth LE is configured to use Nordic Semiconductor's SoftDevice Link Layer and Low Latency Packet Mode (LLPM).
116+
* The preconfigured ``debug`` configuration does not use the bootloader due to memory size limits.
117+
In the ``debug`` configuration, logs are provided through the UART.
118+
For detailed information on working with the nRF54L15 DK, see the :ref:`ug_nrf54l15_gs` documentation.
119+
* The preconfigured ``release`` configurations use the MCUboot bootloader built in the direct-xip mode (``MCUBOOT+XIP``) and support firmware updates using the :ref:`nrf_desktop_dfu`.
120+
All of the ``release`` configurations enable hardware cryptography for the MCUboot bootloader.
121+
The application image is verified using a pure ED25519 signature.
122+
The public key that MCUboot uses for validating the application image is securely stored in the hardware Key Management Unit (KMU).
123+
For more details on nRF54L Series cryptography, see :ref:`ug_nrf54l_cryptography`.
124+
* The board supports the ``release`` :ref:`nrf_desktop_bluetooth_guide_fast_pair` configuration that acts as a mouse (``release_fast_pair`` file suffix).
125+
126+
Sample mouse or keyboard (``nrf54l15dk/nrf54l10/cpuapp``)
127+
* The configuration emulates the nRF54L10 SoC on the nRF54L15 Development Kit.
128+
* The build types allow to build the application as a mouse or a keyboard.
129+
* Inputs are simulated based on the hardware button presses.
130+
* On the nRF54L10 SoC, you can only use the **GPIO1** port for PWM hardware peripheral output.
131+
Because of that, on the DK PCA10156 revision v0.8.1, **LED 0** and **LED 2** cannot be used for PWM output.
132+
You can still use these LEDs with the PWM LED driver, but you must set the LED color to ``LED_COLOR(255, 255, 255)`` or ``LED_COLOR(0, 0, 0)``.
133+
This ensures the PWM peripheral is not used for the mentioned LEDs.
134+
* Only Bluetooth LE transport is enabled.
135+
Bluetooth LE is configured to use Nordic Semiconductor's SoftDevice Link Layer and Low Latency Packet Mode (LLPM).
136+
* In ``debug`` configurations, logs are provided through the UART.
137+
For detailed information on working with the nRF54L15 DK, see the :ref:`ug_nrf54l15_gs` documentation.
138+
* The configurations use the MCUboot bootloader built in the direct-xip mode (``MCUBOOT+XIP``) and support firmware updates using the :ref:`nrf_desktop_dfu`.
139+
All of the configurations enable hardware cryptography for the MCUboot bootloader.
140+
The application image is verified using a pure ED25519 signature.
141+
The public key that MCUboot uses for validating the application image is securely stored in the hardware Key Management Unit (KMU).
142+
For more details on nRF54L Series cryptography, see :ref:`ug_nrf54l_cryptography`.
143+
* The board supports the ``debug`` :ref:`nrf_desktop_bluetooth_guide_fast_pair` configuration that acts as a mouse (``fast_pair`` file suffix).
144+
The configuration uses the MCUboot bootloader built in the direct-xip mode (``MCUBOOT+XIP``), and supports firmware updates using the :ref:`nrf_desktop_dfu` and :ref:`nrf_desktop_dfu_mcumgr`.
145+
106146
Sample mouse or keyboard (``nrf54l15dk/nrf54l15/cpuapp``)
107-
* The configuration uses the nRF54L15 Development Kit (DK).
147+
* The configuration uses the nRF54L15 Development Kit.
108148
* The build types allow to build the application as a mouse or a keyboard.
109149
* Inputs are simulated based on the hardware button presses.
110150
* On the nRF54L15 SoC, you can only use the **GPIO1** port for PWM hardware peripheral output.
@@ -113,7 +153,7 @@ Sample mouse or keyboard (``nrf54l15dk/nrf54l15/cpuapp``)
113153
This ensures the PWM peripheral is not used for the mentioned LEDs.
114154
* Only Bluetooth LE transport is enabled.
115155
Bluetooth LE is configured to use Nordic Semiconductor's SoftDevice Link Layer and Low Latency Packet Mode (LLPM).
116-
* In debug configurations, logs are provided through the UART.
156+
* In ``debug`` configurations, logs are provided through the UART.
117157
For detailed information on working with the nRF54L15 DK, see the :ref:`ug_nrf54l15_gs` documentation.
118158
* The configurations use the MCUboot bootloader built in the direct-xip mode (``MCUBOOT+XIP``) and support firmware updates using the :ref:`nrf_desktop_dfu`.
119159
All of the configurations enable hardware cryptography for the MCUboot bootloader.
@@ -130,6 +170,6 @@ Sample mouse (``nrf54h20dk/nrf54h20/cpuapp``)
130170
* Bluetooth LE and USB High-Speed transports are enabled.
131171
Bluetooth LE is configured to use Nordic Semiconductor's SoftDevice Link Layer and Low Latency Packet Mode (LLPM).
132172
USB High-Speed is configured to use the USB next stack (:kconfig:option:`CONFIG_USB_DEVICE_STACK_NEXT`).
133-
* In debug configurations, logs are provided through the UART.
173+
* In ``debug`` configurations, logs are provided through the UART.
134174
For detailed information on working with the nRF54H20 DK, see the :ref:`ug_nrf54h20_gs` documentation.
135175
* The configurations use the Software Updates for Internet of Things (SUIT) and supports firmware updates using the :ref:`nrf_desktop_dfu` and :ref:`nrf_desktop_smp`.

applications/nrf_desktop/description.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -366,7 +366,7 @@ Depending on the development kit you use, you need to select the respective conf
366366

367367
.. table-from-rows:: /includes/sample_board_rows.txt
368368
:header: heading
369-
:rows: nrf52840dk_nrf52840, nrf52833dk_nrf52833, nrf52833dk_nrf52820, nrf5340dk_nrf5340_cpuapp, nrf54l15dk_nrf54l15_cpuapp, nrf54h20dk_nrf54h20_cpuapp
369+
:rows: nrf52840dk_nrf52840, nrf52833dk_nrf52833, nrf52833dk_nrf52820, nrf5340dk_nrf5340_cpuapp, nrf54l15dk_nrf54l15_cpuapp, nrf54l15dk_nrf54l10_cpuapp, nrf54l15dk_nrf54l05_cpuapp, nrf54h20dk_nrf54h20_cpuapp
370370

371371
Depending on the configuration, a DK may act either as mouse, keyboard or dongle.
372372
For information about supported configurations for each board, see the :ref:`nrf_desktop_board_configuration_files` section.

doc/nrf/releases_and_maturity/releases/release-notes-changelog.rst

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -219,6 +219,9 @@ nRF Desktop
219219
* System Power Management for the :ref:`zephyr:nrf54h20dk_nrf54h20` board target on the application and radio cores.
220220
The application still has high power consumption as the Bluetooth LE controller running on the radio core requires disabling MRAM latency (:kconfig:option:`CONFIG_MRAM_LATENCY_AUTO_REQ`).
221221
Enabling MRAM latency makes the Bluetooth LE controller unstable.
222+
* Application configurations for the nRF54L05 and nRF54L10 SoCs (emulated on the nRF54L15 DK).
223+
The configurations are supported through ``nrf54l15dk/nrf54l10/cpuapp`` and ``nrf54l15dk/nrf54l05/cpuapp`` board targets.
224+
For details, see the :ref:`nrf_desktop_board_configuration`.
222225

223226
nRF Machine Learning (Edge Impulse)
224227
-----------------------------------

0 commit comments

Comments
 (0)