It is easy to update device firmware using the firmware upgrade program in tio-tools. It is possible to use any supported transport; if you can talk to the device via USB, serial, or ethernet, you can upgrade it. Download the latest firmware (if available) from the product pages on this site.
Using linux, macOS, or WSL, first install tio-tools and then use one of the following command (with variations noted for specific platforms and connection types):
[macos usb-cdc] % tio-firmware-upgrade -r /dev/cu.usbmodemXXXXX CSB-R10-firmware-2019-03-25-e47a22.bin [macos ftdi] % tio-firmware-upgrade -r /dev/cu.usbserialXXXXX CSB-R10-firmware-2019-03-25-e47a22.bin [linux usb-cdc] % tio-firmware-upgrade -r /dev/ttyACMx CSB-R10-firmware-2019-03-25-e47a22.bin [linux ftdi] % tio-firmware-upgrade -r /dev/ttyUSBx CSB-R10-firmware-2019-03-25-e47a22.bin [wsl1] % tio-firmware-upgrade -r /dev/ttySx CSB-R10-firmware-2019-03-25-e47a22.bin
-r flag specifies the path to the device serial port.
If the unit freezes and stops blinking for more than 10 seconds, the firmware may not be compatible with the hardware. This may be due to an incompatible hardware revision (R3/R4). You can safely power cycle the device and it will continue to use the existing firmware.
Checking firmware version
To determine the firmware of your device, call the
>>> tio-rpc dev.firmware.serial "2019-09-20/aec8d0"
Or in python
In : tio.sync4.dev.firmware.serial() Out: '2019-09-20/aec8d0'
If this command doesn't work or your device was delivered before 2019, the firmware upgrade tool may not work; however, it may be possible to return your device for a one-time reprogramming at Twinleaf to enable future firmware upgrades.