MABEL 組裝指南
開源 56 自由度移動式雙臂機器人,以 Vision Pro 進行全身遠端操作
授權條款
- software: Apache 2.0
- hardware design files (CAD, PCB): CERN-OHL-S 2.0 (strongly reciprocal)
- documentation and media: CC BY 4.0
分開授權。軟體採用 Apache-2.0;硬體設計檔案(CAD、PCB)採用 CERN-OHL-S-2.0,這是一種強互惠的開源硬體授權,要求修改後的設計以相同條款分享;文件與媒體採用 CC BY 4.0。原專案元件各自保有其授權,列於 THIRD_PARTY_NOTICES.md:手臂衍生自 OpenArm,機器手衍生自 ORCA Hand。查核日期:2026 年 11 月 4 日。
組裝指南
1. 開始之前
MABEL 由哪些零件構成,以及哪些零件是外購、自製或取自其他開源專案。
1.1 了解你要組裝的是什麼
MABEL 結合了外購模組、兩個開源子組件,以及少量自有的客製零件。
- MABEL 是一台移動式雙臂機器人:三模組舵輪底盤、垂直升降機構、可俯仰的軀幹、配備立體相機的 3 自由度頭部、兩支 7 自由度手臂,以及兩隻 17 自由度的手。
- 手臂源自 OpenArm,手部源自 ORCA Hand;兩者都依照各自專案發布的方式製作。
- 舵輪模組(REV MAXSwerve)與升降機構(升降桌立柱)為市售零件。
- MABEL 自有的零件包括七片鈑金板、列印的外蓋與安裝座、鋁擠型,以及一片客製 PCB,也就是底盤載板。
1.2 選擇你的組裝等級
除了五項選擇之外,每種組裝的其他部分都相同。
- 先訂購核心零件:原專案的 Build Guide 在第 1 到 8 節列出這些零件,在 Essential、Recommended 與 Maximum 三種配置中都相同。
- 接著完成第 9 節的五項選擇:機載運算單元、兩台手腕相機、頭部相機、選配的底盤深度相機,以及 2D 光達。
- 原專案建議的選擇是 Orin NX 16 GB、MMlove 1200P 手腕相機、MMlove 立體頭部相機、不裝底盤深度相機,以及 RPLIDAR C1。
- 三種參考配置只在這五項選擇上有所不同;目前價格請見本專案的零件清單。
2. 訂購零件
核心零件清單,以及每個零件的來源。
2.1 訂購核心零件
原專案附成本的清單是唯一依據;每一行都附有供應商連結。
- 請使用本專案的零件清單,它是根據原專案的 core.csv 建立的,原專案將該檔案視為物料清單的唯一依據。
- 大部分致動器、OpenArm 結構件組、手臂線束與手部伺服機都在淘寶購買;舵輪模組向 REV 購買,升降立柱向 FlexiSpot 購買,鋁擠型向 McMaster-Carr 購買。
- 請查看零件清單上的未決項目:原專案註記了尚未估算成本的零件,例如運費、線材以及載板的元件。
3. 製作 MABEL 的客製零件
鈑金板件、列印零件與鋁擠型裁切。
3.1 取得 CAD
所有客製零件都來自同一個完整機器人的 STEP 組合檔。
- 解壓縮 hardware/cad/MABEL_full_assembly.step.zip,並在任一 CAD 工具中開啟 STEP,例如 FreeCAD、Onshape、Fusion 或 SolidWorks。
- 整台機器人各連桿的網格也放在 simulation/mabel_mujoco/assets/meshes 中,但製作零件時請以 STEP 為準。
3.2 製作鈑金板
共七片板,以 5052 H32 鋁、2.0 mm(0.080 in)報價。
- 將每片板的 DXF 或 STEP 上傳到線上鈑金加工服務,材質 5052 H32 鋁,厚度 2.0 mm。
- 底盤鈑金,下層:僅雷射切割。
- 底盤鈑金,上層:4 道折彎、壓凹成形、壓入五金件與攻牙。
- 升降機構到軀幹的轉接板:2 道折彎、壓凹成形、壓入五金件與攻牙。
- 軀幹輸出板:1 道折彎、壓入五金件與攻牙。
- 機身底板:2 道折彎、壓入五金件與攻牙。
- 頸部安裝板:僅 2 道折彎。
- 手臂安裝板(兩片):壓入五金件與攻牙。
- 壓入五金件是指在加工廠壓入 PEM 螺帽或支柱,攻牙是指在加工廠切出螺紋孔,而不是在你自己的工作台上進行。
3.3 列印列印件並裁切型材
外蓋、感測器座與飾條為列印件;機架使用 2x2 in 與 2x4 in 型材。
- 依 STEP 以 1.75 mm 線材列印外蓋、感測器安裝座與飾板(Build Guide 第 8 節)。
- 依 Build Guide 項目 6.01 中的長度切割鋁擠型,原專案列出這些長度時沒有標示單位:2x2 in 型材 15(2)、17(2)、4.75(3)與 8(2);2x4 in 型材 10(1)與 12.5(2)。
- 用項目 6.02 與 6.03 中的 1010 系列角座與斜角連接板組合框架。
4. 組裝子組件
手臂、手部、舵輪模組與升降機構,各自依其製作者公開的方式組裝。
4.1 組裝兩支手臂
手臂衍生自 OpenArm,依 OpenArm 公布的方式組裝。
- 依照本站的 OpenArm 指南製作兩支 7 自由度手臂,該指南依循 OpenArm 自己的硬體文件。
- MABEL 的手臂韌體讓每支手臂各自使用一條 CAN 匯流排,搭配 OpenArm 的馬達組合:關節 1 與 2 使用 DM8009,關節 3 與 4 使用 DM4340,關節 5 到 7 使用 DM4310。
- 首次使用前,請在原廠工具中檢查每顆 DaMiao 馬達的 p_max、v_max 與 t_max;原專案提醒,設定不一致會在不知不覺中改變線路上每個數值的比例。
4.2 組裝兩隻機器手
機器手衍生自 ORCA,使用 Feetech 伺服機。
- 依照本站的 ORCA Hand 指南製作兩隻手,採用其 Feetech 版本:MABEL 的手使用 Feetech HL3915M 與 HL3930M 伺服機,每隻手 17 顆(16 顆用於手指,1 顆用於手腕)。
- 每隻手需要一片匯流排伺服機驅動板與一片電源分配板(Build Guide 項目 4.03 與 4.04)。
- 新組裝好的手在啟用扭矩前,要先讓肌腱就位並完成校正:每個指令都會被限制在校正後的範圍內。
4.3 組裝舵輪模組並裝上升降機構
兩者都是市售零件。
- 依照 REV 的文件組裝三個 REV MAXSwerve 模組(REV-21-3005)。
- 裝上 FlexiSpot E7 Pro 升降立柱(CBR4830MD-E7WS);MABEL 以 Raspberry Pi Pico 經由 BTS7960 H 橋驅動立柱的直流馬達,並讀取其正交編碼器。
- 將三個模組分別裝在右前、左前與後方中央:底盤韌體依此順序分配它們的 CAN ID。
5. 製作底座載板
唯一的客製 PCB:驅動舵輪底座的 Teensy 4.1 載板。
5.1 訂購並組裝電路板
一片 2 層板,具備三條 CAN 匯流排、乙太網路、24 V 輸出與一顆 IMU。
- 將 electrical/Motherboard/fab 壓縮成 zip,上傳到任何 2 層 PCB 打樣服務;疊構資訊在 fab/Motherboard-job.gbrjob 中。
- 依照 electrical/exports/Motherboard_schematic.pdf 中的電路圖採購元件。
- 這片板子為每個舵輪模組提供一條 CAN 匯流排、連到機器人電腦的乙太網路、三個 XT30 的 24 V 輸出,以及一顆 BNO085 IMU。
- 原專案回報已完成打樣並在工作台上驗證:燒錄、乙太網路與全部三條 CAN 匯流排。
6. 燒錄韌體並啟用各匯流排
兩片 Teensy 4.1 板、一片負責升降機構的 Raspberry Pi Pico,以及手部的伺服機匯流排。
6.1 燒錄舵輪底座
底座的 Teensy 以 1 Mbit/s 驅動 REV SPARK 控制器。
- 在 firmware/swerve_drive 中執行 pio run -e teensy41 -t upload。
- 執行 ./setup_can.sh,以 1 Mbit/s 啟用 can0。
- 執行 scripts/verify_can_motors.py,確認六台 SPARK 控制器全部有回應:奇數 ID 負責驅動,偶數 ID 負責轉向。
6.2 燒錄手臂、軀幹與頸部
一片 Teensy 依其 SD 卡上的設定檔,驅動兩支手臂、軀幹與頸部。
- 將 config/robot.json 複製到 Teensy 的 SD 卡,並依你的網路設定 net.ip。
- 在 firmware/openarm_dual 中執行 pio run -e teensy41 -t upload;若第一次上傳失敗,再重試一次,但成功後絕不要再上傳。
- 以 115200 鮑開啟序列埠監視器:它會列出每個致動器,無論是否在線。
- 在主機上用 DaMiao USB-CAN 轉接器搭配 scripts/dm_configurator.py 設定馬達 ID;同一條匯流排上的 ID 必須各不相同。
- 頸部的 Dynamixel 匯流排是 5 V 邏輯,而 Teensy 的接腳不耐受 5 V,因此請使用電位轉換器。
6.3 燒錄升降控制器
升降機構在 Raspberry Pi Pico 上執行 MicroPython。
- 執行 pip install mpremote,然後執行 firmware/lift/tools/deploy.sh。
- 執行一次 calibrate,讓升降機構找到最低點與最高點;若立柱在斷電時被手動移動過,請重新執行 home。
6.4 檢查機器手與 CAN 匯流排
機器手不需要燒錄。
- 執行 firmware/orca_hand/feetech/scripts/scan.py,檢查每隻手上的伺服機 ID 1 到 17。
- 執行 firmware/can_up.sh --ping,啟用 SocketCAN 並 ping DaMiao 馬達。
7. 初步測試與校正
安全地測試每個子系統,然後進行校正。
7.1 安全地測試底座
原專案針對舵輪底座的首次開動規則。
- 進行最初的測試時,請將輪子架離地面。
- 在地面上行駛之前,先執行一次 scripts/set_drive_limits.py,將驅動輸出上限寫入快閃記憶體。
- 第一次實際行駛前,在 swerve_teleop.py 開頭設定 STEER_OFFSET、DRIVE_SIGN、WHEEL_RADIUS 與 DRIVE_GEAR_RATIO。
- 同一時間只能有一個程式對匯流排下指令:在機器人上使用這些工具前,請先停止機器人軟體。
7.2 校正馬達與機器手
編碼器範圍、關節方向與重力補償都儲存在同一個校正檔中。
- 用 pip install -r calibration/requirements.txt 安裝校正工具。
- 執行 calibration/motor_calibration/hardware/scan.sh,在不通電驅動馬達的情況下列出馬達。
- 用 run_hardware.sh 辨識每顆馬達的摩擦與慣量,過程中遠離轉軸,並將一隻手放在緊急停止開關上。
- 執行每隻手的極限掃描:python3 -m mabel_hw.drivers.orcahand.calibrate --model left,然後是 right。
7.3 啟動整台機器人
先建置一次 ROS 2 工作區,之後用一個腳本啟動所有東西。
- 在機器人電腦上執行一次 ros/dev_up.sh,建置 ROS 2 Jazzy 工作區。
- 從儲存庫根目錄執行 bash server/real_run.sh,然後開啟 8094 埠上的 Control Center,或連接 Vision Pro 應用程式。
- 手臂啟動時是無力狀態;操作者需明確啟用扭矩。啟用扭矩前,先確認緊急停止開關的位置。
- 停止主機前先扶住手臂:只要 250 ms 內沒有收到主機封包,所有手臂馬達都會停用。
- 底盤的每個移動都會經過防傾倒檢查,依升降高度限制速度。