HOPEJr 組裝指南
具備 66 自由度、3D 列印零件並支援 LeRobot 的 DIY 人形機器人
授權條款
Apache-2.0
組裝指南
1. 開始之前
原專案為目前的手臂、機器手與外骨骼公開了列印檔、CAD 與零件清單,但沒有逐步組裝指南。以下步驟涵蓋它確實有記錄的內容。
1.1 選擇要組裝的版本
儲存庫中有兩種設計。Arm/ 是最新版,來自 Hugging Face。Humanoid/ 收錄完整機身,並附有自己的草稿。
- 手臂、機器手與遠端操作外骨骼,請以 Arm 資料夾為準:它反映最新的版本。
- 包括腿部在內的完整人形機器人,請使用 Humanoid 資料夾。其 readme 列出目前左右兩側手臂的草稿。
1.2 訂購零件
手臂的零件清單是 Arm/BOM.md。
- 清單涵蓋 Feetech 馬達(機器手用 SCS0009,手臂用 STS3250、STS3215 與 SM8512BL)、一片 URT-1 電路板,以及一片 Waveshare 伺服驅動板。
- 清單也列出手臂用的 12 V 5 A 電源、機器手用的 5 V 4 A 電源、USB 線與螺絲組。
- 納入 Arm/PCB 資料夾中的客製 PCB:它們用來連接馬達,因此不需要焊接。
1.3 依 CAD 列印並組裝
列印檔案位於 Arm/3dprint files 中的 arm 與 exoskeleton 之下。組裝完成的設計在 Arm/STEP。
- 列印手臂與外骨骼零件。
- 用 STEP/arm.step 與 STEP/exoskeleton.step 了解零件如何組合。
- 螺紋埋入件已改為螺栓,手指則以螺絲將線鎖定在位。
- 若卡關,可到 readme 中連結的社群 Discord 或 WhatsApp 詢問。
2. 安裝 LeRobot
HOPEJr 在 Hugging Face LeRobot 上運行。以下步驟依照 LeRobot 的 Hope Jr 指南。
2.1 安裝含 HopeJR 額外套件的版本
先依照 LeRobot 的安裝說明操作。
- 執行:pip install -e ".[hopejr]"
2.2 找出 USB 連接埠
手臂、機器手、手套與外骨骼各有自己的連接埠。
- 執行 lerobot-find-port,記下每個裝置的連接埠路徑。下列指令會用到它們。
3. 校正
遠端操作前先校正每個肢體。檔案儲存在 ~/.cache/huggingface/lerobot/calibration。
3.1 校正機器手
會開啟機器手的校正視窗。
- 執行 lerobot-calibrate,加上 --robot.type=hope_jr_hand、你的 --robot.port、一個 --robot.id 與 --robot.side。
- 在視窗中校正每個手指關節,設定其範圍邊界。
- 讓橈側與尺側屈肌的範圍大小相同、偏移量不同,使手指能對稱移動。
3.2 校正手套
機器手的遠端操作裝置。
- 執行 lerobot-calibrate,加上 --teleop.type=homunculus_glove、你的 --teleop.port、一個 --teleop.id 與 --teleop.side。
- 從拇指開始,讓每根手指走完其完整範圍,然後按 Enter 繼續。
3.3 校正機器手臂
會開啟手臂的校正視窗。
- 執行 lerobot-calibrate,加上 --robot.type=hope_jr_arm、你的 --robot.port 與一個 --robot.id。
- 讓肩部、手肘與手腕的每個關節走完其完整範圍,並調整其最小值與最大值。
3.4 校正外骨骼
手臂的遠端操作裝置。
- 執行 lerobot-calibrate,加上 --teleop.type=homunculus_arm、你的 --teleop.port 與一個 --teleop.id。
- 在提示時讓所有關節走完其完整範圍,然後按 Enter 儲存。
4. 遠端操作
由於 Feetech 中介軟體的衝突,手臂與機器手要在不同的 shell 工作階段中執行。
4.1 遠端操作機器手
由手套驅動機器手。
- 執行 lerobot-teleoperate,加上 --robot.type=hope_jr_hand 與 --teleop.type=homunculus_glove、你在校正時使用的連接埠、id 與側別,以及 --fps=30。
4.2 遠端操作手臂
由外骨骼驅動手臂。
- 在第二個 shell 中執行 lerobot-teleoperate,加上 --robot.type=hope_jr_arm 與 --teleop.type=homunculus_arm、你在校正時使用的連接埠與 id,以及 --fps=30。
5. 錄製與訓練
LeRobot 將 HOPEJr 上的錄製、重播與訓練標示為仍屬實驗性質。它的指南示範的是機器手部分。
5.1 錄製、重播與訓練
使用一台攝影機,以及你自己的資料集儲存庫。
- 用 lerobot-record 錄製,指定機器手、手套、一台相機與一個 --dataset.repo_id。
- 用 lerobot-replay 檢查該回合。
- 用 lerobot-train 搭配 --policy.type=act 訓練,然後依 LeRobot 指南的說明進行評估。