Open Source Robotics

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

OpenArm 組裝指南

用於接觸密集環境實體 AI 研究的 7 自由度人形手臂

授權條款

  • hardware (openarm_hardware: CAD, STL, bill of materials): CERN-OHL-S 2.0 (strongly reciprocal)
  • software and documents: Apache 2.0

依部分授權。硬體(openarm_hardware:CAD、STL 與物料清單)採用 CERN-OHL-S-2.0,這是一種強互惠授權。軟體與文件,包括 openarm_can、openarm_ros2 與 openarm_description,採用 Apache-2.0。查核日期:2026 年 11 月 2 日。

組裝指南

1. 開始之前

取得 2.0 檔案,並在任何馬達裝進手臂之前設定每顆馬達的 ID。Enactic 的步驟是針對 OpenArm 1.0;2.0 的手臂結構、馬達與電子元件都相同,改變的是夾爪與 J5 支架。

1.1 取得 CAD 檔案與零件清單

從 Enactic 下載 OpenArm 2.0 的 CAD 資料與 BOM。

  1. 開啟 Enactic 的 OpenArm 2.0 Drive 資料夾(可從 docs.openarm.dev 的 OpenArm 2.0 > General > 3DCAD and BOM 連結進入),下載 3D CAD 資料與「OpenArm 2.0 BOM.xlsx」。
  2. 依型號向 MiSUMi meviy 訂購機加工件,並依 CAD 資料列印 3D 列印件。
  3. 若你已經有 OpenArm 1.0,Enactic 的「Upgrade from 1.0」頁面只列出你需要的零件:2.0 夾爪、J5_A_rotate90,以及 2.0 的 J3-J4 外蓋與 J4 線材固定座。
  4. Enactic 在該 Drive 資料夾中的 README 表示,公布的 CAD 以簡化模型呈現市售零件,因此外購零件的確切幾何請以物料清單及製造商自己的 CAD 為準。該資料夾中還有一個 Options 資料夾,內含頭部相機版本的組件。

1.2 設定馬達 ID

每顆馬達在組裝前都需要設定 CAN ID 與 master ID。

  1. 在 Windows 電腦上安裝 Damiao Debugging Tool,並透過 Damiao USB CAN 除錯器連接每顆馬達。此工具以序列埠(UART)921600 bps 與馬達通訊,而不是透過 CAN。
  2. 各關節馬達:J1 與 J2 為 DM-J8009P-2EC,J3 為 DM-J4340P-2EC,J4 為 DM-J4340-2EC,J5 至 J8 為 DM-J4310-2EC V1.1。
  3. 依關節設定 ID:J1 0x01/0x11、J2 0x02/0x12、J3 0x03/0x13、J4 0x04/0x14、J5 0x05/0x15、J6 0x06/0x16、J7 0x07/0x17、J8(夾爪)0x08/0x18(CAN ID / master ID)。
  4. 按 ReadParam,輸入 CAN ID 與 master ID,再按 WriteParam 將它們存入馬達。
  5. 可選擇按 Calibrate 檢查馬達是否會轉。若它啟動了卻不轉,檢查電源是否提供足夠的電流。
  6. Enactic 在 24V 下校正與測試的建議電流表列出最低電流與建議電流:DM-J4310 約 0.25 A 與約 0.3 A;DM-J4340 約 0.25 A 與約 0.3 A;DM-J8009P 約 0.7 A 與約 0.75 A。電流會相加,因此在同一個電源上菊鏈串接的馬達需要其電流總和。

2. J1–J2 子組件

肩部:J1 與 J2 馬達,搭配零件 J1_A 至 J1_E。每支手臂各組裝一個。

2.1 將 J1 裝到 J1_A 上

  1. 用 5 顆 M4x10 螺栓將 J1 馬達的背面裝到 J1_A 上,保持電源與通訊埠可以接觸得到。這顆馬達必須是 ID 0x01、master ID 0x11。

2.2 裝上 J1_B

  1. 用 3 顆 M4x8 螺栓將 J1_B 裝到馬達上。機械擋塊朝向馬達的電源埠,並位於上方。
  2. 左臂的 J1_B 方向略有不同:J1 的 Power+CAN 埠朝前,機械擋塊朝向連接埠並位於上方。

2.3 裝上 J1_C

  1. 用 6 顆 M5x10 螺栓將 J1_C 裝到 J1 的轉子上。

2.4 安裝 J1_D 與 J1_E

  1. 用 2 顆 M4x10 螺栓將 J1_D 裝到 J1_C 上。
  2. 用 3 顆 M4x10 螺栓將 J1_E 裝到 J1_C 上。

2.5 安裝 J2 馬達

  1. 將 DM8009 J2 馬達插入 J1_D 與 J1_E 之間,連接埠朝向 J1,J2 背面朝向 J1_E。
  2. 用 2 顆 M4x8 螺栓將 J1_E 接到 J2,再用 3 顆 M4x8 螺栓將 J1_D 接到 J2。

3. J2–J3 子組件

上臂支架:J2_A、J2_B 與 J2_C。

3.1 接合 J2_A 與 J2_B

  1. 用 2 顆 M4x10 螺栓將 J2_A 裝到 J2_B 上。

3.2 安裝 J2_C

  1. 將 J2_C 放到 J2_A 與 J2_B 上,讓孔對齊。
  2. 用 4 顆 M4x6 螺栓將 J2_C 鎖到 J2_A,再用 4 顆 M4x6 螺栓鎖到 J2_B。

4. J3–J4 子組件

肘部:J3 與 J4 馬達,搭配 J4_A、J4_B 與第一根圓柱。

4.1 將 J4_A 裝到 J3 上

  1. 用 6 顆 M3x6 螺栓將 J4_A 裝到 J3 馬達上。兩個 Power+CAN 埠分別朝前與朝後,J3 的通訊埠在右側。

4.2 將軸承裝到 J4_B

  1. 將 FL6803ZZ 軸承裝到 J4_B 上。
  2. 將 J4_B 放在 J4_A 內側,孔對齊;先不要鎖緊。

4.3 裝上 J4 馬達

  1. 將 J4 馬達滑入 J4_A 與 J4_B 之間,對準 J4_B 上的孔,用 4 顆 M3x6 螺栓將 J4 鎖到 J4_B。對照 Enactic 的圖片檢查 Power+CAN 埠的位置。

4.4 鎖緊 J4_A

  1. 用 6 顆 M3x6 螺栓將 J4_A 鎖到 J4_B,再用 6 顆 M3x6 螺栓將 J4_A 鎖到 J4 馬達。

4.5 裝上圓柱

  1. 將支柱 AETTS8-61-SC0-M3-N3 插入 J4_A 的兩片法蘭之間,用 2 顆 M3x6 螺栓固定。

5. J4–J5 子組件

前臂:J4_C、J4_D、J4_E 與 J5 馬達。

5.1 安裝 J4_C

  1. 用 6 顆 M3x6 螺栓將 J4_C 裝到 J4 馬達的轉子上。

5.2 安裝 J4_D 與 J4_E

  1. 將 J4_D 裝到 FL6803ZZ 軸承上。
  2. 將 J4_E 與 J4_C 上的機械擋塊垂直對齊,再用 6 顆 M3x6 螺栓將它裝到 J4_C 上。

5.3 安裝 J5 馬達

  1. 將 J5 馬達放在 J4_D 與 J4_E 之間,用 6 顆 M3x6 螺栓固定,Power+CAN 埠分別朝前與朝後,通訊埠朝向 J4_E。

5.4 安裝圓柱

  1. 在 J4_D 與 J4_E 之間放兩根支柱 AETTS8-74.2-SC0-M3-N3,用 M3x6 螺栓固定。

6. J5–J6–J7 子組件

手腕。在 OpenArm 2.0 中,J5 支架是 J5_A_rotate90(型號 MVTUP-ASN-4EW-3BJ7T-L),取代 1.0 的 J5_A。

6.1 準備側板

  1. 在鈑金件 J6_A 中裝一個 FL6700ZZ 軸承,並將一個 J7_B 輕輕插入軸承。
  2. 對 J6_B 重複此步驟。

6.2 裝上 J5 支架

  1. 用 6 支 M3x18 螺栓將 J5_A_rotate90 固定到 J5 馬達的轉子上。Enactic 的這個步驟是針對 1.0 的 J5_A(6 支 M3x18 螺栓)撰寫的,接下來兩個步驟也是沿用它針對 J5_A 的 1.0 說明;它並未針對 J5_A_rotate90 發布獨立的步驟,因此請對照 2.0 的 CAD 資料檢查配合與機械限位。其 2.0 物料清單列出兩支手臂共 12 支 M3x18 螺栓(CBE3-18)。

6.3 安裝 J6_B 與 J6_A

  1. 用 3 顆 M3x8 螺栓將 J6_B 裝到 J5 支架上,朝支架的機械擋塊方向對齊。
  2. 用 3 顆 M3x8 螺栓將 J6_A 裝到支架上。

6.4 準備 J6 馬達

  1. 用 4 顆 M3x6 螺栓將 J6_D 裝到 J6 馬達上,其上下兩端與兩個 Power+CAN 埠對齊。
  2. 用 6 顆 M3x6 螺栓將 J7_E 裝到 J6 的轉子上。

6.5 安裝 J6 馬達

  1. 將 J6 放在 J6_A 與 J6_B 之間,用 4 顆 M3x6 螺栓鎖到 J6_A。通訊埠應與 J7_E 對齊。
  2. 正面看向 J6_B 時,右臂的 J7_E 向右突出,左臂的則向左突出。

6.6 準備 J7 馬達

  1. 用 3 顆 M3x8 螺栓將 J7_A 裝到 J7 馬達上,最上方的螺栓與 Power+CAN 埠對齊。
  2. 用 2 顆 M3x8 螺栓將 J7_C 裝在 J7 背面,與兩個 Power+CAN 埠之間的連線平行。左臂的 J7_C 則裝在另一側。

6.7 安裝 J7 馬達

  1. 將 MR106ZZ1 軸承裝入 J7_D_right(左臂為 J7_D_left)的兩個孔中。
  2. 將 J7 放在 J6_A 與 J6_B 之間,每側用 2 顆 M3x8 螺栓將兩個 J7_B 裝到 J7_A 上。此時 J7_C 與 J7_E 應朝同一方向。

6.8 安裝 J7_D

  1. 用 DBSY4-6-5 段差螺栓將 J7_D 同時裝到 J7_C 與 J7_E 上,並在段差螺栓與 J7_D 之間,以及 J7_D 與 J7_C/J7_E 之間,放入 4 個 SWSPS12-6-0.5 墊圈。

6.9 封閉手腕

  1. 將 J6_C_right(左臂為 J6_C_left)插入 J6_A 與 J6_B 之間,用 3 顆 M3x6 螺栓固定。

7. 夾爪(OpenArm 2.0)

2.0 夾爪是一個精巧的末端執行器,附手內 Arducam B0495 攝影機,由 J8 馬達驅動。

7.1 組裝 2.0 夾爪

Enactic 尚未公開 2.0 夾爪的逐步組裝說明。

  1. 依 Enactic Drive 資料夾中的 2.0 CAD 資料,用零件清單中的末端執行器零件(MiSUMi meviy 零件、MiSUMi 五金、列印的手指與外蓋、相機及其線材)組裝夾爪。
  2. Enactic 的 OpenArm 2.0 > Gripper 頁面列出相機規格;其相機設定教學涵蓋 Linux 端的設定。

8. 最終組裝

將各子組件接合成一支完整的手臂。

8.1 將手肘接到肩部

  1. 用 6 顆 M3x15 螺栓將 J2–J3 子組件裝到 J3 馬達的轉子上。
  2. 用 6 顆 M5x10 螺栓將 J2_A 裝到 J2 馬達的轉子上。

8.2 安裝夾爪

  1. 將夾爪裝到 J7 馬達的轉子上。Enactic 的 1.0 指南是用 6 顆 M3x15 螺栓穿過 1.0 夾爪的 J8_A 來固定;2.0 夾爪的固定方式尚未公開。

8.3 安裝手臂

  1. 用 4 顆 M6x12 螺栓穿過 J1_A,鎖入已插入鋁擠型中的 T 型槽螺帽,將每支手臂裝到其支撐柱上,並讓 J1_A 頂部與鋁擠型頂部對齊。
  2. 兩顆 J1 馬達的 Power+CAN 埠都朝前。
  3. OpenArm 2.0 的支撐柱是裝在帶 M6 螺牙底板上的 MiSUMi 鋁框架;2.0 BOM 沒有列出它們,而 Enactic 的 1.0 底座指南描述的是 1.0 版本。
  4. Enactic 的 OpenArm 2.0 物料清單試算表只涵蓋手臂、末端執行器、頭部相機與相機整合。它沒有列出支柱、底板、T 型槽螺帽、纜線、集線板、電源供應器、緊急停止開關、USB 轉 CAN FD 轉換器或外殼螺絲。電氣零件請以 Enactic 1.0 的「Electronics」零件清單與「Procuring Components」頁面為公布來源,其 Upgrade 頁面表示 2.0 的電子部分與 1.0 相同。

9. 配線

連接馬達纜線。連接器很脆弱:請握住連接器本身,絕對不要拉扯電線。

9.1 檢查纜線

  1. 開始前,對照 Enactic 的配線拓撲確認每個連接器的腳位分配;J3–J4 與 J4–J7 的線是最棘手的。
  2. 向 LCSC 購買的 J4–J7 纜線,由於接頭有干涉問題,需要把接頭改成 L 形;Enactic 的「Components」頁面(J4+J5+J6+J7 to Hub Cable 的說明)示範了做法,使用模具(Enactic 提供其 3D 資料 cables_L-shapedMold.step 與 cables_L-shapedCase.step)和熱熔膠。該頁面上兩張 L 形接頭的圖片分別標示為 J3–J4 與 J4–J7。Enactic 表示,生產 OpenArm 成品的製造商所提供的纜線不會有這個問題。

9.2 J3–J4 配線

  1. 將 J3 連接器接到 J3 馬達,J4 連接器接到 J4 馬達,線沿上臂背面佈線。注意:J4 連接器離鈑金很近。

9.3 J4–J7 配線

  1. 從手臂背面接上 J5 連接器,將手肘彎到擋塊處並接上 J4,然後接上 J6 與 J7。J6 很難搆到:移動手臂找個好角度。
  2. 所有線都沿手臂背面佈線。

9.4 J7–J8 配線

  1. 將 J7–J8 線接到 J7 底面的連接器,再將另一端接到 J8。

9.5 J1–J2 配線

  1. 將 J1 與 J2 連接器插到各自的馬達上。J1 的線從腋下繞到背面,J2 的線向下彎。
  2. 小心插好 J1 與 J2 線上的白色小插頭;沒對準就卡不住。

10. 外殼與集線板

蓋上手臂外殼、裝上集線板,再蓋上胸部外殼。

10.1 封閉手臂外殼

  1. J1–J2:將 J2 的線穿過外殼,放入 J1-J2_B,蓋上並以 2 顆螺絲固定。
  2. J2–J3:將 J3-J4 的線穿過 J2-J3_B,將 J1-J2_A 的卡釘插入 J2 馬達的中心孔,向上滑動後以 2 顆螺絲固定。
  3. J3–J4:從前方裝上 J3-J4_A、從後方裝上 J3-J4_B,以 4 顆螺絲固定(2.0 使用 J3-J4_cover_v2.0 列印件)。
  4. J4–J5:將 J4-J7 的線佈到內側並放入 J4-J5_B 的內側槽,裝上後以 4 顆螺絲固定。
  5. J6–J7:這些零件分左右;裝上後以 3 顆螺絲固定。

10.2 安裝集線板

  1. 將 HNTP6-6 T 型槽螺帽插入每個肩部背面的槽中。
  2. 用內六角螺絲裝上集線板的背蓋與 PCB,CAN 連接器朝內,然後鎖緊。每支手臂的集線板各自獨立運作。

10.3 連接集線板

  1. 將 J1、J2 與 J3-J4 的馬達線、通訊線與延長線接到各集線板,對照 Enactic 的參考圖片檢查,然後整理好線。

10.4 封閉胸部

  1. 從前方裝上 Chest-cover_A、從後方裝上 Chest-cover_B,J2 與 J3-J4 的線穿過 Chest-cover_B 上的 U 形槽。
  2. 確認沒有任何通訊線或延長線被夾到,然後以 6 顆螺絲固定外蓋。

11. 電源與 CAN

為每支手臂供電,並將它連接到電腦。

11.1 經由緊急停止開關接上電源

  1. 每支手臂各配一個電源供應器。Enactic 的 1.0「Procuring Components」頁面列出一款輸出電壓 24V、輸出電流 15A 的電源供應器;其馬達頁面列出 DM-J4310-2EC V1.1 與 DM4340 系列的額定電壓為 24V,DM-J8009P-2EC 為 24V(支援 24–48V)。
  2. 將緊急停止開關放在觸手可及之處,並與手臂保持足夠距離。Enactic 的安全指南警告,OpenArm 的可回驅性很高:如果因緊急停止而斷電,手臂所握持的負載會迅速掉落。
  3. 將兩支手臂的電源都經過同一個緊急停止開關,並將緊急停止開關的兩條輸出線接到兩支手臂的集線板。
  4. 對於重負載,Enactic 建議每支手臂用兩個電源:一個給 J1 與 J2,一個給 J3 至 J8。

11.2 連接 CAN

  1. 將每個 USB 轉 CAN-FD 轉換器接到其手臂的集線板:紅線接 CANH,黑線接 CANL。
  2. Enactic 的主從設定將轉換器編號為 CAN 0 右主動臂、1 左主動臂、2 右從動臂、3 左從動臂。

12. 軟體設定

在 Ubuntu 22.04/24.04 或其他支援 SocketCAN 的 Linux 上啟用 CAN 介面、校正並測試。

12.1 安裝 OpenArm CAN 工具

  1. 加入 OpenArm PPA(ppa:openarm/main),並安裝 can-utils、iproute2、libopenarm-can-dev 與 openarm-can-utils。

12.2 設定 CAN 介面

  1. 用 'ip link show' 找到介面,然後進行設定。若使用 Enactic 建議的 5 Mbps CAN FD,執行 'openarm-can-cli -i can0 can_configure'(預設值為標稱 1000000 與資料 5000000);若使用 CAN 2.0,執行 'openarm-can-cli -i can0 can_configure --no-fd'。若要手動設定 CAN FD:先執行 'sudo ip link set can0 down',再執行 'sudo ip link set can0 type can bitrate 1000000 dbitrate 5000000 fd on',然後執行 'sudo ip link set can0 up'。若要手動設定 CAN 2.0,改用 'type can bitrate 1000000'。
  2. 若要一次設定 can0 到 can3,Enactic 的腳本在 CAN FD 下為 'openarm-can-configure-socketcan-4-arms -fd -b 1000000 -d 5000000',在 CAN 2.0 下為 'openarm-can-configure-socketcan-4-arms'。若四個介面中有任何一個不存在,腳本會報錯停止。
  3. 如果你安裝的是 openarm_can 1.2.8 或更舊的版本,指令則改為 'openarm-can-configure-socketcan can0 -fd -b 1000000 -d 5000000'(CAN 2.0 則為 'openarm-can-configure-socketcan can0'),與 Enactic 的 1.0 文件相同。1.2.9 版(2026 年 5 月 18 日)已將其移除。

12.3 測試一顆馬達

  1. 在一個終端機中執行「candump can0」,在另一個終端機中以「cansend can0 001#FFFFFFFFFFFFFFFC」啟用馬達 1。其 LED 會變綠,鮑率一致後會收到 ID 011 的回覆。
  2. 以「cansend can0 001#FFFFFFFFFFFFFFFD」再次停用它。

12.4 設定馬達鮑率

  1. 更改馬達的鮑率之前,先把 CAN 介面設為該馬達目前的鮑率;如果兩者不同,指令就無法送達馬達。('openarm-can-cli -i can0 discover' 會掃描匯流排並列出每個馬達的鮑率;之後請再執行一次 can_configure,因為 discover 會讓介面停留在最後掃描的速率。)接著設定馬達的鮑率,例如暫時設定用 'openarm-can-cli -i can0 change_baud -b 5000000 -c 1',要儲存則用 'openarm-can-cli -i can0 change_baud -b 5000000 -c 1 --save'。
  2. --save 旗標會寫入馬達的快閃記憶體,而快閃記憶體有約 10,000 次寫入循環的硬性上限。不要在腳本中執行或重複執行:超過上限會永久損壞馬達的快閃記憶體。
  3. 執行 --save 後,將馬達斷電再重新上電,然後把 CAN 介面設為新的鮑率,並確認馬達有回應:'candump can0' 會顯示回應的資料框,例如馬達 ID 1 會是 0x11。
  4. 如果你安裝的是 openarm_can 1.2.8 或更舊的版本,指令則改為 'openarm-can-change-baudrate --baudrate 5000000 --canid 1 --socketcan can0 --flash'(暫時設定時省略 --flash),而 Enactic 較舊的說明要求在變更時將 CAN 介面切到 CAN 2.0 模式,之後再設回目標鮑率。1.2.9 版(2026 年 5 月 18 日)已將其取代。

12.5 校正零點位置

校正開始時手臂會自動移動:請穿戴安全裝備、清空工作範圍,並隨時準備使用緊急停止。

  1. 將手臂大致擺成 Enactic 圖片中的零點姿勢(夾爪的零點是閉合狀態),然後一次一支手臂執行 'openarm-can-zero-position-calibration'。不加任何選項時,它會校正 can0 上 OpenArm 2.0 的右臂(預設為 '--robot-version v2';OpenArm 1.0 手臂請加上 '--robot-version v1')。若要指定特定手臂,請提供連接埠與側別,例如右側從手臂:'openarm-can-zero-position-calibration --canport can2 --arm-side right_arm'。Enactic 的其他範例為左側主手臂用 '--canport can1 --arm-side left_arm',左側從手臂用 '--canport can3 --arm-side left_arm'。這個選項的拼法是帶連字號的 --arm-side;Enactic 的 1.0 文件寫成底線,但腳本的選項清單中沒有那種拼法。
  2. 在主從式配置中,主手臂與從手臂要分別執行零點校正,校正時各自處於獨立狀態。
  3. 1.2.8 以前的版本只有 --canport 與 --arm-side 選項,沒有 --robot-version 選項。

12.6 檢查並執行示範程式

  1. 執行「openarm-can-cli -i can0 monitor」檢查與馬達的通訊(要指定特定馬達時加上「--id 1,2,3」,使用你的馬達 ID)。它會即時顯示每顆馬達的位置、速度、扭矩與溫度。Enactic 表示,執行 demo 之前要先讓這一步正常運作。若你安裝的是 openarm_can 1.2.8 或更舊的版本,檢查指令則是「openarm-can-motor-check 1 17 can0 -fd」(傳送 ID 與接收 ID 以十進位表示;17 即 0x11)。
  2. 執行展示之前,請確認已為所有馬達設定安全的零點位置、緊急停止開關隨時觸手可及、已將手臂活動範圍內的所有障礙物、工具與人員移開,並且知道如何快速切斷電源。Enactic 警告,若未做到這些,可能導致嚴重受傷或設備損壞。
  3. 接著執行 'openarm-can-demo'。預設展示會以 CAN FD 在 can0 上驅動馬達 0x01、0x02 與 0x07(DM4310);若是其他馬達配置,Enactic 表示要編輯 examples/demo.cpp(馬達類型、傳送 ID 與接收 ID,三個清單長度相同)並建置。展示程式會啟用馬達、執行位置與扭矩控制測試、若有設定夾爪則將其開合、顯示 10 個週期的馬達位置,最後再停用所有馬達。

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