Connecting to sources…

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)

Documents