Skip to content

Frequently asked questions

Where to buy OriginBot from ?

The only sales platform for the OriginBot intelligent robot open source kit: Guyue Academy→kit purchase link

The battery interface is tight, and it is not easy to insert

In order to ensure the stability of the system power supply and meet the instantaneous high power output of the total power supply, OriginBot adopts a T-type interface in the selection of power interfaces. The connection of the interface is tight in the new state, please use skillful force and operate cautiously when installing.

How to install the heatsink for the processor ?

Tear off the blue plastic sheet on the back of the heat sink, the white one is the thermal pad, try to keep the core SoC on the RDK X3 (Sunrise X3 pi) in the middle of the thermal pad, and then press and paste.


How to use the course cards that come with the kit ?

Scratch open the course redemption card included in the kit and find the redemption code. Log in to the WeChat public account of "Guyueju", click "Guyue Academy" in the menu bar, click "My" at the bottom after entering, and then click on the exchange center, enter the redemption code to confirm that the redemption can be successfully redeemed, and you can learn the successfully redeemed course in "My Courses".


The buzzer kept going off

If you find that the buzzer keeps ringing during the process of using OriginBot, don't worry, this is the default battery protection program for the controller, when the voltage is lower than 9.6V, the buzzer will keep ringing, please turn off the phone and charge it in time.

In addition, when burning the control firmware, if you use the PC to supply power to the controller through the firmware download port, the voltage after burning the firmware will also be lower than 9.6V, and according to the battery protection program, the buzzer will also sound, and after reconnecting the battery, it can return to normal.

The lidar keeps spinning after the robot is powered on

Due to the characteristics of the lidar itself, it will rotate all the time after powering on, If you do not use it for the time being, you can unplug the radar USB cable first, and then connect it when you use it.

Where is the robot's SD card inserted ?

After the SD card is burned to the image, insert it into the card slot on the front of the robot and the back of the RDK X3 (Rising Sun X3 system) board.


Can the robot be used while charging ?

No, the charging circuit on the robot controller is designed according to the shutdown state, so when charging, please turn off the robot power switch, and after charging, unplug the charging head and use it again.

How to confirm that the robot is charging is over ?

Please use the charger provided with the kit to charge, there is an LED indicator on the charger plug, the red light is charging, and the green light is charging completed. A full charge is expected to take around 3 hours.

The motor of the machine is not moving properly

When the robot is controlled by the keyboard, if you find that the motor on one side of the robot does not rotate, or sometimes does not rotate, please check in the following ways:

(1)Check whether the wiring of the robot motor is correct and firm, including the motor end and the drive board end;

(2) The robot is in differential motion, and when turning in situ, if the speed is too slow, the inner wheel may not turn, which is a normal phenomenon;

(3) If the wheel on one side does not rotate during the forward movement of the robot, or sometimes does not rotate, please refer to the controller firmware to install and re-burn the firmware before trying;

If the problem persists, please contact the assistant for after-sales support.

Is the controller board sold separately?

The OriginBot controller board is not sold separately for the time being, but the schematic and PCB are open source, and developers can make their own boards.

Can the visual version be upgraded to the navigation version?

The official does not provide price difference upgrade services, but the relevant components, models, and software are open source, and developers can make their own upgrades.

What to do if the robot is out of control?

In the secondary development process, if the ROS application is not properly developed, it may cause the robot to get out of control, such as the movement has been moving without stopping, etc., at this time, you can pick up the robot, press the reset button "RESET" on the controller board, the underlying motion function of the robot can be reset, and then close the ROS application node of the host computer as soon as possible.

The direction of the gold finger of the camera cable

As you can see in the image below, the gold finger is facing the side of the PCB, and the same is true for the X3.


Image/firmware burning and startup

The controller firmware failed to be burned

When downloading firmware to the extension board through the "Burning" port, if the burning fails, check the following issues:

(1)You need to disconnect the serial port connection between the expansion board and the Sunrise pi, otherwise you will not be able to connect to download;


(2)Check the configuration in the FlyMcu software:

  • The firmware file is selected correctly;
  • The port where the firmware is downloaded is correct;
  • The reset option in the lower left corner is selected correctly;


The login page cannot be entered after power-on

After burning the SD card image, when the Sunrise Pi is started:

  1. If the serial port interface continuously outputs uboot information and cannot enter the login interface of the ubuntu system, it may be because the power supply of the board is insufficient, please check the power input of the RDK X3 (Sunrise X3 Pi) and make sure that the controller board is powered through the typec adapter board, or use an external power supply of 5V 2A or above to supply power to the typec port of RDK X3 (Sunrise X3 Pi).
  2. If you stop at the uboot interface as shown below, the card has been started but the SD image has not been loaded. Please make sure that the SD card has been inserted into the card slot of the RDK X3 (Sunrise X3 Pi) correctly, and that there is no keyboard input during the boot process.


The serial port device could not be found in the serial port software

After connecting the serial port module, if you can't find the device in the device selection drop-down box of the serial port software, right-click in "My Computer" to open "Device Manager" and confirm whether the driver of the serial port module has been installed on the system.

If the following message is displayed, the serial module driver is not installed,click here to download the serial driver, decompress it, double-click the dpinst64.exe to install it, and then try to communicate again after the driver is installed.


Characters cannot be entered in the serial port software

After connecting the serial port, start OriginBot, and you can see the output log information and login prompt in the serial port communication software, but you can't enter characters:


(1)Please check the connection of the serial port cable, there is an output message indicating that the RX connection of the serial port is correct, it may be that TX and GND are reversed.


(2)Confirm whether the serial communication software used has a remote interaction function, and the serial communication assistant should not be used, but the serial remote terminal connection software, such as MobaXterm, TeraTerm, etc.

Does the RDK X3 have a user manual ?

For the basic use of RDK X3(Sunrise X3 Pi), please refer to the RDK X3 user manual

Where to download the FlyMcu software ?

Please refer to the common software download page.

Where can I download the SD card image burning software ?

Please refer to the common software download page.

Where can I download the serial driver ?

Please refer to the common software download page.

How to debug firmware code online ?

You need to use the stlink simulator, connect to the SWD interface on the controller side, and refer to the source code for debugging and downloading.

The HDMI connection display has no image

The OriginBot system image uses Ubuntu 20.04 Server version, and does not have a system desktop, and it is normal to display the default horizon logo information after connecting to the monitor through HDMI.


The SD card is running out of space

The SD card in the OriginBot suite is 32GB, the space can be fully satisfied under normal use, if you find that the space does not match the 32GB, please confirm:

(1)To reduce the size of the system image file, the free space in the system image file of the SD card has been compressed. After the system image file is burned, perform operations by referring to Expanding SD Card Space

(2)The file format in the SD card image is EXT4, which cannot be fully read in windows, which will cause the disk space to be seen only a few hundred megabytes, which is a normal phenomenon, and can be read by installing the corresponding software, or read under the Ubuntu system.

The SD card cannot be read or written

Some SD cards will be corrupted after operation, resulting in the inability to read and write the SD card, you need to format it, the specific steps are as follows: (1)Right-click on the "This Computer" icon on the desktop, Manage, Disk Management, and select the disk corresponding to the SD card. (2)Delete all partitions on the SD card disk, right-click in the corresponding position of the partition, and you can see the delete option. (3)Create a new partition, right-click in the deleted unallocated part, create a new simple volume, and then go directly to the next step, and confirm. (4)Finally, it is normal to be able to see the partition of the SD card correctly and read and write it in the file management.

Use of basic functions

The device number cannot be displayed after the handle is connected

Due to the fact that the underlying driver of different brands of controllers may be different, some controllers cannot be driven when connected to the RDK X3 (Sunrise X3 Pi). If you cannot see the devices marked with "js + numbers" after using the ls /dev/input/ command, the controller cannot be driven by the Ubuntu system of RDK X3.

At present, the handle models that have passed the test are:

(More models to be added)

If it cannot be driven, the handle can be plugged into the PC and the robot movement can be controlled through ROS2 distributed communication.

The camera failed to start

OriginBot uses the MIPI camera as the vision sensor, and the connection cable is a soft cable, and the interfaces on both sides are easily connected improperly.


If the camera fails to start, troubleshoot the issue in the following ways:

(1)Reconnect the cables on both sides, pay attention to keep the interface flat, and insert it into the bottom of the interface, confirm that the connection is correct, and then try again, note that the cable cannot be hot-swapped, and it needs to be shut down before operation;

(2)After connecting the cable, use the command in the figure to view, if the camera is not connected, please repeat the previous operation, or replace the cable;


(3)Confirm whether there are other programs that have occupied the right to use the camera, if so, please close other programs and try again;

How to compile the code of the host computer on the PC side ?

Please refer to the steps to download/compile the PC function pack.

VSCode is unable to connect to the bot

Troubleshoot the following possible issues:

(1)Whether the PC running VSCode is under the same LAN as the robot, that is, connected to the same router;

(2)Whether the PC and the robot can be successfully connected through "ping + the IP address of the other party";

(3)Whether the IP address, user name, password, command line characters, etc. filled in when connecting to the robot through VSCode are incorrect.

How to install VSCode under Ubuntu ?

Please refer to Installing VSCode进行操作。

Can the robot be connected to a USB camera ?

Yes, for specific usage methods, please refer to the Horizon Robotics Development Platform User Manual: USB Image Acquisition

The IP address of the bot changes

(1)Wired network: The static IP address has been set in the OriginBot image, which is, and it is configured by referring to the video instructions for SSH remote login.

(2)Wireless network: If the connected router has DHCP (Dynamic Host Configuration Protocol) turned on, the IP address of the robot may change after each connection, if you need a fixed IP, please search for "Linux wireless network static IP settings" on the Internet, refer to the configuration.

ROS2 and TogetheROS

ROS2 is soft-linked to TogetheROS

The system image has been installed with the common ROS2 function package. If you have a newly installed ROS2 package, you need to complete the soft link with the tros after installation.

$ cd /opt/tros 
## Create a soft link from ROS package to TogetheROS using in /opt/tros 
$ python3 --foxy /opt/ros/foxy/ --tros /opt/tros 

The system update overwrites the profile

If you manually use Upgrade to update the system, the TROS system may be updated and the camera-related configurations in the original image will be overwritten:

  • Confirm that the camera model and calibration file in the "/opt/tros/share/websocket/launch/" path are "GC4663", if not, modify:


  • Confirm that the camera model and calibration file in the "/opt/tros/share/mipi_cam/launch/" path are "GC4663", if not, modify:


ROS2 key acquisition fails or becomes unresponsive

Since the official ROS software source often fails to be accessed in China, ROS/ROS2 often encounters problems such as key acquisition failure and slow download speed when installing or updating ROS/ROS2,you can use the following domestic software sources to install or update.

"Encounter ROS download or update is not smooth? Why don't you try a domestic HUAWEI CLOUD image! "

How to install ROS2 on a PC ?

For details, please refer to the ROS2 installationprocedure

OriginBot code does not compile on PC

Some of the function packages in the OriginBot code repositoryneed to call the software resources in RDK X3(Sunrise X3 Pi), so they cannot be fully compiled on the PC side.If necessary, you can copy the required files or separate function packages to the PC for compilation and use.

Is TogetheROS open source ?

Open source, you can refer to the user manual of the Horizon Robotics platform.

Can ROS1 and ROS2 coexist ?

Yes, you only need to call the ROS version you want by setting the environment variables.

App features

The Rviz host computer cannot visualize the information

When running the application function, the visualization information such as TF and map cannot be displayed in the host computer Rviz, please check and confirm:

(1)Whether the robot and PC are on the same LAN and can ping each other through their IP addresses;

(2)If you are using a virtual machine to run Ubuntu, please confirm that the network configuration of the virtual machine is set to bridge mode;


(3)Test whether you can communicate

ros2 provides a network check CLI (command line interface) tool, multicast, which we can use to perform tests on two ros2 terminals.

First of all, on the computer, we start receiving multicast commands

ros2 multicast receive

On OriginBot, we send a multicast,

ros2 multicast send
If a message is received, it can be communicated by multiple machines

When the ROS_DOMAIN_ID of the computer and OriginBot are the same (both are 0 by default), they can communicate with each other through topics, etc.

Reference link: Do not set the master/slave machine, see how ROS2 communicates with multiple machines

The navigation app doesn't see the information in Rviz

After running the OriginBot navigation app, I can't see the map and bot information in the launched Rviz.


At this time, please use Ctrl+C to turn off the Rviz host computer on the PC side, as well as the navigation function on the robot side, and then run the Rviz host computer command on the PC side first, and then start the navigation function on the robot side, at this time, the map and TF information can be displayed in Rviz.

If it doesn't show up yet, repeat the operation 2~3 times.

The camera image transmission is severely stuck

ROS2 Foxy uses fastdds by default, which will be limited in the image transmission scenario, and we can switch to cyclonedds.

Note that DDS needs to be configured as cyclonedds for both the nodes sending and receiving images.Please refer to the Launching the ROS Camera Driverand Viewing Visualization Images section, and run the following command to switch the DDS used by the current terminal before starting the node:

$ export RMW_IMPLEMENTATION=rmw_cyclonedds_cpp
$ export CYCLONEDDS_URI='<CycloneDDS><Domain><General><NetworkInterfaceAddress>wlan0</NetworkInterfaceAddress></General></Domain></CycloneDDS>'