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