PiPER+Pika:機体設定
状態:開発中
開発中 roboloom setup は偽の機器を使った試験でだけ確かめています.実機で動かしたことはありません.うまくいかない段階があれば,その段階の表示を添えて報告してください.
- 目的:
.roboloom/piper-pika/を作り,どのCAN interface・serial port・trackerがどの機器かをroboloom setupで特定して書き込み,読み取りで確かめる. - 前提:Installation が済んでいる.PiPER 2台,Pika Gripper 2台,Pika Sense 2台,基地局(Lighthouse)を配線し,電源を入れている.腕は折りたたんだ休止の姿勢で,motorは無効(電源を入れた直後の状態).
- 所要:30分(管理者の作業を除く).
- 結果:
roboloom validate piper-pikaが通る.機器を何も有効にせず,動かさない.
0. 管理者に頼むこと
rootが要る作業です.roboloomはsudoを呼びません.
- serial portを開く権限(
dialoutgroup). - Vive trackerのudev rules(libsurviveの
81-vive.rules). - CAN interfaceを1 Mbpsで有効にする.名前は決めなくてかまいません(
can0,can1のままでよい).roboloomはUSB-CAN adapterのserial番号で腕を見分けます.
1. 設定を作る
uv add git+https://github.com/tetsugo02/roboloom.git --tag v0.2.0 --extra piper --extra pika --extra record
uv run roboloom init piper-pika
uv run roboloom validate piper-pika --mock # 装置なしで設定が読めることを確かめる
.roboloom/piper-pika/ に,腕・Gripper・Senseごとのnodeのfileができます.機器の識別子(CAN adapterのserial,serial port,trackerのserial)は SET_ のままです.
2. 機器を特定する
uv run roboloom setup piper-pika
画面の指示に従って,1台ずつ手で動かします.変化したものがちょうど1つのときに,それをその機器として書きます.0個や2個以上のときは,もう一度聞きます.
| 段階 | 調べること | 頼まれる操作 |
|---|---|---|
check |
extras,serial portの権限,Viveのudev rules | なし |
can |
CAN interfaceの状態,bitrate,adapterのserial | 有効でなければ,表示されたcommandを管理者に実行してもらい,Enter |
arms |
どのCANがどの腕か | 指定された腕のjoint1(根元)を手で20°ほど回して戻し,Enter |
senses |
どのportがどのSenseか | 指定されたSenseを何度か開閉し,Enter |
trackers |
どのtracker(LHR-…)がどのSenseに入っているか |
指定されたSenseを30 cmほど動かし(他は静かに),Enter |
grippers |
どのportがどのGripperか | 指定されたGripperのUSBを抜いてEnter,同じ差し口に挿し直してEnter |
validate |
実機用に設定が読めるか | なし |
- motorが有効な腕は断ります. PiPERは無効にすると落ちるので,setupは無効にしません.支えてから
check-holdの最後に release するか,休止の姿勢で電源を入れ直してから,もう一度実行します. - trackerが見えないときは,基地局の校正(libsurviveの
--force-calibrate)を提案します.両方のSenseを,両方の基地局から見える場所に静かに置いてからyesと答えます.校正の結果はlibsurviveの設定(~/.config/libsurvive/)に残るので,一度だけで済みます. - Gripperは手で回せないので,USBの抜き差しで特定します(LeRobotの
lerobot-find-portと同じ方式).portの名前はUSBの差し口で決まるので,挿し直すときは同じ差し口に挿します. - 最後の1台は,候補が1つだけなら聞かずに決めます.
書き込んだ行には # roboloom setup <日付> が付きます.fileのほかの行とcommentは変えません.
# nodes/left.yaml(抜粋)
can: {serial: "0029002F5746570A20383839"} # roboloom setup 2026-11-17
# nodes/left_sense.yaml(抜粋)
port: /dev/serial/by-path/pci-0000:00:14.0-usb-0:3.4:1.0-port0 # roboloom setup 2026-11-17
tracker: {system: lighthouse, serial: "LHR-F7BA2042"} # roboloom setup 2026-11-17
一部だけやり直す
uv run roboloom setup piper-pika --step grippers # Gripperだけ
uv run roboloom setup piper-pika --step can,arms # CANと腕
設定済みの値は先に表示されます.Enterでそのまま使い,r で特定し直します.cableや機器を替えたあとの確認に使います.
3. 読み取りで確かめる
uv run roboloom validate piper-pika
uv run roboloom probe can0 # 腕(CANの名前は setup の can の段階に表示される)
uv run roboloom probe /dev/serial/by-path/<Gripperのport> --device pika
uv run roboloom probe /dev/serial/by-path/<Senseのport> --device pika_sense
validateは,workspaceを書いていないIKのnodeにnote:を出します.初回はそれでかまいません(設定を絞る で足します).- 休止の姿勢では,joint2が少し負,joint3が少し正になり,
limits(joint2 ≥ 0,joint3 ≤ 0)の外に出ることがあります.home へ動かすときに範囲の内側へ戻るので,そのままでかまいません. - Gripperを閉じた状態の角度が0より小さい(例:−0.015 rad)ときは,setupが
note:で知らせます.零点の書き込み(pika_sdkのset_zero)はroboloomではまだ行いません.小さいずれなら,そのまま次へ進めます.
次へ
初めての遠隔操作:保持を確かめ,home へ動かし,ゆるい設定で遠隔操作します.