 wandering1
|
8744c833e5
|
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。
|
2026-10-30 09:22:44 +08:00 |
|
|
wandering1
|
dab0d8ba17
|
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 %。
|
2026-10-29 20:59:36 +08:00 |
|
|
wandering1
|
b25d70e962
|
feat(屏板): 协议层 sb_proto（帧 A 解析 / 帧 B 组帧 / CRC-16）
批 1 的 1-1：新建 Drivers/BSP/ScreenLink/sb_proto.c/h，纯逻辑、无 HAL 依赖，
可主机侧单测。屏板侧的协议事实源是 DTU-LCD 的 CRC16.c / MODBUS.c / rs485.h。
- CRC-16/MODBUS 用一张 16 位合并表（512 B，与屏板两张 8 位表同量）。可逐项
验证的关系：s_crc_table[i] == (auchCRCLo[i] << 8) | auchCRCHi[i]——屏板把
低字节表叫 Hi、高字节表叫 Lo，这正是下面那个字节序陷阱的根源。
- 帧 A 解析：先校 CRC 再看字段。地址/功能码/命令类型不符报 BSP_ERR_PARAM，
CRC 不符报 BSP_ERR_CRC（调用方据此决定"计数"还是"静默丢"）。RT_CMD 带
非 0 key 不报错、按 0 收——为这一项丢一帧等于丢一次刷新，代价不对等。
- 帧 B 组帧：普通图（掩码小端）+ LOGO（宽高大端 + 魔数 0x89 0x45），整帧
4208 B 重写（998 B 填充固定 0x00 且参与 CRC），组完即自校验。
LOGO 容量按字节数判（((w+7)/8)*h <= 3200）而不是像素数：161x159 只有
25599 像素，却要 3339 B 才装得下。
- 主机单测 59/59 PASSED（test/host/sb_proto/），覆盖率 74/74 行、6/6 函数。
其中两条向量是屏板自己算出来的线上字节（01 03 01 00 F0 48 与
01 03 00 09 31 DE），并按屏板 Check_CRC 的口径反查"它会认这一帧"。
- 双端注册：uvprojx 加 File + IncludePath；模拟器侧走 check_registration.py
的 MCU-only 豁免（纯逻辑，模拟器无消费路径）。
- Keil 构建 0 错误 0 警告；Code 不变——尚无调用者，链接器按未用节丢弃。
文档侧的 CRC 字节序订正见下一个提交。
|
2026-10-29 19:17:28 +08:00 |
|