OpenManipulator-X 組裝指南
ROBOTIS 模組化機器手臂,採用 DYNAMIXEL 伺服機,完整支援 ROS 2 與 MoveIt
授權條款
Apache-2.0
組裝指南
1. 開始之前
ROBOTIS 為組裝 OpenMANIPULATOR-X 公開了什麼,以及本指南能提供與無法提供的內容。
1.1 閱讀原專案公開的資料
OpenMANIPULATOR-X 以未組裝的零件出貨,ROBOTIS 以 PDF 手冊與影片公開其組裝方式,而不是文字步驟。
- ROBOTIS 以盒裝未組裝零件的形式供應 OpenMANIPULATOR-X(RM-X52-TNM)。
- 機構組裝方面,ROBOTIS 發布了一份名為 Assembly Manual for OpenMANIPULATOR-X 的 PDF 和一支組裝影片。它沒有以文字發布逐一關節的組裝步驟。
- 因此本指南不提供逐一關節的組裝步驟。請依照 PDF 手冊與影片組裝手臂,並用下一節的零件清單核對箱內物品。
- ROBOTIS 也在 Onshape 與 Thingiverse 上發布了零件的 3D CAD 檔案,供想修改或列印零件的人使用。
- 撰寫本指南時,PDF 手冊的下載連結傳回錯誤頁面而不是檔案,因此本指南無法閱讀手冊本身。組裝影片沒有口述解說,也無法逐步核對。
2. 零件與工具
ROBOTIS 提供的零件清單,供開始前清點包裝內容。
2.1 檢查機身零件
依 ROBOTIS 清單清點連桿框架、滑軌支架、掌部夾爪、連桿、凸緣襯套、曲柄臂、滑塊與 FR12 支架。
- LINK FRAME(LONG):1。
- LINK FRAME(SHORT):1。
- RAIL BRACKET(LEFT):1。
- RAIL BRACKET(RIGHT):1。
- PALM GRIPPER:2。
- LINK ROD:2。
- FLANGE BUSH:4。
- CRANK ARM:1。
- RAIL BLOCK:2。
- FR12-S101-K:1。FR12-S102-K:2。FR12-H101-K:2。FR12-H104-K:1。
2.2 檢查致動器與纜線
依 ROBOTIS 清單清點五顆 XM430-W350-T 致動器與 CABLE-X3P 纜線。
- XM430-W350-T:5。
- CABLE-X3P-100:1。
- CABLE-X3P-180:2。
- CABLE-X3P-240:2。
2.3 檢查螺絲、螺帽、惰輪與軸承
清點 Miscellaneous 下所列的扣件與惰輪零件。
- X-SP:24。
- NUT-M2.5:16。NUT-M3:4。
- FHS-M2.5x14:12。
- WB-M2x3:38。WB-M2x4:4。
- WB-M2.5x4:4。WB-M2.5x6:8。WB-M2.5x8:16。WB-M2.5x12:4。WB-M2.5x17:4。WB-M2.5x20:4。
- WB-M3x10:4。
- DC12-IDLER:3。DC12-IDLER-CAP:3。DC12-P-BEARING:3。
- RUBBER PAD:2。
2.4 備齊工具
ROBOTIS 列出一支螺絲起子與三支扳手作為組裝工具。
- 螺絲起子:1。
- Wrench-1.5:1。Wrench-2.0:1。Wrench-2.5:1。
2.5 決定選配零件
ROBOTIS 將電源供應器、控制板、U2D2 介面及其電源集線板,以及底板列為選配,不屬於手臂本身。
- 選配零件,各一:SMPS 12V5A、OpenCR、U2D2、U2D2 Power Hub Board、Base Plate-02。
- ROBOTIS 的概覽頁面註明,底板不包含在套件中。
- 要執行後面章節的快速入門,你需要 OpenCR,或 U2D2 加上其電源集線板來連接手臂,以及一個 12 V 電源。
3. 機構組裝
依 ROBOTIS 手冊與影片組裝手臂。
3.1 依 ROBOTIS 手冊組裝手臂
依照 ROBOTIS 的 PDF 手冊與組裝影片操作,因為沒有公開文字步驟。
- 請使用 ROBOTIS Assembly 頁面連結的 PDF Assembly Manual for OpenMANIPULATOR-X 與組裝影片。
- 原專案在任何可讀取的文字文件中都沒有說明螺絲尺寸、惰輪位置或關節順序,因此這裡也不提供。
- 用上一節的扣件清單核對你是否備齊手冊要求的每顆螺絲與螺帽。
4. 伺服機設定與電源
ROBOTIS 為正常運作的手臂提供的伺服機 ID、鮑率、供電電壓與起始姿態。
4.1 檢查 DYNAMIXEL ID 與鮑率
ROBOTIS 列出的預設 ID 為:關節 1 至 4 與夾爪依序為 11 至 15,鮑率皆為 1 Mbps。
- ROBOTIS 為 OpenMANIPULATOR-X 鏈提供的預設 DYNAMIXEL 設定為:關節 1,ID 11。關節 2,ID 12。關節 3,ID 13。關節 4,ID 14。夾爪,ID 15。五者的鮑率皆為 1 Mbps。
- ROBOTIS 以警告形式顯示此表,文字為:「如果你使用的是自訂機器手臂,請參考以下 OpenMANIPULATOR-X 鏈的預設 DYNAMIXEL 設定。」
- 不要將伺服機重新編號為 1 至 5。OpenMANIPULATOR-X 的 ROS 2 硬體描述將五個致動器列為 ID 11、12、13、14 與 15,baud_rate 為 1000000,而 OpenCR Arduino 函式庫在註解 Use Default OpenMANIPULATOR-X ID setting 之下設定 joint1_id = 11 至 gripper_id = 15。
- 本指南參閱的 ROBOTIS 文件沒有說明如何在伺服機上設定 ID,也沒有說明套件中的伺服機出廠時是否已設定好。
4.2 使用 12 V 電源
這支手臂的規格為 12 V 輸入,ROBOTIS 建議使用其 SMPS 12V 5A PS-10。
- 規格列出 OpenMANIPULATOR-X 的輸入電壓為 12 V。
- 快速入門指南建議使用 ROBOTIS SMPS 12V 5A PS-10 作為電源供應器。
- DYNAMIXEL XM430-W350-T 頁面列出其輸入電壓為 10.0 ~ 14.8 [V](Recommended : 12.0 [V])。
4.3 將每個關節設定到起始姿態
ROBOTIS 提醒,若通電時有關節超出其範圍,手臂可能無法啟動,因此請先以手動方式擺好姿態。
- 運轉手臂之前,請檢查每個關節的位置。ROBOTIS 警告,若有關節超出範圍,手臂可能會停止運作,或無法開始運作。
- 在 DYNAMIXEL 扭矩未啟用時,用手移動每個關節,使其符合 ROBOTIS 快速入門指南中的理想姿勢圖。
4.4 連接控制器、致動器與電源
將手臂接到 OpenCR,或接到附電源集線板的 U2D2,接上 12 V 電源,打開開關,並檢查 LED。
- 使用 OpenCR:以 micro USB 線將 OpenCR 連接到電腦,將 OpenMANIPULATOR-X 的 DYNAMIXEL 致動器接到 OpenCR,並為 OpenCR 供應 12 V 電源。
- 使用 U2D2:將 micro USB 接到電腦,並將 DYNAMIXEL 致動器與 12 V 電源接到 U2D2 與 U2D2 電源集線板。詳細的連接方式,ROBOTIS 請你參閱 U2D2 e-Manual 與 U2D2 電源集線板 e-Manual。
- 打開電源開關,確認所有 DYNAMIXEL 的 LED 都閃爍一次。
- ROBOTIS 描述致動器以菊鏈方式連接在 TTL 準位的多點匯流排上。在參閱的頁面中,它沒有提供逐條線材的連接順序。
5. 以 Arduino 與 OpenCR 控制(不使用 ROS)
ROBOTIS 提供的做法:以在 Arduino IDE 中寫入程式的 OpenCR 1.0 驅動手臂,並搭配 Processing GUI。
5.1 為 OpenCR 設定 Arduino IDE
依照 ROBOTIS OpenCR 1.0 e-Manual,安裝 Arduino IDE 與 OpenCR 開發板支援。
- ROBOTIS 表示,這種 Arduino 方式不需要 ROS。OpenCR 會成為主控制器。
- 安裝 Arduino IDE,並依照適用於 Windows、Linux 或 Mac 的 OpenCR 1.0 e-Manual 設定 OpenCR 開發環境。
- ROBOTIS 警告,OpenCR 的板子管理員不支援在 Raspberry Pi 或 NVidia Jetson 等 ARM 架構 SBC 上執行的 Arduino IDE。
5.2 上傳 open_manipulator_chain 範例
在 Arduino IDE 中開啟 Chain 範例,並透過 micro USB 上傳到 OpenCR。
- 以 micro USB 線將 OpenCR 連接到電腦。
- 在 Arduino IDE 中開啟 Examples > OpenManipulator > example > Chain > open_manipulator_chain。
- 將範例上傳到 OpenCR。上傳完成時,輸出視窗會顯示訊息。
- 若上傳失敗,請使用復原模式:按住 PUSH SW2 按鈕,按下 Reset 按鈕,放開 Reset 按鈕,再放開 PUSH SW2 按鈕。OpenCR 的 STATUS LED 隨後會週期性閃爍。
5.3 安裝 Processing GUI
安裝 Processing 3.5.4 與 ControlP5 函式庫,並取得 OpenMANIPULATOR 的 Processing 原始碼。
- 下載並安裝 Processing。ROBOTIS 在 Processing v3.5.4 中測試過原始碼。
- 在 Processing 中選擇 Tools > Add Tool..,開啟 Libraries 分頁,搜尋 ControlP5 並安裝。
- 從 GitHub 上的 ROBOTIS-GIT 取得 open_manipulator_processing 原始碼,可下載 zip 或用 git clone。
5.4 執行 Processing GUI
連接手臂,按下 OpenCR 的 Reset 按鈕開啟扭矩,然後執行 Chain.pde。
- 啟動 Processing 之前,OpenCR 1.0 必須已連接到 OpenMANIPULATOR-X。
- 以 micro USB 線將 OpenCR 連接到電腦,將 OpenMANIPULATOR-X 接到 OpenCR,並為 OpenCR 供應 12 V 電源。打開 OpenCR 的電源開關。
- 按下 OpenCR 1.0 的 Reset 按鈕,確認 OpenMANIPULATOR-X 已啟用扭矩,可以從關節變得僵硬看出。
- 在 Processing 中開啟 open_manipulator_processing > Chain > Chain.pde 並執行。接著會顯示圖形化 GUI。
- 若 Processing 主控台顯示錯誤且 GUI 無法執行,ROBOTIS 表示請檢查 ControlP5、顯示卡驅動程式與 Java 函式庫是否正確安裝。
6. 以 ROS 2(Jazzy)控制
ROBOTIS 提供的做法:從裝有 ROS 2 Jazzy 的 PC 驅動手臂,可使用 Docker 或直接安裝在主機上。
6.1 選擇 ROS 版本
ROBOTIS 的文件涵蓋 ROS 2 Jazzy、ROS 2 Humble 與 ROS Noetic;本節以 Jazzy 為準。
- ROS 2 Jazzy 支援 Ubuntu 24.04。ROBOTIS 建議 Jazzy 使用 Docker。
- ROS 2 Humble 支援 Ubuntu 22.04,ROS Noetic 支援 Ubuntu 20.04。Docker 支援 Jazzy 與 Humble,不支援 Noetic。
- Humble 的 ROBOTIS 套件名稱不同。例如,Humble 頁面執行 ros2 run open_manipulator_x_bringup create_udev_rules,而 Jazzy 頁面執行 ros2 run open_manipulator_bringup om_create_udev_rules。請使用與你的 ROS 版本對應的 ROBOTIS 快速入門分頁。
6.2 設定 Docker 環境
安裝 Docker Engine,複製 open_manipulator 的 jazzy 分支,並啟動容器。
- 依照 Ubuntu 的官方 Docker 安裝指南及其安裝後步驟:以 repository 方式安裝 Docker Engine,將你的使用者加入 docker 群組,讓 Docker 開機時自動啟動,並以 docker run hello-world 驗證。
- 執行:git clone -b jazzy https://github.com/ROBOTIS-GIT/open_manipulator.git,然後 cd open_manipulator。
- 以 ./docker/container.sh start 啟動容器,並以 ./docker/container.sh enter 進入。./docker/container.sh help 會顯示可用指令。
- ROBOTIS 的警告:./docker/container.sh stop 會移除容器及其中所有資料,只保留對應的 /workspace 目錄,因此請將你的工作放在 /workspace,它會儲存到主機上的 docker/workspace。docker restart 會保留所有資料。
6.3 或在主機上安裝 ROS 2 套件
不使用 Docker 時,將自己加入 dialout 群組,複製四個 jazzy 儲存庫,以 colcon 建置,並建立 udev 規則。
- 必須已安裝 ROS 2 Jazzy。此套件僅相容於 ROS 2 Jazzy。
- 執行:sudo usermod -aG dialout $USER,然後登出再重新登入。
- 在 ~/ros2_ws/src 中,複製以下每個 ROBOTIS-GIT 儲存庫的 jazzy 分支:DynamixelSDK、dynamixel_interfaces、dynamixel_hardware_interface 與 open_manipulator。
- 在 ~/ros2_ws 中執行:sudo rosdep init、rosdep update,然後 rosdep install --from-paths src -y --ignore-src。
- 建置:colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=Release,然後 source ~/ros2_ws/install/setup.bash。
- 以下指令建立並套用 udev 規則:ros2 run open_manipulator_bringup om_create_udev_rules
6.4 設定通訊介面
使用附電源集線板的 U2D2,或載入 usb_to_dxl 範例的 OpenCR。
- 選項 1(建議):U2D2。依照前面的步驟連接,然後將 USB 延遲計時器設為 1 ms。Docker 環境中已設定好。在主機上安裝時,ros2 run open_manipulator_bringup om_create_udev_rules 會設定它,而 cat /sys/bus/usb-serial/devices/ttyUSB0/latency_timer 會顯示目前的值。
- 選項 2:OpenCR。為 OpenCR 設定 Arduino IDE,將 OpenCR 連接到電腦,開啟 File > Examples > OpenCR > 10.Etc > usb_to_dxl 並上傳。
- 若上傳失敗,請使用 Arduino 一節所述的復原模式:開啟 OpenCR,按住 PUSH SW2,按下 Reset,放開 Reset,再放開 PUSH SW2。STATUS LED 應每 100ms 閃爍一次。
6.5 啟動控制器
啟動 open_manipulator_x.launch.py,它會開啟扭矩並鎖定各關節。
- 如同前面的步驟,先設定起始姿勢。
- 使用 U2D2 時執行:ros2 launch open_manipulator_bringup open_manipulator_x.launch.py
- 使用 OpenCR 時執行:ros2 launch open_manipulator_bringup open_manipulator_x.launch.py port_name:=/dev/ttyACM0
- 在 Docker 環境中,請在執行 ./docker/container.sh enter 之後,於容器內執行這些指令。
- 控制器啟動後,OpenMANIPULATOR-X 的每個關節都會鎖定(Torque On)。啟動輸出會 ping ID 011 至 015。