Hardware Setup¶

Camera configuration¶

Run rd list_devices to detect all connected cameras and generate a starter ~/.config/raiden/camera.json. Edit it to assign the correct role to each camera ("scene", "left_wrist", or "right_wrist"):

{
  "scene_camera":      {"serial": 37038161, "type": "zed",       "role": "scene"},
  "left_wrist_camera": {"serial": 16522755, "type": "zed",       "role": "left_wrist"},
  "right_wrist_camera":{"serial": 14932342, "type": "zed",       "role": "right_wrist"}
}

ZED Mini cameras are mounted on the follower arm wrist links via 3D-printed mounts (left, right). The ZED 2i is used as a fixed overhead or scene camera. Any Intel RealSense D400-series camera can be used as an alternative wrist or scene camera. The D405 in particular is well-suited for wrist mounting due to its compact form factor and close-range depth optimization.

Right wrist ZED Mini orientation

The ZED Mini on the right wrist must be mounted upside down.

RealSense bag file size

RealSense cameras record to .bag files at 640×480 BGR8. The file size is roughly 500 MB–1 GB per camera per 10 seconds. See Recording for mitigations.

Prefer ZED cameras for dynamic tasks

For tasks involving fast robot motion, ZED cameras are strongly recommended over RealSense. RealSense cameras have synchronization limitations that can cause misalignment with other cameras:

Timestamp reliability — global_time_enabled is inconsistently supported across D4xx firmware versions. When unsupported, the SDK reports hardware-relative timestamps (milliseconds since device boot) instead of wall-clock time. Raiden measures a clock offset at recording start to compensate, but this is only an approximation.
Frame extraction — The RealSense SDK pre-buffers frames during bag playback. If the pipeline queue is drained to fetch the latest frame (as is appropriate for live preview), every other buffered frame is silently discarded, halving the apparent FPS. Raiden works around this by disabling queue draining during playback.

ZED timestamps (sl.TIME_REFERENCE.IMAGE) are wall-clock Unix nanoseconds, consistent across all ZED cameras and with the robot controller clock, making multi-camera alignment straightforward. Use RealSense cameras only where their close-range depth quality is the primary requirement and motion is limited.

SpaceMouse setup¶

SpaceMouse devices are identified by their hidraw path (e.g. /dev/hidraw6). To find the correct paths, run:

rd list_devices

This lists all connected SpaceMouse devices with their paths. Once identified, save them to ~/.config/raiden/spacemouse.json:

{
  "path_r": "/dev/hidraw7",
  "path_l": "/dev/hidraw6"
}

rd teleop and rd record pick up the paths from this file automatically. You can still override them on the command line with --spacemouse-path-r and --spacemouse-path-l.

Soft E-Stop Foot Switch¶

See Safety for setup and usage.

CAN bus setup¶

Each YAM arm communicates over its own CAN interface. Raiden expects the interfaces to be named as follows:

Interface name	Arm
`can_follower_r`	Right follower arm
`can_follower_l`	Left follower arm
`can_leader_r`	Right leader arm
`can_leader_l`	Left leader arm

These names must be set as persistent CAN interface aliases. In a single-arm setup, only can_follower_l and can_leader_l are needed — the single arm is always treated as the left arm. Follow the i2rt guide to assign them: Setting a persistent ID for a socket CAN interface.

Identifying each arm¶

Because all arms look identical on the bus, connect and name them one at a time:

Disconnect all arms.
Connect a single arm.
Run ip link show to see which can* interface appeared.
Assign the persistent name for that arm (e.g. can_follower_l) following the i2rt guide above.
Disconnect that arm and repeat for the next one.

This ensures each physical arm is unambiguously mapped to its interface name before running Raiden.

Bringing interfaces up¶

After each reboot, bring all CAN interfaces up with:

sudo bash scripts/reset_all_can.sh

This sets every detected can* interface to 1 Mbit/s and brings it UP. See the FAQ for details.