入力(inputs,trackers)
inputs: は操作者の入力機器(leader arm,手に持つ機器)です.入力はfollowerへ直接は指令せず,controllerが入力をfollowerの指令に変えます(controller).trackers: は,手に持つ機器の姿勢を測る追跡systemです.
共通のkey
| key | 型 | 既定値 | 単位 | 説明 |
|---|---|---|---|---|
type |
文字列 | 必須 | — | 機種(rakuda_mini,pika_sense)か module:Class |
poll_hz |
数値 | 動かすfollowerのうち最も速い control_hz |
Hz | 入力を読む周期(制御周期).followerのない構成では必須 |
関節の入力は,関節の位置を入力の単位で observation.<入力名> に記録します.姿勢の入力は x,y,z,qx,qy,qz,qw,gripper,tracking,engaged を記録します(datasetの列).
rakuda_mini
Rakuda2のleader arm(Rakuda-mini)です.関節名と単位(dynamixel_count)はRakuda2 followerと同じなので,joint controllerは同じ名前の関節どうしを対応させます.control を書くと,関節groupごとに制御則で動きます(重力補償,triggerのばねなど).torqueが切れると落ち(falls),sessionの終了時に脱力します(torque_off).
| key | 型 | 既定値 | 単位 | 説明 |
|---|---|---|---|---|
port |
文字列 | 必須 | — | U2D2のport(/dev/serial/by-id/...) |
motor_ids |
整数のリスト | 必須 | — | 関節の順のmotor ID.Rakuda2 follower と同じ決まった並び |
registers |
mapping | 必須 | — | 起動時に照合するEEPROMの値.項目は Rakuda2 follower と同じ |
control |
リスト | — | — | 関節groupごとの制御則(control).書かなければ読むだけ |
bus_watchdog_ms |
整数か null |
— | ms | DynamixelのBus Watchdog.電流制御の制御則には実機で必須 |
pika_sense 開発中
手に持つPika Senseです.姿勢はVive trackerを trackers: の追跡systemが読み,顎の開きとclutch(engaged)はSenseのserialから読みます.pose_ik controllerが腕の関節に変えます(Pika SenseとIK).
| key | 型 | 既定値 | 単位 | 説明 |
|---|---|---|---|---|
port |
文字列 | 必須 | — | Senseのserial port(/dev/serial/by-path/...) |
tracker |
{system, serial} |
必須 | — | system:trackers: のnode名.serial:trackerのserial番号(LHR-...) |
stale_ms |
数値 | 100 |
ms | これより古い姿勢やserialの値は,見失ったとみなす |
追跡system(trackers) 開発中
追跡systemは1つのnodeで,見えている全ての追跡対象の姿勢をserial番号つきで流します.同じsystemを複数の入力が使えます(USBの受信機と,較正した世界座標は1つ).
| key | 型 | 既定値 | 単位 | 説明 |
|---|---|---|---|---|
type |
文字列 | 必須 | — | libsurvive か module:Class |
poll_hz |
数値 | 読む入力のうち最も速い周期 | Hz | 姿勢を流す周期 |
libsurvive
Lighthouse(Vive)の追跡をlibsurviveで行います.追跡対象はserial番号(LHR-...)で区別します.
| key | 型 | 既定値 | 単位 | 説明 |
|---|---|---|---|---|
args |
文字列のリスト | [] |
— | libsurviveに渡す追加の引数(例:[--lighthouse-gen, "2"]) |
例
# nodes/right_sense.yaml
type: pika_sense
port: SET_RIGHT_SENSE_PORT
tracker: {system: lighthouse, serial: SET_RIGHT_TRACKER_SERIAL}
stale_ms: 100
# nodes/lighthouse.yaml(config.yaml の trackers.lighthouse)
type: libsurvive
args: []