Skip to content

Inputs (inputs, trackers)

inputs: are the operator's devices (leader arms, hand-held devices). An input never commands a follower itself; a controller turns it into follower commands (controllers). trackers: are the tracking systems that measure the pose of hand-held devices.

Keys of every input

Key Type Default Unit Description
type text required — The model (rakuda_mini, pika_sense) or module:Class
poll_hz number the fastest control_hz of the followers it drives Hz Rate at which the input is read (Control rate); required in a configuration without followers

A joint input records its joint positions, in its own unit, as observation.<input>. A pose input records x, y, z, qx, qy, qz, qw, gripper, tracking and engaged (Dataset features).

rakuda_mini

The Rakuda2 leader arm (Rakuda-mini). Its joint names and unit (dynamixel_count) are those of the Rakuda2 follower, so a joint controller pairs the joints of the same name. With control its joint groups run control laws (gravity compensation, a spring on the triggers, ...). It falls when torque goes off (falls) and goes limp when the session ends (torque_off).

Key Type Default Unit Description
port text required — Port of the U2D2 (/dev/serial/by-id/...)
motor_ids list of integers required — Motor IDs in joint order; the same fixed order as the Rakuda2 follower
registers mapping required — EEPROM values checked at startup; the same entries as the Rakuda2 follower
control list — — Control laws per joint group (control); without it the arm is only read
bus_watchdog_ms integer or null — ms The Dynamixel Bus Watchdog; required on hardware for current-mode laws

pika_sense In development

A hand-held Pika Sense. Its pose comes from its Vive tracker, read by a tracking system under trackers:; the jaw opening and the clutch (engaged) come from the Sense's serial port. A pose_ik controller turns it into arm joints (Pika Sense and IK).

Key Type Default Unit Description
port text required — The Sense's serial port (/dev/serial/by-path/...)
tracker {system, serial} required — system: a node under trackers:; serial: the tracker's serial number (LHR-...)
stale_ms number 100 ms Older pose or serial values count as lost

Tracking systems (trackers) In development

A tracking system is one node that publishes the pose of every tracked object it sees, keyed by serial number. Several inputs can share one system (one USB receiver, one calibrated world frame).

Key Type Default Unit Description
type text required — libsurvive or module:Class
poll_hz number the fastest input that reads it Hz Rate at which the poses are published

libsurvive

Lighthouse (Vive) tracking through libsurvive. Tracked objects are told apart by serial number (LHR-...).

Key Type Default Unit Description
args list of text [] — Extra libsurvive arguments (e.g. [--lighthouse-gen, "2"])

Example

# 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 (trackers.lighthouse of config.yaml)
type: libsurvive
args: []