diff --git a/docs/产品需求/产品需求设计文档.md b/docs/产品需求/产品需求设计文档.md index 5ee7be2b..5fb1d7af 100644 --- a/docs/产品需求/产品需求设计文档.md +++ b/docs/产品需求/产品需求设计文档.md @@ -329,7 +329,7 @@ tTimer_NoUI 无压无流判据（CN_ |---|---|---| | **外部资源**（标准源、端子变比） | 定值标定、保护判据解卡 | 两点标定（§9.2 第 4 步） | | **硬件缺失**（X3 / X4） | 开入 138、开出 31、电度 8、同期、三相通道 | V0.2 硬件 | -| **立项未排** | 录波、多规约、SNTP、记录 5 页、定值铺开 | 按 §9.2 顺序 | +| **立项未排** | 录波、多规约、SNTP、定值铺开 | 按 §9.2 顺序 | | **算力 / 形态**（X1 / X2） | 双核分工、VxWorks | 不解除。**屏板链路已从范围外项移入范围内待做**（规格 §5.16，执行规划 docs/任务规划/屏板链路.md）：主机侧链路与参考 1:1 同构，不属"替代方案" | > **结论**：本产品与参考产品的差距**全部是"进度"而非"范围"**——没有一项是"参考有而我们不做"。 @@ -883,10 +883,16 @@ sequenceDiagram - 判据：动作路径零 NAND I/O（protectTask 静态链 872 B 改前后不变）；104 时标 = 事件上送时刻， 与落盘记录（事件发生时刻）差 ≤ 一拍 + 排空延迟（≤50 ms）。 -**FR-SOE-3 记录体系（🔶 展示层待补）** -- 现状：内核只有 SOE 一类；UI 菜单的「事故 / 操作 / 保护告警 / 保护启动 / 遥控记录」5 页 - **缺写入方**，运行报告缺上电次数与 104 统计只读计数（§9）。 -- 判据（补齐后）：五类记录各有写入点、可翻最近 20 条、空记录明确显示"无记录"、共用 reader。 +**FR-SOE-3 记录体系（✅ 软件面已落地；真机判据待台架）** +- 现状：七类文本记录（运行 / 自检 / 事故 / 告警 / 启动 / 操作 / 遥控）+ 二进制 SOE 已落地， + 「记录类型 = 日志 ID 本身」（一类记录一个文件，记录体内无类型字段位）；UI 六页已绑 + （记录 5 页 + 运行报告，2026-10-28）。运行报告的四个数取自 boot_stats（SD2506 用户 SRAM + 上电次数 + 本次复位原因快照）与 iec104_serv 的四个只读观测计数，经 info 帧下发 + （口径 docs/UI设计/UI_数据供给设计说明.md §4.4）。 +- 判据：五类记录各有写入点、可翻最近 20 条、空记录明确显示"无记录"、共用 reader——**软件面已满足** + （空态与四个范围标签由 60 页像素黄金钉住；模拟器侧这些文件没有写入方，只拍到空态）。 + 真记录翻页、掉电后保持、清除记录后归零、boot_count 自增与四态判定**待台架复核** + （docs/任务规划/登记簿.md §7）。 ### 5.15 IEC 60870-5-104 上行（FR-IEC104）✅ @@ -1813,8 +1819,9 @@ pre-commit run --all-files ![级联框总览](../images/级联框总览.svg) **规模**：菜单节点 **9** 个（含根）+ 叶子节点 **33** 个 = **42** 节点；最大深度 **4 级（L0~L3）**。 -**绑定现状**（2026-10-27 实测）：**已绑内容页 22 叶 / 未绑 11 叶**（页面注册表 `UI_PAGE_MAP_COUNT` = 22， -与已绑叶数一致）；未绑 11 叶 = 记录 5 + 运行报告 1（当前执行）+ 无开入硬件 3 + 未立项 2。 +**绑定现状**（2026-10-28 实测）：**已绑内容页 28 叶 / 未绑 5 叶**（页面注册表 `UI_PAGE_MAP_COUNT` = 28， +与已绑叶数一致）；未绑 5 叶 = 无开入硬件 3 + 手动录波 1 + SNTP 1（取舍与重开条件见 +docs/任务规划/UI补齐.md §5）；原「当前执行 6 项」（记录 5 页 + 运行报告）已于 2026-10-28 落地绑页。 **根页（主界面）7 个一级条目**：装置信息 / 实时数据 / 参数定值 / 三遥设置 / 装置维护 / 通讯参数 / 记录查询。 @@ -1848,7 +1855,7 @@ pre-commit run --all-files ### 8.3 内容页 -**已绑 22 页**（按分组；逐页形态见 [`docs/UI设计/页面补齐规划.md`](../UI设计/页面补齐规划.md)）： +**已绑 28 页**（按分组；逐页形态见 [`docs/UI设计/页面补齐规划.md`](../UI设计/页面补齐规划.md)）： | 分组 | 页面 | 形态 | |---|---|---| @@ -1860,8 +1867,10 @@ pre-commit run --all-files | 装置维护 | 时钟设置 / 强制复归 / 清除记录 | 操作页（执行类必须出真反馈，不得"点了没效果"） | | 通讯参数 | 通讯设置 / 网口设置 | 可编辑（`[comm]` / `[network]` 段，保存后按各自生效时机） | | 记录查询 | SOE 记录 / 自检记录 / 运行记录 | 记录列表（共用 reader） | +| 记录查询 | 事故记录 / 操作记录 / 保护告警 / 保护启动 / 遥控记录 | 记录列表（每记录 2 行、空态显「无记录」；写入点与判据见 App/log/README.md §五类记录） | +| 记录查询 | 运行报告 | 只读列表 13 行分 2 页；四个数逐个挂范围标签（自电池周期 / 本次开机），跨开机累计按裁定不做 | -**未绑 11 叶**：记录 5（事故 / 操作 / 保护告警 / 保护启动 / 遥控）+ 运行报告 = **当前执行 6 项**； +**未绑 5 叶**（2026-10-28：记录 5 页与运行报告页已落地绑页，原「当前执行 6 项」清零）： 遥信类型 / 遥信防抖 / 双点遥信 = 等开入硬件（§9.1.1「出口与开入」）；手动录波 = 等录波子系统 （§9.1.2「录波子系统」）；SNTP 设置 = 等 SNTP 对时（§9.1.2「SNTP 对时」）。 @@ -1869,7 +1878,7 @@ pre-commit run --all-files - 菜单导航状态**不压层**，返回即原样还原；同一时刻至多一个内容页打开。 - 节点→页映射在逻辑层 `menu_content_page_for(node)`；未绑叶子进入空白终点框（不伪造数据）。 - 数据供给走**注入通道**（rt / par / info / 遥测死区与系数第四表），页面不直接触算法层； - 像素黄金用例当前 **53 页**（菜单 8 状态另计）。 + 像素黄金用例当前 **60 页**（菜单 8 状态另计；2026-10-28 记录 5 页与运行报告 2 页落地，+7 张）。 ### 8.4 密码与权限 @@ -1882,7 +1891,8 @@ pre-commit run --all-files ### 8.5 中文字体 -- 字体 `ui_font_cn_12.c`：宋体 12px 1bpp **子集**（当前 122 唯一字 / 217 字形）。 +- 字体 `ui_font_cn_12.c`：宋体 12px 1bpp **子集**（当前 **218 唯一字 / 313 字形**，2026-10-28 实测； + 122/217、179/274、185/280 均为历史快照。字形数 = 汉字/符号数 + ASCII 0x20~0x7E 共 95 个）。 - 生成流程：`tools/font_gen/extract_cn.py`（扫 UI 源码 → `ui_cn_chars.txt`）→ `tools/font_gen/make_font.py`。 - **约束**：任何 UI 文案新增汉字后必须走此流程，否则显示为空白方块。 @@ -1926,7 +1936,7 @@ pre-commit run --all-files | **遥测铺开** | 4、5 | 31 点 + 模型 35 行 | 9 点 | +22 点 + 模型表 | | **录波子系统** | 10、15 | 3 类型 / 6 段 / 65 通道 / RAM 16 个 / COMTRADE 64·64·16 | 0 | 整子系统 | | **记录体系** | 9、13 | 13 类队列（128/256 条） | 8 类 | +5 类（越限 / 闭锁 / COS / 顺控 / 顺控执行） | -| **UI 记录页** | 9、13 | 参考有完整记录页与运行报告 | 菜单叶未绑页 | 5 页 + 运行报告 | +| **UI 记录页** | 9、13 | 参考有完整记录页与运行报告 | 六页已绑并纳入像素黄金回归（2026-10-28） | 只剩真机判据（docs/任务规划/登记簿.md §7） | | **多规约栈** | 17 | 12 种 | 1 种（104） | +11 种（101 / 102 / 103 / CDT / ModBus / Whm_GB / 61850 / CAN + 子站侧 3 类） | | **国密算法** | 18 | `Comm/Ecc/` 全套 | 0 | SM2 / SM3 / ECDSA | | **软压板铺开** | 11 | 9 面（表容量 32） | 1 面 | +8 面 | @@ -1948,8 +1958,8 @@ pre-commit run --all-files | 顺序 | 工作 | 类别 | 当前状态 | 开始条件 | |---|---|---|---|---| -| 1 | UI 补齐（记录 5 页 → 运行报告） | 规模型 | **当前执行** | 已开始 | -| 2 | net 层跨上下文收口 | 平台 | 下一步 | UI 清单完成 | +| 1 | UI 补齐（记录 5 页 → 运行报告） | 规模型 | **清单已清空（2026-10-28）** | 六页已落地；余 5 叶属不做项，重开条件见 docs/任务规划/UI补齐.md §5 | +| 2 | net 层跨上下文收口 | 平台 | **下一顺位（未开工）** | UI 清单已清空，切换条件已满足；**开工待用户点头** | | 3 | 其余结构与可靠性评估 | 平台 | 排队 | net 收口后 | | 4 | 端子/子板变比确认 → 两点标定 | 阻塞型 | 等外部资源 | 子板实物/原理图、标准源到位可插入 | | 5 | 标准源送检与第三方 104 主站验收 | 阻塞型 | 等标定 | 保护 VALID 置位；送检窗口前 2 日冻结特性 | @@ -2701,6 +2711,7 @@ pre-commit run --all-files | 2026-10-28 | **v1.4 屏板链路口径更正 + 逐字节复刻规格（新增 §5.16、§9.13）** | ① **口径更正**：v1.3 及更早把参考写成"**板载** LCD + 按键"、把本产品远端推流说成"等价替代"，**两处都错**。参考源码中主机侧 5 个碰硬件的函数（`KeyGet` / `WriteScreenByByte` / `LCD_LED_Update` / `getRs485Key` / `anyNewKey`）**全树只有声明没有实现**，按键轮询函数名为 `Key_Rs485_Process()`（注释"轮询从485传来的按键值"），屏板插槽号 `CN_SLOT_DISP = 0`（注释"显示板插槽号固定为0"）——**参考的屏和键同样在独立板件上、同样靠链路传输**，本产品与之**同构而非替代**；§2.4.1 X3 由「本地人机」改为「**就地屏板（板件本体）**」，并补口径更正说明段；② **§2.5.2 补第 20 项「远端屏与按键链路」**（状态 🔶），能力计数 19 → **20 项**、🔶 9 → **10 项**，§2.5.7 差异归因同步（X3 不再计为"已用等价方案替代"）；③ **新增 §5.16 远端屏与按键链路（FR-HMI）**：两条链路对照（RS-485 屏板通道 / TCP 7003 总线）、帧格式逐字节、CRC 覆盖范围、接收定界算法、**INIT 应答 29 B 逐字段偏移表**、键值位掩码语义、`bNeedFlash` 续传与拒绝语义（`-1` / `-2`）、按键状态机与合并优先级、三个定时器（500 ms / 1 分钟 / 200 ms）、发送状态机、`0x55`/`0xaa` 刷新互斥、任务参数（prio 111 / 栈 0x35000）；④ **§5.16.9 给出 10 项与参考的差异**，其中 5 项为客户端可见的报文口径差（INIT **8 B vs 29 B** 为最大一条）；⑤ **§6.2 按参考源码重写**：更正 INIT 应答长度（原写 8 B）、KEEPLIVE 改为**不应答**（原写"原样回显"）、补最长帧 9800 B / 收发缓冲 10240 B / 按键码补 `F1`·`F2` 与位掩码可组合说明；⑥ **新增 §9.13 屏板链路复刻任务规划**：10 条语义短语任务 + 三批划分 + 唯一破坏性变更警示（INIT 长度变更必须与客户端同批发版）；⑦ §9.1.2 补「屏板链路对齐」行、§9.12 补完成判据、§10.3 补现场验收第 13 项。**本次只改本文件** | | 2026-10-28 | **v1.5 补串口屏板通道（显示信息不只走网络）** | ① **口径再更正**：v1.4 把串口通道写成"链路 A，随 RS-485 簇冻结"，等于把它降级成可选——**错**。参考的架构是**一份显存、两个出口**：**串口屏板通道是主通道**（`LCD_LED_Update(显存 3200 B, LED 4 B)` 变化驱动 + `WriteScreenByByte` 500 ms 兜底），**TCP 7003 是镜像**；上行同理（`getRs485Key()` 物理键号 1~10 为主，`g_tRemoteKey` 为镜像，两者在 `Key_Read()` 汇合且**本地优先**）。§5.16 标题改为「**屏板链路：串口主通道 + 网络镜像**」并重写开篇；② **§5.16.1 重写为「一份显存、两个出口」**：显存物理基址 `CN_VIDEO_ADDRESS_BASE = 0xC1F00000`（非 cache 区）、三条下行路径与两条上行路径的归属任务 / 调用 / 载荷 / 节拍对照表；③ 新增 **§5.16.2「本产品的串口通道（待建）」**：V0.1 串口资源盘点（USART1 调试占用 / UART4 被冻结 RS-485 占用 / **UART5、USART2、USART3 空闲**），默认选 **USART3（PB10/PB11）**，若屏板为 RS-485 半双工则改 UART4 并先解冻该簇；④ 新增 **§5.16.3「参考实现的屏板侧接口一览」**，并**明确列出交付源码推不出的四项**（波特率与数据格式 / 帧头与校验 / 半双工方向控制 / 3200 B 是否分片与应答）——在拿到实测前不得声称"按参考协议实现"；⑤ **§5.16.9 差异表由 10 行扩到 14 行**，新增「串口屏板通道整条缺失」「双出口并发缺失」「面板指示灯语义不同」「背光对比度」四项，并注明第 11/12 条是**整条链路缺失**而非报文细节；⑥ **§5.16.10 判据由 7 条扩到 12 条**，新增串口侧 5 条（键号注入 / 500 ms 内出帧 / 双通道并发不丢帧不串帧 / 拔插恢复 / 背光）；⑦ **§9.13 任务由 10 条扩到 13 条**：原「RS-485 屏板通道」一条拆为「串口通道物理层定版 / 串口下行显存 / 串口上行按键 / 双通道并发回归」四条，批次表第三批改为**独立立项、不随 §5.10 冻结**，并补前置阻塞（需屏板实物验收；拿不到固件或抓包时不得把猜测定成契约）；⑧ §5.16.8 `tTimerLCD` 行由"此路不实现"改为"串口通道周期兜底节拍（待建）"，§2.5.2 第 20 项、§9.1.2、§9.12、§10.3 同步。**本次只改本文件** | | 2026-10-28 | **v1.6 屏板源码到手：串口通道协议定版 + 状态灯下行** | ① **屏板固件已获得**（`D:\Code\DTU Code\DTU-LCD`，STM32F103ZE + UC1698U 160×160 单色 + **20 路状态指示灯** + 7 个物理按键），v1.5 列的"四项未知"**全部消解**；② **§5.16.2 重写为「串口通道：物理层与帧格式（屏板源码实测）」**：**700000 8N1**（APB1 42 MHz 分频零误差、`BRR = 0x3C0`）、软件 DE、**角色反转（屏板是 Modbus 主站、主机是从站 `0x01`）**、帧 A 6 B 召唤（`01 03 type key CRC_H CRC_L`，`KEY_CMD=0` / `RT_CMD=1`，CRC-16/MODBUS 只覆盖前 4 B、**高字节在前**）、帧 B **4208 B** 图像应答（3200 显存 + 4 B 状态灯 + 4 B info + 998 B 填充 + 2 B CRC，覆盖 `[0, 4205]`）、时序 275 ms / 200 ms / 5 次超时、200 ms 预算下 4208 B 约 60.1 ms（占 30 %）、主机端口默认 **USART3 + 另配 DE GPIO**（**不必解冻 UART4**）；③ **§5.16.3 重写为「屏板侧行为：状态灯 / 按键 / 背光 / LOGO」**，新增**状态灯下行**：`info[0..3]` 为 **32 位小端位掩码**、**ID 0 = 电源灯硬件常亮、ID 1~19 对应 bit1~19**，给出 20 路 LED 引脚表，并指出"**位 → 业务状态映射表参考源码没有、须由本产品自定**"；键值 `KEY_TYPE` 表（`0` 无键 / `1` ENTER / `2` UP / `3` DOWN / `4` ESC / `5` ADD / `6` DEC / `7` LEFT / `8` RIGHT / `9` RESET / `10` FACTORY），并**指出与参考主机 `getRs485Key()` 的 `9` / `10` 语义冲突**（参考是 `F1` 与 `F1+ENT`）、`key_configs[]` 仅 7 项且无 ADD/DEC 入口；背光自管、LOGO（Flash `0x0803F000`、魔数 `0x89 0x45`）、屏板健壮性（CRC 错 ≥3 仅清计数**不自愈**、**≈5000 s 自复位**、DMA 接收问题未解决）；④ **§5.16.9 差异表**第 8 / 11 / 12 / 13 / 14 行按屏板实测重写，并新增"来自屏板固件的新增约束"5 条；⑤ **§5.16.10 判据由 12 条扩到 15 条**（275 ms 召唤 / ≤200 ms 回 4208 B、显存逐字节、7 键、**状态灯逐位**、双通道并发、**自复位容忍**、拔插恢复、**LOGO 下发**）；⑥ **§9.13 任务由 13 条改为 15 条**：第 10 条由"物理层定版"改为"**串口物理层落地**"（参数已定）、新增第 12 条"**状态灯位映射表**"与第 15 条"**LOGO 下发流程**"、第 14 条并入"自复位容忍"，批次表第三批改 10~15 并注明**不必解冻 UART4**，删除"拿不到固件不得定契约"告警（已消解），保留"**4208 vs 3208 待台架复核**"；⑦ **§5.8 补屏板 20 路指示灯与主板 6 路 LED 是两套独立输出**；§5.6 FR-UI-1 改为"**双出口推流**"；§6.2 口径注改为"串口通道是 Modbus RTU 风格裸帧、**不能共用组帧代码**"；§2.4.1 X3、§2.5.2 第 20 项、§5.16.1、§5.16.8 `tTimerLCD` 行、§9.1.2、§9.12、§10.3 第 13 项同步。**本次只改本文件** | +| 2026-10-28 | **UI 现状同步（不 bump 版本号）** | ① 绑定叶数 22→28、未绑 11→5（记录 5 页与运行报告页落地绑页，§8.2 / §8.3 / §9.2）；② 像素黄金 53→60 页（新增 7 张，含运行报告第 2 页）；③ 字库当前态改 218 唯一字 / 313 字形（122/217、179/274、185/280 均为历史快照，§8.5）；④ FR-SOE-3 由「展示层待补」转「软件面已落地，真机判据待台架」（§5.14）；⑤ §2.4 立项未排去掉已交付的「记录 5 页」、§9.1 差距表 UI 记录页行改写现状与去向。真机判据登记 docs/任务规划/登记簿.md §7；模拟器结构性照不到的部分见 docs/测试说明/模拟器差距清单.md §2.3。 | | 2026-10-28 | **v1.7 单色口径：删除多色协议，INIT 由 29 B 改 16 B** | 用户裁定"屏幕板都是单色的，多色协议可以删除、不必对齐"。**核查后确认这不是让步，而是删死字段**：① **三处源码证据**——`RemoDispBus.h:46` `CN_RDISP_TYPE_MONO = TRUE` → `CN_RDISP_LCD_TYPE = CN_MODE_GREY_MONO`、`CN_RDISP_MEMSIZE = (X>>3)*Y`（链路显存本就是 1 bpp）；`RDisp_Form_InitInf` 里 `CN_RGB_RED/GREEN/BLUE` 是**编译期常量**而非逐帧数据；`RDisp_LcdColor_To_Mono()` 对 `CN_MODE_GREY_MONO` **直接 `return TRUE` 不转换**，真正干活的 `RDisp_Lcd16B_To_Mono()`（RGB565→单色）挂在 `CN_MODE_COLOR_16B` 下**本构建永不进入**（死代码）；② **§5.16.5 INIT 应答表由 29 B 重写为 16 B**（宽 2 + 高 2 + 显存 4 + 8 键值表），删掉 1 B 颜色位 + 12 B RGB，并补"为什么是 16 B"的证据块；③ **§6.2 命令集 INIT 行**同步改 16 B 并加"单色口径"注（颜色位与 RGB 整段删除、`RDisp_LcdColor_To_Mono()` 不存在）；④ **§5.16.6 第 6 条注**改为"该函数在参考单色构建下就是空转"，避免误以为本产品漏了一步转换；⑤ **§5.16.9 第 1 行**由"补 21 B"改为"**补 8 B 键值表 → 16 B**，颜色 13 B 不对齐"；"新增约束"补"单色"一条；末尾警示改为 **16 B vs 29 B 不可互换**（从偏移 4 起含义即不同，客户端不得复用参考 29 B 解析器截前 16 B）；⑥ **§5.16.10 判据第 1 条**改 16 B 且"不得出现颜色位或 RGB"；⑦ **§9.13 第 2 条**改"INIT 应答补足 **16** 字节 / 不加颜色位与 RGB"、第 9 条客户端按 16 B 解析、破坏性变更警示改 16 B（后 8 B 而非后 21 B）并补"不可与参考 29 B 互换"；⑧ **§2.4.1 补"多色显示不在本表内"**——参考与本产品都是单色链路，删的是死字段，**不属于"决定不做"的能力**；§2.5.2 第 20 项、§9.1.2、§9.12、§10.3 第 13 项同步；⑨ **§8.1 色深行**补"无灰度、无彩色，7003 INIT 颜色字段已删"，渲染行改为"串口屏板通道（主）+ TCP 7003（镜像）双出口"。**本次只改本文件** | | 2026-10-28 | **v1.8 端口重排：屏板占 USART1，日志迁 RS-232 通道** | 用户裁定"把现在的日志 UART 让给屏幕，RS-232 通道后面用来输出日志"。**这条裁定把 v1.6/v1.7 的头号阻塞直接消掉了**：① **§5.16.2 新增「端口裁定」块**——屏板改走 **USART1（PA9/PA10，MCU 直出 TTL、不经任何收发器）**，因此 `U15 = TP8485E-SR` 只有 250 kbps 这件事**对屏板链路不再构成约束**；日志迁 **RS-232 通道**（V0.1 板上 RS232#3 = USART2 PD5/PD6 为默认，RS232#1 = UART5 PC12/PD2 为备选，两者都经隔离器 → U13 TPT3232E → CN1）；② **纠正分频算法**——旧文写"`42 000 000 / 700 000 = 60` → `USARTDIV = 60.0`、`BRR = 0x3C0`"**漏了 16 倍过采样**，照此写实际波特率只有 43 750；正确值：USART1（APB2 84 MHz）`USARTDIV = 7.5` → **`BRR = 0x0078`**，APB1 实例（42 MHz）`USARTDIV = 3.75` → **`BRR = 0x003C`**，两者误差均为 0；③ **§5.16.2「主机侧端口选型」整表重写为「主机侧端口重排」**，按 `docs/硬件平台/V0.1_网表详细分析报告.md` §4.2 的三对 UART 轮换列明 RS485#4 = UART4（DE = PA15）、RS232#1 = UART5、RS232#3 = USART2，并补两条实现约束（`console_log.c` 里 `huart1` 5 处 + 自愈函数直写 `USART1_IRQn` / `MX_USART1_UART_Init()` 需收口成一处端口宏；新日志口必须 `UART_MODE_TX`，否则重演 ORE 锁存）；④ **DE 口径改为「TTL 直连无 DE」**，仅"经外部 485 模块接 A/B"时才需处理，且极性由该模块决定；⑤ **主机 RX 口径**由"吃下 4208 B"改为"只需 6 B（16 B 缓冲够）"，并说明 TTL 直连无自发自收；⑥ **§4.2 外设接口表**：USART1 行补"端口重排后改作屏板链路 + PA10 目前未接线"，新增 USART2（RS-232 #3，日志口）与 UART5（RS-232 #1，备选）两行，UART4 行注明 V0.1 轮换依据；⑦ **§5.16.9「新增约束」**与 **§9.12** 的 700000 行同步为"USART1 TTL 直连、无 DE"；⑧ **§9.13 新增第 16 条「日志口迁移」**并置于第三批首位，批次表注明 **16 必须排在 10 之前**（两者共用 `USART1->DR`）；第 10 条改为 `BRR = 0x0078`、无 DE、`DMA2_Stream7/2` 现成；**前置阻塞**补两条物理前置（PA10 接线、台架串口线从 USART1 挪到 CN1）。**本次只改本文件** | | 2026-10-28 | **v1.9 撤销"PA10 未接线"，ORE 机理改正** | 用户反馈"PA10 这个端口我接线了，当时分析出这个问题来，我怀疑是错误的"。核查后确认：**`App/log/console_log.c`（文件头与 `con_uart_reinit()` 注释）与 `docs/子系统设计/控制台单写者日志设计说明.md` §12 里的"PA10 悬空 / 未接线"是 2026-10-02 的归因推断，不是实测**，且与用户确认的接线状态相反。改动：① **§4.2 外设接口表** USART1 行删掉"PA10 目前未接线、作屏板链路前必须接上"，改为"PA10 双向均已接线"；② **§5.16.2** 原"USART1 的 RX 目前没有接线"警示块整段重写为「旧结论已撤销 + ORE 真正机理」——ORE 的充分条件是**RX 使能却从不读 `DR`**（任意一个字节或噪声沿使 `RXNE` 置位后无人读，下一个事件即锁存 ORE，且只能靠"读 SR 再读 DR"清除 ⇒ **永不自愈**），与引脚悬空无关；据此补两条硬要求（屏板链路必须真的消费 `DR` 并在 `HAL_UART_ErrorCallback` 里清 ORE 后重挂接收；新日志口设 `UART_MODE_TX` 仍正确，因为那是从机制上摘掉 RX）；③ **§9.13 前置阻塞**由"两条物理前置"改为"一条物理前置（台架串口线挪位）+ 一条实现纪律（RX 要真读、ORE 要真清）"，并写明原"PA10 接线"结论已撤销；第 11 条的验收隐含"拔插 TX 线制造噪声后能自动恢复"。**当年那场 ORE 风暴的真因仍待定**——接线正常时更常见的是对端波特率不匹配或适配器 TX 在 USB 掉线时浮空，下次复现先量空闲电平与波特率，不要再默认"引脚悬空"。**本次只改本文件** |