Firmware Flashing Tool

This multi-platform Python tool can flash Radio Dongle and Core Module with local binary or the latest released firmware from our GitHub.

caution

Windows

You need Python and pip installed and in system PATH on your device for you to be able to get the Firmware Flashing Tool

Linux

You need Python and pip installed and in system PATH on your device for you to be able to get the Firmware Flashing Tool

macOS

You need Python and pip installed and in system PATH on your device for you to be able to get the Firmware Flashing Tool

Installation

To install the Firmware Flashing Tool you just need to open your systems CLI and run the following command:

tip

You can use the same command to upgrade Firmware Flashing Tool to the latest version

Windows

pip install --upgrade --no-cache-dir bcf

Linux

sudo pip install --upgrade --no-cache-dir bcf

You can also turn on autocomplete by adding this line to ~/.bashrc

eval "$(_BCF_COMPLETE=source bcf)"

And then reload ~/.bashrc by:

source ~/.bashrc

Thanks to this, you can use a TAB key to autocomplete commands for Firmware Flashing Tool

macOS

pip install --upgrade --no-cache-dir bcf

tip

To get all available commands just type bcf --help to your CLI

bcf --help output

Usage: bcf [OPTIONS] COMMAND [ARGS]...

HARDWARIO Firmware Tool.

Options:
-d, --device TEXT  Device path.
--version          Show the version and exit.
--help             Show this message and exit.

Commands:
clean    Clean cache.
create   Create new firmware.
devices  Print available devices.
eeprom   Work with EEPROM.
flash    Flash firmware.
help     Show help.
list     List firmware.
log      Show log.
pull     Pull firmware to cache.
read     Download firmware to file.
reset    Reset core module.
search   Search in firmware names and descriptions.
source   Firmware source.
test     Test firmware source.
update   Update list of available firmware.

Workflow Example

Update the list of firmware from our GitHub

bcf update

List all firmware

bcf list

Search for specific firmware

info

You will get all firmware with the search term in it

bcf search button

Flash firmware to the device

info

You will be prompted to select to which device should the firmware be flashed

bcf flash hardwario/twr-radio-push-button:latest

tip

If you are flashing multiple times in a row you can use a --device flag to skip the prompt for selecting the device every time

bcf flash --device /dev/ttyUSB0 hardwario/twr-radio-push-button:latest

More About Firmware Flashing Tool

You can use Firmware Flashing Tool for logging messages from the device. Visit Development With Command Line Tools chapter to get more info about this.