HARDWARIO TOWER Firmware Flashing Tool¶
This multi-platform Python tool can flash Radio Dongle and Core Module with local binary or latest released firmwares from GitHub.
The installation and usage instructions are in the Quick Tutorial and Projects section.
Install & Upgrade¶
You can install tools with pip3
python tool. Always make sure that you are using the latest version.
sudo pip3 install --upgrade --no-cache-dir bcf
Autocomplete¶
For Ubuntu/Linux you can enable autocomplete. Add this line to ~/.bashrc
eval "$(_BCF_COMPLETE=source bcf)"
Then run this command to reload .bashrc
source ~/.bashrc
Now you can for example write bcf --de
, press TAB key and --device
text is automatically completed.
Usage examples¶
Update and dowload list of all firmwares from GitHub
bcf update
List all firmwares
bcf list
Search for firmware
bcf search button
Flash Core Module R2
bcf flash hardwario/bcf-radio-push-button:latest
Tip
You can use optional --device
parameter to choose the right serial port. This way the bcf
won’t ask you every time.
Flash Core Module R1
bcf flash --device dfu hardwario/bcf-radio-push-button:latest
Flash Radio Dongle with latest firmware
bcf flash --device /dev/ttyUSB0 hardwario/bcf-gateway-usb-dongle:latest
bcf logging¶
It is possible to use bcf
as a serial console to see log messages which are printed with twr_log_
APIs.
It is using serial port in the parameter and 115200 baud speed with 8N1 uart format.
bcf log --device [device]
Flash firmware and immediatelly start logging after upload
bcf flash --device [device] [firmware]:[version] --log
Reset Core Module and immediatelly start logging after upload
bcf reset --device [device] --log
bcf –help¶
1$ bcf --help
2Usage: bcf [OPTIONS] COMMAND [ARGS]...
3
4HARDWARIO Firmware Tool.
5
6Options:
7-d, --device TEXT Device path.
8--version Show the version and exit.
9--help Show this message and exit.
10
11Commands:
12clean Clean cache.
13create Create new firmware.
14devices Print available devices.
15eeprom Work with EEPROM.
16flash Flash firmware.
17help Show help.
18list List firmware.
19log Show log.
20pull Pull firmware to cache.
21read Download firmware to file.
22reset Reset core module.
23search Search in firmware names and descriptions.
24source Firmware source.
25test Test firmware source.
26update Update list of available firmware.