wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects 1 Releases Wiki Activity

docs(屏板链路): 规划文档收编为设计说明事实源，全仓引用与端口口径同步

Browse Source 
- 重写 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:
Wanderingss
2026-10-30 09:22:44 +08:00
parent 613fc25651
commit 8744c833e5
19 changed files with 308 additions and 772 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/README.md
+2 -2
View File
@@ -93,7 +93,7 @@ docs/
| [`ADC采样节拍设计说明.md`](子系统设计/ADC采样节拍设计说明.md) | **ADC 采集链路采样节拍（现状说明）**：TIM3 1 kHz 更新事件同时触发 TPAFE CONVST 与（经 TRGO）STM32 ADC1 + DMA 乒乓缓冲；节拍源为什么是 TIM3、DMA 硬约束、事件驱动消费与就绪门、实现落点、观测计数、性能特征与设计边界 |
| [docs/子系统设计/故障录波设计说明.md](子系统设计/故障录波设计说明.md) | **故障录波设计与口径属主**：1 kHz 起步与 80 点口径的偏离登记、存原始码值的理由、四段所有权与四条并发陷阱、段文件字节布局、现场单通道回放显示契约、预算与 R6 前置 |
| [`IEC104上行设计说明.md`](子系统设计/IEC104上行设计说明.md) | **B4 上行规约**：IEC 60870-5-104 被控站（TCP 2404）范围/点表（V0.1 有效子集）/链路流程（k/w/t1~t3、总召、COV、遥控两段式、定值）/netTask 接入决策/预算与测试方案；协议核心纯逻辑 + 主机侧纯逻辑单测全栈单测 |
| [`屏板链路设计说明.md`](子系统设计/屏板链路设计说明.md) | **屏板串口链路（`Drivers/BSP/ScreenLink/`）实现记录**：一句话架构与数据流、`sb_proto`/`sb_link` 全部对外接口、八条关键实现决定（不留影子缓冲/busy 冻结/中断起发等）、资源占用实测（`s_frame` 落 RW_IRAM1 非 CCM）、单测与台架/真屏板冒烟证据链、接线教训（排针丝印视角陷阱）、坑账本、**尚未实测项清单**；任务分解与协议事实源仍在 `docs/任务规划/屏板链路.md` |
| [`屏板链路设计说明.md`](子系统设计/屏板链路设计说明.md) | **屏板串口链路（主机侧，`Drivers/BSP/ScreenLink/`）设计**：链路与角色、USART1 700 kbaud 配置与中断收发、物理接线（含台架日志口与 PC 顶替屏板）、协议实现口径（CRC 字节序 / 整帧 DMA / 时序）、键值与状态灯映射表、资源与耗时、对外接口表、验证状态与未闭环项、坑账本 |
| [`网络/BSD_Socket_API_使用指南.md`](网络/BSD_Socket_API_使用指南.md) | **上层视图**：BSD Socket API 公开语义、示例、常见问题 |
| [`网络/BSD_Socket_API_函数调用关系.md`](网络/BSD_Socket_API_函数调用关系.md) | **内部视图**：netTask / 消息队列 / 保护判据挂起 / 重试对账的调用关系与设计意图 |
| [`网络/Net层阻塞模型架构设计.md`](网络/Net层阻塞模型架构设计.md) | **等待模型**：recv/send 挂起请求架构、数据结构与挂起槽状态机、recv 五路 + send 四路完成语义、模块接口契约（14 函数）、实现落点（20 集成点）、调用方契约、设计边界与性能特征 |
@@ -243,7 +243,7 @@ docs/
| 位置 | 内容 |
|---|---|
| [`任务规划/`](任务规划/README.md) | **统一待办入口（7 个文件）**：`README.md` = 现在做什么与全项目顺序；`UI补齐.md` = 当前唯一执行清单；`登记簿.md` = 后续任务、外部窗口与长期观察；`故障录波.md` = 录波的卡片与判据（1 kHz · 8 路原始码值 · 单通道回放）；`数据可信.md` = 采集数据可信度的五级台阶与任务卡（含手边可做的动态波形验证）+ 被代码引用的设计约束；`暂缓-RS485.md`、`屏板链路.md` = 两个专项（`测试与架构专项.md` 已删除 2026-10-28，未闭环约束并入 `暂缓-RS485.md`）。完成即删，重复内容只保留一个归属 |
| [`任务规划/`](任务规划/README.md) | **统一待办入口（6 个文件）**：`README.md` = 现在做什么与全项目顺序；`UI补齐.md` = 当前唯一执行清单；`登记簿.md` = 后续任务、外部窗口与长期观察；`故障录波.md` = 录波的卡片与判据（1 kHz · 8 路原始码值 · 单通道回放）；`数据可信.md` = 采集数据可信度的五级台阶与任务卡（含手边可做的动态波形验证）+ 被代码引用的设计约束；`暂缓-RS485.md` = 暂缓专项（`测试与架构专项.md` 已删除 2026-10-28，未闭环约束并入 `暂缓-RS485.md`；`屏板链路.md` 已完成，转为 `子系统设计/屏板链路设计说明.md` 后删除）。完成即删，重复内容只保留一个归属 |
| `硬件平台/` | 网表详细分析报告与语义图（V0.0 / V0.1）；**[`ADC通道映射说明.md`](硬件平台/ADC通道映射说明.md)——V0.1 十七路 ADC 语义/网名/通道号权威映射表（固件取数、UI 显示、自检注入以此为准）** |
| `芯片手册/` | 外部芯片数据手册转录（CH395F / GD5F2GQ5UE / SD2506 / TPAFE5160 / RTL8305NBI 等） |
| `images/` | 文档技术配图（`.svg` 产物，由 `tools/arch_diagram/`、`tools/refgraph/` 生成） |