Update firmware using the UF2 Bootloader¶

Overview¶

nRF52840 Connect Kit is shipped with the UF2 Bootloader, which is an easy-to-use and self-upgradable bootloader that can be used to update the firmware by just copying the .uf2-format images to the flash drive without using an external programmer.

This section details how to update firmware using the UF2 Bootloader.

Flash memory layout¶

When updating firmware using the UF2 Bootloader, you must be aware of where in the device memory the different firmware components are located.

The following figure shows the default flash memory layout of nRF52840 Connect Kit:

Installing UF2 Converter¶

uf2conv is an open source Python based tool for packing and unpacking UF2 files.

Before you install uf2conv, make sure that you have Python 3.6.0 or later installed.

Then open up a terminal and run the following command to install the latest prerelease version from the HEAD of the main branch:

1

py -3 -m pip install --pre -U git+https://github.com/makerdiary/uf2utils.git@main

1

python3 -m pip install --pre -U git+https://github.com/makerdiary/uf2utils.git@main

You can run uf2conv --help for a list of available options:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

$ uf2conv --help

usage: uf2conv [-h] [-b BASE] [-f FAMILY] [-o FILE] [-d DEVICE_PATH] [-l] [-c] [-D] [-w] [-C] [-i] [INPUT]

Convert to UF2 or flash directly.

positional arguments:
  INPUT                 input file (HEX, BIN or UF2)

options:
  -h, --help            show this help message and exit
  -b BASE, --base BASE  set base address of application for BIN format (default: 0x2000)
  -f FAMILY, --family FAMILY
                        specify familyID - number or name (default: 0x0)
  -o FILE, --output FILE
                        write output to named file; defaults to "flash.uf2" or "flash.bin" where sensible
  -d DEVICE_PATH, --device DEVICE_PATH
                        select a device path to flash
  -l, --list            list connected devices
  -c, --convert         do not flash, just convert
  -D, --deploy          just flash, do not convert
  -w, --wait            wait for device to flash
  -C, --carray          convert binary file to a C array, not UF2
  -i, --info            display header information from UF2, do not convert

Generating the firmware in UF2¶

To generate the application firmware in UF2, simply use uf2conv on a .bin file or .hex file, specifying the family as 0xADA52840:

1

uf2conv -f 0xADA52840 -c -o application.uf2 application.hex

1

uf2conv -f 0xADA52840 -c -b 0x1000 -o application.uf2 application.bin

To generate a UF2 image for bootloader from a .hex file, specifying the separated family of 0xD663823C:

1

uf2conv -f 0xD663823C -c -o bootloader.uf2 bootloader.hex

Updating the application firmware¶

Generate the correct UF2 application firmware for your board by following the steps above.

To update the application firmware, complete the following steps:

1. Push and hold the USER button and plug your board into the USB port of your computer. Release the USER button after your board is connected. The RGB LED turns green.

2. It will mount as a Mass Storage Device called UF2BOOT.

   

3. Drag and drop the UF2 file onto the UF2BOOT volume. The RGB LED blinks red fast during flashing.

4. Reset the board and the new application firmware is running.

Updating the UF2 Bootloader¶

The UF2 Bootloader is self-upgradable, so that you can update the UF2 bootloader without using an external programmer. The latest UF2 bootloader is located in the firmware/uf2_bootloader folder.

To update the bootloader, complete the following steps:

1. Push and hold the USER button and plug your board into the USB port of your computer. Release the USER button after your board is connected. The RGB LED turns green.

2. Open INFO_UF2.TXT in the UF2BOOT volume with a text editor, and check the current version of bootloader. The figure below shows we are running the 0.7.0-rtm version.

   

3. Check if newer updates are available in the firmware/uf2_bootloader folder. The update is released with the name update-nrf52840_connectkit-uf2_bootloader-<version>-nosd.uf2.

4. Drag and drop the update file onto the UF2BOOT volume.

5. Enter DFU mode again and verify the version printed in INFO_UF2.TXT.