From b299cfea8a2356b033d0ed46207dce2e0924fc12 Mon Sep 17 00:00:00 2001
From: Pepijn <138571049+pkooij@users.noreply.github.com>
Date: Tue, 4 Mar 2025 09:57:37 +0100
Subject: [PATCH] Add step assembly tutorial (#800)
---
examples/10_use_so100.md | 227 ++++++++++++++++++++++++++++++++++++---
media/tutorial/img1.jpg | Bin 0 -> 67855 bytes
media/tutorial/img10.jpg | Bin 0 -> 129990 bytes
media/tutorial/img11.jpg | Bin 0 -> 111488 bytes
media/tutorial/img12.jpg | Bin 0 -> 81939 bytes
media/tutorial/img13.jpg | Bin 0 -> 90551 bytes
media/tutorial/img14.jpg | Bin 0 -> 88316 bytes
media/tutorial/img15.jpg | Bin 0 -> 98726 bytes
media/tutorial/img16.jpg | Bin 0 -> 86507 bytes
media/tutorial/img17.jpg | Bin 0 -> 73468 bytes
media/tutorial/img18.jpg | Bin 0 -> 79960 bytes
media/tutorial/img19.jpg | Bin 0 -> 99177 bytes
media/tutorial/img2.jpg | Bin 0 -> 90672 bytes
media/tutorial/img20.jpg | Bin 0 -> 43387 bytes
media/tutorial/img21.jpg | Bin 0 -> 86694 bytes
media/tutorial/img22.jpg | Bin 0 -> 63458 bytes
media/tutorial/img23.jpg | Bin 0 -> 55148 bytes
media/tutorial/img24.jpg | Bin 0 -> 62354 bytes
media/tutorial/img25.jpg | Bin 0 -> 77381 bytes
media/tutorial/img26.jpg | Bin 0 -> 81866 bytes
media/tutorial/img27.jpg | Bin 0 -> 49286 bytes
media/tutorial/img28.jpg | Bin 0 -> 93048 bytes
media/tutorial/img29.jpg | Bin 0 -> 55617 bytes
media/tutorial/img3.jpg | Bin 0 -> 87554 bytes
media/tutorial/img30.jpg | Bin 0 -> 58339 bytes
media/tutorial/img31.jpg | Bin 0 -> 85916 bytes
media/tutorial/img32.jpg | Bin 0 -> 89561 bytes
media/tutorial/img4.jpg | Bin 0 -> 71612 bytes
media/tutorial/img5.jpg | Bin 0 -> 67065 bytes
media/tutorial/img6.jpg | Bin 0 -> 65468 bytes
media/tutorial/img7.jpg | Bin 0 -> 90926 bytes
media/tutorial/img8.jpg | Bin 0 -> 76325 bytes
media/tutorial/img9.jpg | Bin 0 -> 83830 bytes
33 files changed, 213 insertions(+), 14 deletions(-)
create mode 100644 media/tutorial/img1.jpg
create mode 100644 media/tutorial/img10.jpg
create mode 100644 media/tutorial/img11.jpg
create mode 100644 media/tutorial/img12.jpg
create mode 100644 media/tutorial/img13.jpg
create mode 100644 media/tutorial/img14.jpg
create mode 100644 media/tutorial/img15.jpg
create mode 100644 media/tutorial/img16.jpg
create mode 100644 media/tutorial/img17.jpg
create mode 100644 media/tutorial/img18.jpg
create mode 100644 media/tutorial/img19.jpg
create mode 100644 media/tutorial/img2.jpg
create mode 100644 media/tutorial/img20.jpg
create mode 100644 media/tutorial/img21.jpg
create mode 100644 media/tutorial/img22.jpg
create mode 100644 media/tutorial/img23.jpg
create mode 100644 media/tutorial/img24.jpg
create mode 100644 media/tutorial/img25.jpg
create mode 100644 media/tutorial/img26.jpg
create mode 100644 media/tutorial/img27.jpg
create mode 100644 media/tutorial/img28.jpg
create mode 100644 media/tutorial/img29.jpg
create mode 100644 media/tutorial/img3.jpg
create mode 100644 media/tutorial/img30.jpg
create mode 100644 media/tutorial/img31.jpg
create mode 100644 media/tutorial/img32.jpg
create mode 100644 media/tutorial/img4.jpg
create mode 100644 media/tutorial/img5.jpg
create mode 100644 media/tutorial/img6.jpg
create mode 100644 media/tutorial/img7.jpg
create mode 100644 media/tutorial/img8.jpg
create mode 100644 media/tutorial/img9.jpg
diff --git a/examples/10_use_so100.md b/examples/10_use_so100.md
index b39a0239..23da1eab 100644
--- a/examples/10_use_so100.md
+++ b/examples/10_use_so100.md
@@ -4,8 +4,8 @@
- [A. Source the parts](#a-source-the-parts)
- [B. Install LeRobot](#b-install-lerobot)
- - [C. Configure the motors](#c-configure-the-motors)
- - [D. Assemble the arms](#d-assemble-the-arms)
+ - [C. Configure the Motors](#c-configure-the-motors)
+ - [D. Step-by-Step Assembly Instructions](#d-step-by-step-assembly-instructions)
- [E. Calibrate](#e-calibrate)
- [F. Teleoperate](#f-teleoperate)
- [G. Record a dataset](#g-record-a-dataset)
@@ -70,6 +70,7 @@ conda install -y -c conda-forge "opencv>=4.10.0"
```
Great :hugs:! You are now done installing LeRobot and we can begin assembling the SO100 arms :robot:.
Every time you now want to use LeRobot you can go to the `~/lerobot` folder where we installed LeRobot and run one of the commands.
+
## C. Configure the motors
> [!NOTE]
@@ -221,19 +222,13 @@ Redo the process for all your motors until ID 6. Do the same for the 6 motors of
Follow the video for removing gears. You need to remove the gear for the motors of the leader arm. As a result, you will only use the position encoding of the motor and reduce friction to more easily operate the leader arm.
-#### c. Add motor horn to all 12 motors
+## D. Step-by-Step Assembly Instructions
-
-Video adding motor horn
+**Step 1: Clean Parts**
+- Remove all support material from the 3D-printed parts.
+---
-
-
-
-
-Follow the video for adding the motor horn. For SO-100, you need to align the holes on the motor horn to the motor spline to be approximately 1:30, 4:30, 7:30 and 10:30.
-Try to avoid rotating the motor while doing so to keep position 2048 set during configuration. It is especially tricky for the leader motors as it is more sensible without the gears, but it's ok if it's a bit rotated.
-
-## D. Assemble the arms
+### Additional Guidance
Video assembling arms
@@ -242,7 +237,211 @@ Try to avoid rotating the motor while doing so to keep position 2048 set during
-Follow the video for assembling the arms. It is important to insert the cables into the motor that is being assembled before you assemble the motor into the arm! Inserting the cables beforehand is much easier than doing this afterward. The first arm should take a bit more than 1 hour to assemble, but once you get used to it, you can do it under 1 hour for the second arm.
+**Note:**
+This video provides visual guidance for assembling the arms, but it doesn't specify when or how to do the wiring. Inserting the cables beforehand is much easier than doing it afterward. The first arm may take a bit more than 1 hour to assemble, but once you get used to it, you can assemble the second arm in under 1 hour.
+
+---
+
+### First Motor
+
+**Step 2: Insert Wires**
+- Insert two wires into the first motor.
+
+
+
+**Step 3: Install in Base**
+- Place the first motor into the base.
+
+
+
+**Step 4: Secure Motor**
+- Fasten the motor with 4 screws. Two from the bottom and two from top.
+
+**Step 5: Attach Motor Holder**
+- Slide over the first motor holder and fasten it using two screws (one on each side).
+
+
+
+**Step 6: Attach Motor Horns**
+- Install both motor horns, securing the top horn with a screw. Try not to move the motor position when attaching the motor horn, especially for the leader arms, where we removed the gears.
+
+
+
+ Video adding motor horn
+
+
+
+**Step 7: Attach Shoulder Part**
+- Route one wire to the back of the robot and the other to the left or in photo towards you (see photo).
+- Attach the shoulder part.
+
+
+
+**Step 8: Secure Shoulder**
+- Tighten the shoulder part with 4 screws on top and 4 on the bottom
+*(access bottom holes by turning the shoulder).*
+
+---
+
+### Second Motor Assembly
+
+**Step 9: Install Motor 2**
+- Slide the second motor in from the top and link the wire from motor 1 to motor 2.
+
+
+
+**Step 10: Attach Shoulder Holder**
+- Add the shoulder motor holder.
+- Ensure the wire from motor 1 to motor 2 goes behind the holder while the other wire is routed upward (see photo).
+- This part can be tight to assemble, you can use a workbench like the image or a similar setup to push the part around the motor.
+
+
+
+**Step 11: Secure Motor 2**
+- Fasten the second motor with 4 screws.
+
+**Step 12: Attach Motor Horn**
+- Attach both motor horns to motor 2, again use the horn screw.
+
+**Step 13: Attach Base**
+- Install the base attachment using 2 screws.
+
+
+
+**Step 14: Attach Upper Arm**
+- Attach the upper arm with 4 screws on each side.
+
+
+
+---
+
+### Third Motor Assembly
+
+**Step 15: Install Motor 3**
+- Route the motor cable from motor 2 through the cable holder to motor 3, then secure motor 3 with 4 screws.
+
+**Step 16: Attach Motor Horn**
+- Attach both motor horns to motor 3 and secure one again with a horn screw.
+
+
+
+**Step 17: Attach Forearm**
+- Connect the forearm to motor 3 using 4 screws on each side.
+
+
+
+---
+
+### Fourth Motor Assembly
+
+**Step 18: Install Motor 4**
+- Slide in motor 4, attach the cable from motor 3, and secure the cable in its holder with a screw.
+
+
+

+

+
+
+**Step 19: Attach Motor Holder 4**
+- Install the fourth motor holder (a tight fit). Ensure one wire is routed upward and the wire from motor 3 is routed downward (see photo).
+
+
+
+**Step 20: Secure Motor 4 & Attach Horn**
+- Fasten motor 4 with 4 screws and attach its motor horns, use for one a horn screw.
+
+
+
+---
+
+### Wrist Assembly
+
+**Step 21: Install Motor 5**
+- Insert motor 5 into the wrist holder and secure it with 2 front screws.
+
+
+
+**Step 22: Attach Wrist**
+- Connect the wire from motor 4 to motor 5. And already insert the other wire for the gripper.
+- Secure the wrist to motor 4 using 4 screws on both sides.
+
+
+
+**Step 23: Attach Wrist Horn**
+- Install only one motor horn on the wrist motor and secure it with a horn screw.
+
+
+
+---
+
+### Follower Configuration
+
+**Step 24: Attach Gripper**
+- Attach the gripper to motor 5.
+
+
+
+**Step 25: Install Gripper Motor**
+- Insert the gripper motor, connect the motor wire from motor 5 to motor 6, and secure it with 3 screws on each side.
+
+
+
+**Step 26: Attach Gripper Horn & Claw**
+- Attach the motor horns and again use a horn screw.
+- Install the gripper claw and secure it with 4 screws on both sides.
+
+
+
+**Step 27: Mount Controller**
+- Attach the motor controller on the back.
+
+
+

+

+
+
+*Assembly complete – proceed to Leader arm assembly.*
+
+---
+
+### Leader Configuration
+
+For the leader configuration, perform **Steps 1–23**. Make sure that you removed the motor gears from the motors.
+
+**Step 24: Attach Leader Holder**
+- Mount the leader holder onto the wrist and secure it with a screw.
+
+
+
+**Step 25: Attach Handle**
+- Attach the handle to motor 5 using 4 screws.
+
+
+
+**Step 26: Install Gripper Motor**
+- Insert the gripper motor, secure it with 3 screws on each side, attach a motor horn using a horn screw, and connect the motor wire.
+
+
+
+**Step 27: Attach Trigger**
+- Attach the follower trigger with 4 screws.
+
+
+
+**Step 28: Mount Controller**
+- Attach the motor controller on the back.
+
+
+

+

+
+
+*Assembly complete – proceed to calibration.*
+
## E. Calibrate
diff --git a/media/tutorial/img1.jpg b/media/tutorial/img1.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..c16fbf5e9204d8a00d44434b86a289fd25344d01
GIT binary patch
literal 67855
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