feat(屏板): 帧 B 组帧 + 中断起发 TX DMA + 按键队列 + 离线判定(批 2)

批 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 %。
This commit is contained in:
2026-10-29 20:59:36 +08:00
parent e5b4182a9f
commit dab0d8ba17
15 changed files with 1263 additions and 132 deletions
+24 -3
View File
@@ -174,18 +174,25 @@ uint16_t rs485_rx_get_size(const rs485_handle_t *p_handle) {
/* ==================== HAL 回调(本工程唯一实现处) ====================
*
* ⚠ 这两个回调是 HAL 的**全局单例**:一个工程只能有一份定义
* ⚠ 下面三个回调是 HAL 的**全局单例**:一个工程只能有一份定义
* (Inc/stm32f4xx_hal_conf.h 的 USE_HAL_UART_REGISTER_CALLBACKS = 0,
* 没法按句柄注册各自的回调)。所以新增通道时**在这里加一行转发**,
* 不要在别处再定义一份 —— 重复定义是链接期的 multiple definition,编不过。
* 三个 = RxEvent / Error / TxCplt。加通道时**三个都要看一遍**:只用收的通道
* 也得知道 TxCplt 有没有被占,免得日后自己想发东西时找不到落点。
*
* 按句柄过滤放在各通道自己的模块里(如 sb_link_on_rx_event 内部判 p_huart),
* 本文件不必知道别的通道用的是哪个 huart,也就不会因为它们换口而改动。
*/
/*
* 应用层接收钩子默认实现(弱符号,可被应用重定义)。
* 在中断上下文调用,仅做占位,业务解析由应用提供。
* 函数功能:应用层接收钩子的默认实现(弱符号,可被应用重定义)
* 入口参数:buf - 本次接收数据首地址(中断上下文,回调返回后即被复写)
* size - 本次接收字节数
* 返回值:无
* 限定条件:中断上下文调用(HAL_UARTEx_RxEventCallback 内),默认实现仅做占位
* 函数说明:业务解析由应用侧重定义本函数提供;弱符号定义与 rs485.h 的声明同名,
* 应用侧给出强符号时链接器取强符号,本实现被覆盖。
*/
__weak void rs485_on_rx(uint8_t *buf, uint16_t size) {
(void)buf;
@@ -228,3 +235,17 @@ void HAL_UART_ErrorCallback(UART_HandleTypeDef *huart) {
/* 屏板链路(USART1):清 ORE 并重挂接收(不清 ORE 会永久静默),见 sb_link.c */
sb_link_on_error(huart);
}
/*
* HAL UART 发送完成回调(DMA 传输结束 / 阻塞发送结束)。
* 全工程原本零实现(2026-10-29 核实),屏板链路是第一个用户:它靠这个回调清 TX busy。
*
* 为什么放在本文件而不是 sb_link.c:三个全局 UART 回调必须一眼能找到全部落点。
* 分开写的话,下一个加通道的人只在本文件看到两个回调,会以为 TxCplt 没人用、
* 于是自己在别处再定义一份 —— 那是链接期 multiple definition。
* 本文件只做一行转发,**按句柄过滤在 sb_link 内部做**,与上面两个回调同一约定。
*/
void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart) {
/* 屏板链路(USART1):清 TX busy 标志并计数,见 sb_link.c */
sb_link_on_tx_cplt(huart);
}