Developer Setup Guide

Goal: Clone the RBQ repository, set up the development environment, and launch the simulator so you can test robot behavior before running on hardware.

📖

REQUIRED READING

Familiarize yourself with the safety guidelines before testing on the real robot: General Safety Guidelines.

System Requirements

Item	Requirement
OS	Ubuntu 22.04 (x86-64)
CPU	Intel Core i7 12th Gen or equivalent
RAM	16 GB or more
Storage	25 GB free space
Control	Keyboard (W/A/S/D/Q/E/R/F, 1–5) or Logitech F710 gamepad

Step 1. Clone the Repository

git clone https://github.com/RainbowRobotics/RBQ.git
cd RBQ

All SDK source code, examples, scripts, and simulator environments live inside RBQ/.
Run all commands from this directory unless stated otherwise.

Note: Pre-built binaries are already included in bin/. No compilation step is required to run the simulator or deploy to the robot.

Step 2. Launch the Simulator

Start the RBQ control stack, MuJoCo physics simulator, and RBQGUI together:

bash scripts/sim.bash          # motion only
bash scripts/sim.bash --vision # motion + vision sensors

If prompted, enter your user password in the newly opened terminal windows.

Step 3. Connect and Initialize in RBQGUI

1. In RBQGUI, click Connect — the indicator changes to Simulator Connected (blue).
2. Click Auto Start Robot — all indicators turn green when ready.
3. In the Walk tab, press Stance (or keyboard 2) to stand the robot up.

The robot is now ready to receive commands. Refer to Basic Motion Command for joystick and gait control.

i

NOTE

In simulation, only Control Start turns green. On the real robot, all three startup indicators (Motor Check / Initialize Pose / Control Start) turn green when ready.

Step 4. Run on the Real Robot

When you are ready to test on hardware:

1. Place the robot in the correct initial pose.
2. Connect your development PC to the robot Wi-Fi (RBQ_xxxx).
3. Launch the GUI (from RBQ/):

./bin/GUI

4. Click Connect → Auto Start Robot → Stance.

It is strongly recommended to verify all behaviors in simulation before testing on the real robot.

Step 5. Update the Robot

Robot software is updated from RBQGUI, using UPDATE ROBOT on the Software Update screen. RBQGUI transfers and installs the new version, then prompts you to restart.

→ Robot Software Update

⚠

CAUTION

Put the robot in the sitting state before restarting, and do not move it until the restart finishes. Running a mismatched binary and script combination can cause unexpected behavior.

Detailed Reference

Topic	Link
Full GUI walkthrough	Developers Guide (Software)
GUI panel details	GUI Introduction
Simulation environment	MuJoCo Simulation
Concepts & architecture	Concept