From LinkbotLabs
Jump to: navigation, search


Updating your Robot's Firmware

With a Linkbot-Hub

If you have a Linkbot-Hub in your classroom and your Linkbot's firmware is corrupted or out of date, you may use the Linkbot-Hub to update the firmware on your Linkbot. To do so, follow the following steps:

  • Turn off your Linkbot.
  • Connect your Linkbot to your Linkbot-Hub with a Micro-USB cable.
  • Turn on your Linkbot. The Linkbot should flash a red LED several times.
  • Wait until your Linkbot beeps and turns its main LED to a teal color. It should take about a minute for the process to complete. Once the robot beeps and boots up, the flashing process is finished and you may turn off and remove the robot.

With a PC and C-STEM Studio

If you are using a PC and C-STEM studio to control your Linkbots, use the following steps to update your Linkbot's firmware:

  • Click on the "gear" icon on the top right of the LinkbotLabs browser.
  • Click on the link titled "Start firmware updater".
  • Follow the instructions that appear on the screen.

Linkbot Labs does not recognize my robot

  • Make sure the robot is turned on. Turn the robot on by holding down the power button until the purple LED turns blue. Plugging the robot in does not automatically power on the robot.
  • Make sure the robot is properly plugged into your computer.
  • (Windows) Make sure the driver is properly installed. Driver installation is included as part of the LinkbotLabs installation process. If that does not work, the driver can also be found inside the directory "driver" in your LinkbotLabs installation directory.
  • (Windows) Check to make sure that the robot is recognized by your computer. The robot should appear in the Device Manager in the "Ports" section, and should have a COM port assigned to it.
  • (Windows) Make sure the LinkbotLabs service is running. Start the "View Local Services" application and make sure the "Linkbot baromeshd daemon" is running.

My robot's motors seem jerky when trying to move at a constant velocity

See: Robot Motor Calibration

My robot's zero position is off

See: Robot Motor Calibration

Robot Motor Calibration

Firmware version 4.4.13 and higher (Linkbot Labs 1.0.8 and higher)

Robots come pre-calibrated from the factory, but they may sometimes need recalibration. To recalibrate the robot's motors, first move the robot's motors to their zero position. Then, hold down the A and B buttons until the motors begin to move. Once the motors stop moving after about 5 seconds, your robot's motors are calibrated.

Firmware version 4.4.12 and lower

Robots come pre-calibrated from the factory, but they may sometimes need recalibration. To recalibrate the robot's motors, first move the robot's motors to their zero position. Then, hold down the A and B buttons until the LED flashes. Next, hold down the "A" button until the motors begin to move. After about 30 seconds of motion, the robot will beep. After the beep, the robot will continue moving, but the calibration process is complete. You may power-cycle the robot and it's motors should now be calibrated.


I have a robot in the robot manager, but my program does not connect to it

If Linkbot Labs is currently in an interactive lesson, the lesson may be using the robot. If this is the case, the robot will be listed as acquired in the robot manager. Navigate back to the learning pathways page by clicking the Linkbot Labs icon in the upper left, then try your program again.

I get error messages when I try to run Ch programs

If you get error messages similar to the following:

   Error: CLinkbotI::CLinkbotI(): dlopen(): Unknown error
   ERROR: internal error for dlopen(): The specified module could not be found.

You may need to reinstall LinkbotLabs. To perform a full reinstall, follow the following steps:

  • First, uninstall Linkbot Labs if you haven't already.
  • Next, delete the directory "C:\Ch\package\chbarobo" and the file "C:\Ch\toolkit\include\linkbot.h" . You can do this via the Windows file manager.
  • Finally, reinstall the latest version of Linkbot Labs.

When I try to run a Ch program, I get a HANDSHAKE_FAILED error

This error usually occurs when there is more than one LinkbotLabs process running. Open Windows Task Manager, and click on the processes tab. End all processes with image name LinkbotLabs.exe. Then, reopen LinkbotLabs and connect the robot(s) normally. Your program should now run correctly.


I'm getting a "RuntimeError: NO_ROBOT_ENDPOINT"

This usually means that a functioning Linkbot or Z-Link dongle was not detected. Make sure you have at least one Linkbot (or Z-Link) physically attached to your computer with a good USB cable.

I'm getting a "Runtime Error: Connection timed out"

This usually means that a robot with the requested Serial ID could not be found. Make sure that the ID is typed in correctly in your program, and that the remote robot is powered on. If you are trying to connect wirelessly to a robot in an environment with lots of RF interference (For instance, in a room with many Linkbots, cell phones, etc), it may take several tries to connect to your Linkbot.

Linkbot-Hub /

  • When I type my Linkbot-Hub ID into the Hub Manager, it spins forever. This can be caused by a several factors:
    • The Linkbot-Hub cannot contact our servers. If you have the Linkbot-Hub plugged into an ethernet network, check the lights on the Linkbot-Hub's ethernet port. Make sure that both the green light and amber light are lit. If the lights are dark, it is possible that the ethernet port it is plugged into is inactive.
    • The Linkbot-Hub cannot contact global NTP servers to set it's time and date. This typically occurs on networks where NTP packets are blocked. See if your network administrator will allow devices to access the NTP server at "". If that is not possible, please consult the guide _here_ for how to resolve this issue.
  • When I try to connect to a robot, the spinner spins forever
    • Make sure that you are properly connected to the hub. One way to do this is is the following:
      • Go to the homepage
      • In the Python Pathway, click on "Python IDE"
      • The default program that pops up should be a one-liner "Hello, World" program. Click on the green "run" arrow at the top-left.
      • The text "Hello, world!" should be printed out on in the console on the right-hand side. If the text does not print out, your device is not properly connected to the Linkbot-Hub. If your devices is not properly connected to the hub, this may be due to several factors:
        • Your network security settings are blocking local websockets connections.
        • Your browser is configured to use a proxy. Try disabling proxies in your browser for usage with If you are in a classroom with ChromeBooks, your network administrator may need to do this for you.
        • You are on a different network than the Linkbot-Hub. When using the Linkbot-Hub, your device must be on the same "subnet" as your Linkbot-Hub.
        • Check the black "dongles" attached to the USB ports on your Linkbot-Hub. They should be fully plugged in and emitting a solid blue light.
    • If you _are_ properly connected to the hub, check the following:
      • Make sure the Linkbot's serial ID is typed in correctly in your robot manager.
      • Make sure your robot is completely powered on. The main LED should be displaying a teal blue light, and the LED between the A and B buttons should be displaying a solid blue light. Also, the robot should beep when you press the buttons. Also try rebooting the robot.
      • Make sure the two black dongles that came with your Linkbot-Hub are plugged in to the Linkbot-Hub, and that they are emitting a solid blue light.