Skip to content

Commit b299cfe

Browse files
authored
Add step assembly tutorial (#800)
1 parent bf6f89a commit b299cfe

33 files changed

+211
-12
lines changed

examples/10_use_so100.md

Lines changed: 211 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@
44

55
- [A. Source the parts](#a-source-the-parts)
66
- [B. Install LeRobot](#b-install-lerobot)
7-
- [C. Configure the motors](#c-configure-the-motors)
8-
- [D. Assemble the arms](#d-assemble-the-arms)
7+
- [C. Configure the Motors](#c-configure-the-motors)
8+
- [D. Step-by-Step Assembly Instructions](#d-step-by-step-assembly-instructions)
99
- [E. Calibrate](#e-calibrate)
1010
- [F. Teleoperate](#f-teleoperate)
1111
- [G. Record a dataset](#g-record-a-dataset)
@@ -70,6 +70,7 @@ conda install -y -c conda-forge "opencv>=4.10.0"
7070
```
7171
Great :hugs:! You are now done installing LeRobot and we can begin assembling the SO100 arms :robot:.
7272
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.
73+
7374
## C. Configure the motors
7475

7576
> [!NOTE]
@@ -221,28 +222,226 @@ Redo the process for all your motors until ID 6. Do the same for the 6 motors of
221222

222223
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.
223224

224-
#### c. Add motor horn to all 12 motors
225+
## D. Step-by-Step Assembly Instructions
226+
227+
**Step 1: Clean Parts**
228+
- Remove all support material from the 3D-printed parts.
229+
---
230+
231+
### Additional Guidance
225232

226233
<details>
227-
<summary><strong>Video adding motor horn</strong></summary>
234+
<summary><strong>Video assembling arms</strong></summary>
228235

229-
<video src="https://github.com/user-attachments/assets/ef3391a4-ad05-4100-b2bd-1699bf86c969"></video>
236+
<video src="https://github.com/user-attachments/assets/488a39de-0189-4461-9de3-05b015f90cca"></video>
230237

231238
</details>
232239

233-
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.
234-
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.
240+
**Note:**
241+
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.
235242

236-
## D. Assemble the arms
243+
---
237244

238-
<details>
239-
<summary><strong>Video assembling arms</strong></summary>
245+
### First Motor
240246

241-
<video src="https://github.com/user-attachments/assets/488a39de-0189-4461-9de3-05b015f90cca"></video>
247+
**Step 2: Insert Wires**
248+
- Insert two wires into the first motor.
249+
250+
<img src="../media/tutorial/img1.jpg" style="height:300px;">
251+
252+
**Step 3: Install in Base**
253+
- Place the first motor into the base.
242254

255+
<img src="../media/tutorial/img2.jpg" style="height:300px;">
256+
257+
**Step 4: Secure Motor**
258+
- Fasten the motor with 4 screws. Two from the bottom and two from top.
259+
260+
**Step 5: Attach Motor Holder**
261+
- Slide over the first motor holder and fasten it using two screws (one on each side).
262+
263+
<img src="../media/tutorial/img4.jpg" style="height:300px;">
264+
265+
**Step 6: Attach Motor Horns**
266+
- 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.
267+
268+
<img src="../media/tutorial/img5.jpg" style="height:300px;">
269+
<details>
270+
<summary><strong>Video adding motor horn</strong></summary>
271+
<video src="https://github.com/user-attachments/assets/ef3391a4-ad05-4100-b2bd-1699bf86c969"></video>
243272
</details>
244273

245-
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.
274+
**Step 7: Attach Shoulder Part**
275+
- Route one wire to the back of the robot and the other to the left or in photo towards you (see photo).
276+
- Attach the shoulder part.
277+
278+
<img src="../media/tutorial/img6.jpg" style="height:300px;">
279+
280+
**Step 8: Secure Shoulder**
281+
- Tighten the shoulder part with 4 screws on top and 4 on the bottom
282+
*(access bottom holes by turning the shoulder).*
283+
284+
---
285+
286+
### Second Motor Assembly
287+
288+
**Step 9: Install Motor 2**
289+
- Slide the second motor in from the top and link the wire from motor 1 to motor 2.
290+
291+
<img src="../media/tutorial/img8.jpg" style="height:300px;">
292+
293+
**Step 10: Attach Shoulder Holder**
294+
- Add the shoulder motor holder.
295+
- Ensure the wire from motor 1 to motor 2 goes behind the holder while the other wire is routed upward (see photo).
296+
- 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.
297+
298+
<div style="display: flex;">
299+
<img src="../media/tutorial/img9.jpg" style="height:250px;">
300+
<img src="../media/tutorial/img10.jpg" style="height:250px;">
301+
<img src="../media/tutorial/img12.jpg" style="height:250px;">
302+
</div>
303+
304+
**Step 11: Secure Motor 2**
305+
- Fasten the second motor with 4 screws.
306+
307+
**Step 12: Attach Motor Horn**
308+
- Attach both motor horns to motor 2, again use the horn screw.
309+
310+
**Step 13: Attach Base**
311+
- Install the base attachment using 2 screws.
312+
313+
<img src="../media/tutorial/img11.jpg" style="height:300px;">
314+
315+
**Step 14: Attach Upper Arm**
316+
- Attach the upper arm with 4 screws on each side.
317+
318+
<img src="../media/tutorial/img13.jpg" style="height:300px;">
319+
320+
---
321+
322+
### Third Motor Assembly
323+
324+
**Step 15: Install Motor 3**
325+
- Route the motor cable from motor 2 through the cable holder to motor 3, then secure motor 3 with 4 screws.
326+
327+
**Step 16: Attach Motor Horn**
328+
- Attach both motor horns to motor 3 and secure one again with a horn screw.
329+
330+
<img src="../media/tutorial/img14.jpg" style="height:300px;">
331+
332+
**Step 17: Attach Forearm**
333+
- Connect the forearm to motor 3 using 4 screws on each side.
334+
335+
<img src="../media/tutorial/img15.jpg" style="height:300px;">
336+
337+
---
338+
339+
### Fourth Motor Assembly
340+
341+
**Step 18: Install Motor 4**
342+
- Slide in motor 4, attach the cable from motor 3, and secure the cable in its holder with a screw.
343+
344+
<div style="display: flex;">
345+
<img src="../media/tutorial/img16.jpg" style="height:300px;">
346+
<img src="../media/tutorial/img19.jpg" style="height:300px;">
347+
</div>
348+
349+
**Step 19: Attach Motor Holder 4**
350+
- 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).
351+
352+
<img src="../media/tutorial/img17.jpg" style="height:300px;">
353+
354+
**Step 20: Secure Motor 4 & Attach Horn**
355+
- Fasten motor 4 with 4 screws and attach its motor horns, use for one a horn screw.
356+
357+
<img src="../media/tutorial/img18.jpg" style="height:300px;">
358+
359+
---
360+
361+
### Wrist Assembly
362+
363+
**Step 21: Install Motor 5**
364+
- Insert motor 5 into the wrist holder and secure it with 2 front screws.
365+
366+
<img src="../media/tutorial/img20.jpg" style="height:300px;">
367+
368+
**Step 22: Attach Wrist**
369+
- Connect the wire from motor 4 to motor 5. And already insert the other wire for the gripper.
370+
- Secure the wrist to motor 4 using 4 screws on both sides.
371+
372+
<img src="../media/tutorial/img22.jpg" style="height:300px;">
373+
374+
**Step 23: Attach Wrist Horn**
375+
- Install only one motor horn on the wrist motor and secure it with a horn screw.
376+
377+
<img src="../media/tutorial/img23.jpg" style="height:300px;">
378+
379+
---
380+
381+
### Follower Configuration
382+
383+
**Step 24: Attach Gripper**
384+
- Attach the gripper to motor 5.
385+
386+
<img src="../media/tutorial/img24.jpg" style="height:300px;">
387+
388+
**Step 25: Install Gripper Motor**
389+
- Insert the gripper motor, connect the motor wire from motor 5 to motor 6, and secure it with 3 screws on each side.
390+
391+
<img src="../media/tutorial/img25.jpg" style="height:300px;">
392+
393+
**Step 26: Attach Gripper Horn & Claw**
394+
- Attach the motor horns and again use a horn screw.
395+
- Install the gripper claw and secure it with 4 screws on both sides.
396+
397+
<img src="../media/tutorial/img26.jpg" style="height:300px;">
398+
399+
**Step 27: Mount Controller**
400+
- Attach the motor controller on the back.
401+
402+
<div style="display: flex;">
403+
<img src="../media/tutorial/img27.jpg" style="height:300px;">
404+
<img src="../media/tutorial/img28.jpg" style="height:300px;">
405+
</div>
406+
407+
*Assembly complete – proceed to Leader arm assembly.*
408+
409+
---
410+
411+
### Leader Configuration
412+
413+
For the leader configuration, perform **Steps 1–23**. Make sure that you removed the motor gears from the motors.
414+
415+
**Step 24: Attach Leader Holder**
416+
- Mount the leader holder onto the wrist and secure it with a screw.
417+
418+
<img src="../media/tutorial/img29.jpg" style="height:300px;">
419+
420+
**Step 25: Attach Handle**
421+
- Attach the handle to motor 5 using 4 screws.
422+
423+
<img src="../media/tutorial/img30.jpg" style="height:300px;">
424+
425+
**Step 26: Install Gripper Motor**
426+
- 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.
427+
428+
<img src="../media/tutorial/img31.jpg" style="height:300px;">
429+
430+
**Step 27: Attach Trigger**
431+
- Attach the follower trigger with 4 screws.
432+
433+
<img src="../media/tutorial/img32.jpg" style="height:300px;">
434+
435+
**Step 28: Mount Controller**
436+
- Attach the motor controller on the back.
437+
438+
<div style="display: flex;">
439+
<img src="../media/tutorial/img27.jpg" style="height:300px;">
440+
<img src="../media/tutorial/img28.jpg" style="height:300px;">
441+
</div>
442+
443+
*Assembly complete – proceed to calibration.*
444+
246445

247446
## E. Calibrate
248447

media/tutorial/img1.jpg

66.3 KB
Loading

media/tutorial/img10.jpg

127 KB
Loading

media/tutorial/img11.jpg

109 KB
Loading

media/tutorial/img12.jpg

80 KB
Loading

media/tutorial/img13.jpg

88.4 KB
Loading

media/tutorial/img14.jpg

86.2 KB
Loading

media/tutorial/img15.jpg

96.4 KB
Loading

media/tutorial/img16.jpg

84.5 KB
Loading

media/tutorial/img17.jpg

71.7 KB
Loading

media/tutorial/img18.jpg

78.1 KB
Loading

media/tutorial/img19.jpg

96.9 KB
Loading

media/tutorial/img2.jpg

88.5 KB
Loading

media/tutorial/img20.jpg

42.4 KB
Loading

media/tutorial/img21.jpg

84.7 KB
Loading

media/tutorial/img22.jpg

62 KB
Loading

media/tutorial/img23.jpg

53.9 KB
Loading

media/tutorial/img24.jpg

60.9 KB
Loading

media/tutorial/img25.jpg

75.6 KB
Loading

media/tutorial/img26.jpg

79.9 KB
Loading

media/tutorial/img27.jpg

48.1 KB
Loading

media/tutorial/img28.jpg

90.9 KB
Loading

media/tutorial/img29.jpg

54.3 KB
Loading

media/tutorial/img3.jpg

85.5 KB
Loading

media/tutorial/img30.jpg

57 KB
Loading

media/tutorial/img31.jpg

83.9 KB
Loading

media/tutorial/img32.jpg

87.5 KB
Loading

media/tutorial/img4.jpg

69.9 KB
Loading

media/tutorial/img5.jpg

65.5 KB
Loading

media/tutorial/img6.jpg

63.9 KB
Loading

media/tutorial/img7.jpg

88.8 KB
Loading

media/tutorial/img8.jpg

74.5 KB
Loading

media/tutorial/img9.jpg

81.9 KB
Loading

0 commit comments

Comments
 (0)