Repository navigation
Assembly Guide
Purchase the electronics in the sourcing table, then print the 3D parts from STL/ and follow the steps below.
Each step has an illustration where noted (see the quick reference table).
| Part | Qty | Notes |
|---|---|---|
| Ball bearing | 6 | Supported Ball Bearing.stl |
| Omniwheel core | 1 | Omni Wheel Core.stl |
| Bearing inner ring | 1 | Bearing Inner Ring.stl |
| Ball retainer | 1 | Ball Retainer.stl |
Assembly
-
Insert all six ball bearings onto the omniwheel core, then slide in the bearing inner ring.
-
Push the bearing inner ring against the balls while turning it so that the protruding circle faces up. Align the balls so they are spaced evenly at 60°.
-
Push the ball retainer into the balls until it snaps into place.
| Part | Qty | Notes |
|---|---|---|
| Filament cut to 29 cm | 1 | Roller axle material |
| Roller | 5 | Roller.stl |
| Omniwheel frame side | 2 | Omni Wheel Frame.stl |
| Hub retaining ring | 1 | Hub Retaining Ring.stl |
Assembly
-
Slide the five rollers onto the 29 cm filament, spacing them evenly.
-
Clamp the filament between the two omniwheel frame sides.
-
Place the clamped frame onto the omniwheel core and secure it with the hub retaining ring.
-
Repeat Steps 2.1–2.3 for the other side of the omniwheel.
| Part | Qty | Notes |
|---|---|---|
| Rear base | 1 | Rear Base.stl |
| Main base bolt | 1 | Main Base Bolt.stl |
| Rear deadwheel bracket | 1 | Rear Deadwheel Bracket.stl |
| Rear wheel nut | 1 | Rear Wheel Nut.stl |
| Omni wheel | 1 | From Steps 1–2 |
Assembly
-
Connect the rear deadwheel bracket to the rear base with the main base bolt.
-
Slide the omni wheel onto the rear axle and tighten the rear wheel nut.
-
Repeat Steps 1–3 for the other side.
| Part | Qty | Notes |
|---|---|---|
| Feetech STS3215 servo (1/345) | 1 | From sourcing table |
| STS drive plate | 1 | |
| Phillips screw | 1 | |
| M3 × 5 mm screw | 4 | |
| Servo coupler | 1 | Servo Coupler.stl |
| Servo bracket | 1 | Left · Right |
| Arm base | 1 | Arm Base.stl |
| Main base bolt | 1 | Main Base Bolt.stl |
Assembly
-
Attach the STS drive plate to the Feetech STS3215 servo with the Phillips screw, then use the four M3 × 5 mm screws to bolt on the servo coupler.
-
Insert the Feetech servo assembly into the servo bracket.
-
Place the arm base on top of the servo bracket. Run the main base bolt through the arm base and tighten it on the servo bracket.
-
Repeat for the other side as well.
| Part | Qty | Notes |
|---|---|---|
| Ball bearing | 6 | Supported Ball Bearing.stl |
| Bearing inner ring | 1 | Bearing Inner Ring.stl |
| Wheel bearing bracket | 1 | Left · Right |
| Ball retainer | 1 | Ball Retainer.stl |
Assembly
-
Insert all six ball bearings into the wheel bearing bracket, then slide in the bearing inner ring.
-
Push the bearing inner ring against the balls while turning it. Align the balls so they are spaced evenly at 60°.
-
Push the ball retainer into the balls until it snaps into place.
-
Repeat for the other side.
| Part | Qty | Notes |
|---|---|---|
| Traction servo assembly | 1 | From Step 4 |
| Traction wheel bearing | 1 | From Step 5 |
| VEX shaft half | 1 | Front Axle Halve.stl |
| VEX Traction Wheel | 1 | VEX item 276-1497 |
| Front drive bolt | 1 | Front Drive Bolt.stl |
| Main base bolt | 2 | Main Base Bolt.stl |
Assembly
-
Insert the VEX shaft half into the VEX Traction Wheel, then into the traction wheel bearing.
-
Align the axle end to face the servo coupler, then push the axle into the servo coupler until it clicks in place. Secure by locking the front drive bolt into the arm base side thread.
-
Repeat for the other side.
-
Use two main base bolts to attach the rear base to the arm base.
Build the follower arm per the official LeRobot SO-101 assembly guide (motor setup, joints, gripper).
| Part | Qty | Notes |
|---|---|---|
| Arm retainer pin | 4 | Arm Retainer Pin Halve.stl |
| Arm pin half bracket | 1 | Arm Pin Half Bracket.stl |
| Arm pin mini bracket | 1 | Arm Pin Mini Bracket.stl |
| Arm pin bolt | 1 | Arm Pin Bolt.stl |
Assembly
-
Mount the base of the SO101 follower arm to the chassis. Insert all four arm retainer pins all the way into the holes.
-
Insert the arm pin half bracket on one of the pins on the bottom of the chassis and rotate it until it reaches the back.
-
Push the arm pin mini bracket into place and fasten using the arm pin bolt.
-
Repeat 7.2 and 7.3 for all pins.
The two Feetech STS3215 traction-wheel servos ship with the factory ID. Each must be set to ID 7 (left) and ID 8 (right) before the robot is wired up. Use the SO101 Driver board (not the LCD board) and keep the two jumpers on B until the end of this section.
-
Get the repo (needed for
configure-left-right.pyand the rest of the build):git clone https://github.com/timrobot/SOBle.git cd SOBle -
Plug a USB-C cable from your computer into the SO101 Driver board.
-
Plug in the barrel jack (UBEC / bench power — do not connect the battery yet if you are still on the bench).
-
From the repo root, run the motor ID script (default port is macOS; Linux e.g.
/dev/ttyACM0, WindowsCOM3):cd examples python configure-left-right.pyUse
-c/--comportif your port differs, e.g.python configure-left-right.py -c /dev/ttyACM0. -
Left motor only — plug the left traction servo into the driver bus, press Enter, then unplug the left motor when the script says it succeeded.
-
Right motor only — plug in the right traction servo, press Enter, then unplug the right motor when done.
-
Unplug all power — disconnect the barrel jack and the USB-C cable from the SO101 Driver board.
-
Move the two jumpers on the SO101 Driver board from B to A.
-
Wire J2 (servo 2) to the left traction motor.
-
Wire the left traction motor to the right traction motor.
-
Wire the right traction motor to J1 (servo 1).
If the board is already on the robot, do not power the robot. The SO101 Driver board may be damaged if the robot is powered without a shared ground.
-
Install the Python package on your laptop (if you have not already):
pip install "soble @ git+https://github.com/timrobot/SOBle.git@master" -
Plug a USB-C cable from your computer to the LCD board.
-
Flash firmware — Open
esp32/So101-Platform/in the Arduino IDE (or your usual ESP32 toolchain). Add the esp32 boards library from the boards manager and GFX_Library_for_Arduino from the Library Manager. -
Apply the patch — before uploading, run from the repo (required for the Waveshare LCD on ESP32 core 4.x):
cd esp32 ./patches/apply.sh -
On the port, select the ESP32-S3 Dev Module board type, click on the connected serial port, and upload the sketch. It should take around one minute.
-
Unplug the USB-C cable from the LCD board.
-
Insert the barrel connector and UBEC power wires into the XT60 female screw terminal, as shown in the diagram.
-
Optional. If you are planning to use the Raspi camera or you have hooked jumpers, you will have to do this. Be warned that this step is irreversible:
- Remove the header from the end of the UBEC.
- Insert the power wires into the USB-C female screw terminal, as shown in the diagram.
-
Solder the header pins onto the LCD board's right side. (You may skip this step if you are using hooked jumpers.)
| Part | Qty | Notes |
|---|---|---|
| LCD (ESP32-S3) | 1 | From Step 9 |
| ESP32 Mount | 1 | ESP32 Mount.stl |
| M2 × 6 mm screw | 4 | From sourcing table |
| Rear base | 1 | From Step 3 |
| ESP32 bolt | 1 | ESP32 Bolt.stl |
| Bus adapter | 1 | Bus Adapter Bracket.stl |
| Bus adapter clamping foot | 2 | Bus Adapter Clamping Foot.stl |
| Bus adapter clamp bolt | 2 | Bus Adapter Clamp Bolt.stl |
| Bus adapter bracket top | 1 | Bus Adapter Bracket Top.stl |
| Bus adapter bracket bottom | 1 | Bus Adapter Bracket Bottom.stl |
| SO101 Driver board | 1 | From SO101 follower arm |
| Bus adapter bracket retainer | 1 | Bus Adapter Bracket Retainer.stl |
| Bus adapter retainer bolt | 1 | Bus Adapter Retainer Bolt.stl |
Assembly
-
Place the LCD onto the ESP32 Mount and insert four M2×6 mm screws.
-
Slide the ESP32 Mount onto the rear base and secure with the ESP32 bolt.
-
Secure the clamp feet to the bus adapter with the bus adapter clamp bolt.
-
Clamp the top and bottom bus adapter brackets onto the SO101 Driver board.
-
Insert the top and bottom bus adapter brackets into the bus adapter, slide on the bus adapter bracket retainer, and secure with the bus adapter retainer bolt.
-
Slide the bus adapter into the back of the SO101 arm.
-
Attach the jumper headers (or hooks) to the LCB board's right side (Diagram A), and then wire them to the SO101 Driver board (Diagram B).
-
LCD connection options:
- With Raspi camera — Use a USB-C → µ-USB cable from the UBEC to the Raspi PWR. Use a µ-USB → USB-C cable from Raspi USB to the LCD board. (See Raspi camera attachment (optional) for camera assembly.)
- No Raspi camera, UBEC USB-C — Use a USB-C to USB-C cable from the UBEC to the LCD board.
- No Raspi camera, UBEC header — Plug the header into the right side of the LCD board (as shown).
-
Plug the barrel connector into the SO101 Driver board.
-
Insert the 7.4 V battery into the battery cage and secure it with the battery lock (Battery Lock.stl).
WARNING: When you start the example below, the follower arm on the robot will immediately engage to match the joint mapping in your config file. Keep hands clear of the arm and make sure it has room to move before running.
-
Plug the leader arm into your PC or Mac. Record the serial port.
-
Plug the XT60 male connector into the battery's XT60 female socket. This will power the robot.
-
Read the robot name on the OLED. Then, on your PC or Mac:
cd examples python viz-apriltags.py -p /dev/tty.usbmodem575E0032081 -n Capybara -c config.json-
-p— Leader port (Linux e.g./dev/ttyACM0, Windows e.g.COM3, macOS e.g./dev/tty.usbmodem575E0032081) -
-n— Robot name (e.g.Capybara) -
-c— Config file — leader/follower joint limits (see config.json)
-
You can now control the robot using WASD and the leader arm.
If you plan to add the Raspi camera attachment, print SO-ARM101_IMX708_wrist_mount.stl and mount it on the gripper as shown:
-
Camera to Pi — Connect the Arducam IMX708 camera module to the Raspberry Pi Zero 2 W camera port.
-
Mount Pi + camera — Secure the camera and Pi Zero 2 W to the cam mount.
-
SD card — Flash an SD card with Raspberry Pi OS. Setup the WiFi if you require video streaming.
-
AprilTag service — Boot the Pi, copy the
SOBle/raspitree onto it, and run:bash install-detect-atags-service.sh
(from
SOBle/raspi/). Then shut the Pi down.
Optional: Display an AprilTag such as this tag16h5 example on your phone — with the Raspi camera attached, you should see the tag detected in the pygame window.
| Step | Summary | Image |
|---|---|---|
| 1 | Omni-directional ball bearing | 1a.png · 1b.png · 1c.png |
| 2 | Omni-directional rollers | — |
| 3 | Rear omni-wheel assembly | 3a.png · 3b.png |
| 4 | Traction wheel servo | 4a.png · 4b.png · 4c.png |
| 5 | Traction wheel bearing | 5a.png · 5b.png · 5c.png |
| 6 | Front wheel assembly | 6a.png · 6b.png · 6d.png |
| 7 | Mount SO101 follower arm | 7a.png · 7b.png · 7c.png |
| 8 | Configure left/right traction motor IDs (SO101 Driver board, jumpers B→A) | — |
| 9 | Install SOBle and flash firmware | esp32s3lcd.png |
| 10 | Prepare cables and LCD header pins | 10a.png · 10b.png · 10c.png |
| 11 | Mounting the Electronics | 11a.png · 11b.png · 11c.png · 11d.png · 11e.png |
| 12 | Wire arm UART, UBEC, and LCD power | UART Wiring.png · Driver Wiring.png |
| 13 | Power on, run viz-apriltags.py
|
— |
| — | Optional: Raspi camera + AprilTag service | CamMount.png |
If a printed part name in your slicer folder differs from the labels above, match by shape to the step image.