7. Prepare the Robot Arm
Two arms: a leader you move by hand and a follower that repeats the motion. Install the environment, write servo IDs (skip on pre-built arms), calibrate both, and verify with a first teleoperation.
7.1 The Two Arms
7.1 The Two Arms
Leader arm — a low-cost open-source arm designed for education and research, available as a complete unit or a DIY kit. Six joints driven by 7.4 V-class STS3215 servos on a 5 V supply; it only reads joint angles.
Follower arm — the arm that executes. On the Pro kit it runs 12 V servos; it mirrors the leader during teleoperation and later executes the trained VLA policy.
The leader runs on 5 V and the follower on 12 V. Swapping them can damage the servos. Power both arms down before changing any cable.
The full assembly walkthrough lives in the beginner course: Beginner Chapter 6 — Configure Motors and Assemble the Arms covers 3D printing, motor planning, ID writing, and step-by-step assembly; Beginner Chapter 7 — Servo Debugging covers the Feetech debugging tool for a misbehaving servo.
7.2 Install the LeRobot Environment
7.2 Install the LeRobot Environment
Before calibration, install the exact environment every later chapter uses.
Install uv first, then create the workspace:
curl -LsSf https://astral.sh/uv/install.sh | sh
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
uv --version
mkdir ~/rebot_lerobot
cd ~/rebot_lerobot
sudo apt update
sudo apt install -y ffmpeg
# Download the Seeed LeRobot fork (includes SO101 leader/follower support)
git clone https://github.com/Seeed-Projects/lerobot.git
# Create virtual environment (Python 3.12)
uv venv --python 3.12 .venv
source .venv/bin/activate
uv pip install --upgrade pip
uv pip install -e ./lerobot
# Feetech servo SDK — required by the SO-101 buses
uv pip install feetech-servo-sdk
The runtime environment only needs to be configured once. Later chapters
assume you can re-enter it with:
cd ~/rebot_lerobot && source .venv/bin/activate
7.3 Kit or Pre-Built?
7.3 Kit or Pre-Built?
| Your situation | Assemble | Write servo IDs | Calibrate |
|---|---|---|---|
| 3D-printed or kit version | Yes | Yes | Yes |
| Pre-built arm (整机) | Already done | Skip — IDs are written at the factory | Yes |
If you bought pre-built arms, jump straight to 7.5 Calibrate the Arms.
Label every servo before it goes into a joint — F1–F6 on follower servos, L1–L6 on leader servos. Joint 1 = shoulder pan, 2 = shoulder lift, 3 = elbow, 4 = wrist pitch, 5 = wrist roll, 6 = gripper. SO-ARM101 leader joints 1–3 use different gear ratios than SO-ARM100 — check the ratio table in Beginner Chapter 6.2 before mounting anything.
All six servos share one serial bus. Configure IDs with exactly one servo wired to the controller board, or a duplicate ID gets written to every servo that has it.
7.4 Write Servo IDs (Kit Version Only)
7.4 Write Servo IDs (Kit Version Only)
Find the controller-board port first:
lerobot-find-port
Unplug the board when prompted and replug it; the printed port is yours
(usually /dev/ttyACM0).
Flash IDs joint by joint:
lerobot-setup-motors \
--robot.type=so101_follower \
--robot.port=/dev/ttyACM0
The tool names the joint to connect — wire up that single servo, press Enter, and it writes the ID and baud rate:
Connect the controller board to the 'gripper' motor only and press enter.
Repeat for all six follower joints, then run the same tool for the leader:
lerobot-setup-motors \
--teleop.type=so101_leader \
--teleop.port=/dev/ttyACM1
Configure serial port permissions (and remember them after reboots):
sudo usermod -aG dialout $USER # log out and back in once
sudo chmod 666 /dev/ttyACM*
On Ubuntu, the brltty service can claim the USB serial adapter. If the
port disappears after a few seconds, remove it: sudo apt remove brltty.
7.5 Calibrate the Arms
7.5 Calibrate the Arms
Calibration is required for both kit and pre-built arms. It teaches
LeRobot each joint's middle position and its two mechanical end stops.
Calibration files live under ~/.cache/huggingface/lerobot/calibration/,
keyed by arm ID — reuse an ID only for the same physical arm.
Find both ports, then export the values used by every later chapter:
export TELEOP_PORT=/dev/ttyACM0
export TELEOP_ID=so101_leader
export ROBOT_PORT=/dev/ttyACM1
export ROBOT_ID=so101_follower
Calibrate the leader:
lerobot-calibrate \
--teleop.type=so101_leader \
--teleop.port=$TELEOP_PORT \
--teleop.id=$TELEOP_ID
- Move every joint to the middle of its travel. Center the wrist roll carefully — if it starts at an end stop, the encoder can overflow during the sweep.
- Press Enter, then sweep each joint slowly to both end stops, one joint at a time. Repeats are fine; the extremes are overwritten.
- Press Enter to save.
Calibrate the follower the same way:
lerobot-calibrate \
--robot.type=so101_follower \
--robot.port=$ROBOT_PORT \
--robot.id=$ROBOT_ID
For the follower, stop at the arm's true mechanical end stop — not at a cable, not at the table. A pinched cable records a false limit and compresses the usable range.
If the follower mirrors only half of the leader's motion, or a joint snaps to an end stop, the range sweep was too short. Recalibrate that arm and move every joint through its complete travel.
If you run the NVIDIA workshop tooling, verify the follower's quality:
export ROBOT_PORT ROBOT_ID
python ~/Sim-to-Real-SO-101-Workshop/docker/real/scripts/so101_check_calibration.py
A good calibration ends with:
Overall: ✓ PASS — calibration looks good.
7.6 Verify the Robotic Arm
7.6 Verify the Robotic Arm
Bring both arms to a similar pose, then run:
lerobot-teleoperate \
--robot.type=so101_follower \
--robot.port=$ROBOT_PORT \
--robot.id=$ROBOT_ID \
--teleop.type=so101_leader \
--teleop.port=$TELEOP_PORT \
--teleop.id=$TELEOP_ID
Move the leader slowly. The follower must track each joint in the same
direction and reach the same end stops. Stop with Ctrl+C.
This also confirms the joint ordering used everywhere else in the course:
shoulder_pan, shoulder_lift, elbow_flex, wrist_flex, wrist_roll,
gripper. If one joint moves backwards, recalibrate — do not compensate in
software.
Keep one hand near the follower's power switch during the first runs.