Open Source Robotics

精選高品質的開源機器人專案、工具與軟體,推動機器人社群向前發展。

HOPEJr 組裝指南

具備 66 自由度、3D 列印零件並支援 LeRobot 的 DIY 人形機器人

授權條款

Apache-2.0

組裝指南

1. 開始之前

原專案為目前的手臂、機器手與外骨骼公開了列印檔、CAD 與零件清單,但沒有逐步組裝指南。以下步驟涵蓋它確實有記錄的內容。

1.1 選擇要組裝的版本

儲存庫中有兩種設計。Arm/ 是最新版,來自 Hugging Face。Humanoid/ 收錄完整機身,並附有自己的草稿。

  1. 手臂、機器手與遠端操作外骨骼,請以 Arm 資料夾為準:它反映最新的版本。
  2. 包括腿部在內的完整人形機器人,請使用 Humanoid 資料夾。其 readme 列出目前左右兩側手臂的草稿。

1.2 訂購零件

手臂的零件清單是 Arm/BOM.md。

  1. 清單涵蓋 Feetech 馬達(機器手用 SCS0009,手臂用 STS3250、STS3215 與 SM8512BL)、一片 URT-1 電路板,以及一片 Waveshare 伺服驅動板。
  2. 清單也列出手臂用的 12 V 5 A 電源、機器手用的 5 V 4 A 電源、USB 線與螺絲組。
  3. 納入 Arm/PCB 資料夾中的客製 PCB:它們用來連接馬達,因此不需要焊接。

1.3 依 CAD 列印並組裝

列印檔案位於 Arm/3dprint files 中的 arm 與 exoskeleton 之下。組裝完成的設計在 Arm/STEP。

  1. 列印手臂與外骨骼零件。
  2. 用 STEP/arm.step 與 STEP/exoskeleton.step 了解零件如何組合。
  3. 螺紋埋入件已改為螺栓,手指則以螺絲將線鎖定在位。
  4. 若卡關,可到 readme 中連結的社群 Discord 或 WhatsApp 詢問。

2. 安裝 LeRobot

HOPEJr 在 Hugging Face LeRobot 上運行。以下步驟依照 LeRobot 的 Hope Jr 指南。

2.1 安裝含 HopeJR 額外套件的版本

先依照 LeRobot 的安裝說明操作。

  1. 執行:pip install -e ".[hopejr]"

2.2 找出 USB 連接埠

手臂、機器手、手套與外骨骼各有自己的連接埠。

  1. 執行 lerobot-find-port,記下每個裝置的連接埠路徑。下列指令會用到它們。

3. 校正

遠端操作前先校正每個肢體。檔案儲存在 ~/.cache/huggingface/lerobot/calibration。

3.1 校正機器手

會開啟機器手的校正視窗。

  1. 執行 lerobot-calibrate,加上 --robot.type=hope_jr_hand、你的 --robot.port、一個 --robot.id 與 --robot.side。
  2. 在視窗中校正每個手指關節,設定其範圍邊界。
  3. 讓橈側與尺側屈肌的範圍大小相同、偏移量不同,使手指能對稱移動。

3.2 校正手套

機器手的遠端操作裝置。

  1. 執行 lerobot-calibrate,加上 --teleop.type=homunculus_glove、你的 --teleop.port、一個 --teleop.id 與 --teleop.side。
  2. 從拇指開始,讓每根手指走完其完整範圍,然後按 Enter 繼續。

3.3 校正機器手臂

會開啟手臂的校正視窗。

  1. 執行 lerobot-calibrate,加上 --robot.type=hope_jr_arm、你的 --robot.port 與一個 --robot.id。
  2. 讓肩部、手肘與手腕的每個關節走完其完整範圍,並調整其最小值與最大值。

3.4 校正外骨骼

手臂的遠端操作裝置。

  1. 執行 lerobot-calibrate,加上 --teleop.type=homunculus_arm、你的 --teleop.port 與一個 --teleop.id。
  2. 在提示時讓所有關節走完其完整範圍,然後按 Enter 儲存。

4. 遠端操作

由於 Feetech 中介軟體的衝突,手臂與機器手要在不同的 shell 工作階段中執行。

4.1 遠端操作機器手

由手套驅動機器手。

  1. 執行 lerobot-teleoperate,加上 --robot.type=hope_jr_hand 與 --teleop.type=homunculus_glove、你在校正時使用的連接埠、id 與側別,以及 --fps=30。

4.2 遠端操作手臂

由外骨骼驅動手臂。

  1. 在第二個 shell 中執行 lerobot-teleoperate,加上 --robot.type=hope_jr_arm 與 --teleop.type=homunculus_arm、你在校正時使用的連接埠與 id,以及 --fps=30。

5. 錄製與訓練

LeRobot 將 HOPEJr 上的錄製、重播與訓練標示為仍屬實驗性質。它的指南示範的是機器手部分。

5.1 錄製、重播與訓練

使用一台攝影機,以及你自己的資料集儲存庫。

  1. 用 lerobot-record 錄製,指定機器手、手套、一台相機與一個 --dataset.repo_id。
  2. 用 lerobot-replay 檢查該回合。
  3. 用 lerobot-train 搭配 --policy.type=act 訓練,然後依 LeRobot 指南的說明進行評估。

本網站需要 JavaScript 才能正常運作。請啟用 JavaScript 以瀏覽我們的開源機器人專案。