题果果 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 或以自身品牌批量销售。