<!-- SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. -->
<!-- SPDX-License-Identifier: Apache-2.0 -->

<a id="supported-teleop-devices"></a>

# Supported Teleop devices

Isaac Teleop drives the SO-101 from two input devices today. Both command the same SO-101 follower
arm and produce the same LeRobot-format demonstrations — pick the one that matches the hardware you
have and the control feel you want.

<a id="xr-controller"></a>

## XR controller

A VR controller — from a Meta Quest, PICO, or Apple Vision Pro headset — streamed to your
workstation over [NVIDIA CloudXR](https://docs.nvidia.com/cloudxr-sdk). The controller pose drives
the SO-101 **end-effector** target, which inverse kinematics turns into arm joint commands, so you
steer the gripper through space rather than posing each joint.

A **clutch** (deadman) keeps teleoperation safe: the arm only moves while you hold the grip engaged.
Releasing pauses motion, and re-engaging re-centers on the arm’s current pose, so the arm never
jumps when you reposition your hand.

**Controls**

- **Squeeze / grip** — the clutch. Hold to engage teleoperation; release to pause.
- **Trigger** — the gripper, controlled proportionally (analog).
- **Controller orientation** — the wrist. On the 5-DOF SO-101 the wrist follows your hand only
  partially, by design.

The XR controller is **self-calibrating** — there is no leader arm and no manual calibration step —
and it works in both simulation and on real hardware. You will need a CloudXR-connected headset; see
the [Quick Start](../../teleop/quick_start.md) for headset setup.

<a id="so-101-leader"></a>

## SO-101 Leader

A second, back-drivable SO-101 arm used as a **leader**: you move the leader by hand and the SO-101
follower mirrors it. Because the leader and follower share the same kinematics, the mapping is a
**direct joint-space mirror** — there is no inverse kinematics and no clutch; the follower tracks the
leader’s joints one-to-one.

The leader’s joint stream is published by Isaac Teleop’s native `so101_leader` plugin, which the
teleoperation example launches for you.

This path needs the physical leader arm and a one-time **calibration** so the leader and follower
agree on each joint’s zero and range. Calibrate with `lerobot-calibrate` (or the plugin’s own
calibration step); the result is reused on every run.

The SO-101 Leader gives the most direct, intuitive feel for SO-101 teleoperation, at the cost of
needing a second arm.

The SO-101 Leader is the first [joint-space device](../../device/joint_space/index.md) in Isaac Teleop — one
that streams joint positions directly instead of an end-effector pose. The interface is general, so
the SO-101 Leader is just the starting point; feature requests and/or contributions that add more
joint-space devices are highly welcome.

<a id="choosing-a-device"></a>

## Choosing a device

|                | XR controller                                                                               | SO-101 Leader                     |
|----------------|---------------------------------------------------------------------------------------------|-----------------------------------|
| Hardware       | XR headset (CloudXR) that can be reused to teleoperate other robots                         | A leader arm dedicated to SO-101  |
| Mapping        | End-effector pose → IK, with a clutch                                                       | Direct joint-space mirror (1:1)   |
| Extra Features | - No dedicated space needed for setting up a second arm<br/>- Haptics support (coming soon) | - No clutch or IK weights to tune |

<a id="prerequisites-and-calibration"></a>

## Prerequisites and calibration

Both devices share the same high-level setup — see the per-flow steps in
[Data Collection in Real](data_collection_real.md) and [Data Collection in Sim](data_collection_sim.md). Calibration differs by device:

- **XR controller** — **self-calibrating**: the clutch re-centers on every engage, so there is no
  manual calibration step. It just needs a CloudXR-connected headset
  ([Quick Start](../../teleop/quick_start.md)).
- **SO-101 Leader** — needs a **one-time calibration** so the leader and follower agree on each
  joint’s zero and range:
  ```bash
  lerobot-calibrate \
      --teleop.type=so101_leader \
      --teleop.port=/dev/ttyACM1 \
      --teleop.id=so101_leader_arm
  ```

  The result is stored under `so_leader/<id>.json` and reused on every run.

<a id="learn-more"></a>

## Learn more

For the device and retargeting internals behind these flows, see the Isaac Teleop references:

- [Spatial Trackers and Device Data](../../device/trackers/index.md) — the device interface (trackers).
- [Add a New Device](../../device/add_device.md) — the device plugin model.
- [Generic Joint-Space Device](../../device/joint_space/index.md) — the SO-101 leader (joint-space) device and its plugin.
- [Retargeting Interface](../../references/retargeting/index.md) — the retargeting interface.
- [Retargeters: SO-101 (5-DOF arm)](../../references/retargeting/so101.md) — the SO-101 (5-DOF arm) retargeters used by the XR
  controller.
- [Retargeter: Joint-Space Device](../../references/retargeting/joint_space.md) — the joint-space retargeter used by the leader.
