项目>宇树 Go2>按型号找到官方开发入口:SDK 指南十九个接口与八个例程

按型号找到官方开发入口:SDK 指南十九个接口与八个例程

摘要:按官方 Go2 SDK 开发指南的目录认清 SDK 概述、架构说明、应用开发、十九个软件服务接口、八个例程与调试 FAQ,并原样保留「适用于 Go2 Edu 型号、软件版本小于 V1.1.6 与大于等于 V1.1.6 两套接口」的适用范围声明。

先按型号和软件版本定入口,再看目录

官方《Go2 SDK 开发指南》只面向特定型号与软件版本,不能当作对四个版本通用的 SDK 教程。找开发入口的第一步,是先确认自己机器的型号与软件版本,再决定该翻哪一套接口文档;把适用于 Edu 的接口描述直接套到 AIR、PRO、X 上,是这一页最想帮读者避开的错。本页只做目录与边界的核对,不含具体调用、参数与动手操作步骤。指南页面标注的更新时间为 2025-11-21 11:19:46,目录结构下面按官方原文逐项列出。

适用范围声明是整份指南的硬边界,原样保留。

本文档接口描述适用于 Go2 Edu 型号,要求 Go2 软件版本低于 V1.1.6;若您的软件版本为 V1.1.6 及以上,请参考《运控服务接口 V2.0》。

如有其他疑问,欢迎联系官方技术支持。

两套接口必须分开看

声明把读者分成两条路,两条都要留在页面上,不能合并成一句「Go2 SDK 怎么用」。

软件版本 该看的官方接口 不要做的事
低于 V1.1.6 本指南的软件服务接口与例程,含高层运动服务接口等 19 个接口、8 个例程 不要把这一套接口描述当成 AIR、PRO、X 的通用教程
V1.1.6 及以上 《运控服务接口 V2.0》 不要沿用低版本接口的调用口径去套高版本机器

「软件服务接口」19 项里的第一项正是《运控服务接口 V2.0》,与声明里让高版本读者去看的是同一份;低版本读者看同目录其余接口与高层运动接口。型号边界同样写在前头:文档中心中文页写明 Go2 Pro、Air 版本不支持使用任何电气接口如 SBUS、DC28.8V 以及以太网接口,即 AIR/PRO 无电气接口、EDU 独占;英文官方页另有「These interfaces are exclusive to the Go2 EDU version」一类独占句,但该页通过搜索索引快照取得,只作旁证,正式逐字口径仍以中文文档中心与官网产品页为准。X 的「基础支持」不得自行推断等同于 EDU。把型号边界和版本声明合起来,才不会把只面向 Go2 Edu 的接口写成四版本通用教程。

指南目录:先认清结构,再按图找页

官方目录按六段组织,下面把分组与条目数逐项列出。接口与例程数量固定,便于读者核对自己有没有漏看某一项。

目录分组 条目数 说明
SDK 概述 3 概述类条目
架构说明 机器狗服务 8 及 9 类服务 分组见下方列表
应用开发 7 获取 SDK、快速开始、创建客户应用、App 绑定、附加设备、拓展坞配置、带屏遥控器配套说明
软件服务接口 19 逐项见下方接口表
例程参考 8 逐项见下方例程表
调试说明与 FAQ — 调试说明、FAQ

架构说明这一段的分组

  • 机器狗服务(8)
  • 底层服务
  • 运动服务
  • DDS 中间件
  • 图像服务
  • 网络服务
  • UWB 服务
  • LiDAR 服务
  • SLAM 服务
  • 故障

应用开发 7 项

序号 条目
1 获取 SDK
2 快速开始
3 创建客户应用
4 App 绑定
5 附加设备
6 拓展坞配置
7 带屏遥控器配套说明

软件服务接口 19 个

下面按官方目录顺序列全 19 个接口名称。前两项是运控与通信底座,中间覆盖运动、感知、状态、导航与外设,末尾含 ROS2 服务接口与 Python 服务接口;读者据此确认自己要找的功能在官方叫什么名字,再回官方文档读正文。

序号 软件服务接口名称
1 运控服务接口 V2.0
2 DDS 通信接口
3 避障服务接口
4 音量灯光服务接口
5 设备状态服务接口
6 运控切换服务接口
7 高层运动服务接口
8 AI 运动服务接口
9 底层服务接口
10 LiDAR 服务接口
11 多媒体服务接口
12 UWB 服务接口
13 故障服务接口
14 SLAM 导航服务接口
15 二维码回充服务
16 里程计服务接口
17 D1 机械臂服务接口
18 ROS2 服务接口
19 Python 服务接口

例程参考 8 个

序号 例程名称
1 DDS 通信例程
2 高层运动控制
3 底层运动控制-腿部摆动
4 底层运动控制-调试框架
5 灯光控制例程
6 获取遥控器状态
7 RL 控制例程
8 读取电机异常例程

高层运动接口锚点:只当入口地图,不写越界教程

指南「高层运动服务接口」一页给出的下列名称,本页只作官方开发入口地图上的锚点,用来核对「自己要找的功能在官方目录里叫什么」。具体调用、参数与返回值一律回到官方文档,本页不展开成操作教程。

锚点 官方目录里的定位
Damp 阻尼急停,官方标注为最高优先级
BalanceStand 平衡站立
StopMove 停止移动
StandUp 起立,默认站立高度 0.33m
StandDown 趴下
RecoveryStand 翻身恢复站立
Euler 姿态控制类锚点
Move 速度控制类锚点
SwitchGait 步态切换类锚点
BodyHeight 机身高度类锚点
FootRaiseHeight 抬足高度类锚点
SpeedLevel 速度档类锚点
TrajectoryFollow 轨迹跟随类锚点
GetState 状态获取类锚点
错误码 4101 / 4201 / 4205 / 4206 / 3104
高层状态话题 rt/sportmodestate,含足端力与 IMU 四元数、陀螺、加速度、rpy、温度

落点:环境与官方入口不止一处

官方 unitree_sdk2 仓库 README 给出的构建环境要求,可作为准备开发环境时的核对项;这一套要求写在该仓库自述里,但「能不能用这些接口」仍受前面的型号与软件版本声明约束。

环境项 官方要求
操作系统 Ubuntu 20.04 LTS
CPU 架构 aarch64 与 x86_64
CMake 3.10 及以上
GCC 9.4.0
构建工具 Make;README 另列依赖安装与 build examples 说明

除了这份 SDK 指南,官方客服中心还设有「开发指南 Go2」分组,含板载 IP 与用户名密码、能否无线开发、外接设备、电源接口开发、SBUS 自定义遥控器、L1 与 L2 雷达位置与点云坐标系、SLAM 接口与常见错误、运动模式速度、底层控制电机抖动、二开视频教程等条目。读者在指南里找不到某一项时,可按条目名回到客服中心检索;本页不替官方补全这些条目的具体结论。

核完手里多了什么

  1. 确认自己机器的型号是不是 Go2 Edu;不是 Edu 时,把 AIR、PRO、X 的电气接口与二开边界结论翻到「买之前确认二开边界」那一页核对,不把本指南接口套上去。
  2. 确认机器软件版本落在「低于 V1.1.6」还是「V1.1.6 及以上」,据此选定该看的那一套接口文档。
  3. 按 19 个软件服务接口与 8 个例程的目录,找到自己要做的那一项在官方叫什么名字,再回官方文档读正文。
  4. 准备开发环境时按 Ubuntu 20.04、CMake 3.10 及以上、GCC 9.4.0 逐项核对。

核完的结果:手里有一张明确的「我的型号、我的版本、该翻哪一套接口、按哪个环境准备」的对照;本页始终不写成对四版本通用的 SDK 教程。

资料来源

  • 宇树官方 Go2 SDK 开发指南
  • 宇树官方文档中心 Go2 产品列表
  • 宇树官方客服中心帮助页
  • 证据包校准条目