State / Health
Capability
Section titled “Capability”Read motor feedback, system health, and module diagnostics, or subscribe to state.
Applicable Products
Section titled “Applicable Products”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
Quick Example
Section titled “Quick Example”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";Parameters and Returns
Section titled “Parameters and Returns”| Operation | Parameters | Returns |
|---|---|---|
| State.snapshot() | — | HandState |
| Health.snapshot() | — | HealthSnapshot |
Find full signatures, defaults, units, and Python / C++ differences by operation:
Errors and Limits
Section titled “Errors and Limits”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