题果果 R3｜协作接口约定与交付边界
2026-11-18；状态：建议实现接口，尚未与真机联调，不是已可烧录固件。

一、硬件职责
果核：立创实战派 ESP32-S3；同一果核离座控制手机/电脑，上车接收已配对手机的遥控输入。
CM5：本地运行唯一运动指令转发程序，使用原厂 xgolib 对应版本。原厂内部 UART 不加接第二个主机。
车内 ESP32：保持原厂实时姿态/运动闭环、原电池/电机/轮腿。
实时平衡不依赖手机、BLE、Wi-Fi、LLM 或互联网。

二、果核到 CM5 的候选文本帧（仅示意，不是原厂线协议）
每行一个 JSON，不带隐含单位：
{"schema":"tgg.motion.v1","session":"new-physical-arm-session","source_seq":123,"enabled":true,"vx_mps":0.10,"yaw_dps":0,"ttl_ms":300}
实际协议须约定最大帧长、校验方法、版本兼容、配对权限与错误码。
任一未知版本/非数值/超范围/过长帧/错误会话/重复或乱序源序号均拒收，不续期。
CM5 用单调时钟跟踪最后新鲜源命令；不得用转发进程不断重复旧帧维持租约。
BLE 重连和 USB 重启生成新会话，必须操作员在静止状态重新使能，不能沿用上次速度。
校验只能处理损坏，不能代替身份认证。先验证绑定设备，不允许网络任意主机直接发送底盘命令。
首样速度建议上限 0.10 m/s，偏航 20 度/s；具体映射由原厂版本和实测确定，不把 API 范围当物理单位保证。

三、状态回报
建议包含 session、ack_source_seq、mode、fault、battery、pitch_deg 与 telemetry_age_ms。
收到了指令、已向 UART 写入、实际已停是三种不同状态，不能合并成 success。
超时（手机/BLE/果核）：CM5 在末次有效源命令后 300 ms 内请求前进与转向双零，保持自平衡。
CM5 崩溃/内部 UART 断：必须独立证实下位机的命令失效处理；用同一进程的 finally 不是独立保护。
任何失联恢复后都保持锁止；误动作、倾倒、低电量或复位后先人工检查。

四、硬件连接与供电
USB 通路：果核原 Type-C 设备端 → 短数据线 → 原厂 Hub → CM5 用户 USB 主机口。
检查 CH340K 驱动、枚举、收发、端口是否对外供电、最坏工况压降和插拔复位。不能推断所有 Type-C 都有数据和足够供电。
禁止双电源 VBUS 硬并联、直接从动力电池取电给果核、让 USB 插头承担果核重量。
未有机械在位传感器，不能声称“仅凭拔出托座就能自动判定离座”。必须先停止并撤销使能，再取下并断开车载数据线。

五、网页和下载
网页控制预演从不连接真实底盘；没有 BLE/WebUSB 控制、云端遥控 API 或录音上传。
验收记录仅存当前浏览器；分享步骤链接不会同步验收记录，也不会上传本机备注。
R3工程资料包是评审和测量资料，不含生产放行的 CAD、已实现的桥接固件、原厂商标授权或量产证明。
原PDF「控制连接与稳定性选型-R2」作为方案基线留存其版本名；其数值门槛仍属于目标值。
网站参考 Digimals XGO-Duck Parts 的组织方式；不复制其查看器、模型、页面图片或装配视频。
采购原板与原车仅是样机实施路线，不等于允许复制第三方硬件、固件、SDK 或以自身品牌批量销售。
