Firmware Upgrade Instructions

These instructions provide information on how to upgrade the firmware on Booster to a newer release.

Prerequisites

  • Ensure dfu-util is installed. On Ubuntu, install it from apt using sudo apt-get install dfu-util
  • If building your own firmware, cargo-binutils) must be installed:
cargo install cargo-binutils
rustup component add llvm-tools-preview

The following instructions describe the process of uploading a new firmware image over the DFU Bootloader USB interface.

  1. Generate the firmware image: cargo build

    • Note: For production usage, you should append --release to build the firmware with more optimization and slightly less debugging information.
    • Note: You may also use the latest pre-built assets instead of building firmware.
  2. Generate the binary file for your firmware build: cargo objcopy -- -O binary booster.bin

    • Note: If you built with --release, use the commmand: cargo objcopy --release -- -O binary booster.bin
  3. Reset Booster into DFU mode. This can be done via the USB serial port or by doing the following:

    • Insert a pin into the DFU Bootloader hole to press the DFU button
    • While the DFU button is pressed, power cycle booster by turning off the power switch for at least 10 seconds and then turn the power switch on.
  4. Verify Booster is in DFU mode: dfu-util -l should show 4 entries beginning with Found DFU: [0483:df11]

  5. Upload the DFU file to Booster:

dfu-util -a 0 -s 0x08000000:leave --download booster.bin