跨模块数据契约把 TC264 智能车当成“多子系统接口”来读单点精读讲函数本篇讲模块之间传了什么全局量、谁写谁读、在哪个节拍上生效。多元素任务节拍 / 标志位 / 图像 duty / GPS 角差 / PID / 执行器 / Flash。仓库https://github.com/shuifanyu/TC264-GPS-Vision-Car目录为什么要读“接口”全局变量清单真实符号时序图一拍系统里发生什么契约 A菜单 ↔ 控制契约 BIMU ↔ GPS 导航契约 C视觉 ↔ 舵机契约 DGPS 存储 ↔ Follow_track契约 EPID ↔ 执行器量纲Flash 作为持久接口故障注入契约被破坏时会怎样接口表建议写进文档重构方向保持可赛如何用本方法读你自己的车小结1. 为什么要读“接口”竞赛工程常见现象每个.c单独看都“差不多”联调时玄学有时转向对、有时反存了航点却乱跑根因往往是隐式接口谁定义变量 谁在 ISR 写 谁在主循环写 单位是什么 更新频率多少 上电默认值是否安全把仓库当成系统集成问题精读质量会再上一档。2. 全局变量清单真实符号2.1 模式与标志符号定义位置约写读IMU_1_Open_flagIMU_1.c菜单isr imuG_navigation_flagIMU_1.c菜单isr 导航I_navigation_flagIMU_1.c菜单isr 导航Key_close_flagCommon_Peripherals.c业务/菜单isr key_scanmt9v03x_finish_flag采集驱动摄像头完成Image.cgnss_flagGNSS 驱动串口/驱动GPS_parse2.2 感知结果符号写读单位/域gnss.latitude/longitudeparse采点、Follow_track度gnss.direction等parse显示视驱动angle_lightimu()Follow_track±180°Angle_zimu()显示0~360°mid_line_list[]Find_Mid_Linesteering_image像素image_steering_dutysteering_image舵机待接duty 约 56~96Azimuth/Distance/Nomal_ErrorFollow_trackPID/显示° / 距离单位LAT_OUT_x/LOG_OUT_xflash_outputFollow_track度N_1/N_2/N_3Follow_track速度查表航点序号2.3 执行与人机符号写读func_indexMenu 键处理Menu 绘制key1_flag...key_scanMenu / Steer_text 等I_PID / G_PID应初始化/菜单PidLocCtrlPWM/DIR 寄存器Steer_set / BLDC_ctrl硬件3. 时序图一拍系统里发生什么时间轴示意 ├─ UART RX ──► gnss_flag1 ├─ CCU60_CH0 20ms ──► [IMU_1_Open_flag?] imu() → angle_light ├─ CCU60_CH1 5ms ──► [Key_close_flag0?] key_scan() → keyN_flag ├─ CCU61_CH0 5ms ──► [G_flag?] G_navigation/Follow_track │ └─► [I_flag?] I_navigation └─ main loop ──────► GPS_parse() 若 gnss_flag └─► Menu() 读 key flag改 func_index / flags └─► 页面函数可能采点/Flash/Steer_text关键推论推论含义控制不依赖 main 独占菜单卡顿不直接杀周期导航flags 是唯一模式入口菜单不直接调 Follow_track 也行多写者风险同一执行器可能被菜单测试页与导航 ISR 同时写延迟阶梯IMU 20ms → 导航 5ms 读到旧 angle_light4. 契约 A菜单 ↔ 控制接口菜单 → IMU_1_Open_flag / G_navigation_flag / I_navigation_flag 菜单 → Key_close_flag 菜单 → GPS_flash_input/output / 采点函数 控制 ← 只通过 flags 全局数据合同条款示例条款约定现状默认安全上电 flags0执行器不动✔ 定义为 0互斥同时只开一种导航✘ 两 flag 可同时为 1单一写者只有菜单改 flags基本成立可观测屏显当前 flags部分页面有故障模式G1 且 I1 → 5ms 里两个导航函数都跑 → 两次写舵机/速度后者覆盖前者行为抖修复合同voidset_nav_mode(intmode)/* 0 idle, 1 GPS, 2 IMU */{G_navigation_flag(mode1);I_navigation_flag(mode2);}5. 契约 BIMU ↔ GPS 导航数据接口imu() 输出 angle_light Follow_track 输入 angle_light 输出 Nomal_Error wrap(Azimuth - angle_light)合同条款条款要求域两侧都在 ±180或都 wrap 后再比符号航向增加方向与车头基准一致单位度不是 rad更新率IMU 周期已知导航可读阶梯值有效性IMU 未开时不应使用陈旧 angle_light 做闭环现状风险详深度06dt 与 PIT 可能不一致零偏/滤波状态问题导致 angle_light 不可信角差公式与发车方向偏置注释耦合建议的显式结构typedefstruct{floatheading_deg;/* ±180 */uint32_tstamp_ms;uint8_tvalid;}HeadingSample;HeadingSampleheading_get(void);导航侧检查valid与stamp年龄。6. 契约 C视觉 ↔ 舵机数据接口Find_Mid_Line → mid_line_list[] steering_image → image_steering_duty Steer_set(angle) / pwm_set_duty(...)量纲契约阶段量中线像素 0~187duty 公式96 - (mid/188)*40 →5696Steer_set角度域另有 LMAX/RMAXPWM 驱动比较值当前缺口image_steering_duty命名像 dutySteer_set吃 angle二者无统一转换层。联调时必须在某处写清voidvision_apply(void){/* 方案1duty 直接 pwm *//* 方案2angle map(duty); Steer_set(angle); */}模式契约视觉模式与 GPS 导航不得同时写舵机。现状mt9v03x_init在 main 里被注释暗示摄像头并非默认模式——要在菜单里统一。7. 契约 DGPS 存储 ↔ Follow_track接口流水线采点gnss → LAT_data_x[Index_x] 保存LAT_data → int32×1e7 → flash page 执行flash → LAT_OUT_x → [N_x] 当前目标合同条款条款约定双缓冲data编辑与 OUT跟踪分离 ✔页映射科目1 page112→103→9有效点数跟踪 N_x 应 有效点数精度1e7 定标擦写先 erase 再 write ✔现状缺口缺口后果无独立valid_count_out读 20 点、跟踪越界无校验和Flash 脏数据当航点N_x 与 Index_x 生命周期采点后未 output 则 OUT 仍旧建议接口typedefstruct{doublelat[16],lon[16];intcount;uint16_tcrc;}Route;introute_save(intsub,constRoute*r);introute_load(intsub,Route*r);/* 0ok */8. 契约 EPID ↔ 执行器量纲期望链条e 度 / 像素 → PID.out 任意“控制量” → 映射层 → Steer_set(angle) 或 pwm_set_duty(duty) → 机械现状算法输出执行接口映射PidLocCtrl.out未稳定接 Steer缺BLDC_ctrl(4500)PWM duty 直接硬编码image_steering_duty疑似 duty与 Steer 角度不一致合同必须写明PID out 的单位是什么 output_limits 与 SERVO_MOTOR_MID 的关系 正输出对应左舵还是右舵否则“参数怎么调都不对”其实是契约未定义。9. Flash 作为持久接口Flash 页是跨上电的 API| Section 0 | Page 9 科目3 航点 | Page 10 科目2 | Page 11 科目1 | (其它页 PID 参数… 若实现)接口设计要素建议版本字布局变更可识别CRC防坏页默认值校验失败用编译期常量访问互斥仅主循环写 Flash避免 ISR 写GPS_flash 系列目前在菜单调用主循环方向正确Flash 写耗时长不应放 5ms ISR。10. 故障注入契约被破坏时会怎样注入预期现象定位不开 IMU 直接开 G 导航Nomal_Error 冻结/乱angle_light 无效同时 GI1舵机/速度打架模式互斥视觉未 init 调 steering无 duty/读到垃圾finish_flag/驱动Flash 未 output 只 Follow用旧 OUT/空点契约 D错误 scale/dt航向增速不对IMU 契约duty 当 angle 写入 Steer中值严重偏量纲契约 EKey_close0 仍狂按导航中跳菜单人机契约面试/赛前可用这张表做故障演练。11. 接口表建议写进文档把你自己的车填成下表比再写一万字摘要有用变量类型单位写者读者频率默认有效条件angle_lightfloatdeg±180imu20msFollow5ms20ms0IMU_1_Open1image_steering_dutyfloatduty?steering_image舵机帧率76摄像头 initNomal_ErrorfloatdegFollow5msPID5ms0G_flag1N_1intidxFollow速度表5ms0OUT 有效…12. 重构方向保持可赛12.1 最小改动赛期① 模式enter_mode 互斥 ② IMUstatic 滤波 标定 average 统一 dt ③ 视觉明确 duty→pwm 函数 ④ GPSFollow 前检查 count/N 范围 ⑤ PID去掉函数内写死 kp限幅写回12.2 赛后结构化app/ mode.c # 模式机 nav_gps.c nav_imu.c vision_line.c act_servo.c act_motor.c param.c # PID/Flash menu.c # 只调用 app API依赖方向menu → app → drivers ISR 仅调 app 周期函数不写 UI13. 如何用本方法读你自己的车五步精读法① 列全局变量含驱动导出的 gnss、mt9v03x_* ② 每个变量标写者/读者/单位/频率 ③ 画两张图主循环时序 中断时序 ④ 找“多写者”“单位不清”“有效位缺失” ⑤ 用故障注入表做一次台架验证多技术点对照本车技术点在哪嵌入式时序/中断isr.c pit状态机/表驱动 UIMenu.c数字信号处理OTSU、FIR 权重导航几何Azimuth/Distance/wrap持久化Flash 定点化控制理论PID 位置式/增量式传感器IMU/GNSS/摄像头人机工程菜单蜂鸣按键保护一篇文章同时覆盖这些点而不是每点各写一章空目录。14. 小结代码精读的高级形态 不是复述函数名而是验证模块间契约是否成立。本工程契约亮点双缓冲航点、Flash 分页、flag 门控 ISR、菜单与控制分离。待补契约模式互斥、IMU 有效性、视觉量纲、PID 参数来源、Flash 校验。把契约表写清楚调车就从“玄学”变成“接口联调”。作者shuifanyu标签系统架构嵌入式智能车接口契约联调代码精读仓库https://github.com/shuifanyu/TC264-GPS-Vision-Car本系列深度01–06 与本篇07 接口契约深度系列完整清单篇文件01系统架构与双模式导航02视觉循迹代码精读03GPS 航点与 Follow_track04Menu 表驱动菜单05PID / 执行器 / GL_Math06IMU 航向积分与角差耦合07本篇跨模块数据契约