UF2 Converter

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

Requirements

• Python 3.6.0 or later
• macOS, Linux, Windows 7 or newer, or FreeBSD

Installing

To install the latest prerelease version from the HEAD of the main branch, you can do the following:

On Linux/macOS:

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

On Windows:

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

Basic usage

Pack a .bin/.hex to .uf2

uf2conv firmware.bin --base 0x1000 --family 0xADA52840 --convert --output firmware.uf2

uf2conv firmware.hex --family 0xADA52840 --convert --output firmware.uf2

Unpack a .uf2 to .bin

uf2conv firmware.uf2 --convert --output firmware.bin

Options

-b --base : set base address of application for BIN format (default: 0x2000)

-f --family : specify familyID - number or name (default: 0x0)

-o --output : write output to named file (defaults to flash.uf2 or flash.bin where sensible)

-d --device : 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