Revo 3 SDK v2.x API navigation
This section helps you find APIs by capability domain and understand key constraints. It does not duplicate complete signatures, parameter tables, or data structures.
Complete API contract
For exact signatures, constraints, return values, enums, error semantics, and Python, C++, and C ABI mappings, use the versioned Revo 3 SDK v2.0.0 complete API manual. The complete manual is the single authoritative source for the API contract.
This index targets Revo 3 SDK v2.0.0; its Python wheel package is bc-revo3-sdk.
Documentation boundary
| Question | Documentation |
|---|---|
| Choose a capability domain and understand object relationships or key risks | This API navigation section |
| Look up exact signatures, fields, enums, or language mappings | Complete API manual |
| Complete a connection, motion, touch, or maintenance workflow | Developer guides |
Core objects
| Object | Responsibility |
|---|---|
Manager | Discovery, connection, and shared-resource shutdown |
Hand | Device identity, layouts, firmware information, and capability domains |
DetectedDevice | Port, protocol, slave ID, model, and serial number |
Hand domains
- Motion: target motion, Servo, teaching, replay, waiting, and cancellation.
- State, Touch, and Health: snapshots, subscriptions, layouts, telemetry, and diagnostics.
- Config, Calibration, and Maintenance: settings, limits, calibration, reboot, reset, and firmware update.
Experimental API: ExperimentalCollision
ExperimentalCollision may change or be removed in a later release and is not covered by backward-compatibility guarantees. It does not replace device-level limits, emergency stops, or other safety controls, and must not be the application's only collision safeguard. Validate it on the target device, firmware, load, and operating scenario before use.
Errors and recovery
Handle SdkError together with operation_effect, recovery_requirement, and OperationState. Indeterminate does not mean “not executed”; read the device state before deciding whether a write is safe to retry.
See types, enums, and errors for the type index.
Language differences
| Semantics | Python | C++ | C ABI |
|---|---|---|---|
| Lifecycle | await close() / async context | RAII / close() | Explicit handle release |
| Waiting | Awaitable | Blocking with std::chrono timeout | Synchronous functions or callbacks |
| Naming | Object methods omit revo3_ | Object methods omit revo3_ | Exported symbols use revo3_ |
| Error | SdkError | revo3::SdkError | Error structure and status code |