Errors

from videosdk_teleop import NotAligned, RoomError

NotAligned and RoomError are on the package root. The rest live in the module that raises them.

What is raised

Exception	Import from	Raised when
`NotAligned`	`videosdk_teleop`	the two arms are too far apart to arm safely, or `arm_when_aligned()` ran out of time
`RoomError`	`videosdk_teleop`	room creation failed, no token, or a room id that is not real
`RecordingError`	`videosdk_teleop.recordings`	the API refused a cloud-recording request
`SchemaMismatch`	`videosdk_teleop.protocol`	a frame did not decode as this protocol, or a group was missing or the wrong size
`CalibrationError`	`videosdk_teleop.adapters.so101_calibration`	no calibration file, corrupt JSON, or an empty calibration
`ValueError`		no token passed and `VIDEOSDK_TOKEN` unset
`TypeError`		`on_starvation=TORQUE_OFF` without overriding `torque_enable()`. Raised at construction
`RuntimeError`		`tick()` called before `start()`

What to catch

The subclassing decides this.

Exception	Subclasses
`NotAligned`	`RuntimeError`
`RoomError`	`RuntimeError`
`RecordingError`	`RoomError`
`SchemaMismatch`	`ValueError`
`CalibrationError`	`ValueError`

RecordingError subclasses RoomError, so one except RoomError around session setup catches every VideoSDK API failure, cloud recording included.

from videosdk_teleop import RoomError

try:
    follower.start()
except RoomError as e:
    print("could not set up the session:", e)

Arming

NotAligned is the one you will catch most, since it is raised on purpose whenever arming would make the follower travel to meet a leader that is somewhere else.

from videosdk_teleop import NotAligned

try:
    leader.arm_when_aligned(hold_s=2.0, timeout=30.0)
except NotAligned as e:
    print(e)          # names the joint and how far out it is

Both arm_when_aligned() and hold_deadman(True) raise it. Releasing the deadman never does, because a stop must not be refusable.

Calibration

CalibrationError subclasses ValueError, so a caller that already handles bad input keeps working.

from videosdk_teleop.adapters import so101_calibration

try:
    calib = so101_calibration.load_for("my_follower")
except so101_calibration.CalibrationError as e:
    print(e)          # names the path it looked in

Troubleshooting

The same failures by symptom, with what to change.

Leader

Arming, control and the calls that raise here.

Python SDK

Adapters

Classes

What is raised

What to catch

Arming

Calibration

Troubleshooting

Leader

​What is raised

​What to catch

​Arming

​Calibration

​Related

Troubleshooting

Leader

What is raised

What to catch

Arming

Calibration

Related