项目>宇树 Go2>买之前确认二开边界:电气接口、SDK 适用型号与软件版本分界

买之前确认二开边界:电气接口、SDK 适用型号与软件版本分界

摘要:逐条确认 Pro 与 Air 不支持任何电气接口、英文官方页写明这些接口为 EDU 独占、官方 SDK 开发指南只适用于 Go2 Edu 型号且按软件版本分两套接口,知道 X 的「基础支持」不能自行推断等同于 EDU。

为什么这一页要在下单前读

官网产品页给二次开发只留了四个符号 ○ ○ ◕ ●,看不出「○」到底不能做什么。玩家最容易踩的坑,是默认买回来的 Go2 都能接自己的设备、都能照一份通用 SDK 教程往下做,付了钱才发现型号不对。文档中心、官方 SDK 开发指南和条款页把边界写得很具体。下面按确认顺序逐条走,走完就知道自己那台机器能二开到哪一层、哪些结论必须回到官方手册。

逐条确认二开边界

按下面顺序走,每一步都给出按什么确认、确认完手里多了什么。

  1. 确认型号有没有电气接口:读文档中心逐字硬边界「Go2 Pro、Air 版本不支持使用任何电气接口如 SBUS、DC28.8V 以及以太网接口」。AIR、PRO 不开放这几个接口;英文官方页「These interfaces are exclusive to the Go2 EDU version」出自搜索索引快照,只作旁证,正式逐字引用以中文文档中心这句为主。确认完手里多的是一句能直接否掉「买 AIR 或 PRO 接设备」的判断。
  2. 把三个电气接口的定义对上号:电源接口、以太网接口、SBUS 接口各自是什么、供电怎么算,逐行看下面第 2 步的表,别把 SBUS 当电源口。
  3. 把官网符号和文档中心措辞两列并排读,不互相翻译替代:官网「○ ○ ◕ ●」是符号,文档中心「无 / 无 / 基础支持 / 支持」是文字口径,两列都留着,不要写成「○ 等于无」,见下面第 3 步的表。
  4. 认 X 的「基础支持」到哪一层:文档中心只写「基础支持」,没有给出等同于 EDU 的说明,X 这一档能做什么要回官方手册确认,不能自行推断它和 EDU 一样。
  5. 确认官方 SDK 开发指南面向哪个型号、按哪个软件版本分:逐字适用范围见下面第 5 步的引用,它是 Go2 Edu 型号专属,且分两套接口,不能当成 Go2 全系通用 SDK 教程,更不能把适用于 Edu 的接口描述套到 AIR、PRO、X 上。
  6. 把「能做什么」交回官方手册:文档中心脚注写「详细功能,请查看二次开发手册」和「更详细保修条款,请参见产品保修手册」;官方客服中心开发指南下另有 Go2 42 条开发条目。结论一律回手册与条款,不靠四个符号猜,见下面第 6 步的表。
  7. 最后读一遍停手线:官方警示「本产品为民用机器人产品,请各位用户不要危险性改造和使用机器人」,条款写「在质保期内,未经宇树科技允许,发生私自改造、拆装、开壳等行为,质保期将直接失效」。想动接口、动内部之前,先确认这一步会不会踩到质保边界;本 wiki 不写任何拆机、开壳、换核心模组的操作步骤。

第 2 步 · 三个电气接口的官方定义

接口 官方定义
电源接口 DC 28.8V 输出,连接 Orin NX 8/16GB 高算力模组 BAT 输入
以太网接口 标准 RJ45,连接 User PC / Orin NX 8/16GB
SBUS 接口 用于通用遥控器上的通讯连接,不提供电源输出,定义(从左往右)NC / GND / SBUS

三行都是文档中心逐字定义。电源口标的是 DC 28.8V 输出,以太网口是标准 RJ45,SBUS 只做遥控器通讯、不提供电源输出,引脚是 NC / GND / SBUS。第 1 步那句硬边界里的 SBUS、DC28.8V、以太网接口,对应的就是这三项。

第 3 步 · 官网符号与文档中心措辞两列并列

版本 官网产品页「二次开发」 文档中心「二次开发」
AIR ○ 无
PRO ○ 无
X ◕ 基础支持
EDU ● 支持

两列都是官方口径,分行并列摆着,不合并成一句、不互相翻译替代。官网四个符号看不出「○」具体不能做什么,能落到操作层面的,是第 1 步那句电气接口硬边界和第 5 步的 SDK 适用范围。

第 5 步 · 官方 SDK 开发指南的逐字适用范围

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

这段声明写在官方《Go2 SDK 开发指南》开头,给出的是两套接口:Go2 Edu 且软件版本低于 V1.1.6 的,用本文档的接口描述;软件版本为 V1.1.6 及以上的,转《运控服务接口 V2.0》。两条都只面向 Go2 Edu 型号。这是按型号加按软件版本找文档的依据,不能改写成一份 Go2 通用 SDK 教程,也不能把 Edu 的接口描述套到 AIR、PRO、X 上。英文版 AI 运动服务页有同类声明,写明适用于 Go2 Edu 型号、要求软件版本低于 V1.1.6,可作同一口径的旁证。

两套接口怎么按自己的机器对号

这段适用范围只用来找该看哪份文档,不写成接口教程。先确认机型:机型并非 Go2 Edu 时,这份 SDK 指南的接口描述和《运控服务接口 V2.0》都套不上,别照着往下做,回到第 1 步的电气接口硬边界看这台机器能做什么。机型是 Go2 Edu,再看机器当前的 Go2 软件版本:低于 V1.1.6 看本文档的接口描述,V1.1.6 及以上转《运控服务接口 V2.0》。软件版本以机器上实际显示的为准,本页不写查询步骤;按型号加按版本对好号,才知道该打开哪一份官方手册,也才知道 X 的「基础支持」要不要再回手册确认。

第 6 步 · 官方开发指南里与二开相关的条目

官方客服中心「Development Guidelines → Go2」列了 42 条开发相关条目,和这一页要确认的边界直接相关的分成几组:

条目分组 与二开边界相关的例子
连接与开发方式 板载 IP / 用户名 / 密码、能否无线开发、外接设备、连接方式、内部设备拓扑
电气与拓展 电源接口开发、拓展坞 NX 固件更新 / 恢复系统 / 无响应
遥控器与总线 SBUS 自定义遥控器、拓展坞配置
感知与导航 L1 / L2 雷达位置与点云坐标系、SLAM 接口与配置参数、D435i 的 URDF、相机内外参
运动控制 FSM 模式切换、sportmode 关闭后能否取速度、抬腿高度、IMU 位置、运动模式速度

这些是官方帮助条目的标题,逐条正文以官方页面为准。文档中心脚注把「详细功能,请查看二次开发手册」和「更详细保修条款,请参见产品保修手册」单独列出,意思很明确:某个接口能不能用、怎么用,答案在手册里,不在这四个符号里。X 的「基础支持」要做哪些事、做到什么程度,同样回手册确认,本页不替官方下结论。

核完的结果

核完的结果为:手里有四条能直接用的结论。AIR、PRO 不支持任何电气接口,别指望接 SBUS、DC 28.8V 或 RJ45;三个电气接口各自的定义和供电口径以文档中心表为准;官网符号与文档中心措辞是两套并列口径,X 的「基础支持」不推断等同 EDU;官方 SDK 开发指南只适用 Go2 Edu 型号,按低于 V1.1.6 与 V1.1.6 及以上分两套接口,AIR、PRO、X 套不上。

预期结果是:下单前就能否掉「买低配照样能二开」这个假设,或确认自己要的就是不接设备、只玩现成功能。具体某个接口怎么接、某个服务怎么调,官方把答案放在《二次开发手册》与《运控服务接口 V2.0》里。这一页给的是该不该往下看、该看哪一套的判断,结论一律回到官方手册,不靠四个符号猜。想按软件版本找开发入口翻 100 页,想核对官方口径互相打架的地方翻 120 页,想读失保条款翻 50 页。

资料来源

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