nRF5340: Network core bootloader
The network core bootloader sample, also called B0n, is an immutable first-stage bootloader that can update the application firmware on the network core of the nRF5340 System on Chip (SoC).
Requirements
The sample supports the following development kit:
Hardware platforms |
PCA |
Board name |
|
|---|---|---|---|
PCA10095 |
|
Overview
The network core bootloader sample protects the flash memory areas allocated to both itself and the application running on the network core.
MCUboot verifies and shares with the network core bootloader any new network core application image received through a device firmware update (DFU) transport layer, like a serial or a Bluetooth® LE connection. For this reason, without MCUboot, this sample does nothing else but directly launches the application.
During the boot process, the network core bootloader sample and MCUboot interact as follows:
When MCUboot receives a new network core application image, it writes the configuration for the network core bootloader to the shared SRAM.
The configuration includes an update instruction and both the SHA and the data of the image.
The network core bootloader locks the flash memory areas containing itself and its configuration.
The ACL peripheral is used for locking. For details on locking, see the Hardware flash write protection driver.
The network core bootloader performs any pending network core firmware update.
It calls the Peripheral CPU DFU (PCD) library to inspect the SRAM region shared with the application core:
If MCUboot has written an update instruction, the network core bootloader copies the specified data range to the application partition on the network core.
Once the copy is done, the network core bootloader compares the SHA of the data in the application partition against the SHA specified in the shared SRAM.
It then communicates the result of the comparison to MCUboot using the shared SRAM.
The network core bootloader then locks the flash memory areas containing the network core application.
The ACL peripheral is used for locking. For details on locking, see the Hardware flash write protection driver.
The network core bootloader boots the application on the network core.
After performing a potential firmware update and enabling flash memory protection, the network core bootloader uninitializes all peripherals that it used and boots the application.
Configuration
See Configuring and building for information about how to permanently or temporarily change the configuration.
Configuration options
To set the minimum partitioning size, use the Kconfig option CONFIG_NETBOOT_MIN_PARTITION_SIZE.
Building and running
This sample can be found under samples/nrf5340/netboot/ in the nRF Connect SDK folder structure.
Caution
You must include the nRF Secure Immutable Bootloader as an image in a project using sysbuild, rather than building it stand-alone. While it is technically possible to build the NSIB by itself and merge it into other application images, this process is not supported. To reduce the development time and potential issues, the existing nRF Connect SDK infrastructure for sysbuild handles the integration.
To include the sample as an image in a sysbuild project that contains a network core application, add the following sysbuild Kconfig options in the project:
The build system includes the sample in the build automatically and generates a new set of firmware update files.
These files match the ones described in Using MCUboot in nRF Connect SDK, except that they contain the network core application firmware and are prefixed with net_core_.
See Configuring and building for information on how to enable the required configuration options. Then follow the instructions in Building and programming with nRF53 Series to build and program the images for the network and application core.
Note
To try out the network core bootloader sample, use the Bluetooth: Peripheral UART sample as the basis for the multi-image build. This sample automatically includes the network core sample HCI IPC when built for the nRF5340 DK. Then apply the options mentioned to include the network core bootloader sample with MCUboot.
Testing
After programming the sample to your development kit, complete the following steps to test it:
Connect to the kit that runs this sample with a terminal emulator (for example, the Serial Terminal app). See Testing and optimization for the required settings and steps.
Note
The nRF5340 DK has multiple UART instances, so the correct port must be identified. See Getting logging output with nRF5340 DK for additional details.
Reset the kit.
Observe the following lines in the console output:
I: Starting bootloader I: Primary image: magic=unset, swap_type=0x1, copy_done=0x3, image_ok=0x3 I: Secondary image: magic=unset, swap_type=0x1, copy_done=0x3, image_ok=0x3 I: Boot source: none I: Swap type: none I: Bootloader chainload address offset: 0xc000 I: Jumping to the first image slot *** Booting Zephyr OS build v2.7.99-ncs1-2195-g186cf4539e5a ***
Program the network core update image using nRF Util:
nrfutil device program --options chip_erase_mode=ERASE_RANGES_TOUCHED_BY_FIRMWARE --firmware zephyr/net_core_app_moved_test_update.hexNote
Typically, the update image is received through serial interface or Bluetooth. For testing purposes, use nRF Util to program the update image directly into the update slot.
Reset the kit.
Observe that the output includes the following lines indicating that the MCUboot in the application core has read the update image and performed a firmware update of the network core:
I: Starting network core update I: Turned on network core I: Turned off network core I: Done updating network core I: Bootloader chainload address offset: 0xc000 I: Jumping to the first image slot *** Booting Zephyr OS build v2.7.99-ncs1-2195-g186cf4539e5a ***
Dependencies
This sample uses the following nRF Connect SDK libraries:
include/bl_validation.hinclude/bl_crypto.hsubsys/bootloader/include/provision.h
The sample also uses drivers from nrfx.