Skip to content

传感器实时上报接口 ​

返回软件服务接口 | 控制指令接口

接口说明 ​

传感器实时上报接口用于接收机器人本体状态,对应红框中的“传感器实时上报端口”。机器人通过 UDP 接收端口 8080 向 SDK 上报状态,SDK 在接收线程中解析并缓存最近一次数据,应用程序通过查询函数读取缓存。

读取状态前应先检查 IsConnected()。状态读取函数通常不会主动触发新的网络请求,数据是否最新取决于机器人上报周期和应用读取时间。

通信参数 ​

参数默认值
机器人 IP192.168.234.1
SDK 接收端口8080
传输协议UDP
消息格式JSON

上报消息类型 ​

消息类型对应内容常用 SDK 函数
dog_state电量、温度、设备名、WiFi SSID、序列号、型号等基础信息GetPower()、GetTemperature()、GetSn()、GetDevName()、GetWifiSsid()、GetModel()
version运控版本和任务版本GetVersion()
speed_set当前速度等级GetSpeedLevel()
feedback功能模式、控制模式、运动模式、运动类型和电机温度GetFunctionMode()、GetControlMode()、GetMotionMode()、GetMotionType()、GetMotorTemp()
imu_info四元数、RPY、机体加速度和机体角速度GetQuaternion()、GetRPY()、GetBodyAcc()、GetBodyGyro()
odom_info位置、世界速度和机体速度GetPosition()、GetWorldVelocity()、GetBodyVelocity()
leg_joint_info4 条腿的角度、角速度和力矩GetLeg*Joint()、GetLeg*JointVel()、GetLeg*JointTorque()
dev_info电池电压、电流、温度、电量和错误码GetBatteryInfo()

获取基础信息 ​

函数函数原型返回内容
GetPoweruint32_t GetPower() const电量百分比
GetTemperaturefloat32_t GetTemperature() const设备温度,单位 °C
GetSnstd::string GetSn() const设备序列号
GetDevNamestd::string GetDevName() const设备名称
GetWifiSsidstd::string GetWifiSsid() const当前 WiFi SSID
GetVersionVersionInfo GetVersion() const运控版本和任务版本
GetModelModel GetModel() const当前机型枚举

相关数据类型 ​

VersionInfo ​

字段类型说明
mc_versionstring运控版本
dog_task_versionstring任务版本

Model ​

枚举值值说明
MODEL_XG0小狗点足
MODEL_XGW1小狗轮足
MODEL_XGWHSPD2小狗高速轮足

获取速度和模式 ​

函数函数原型返回内容
GetSpeedSpeedInfo GetSpeed() const前后速度、角速度、左右速度、头部角度
GetSpeedLevelSpeedLevel GetSpeedLevel() const慢速、正常或快速
GetFunctionModeFunctionMode GetFunctionMode() const遥控、追踪、SDK 或通用 SDK 模式
GetControlModeControlMode GetControlMode() const站立、趴下、锁定、移动、平衡站立等状态
GetMotionModeMotionMode GetMotionMode() const特技动作是否执行、休息或禁止
GetMotionTypeMotionType GetMotionType() const当前特技动作类型

相关数据类型 ​

SpeedInfo ​

字段类型说明
speedfloat32_t前后速度
angle_speedfloat32_t角速度
shift_speedfloat32_t左右速度
anglefloat32_t头部角度

SpeedLevel ​

枚举值值说明
SL_NULL0无效值
SL_SLOW1慢速
SL_NORMAL2正常速度
SL_FAST3快速

FunctionMode ​

枚举值值说明
FM_NULL0无效值
FM_REMOTE1遥控模式
FM_TRACE2追踪模式
FM_SDK3SDK 模式
FM_GENERAL_SDK4通用 SDK 模式

ControlMode ​

枚举值值说明
CM_NULL0无效值
CM_STAND_UP1站立
CM_SIT_DOWN2趴下
CM_LOCK_MODE3锁定模式
CM_EMERGENCY_STOP4紧急停止
CM_MOVE_MODE5移动模式
CM_BALANCE_STAND_MODE6平衡站立模式
CM_INIT7初始化

MotionMode ​

枚举值值说明
MM_NULL0无效值
MM_RUNNING1执行中(在进行特技动作)
MM_REST2休息(未进行特技动作)
MM_FORBID3禁止(不在实验室模式)

MotionType ​

枚举值值说明
MT_NULL0无效值
MT_JUMP1跳跃
MT_FORWARD_JUMP2前跳
MT_BACK_FLIP3后空翻
MT_GREET4招手
MT_TWO_LEG_STAND5双腿站立
MT_FORBID6禁止(未开启狂暴模式)
MT_UNKNOWN7未知(未进行特技动作)
MT_UNLOADING_SQUAT8卸货下蹲

获取 IMU 和姿态数据 ​

函数返回类型及内容
GetQuaternion()std::array<float32_t, 4>,四元数 [w, x, y, z]
GetRPY()std::array<float32_t, 3>,滚转、俯仰、偏航,单位为弧度
GetBodyAcc()std::array<float32_t, 3>,机体坐标系加速度,单位 m/s²
GetBodyGyro()std::array<float32_t, 3>,机体坐标系角速度,单位 rad/s

获取里程计数据 ​

函数返回类型及内容
GetPosition()std::array<float32_t, 3>,世界坐标系位置,单位 m
GetWorldVelocity()std::array<float32_t, 3>,世界坐标系速度,单位 m/s
GetBodyVelocity()std::array<float32_t, 3>,机体坐标系速度,单位 m/s

获取电机和关节数据 ​

数据函数
电机温度GetMotorTemp(),返回 16 个电机温度
髋外展关节角度 / 角速度 / 力矩GetLegAbadJoint() / GetLegAbadJointVel() / GetLegAbadJointTorque()
髋关节角度 / 角速度 / 力矩GetLegHipJoint() / GetLegHipJointVel() / GetLegHipJointTorque()
膝关节角度 / 角速度 / 力矩GetLegKneeJoint() / GetLegKneeJointVel() / GetLegKneeJointTorque()
足端关节角度 / 角速度 / 力矩GetLegFootJoint() / GetLegFootJointVel() / GetLegFootJointTorque()

每个关节函数返回 std::array<float32_t, 4>,数组顺序为:

text
[左前腿, 右前腿, 左后腿, 右后腿]

每条腿的关节名称为 abad、hip、knee、foot。角度单位为 rad,角速度单位为 rad/s,力矩单位为 N·m。

获取电池信息 ​

字段内容
函数名GetBatteryInfo
函数原型BatteryInfo GetBatteryInfo() const
功能概述读取电池详细状态
参数无
返回值current:电流;error:电池错误码;power:电量百分比;temp:温度;volt:电压
备注单位和具体安全阈值以 BatteryInfo 定义及实际硬件规格为准

BatteryInfo 结构体 ​

字段类型说明
currentfloat32_t电流 (A)
errorint32_t错误码
powerint32_t电量百分比
tempfloat32_t温度 (°C)
voltfloat32_t电压 (V)

使用注意事项 ​

  • 状态数据是最近一次上报的缓存,不保证每次调用都触发新的网络接收。
  • 使用姿态、速度和关节数据参与控制时,应检查连接状态、数据时间和数据是否处于合理范围。
  • 机型不同,传感器、轮毂电机和上装状态可能不同,应用应先读取 GetModel() 再启用对应功能。
  • 电机温度、电池状态和故障信息应在运动前和运行过程中持续检查。