wandering1
dab0d8ba17
批 2 五项全部落地（docs/任务规划/屏板链路.md §3）： - 2-1 sb_link_frame_update()：uiTask 渲染后按需组帧，不留 3200 B 影子 副本，直接拿活显存与帧内点阵段 memcmp；组完自校验，过了才置 ready。 静态 4208 B 帧缓冲实测落 RW_IRAM1（0x20006d98），不在 CCM。 - 2-2 空闲中断校完 6 B 召唤帧直接点 TX DMA（sb_tx_kick），不排队不攒批； busy 期间再来的召唤丢帧并计数，绝不叠发（屏板收帧一次 IDLE 一包）。 - 2-3 按键走环形队列（中断入、任务出），uiTask 按 §4.3 表映射 UI_KEY_* 后调 ui_port_queue_key；9/10（RESET/FACTORY）按决策四先丢弃并留痕。 - 2-4 HAL_UART_TxCpltCallback 在 rs485.c 加第三行转发（三个全局回调 落点收一处，防日后重复定义）；busy 冻结帧缓冲，错误中断按 gState 收拾被打断的 TX，防残留 busy 把链路永久锁死。 - 2-5 连续 >=10 s 无有效召唤帧才判离线（不按 500 ms——屏板约 5000 s 自复位有 1 s 空窗），恢复即清标志；CRC 错帧静默丢弃并计数。 实测：台架 40 s（PC 顶替屏板，--key-fixed 2 持续改画面）rx=143 ok=143 keys=143 crc=0 / tx=143 done=143 drop=0 abor=0 fb=144 bad=0；脚本一停 10 s 准点出 OFFLINE。组帧耗时 509 µs 典型 / 709 µs 峰值——原 0.3 ms 判据系估算，已按实测在规划文档改口为 1 ms 并给出压降路径（未做）。 附带：rs485_on_rx 补 CODE-RULE-09 文档块（本轮改 rs485.c 触发整文件 重扫被拦）；CRC 循环计数改 32 位（消掉 ARMCC 每轮 UXTH）；bench 脚本 加 --reply/--key-fixed/--dump，并写明 CH340 收不了 700 kbaud 连续流、 --reply 收不全 4208 B 不是固件问题。 主机单测 146/146 PASSED（+65）；Keil 0 错误 0 警告；ci_local 全绿 （SKIP=nested-comment，worktree 限制，主树脚本另查 0 新发）。 Code=238,936 B / RW_IRAM1 65.5 % / RW_CCM 87.9 %。
Src/ — CubeMX 生成的源文件
⚠️ 本目录文件由 STM32CubeMX 生成（
.ioc重生成会覆盖），不是自研代码。 但允许在USER CODE BEGIN/END标记区之间写自定义代码。
文件一览
| 文件 | 生成 | 作用 |
|---|---|---|
main.c |
CubeMX | 程序入口：HAL_Init → SystemClock_Config → 外设初始化 → app_main_init → osKernelStart |
freertos.c |
CubeMX | FreeRTOS 任务创建（MX_FREERTOS_Init）+ 任务栈/优先级定义 |
gpio.c / dma.c / spi.c / i2c.c / usart.c |
CubeMX | 各外设 MX_xxx_Init |
stm32f4xx_hal_msp.c |
CubeMX | HAL 外设底层初始化（时钟使能、NVIC、引脚复用） |
stm32f4xx_hal_timebase_tim.c |
自研覆盖 | HAL 时基改用 TIM7（非 SysTick），tick = 1ms |
stm32f4xx_it.c |
CubeMX | 中断服务函数（ISR） |
system_stm32f4xx.c |
CMSIS | 系统时钟初始化（SystemInit） |
⚠️ 修改约定（铁律）
- 自定义代码只写
USER CODE BEGIN xxx/USER CODE END xxx标记区之间—— 标记区外的内容在 CubeMX 重新生成时会被无条件覆盖丢失 - 本目录被 pre-commit 的 C 代码规范检查排除（因是生成代码，风格不受控）
Drivers/BSP/才是纯手工代码区；应用逻辑放App/
关键点
- HAL 时基 = TIM7，不是 SysTick；FreeRTOS 用 SysTick 之外的方式，tick = 1ms
- NVIC 4 位优先级分组；外设中断优先级 ≥ 5（0~4 预留给 FreeRTOS）
- 时钟：HSE 8MHz → PLL M=4/N=168/P=2 → 168MHz
相关文档
- 架构全景：
docs/架构设计/项目架构总览.md - 启动顺序：
docs/架构设计/项目启动顺序管理.md - 任务表（唯一事实源 =
freertos.c）：根README.md