XLeRobot 組裝指南
實用的雙臂移動式居家機器人,660 美元、組裝不到 4 小時
授權條款
Apache-2.0
組裝指南
1. SO101 手臂組裝
組裝兩支 SO101 機器手臂
1.1 組裝 SO101 手臂
依照 huggingface.co/docs/lerobot/so101 上的說明,組裝 2x SO101 手臂
- 從 GitHub 或 MakerWorld(makerworld.com/en/models/1379312)上的 XLeRobot 硬體檔案下載並 3D 列印所有跟隨臂零件
- 使用 PLA+ 或 PLA Matte 線材,並採用 XLeRobot GitHub(hardware/README.md)中建議的切片設定,設定依印表機型號(Bambu Lab、Ender 等)而異
- 用斜口鉗或小螺絲起子移除每個列印件上的所有支撐材
- 用斜口鉗清除牽絲或粗糙邊緣,並打磨螺絲孔周圍,使配合順暢
- 依照 HuggingFace 上的 SO-101 從動臂組裝指南進行——每支手臂使用 6 顆 STS3215 伺服機(12V 版本)
- 依序組裝各關節:shoulder pan(關節 1)、shoulder lift(關節 2)、elbow flex(關節 3)、wrist flex(關節 4)、wrist roll(關節 5),最後是夾爪(關節 6)
- 用 M2x6mm 螺絲固定每顆馬達(每顆馬達 4 顆螺絲),馬達舵盤與結構連接則用 M3x6mm 螺絲
- 重複整個流程,製作第二支相同的跟隨臂,XLeRobot 總共需要 2 支跟隨臂
1.2 設定手臂馬達
為 SO101 手臂設定馬達
- 用 USB-C 將第一支手臂的馬達控制板(Waveshare Serial Bus Servo Driver)接到電腦
- 將電源供應器接到馬達控制板,只接 USB 無法為馬達供電
- 確認電路板上的跳線帽設在 B 通道(USB 模式)
- 確認手臂馬達已在 SO-101 組裝過程中設定為 ID 1 至 6
- 若馬達需要重新設定,請逐一連接每顆馬達,並使用 configure_motor.py 腳本或 bambot.org 上的 Bambot 工具
- 依序設定馬達 ID:1(shoulder pan)、2(shoulder lift)、3(elbow flex)、4(wrist flex)、5(wrist roll)、6(夾爪)
- 在第二支手臂自己的控制板上重複確認,兩支手臂在各自的電路板上都使用 ID 1-6
1.3 安裝手腕攝影機
在每支手臂上加裝手腕攝影機
- 從 SO-ARM100 儲存庫下載手腕攝影機座 STL(Optional/SO101_Wrist_Cam_Hex-Nut_Mount_32x32_UVC_Module)
- 用 PLA+ 列印攝影機座,這是小零件,很快就能印好
- 將攝影機座裝到跟隨臂靠近夾爪的手腕部位
- 將 USB 攝影機模組(32x32mm UVC 攝影機)裝入攝影機座並固定
- 沿手臂佈置 USB 攝影機線,用小束線帶或膠帶整理整齊,避免動作時勾到
- 為第二支手臂的手腕攝影機重複安裝步驟
1.4 貼上夾爪膠帶
在手指上纏繞 3M 夾爪膠帶
- 剪下一小條 3M 夾爪膠帶,貼合每根夾爪手指
- 貼膠帶前,先用異丙醇清潔夾爪手指表面
- 將膠帶用力壓貼在兩根夾爪手指的內側面,以達到最佳黏著
- 夾爪膠帶能大幅改善抓取光滑物體的能力,此步驟為選配,但強烈建議用於實際任務
2. 馬達設定
為所有伺服馬達設定馬達 ID
2.1 將馬達接到控制板
將馬達逐一接到控制板
- 將所有馬達從控制板上拔下,之後要一次一顆設定其他馬達
- 用隨附的線材將一顆尚未設定的 STS3215 馬達接到馬達控制板
- 用 USB-C 資料線將馬達控制板接到電腦
- 確認 USB 資料線與電源供應器都已連接,只接 USB 無法為馬達供電
- 在 Linux 上,你可能需要授予序列埠存取權限:sudo chmod 666 /dev/ttyACM0
2.2 開啟設定頁面
使用 bambot.org/feetech.js 進行設定
- 開啟網頁瀏覽器並前往 bambot.org/feetech.js,這是 Bambot 馬達設定工具
- 點選連線按鈕,並選擇對應你的馬達控制板的序列埠
- 頁面應會偵測到並顯示已連接的伺服馬達及其目前的 ID
- 若找不到馬達,請確認電源與 USB 都已連接,然後重新整理頁面再試一次
- 替代做法:若偏好命令列設定,可以使用 LeRobot 的 configure_motor.py 腳本
2.3 重新命名馬達 ID
依說明設定馬達 ID
- 頭部馬達會與一支 SO-101 手臂共用 Board 1(L-board),手臂馬達 1-6 已設定好
- 單獨連接第一顆頭部馬達並將其 ID 設為 7,這將是頭部水平旋轉馬達
- 拔下馬達 7,連接第二顆頭部馬達並將其 ID 設為 8,這將是頭部俯仰馬達
- 底盤輪馬達會與第二支手臂共用 Board 2(R-board),手臂馬達 1-6 已設定好
- 逐一連接每顆輪子馬達,將三顆全向輪馬達的 ID 分別設為 7、8、9
2.4 設定頭部與底座馬達
頭部馬達:7,8;底座馬達:7,8,9
- 將 Board 1(L-board)連同其所有串接的馬達一起連接:6 顆手臂馬達加上 2 顆頭部馬達
- 掃描馬達,Board 1 應顯示總共 8 顆馬達(手臂為 ID 1-6,頭部為 7-8)
- 將 Board 2(R-board)連同其所有馬達一起連接:6 顆手臂馬達加上 3 顆底盤輪馬達
- 掃描馬達,Board 2 應顯示總共 9 顆馬達(手臂為 ID 1-6,底盤為 7-9)
- 若有馬達顯示錯誤的 ID,請拔下其他所有馬達,單獨重新設定有問題的馬達
2.5 標示馬達
在馬達上標記 ID(L1-L8、R1-R9)
- 用油性筆在每顆馬達本體上寫下馬達 ID,方便辨識
- 將 Board 1 的馬達標示為 L1 至 L8(L1-L6 為左臂,L7-L8 為頭部)
- 將 Board 2 的馬達標示為 R1 至 R9(R1-R6 為右臂,R7-R9 為底盤輪子)
- 在控制板本身標上 L-board 與 R-board,以便配線時區分
- 這些標示能避免配線階段的混淆,也讓之後的故障排除更簡單
3. IKEA 推車組裝
組裝 IKEA RASKOG 多用途推車底座
3.1 組裝 IKEA 推車
依照隨附的 IKEA 說明書組裝
- 拆開 IKEA RASKOG 推車的包裝,攤開所有隨附零件與五金
- 依照隨附的 IKEA 組裝說明書組裝,XLeRobot GitHub 儲存庫中也有 PDF 版本(others/Manuals_raskog_utility_cart.pdf)
- 組裝全部三層層板,並裝上四個萬向輪
- 推車有三個功能層:底層(放 LeKiwi 輪式底盤)、中層(放電池)與頂層(放手臂與電子元件)
- 繼續之前,確認推車四個輪子都能自由滾動,且所有層板都已牢固裝好
4. 輪座組裝
安裝全向輪與 LeKiwi 底座零件
4.1 選擇底板
選擇正確的板子
- 從你列印的 XLeRobot 零件中找出 3D 列印的 LeKiwi 底盤板
- 找出正確的底板,它是較大、較薄、用來安裝全向輪的那塊板
- 不要與上板混淆,用錯板子會造成與 IKEA 推車的安裝問題
- 確認板上有三個呈三角形排列、用於安裝全向輪馬達連接件的位置
4.2 安裝全向輪
每個車輪以 3x M4 螺絲安裝
- 用 M4x10 螺絲將 3 個全向輪連接件裝到底板上(每個連接件 3 顆螺絲)
- 將每顆 STS3215 馬達(ID R7、R8、R9)裝入各自的輪子連接件支架
- 將 4 吋全向輪壓入馬達軸,確認完全就位
- 依照 LeKiwi 組裝指南中的馬達 ID 示意圖擺放輪子,方向會影響行駛是否正確
- 確認每個輪子都能自由轉動,不會摩擦到底盤板或連接件支架
4.3 準備加長電線
在為輪式底座配線之前,先準備加長的馬達纜線。需要這些較長的纜線,才能從推車底部的車輪馬達一路走線到頂部的馬達控制板。
- 若沒有現成的長線材,請用 JST XH 接頭套件製作延長的 5264 馬達線
- 將導線剪成所需長度,從馬達控制板的位置量到組裝後機器人中每顆馬達的位置
- 小心剝除導線末端(約 3mm),再用壓接工具在每條導線上壓接 JST XH 接頭
- 重要:密切注意導線極性,壓接前先標出正負極導線,避免接反
- 5264 導線極性接反會造成馬達錯誤,並可能損壞馬達控制板
- 接到任何馬達之前,用三用電錶測試每條完成的線材,確認導通與腳位對應正確
4.4 馬達配線
依 LeKiwi 教學為馬達配線
- 將每條輪子馬達線接到 5264 延長線,先不要直接接到控制板
- 使用 4ft 5264 延長線套件,提供足夠的線長,以便佈線通過整個推車高度
- 重要:連接時仔細確認導線極性,極性接反會造成馬達錯誤或損壞控制板
- 若使用接頭套件(美國買不到現成的長線材),請仔細壓接接頭,並用三用電錶確認
- 延長的馬達線先自然垂放,之後的步驟會將它們佈線穿過推車
4.5 安裝上板
安裝附接頭的上板
- 將 3D 列印的上板放到組裝好的輪式底盤上,對齊所有安裝孔
- 用合適的 M3 螺絲將上板固定到底盤組件上
- 確認板子平放,不會干擾下方全向輪的轉動
4.6 安裝 LeKiwi 底座
將底座安裝到推車底部
- 將 3 個輪子連接件裝到上板上,它們會將 LeKiwi 底盤固定到 IKEA 推車底部
- 將 IKEA 推車翻面,方便組裝
- 將附連接件的 LeKiwi 底盤試裝到推車下方,確認它能提供足夠的輪子壓力
- LeKiwi 全向輪著地時,IKEA 推車的四個萬向輪仍必須全部接觸地面
- 若推車輪子離開地面,請在切片軟體中縮放 z 軸來調整連接件高度(x/y 保持不變),然後重新列印
- v0.4.0 的替代做法:列印間隔墊圈並裝入 IKEA 推車的輪子組件中,而不是重新列印連接件
- 用 12 顆 M3 螺絲將 LeKiwi 底盤固定到 IKEA 推車底部,螺絲應對準推車金屬網的孔
4.7 裁切金屬網
裁出纜線走線用的孔
- 用尖嘴鉗或斜口鉗剪掉 IKEA 推車底層金屬網的部分區域,用於佈線
- 每個穿線點只剪掉中央的 X 形部分,保留周圍的網格以維持結構完整
- 在馬達線需要從下方輪式底盤穿入推車內部的位置開孔
- 用銼刀修整或用膠帶包覆任何尖銳的金屬邊緣,避免運作時損傷線材
4.8 纜線走線
將纜線穿過推車
- 將先前延長的輪子馬達線從下方穿過剪開的網孔往上拉
- 盡可能沿推車框架佈線,保持整齊且不礙事
- 在上端保留足夠的線材餘長,以便最後接到馬達控制板(R-board)
- 用束線帶或膠帶暫時固定線材,避免干擾下方輪子轉動
5. 手臂底座與頭部組裝
安裝頂部底座與頭部機構
5.1 安裝上底座
組裝上底座結構並放到 IKEA 推車上。先不要夾緊固定,等所有配線與電子元件都裝好後再固定。
- 3D 列印手臂底座組件,這是放在 IKEA 推車上方、承載兩支手臂與頭部的結構
- 手臂底座連接兩個 SO-101 手臂安裝位置,中間有一個收納線材與電子元件的儲物殼
- 將底座翻面組裝,方便處理安裝螺絲與走線槽
- 確認底座緊密地裝在 IKEA 推車的頂層層板上,應能牢固夾住推車邊緣
5.2 組裝頭部
組裝頭部的水平旋轉/俯仰機構,並裝上你選擇的攝影機。
頭部攝影機選項: Logitech C920 Webcam(約 $66):基本的單一 RGB 相機。適合以有限預算入門。 Intel RealSense D415(約 $272):RGBD 深度攝影機。建議用於進階感知與空間感知任務。
兩款攝影機都裝在同一個頭部支架上。3D 模型顯示的是 RealSense D415 的配置。請依預算與用途選擇;之後隨時可以升級。
- 頭部使用與 SO-101 手臂前兩個關節相同的關節設計,構成 2 自由度的水平旋轉/俯仰機構
- 將馬達 L7(頭部水平旋轉)裝入頭部底座支架,並以 4x M2x6mm 螺絲固定
- 將馬達舵盤裝到馬達 L7 上,並以一顆 M3x6mm 舵盤螺絲固定
- 將馬達 L8(頭部俯仰)裝到俯仰支架上,並以 4x M2x6mm 螺絲固定
- 為你選用的頭部攝影機裝上攝影機連接件,從硬體檔案中列印正確的版本(選項:Logitech C920、RealSense D415 或平價 USB 攝影機)
- 頭殼採用中空頸部設計,方便佈線,同時節省線材
6. 電子元件與配線
安裝 Raspberry Pi,連接所有馬達與資料纜線,並設定電源
6.1 安裝 Raspberry Pi
在接上資料線與電源線之前,先燒錄並安裝 Raspberry Pi
- 將燒錄好的 microSD 卡插入 Raspberry Pi 5,請用 Raspberry Pi Imager 燒錄 Raspberry Pi OS(桌面版)
- 將 Raspberry Pi 放入其外殼,或放到頂部底座殼上的安裝位置;先不要接線,接線在後續步驟進行
- 完成初始設定:國家、時區、WiFi 網路連線
- 透過 raspi-config(Interface Options > SSH)啟用 SSH,以便遠端存取
- 透過 raspi-config(Interface Options > VNC)啟用 VNC,以便遠端桌面存取
- 安裝系統相依套件:sudo apt update && sudo apt upgrade -y && sudo apt install -y python3-pip git curl wget
6.2 裁切網子以便纜線走線
在上層裁孔
- 與底層相同,用尖嘴鉗在推車上面兩層層板上再剪出網孔
- 在線材需要穿過推車中層與頂層之間的位置剪開
- 選擇能讓線材走得整齊、同時盡量減少從外部看到線材的位置
- 只剪掉線材穿過所需的最小網格面積,以維持結構完整
6.3 將 LeKiwi 連接到手臂
將底座連接到其中一支手臂
- 將 LeKiwi 輪式底盤延長的 5264 馬達線接到 Board 2(R-board)
- 這塊板同時控制輪式底盤馬達(ID R7-R9)與一支 SO-101 跟隨臂(ID R1-R6)
- 沿推車框架將線材從底層整齊地佈到頂層層板上的電子區
- 確認所有馬達線連接都牢固,接頭卡扣都已完全扣上
6.4 連接資料線
USB-C 到 Pi 的連接
- 從每塊馬達控制板拉 USB-C 轉 USB-A 資料線接到 Raspberry Pi
- Board 1(L-board)接到 Pi 的一個 USB-A 連接埠,這塊板控制一支手臂與頭部
- Board 2(R-board)接到 Pi 的另一個 USB-A 連接埠,這塊板控制另一支手臂與輪式底盤
- 這樣 Raspberry Pi 還剩 2 個 USB-A 連接埠可供攝影機使用(手腕攝影機,以及透過 USB 集線器連接的頭部攝影機)
6.5 放置電池
將電池放在中層/下層
- 將 Anker SOLIX C300 行動電源站放在 IKEA 推車的中層或下層層板上
- 為了安全運作,電池要直立放置,不要側放
- 將電池(2.8 kg)放在實際可行的最低層板上,讓重心保持在低處
- 電池底部有防滑橡膠,可避免機器人正常運作時滑動
- 確認電池上的三個電源線連接埠都不需移動電池就能插拔
6.6 連接電源線
連接所有電源線
- 安全:電源線一定要最後連接;插拔任何其他線材之前,先切斷電源
- 從每塊馬達控制板拉 2x USB-C 轉 DC(12V)線,接到 Anker SOLIX C300 行動電源站
- 從 Raspberry Pi 拉 1x USB-C 轉 USB-C 線,接到 Anker 行動電源站
- 使用 Anker 上的快充連接埠,每個連接埠最高提供 100W,足以讓 12V 馬達運作
- 確認三條電源線都已牢固連接,且在最終組裝完成前,行動電源站保持關閉
6.7 通電並確認
打開行動電源站,確認所有電子元件都有供電
- 通電前確認所有資料線與電源線都已牢固連接
- 開啟 Anker SOLIX C300 行動電源站
- 確認兩塊馬達控制板都有供電,其指示 LED 應會亮起
- 確認 Raspberry Pi 已通電並開始開機(注意綠色的活動 LED)
- 若有任何元件沒有通電,請立即斷開行動電源站,並檢查所有線材連接
7. 最終組裝
完成機器人組裝與驗證
7.1 完整配線檢查
確認所有連接
- 從起點到終點追蹤每條線材,確認沒有鬆脫或只插一半的連接
- 確認兩塊馬達控制板上的跳線帽都設在 USB/B 通道
- 確認 Board 1(L-board)連接了 8 條馬達線:6 顆手臂馬達(L1-L6)加上 2 顆頭部馬達(L7-L8)
- 確認 Board 2(R-board)連接了 9 條馬達線:6 顆手臂馬達(R1-R6)加上 3 顆底盤馬達(R7-R9)
- 確認沒有任何線材被夾住、拉緊或摩擦到活動部件(輪子、關節、夾爪)
- 確認電源線方便取用,以便緊急時快速斷電
7.2 夾緊上底座
將頂部底座固定到推車上
- 此步驟之前應完成所有電子元件與配線,夾緊之後就很難再修改配線
- 小心地將 3D 列印的頂部底座組件裝入 IKEA 推車的頂層層板
- 將推車邊緣壓入外殼插槽時,小心不要壓壞 3D 列印的外殼
- 確認底座穩固,移動推車時不會晃動或移位
7.3 擺放手臂底座
將手臂放在各角落
- 將兩支 SO-101 跟隨臂放在推車頂層層板前方的兩個角落
- 用桌夾將每支手臂底座固定到推車邊緣,用力鎖緊但不要讓層板彎曲
- 確認兩支手臂都能完整活動,不會互相碰撞或撞到推車框架
- 警告:機器人完全組裝好之後,絕對不要像推車一樣推著走,這會損壞馬達齒輪。要移動位置時,一定要抬起機器人(約 12 kg)
7.4 加上結構支撐
選配:加上線軸支架
- 可選擇在中間的儲物殼內放入一個用完的線材捲軸(紙管),作為額外的結構補強
- 在馬達控制板與第一個關節上裝上選配的保護殼,提供更好的保護並讓外觀更整潔
- 將手臂外殼套過第二個關節之前,可能需要暫時拆下手腕攝影機
- 可選擇在手臂線材外套上運動護套,隱藏配線,讓 XLeRobot 外觀更精緻
7.5 最終確認
檢查所有功能正常
- 開啟 Anker 行動電源站,確認 Raspberry Pi 成功開機
- 以 SSH 登入 Pi 並執行:lerobot-find-port,確認兩塊馬達控制板都在各自的 USB 連接埠上被偵測到
- 執行馬達掃描,確認全部 17 顆馬達都正確回應(L-board 上 8 顆,R-board 上 9 顆)
- 依照 LeRobot 文件中的校正程序校正每支跟隨臂:將每個關節移到其中點並確認,然後走完整個活動範圍
- 以 LeKiwi 機器人設定校正整個 XLeRobot 系統,確切的校正指令與適用你配置的參數請參考 LeRobot 文件
- 用鍵盤控制腳本(xlerobot_teleop_keyboard.py)測試基本的遠端操作,確認手臂、頭部與底盤都有回應
- 用手輕輕移動各關節測試每支手臂,通電的馬達應提供平順的阻力
- 確認所有攝影機都被偵測到並正在串流:手腕攝影機直接接 USB,頭部攝影機透過 USB 集線器