Protocol Documentation
Compatible Version
- RBY1-RPC version: Before v0.2.0
- RBY1-SDK version: Before v0.2.0 (4120217)
Table of Contents
- CartesianCommand
- CartesianCommand.Feedback
- CartesianCommand.Request
- CartesianCommand.SE3PoseTarget
- CartesianCommand.TrackingError
- GravityCompensationCommand
- GravityCompensationCommand.Feedback
- GravityCompensationCommand.Request
- ImpedanceControlCommand
- ImpedanceControlCommand.Feedback
- ImpedanceControlCommand.Request
- ImpedanceControlCommand.TrackingError
- JogCommand
- JogCommand.Feedback
- JogCommand.Request
- JointPositionCommand
- JointPositionCommand.Feedback
- JointPositionCommand.Request
- JointVelocityCommand
- JointVelocityCommand.Feedback
- JointVelocityCommand.Request
- OptimalControlCommand
- OptimalControlCommand.CartesianCost
- OptimalControlCommand.CenterOfMassCost
- OptimalControlCommand.Feedback
- OptimalControlCommand.JointPositionCost
- OptimalControlCommand.Request
- RealTimeControlCommand
- RealTimeControlCommand.Feedback
- RealTimeControlCommand.Request
- SE2VelocityCommand
- SE2VelocityCommand.Feedback
- SE2VelocityCommand.Request
- StopCommand
- StopCommand.Feedback
- StopCommand.Request
rb/api/arm-command.proto
ArmCommand
ArmCommand
ArmCommand-Feedback
ArmCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback | ||
| joint-position-command-feedback | JointPositionCommand.Feedback | ||
| gravity-compensation-command-feedback | GravityCompensationCommand.Feedback | ||
| cartesian-command-feedback | CartesianCommand.Feedback | ||
| impedance-control-command-feedback | ImpedanceControlCommand.Feedback |
ArmCommand-Request
ArmCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request | ||
| joint-position-command | JointPositionCommand.Request | ||
| gravity-compensation-command | GravityCompensationCommand.Request | ||
| cartesian-command | CartesianCommand.Request | ||
| impedance-control-command | ImpedanceControlCommand.Request |
rb/api/basic-command.proto
CartesianCommand
CartesianCommand
CartesianCommand-Feedback
CartesianCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback | ||
| tracking-errors | CartesianCommand.TrackingError | repeated |
CartesianCommand-Request
CartesianCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request | ||
| minimum-time | google.protobuf.Duration | ||
| targets | CartesianCommand.SE3PoseTarget | repeated | |
| stop-position-tracking-error | google.protobuf.DoubleValue | ||
| stop-orientation-tracking-error | google.protobuf.DoubleValue |
CartesianCommand-SE3PoseTarget
CartesianCommand.SE3PoseTarget
| Field | Type | Label | Description |
|---|---|---|---|
| ref-link-name | string | ||
| link-name | string | ||
| T | SE3Pose | ||
| linear-velocity-limit | google.protobuf.DoubleValue | (m/s) | |
| angular-velocity-limit | google.protobuf.DoubleValue | (rad/s) | |
| acceleration-limit-scaling | google.protobuf.DoubleValue | default.linear-acceleration-limit * acceleration-limit-scaling default.angular-acceleration-limit * acceleration-limit-scaling |
(0, 1] |
CartesianCommand-TrackingError
CartesianCommand.TrackingError
| Field | Type | Label | Description |
|---|---|---|---|
| position-error | double | ||
| rotation-error | double |
GravityCompensationCommand
GravityCompensationCommand
GravityCompensationCommand-Feedback
GravityCompensationCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback |
GravityCompensationCommand-Request
GravityCompensationCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request | ||
| on | bool |
ImpedanceControlCommand
ImpedanceControlCommand
ImpedanceControlCommand-Feedback
ImpedanceControlCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback | ||
| tracking-error | ImpedanceControlCommand.TrackingError |
ImpedanceControlCommand-Request
ImpedanceControlCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request | ||
| ref-link-name | string | ||
| link-name | string | ||
| T | SE3Pose | ||
| translation-weight | Vec3 | ||
| rotation-weight | Vec3 |
ImpedanceControlCommand-TrackingError
ImpedanceControlCommand.TrackingError
| Field | Type | Label | Description |
|---|---|---|---|
| position-error | double | ||
| rotation-error | double |
JogCommand
JogCommand
JogCommand-Feedback
JogCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback | ||
| target-joint-name | string |
JogCommand-Request
JogCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request | ||
| joint-name | string | ||
| velocity-limit | google.protobuf.DoubleValue | (rad/s) (optional) | |
| acceleration-limit | google.protobuf.DoubleValue | (rad/s^2) (optional) | |
| absolute-position | double | (rad) | |
| relative-position | double | (rad) current position + relative position | |
| one-step | bool | 5 deg, true is positive move, false is negative move |
JointPositionCommand
JointPositionCommand
JointPositionCommand-Feedback
JointPositionCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback |
JointPositionCommand-Request
JointPositionCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request | ||
| minimum-time | google.protobuf.Duration | ||
| position | double | repeated | |
| velocity-limit | double | repeated | |
| acceleration-limit | double | repeated | |
| cutoff-frequency | google.protobuf.DoubleValue |
JointVelocityCommand
JointVelocityCommand
JointVelocityCommand-Feedback
JointVelocityCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback |
JointVelocityCommand-Request
JointVelocityCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request | ||
| minimum-time | google.protobuf.Duration | ||
| velocity | double | repeated | |
| acceleration-limit | double | repeated |
OptimalControlCommand
OptimalControlCommand
OptimalControlCommand-CartesianCost
OptimalControlCommand.CartesianCost
| Field | Type | Label | Description |
|---|---|---|---|
| ref-link-name | string | ||
| link-name | string | ||
| T | SE3Pose | ||
| translation-weight | double | default = 1 | |
| rotation-weight | double | default = 1 |
OptimalControlCommand-CenterOfMassCost
OptimalControlCommand.CenterOfMassCost
| Field | Type | Label | Description |
|---|---|---|---|
| ref-link-name | string | ||
| pose | Vec3 | ||
| weight | double | default = 1 |
OptimalControlCommand-Feedback
OptimalControlCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback | ||
| total-cost | double | ||
| cartesian-costs | double | repeated | |
| center-of-mass-cost | double | ||
| joint-position-costs | double | repeated |
OptimalControlCommand-JointPositionCost
OptimalControlCommand.JointPositionCost
| Field | Type | Label | Description |
|---|---|---|---|
| joint-name | string | ||
| target-position | double | ||
| weight | double |
OptimalControlCommand-Request
OptimalControlCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request | ||
| cartesian-costs | OptimalControlCommand.CartesianCost | repeated | |
| center-of-mass-cost | OptimalControlCommand.CenterOfMassCost | ||
| joint-position-costs | OptimalControlCommand.JointPositionCost | repeated | |
| velocity-limit-scaling | google.protobuf.DoubleValue | velocity scaling factor: qdot-limit * default.velocity-limit-scaling * velocity-limit-scaling default: 1.0, range: (0, 1] | |
| velocity-tracking-gain | google.protobuf.DoubleValue | velocity tracking gain default: default.optimal-control-command.velocity-tracking-gain, range: (0, 1] | |
| stop-cost | google.protobuf.DoubleValue | stop cost default: default.optimal-control-command.stop-cost, range: (0, ∞) | |
| min-delta-cost | google.protobuf.DoubleValue | minimum delta cost range: (0, ∞) | |
| patience | google.protobuf.Int32Value | patience parameter range: (0, ∞) |
RealTimeControlCommand
RealTimeControlCommand
RealTimeControlCommand-Feedback
RealTimeControlCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback |
RealTimeControlCommand-Request
RealTimeControlCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request | ||
| port | uint32 |
SE2VelocityCommand
SE2VelocityCommand
SE2VelocityCommand-Feedback
SE2VelocityCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback |
SE2VelocityCommand-Request
SE2VelocityCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request | ||
| minimum-time | google.protobuf.Duration | ||
| velocity | SE2Velocity | ||
| acceleration-limit | SE2Velocity |
StopCommand
StopCommand
StopCommand-Feedback
StopCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback |
StopCommand-Request
StopCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request |
rb/api/body-command.proto
BodyCommand
BodyCommand
BodyCommand-Feedback
BodyCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback | ||
| joint-position-command-feedback | JointPositionCommand.Feedback | ||
| optimal-control-command-feedback | OptimalControlCommand.Feedback | ||
| gravity-compensation-command-feedback | GravityCompensationCommand.Feedback | ||
| cartesian-command-feedback | CartesianCommand.Feedback | ||
| body-component-based-command-feedback | BodyComponentBasedCommand.Feedback |
BodyCommand-Request
BodyCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request | ||
| joint-position-command | JointPositionCommand.Request | ||
| optimal-control-command | OptimalControlCommand.Request | ||
| gravity-compensation-command | GravityCompensationCommand.Request | ||
| cartesian-command | CartesianCommand.Request | ||
| body-component-based-command | BodyComponentBasedCommand.Request |
rb/api/body-component-based-command.proto
BodyComponentBasedCommand
BodyComponentBasedCommand
BodyComponentBasedCommand-Feedback
BodyComponentBasedCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback | ||
| right-arm-command-feedback | ArmCommand.Feedback | ||
| left-arm-command-feedback | ArmCommand.Feedback | ||
| torso-command-feedback | TorsoCommand.Feedback |
BodyComponentBasedCommand-Request
BodyComponentBasedCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request | ||
| right-arm-command | ArmCommand.Request | ||
| left-arm-command | ArmCommand.Request | ||
| torso-command | TorsoCommand.Request |
rb/api/command-header.proto
CommandHeader
CommandHeader
CommandHeader-Feedback
CommandHeader.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| finished | bool |
CommandHeader-Request
CommandHeader.Request
| Field | Type | Label | Description |
|---|---|---|---|
| control-hold-time | google.protobuf.Duration | ||
| gravity | Vec3 | ||
| inertials | CommandHeader.Request.InertialsEntry | repeated |
CommandHeader-Request-InertialsEntry
CommandHeader.Request.InertialsEntry
| Field | Type | Label | Description |
|---|---|---|---|
| key | string | ||
| value | Inertial |
rb/api/component-based-command.proto
ComponentBasedCommand
ComponentBasedCommand
ComponentBasedCommand-Feedback
ComponentBasedCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback | ||
| mobility-command-feedback | MobilityCommand.Feedback | ||
| body-command-feedback | BodyCommand.Feedback | ||
| head-command-feedback | HeadCommand.Feedback |
ComponentBasedCommand-Request
ComponentBasedCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request | ||
| mobility-command | MobilityCommand.Request | ||
| body-command | BodyCommand.Request | ||
| head-command | HeadCommand.Request |
rb/api/control-manager.proto
ControlManagerCommandRequest
ControlManagerCommandRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | Request header | |
| command | ControlManagerCommandRequest.Command | ||
| unlimited-mode-enabled | google.protobuf.BoolValue |
ControlManagerCommandResponse
ControlManagerCommandResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader | Response header | |
| control-manager-state | ControlManagerState |
ControlManagerState
ControlManagerState
| Field | Type | Label | Description |
|---|---|---|---|
| state | ControlManagerState.State | ||
| time-scale | double | ||
| control-state | ControlManagerState.ControlState | ||
| enabled-joint-idx | uint32 | repeated | |
| unlimited-mode-enabled | bool |
GetTimeScaleRequest
GetTimeScaleRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | Request header |
GetTimeScaleResponse
GetTimeScaleResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader | Response header | |
| time-scale | double |
SetTimeScaleRequest
SetTimeScaleRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | Request header | |
| time-scale | double |
SetTimeScaleResponse
SetTimeScaleResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader | Response header | |
| current-time-scale | double |
ControlManagerCommandRequest-Command
ControlManagerCommandRequest.Command
Control manager command
| Name | Number | Description |
|---|---|---|
| COMMAND-UNKNOWN | 0 | |
| COMMAND-ENABLE | 1 | |
| COMMAND-DISABLE | 2 | |
| COMMAND-RESET-FAULT | 3 |
ControlManagerState-ControlState
ControlManagerState.ControlState
| Name | Number | Description |
|---|---|---|
| CONTROL-STATE-UNKNOWN | 0 | |
| CONTROL-STATE-IDLE | 1 | |
| CONTROL-STATE-EXECUTING | 2 | |
| CONTROL-STATE-SWITCHING | 3 |
ControlManagerState-State
ControlManagerState.State
| Name | Number | Description |
|---|---|---|
| CONTROL-MANAGER-STATE-UNKNOWN | 0 | |
| CONTROL-MANAGER-STATE-IDLE | 1 | |
| CONTROL-MANAGER-STATE-ENABLED | 2 | |
| CONTROL-MANAGER-STATE-MINOR-FAULT | 3 | |
| CONTROL-MANAGER-STATE-MAJOR-FAULT | 4 |
rb/api/control-manager-service.proto
ControlManagerService
ControlManagerService
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
| ControlManagerCommand | ControlManagerCommandRequest | ControlManagerCommandResponse | |
| GetTimeScale | GetTimeScaleRequest | GetTimeScaleResponse | |
| SetTimeScale | SetTimeScaleRequest | SetTimeScaleResponse |
rb/api/gamepad.proto
Gamepad
Gamepad
| Field | Type | Label | Description |
|---|---|---|---|
| buttons | bool | repeated | |
| joystick | double | repeated |
UploadGamepadDataRequest
UploadGamepadDataRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | ||
| data | Gamepad |
UploadGamepadDataResponse
UploadGamepadDataResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader |
rb/api/gamepad-service.proto
GamepadService
GamepadService
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
| UploadGamepadData | Gamepad stream | UploadGamepadDataResponse |
rb/api/geometry.proto
EulerAngleZYX
EulerAngleZYX
| Field | Type | Label | Description |
|---|---|---|---|
| z | double | ||
| y | double | ||
| x | double |
Inertia
Inertia
Inertia tensor components (kg*m^2)
| Field | Type | Label | Description |
|---|---|---|---|
| ixx | double | ||
| iyy | double | ||
| izz | double | ||
| ixy | double | ||
| ixz | double | ||
| iyz | double |
Inertial
Inertial
| Field | Type | Label | Description |
|---|---|---|---|
| mass | double | Mass (kg) | |
| center-of-mass | Vec3 | Center of mass (m) | |
| inertia | Inertia | Inertia tensor |
Quaternion
Quaternion
| Field | Type | Label | Description |
|---|---|---|---|
| x | double | ||
| y | double | ||
| z | double | ||
| w | double |
SE2Pose
SE2Pose
| Field | Type | Label | Description |
|---|---|---|---|
| position | Vec2 | (m) | |
| angle | double | (rad) |
SE2Velocity
SE2Velocity
| Field | Type | Label | Description |
|---|---|---|---|
| linear | Vec2 | (m/s) | |
| angular | double | (rad/s) |
SE3Pose
SE3Pose
| Field | Type | Label | Description |
|---|---|---|---|
| position | Vec3 | (m) | |
| quaternion | Quaternion | ||
| euler | EulerAngleZYX |
Vec2
Vec2
| Field | Type | Label | Description |
|---|---|---|---|
| x | double | ||
| y | double |
Vec3
Vec3
| Field | Type | Label | Description |
|---|---|---|---|
| x | double | ||
| y | double | ||
| z | double |
rb/api/gripper-command.proto
GripperInitializationRequest
GripperInitializationRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | Request header | |
| name | string |
GripperInitializationResponse
GripperInitializationResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader | Response header |
GripperMoveRequest
GripperMoveRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | Request header | |
| name | string | ||
| position | int32 | ||
| velocity | int32 | ||
| force | int32 |
GripperMoveResponse
GripperMoveResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader | Response header |
rb/api/gripper-command-service.proto
GripperCommandService
GripperCommandService
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
| GripperInitialization | GripperInitializationRequest | GripperInitializationResponse | |
| GripperMove | GripperMoveRequest | GripperMoveResponse | Joint command |
rb/api/head-command.proto
HeadCommand
HeadCommand
HeadCommand-Feedback
HeadCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback | ||
| joint-position-command-feedback | JointPositionCommand.Feedback |
HeadCommand-Request
HeadCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request | ||
| joint-position-command | JointPositionCommand.Request |
rb/api/header.proto
CommonError
CommonError
| Field | Type | Label | Description |
|---|---|---|---|
| code | CommonError.Code | Error code | |
| message | string | Human-readable error message |
RequestHeader
RequestHeader
Standard request header
| Field | Type | Label | Description |
|---|---|---|---|
| request-timestamp | google.protobuf.Timestamp | Client local system clock |
ResponseHeader
ResponseHeader
Standard response header
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | Echo | |
| request-received-timestamp | google.protobuf.Timestamp | Robot clock | |
| response-timestamp | google.protobuf.Timestamp | Robot clock | |
| error | CommonError | If set, there is error |
CommonError-Code
CommonError.Code
| Name | Number | Description |
|---|---|---|
| CODE-UNSPECIFIED | 0 | Code is not specified. |
| CODE-OK | 1 | Not an error. Request was successful. |
| CODE-INTERNAL-SERVER-ERROR | 2 | Service experienced an unexpected error state. |
| CODE-INVALID-REQUEST | 3 | Ill-formed request. Request arguments were not valid. |
rb/api/log.proto
GetLastLogRequest
GetLastLogRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | ||
| log-count | int32 |
GetLastLogResponse
GetLastLogResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader | ||
| logs | Log | repeated |
GetLogStreamRequest
GetLogStreamRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | ||
| update-rate | double | Hz |
GetLogStreamResponse
GetLogStreamResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader | ||
| logs | Log | repeated |
Log
Log
| Field | Type | Label | Description |
|---|---|---|---|
| timestamp | google.protobuf.Timestamp | ||
| robot-system-timestamp | google.protobuf.Timestamp | ||
| level | Log.Level | ||
| message | string |
SetLogLevelRequest
SetLogLevelRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | ||
| level | Log.Level |
SetLogLevelResponse
SetLogLevelResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader |
Log-Level
Log.Level
| Name | Number | Description |
|---|---|---|
| LEVEL-TRACE | 0 | |
| LEVEL-DEBUG | 1 | |
| LEVEL-INFO | 2 | |
| LEVEL-WARN | 3 | |
| LEVEL-ERROR | 4 | |
| LEVEL-CRITICAL | 5 |
rb/api/log-service.proto
LogService
LogService
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
| GetLastLog | GetLastLogRequest | GetLastLogResponse | |
| GetLogStream | GetLogStreamRequest | GetLogStreamResponse stream | |
| SetLogLevel | SetLogLevelRequest | SetLogLevelResponse |
rb/api/mobility-command.proto
MobilityCommand
MobilityCommand
MobilityCommand-Feedback
MobilityCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback | ||
| joint-velocity-command-feedback | JointVelocityCommand.Feedback | ||
| se2-velocity-command-feedback | SE2VelocityCommand.Feedback |
MobilityCommand-Request
MobilityCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request | ||
| joint-velocity-command | JointVelocityCommand.Request | ||
| se2-velocity-command | SE2VelocityCommand.Request |
rb/api/parameter.proto
GetParameterListRequest
GetParameterListRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader |
GetParameterListResponse
GetParameterListResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader | ||
| parameters | GetParameterListResponse.ParameterType | repeated |
GetParameterListResponse-ParameterType
GetParameterListResponse.ParameterType
| Field | Type | Label | Description |
|---|---|---|---|
| name | string | ||
| type | int32 | Type of parameter 0: int 1: double 2: std::string 3: std::array<double, 3> 4: std::array<double, 6> 5: std::array<double, 7> |
GetParameterRequest
GetParameterRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | ||
| name | string |
GetParameterResponse
GetParameterResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader | ||
| parameter | string |
ResetAllParametersToDefaultRequest
ResetAllParametersToDefaultRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader |
ResetAllParametersToDefaultResponse
ResetAllParametersToDefaultResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader |
ResetParameterToDefaultRequest
ResetParameterToDefaultRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | ||
| name | string |
ResetParameterToDefaultResponse
ResetParameterToDefaultResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader |
SetParameterRequest
SetParameterRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | ||
| name | string | ||
| parameter | string |
SetParameterResponse
SetParameterResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader |
rb/api/parameter-service.proto
ParameterService
ParameterService
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
| ResetAllParametersToDefault | ResetAllParametersToDefaultRequest | ResetAllParametersToDefaultResponse | |
| ResetParameterToDefault | ResetParameterToDefaultRequest | ResetParameterToDefaultResponse | |
| GetParameter | GetParameterRequest | GetParameterResponse | |
| SetParameter | SetParameterRequest | SetParameterResponse | |
| GetParameterList | GetParameterListRequest | GetParameterListResponse |
rb/api/ping.proto
PingRequest
PingRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader |
PingResponse
PingResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader |
rb/api/ping-service.proto
PingService
PingService
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
| Ping | PingRequest | PingResponse |
rb/api/power.proto
JointCommandRequest
JointCommandRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | Request header | |
| name | string | Motor ID | |
| command | JointCommandRequest.Command |
JointCommandResponse
JointCommandResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader | Response header | |
| status | JointCommandResponse.Status | ||
| message | string | Human-readable message for status |
PowerCommandRequest
PowerCommandRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | Request header | |
| name | string | Power ID | |
| command | PowerCommandRequest.Command |
PowerCommandResponse
PowerCommandResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader | Response header | |
| status | PowerCommandResponse.Status | ||
| message | string | Human-readable message for status |
ToolFlangePowerCommandRequest
ToolFlangePowerCommandRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | Request header | |
| name | string | Tool Flange name | |
| command | ToolFlangePowerCommandRequest.Command |
ToolFlangePowerCommandResponse
ToolFlangePowerCommandResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader | Response header |
JointCommandRequest-Command
JointCommandRequest.Command
Modes for joint/motor command
| Name | Number | Description |
|---|---|---|
| COMMAND-UNKNOWN | 0 | |
| COMMAND-SERVO-ON | 1 | |
| COMMAND-BRAKE-ENGAGE | 2 | |
| COMMAND-BRAKE-RELEASE | 3 | |
| COMMAND-HOME-OFFSET-RST | 4 |
JointCommandResponse-Status
JointCommandResponse.Status
| Name | Number | Description |
|---|---|---|
| STATUS-UNKNOWN | 0 | |
| STATUS-SUCCESS | 1 | |
| STATUS-INTERNAL-ERROR | 2 |
PowerCommandRequest-Command
PowerCommandRequest.Command
Power command
| Name | Number | Description |
|---|---|---|
| COMMAND-UNKNOWN | 0 | |
| COMMAND-POWER-ON | 1 | |
| COMMAND-POWER-OFF | 2 |
PowerCommandResponse-Status
PowerCommandResponse.Status
| Name | Number | Description |
|---|---|---|
| STATUS-UNKNOWN | 0 | |
| STATUS-SUCCESS | 1 | |
| STATUS-INTERNAL-ERROR | 2 |
ToolFlangePowerCommandRequest-Command
ToolFlangePowerCommandRequest.Command
| Name | Number | Description |
|---|---|---|
| COMMAND-UNKNOWN | 0 | |
| COMMAND-POWER-OFF | 1 | |
| COMMAND-POWER-12V | 2 | |
| COMMAND-POWER-24V | 3 |
rb/api/power-service.proto
PowerService
PowerService
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
| PowerCommand | PowerCommandRequest | PowerCommandResponse | Control power of the robot |
| JointCommand | JointCommandRequest | JointCommandResponse | Joint command |
| ToolFlangePowerCommand | ToolFlangePowerCommandRequest | ToolFlangePowerCommandResponse | Tool Flange |
rb/api/robot-command.proto
RobotCommand
RobotCommand
RobotCommand-Feedback
RobotCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback | ||
| whole-body-command-feedback | WholeBodyCommand.Feedback | ||
| component-based-command-feedback | ComponentBasedCommand.Feedback | ||
| jog-command-feedback | JogCommand.Feedback | ||
| status | RobotCommand.Feedback.Status | ||
| finish-code | RobotCommand.Feedback.FinishCode |
RobotCommand-Request
RobotCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request | ||
| whole-body-command | WholeBodyCommand.Request | ||
| component-based-command | ComponentBasedCommand.Request | ||
| jog-command | JogCommand.Request |
RobotCommandRequest
RobotCommandRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | ||
| robot-command | RobotCommand.Request | ||
| priority | int32 |
RobotCommandResponse
RobotCommandResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader | ||
| feedback | RobotCommand.Feedback |
RobotCommand-Feedback-FinishCode
RobotCommand.Feedback.FinishCode
| Name | Number | Description |
|---|---|---|
| FINISH-CODE-UNKNOWN | 0 | |
| FINISH-CODE-OK | 1 | |
| FINISH-CODE-CANCELED | 2 | |
| FINISH-CODE-PREEMPTED | 3 | |
| FINISH-CODE-INITIALIZED-FAILED | 4 | |
| FINISH-CODE-CONTROL-MANAGER-IDLE | 5 | |
| FINISH-CODE-CONTROL-MANAGER-FAULT | 6 | |
| FINISH-CODE-UNEXPECTED-STATE | 7 |
RobotCommand-Feedback-Status
RobotCommand.Feedback.Status
| Name | Number | Description |
|---|---|---|
| STATUS-IDLE | 0 | |
| STATUS-INITIALIZING | 1 | |
| STATUS-RUNNING | 2 | |
| STATUS-FINISHED | 3 |
rb/api/robot-command-service.proto
RobotCommandService
RobotCommandService
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
| RobotCommand | RobotCommandRequest | RobotCommandResponse | In case of sending and receiving a single command |
| RobotCommandStream | RobotCommandRequest stream | RobotCommandResponse stream | In case of sending and receiving commands continuously |
rb/api/robot-info.proto
BatteryInfo
BatteryInfo
EMOInfo
EMOInfo
| Field | Type | Label | Description |
|---|---|---|---|
| name | string |
GetRobotInfoRequest
GetRobotInfoRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader |
GetRobotInfoResponse
GetRobotInfoResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader | ||
| robot-info | RobotInfo |
GetRobotModelRequest
GetRobotModelRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader |
GetRobotModelResponse
GetRobotModelResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader | ||
| model | string |
ImportRobotModelRequest
ImportRobotModelRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | ||
| name | string | ||
| model | string |
ImportRobotModelResponse
ImportRobotModelResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader |
JointInfo
JointInfo
| Field | Type | Label | Description |
|---|---|---|---|
| name | string | ||
| has-brake | bool |
PowerInfo
PowerInfo
| Field | Type | Label | Description |
|---|---|---|---|
| name | string |
RobotInfo
RobotInfo
| Field | Type | Label | Description |
|---|---|---|---|
| robot-version | string | ||
| sdk-commit-id | string | ||
| battery-info | BatteryInfo | ||
| power-infos | PowerInfo | repeated | |
| emo-infos | EMOInfo | repeated | |
| degree-of-freedom | int32 | ||
| joint-infos | JointInfo | repeated | |
| mobility-joint-idx | uint32 | repeated | |
| body-joint-idx | uint32 | repeated | |
| head-joint-idx | uint32 | repeated |
rb/api/robot-info-service.proto
RobotInfoService
RobotInfoService
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
| GetRobotInfo | GetRobotInfoRequest | GetRobotInfoResponse | |
| GetRobotModel | GetRobotModelRequest | GetRobotModelResponse | |
| ImportRobotModel | ImportRobotModelRequest | ImportRobotModelResponse |
rb/api/robot-state.proto
BatteryState
BatteryState
| Field | Type | Label | Description |
|---|---|---|---|
| voltage | double | V | |
| current | double | Amp | |
| level-percent | double | % |
Collision
Collision
| Field | Type | Label | Description |
|---|---|---|---|
| link1 | string | ||
| link2 | string | ||
| position1 | Vec3 | ||
| position2 | Vec3 | ||
| distance | double |
EMOState
EMOState
| Field | Type | Label | Description |
|---|---|---|---|
| state | EMOState.State |
FTSensorData
FTSensorData
| Field | Type | Label | Description |
|---|---|---|---|
| time-since-last-update | google.protobuf.Duration | ||
| force | Vec3 | ||
| torque | Vec3 |
GetControlManagerStateRequest
GetControlManagerStateRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader |
GetControlManagerStateResponse
GetControlManagerStateResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader | ||
| control-manager-state | ControlManagerState |
GetRobotStateRequest
GetRobotStateRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader |
GetRobotStateResponse
GetRobotStateResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader | ||
| robot-state | RobotState | ||
| control-manager-state | ControlManagerState |
GetRobotStateStreamRequest
GetRobotStateStreamRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | ||
| update-rate | double | Hz |
GetRobotStateStreamResponse
GetRobotStateStreamResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader | ||
| robot-state | RobotState | ||
| control-manager-state | ControlManagerState |
JointState
JointState
| Field | Type | Label | Description |
|---|---|---|---|
| is-ready | bool | ||
| fet-state | JointState.FETState | ||
| run-state | JointState.RunState | ||
| init-state | JointState.InitializationState | ||
| motor-type | uint32 | MOTOR STATE | |
| motor-state | uint64 | ||
| time-since-last-update | google.protobuf.Duration | ||
| power-on | bool | ||
| position | double | ||
| velocity | double | ||
| current | double | ||
| torque | double | ||
| target-position | double | ||
| target-velocity | double | ||
| target-feedback-gain | uint32 | ||
| target-feedforward-torque | double |
PowerState
PowerState
| Field | Type | Label | Description |
|---|---|---|---|
| state | PowerState.State | ||
| voltage | double |
ResetOdometryRequest
ResetOdometryRequest
| Field | Type | Label | Description |
|---|---|---|---|
| request-header | RequestHeader | ||
| initial-pose | SE2Pose |
ResetOdometryResponse
ResetOdometryResponse
| Field | Type | Label | Description |
|---|---|---|---|
| response-header | ResponseHeader |
RobotState
RobotState
| Field | Type | Label | Description |
|---|---|---|---|
| timestamp | google.protobuf.Timestamp | ||
| system-stat | SystemStat | System Statistic | |
| battery-state | BatteryState | Battery State | |
| power-states | PowerState | repeated | Power State |
| emo-states | EMOState | repeated | EMO state |
| joint-states | JointState | repeated | Joint State |
| tool-flange-right | ToolFlangeState | Tool Flange State | |
| tool-flange-left | ToolFlangeState | ||
| ft-sensor-right | FTSensorData | Force Torque Sensor | |
| ft-sensor-left | FTSensorData | ||
| is-ready | double | repeated | |
| position | double | repeated | |
| velocity | double | repeated | |
| current | double | repeated | |
| torque | double | repeated | |
| target-position | double | repeated | |
| target-velocity | double | repeated | |
| target-feedback-gain | uint32 | repeated | |
| target-feedforward-torque | double | repeated | |
| odometry | SE2Pose | Mobility State | |
| center-of-mass | Vec3 | Center Of Mass(Position of center of mass with respect t base link) | |
| collisions | Collision | repeated | Collisions |
SystemStat
SystemStat
| Field | Type | Label | Description |
|---|---|---|---|
| cpu-usage | double | % | |
| memory-usage | double | % | |
| uptime | double | sec | |
| program-uptime | double | sec |
ToolFlangeState
ToolFlangeState
| Field | Type | Label | Description |
|---|---|---|---|
| time-since-last-update | google.protobuf.Duration | ||
| gyro | Vec3 | ||
| acceleration | Vec3 | ||
| switch-A | bool | ||
| output-voltage | int32 |
EMOState-State
EMOState.State
| Name | Number | Description |
|---|---|---|
| STATE-RELEASED | 0 | |
| STATE-PRESSED | 1 |
JointState-FETState
JointState.FETState
| Name | Number | Description |
|---|---|---|
| FET-STATE-UNKNOWN | 0 | |
| FET-STATE-ON | 1 | |
| FET-STATE-OFF | 2 |
JointState-InitializationState
JointState.InitializationState
| Name | Number | Description |
|---|---|---|
| INIT-STATE-UNKNOWN | 0 | |
| INIT-STATE-INITIALIZED | 1 | |
| INIT-STATE-UNINITIALIZED | 2 |
JointState-RunState
JointState.RunState
| Name | Number | Description |
|---|---|---|
| RUN-STATE-UNKNOWN | 0 | |
| RUN-STATE-CONTROL-ON | 1 | |
| RUN-STATE-CONTROL-OFF | 2 |
PowerState-State
PowerState.State
| Name | Number | Description |
|---|---|---|
| STATE-UNKNOWN | 0 | |
| STATE-POWER-ON | 1 | |
| STATE-POWER-OFF | 2 |
rb/api/robot-state-service.proto
RobotStateService
RobotStateService
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
| GetRobotState | GetRobotStateRequest | GetRobotStateResponse | |
| GetRobotStateStream | GetRobotStateStreamRequest | GetRobotStateStreamResponse stream | |
| GetControlManagerState | GetControlManagerStateRequest | GetControlManagerStateResponse | |
| ResetOdometry | ResetOdometryRequest | ResetOdometryResponse |
rb/api/torso-command.proto
TorsoCommand
TorsoCommand
TorsoCommand-Feedback
TorsoCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback | ||
| joint-position-command-feedback | JointPositionCommand.Feedback | ||
| gravity-compensation-command-feedback | GravityCompensationCommand.Feedback | ||
| cartesian-command-feedback | CartesianCommand.Feedback | ||
| impedance-control-command-feedback | ImpedanceControlCommand.Feedback | ||
| optimal-control-command-feedback | OptimalControlCommand.Feedback |
TorsoCommand-Request
TorsoCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request | ||
| joint-position-command | JointPositionCommand.Request | ||
| gravity-compensation-command | GravityCompensationCommand.Request | ||
| cartesian-command | CartesianCommand.Request | ||
| impedance-control-command | ImpedanceControlCommand.Request | ||
| optimal-control-command | OptimalControlCommand.Request |
rb/api/whole-body-command.proto
WholeBodyCommand
WholeBodyCommand
WholeBodyCommand-Feedback
WholeBodyCommand.Feedback
| Field | Type | Label | Description |
|---|---|---|---|
| command-header-feedback | CommandHeader.Feedback | ||
| stop-command-feedback | StopCommand.Feedback | ||
| real-time-control-command-feedback | RealTimeControlCommand.Feedback |
WholeBodyCommand-Request
WholeBodyCommand.Request
| Field | Type | Label | Description |
|---|---|---|---|
| command-header | CommandHeader.Request | ||
| stop-command | StopCommand.Request | ||
| real-time-control-command | RealTimeControlCommand.Request |
