RPC Management Tools¶
How to Update RPC¶
Please use the provided updater program to update your RPC. During the update, the RPC will shut down, so make sure to put the robot in a safe position and connect the charger before proceeding.
Downloads (Updater)¶
updater : Download
You can check the latest RPC updates and release notes at the following link: RPC Release Notes on GitHub
Preparation (Updater)¶
Download the updater tool and extract the archive.
Download the appropriate RPC update file for your robot model from the release page.
Place the downloaded update file into the extracted updater directory.
Usage (Updater)¶
sudo apt-get install -y sshpass
tar -xvf updater.tar
cd updater_dist
chmod +x updater
# For ARM-based systems
./updater <update file name> <RPC IP address>
# For x86_64 systems
./updater_x86_64 <update file name> <RPC IP address>
# Example
./updater rby1_m_v1.2-0.10.6.tar.gz 192.168.30.1
./updater rby1_a_v1.0-0.10.6.tar 192.168.30.1
./updater_x86_64 rby1_a_v1.2-0.10.6.tar 192.168.0.192
Result Guide (Updater)¶
If the RPC update is completed successfully, you can verify the updated version in one of the following ways:
Check the version at the bottom of the Dashboard page in the Web UI
Check the version displayed on the backpack OLED
How to Extract Logs¶
The log_backup tool allows you to back up RPC logs directly through the UPC. Ensure the UPC is powered on and ready before proceeding.
Downloads (Log Backup)¶
log_backup(for UPC) : Download
Usage (Log Backup)¶
sudo apt-get install -y sshpass
# Make the tool executable
chmod +x log_backup
# Run the tool
./log_backup <RPC IP address>
# Example
./log_backup 192.168.30.1
After running the command, tar.gz log file will be generated in the same directory where you executed the program. Please attach this file when contacting us for analysis, as it will greatly assist in troubleshooting.
How to Check CAN Communication¶
The can_checker tool allows you to verify whether the CAN communication is functioning correctly.
Warning
Ensure that the robot’s main power is turned on before proceeding.
Downloads (CAN Checker)¶
can_checker(for UPC): Download
Usage (CAN Checker)¶
# Make the tool executable
chmod +x can_checker
# Run the tool
./can_checker <RPC IP address>
# Example
./can_checker 192.168.30.1
If the communication is functioning correctly, you will see output similar to the following. The process typically takes around 1-2 minutes to complete.
Checking can0 (right_arm)...
[SUCCESS] can0 (right_arm) is communicating!
Checking can1 (left_arm)...
[SUCCESS] can1 (left_arm) is communicating!
Checking can2 (torso)...
[SUCCESS] can2 (torso) is communicating!
Checking can3 (wheel)...
[SUCCESS] can3 (wheel) is communicating!
If any issues arise, please save the output and attach it when contacting us for further analysis.
How to Initialize the FT Sensor¶
The ft_initialization tool allows you to check the FT sensor status and perform initialization if supported by the connected sensor firmware.
Warning
Ensure that the robot’s main power is turned on before proceeding.
Downloads (FT Initialization)¶
ft_initialization: Download
Usage (FT Initialization)¶
# Install required package
sudo apt-get install sshpass
# Make the tool executable
chmod +x ./ft_initialization
## Example
# For ARM-based systems
./ft_initialization <RPC_ADDRESS>
# For x86_64 systems
./ft_initialization_x86_64 <RPC_ADDRESS>
Result Guide (FT Initialization)¶
SSAR25 → Latest version. Bias initialization is supported.
FAIL → Older version. Bias initialization is not supported.
If FAIL is displayed, please save the terminal output and contact our CS team(rby.support@rainbow-robotics.com). In this case, an FT sensor firmware update may be required.