Open Source Robotics

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

LeKiwi 組裝指南

搭配 SO-ARM101 與 LeRobot 的低成本全向移動操作機器人

授權條款

Apache-2.0

組裝指南

1. 選擇版本並備齊零件

原專案公開了三個版本(5V、12V 與有線)的物料清單,並附上如何選擇的說明。這裡的所有內容都取自 LeKiwi 儲存庫與 SO-ARM100 儲存庫。

1.1 選擇電源版本

採購任何東西之前,先在 5V 版本(行動電源)、12V 版本(12v 5a 電池)與有線版本之間做決定。

  1. 原專案為馬達與電子元件提供三種選項:5V、12V 或有線。
  2. 原專案的建議:若這是你第一次製作機器人,請選擇 5V 版本,因為它稍微容易組裝一些。若你較有經驗且想舉起較重的物體,請選擇 12V 版本。若你想要最便宜的選項,請選擇有線版本。
  3. 12V 版本的車輪使用 12v ST3215 Feetech 伺服機,Pi 則使用 12v to 5v 轉換器。5V 版本使用 STS3215 伺服機與行動電源。若手臂使用 12V 伺服機,SO-ARM100 README 寫道:「若這樣做,你也必須購買 12V 5A 以上的電源供應器,而不是 5V 的。」
  4. 原專案表示 SO-101 的主導臂一律為 7.4V。

1.2 依物料清單備齊零件

備齊 LeKiwi 物料清單中你所選版本的零件,包括 3 個全向輪、螺絲組、Raspberry Pi 5 與 Waveshare 馬達控制板。

  1. 5V 與 12V 版本共用的零件:4" Omni wheels (3);M2 M3 M4 Assorted Screw Set (1);Raspberry Pi 5 (4GB) (1);USB camera (2);microSD card (1);Table Clamp 4pcs (1);Screwdriver Set (1);USB-C to USB-A Cable 2 pcs (1)。
  2. 5V 版本,移動底座電子元件:20000maH 85W Power Bank (1);STS3215 Servo (3);USB-C Cable 2pcs, 1 foot or 0.5 m (1);USB-C To DC Cable (1)。
  3. 12V 版本,移動底座電子元件:12v 5a Battery (1);Lever Wire Connector (1);12v 5a DC plug connector (1);12v to 5v 5a USB-C converter (1);12v ST3215 Feetech Servo (3)。
  4. 有線版本:4" Omni wheels (3);M2 M3 M4 Assorted Screw Set (1);USB camera (2);USB-C to USB-A Cable 2 pcs (1);USB-C To DC Cable (1);STS3215 Servo (3);Motor Control Board (1);Power Supply (1);USB Hub (1);USB-C extension cable (1)。
  5. 兩支 SO-101 手臂(跟隨臂與主導臂),5V 套組:STS3215 Servo (12);Motor Control Board (2);Power Supply (1)。12V 套組:12v ST3215 Servo (12);Motor Control Board (2);Power Supply (1)。LeKiwi 清單對全部 12 顆手臂馬達只列一種伺服機,但 SO-101 文件為主導臂指定了三種減速比,列於下一行。
  6. SO-ARM100 README 中的 SO-101 伺服機清單,兩支手臂的零件:STS3215 Servo 7.4V, 1/345 gear (C001) x 7;STS3215 Servo 7.4V, 1/191 gear (C044) x 2;STS3215 Servo 7.4V, 1/147 gear (C046) x 3;Motor Control Board x 2;Power Supply x 2。原專案註明六顆主導臂伺服機可以整組購買(3 x 1/147 gear (C046)、2 x 1/191 gear (C044)、1 x 1/345 gear (C001))。
  7. 原專案註腳:另一個支援的攝影機選項是 Arducam 5MP Wide Angle。列印的攝影機座是為所選的攝影機製作的,因此使用其他攝影機時可能需要修改。
  8. 原專案的總價(不含 3D 列印成本):12V 機器人 $482、5V 機器人 $499、僅底座(5V)$248、僅底座(12V)$251.5、僅底座有線版 $184。價格會因購買地點與時間而異。

2. 3D 列印

原專案估計列印時間約 34 小時,並提供可直接列印的 STL 檔,適用於消費級 FDM 印表機上的一般 PLA。

2.1 準備印表機

準備一台使用一般 PLA 線材的消費級 FDM 印表機。

  1. 依印表機本身的說明校正印表機並調平列印平台。
  2. 清潔列印平台。
  3. 裝入線材。
  4. 原專案在 Bambu Lab P1S 上測試:將每個零件載入切片軟體,自動旋轉、自動排列,啟用所有建議的支撐,然後列印。

2.2 列印 LeKiwi 底座零件

列印底座板、3 個驅動馬達座、3 個伺服機輪轂、伺服機控制器座、電池或行動電源座、Pi 外殼與攝影機座。

  1. 列印:Base plate Top (1) 與 Base plate Bottom (1);Drive motor mount (3),檔案 drive_motor_mount_v2.stl;Servo wheel hub (3),需加支撐;Servo controller mount (1);RasPi case Top (1) 與 RasPi case Bottom (1)。
  2. 列印一個電池座:12v Battery mount、12v EU Battery mount 或 5v Battery mount(檔案 5v_specific/5v_power_bank_holder.stl)。
  3. 列印一組攝影機座:Arducam base mount 與 wrist mount,或 webcam base mount、gripper insert 與 wrist mount。
  4. 以樹狀支撐列印 Modified Follower Arm Base (1)。原專案將其標為選配,但若你尚未製作過 SO-100,則建議列印。
  5. 原專案測試時使用的設定:填充密度 15%、層高 0.2 mm、列印速度 150 mm/s。在有指定的地方啟用支撐,之後再從列印件上移除。
  6. 原專案註腳:伺服機輪轂改自 VEX VersaHub 模型,Pi 外殼改自 Micro Center 的模型。
  7. 有線版本的原專案組裝頁面另外使用兩個列印件:wired_specific/cable_holder v0.stl 與 wired_specific/usb_connector_case v1.stl。

2.3 列印兩支 SO-101 手臂

以 SO-ARM100 的檔案列印一支跟隨臂與一支主導臂。

  1. LeKiwi 零件表列出 Follower arm (1) 與 Leader arm (1),並指向 SO-ARM100 儲存庫取得檔案。
  2. SO-ARM100 README 表示,主導臂或跟隨臂的所有零件都包含在每支手臂的單一檔案中,已以 z 軸朝上正確擺放以盡量減少支撐,並為 Ender、Prusa 與 Bambu Lab 印表機分別提供檔案。
  3. SO-ARM100 README 也列出主導臂的單一零件,例如 Handle_SO101.stl 與 Trigger_SO101.stl。

3. 安裝軟體

Hugging Face 的 LeKiwi LeRobot 文件會在組裝步驟之前,先在 Raspberry Pi 與你的筆電或 PC 上安裝 LeRobot。有線版本則全部在筆電上執行。

3.1 在 Pi 上安裝作業系統

在 Raspberry Pi 5 的 microSD 卡上安裝 Raspberry Pi OS 或 Ubuntu。

  1. 有線版本:跳過 Pi 安裝與 SSH 設定,在你的 PC 上執行所有指令,包括 LeKiwi 腳本與主導臂腳本。
  2. 原專案指向 Raspberry Pi 入門文件與 Raspberry Pi Imager,用來安裝 Raspberry Pi OS 或 Ubuntu。
  3. 機器人上的電腦通常是 Raspberry Pi,但原專案表示可以是任何能以 5V 運作、且有足夠 USB 連接埠(2 個以上)供攝影機與馬達控制板使用的 PC。

3.2 在 Pi 上設定 SSH

在 Pi 上啟用 SSH,這樣不必為 Pi 接螢幕或鍵盤,也能從筆電登入。

  1. 設定好 Pi 之後,依 Raspberry Pi 遠端存取文件的說明啟用並設定 SSH。
  2. 從命令提示字元登入,或使用安裝了 Remote - SSH 擴充功能的 VSCode 登入。

3.3 在 Pi 上安裝 LeRobot

在 Raspberry Pi 上安裝含 lekiwi 額外套件的 LeRobot,它會加入 Feetech 馬達支援與 ZeroMQ。

  1. 在 Pi 上依照 LeRobot Installation Guide 操作。
  2. 此外,用以下指令安裝 Feetech 馬達支援與 ZeroMQ:pip install -e ".[lekiwi]"
  3. 原專案之後在 Pi 上是先執行 conda activate lerobot 再執行指令,因此其範例中的環境名稱為 lerobot。

3.4 在筆電或 PC 上安裝 LeRobot

在將執行遠端操作與主導臂的筆電上,安裝含 lekiwi 額外套件的 LeRobot。

  1. 若筆電上已安裝 LeRobot,請跳過基本安裝;否則請依照 LeRobot Installation Guide。
  2. 此外,用以下指令安裝 Feetech 馬達支援與 ZeroMQ:pip install -e ".[lekiwi]"
  3. 原專案表示,之後每次使用 LeRobot,都要進入安裝它的 ~/lerobot 資料夾,並從那裡執行指令。

4. 設定馬達 ID

每顆伺服機在裝進手臂或底座之前,都要一次一顆設定各自的 ID。車輪馬達使用 ID 7、8 與 9;手臂馬達使用 ID 1 至 6。

4.1 找出每塊馬達控制板的 USB 連接埠

以 lerobot-find-port 找出每塊 Waveshare 馬達控制板的序列埠。

  1. 以 USB 將馬達控制板連接到電腦並接上電源,然後執行:lerobot-find-port
  2. 出現提示時拔下電路板的 USB 線並按 Enter。腳本會印出連接埠,例如 Mac 上的 /dev/tty.usbmodem575E0032081 或 Linux 上的 /dev/ttyACM0。之後再接回 USB 線。
  3. 在 Linux 上,你可能需要用以下指令開放 USB 連接埠的存取權限:sudo chmod 666 /dev/ttyACM0 與 sudo chmod 666 /dev/ttyACM1
  4. 對要裝在 LeKiwi 上的電路板做這個步驟,並另外對主導臂的電路板做一次。

4.2 設定跟隨臂與輪子馬達的 ID

以 --robot.type=lekiwi 執行 lerobot-setup-motors,將 6 顆跟隨臂伺服機的 ID 設為 6 到 1,3 顆輪子伺服機的 ID 設為 9、8、7。

  1. 指令(使用上一步找到的連接埠):lerobot-setup-motors --robot.type=lekiwi --robot.port=/dev/tty.usbmodem58760431551
  2. 腳本會先設定手臂馬達(ID 6 到 1),再設定車輪馬達(ID 9、8、7)。原專案表示這些 ID 必須依特定順序才能運作。
  3. 車輪 ID,依原專案馬達 ID 圖中的標示以及 LeRobot LeKiwi 原始碼中的定義:ID 7 是左輪(base_left_wheel),ID 8 是後輪(base_back_wheel),ID 9 是右輪(base_right_wheel)。LeKiwi 上只使用一塊馬達控制板,這就是車輪 ID 為 7、8 與 9 的原因。
  4. LeRobot 原始碼中的手臂 ID:1 肩部水平旋轉、2 肩部抬升、3 肘部屈曲、4 腕部屈曲、5 腕部滾轉、6 夾爪。
  5. 腳本會針對每顆馬達,要求你將控制板只連接到該馬達(第一個提示是 gripper 馬達)並按 Enter。確認它是唯一連接到電路板的馬達,且該馬達沒有與其他馬達菊鏈串接。按 Enter 會為該馬達設定 ID 與鮑率。
  6. 原專案會將這些值寫入每顆馬達的非揮發性 EEPROM,因此只需要做一次。每一步按 Enter 之前請檢查接線:操作電路板時電源線可能會鬆脫。
  7. 若出現錯誤,請檢查電源供應器、電腦與控制板之間的 USB 線,以及從電路板到馬達的 3-pin 線。若是 Waveshare 電路板,兩個跳線帽必須在 B 通道(USB)上。
  8. 讓每顆馬達對應其 ID:ID 7 的車輪馬達裝在左側位置,8 在後方,9 在右側,如原專案的圖所示。

4.3 設定主導臂馬達的 ID

在主導臂自己的控制板上,為 6 顆主導臂伺服機重複馬達設定,並讓每種減速比對應到正確的關節。

  1. 指令:lerobot-setup-motors --teleop.type=so101_leader --teleop.port=/dev/tty.usbmodem575E0031751
  2. LeKiwi 頁面將主導臂類型寫為 so100_leader,SO-101 頁面則寫為 so101_leader。LeRobot 原始碼將這兩個名稱都註冊給同一個主導臂類別。
  3. 主導臂使用三種不同減速比的馬達。主導臂軸、馬達 ID、減速比:底座 / 肩部水平旋轉 1,1/191;肩部抬升 2,1/345;肘部屈曲 3,1/191;腕部屈曲 4,1/147;腕部滾轉 5,1/147;夾爪 6,1/147。
  4. 跟隨臂使用 6 顆 1/345 減速比的 STS3215 馬達。
  5. 主導臂的電路板與 LeKiwi 上的電路板是分開的,並以 USB 連接到你的筆電。

5. 組裝兩支 SO-101 手臂

原專案的 LeKiwi 組裝頁面假設手臂已經組好,而 Hugging Face 的 LeKiwi 頁面則指向其 SO-101 頁面說明手臂組裝。以下步驟依照該 SO-101 頁面;每個關節都要在跟隨臂與主導臂上各做一次。原專案的 LeKiwi 組裝頁面表示,SO-100 或 SO-101 手臂都可以使用。

5.1 清理列印件

移除 3D 列印手臂零件上的支撐材,每顆馬達放好後接上一條 3-pin 線。

  1. 移除 3D 列印件上的所有支撐材。最簡單的方法是用小螺絲起子伸到支撐材下方。
  2. 建議每顆馬達放好後、繼續組裝之前,先在每顆馬達上裝一條 3-pin 線。

5.2 關節 1:底座與肩部

以 4 顆 M2x6mm 螺絲將馬達 1 裝入底座,再以 M3x6mm 螺絲裝上肩部。

  1. 裝上兩個舵盤。用一顆 M3x6mm 螺絲固定上方舵盤。下方舵盤不需要螺絲。
  2. 將第一顆馬達放入底座。
  3. 用 4 顆 M2x6mm 螺絲(最小的螺絲)固定馬達,上方兩顆、下方兩顆。
  4. 套上第一個馬達座,並用兩顆 M2x6mm 螺絲(每側一顆)固定。
  5. 裝上肩部零件。
  6. 用上方 4 顆、下方 4 顆 M3x6mm 螺絲鎖緊肩部零件。
  7. 裝上肩部馬達座。

5.3 關節 2:上臂

以 4 顆 M2x6mm 螺絲裝上馬達 2,再以每側 4 顆 M3x6mm 螺絲裝上上臂。

  1. 裝上兩個舵盤。用一顆 M3x6mm 螺絲固定上方舵盤。下方舵盤不需要螺絲。
  2. 從上方將第二顆馬達滑入。
  3. 用 4 顆 M2x6mm 螺絲固定第二顆馬達。
  4. 每側用 4 顆 M3x6mm 螺絲裝上上臂。

5.4 關節 3:前臂

以 4 顆 M2x6mm 螺絲裝上馬達 3,再以每側 4 顆 M3x6mm 螺絲連接前臂。

  1. 裝上兩個舵盤。用一顆 M3x6mm 螺絲固定上方舵盤。下方舵盤不需要螺絲。
  2. 插入馬達 3,並用 4 顆 M2x6mm 螺絲固定。
  3. 每側用 4 顆 M3x6mm 螺絲將前臂連接到馬達 3。

5.5 關節 4:手腕俯仰

以 4 顆 M2x6mm 螺絲將馬達 4 裝入其支架。

  1. 裝上兩個舵盤。用一顆 M3x6mm 螺絲固定上方舵盤。下方舵盤不需要螺絲。
  2. 套上馬達座 4。
  3. 滑入馬達 4。
  4. 用 4 顆 M2x6mm 螺絲固定馬達 4。

5.6 關節 5:手腕滾轉

以 2 顆 M2x6mm 螺絲將馬達 5 裝入手腕支架,再以兩側各 4 顆 M3x6mm 螺絲將手腕固定到馬達 4 上。

  1. 將馬達 5 插入腕部座,並用 2 顆 M2x6mm 前方螺絲固定。
  2. 腕部馬達只裝一個舵盤,並用一顆 M3x6mm 舵盤螺絲固定。
  3. 從兩側用 4 顆 M3x6mm 螺絲將腕部固定到馬達 4。

5.7 跟隨臂夾爪

以 4 顆 M3x6mm 螺絲將夾爪裝到馬達 5 上,以每側 2 顆 M2x6mm 螺絲裝上夾爪馬達,再以 4 顆 M3x6mm 螺絲裝上夾顎。

  1. 將夾爪裝到馬達 5,用 4 顆 M3x6mm 螺絲將它固定到腕部的舵盤上。
  2. 插入夾爪馬達,每側用 2 顆 M2x6mm 螺絲固定。
  3. 在夾爪馬達上裝上兩個舵盤。用一顆 M3x6mm 螺絲固定上方舵盤;下方舵盤不需要螺絲。
  4. 裝上夾爪爪片,從兩側用 4 顆 M3x6mm 螺絲固定。
  5. 若之後使用網路攝影機選項,原專案的 LeKiwi 組裝頁面會使用另一款帶 M3 螺帽埋入件的跟隨臂夾爪;見攝影機步驟。

5.8 主導臂握把

以 4 顆 M3x6mm 螺絲裝上主導臂支架,以 1 顆 M2x6mm 螺絲裝上握把,以每側 2 顆 M2x6mm 螺絲裝上夾爪馬達,再以 4 顆 M3x6mm 螺絲裝上扳機(Trigger_SO101.stl)。

  1. 將主導臂座裝到腕部上,並用 4 顆 M3x6mm 螺絲固定。
  2. 用 1 顆 M2x6mm 螺絲將握把裝到主導臂座上。
  3. 插入夾爪馬達,每側用 2 顆 M2x6mm 螺絲固定,並用一顆 M3x6mm 舵盤螺絲裝上一個舵盤。
  4. 用 4 顆 M3x6mm 螺絲裝上扳機(Trigger_SO101.stl)。

5.9 主導臂:保留馬達中的齒輪

以 SO-101 所列的三種減速比馬達組裝主導臂,不要拆下其中任何齒輪。

  1. 依照 Hugging Face 的 SO-101 指南組裝遠端操作手臂。SO-101 主導臂有三種減速比,不要拆除任何齒輪。
  2. 拆除齒輪是較早的 SO-100 的做法,其主導臂使用六顆同一減速比的馬達。若你組裝的是 SO-100 主導臂,SO-100 頁面會要你拆除 6 顆主導臂馬達的齒輪;這不屬於 SO-101 的組裝。
  3. SO-ARM100 README 說明 SO-101 較容易組裝(不需拆除齒輪),且主導臂使用更新過的馬達。
  4. 依主導臂表格放置每顆馬達:關節 1 為 1/191,關節 2 為 1/345,關節 3 為 1/191,關節 4、5 與 6 為 1/147。

6. 組裝移動底盤

原專案的 Assembly.md 估計需時 2 小時。它以照片為主,確切的安裝位置呈現在線上的 Fusion 360 模型中,以下步驟依照其文字說明。

6.1 輪子模組:將馬達裝到馬達座上

以 4 顆 m2x5 自攻螺絲將一顆驅動馬達裝到一個驅動馬達座上。

  1. 總共製作三個車輪模組。每個模組包含一顆驅動馬達、一個驅動馬達座、一個輪轂與一個全向輪。
  2. 用 4 顆 m2x5 自攻螺絲將驅動馬達裝到馬達座上。
  3. 保持 ID 順序:ID 7 的馬達是左輪,ID 8 是後輪,ID 9 是右輪。

6.2 輪子模組:將馬達座裝到下底座板

以 4 顆 m3x12 機械螺絲將驅動馬達座鎖到下底座板上。

  1. 用 4 顆 m3x12 機械螺絲將驅動馬達座鎖到底部底座板上。

6.3 輪子模組:將輪轂裝到全向輪上

以 2 顆 m4x12 機械螺絲將輪轂裝到全向輪上。

  1. 用 2 顆 m4x12 機械螺絲將輪轂裝到全向輪上。

6.4 輪子模組:將伺服機舵盤裝到輪轂上

以 2 顆 m3x16 機械螺絲將伺服機舵盤裝到輪轂上。

  1. 用 2 顆 m3x16 機械螺絲將舵盤裝到輪轂上。

6.5 輪子模組:將舵盤裝到驅動馬達上

以 1 顆 m3x6 機械螺絲將伺服機舵盤裝到驅動馬達上,然後確認 3 個模組都已裝在下底座板上。

  1. 用 1 顆 m3x6 機械螺絲將舵盤裝到驅動馬達上。
  2. 對三個模組重複上述步驟,並將 3 個模組都裝到底部底座板上,如原專案的照片所示。

6.6 下底板:控制器座與電池座

將 m3 螺帽放入伺服機控制器座與電池座,再以 4 顆 m3x12 機械螺絲將兩者鎖到下底座板上。

  1. 將 m3 螺帽放入伺服機控制器座與電池座中。用 4 顆 m3x12 機械螺絲將兩者鎖到底部底座板上。
  2. 若是 5V 版本,原專案表示可使用行動電源座(5v_power_bank_holder.stl)固定行動電源,裝在下層板的後方。

6.7 下底板:伺服機驅動板與驅動伺服機線材

裝上伺服機驅動板,並將其線材接到 3 顆驅動伺服機上。

  1. 裝上伺服驅動板,並將線接到 3 顆驅動伺服機上。

6.8 12V 版本配線

12V 版本請以槓桿式接線端子將電池導線接到 12v 轉 5v 轉換器與 DC 圓形插頭轉接器,並以 2 顆 m3x16 機械螺絲與 2 顆 m3 螺帽固定轉換器。

  1. 僅限 12V 版本:用 wago 槓桿式接線端子,將電池的接地與電源導線連接到 12v->5v 轉換器與 DC 圓形插頭轉接器的導線。
  2. 用 2 顆 m3x16 機械螺絲與 2 個 m3 螺帽將 12v to 5v 轉換器鎖到底部底座板上。
  3. 原專案的文字沒有提供極性細節;請依照其接線照片。

6.9 5V 版本配線

5V 版本請依原專案的 5V 接線圖連接行動電源、Raspberry Pi 與伺服機控制板。

  1. 僅限 5V 版本:依原專案的 5V 接線圖連接線材。
  2. 依圖中標示,接線圖顯示一個行動電源(SH-CP05A, 5V, DC 5525)透過 USB-C 為 Raspberry Pi 5 供電,並透過 USB-C to DC 線為伺服板的 DC 插孔(DC 5.52.1)供電;伺服板以 USB 連接到 Pi,板上接有一顆 7.4V 伺服機。
  3. 原專案對最後一步的文字是:將 DC 圓形插頭轉接器插入伺服馬達控制器,並將 5V USB-C 接頭插入 Raspberry Pi 5,為電子元件供電。

6.10 上底板:Raspberry Pi 與跟隨臂

將 Raspberry Pi 5 放入外殼,以 2 顆 m3x12 機械螺絲將它固定到上底座板,再以 4 顆 m3x20 機械螺絲安裝跟隨臂。

  1. 將 Raspberry Pi 5 放入 Pi 外殼底部,並扣上外殼上蓋。
  2. 用 2 顆 m3x12 機械螺絲將 Pi 裝到上層底座板上,並用 4 顆 m3x20 機械螺絲安裝 SO-101 手臂。
  3. 使用原專案修改過的 SO-101 底座或原版底座都可以,因為底座板上兩者的孔位都有。

6.11 有線版本:纜線固定座與 USB-C 纜線

僅限有線版本:列印並裝上纜線固定座與 USB 接頭外殼,並以正確方向插上 USB-C 延長線。

  1. 僅限有線版本:依原專案的照片組裝列印件 cable_holder v0.stl 與 usb_connector_case v1.stl。
  2. 原專案表示,依圖示方向插入 USB-C 線非常重要。UGreen 標誌應與 20GBS, 240W 標籤位於同一側,連接到筆電時 20GBS, 240W 那一側朝上。
  3. 若 USB-C 延長線偵測不到攝影機或馬達控制板,可能是線的方向錯了,應翻轉 180 度。
  4. 依原專案的照片(標為重要)連接兩台攝影機、馬達控制板與 USB-C 延長器的線。

6.12 最終組裝:將纜線穿過上底板

將伺服機控制器的 USB-C 轉 USB-A 纜線、5V USB-C 電源線與手臂的伺服機線材穿過上底座板上的孔。

  1. 將伺服機控制器的 USB-C to USB-A 線、5V USB-C 電源線與 SO-101 伺服機線穿過上層底座板上的孔。

6.13 最終組裝:將上底板裝到馬達座上

以 4 顆 m3x12 機械螺絲將上底座板裝到馬達座上。

  1. 用 4 顆 m3x12 機械螺絲將上層底座板裝到馬達座上。

6.14 攝影機:Arducam 方案

將底座攝影機座裝到下底座板,手腕攝影機座裝到固定夾爪上,兩者各以 2 顆 M2.5x12 機械螺絲固定一台 Arducam 5MP 廣角攝影機。

  1. 列印 1 x base_camera_mount.stl 與 1 x wrist_camera_mount.stl。
  2. 將底座攝影機座鎖到底部底座板上,並用 2 顆 M2.5x12 機械螺絲將 Arducam 5MP 廣角攝影機裝到座上。攝影機線可從缺口穿過。
  3. 用 4 顆 M2x5 自攻螺絲將腕部攝影機座鎖到固定夾爪上,並用 2 顆 M2.5x12 機械螺絲將 Arducam 5MP 廣角攝影機裝到座上。
  4. 原專案註明這些座是為這些攝影機製作的,用於其他攝影機時可能需要修改。

6.15 攝影機:網路攝影機方案

以一顆 M3x12mm 螺栓與一顆 M3 螺帽將網路攝影機手腕座裝到夾爪上,以 2 顆 M3x35mm 螺栓與 2 顆螺帽固定攝影機,底座網路攝影機座也以相同方式安裝。

  1. 列印 1 x webcam_mount/webcam_mount.stl、1 x webcam_mount/so100_gripper_cam_mount_insert.stl 與 1 x webcam_mount/webcam_mount_wrist.stl。
  2. 列印帶有 M3 螺帽嵌槽的新夾爪,並放入螺帽。然後插入馬達並裝上夾爪。
  3. 取 webcam_mount_wrist.stl,加上一顆 M3x12mm 螺栓並鎖緊,直到與夾爪中的 M3 螺帽鎖定。將攝影機放入座中,並在後方孔位加上 2 x M3x35mm 螺栓,配合放入槽中的 2 個螺帽,將攝影機固定到位。
  4. 以 webcam_mount.stl 對底座攝影機做同樣的處理,並將它裝在 LeKiwi 的前方。

6.16 接上所有線材

透過 DC 圓形插頭轉接器為伺服機控制器供電,透過 5V USB-C 接頭為 Raspberry Pi 5 供電,再將伺服機控制器與攝影機的 USB 纜線插到 Pi 上。

  1. 將 DC 圓形插頭轉接器插入伺服馬達控制器,並將 5V USB-C 接頭插入 Raspberry Pi 5,為電子元件供電。
  2. 伺服機控制器與攝影機的 USB 線可以直接插到 Raspberry Pi 上。

7. 校正並操控

取自 Hugging Face LeKiwi 頁面的校正與遠端操作指令。車輪馬達不需要校正。

7.1 校正跟隨臂

透過 SSH 在 Pi 上執行 lerobot-calibrate,校正底座上的跟隨臂。

  1. 確認手臂已連接到 Raspberry Pi。有線版本:在筆電上執行所有指令。
  2. 執行:lerobot-calibrate --robot.type=lekiwi --robot.id=my_awesome_kiwi(用 --robot.id 為機器人取一個唯一的名稱)。
  3. 先將手臂移到每個關節都位於其活動範圍中間的位置,然後按 Enter。接著讓所有關節走過其完整的活動範圍。
  4. 車輪馬達不需要校正。原專案強調校正非常重要,因為它能讓在一台機器人上訓練的神經網路在另一台機器人上運作。

7.2 校正主導臂

在筆電上執行 lerobot-calibrate,校正主導臂。

  1. 執行:lerobot-calibrate --teleop.type=so100_leader --teleop.port=/dev/tty.usbmodem58760431551 --teleop.id=my_awesome_leader_arm
  2. 使用你主導臂的連接埠,並用 --teleop.id 為手臂取一個唯一的名稱。SO-101 頁面寫的同一指令是 --teleop.type=so101_leader。
  3. 原專案也提供一個使用 lerobot.teleoperators.so_leader 中 SO100LeaderConfig 與 SO100Leader 的 Python 範例。

7.3 排除連線問題

如果 LeKiwi 無法連線,請檢查 Pi 的 IP 位址、ping 它,並嘗試 SSH。

  1. 在 Pi 上執行:hostname -I,並確認你的指令或程式碼中使用的是 Pi 的正確 IP。
  2. 在筆電上執行:ping <your_pi_ip_address>。若 ping 失敗,請確認 Pi 已開機、位於同一網路,且已啟用 SSH。
  3. 嘗試:ssh <your_pi_user_name>@<your_pi_ip_address>。若出現連線錯誤,請在 Pi 上執行 sudo raspi-config,在 Interfacing Options 中選擇 SSH 並啟用。

7.4 遠端操作 LeKiwi

先在 Pi 上啟動主機程式,再在筆電上執行遠端操作範例,以鍵盤與主導臂操控。

  1. Mac:你可能需要允許 Terminal 存取鍵盤。前往 System Preferences、Security and Privacy、Input Monitoring,並勾選 Terminal。
  2. 以 SSH 登入 Pi,執行 conda activate lerobot,然後執行:python -m lerobot.robots.lekiwi.lekiwi_host --robot.id=my_awesome_kiwi
  3. 主機會在 --host.connection_time_s 秒(預設 30)後停止。若要進行較長的工作階段,例如錄製資料集,請將其調高,例如 --host.connection_time_s=600。
  4. 在筆電上執行 conda activate lerobot,在 examples/lekiwi/teleoperate.py 中設定正確的 remote_ip 與 port,然後執行:python examples/lekiwi/teleoperate.py
  5. 按鍵:W 前進、A 向左、S 後退、D 向右、Z 左轉、X 右轉、R 加速、F 減速。
  6. 速度模式(線速度、旋轉速度):快速 0.3 m/s、90 deg/s;中速 0.2 m/s、60 deg/s;慢速 0.1 m/s、30 deg/s。
  7. 底座的鍵盤遠端操作依賴全域按鍵後端,因此只能在 X11 工作階段、Windows 桌面,或已授予 Accessibility 或 Input Monitoring 權限的 macOS 上運作,無法在 Wayland 或無頭(headless)機器上使用。
  8. 有線版本:在筆電上執行所有指令。

7.5 錄製、重播與評估

使用 LeRobot 中的 LeKiwi 範例,錄製第一個資料集、重播一個片段,並評估一個策略。

  1. 錄製:以具寫入權限的權杖登入 Hugging Face hub(hf auth login --token ${HUGGINGFACE_TOKEN} --add-to-git-credential),在腳本中調整 remote_ip、HF_REPO_ID、主導臂連接埠與 TASK_DESCRIPTION,然後執行:python examples/lekiwi/record.py
  2. 原專案建議第一個任務至少錄製 50 個回合,例如在不同位置抓取物體並放入箱中,每個位置 10 個回合,攝影機保持固定。
  3. 重播:變更 remote_ip、port、資料集 id 與回合索引,然後執行:python examples/lekiwi/replay.py
  4. 評估策略:變更 remote_ip、port 與模型,然後執行:python examples/lekiwi/evaluate.py
  5. 訓練部分請見 Hugging Face 的頁面 Getting started with real-world robots,本指南不重複其內容。

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