Skip to content
简体中文

State / Health

Read motor feedback, system health, and module diagnostics, or subscribe to state.

The 21-, 16-, and 13-DOF products return active-joint state using JointLayout.joint_count. Protocol paths are implemented for PB1, PT1, DB1, and DT1 but still await hardware validation.

Check the product support matrix

Run these fragments with a connected hand. Python runs inside an async function; C++ requires revo3/revo3.hpp, iostream, vector, chrono, and stdexcept; handle SdkError at the application boundary.

state = await hand.state.snapshot()
health = await hand.health.snapshot()
print(state.positions_deg)
print(health.safety_state, health.faulted_motor_count)
const auto state = hand.state().snapshot();
const auto health = hand.health().snapshot();
std::cout << static_cast<int>(health.safety_state) << " "
<< health.faulted_motor_count << "\n";
Operation Parameters Returns
State.snapshot() — HandState
Health.snapshot() — HealthSnapshot

Find full signatures, defaults, units, and Python / C++ differences by operation:

period is the SDK polling interval, not a firmware sampling-rate guarantee. State and Health are collected separately; 13/16-DOF State also combines multiple protocol reads and is not an atomic device sample.

Errors, Timeouts, and Retries · Language Binding Differences