docs(屏板链路): 规划文档收编为设计说明事实源,全仓引用与端口口径同步
- 重写 docs/子系统设计/屏板链路设计说明.md:链路角色、串口与端口配置、 物理接线、协议实现口径、键值与状态灯映射、资源与耗时、对外接口、 已验证/未闭环、坑账本——只写现状事实,演进过程查 git 历史 - 删除 docs/任务规划/屏板链路.md(内容已全部沉淀进上述设计说明, 登记簿「完成即销项」;docs/任务规划/README.md 相应两行一并移除) - 代码与主机侧测试的文档指针改指设计说明对应章节: sb_link.h/.c、sb_proto.h/.c、sb_led_map.h、console_log.c、ui_task.c、 test/host 的 sb_link/sb_proto/sb_led_map 三套与两个台架脚本 - docs/README.md:设计文档索引行与设计说明描述更新,任务规划目录 7→6 文件 - docs/产品需求/产品需求设计文档.md:串口通道现状口径同步——第 11/12/13 条 已交付(4208 B 应答/状态灯掩码/键上行/双出口并发)、LOGO 下发出局不实现、 帧长实测固化、调试日志口 UART5/RS232#1(§4.2/§5.16/§6.6/§9.12/§9.13) - docs/子系统设计/控制台单写者日志设计说明.md v1.8:全文端口口径由 USART1 同步为 UART5/RS232#1(CON_UART* 单点宏),ORE 机理标注跨端口 同因,时间线补端口迁移行;头部修订指针改为实际章节名 说明:本任务经用户显式授权在任务树内编辑 docs/任务规划/ 与产品需求基线 (铁律「单写者」豁免一次);主树合并后统一跑全量 check_doc_links --all。
This commit is contained in:
@@ -7,8 +7,8 @@
|
||||
* 作者:王建锋
|
||||
* 创建日期:2026-10-29
|
||||
* 修改记录:
|
||||
* 2026-10-29 王建锋 创建初始版本(批 1 的 1-2 / 1-3)
|
||||
* 2026-10-29 王建锋 批 2:组帧入口 + 中断起发 + TxCplt 收尾 + 按键队列 + 离线判定
|
||||
* 2026-10-29 王建锋 创建初始版本(收中断 + 帧 A 校验)
|
||||
* 2026-10-29 王建锋 增加:组帧入口 + 中断起发 + TxCplt 收尾 + 按键队列 + 离线判定
|
||||
*
|
||||
* 四个容易踩的点(改之前先读,前三条都已在台架上被别的东西咬过一次):
|
||||
*
|
||||
@@ -291,7 +291,7 @@ void sb_link_on_rx_event(UART_HandleTypeDef *p_huart, uint16_t size)
|
||||
if (frame.cmd == SB_CMD_KEY)
|
||||
{
|
||||
s_stats.key_events++;
|
||||
/* 只入队,不注键:注键会走 ui_port 的输入队列,属业务动作(决策三)。
|
||||
/* 只入队,不注键:注键会走 ui_port 的输入队列,属业务动作。
|
||||
* key == 0 是"无键",屏板自己的语义就是没有事件,不必占队列。 */
|
||||
if (frame.key != 0U)
|
||||
{
|
||||
@@ -299,7 +299,7 @@ void sb_link_on_rx_event(UART_HandleTypeDef *p_huart, uint16_t size)
|
||||
}
|
||||
}
|
||||
|
||||
/* 决策三:起发就在这儿,不在任务里轮询。一召唤 → 一答 4208 B,绝不叠发。
|
||||
/* 起发就在这儿,不在任务里轮询。一召唤 → 一答 4208 B,绝不叠发。
|
||||
* 上一帧还没发完(屏板自己超时重问过)就丢这一轮:多发一帧会让屏板把
|
||||
* 两帧粘成一帧撕裂,而且它接收溢出后会永久收不到东西(见 §4.4 的警示)。 */
|
||||
if (s_frame_ready == 0U)
|
||||
|
||||
Reference in New Issue
Block a user