USB CDC ACM serial firmware loader + dfu/single_slot sample project integration by nvlsianpu · Pull Request #27185 · nrfconnect/sdk-nrf

nvlsianpu · 2026-02-24T07:33:34Z

added USB CDC-ACM Virtual port firmware loader basing on SMP MCUmgr.
a sysbuild project can select this firmware loader instance using SB_CONFIG_FIRMWARE_LOADER_IMAGE_USB_MCUMGR=y
added configuration with this loader for nRF54lm20DK to the dfu/single_slot sample.

ref.: NCSDK-37252

next steep PR:
dfu/single_slot: Application entering fw_loader via USB MCUmgr

NordicBuilder · 2026-02-24T07:36:17Z

CI Information

^{To view the history of this post, click the 'edited' button above}
Build number: 38

Inputs:

Sources:

sdk-nrf: PR head: ff3782b4ad4744a5075854023d5990f60a949ced

more details

sdk-nrf:

PR head: ff3782b4ad4744a5075854023d5990f60a949ced
merge base: 620b4c310b8cf584dacc859356c215b1deadf214
target head (main): 929c3b20559a2976619646dda17684ce9a7f9b89
Diff

Github labels

Enabled	Name	Description
	ci-disabled	Disable the ci execution
	ci-all-test	Run all of ci, no test spec filtering will be done
	ci-force-downstream	Force execution of downstream even if twister fails
	ci-run-twister	Force run twister
	ci-run-zephyr-twister	Force run zephyr twister

List of changed files detected by CI (13)

doc
│  ├── nrf
│  │  ├── links.txt
│  │  ├── releases_and_maturity
│  │  │  ├── releases
│  │  │  │  │ release-notes-changelog.rst
samples
│  ├── dfu
│  │  ├── fw_loader
│  │  │  ├── usb_mcumgr
│  │  │  │  ├── CMakeLists.txt
│  │  │  │  ├── README.rst
│  │  │  │  ├── app.overlay
│  │  │  │  ├── boards
│  │  │  │  │  │ nrf54lm20dk_nrf54lm20a_cpuapp.overlay
│  │  │  │  ├── prj.conf
│  │  │  │  ├── sample.yaml
│  │  │  │  │ sysbuild.conf
│  │  ├── single_slot
│  │  │  ├── README.rst
│  │  │  ├── sample.yaml
│  │  │  │ sysbuild_usb.conf
sysbuild
│  │ Kconfig.firmware_loader

Outputs:

Toolchain

Version: 911f4c5c26
Build docker image: docker-dtr.nordicsemi.no/sw-production/ncs-build:911f4c5c26_5ea73affbf

Test Spec & Results: ✅ Success; ❌ Failure; 🟠 Queued; 🟡 Progress; ◻️ Skipped; ⚠️ Quarantine

◻️ Toolchain - Skipped: existing toolchain is used
✅ Build twister - Skipped: Skipping Build & Test as it succeeded in a previous run: 37
✅ Integration tests
- ✅ test-sdk-audio - Skipped: Job was skipped as it succeeded in a previous run
- ✅ desktop52_verification - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-apps - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test_ble_nrf_config - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-ble_mesh - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-ble_samples - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-chip - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-nfc - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-nrf-iot_libmodem-nrf - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-nrf-iot_zephyr_lwm2m - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-nrf-iot_samples - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-nrf-iot_lwm2m - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-nrf-iot_thingy91 - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-nrf_crypto - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-rpc - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-rs - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-fem - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-tfm - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-thread-main - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-sdk-find-my - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-nrf_lrcs_mosh - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-nrf_lrcs_positioning - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-low-level - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-sdk-mcuboot - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-sdk-dfu - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-fw-nrfconnect-ps-main - Skipped: Job was skipped as it succeeded in a previous run
- ✅ test-secdom-samples-public - Skipped: Job was skipped as it succeeded in a previous run

Note: This message is automatically posted and updated by the CI

github-actions · 2026-02-24T08:34:47Z

You can find the documentation preview for this PR here.

Preview links for modified nRF Connect SDK documents:

https://ncsbmdoc.z6.web.core.windows.net/ncs/PR-27185/nrf/releases_and_maturity/releases/release-notes-changelog.html
https://ncsbmdoc.z6.web.core.windows.net/ncs/PR-27185/nrf/samples/dfu/fw_loader/usb_mcumgr/README.html
https://ncsbmdoc.z6.web.core.windows.net/ncs/PR-27185/nrf/samples/dfu/single_slot/README.html

ahasztag · 2026-02-27T06:54:02Z

@@ -0,0 +1,40 @@
+mcuboot:


This partition manager file seems only to be necessary for building the usb_mcumgr fw_loader as a standalone application - it is not used if the fw_loader is used by an outside application.
Can't we use devicetree for building the standalone application?

This sample is not intended to function as a standalone sample.

ahasztag · 2026-02-27T08:55:14Z

+ */
+
+/ {
+	chosen {


It seems this file won't be necessary at all in case of the dongle due to the line (this will already be done by default on the dongle):

sdk-nrf/boards/nordic/nrf54lm20dongle/nrf54lm20b_cpuapp_common.dtsi

Line 107 in 3b262d8

#include <../boards/common/usb/cdc_acm_serial.dtsi>

This all will happen automatically there.

Perhaps here you should also simply include the file from zephyr: boards/common/usb/cdc_acm_serial.dtsi for the DK

Also - take a look at

sdk-nrf/boards/nordic/nrf54lm20dongle/Kconfig.defconfig

Line 22 in 3b262d8

source "boards/common/usb/Kconfig.cdc_acm_serial.defconfig"

- perhaps some of the configuration from prj.conf won't be needed (although I doubt it)

In case of the dongle configuration will be more complex (firmware_loader) that this and what you pointed:

dedicated cdc_acm_uart assigned for SMP MCUmgr

dedicated cdc_acm_uart assigned for LOG

umapraseeda · 2026-02-27T09:18:05Z

Changelog entry missing.

nordicjm · 2026-03-03T13:28:39Z

+
+cmake_minimum_required(VERSION 3.20.0)
+find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
+project(ble_mcumgr)


project name is invalid

nordicjm · 2026-03-03T13:29:32Z

+CONFIG_COMMON_LIBC_MALLOC=y
+CONFIG_LOG=n
+
+CONFIG_UART_CONSOLE=n #? Why is this disabled?


can you elaborate?

nordicjm · 2026-03-03T13:29:57Z

+# Enable the mcumgr Packet Reassembly feature over Bluetooth and its configuration dependencies.
+# MCUmgr buffer size is optimized to fit one SMP packet divided into five Bluetooth Write Commands,
+# transmitted with the maximum possible MTU value: 247 bytes.
+#CONFIG_MCUMGR_TRANSPORT_BT_REASSEMBLY=y


why does this file contain complete irrelevant comments?

nordicjm · 2026-03-03T13:30:04Z

+CONFIG_DEVICE_SHELL=n
+CONFIG_DEVMEM_SHELL=n
+CONFIG_FLASH_SHELL=n
+########


Suggested change

########

b807671#diff-b44d5be4e567f8793cc86ecc8bb0c1b11513093eeb4c42704a7fd00a72cc99c3R44 still there

nordicjm · 2026-03-03T13:31:21Z

+CONFIG_BASE64=y
+CONFIG_CRC=y
+
+# Enable the mcumgr Packet Reassembly feature over Bluetooth and its configuration dependencies.


same comments as above

FrancescoSer

Approving but implement these suggestions

NordicBuilder · 2026-03-26T15:23:29Z

Memory footprint analysis revealed the following potential issues

applications.hpf.gpio.icbmsg[nrf54l15dk/nrf54l15/cpuflpr]: High RAM usage: 12662[B] - link (cc: @nrfconnect/ncs-ll-ursus)
applications.hpf.gpio.icbmsg[nrf54l15dk/nrf54l15/cpuflpr]: High ROM usage: 9410[B] - link (cc: @nrfconnect/ncs-ll-ursus)
applications.hpf.gpio.icmsg[nrf54l15dk/nrf54l15/cpuflpr]: High RAM usage: 9014[B] - link (cc: @nrfconnect/ncs-ll-ursus)
applications.hpf.gpio.icmsg[nrf54l15dk/nrf54l15/cpuflpr]: High ROM usage: 5770[B] - link (cc: @nrfconnect/ncs-ll-ursus)

Note: This message is automatically posted and updated by the CI (latest/sdk-nrf/PR-27185/37)

Added USB CDC-ACM (Virtual COM) SMP MCUmgr firmware loader project, so it will be aveilable as firmware loader image. Signed-off-by: Andrzej Puzdrowski <andrzej.puzdrowski@nordicsemi.no>

Added SB_CONFIG_FIRMWARE_LOADER_IMAGE_USB_MCUMGR option which enables USB CDC-ACM firmware loader for a build. Signed-off-by: Andrzej Puzdrowski <andrzej.puzdrowski@nordicsemi.no>

Added configuration which allow to build the sample with USB CDC-ACM SMP MCUmgr firmeare loader. This can be build for nRF54LM20DK with FILE_SUFFIX=usb. Somewhy when building on Windows machine with FILE_SUFFIX=usb need to create sysbuild/usb_mcumgr image configuration explicitelly. Signed-off-by: Andrzej Puzdrowski <andrzej.puzdrowski@nordicsemi.no>

Updated doc for covering building and testing the sample with USB CDC ACM firmware loader. Signed-off-by: Andrzej Puzdrowski <andrzej.puzdrowski@nordicsemi.no>

Add link to nRFUtil mcumanager page. Signed-off-by: Andrzej Puzdrowski <andrzej.puzdrowski@nordicsemi.no>

Doc added (pattern for ble_mcumgr repalyed). Signed-off-by: Andrzej Puzdrowski <andrzej.puzdrowski@nordicsemi.no>

Added reevant records on usb cdc acm smp mcumgr support in NCS. Signed-off-by: Andrzej Puzdrowski <andrzej.puzdrowski@nordicsemi.no> Signed-off-by: Francesco Domenico Servidio <francesco.servidio@nordicsemi.no>

NordicBuilder added the changelog-entry-required Update changelog before merge. Remove label if entry is not needed or already added. label Feb 24, 2026

NordicBuilder added the doc-required PR must not be merged without tech writer approval. label Feb 25, 2026

nvlsianpu changed the title ~~Usb fw loader~~ [WIP] USB CDC ACM serial firmware loader Feb 25, 2026

nvlsianpu changed the title ~~[WIP] USB CDC ACM serial firmware loader~~ [WIP, Do Not Review] USB CDC ACM serial firmware loader Feb 25, 2026

nvlsianpu force-pushed the usb_fw_loader branch 5 times, most recently from 3072221 to 189ffda Compare February 26, 2026 13:52

nvlsianpu marked this pull request as ready for review February 26, 2026 14:33

nvlsianpu requested review from a team as code owners February 26, 2026 14:33

nvlsianpu changed the title ~~[WIP, Do Not Review] USB CDC ACM serial firmware loader~~ USB CDC ACM serial firmware loader + dfu/single_slot sample project integration Feb 26, 2026

ahasztag reviewed Feb 27, 2026

View reviewed changes

tomchy approved these changes Feb 27, 2026

View reviewed changes

ahasztag requested changes Feb 27, 2026

View reviewed changes

ahasztag approved these changes Mar 3, 2026

View reviewed changes

nvlsianpu force-pushed the usb_fw_loader branch 2 times, most recently from cfaecd7 to 8d8b140 Compare March 3, 2026 11:13

nordicjm requested changes Mar 3, 2026

View reviewed changes

nvlsianpu requested a review from a team as a code owner March 3, 2026 14:09

NordicBuilder removed the changelog-entry-required Update changelog before merge. Remove label if entry is not needed or already added. label Mar 3, 2026

nvlsianpu force-pushed the usb_fw_loader branch 2 times, most recently from 56048b6 to b5ea6a9 Compare March 4, 2026 15:23

nvlsianpu requested a review from nordicjm March 4, 2026 15:24

nvlsianpu mentioned this pull request Mar 6, 2026

samples/dfu/single_slot: Application entering fw_loader via USB MCUmgr #27416

Merged

nvlsianpu force-pushed the usb_fw_loader branch from 2326560 to aa539a0 Compare March 9, 2026 14:06

nvlsianpu requested a review from FrancescoSer March 9, 2026 14:08

nvlsianpu force-pushed the usb_fw_loader branch from aa539a0 to f0e12bd Compare March 9, 2026 15:08

NordicBuilder added the changelog label Mar 9, 2026

nvlsianpu force-pushed the usb_fw_loader branch from f0e12bd to da355e9 Compare March 10, 2026 08:06

FrancescoSer requested changes Mar 17, 2026

View reviewed changes

nvlsianpu force-pushed the usb_fw_loader branch 3 times, most recently from f117f96 to 41fca30 Compare March 19, 2026 09:30

nvlsianpu mentioned this pull request Mar 19, 2026

Usb fw loader usb enter nvlsianpu/fw-nrfconnect-nrf#12

Closed

nvlsianpu force-pushed the usb_fw_loader branch from 41fca30 to e525613 Compare March 19, 2026 14:27

FrancescoSer approved these changes Mar 20, 2026

View reviewed changes

Comment thread samples/dfu/single_slot/README.rst Outdated

Comment thread samples/dfu/single_slot/README.rst Outdated

Comment thread samples/dfu/single_slot/README.rst Outdated

Comment thread samples/dfu/single_slot/README.rst Outdated

nvlsianpu force-pushed the usb_fw_loader branch from e525613 to 5a15a68 Compare March 20, 2026 10:23

b-gent approved these changes Mar 20, 2026

View reviewed changes

nvlsianpu force-pushed the usb_fw_loader branch 3 times, most recently from 27de1b1 to 9a619d0 Compare March 26, 2026 13:58

nvlsianpu added 7 commits March 26, 2026 17:48

samples/dfu/fw_loader: added USB MCUmgr loader

49c231f

Added USB CDC-ACM (Virtual COM) SMP MCUmgr firmware loader project, so it will be aveilable as firmware loader image. Signed-off-by: Andrzej Puzdrowski <andrzej.puzdrowski@nordicsemi.no>

sysbuild/Kconfig.firmware_loader: integrate USB MCUMGR

c35c73a

Added SB_CONFIG_FIRMWARE_LOADER_IMAGE_USB_MCUMGR option which enables USB CDC-ACM firmware loader for a build. Signed-off-by: Andrzej Puzdrowski <andrzej.puzdrowski@nordicsemi.no>

samples/dfu/single_slot: doc on USB Serial FW loader

342ce86

Updated doc for covering building and testing the sample with USB CDC ACM firmware loader. Signed-off-by: Andrzej Puzdrowski <andrzej.puzdrowski@nordicsemi.no>

doc/nrf/links: add nRFUtil mcu-manager

039b707

Add link to nRFUtil mcumanager page. Signed-off-by: Andrzej Puzdrowski <andrzej.puzdrowski@nordicsemi.no>

sample/dfu/fw_loader/usb_mcumgr: add sample doc

ee21e33

Doc added (pattern for ble_mcumgr repalyed). Signed-off-by: Andrzej Puzdrowski <andrzej.puzdrowski@nordicsemi.no>

changelog: entry on usb_mcumgr firmware_loader

ff3782b

Added reevant records on usb cdc acm smp mcumgr support in NCS. Signed-off-by: Andrzej Puzdrowski <andrzej.puzdrowski@nordicsemi.no> Signed-off-by: Francesco Domenico Servidio <francesco.servidio@nordicsemi.no>

nvlsianpu force-pushed the usb_fw_loader branch from 9a619d0 to ff3782b Compare March 26, 2026 16:49

nordicjm approved these changes Mar 27, 2026

View reviewed changes

nvlsianpu added this to the 3.3.0 milestone Mar 27, 2026

nvlsianpu merged commit 8b6a6f1 into nrfconnect:main Mar 27, 2026
21 checks passed

Conversation

nvlsianpu commented Feb 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

NordicBuilder commented Feb 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

CI Information

Inputs:

Sources:

Github labels

Outputs:

Toolchain

Test Spec & Results: ✅ Success; ❌ Failure; 🟠 Queued; 🟡 Progress; ◻️ Skipped; ⚠️ Quarantine

Uh oh!

github-actions Bot commented Feb 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

umapraseeda commented Feb 27, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

FrancescoSer left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

NordicBuilder commented Mar 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Memory footprint analysis revealed the following potential issues

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

nvlsianpu commented Feb 24, 2026 •

edited

Loading

NordicBuilder commented Feb 24, 2026 •

edited

Loading

github-actions Bot commented Feb 24, 2026 •

edited

Loading

NordicBuilder commented Mar 26, 2026 •

edited

Loading