Firmware Updates
Introduction
The BleuIO comes with a bootloader to allow you to update the firmware or flash your own application to the dongle.
There are two methods to update the dongle.
Latest Firmware
[2023-05-24] v2.2.2 Firmware
Version 2.2.2 | Download | Release Notes | checksum: 8251e3e950a98468188f101f11be98ac |
---|
Older Firmwares
Version 2.2.1 | Download | Release Notes | checksum: 39d85259ac616f94a0078bcea63cab04 |
---|---|---|---|
Version 2.2.0 | Download | Release Notes | checksum: 6fb1c47b0480f9a76da1363c06893a2e |
Version 2.1.4 | Download | Release Notes | checksum: da5ae02ac86d9968b85ffbe9fd44b902 |
Version 2.1.3 | Download | Release Notes | checksum: a65020d9cd4b5fef262571c6711657d1 |
Version 2.1.2 | Download | Release Notes | checksum: 2a3e7c47dab02d65c5da011ee1e5dae3 |
Version 2.1.1 | Download | Release Notes | checksum: ef0d9659b832de4224ca1d5086b0d7cf |
Version 2.1.0 | Download | Release Notes | checksum: 2cd36d78a0fe4b833805203c3c45e4f7 |
Version 2.0.9 | Download | Release Notes | checksum: c7f5d22380a0e32b47fc59811f2037f7 |
Version 2.0.8 | Download | Release Notes | checksum: ca1c589073abe33c1f8017d8de331470 |
Version 2.0.7 | Download | Release Notes | checksum: a3a37e8af677a288cda2852afd69454b |
Version 2.0.6 | Download | Release Notes | checksum: efe40a5e494fb0c09f19cc54fe642623 |
Version 2.0.5 | Download | Release Notes | checksum: 23cb8a191cdab8c8340c5fe377c649c0 |
Version 2.0.4 | Download | Release Notes | checksum: a6daaa82f8800ac5d944dbbe16552774 |
Version 2.0.3 | Download | Release Notes | checksum: bd5724d0f17a28477ba703acd87352af |
Version 2.0.2 | Download | Release Notes | checksum: 72dc985dba615ee110fe9dd425f9f10b |
Version 2.0.1 | Download | Release Notes | checksum: 12095e3be4589629223ad35c6012a49c |
Version 2.0 | Download | Release Notes | checksum: 54658a95d217646fa00bd8aa8e7f0095 |
Version 1.3.1 | Download | Release Notes | checksum: a882b6bd41135a256f3a2d23030becbc |
Version 1.3.0 | Download | Release Notes | checksum: cf7b172ad769fbc74773092b378b075a |
Version 1.2.0 | Download | Release Notes | checksum: 4b32580e6a920ce1a9735e9af4918451 |
Version 1.1.0 | Download | Release Notes | |
Version 1.0.9 | Download | Release Notes | |
Version 1.0.8 | Download | Release Notes | |
Version 1.0.7 | Download | Release Notes | |
Version 1.0.6 | Download | Release Notes | |
Version 1.0.5 | Download | Release Notes |
How to update your firmware
Update method 1: Using firmware updater
Supports Windows, Mac, Linux
The BleuIO comes with a bootloader to allow you to update the firmware or flash your own application to the dongle. To flash the dongle we will need an image file containing the BleuIO firmware or your own application and the updater script.
How to update a dongle
Requirements
- Python >=3.5
- pyserial 3.5
Steps
- Download and extract the updater zip file https://www.bleuio.com/getting_started/files/BleuIO_FW_Updater.zip
- Place the firmware image file into the same folder. (list of firmware image files are available at the top).
- Open the command prompt and go to the extracted folder where bleuio_fw_updater.py is available.
- Run:
python bleuio_fw_updater.py image_file_name.img
- “Success” message along with the updated firmware version will be shown on the screen once the process is completed.
Update method 2: Manual update
Linux side (PC)
To flash the dongle you will need a image file containing the new firmware or your own application and a host USB loader application (that you can get HERE for Windows (host_usb_updater.zip) or HERE for Linux PC (host_usb_updaterlinux.zip)) or HERE for Linux Raspberry Pi (host_usb_updater_RPi.zip)).
- Download Linux PC Host Updated
- Run with
sudo ./host_usb_updater /dev/ttyACM0 ./example_firmware.img
. - The/dev/ttyACM0
means USB-CDC driver of Linux. It can be changed according to test machine. - Sometimes a modemmanager in Linux system like Ubuntu might interrupt the USB-CDC communication. In that case you can try disabling it.
Linux side (Raspberry Pi)
- Download Linux Raspberry Pi Host Updated
- Run with
sudo ./host_usb_updater /dev/ttyACM0 ./example_firmware.img
. - The/dev/ttyACM0
means USB-CDC driver of Linux. It can be changed according to test machine.
Windows side
Download and save the latest firmware file e.g., 'blueio.1.0.9.img' and the flash programmer 'host_usb_updater.exe' in the same folder.
Preparations:
(This will need to be done once at least on every computer you use to flash dongles.)
- Open the Windows Device Manager.
- Insert a dongle.
- Look at Ports (COM & LPT)
- Notice the number 14. This is the Serial Port number the bootloader is using on my computer. You may get another COM port number. Write this number down as you will need it when flashing the dongles.
- Keep in mind that the bootloader will only be open for about 10 seconds after inserting the Dongle, then it will switch to the main app and the COM port number will change. If this happens just pull out the dongle and insert it again.
- You cannot use the main app's Serial Port number to flash the dongles!
Flashing the dongles:
- Open a terminal and go to the folder where the flash programmer and firmware file is located.
- Type host_usb_updater {number} bleuio.1.0.9.img -verbose
- Where '{number}' should be the number of the Serial Port on your computer (without the brackets {}) as described in the 'preperation' section. It's 14 in the picture above but your computer might have a diffrent number.
- Dont press enter yet.
- Insert the dongle you want to flash. Please note:You cannot have multiple dongles connected.
- Wait one or two seconds after insterting the dongle to make sure the computer recognise it then press Enter. The host_usb_updater.exe will now update the dongle.
- A successful firmware update should look like:
- Trying to flash using wrong COM Port will look like this
- After flasing , you can wait to get the Application started and test that the dongle has been successfully flashed with the new version number 1.0.9 by running the AT-command: ATI
NOTE: For simplicity's sake it is recommended to keep the image-file and host_usb_updater.exe in the same folder otherwise you will need to provide the path to where image file is stored relative to the host_usb_updater.exe.