Firmware update

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.

Upgrade using tio-firmware-upgrade

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

The -r flag specifies the path to the device serial port.

Error conditions

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 dev.firmware.serial RPC.

>>> tio-rpc dev.firmware.serial
"2019-09-20/aec8d0"

Or in python itio.py:

In [1]: tio.sync4.dev.firmware.serial()                                         
Out[1]: '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.