How to build Thymio (Thymio II / Wireless Thymio): the whole process
159 steps to build Thymio (Thymio II / Wireless Thymio), from buying parts, printing and assembly to software, calibration and training, with the bill of materials, shop…
Thymio Wireless AUD 300.00, Thymio USB AUD 241.00 (Tribotix, 2026‑10‑31, before GST and shipping); Mobsya shows no price and the hardware repos give no BOM cost
Buy parts
- Download and install Aseba 1.4
Download and install Aseba version 1.4 using the provided macOS or Windows installer.
- Download Thymio firmware 14
Download the file Thymio2-V14.hex from the firmware 14 download link.
- Download the matching Bonjour installer
Download Bonjour.msi for 32-bit Windows or Bonjour64.msi for 64-bit Windows from the provided GitHub repository.
Assemble
- Connect the robot with USB
Connect your Thymio robot to your computer using a USB cable.
- Connect the robot with USB
Connect your Thymio robot to your computer using a USB cable.
- Connect the dongle and Thymio
Connect the wireless dongle and the Thymio you want to pair to the computer.
- Solder in the wireless module
Upgrade most standard Thymios by soldering the additional module into the robot.
Software
- Install Thymio Suite
Download and install the latest version of Thymio Suite.
- Connect Thymio by USB
Connect Thymio to the computer with the USB cable.
- Open Thymio Suite
Open Thymio Suite.
- Launch a programming environment
Launch VPL or any other supported programming language.
- Start the firmware update
If an update is available, an update icon appears on the robot. Right-click the robot and select “aggiorna il firmware”, or click the update icon.
- Complete the firmware update
Wait until the blue bar is full. The update is finished when the bar is complete.
- Close Aseba Studio
Close Aseba Studio before continuing. It must not remain open during the update process.
- Connect Thymio by USB
Connect Thymio to the computer with the supplied USB cable.
- Run the firmware updater
Run the Thymio Firmware Update program.
- Select the official firmware
Select “Ultima firmware ufficiale” and click “Aggiorna”.
- Confirm and finish updating
Confirm with “Sì” and verify that the process reaches 100%.
- Exit the firmware updater
After the update reaches 100%, Thymio II is updated and it is possible to exit the software.
- Download an earlier firmware
To install an earlier firmware version, download firmware from the Thymio II ASEBA target releases page.
- Choose a custom firmware file
Follow the guide to step 3, then select “File del firmware personalizzato”.
- Select the desired firmware
Select the desired firmware file.
- Download firmware 14 for Thymio
Download the Thymio2-V14.hex firmware file.
- Open a command-line terminal
On macOS, find Terminal in the Applications folder and launch it. On Windows, type cmd.exe in the Windows Start button.
- Navigate to the Thymio Suite helpers folder
Use the MacOS or Windows command matching your computer to navigate to the appropriate Thymio Suite folder.
- Run the firmware upgrader
Run the command for your operating system and replace YOURUSERNAME with your computer username. You can also drag and drop Thymio2-V14.hex into the command line.
- Download and install Aseba 1.4
Download and install Aseba 1.4 for MacOS using Install.Aseba.1.4.OS10.6-10.pkg, or for Windows using aseba-bin-1.4.0-git-b2255c6-win32.exe.
- Download firmware 14 for Thymio
Download the Thymio2-V14.hex firmware file.
- Start Thymio firmware upgrader
Launch the Thymio firmware upgrader program installed with Aseba 1.4.
- Select the downloaded firmware file
The upgrader window should open. An error about connecting to the official firmware server is normal because Thymio Firmware Upgrader is no longer maintained. Click “Seleziona…..” and find the downloaded Thymio2-V14.hex file.
- Update the firmware
Click “Aggiorna”. If the first attempt says it cannot find a Thymio robot, try again a couple of times.
- Exit the upgrader
When the update is complete, press “Esci”. The Thymio now works and can be used with Thymio Suite.
- Open wireless pairing in Thymio Suite
In the Thymio Suite tools, click “Associa un Wireless Thymio a un Wireless dongle”.
- Confirm the warning
If a warning appears, click “Sì”.
- Pair the robot and dongle
Click “Associa !” to pair the connected dongle and Thymio.
- Pair additional robots and dongles
Repeat the same procedure for every robot and dongle you want to pair. You will obtain one robot for each dongle.
- Install the drivers on Windows
On Windows, the computer must recognize Thymio before it can charge. Unplug the robot, then download and install the software.
- Check whether firmware upgrade is stuck
If the upgrade process takes more than 10 seconds, it is stuck.
- Download Thymio firmware 14
Download the Thymio firmware 14 file, Thymio2-V14.hex.
- Open the command-line tool
On macOS, find Terminal in the Applications folder and launch it. On Windows, type cmd.exe in the Windows Start button.
- Change to the Thymio tool directory
Enter the corresponding command for your operating system to change to the folder containing the Thymio command-line tools.
- Connect the robot by USB
Connect the robot to the computer with a USB cable.
- Launch the firmware upgrade tool
Run the upgrade command for your operating system, replace YOURUSERNAME with your computer user name, or drag the firmware file into the command line to obtain the correct path.
- Install Aseba 1.4
Download and install Aseba version 1.4 using the provided macOS or Windows download.
- Download Thymio firmware 14 again
Download the Thymio firmware 14 file, Thymio2-V14.hex.
- Connect the robot by USB
Connect the robot using a USB cable. If it is not detected or restarts constantly, connect another working Thymio, perform steps 4 and 5, and then reconnect the faulty robot.
- Start the Thymio firmware upgrader
Start the “Thymio firmware upgrader” program installed with Aseba version 1.4; the document shows its application icon.
Calibrate and test
- Test another micro-USB cable
Try charging again with another micro-USB cable known to be in good condition. Move the cable slightly; the red light should remain steady.
- Recover a deeply discharged robot
For a fully discharged robot, connect it to a wall charger because a computer will not provide sufficient power.
- Reset the robot
Insert a pin into the small hole on the left of the robot to reset it.
- Try turning off after charging
If the robot turns on, try turning it off. If that does not work, wait 1 hour before trying again.
- Determine whether the battery is faulty
If the robot still cannot be turned off after this procedure, the battery is probably faulty.
- Correct direction with left and right buttons
If the robot turns right, press the left button several times; if it turns left, press the right button several times. Continue until it goes straight, using a larger correction for more presses.
- Store straight-driving correction
When the robot is going straight, hold the central button for 3 seconds. The robot will turn off and store the correction values in long-term memory.
- Test the calibration result
Power on the robot and run the pre-programmed obedient behaviour in magenta to check the calibration result.
- Test the motors
Switch to the obedient magenta mode and press the forward and backward arrow buttons separately. The robot should drive straight forward and then straight backward.
- Check the ground sensors
If the robot detects a hand but does not move, test it on a white surface. If it still does not move, the ground sensors may have a problem.
- Check the firmware version
First, make sure Thymio has the latest firmware. Some older versions do not automatically calibrate the ground sensor values.
- Calibrate the black level
Position Thymio’s ground sensors over the track and press the forward and backward arrow buttons simultaneously to calibrate the black level.
- Calibrate the white level
Position Thymio’s ground sensors over the white area and press the left and right arrow buttons simultaneously to calibrate the white level.
- Check wireless module compatibility
Only robots manufactured before May 2012 are incompatible with the wireless module.
- Test with another working Thymio
If the robot is not detected or repeatedly disconnects, connect another working Thymio and perform points 4 and 5. Then reconnect the faulty Thymio.
- Upgrade the Thymio firmware
Click “Upgrade”. If the upgrader cannot find a Thymio robot on the first attempt, try again several times.
- Finish upgrade and use Thymio
After the upgrade finishes, press “Quit”. The Thymio now works and can be used with Thymio Suite.
- Open the wireless pairing tool
In Thymio Suite, select “Pair a Wireless Thymio to a Wireless dongle”.
- Accept the pairing warning
If a warning appears, click “Yes”.
- Connect the robot and dongle
Connect the dongle and the Thymio that you want to pair.
- Start wireless pairing
Click the “Pair !” button.
- Pair additional robot-dongle pairs
Repeat the pairing process for every robot and dongle. Each dongle pairs with one robot.
- Create a shared robot network
Use the same dongle to pair each Thymio so the robots communicate in one group. This feature is correctly supported only in Aseba Studio.
- Assign one dongle per robot
Use “Pair a case of Wireless” to put one dongle with each robot and spread out the radio channels.
- Join the same Wi-Fi network
Connect both the tablet and relay computer to the same Wi-Fi network. Having both devices connected to the internet is not sufficient.
- Confirm robots appear on both devices
Check that the same robots appear in Thymio Suite on both the computer and the tablet.
- Check the battery charge
Make sure Thymio is fully charged. The battery indicator should show 3 bars when the robot is not connected.
- Restore the base behaviors
Disconnect Thymio or its wireless dongle, turn the robot off, and turn it on again to access the base behaviors.
- Try another Thymio if detection fails
If the robot is not detected or restarts repeatedly with disconnection sounds, connect another working Thymio, perform steps 4 and 5, then reconnect the defective Thymio.
- Try Another Thymio if Needed
If the robot is not detected or repeatedly disconnects, use another working Thymio to execute points 4 and 5. Plug the faulty Thymio back afterward.
- Confirm the successful flash
Check the event window for the message “Flashing OK”.
- Check Blockly4Thymio firmware compatibility
Blockly4Thymio is compatible by default with Aseba up to version 1.5.5 and Thymio firmware up to version 9. Thymio robots from series T, produced after the end of 2019, are not compatible with firmware older than version 13.
Use it
- Connect Thymio for charging
Connect Thymio to a computer or wall charger with the USB cable. A computer or USB hub may not provide enough current for efficient charging.
- Charge while the robot is off
Thymio charges fastest when it is turned off and connected to a wall charger.
- Check the charging lights
A red light beside the micro USB connector indicates charging. A blue light appears when the robot is fully charged.
- Inspect the connector and arrange repair
If the connector is damaged, the robot needs repair. Contact the reseller while the warranty is valid; otherwise, fill in the contact form at the bottom of the Thymio support center page.
- Charge for at least three hours
Charge the robot with the wall charger for at least 3 hours.
- Replace a faulty battery
If the battery is faulty, the robot needs a new battery. Symptoms include showing a full blue light after a few minutes, almost no autonomy after unplugging, or both red and blue lights turning on together.
- Draw a suitable track
When drawing a track yourself, make it sufficiently wide at 4cm and use high contrast; black on white works best.
- Launch the Thymio Suite
Execute flatpak run org.mobsya.ThymioSuite to start the Thymio Suite launcher.
- Launch only the device manager
Execute flatpak run --command=thymio-device-manager org.mobsya.ThymioSuite to start only the device manager instead of the launcher.
- Use Thymio Safely
Do not wet Thymio or immerse it in water. Charging must always be supervised by an adult; it contains small parts that may be swallowed and is unsuitable for children under 3; keep it away from fire and heat sources.
- Distribute and open the VPL 3 bundle
Have pupils drag and drop one ZIP file so VPL 3 is set to the chosen configuration and they can focus on what matters.
Common problems
- Robot connections fail, hang, or disconnect across devices and networks. #38 #67 #118 #644 #746 #811
- Wireless links intermittently drop robot and Scratch messages. #20 #503
- Remote network connection setup is cumbersome and error-prone. #44
- Simulator startup and arrow controls fail unpredictably. #75 #707 #878
- Linux builds fail dependency detection and library linking. #300 #498
- WebGL incompatibilities prevent Scratch from launching. #737
- The Blockly variable rename dialog never appears. #620
- Desktop suite compatibility, localization, and icons are inconsistent. #604 #712 #985 #1042
Parts
- PIC24FJ128GB106 microcontroller (firmware repo readme)
- 9 IR proximity sensors, 5 capacitive touch buttons, 3-axis accelerometer, thermometer, microphone, IR remote receiver
- 39 controllable LEDs, 2 DC wheel motors, speaker, microSD slot
- 3.7V 1,500 mAh Li-Po battery charged over micro-USB, more than 2 hours; top speed 14 cm/s; 11×11.2×5.3 cm, 270 g
- Wireless model: 2.4 GHz 802.15.4 radio module and USB dongle
Tools
- Ships assembled, no tools needed; a USB to micro-USB cable is included
- Modifying the board needs Altium Designer for the sources; the repos also hold fabrication files and STEP models
Skills
- VPL event-action icon blocks (ages 6+ per the site)
- Scratch and Blockly blocks
- Aseba text language and Python (Thonny built into Thymio Suite since 2.4); ROS also works
Software
- Thymio Suite 2.4: VPL, VPL3, Scratch, Blockly, Aseba Studio, Thonny
- thymio.Lab web platform (vpl.Lab, scratch.Lab, py.Lab) for Thymio 2 and 3
- aseba-target-thymio2 firmware (latest release V14, 2019‑11)