Universal Manipulation Exoskeleton (UME) の組み立てガイド
ロボットの関節トルクを操作者に返す、装着型の双腕外骨格
ライセンス
Apache 2.0
コードと CAD:Apache-2.0(リポジトリの LICENSE.md による)。同梱の OpenArm モデルは独自の Apache-2.0 ライセンスファイルを保持し、ACT と DETR のコードには元のプロジェクトの Facebook の著作権表示があります。Yahboom の IMU 読み取りコードはメーカーのコードで、ライセンスの記載がありません。プロジェクトサイトのテンプレートは CC BY-SA 4.0 で、論文と動画は著者のものです。2026-11-08 に LICENSE.md とリポジトリ内のファイルで確認。
組み立てガイド
1. 部品を準備する
アクチュエータと金具をそろえ、外骨格の部品を印刷します。
1.1 購入部品をそろえる
アルミフレーム、ねじ、アクチュエータを用意します。
- 論文の付録 E.2 を部品リストとして使う
- 両腕用にアクチュエータとして DM-J4340-2EC を 8 個、DM-J4310-2EC を 8 個そろえる
- 設定用に Damiao の UART-USB-C アダプタと直流電源を用意する
1.2 外骨格の部品を印刷する
分解図のオレンジ色の部品をすべて PLA で印刷します。
- MuJoCo モデルにある STL ファイルを使うか、ume_step フォルダの STEP ファイルを編集する
- Bambu Lab の PLA Basic で、三角形インフィル 20% で印刷する
- ガイドの推奨どおり、強度のためにオレンジの PLA を使う
- 必要なら CAD で腕の長さを自分の腕に合わせて変える
2. Damiao アクチュエータを設定する
取り付ける前に各アクチュエータの CAN ID、マスター ID、バス速度を設定します。
2.1 アクチュエータを PC につなぐ
アクチュエータの UART ポートを PC につなぎ、電源を準備します。
- Damiao のデバッグツールをダウンロードして開く
- アクチュエータの UART ポートを UART-USB-C アダプタに、さらに PC につなぐ
- 直流電源を 24 V に設定する
- シリアルポートを開くをクリックし、緑になることを確かめる
- アクチュエータの電源を入れ、状態レポートが出ることを確かめる。出なければ別の USB-C ケーブルを試す
2.2 CAN ID を書き込む
各アクチュエータに腕の上の位置で ID を付け、肩からグリッパまで 1 から 8 と数えます。
- パラメータ設定を開き、パラメータ読み込みをクリックする
- 位置 i のアクチュエータでは CAN ID を 0x0i、マスター ID を 0x1i にする。肩なら 0x01 と 0x11
- パラメータ書き込みをクリックし、書き込み成功のメッセージを待つ
2.3 バス速度を 5 Mbps にする
CAN バスの速度を上げ、新しい設定を確認します。
- シリアルポートのタブに戻る
- コマンド欄で s を送り、続けて FCB9 を送る
- アクチュエータの電源を入れ直し、状態レポートに新しい CAN ID、マスター ID、CAN ボーレートが出ることを確かめる
- 右腕の 8 個と左腕の 8 個、すべてのアクチュエータで繰り返す
3. 外骨格を組み立てる
分解図に従い、各腕を肩から手首へ組み立てます。
3.1 肩から始める
肩を机に固定し、外側へ組んでいきます。
- 肩を机に固定する
- ガイドの分解図に従って肩から手首へ組み立てる
- 各アクチュエータは、印刷部品のねじ穴の深さより約 5 mm 長いねじで固定する
3.2 肩のケーブルを通す
J2 のケーブルをフレームの中に隠します。
- J1 からの XT30 2+2 ケーブルを 2020 アルミフレームに通す
- 印刷部品の穴を通して J2 につなぐ
3.3 ほかのケーブルを通す
各関節には動くのに必要なだけのケーブルを残します。
- 関節を組み、ケーブルをつなぐ
- 関節を人の可動域の限界まで回し、必要最小限の余長を見つける
- 動きの邪魔にならない場所でケーブルをテープで留める
3.4 IMU を取り付ける
Yahboom の IMU を外骨格の背中に固定します。
- IMU を外骨格の背中の好きな位置に取り付ける
- x を上、y を左、z を前に向ける
4. ゼロ点合わせとテスト
各関節をソフトウェアのモデルに合わせてゼロ点を取り、重力補償と遠隔操作を確認します。
4.1 各関節のゼロ点を取る
各関節を基準位置で固定し、ゼロ点を保存します。
- ゼロ点合わせ用のキーを印刷する。5 mm x 2.5 mm x 100 mm の溝がある部品
- アクチュエータの前後にある突起を合わせ、キーで固定する
- motor_chain_test.py で motor_ids と motor_types をこの関節に合わせ、set_zero の行のコメントを外す
- 実行し、アクチュエータが緑になり 0 を示すことを確かめる
- すべての関節で繰り返す
4.2 安全にゼロ点を確認する
まずトルク指令を切った状態でシミュレーションの確認を行います。
- real_teleop_sim.py で両腕の tau_ff の前にあるトルク倍率を 0 にする
- real_teleop_sim.py を実行し、関節の値をモデルと比べる
- 値が正しければ倍率を戻し、外骨格を手で動かして重力補償を感じる
4.3 ソフトウェアをつなぐ
IMU、CAN バス、重力補償のデモを設定します。
- yaml ファイルから ume_redis と ume_torch の conda 環境を入れる
- IMU を読めるよう、自分を dialout グループに加える
- 移動台車を CAN0 と CAN1、アームを CAN2 と CAN3、外骨格を CAN4 と CAN5 にして enable_can.sh を実行する
- 初めて組んだときは、MuJoCo のウィンドウを表示し、トルクを 0.5 倍にして重力補償のデモを動かす
4.4 OpenArm を遠隔操作する
アームの遠隔操作デモを動かし、外骨格とロボットが連携することを確かめます。
- process-compose で teleop_openarm.yaml を起動する
- b を押してアームをゆっくり開始位置へ動かす
- バッククォートキーを押してトルクフィードバック付きの遠隔操作を始める