From d0e73d6553acbdd3aa68ecf845157038c48cf5a7 Mon Sep 17 00:00:00 2001 From: Wanderingss <1624155937@qq.com> Date: Thu, 29 Oct 2026 13:19:12 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=BD=95=E6=B3=A2=E7=AB=8B=E9=A1=B9?= =?UTF-8?q?=E6=B3=A2=E5=8F=8A=E7=9A=84=E5=8F=A3=E5=BE=84=E5=90=8C=E6=AD=A5?= =?UTF-8?q?=EF=BC=88=E7=B4=A2=E5=BC=95=E3=80=81=E7=99=BB=E8=AE=B0=E7=B0=BF?= =?UTF-8?q?=E3=80=81=E9=9C=80=E6=B1=82=E4=B8=8E=20UI=20=E7=8A=B6=E6=80=81?= =?UTF-8?q?=E8=A1=8C=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 任务规划 README 顺序表：录波从「当前不排」移到独立行；动态波形验证让位给录波 数据面（段文件是现成的样本出口）。 登记簿：录波与 104 文件传输拆成两行，前者解除暂缓并指向新文档。 产品需求：立项未排行、录波文件存储行、文件传输行、录波采样率行补偏离登记指针。 UI：页面补齐规划第 26 叶与 UI补齐「不做」表改指故障录波立项，旧重开条件已满足。 短板评测记录链行、ADC前端注入验证流程的读数出口注、图形绘制流程与 tools/arch_diagram/README 的生成器清单同步。 --- docs/README.md | 3 ++- docs/UI设计/页面补齐规划.md | 4 ++-- docs/产品需求/产品需求设计文档.md | 8 ++++---- docs/任务规划/README.md | 10 ++++++---- docs/任务规划/UI补齐.md | 4 ++-- docs/任务规划/登记簿.md | 5 +++-- docs/架构设计/图形绘制流程.md | 3 +++ docs/问题记录/采集与数据处理短板评测.md | 4 ++-- tools/arch_diagram/README.md | 3 +++ 9 files changed, 27 insertions(+), 17 deletions(-) diff --git a/docs/README.md b/docs/README.md index 560cf568..cc5e9faf 100644 --- a/docs/README.md +++ b/docs/README.md @@ -91,6 +91,7 @@ docs/ | [`运行与自检记录设计说明.md`](子系统设计/运行与自检记录设计说明.md) | `/log/run.log`·`selftest.log` 定长记录与待机显示 | | [`看门狗设计说明.md`](子系统设计/看门狗设计说明.md) | IWDG（CubeMX 配置）+ 任务心跳位图：选型与超时推导、掩码与埋点、取证机制、验证记录；已台架闭环（V2/V4/V5）。**§11 = 任务级饥饿的诊断方法与 `[PROF]` 实测基线**（诊断沉淀：判读口径、量化归因、三条脆弱点、明确不做的四条） | | [`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 接入决策/预算与测试方案；协议核心纯逻辑 + 主机侧纯逻辑单测全栈单测 | | [`网络/BSD_Socket_API_使用指南.md`](网络/BSD_Socket_API_使用指南.md) | **上层视图**：BSD Socket API 公开语义、示例、常见问题 | | [`网络/BSD_Socket_API_函数调用关系.md`](网络/BSD_Socket_API_函数调用关系.md) | **内部视图**：netTask / 消息队列 / 保护判据挂起 / 重试对账的调用关系与设计意图 | @@ -241,7 +242,7 @@ docs/ | 位置 | 内容 | |---|---| -| [`任务规划/`](任务规划/README.md) | **统一待办入口（6 个文件）**：`README.md` = 现在做什么与全项目顺序；`UI补齐.md` = 当前唯一执行清单；`登记簿.md` = 后续任务、外部窗口与长期观察；`数据可信.md` = 两项阻塞任务及代码引用的设计约束；`暂缓-RS485.md`、`屏板链路.md` = 两个专项（`测试与架构专项.md` 已删除 2026-10-28，未闭环约束并入 `暂缓-RS485.md`）。完成即删，重复内容只保留一个归属 | +| [`任务规划/`](任务规划/README.md) | **统一待办入口（7 个文件）**：`README.md` = 现在做什么与全项目顺序；`UI补齐.md` = 当前唯一执行清单；`登记簿.md` = 后续任务、外部窗口与长期观察；`故障录波.md` = 录波的卡片与判据（1 kHz · 8 路原始码值 · 单通道回放）；`数据可信.md` = 采集数据可信度的五级台阶与任务卡（含手边可做的动态波形验证）+ 被代码引用的设计约束；`暂缓-RS485.md`、`屏板链路.md` = 两个专项（`测试与架构专项.md` 已删除 2026-10-28，未闭环约束并入 `暂缓-RS485.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/` 生成） | diff --git a/docs/UI设计/页面补齐规划.md b/docs/UI设计/页面补齐规划.md index 11741d8d..4cbbaffc 100644 --- a/docs/UI设计/页面补齐规划.md +++ b/docs/UI设计/页面补齐规划.md @@ -77,7 +77,7 @@ | 22 | 双点遥信 | 可编辑列表 | 开入量 | ❌ 同上 | | 24 | 时钟设置 | 表单（6 字段） | `sys_clock_get_time/set` | ✅ | | 25 | 强制复归 | 操作页（确认） | `prot_elm_request_reset()` | ✅ | -| 26 | 手动录波 | 操作页（确认） | 录波模块 | ❌ 录波未实现 | +| 26 | 手动录波 | 操作页（确认） | 录波模块（docs/任务规划/故障录波.md 已立项） | 🔶 录波立项未落地 | | 27 | 清除记录 | 操作页（选类型 + 确认） | `sys_log`（**缺删除 API**） | 🔶 需补 API | | 29 | 通讯设置 | 可编辑列表（4~6 项） | 104 公共地址/端口/主站（当前固定） | 🔶 需 `comm_cfg` | | 31 | SNTP设置 | 可编辑列表（3 项） | SNTP 客户端 | ❌ 未实现（产品口径亦未定） | @@ -91,7 +91,7 @@ **统计（2026-10-25 复核）**：本表 27 叶中 **6 叶已落地**（遥信量 / 查看 4 页 / SOE），剩 21 叶 = 数据现成 **8** 项（整定 4 + 时钟 + 复归 + 死区 + 系数）· 需新数据层 **2** 项（清除记录 / 通讯设置）· 数据源不存在 **11** 项（遥信 3 + 手动录波 + SNTP + 记录 5 + 运行报告）。**分批与 DoD 见 `docs/任务规划/UI补齐.md`**——本表只讲逐页形态与数据源，不重复排期。 -**2026-10-28 复核**：本表 27 叶中 **22 叶已落地**（本批 +6：记录 5 页与运行报告，见 docs/任务规划/UI补齐.md §2 与 docs/任务规划/登记簿.md §7）；未落地的 5 叶 = 遥信类型 / 遥信防抖 / 双点遥信（无开入硬件）+ 手动录波（无录波模块）+ SNTP设置（产品口径未定），取舍与重开条件见 docs/任务规划/UI补齐.md §5。口径闭合：本表 22 叶 + 立项前就已绑定、不在本表内的 6 叶（装置信息 / 交流量 / 直流量 / 网口设置 / 自检记录 / 运行记录）= 现值已绑 28 叶（= UI_PAGE_MAP_COUNT）；本表未落地 5 叶 = 菜单树未绑 5 叶（33 − 28）。复核方法：按缩进判叶子（有更深缩进后继者即非叶子），再按行内 #page= 数已绑。 +**2026-10-28 复核**：本表 27 叶中 **22 叶已落地**（本批 +6：记录 5 页与运行报告，见 docs/任务规划/UI补齐.md §2 与 docs/任务规划/登记簿.md §7）；未落地的 5 叶 = 遥信类型 / 遥信防抖 / 双点遥信（无开入硬件）+ 手动录波（无录波模块）+ SNTP设置（产品口径未定），取舍与重开条件见 docs/任务规划/UI补齐.md §5。口径闭合：本表 22 叶 + 立项前就已绑定、不在本表内的 6 叶（装置信息 / 交流量 / 直流量 / 网口设置 / 自检记录 / 运行记录）= 现值已绑 28 叶（= UI_PAGE_MAP_COUNT）；本表未落地 5 叶 = 菜单树未绑 5 叶（33 − 28）。复核方法：按缩进判叶子（有更深缩进后继者即非叶子），再按行内 #page= 数已绑。**2026-10-29 补充**：「手动录波」已随故障录波独立立项（docs/任务规划/故障录波.md 与 docs/子系统设计/故障录波设计说明.md），上面那行数字仍是 2026-10-28 当日复核值，未随立项改动 --- diff --git a/docs/产品需求/产品需求设计文档.md b/docs/产品需求/产品需求设计文档.md index dfdcd142..8267ed55 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、定值铺开 | 按 §9.2 顺序 | +| **立项未排** | 多规约、SNTP、定值铺开 | 按 §9.2 顺序；**录波已立项**（2026-10-29）：卡片 docs/任务规划/故障录波.md、设计 docs/子系统设计/故障录波设计说明.md，1 kHz 起步与本文 80 点/周波口径的偏离在该设计文档 §2 显式登记 | | **算力 / 形态**（X1 / X2） | 双核分工、VxWorks | 不解除。**屏板链路已从范围外项移入范围内待做**（规格 §5.16，执行规划 docs/任务规划/屏板链路.md）：主机侧链路与参考 1:1 同构，不属"替代方案" | > **结论**：本产品与参考产品的差距**全部是"进度"而非"范围"**——没有一项是"参考有而我们不做"。 @@ -942,7 +942,7 @@ sequenceDiagram | 遥控选择 / 撤销 / 执行 | ≤5 s | 同轮应答（ms 级） | | 读定值 / 改定值预置 / 执行 | ≤10 s / ≤5 s | 同轮应答（ms 级） | | 读文件目录 / 文件 | ≤30 s | ⬜ 未实现（文件传输未立项） | -| 录波文件存储 | ≤15 s | ⬜ 未实现（录波未立项） | +| 录波文件存储 | ≤15 s | ⬜ 未实现（**已立项**，见 docs/任务规划/故障录波.md：本波按 1 kHz / 8 路 / 单段做，≤15 s 与 80 点口径属二期） | **FR-IEC104-8 单连接与自愈** - 需求：单连接语义（CH395F 单 socket）；断链自动重听；网络重建（改 IP）后服务自愈；协议故障主动拆链。 @@ -958,7 +958,7 @@ sequenceDiagram | 归一化值 / 标度化值上送 | 点表要求短浮点（系数 1），无需另做 | 不适用 | | 双点遥信带时标 | V0.1 双点恒 IV，无意义 | 随开入硬件（X3） | | 定值区切换 / 定值文件下装 | 产品未定义多定值区（参考有 4 区） | 规模型 | -| 文件传输（目录 / 读文件 / 录波） | 录波子系统未开始 | 规模型 | +| 文件传输（目录 / 读文件 / 录波） | 录波已立项，段文件取回走现成 FTP（21 端口）；**规约侧文件服务仍未做** | 规模型 | | 固有参数 `8001H~800AH` | 字符串类无法短浮点上送 | 规模型 | | 主站 IP 白名单 | 单 socket 上"拒绝"= 断链重听，可被扫描打成 SPI 风暴且易锁死真主站 | 不适用 | @@ -2397,7 +2397,7 @@ docs/任务规划/UI补齐.md §5）；原「当前执行 6 项」（记录 5 | 指标 | 参考值（`APP/EquipCfg/Const_Wave.h`） | 说明 | |---|---|---| -| 录波采样率 | `CN_SAM_RATE × CN_WAVE_RATIO` = 20 × 4 = **80 点/周波**（50 Hz 下 4000 Hz） | 保护计算用 20 点/周波，录波要 4 倍过采样才能看清波形 | +| 录波采样率 | `CN_SAM_RATE × CN_WAVE_RATIO` = 20 × 4 = **80 点/周波**（50 Hz 下 4000 Hz） | 保护计算用 20 点/周波，录波要 4 倍过采样才能看清波形。**偏离登记**：本装置先按 1 kHz（20 点/周波）立项，理由与二期不返工的结构约束见 docs/子系统设计/故障录波设计说明.md §2 与 §2.1 | | 录波段数 | `CN_WAVE_SECT_NUM` = **6 段** | 每段独立缓冲，支持连续多次录波 | | 启动前缓冲 | `CN_WAVE_CYCLE_SUM_REFRE_BUF` = **5 周波**（100 ms） | 循环刷新，保证故障前有数据 | | 动作后 | `CN_WAVE_CYCLE_SUM_ACTED` = **10 周波**（200 ms） | | diff --git a/docs/任务规划/README.md b/docs/任务规划/README.md index f4ab631e..38380629 100644 --- a/docs/任务规划/README.md +++ b/docs/任务规划/README.md @@ -60,18 +60,20 @@ docs/测试说明/模拟器差距清单.md §2.3「开机账本 boot_stats」一 | **1** | **UI 补齐** | **清单已清空（2026-10-28）** | 记录 5 页与运行报告页已落地并绑页；余下 5 叶属 §5「当前不做」，重开条件见 docs/任务规划/UI补齐.md §5；上板判据见 docs/任务规划/登记簿.md §7 | | **2** | **net 层跨上下文收口** | **下一顺位（未开工）** | UI 清单已清空，切换条件已满足；**开工需用户点头**——换主线是产品决策，不由本批顺带做掉 | | **3** | 其余结构与可靠性评估 | 排队 | net 收口后；逐项见 `登记簿.md`，观察项不为了“清清单”而强做 | -| **4** | 数据可信剩余两项 | 等待外部资源 | 端子/子板变比确认 → 标准源两点标定（已知电压注入已于 2026-10-27 台架闭环并销项）；资源到位可插入优先处理 | +| **4** | 数据可信（采集数据可信度） | 动态波形验证**手边可做**；变比确认与两点标定等外部资源 | 信号发生器动态波形验证（不依赖外部资源）→ 端子/子板变比确认 → 标准源两点标定；**排序调整（2026-10-29）：动态验证让位给故障录波数据面**，段文件落地后判据升级为 PC 独立重算对表（docs/子系统设计/故障录波设计说明.md §11）（已知电压注入已于 2026-10-27 台架闭环并销项）；外部资源到位可插入优先处理 | | **5** | 标准源送检与第三方 104 主站验收 | 等待标定完成 | 两点标定完成且保护 VALID 已置位；送检窗口前 2 日冻结特性 | | **6** | 保护元件与采集增强 | 等待标准源或硬件改版 | 保护先解除未标定闭锁；三相同时刻类功能等 V0.2 硬件 | | **7** | 验证窗口事项 | 逢条件顺带 | CI runner、PC peer、CH340、负向故障注入条件到位时执行 | -| **8** | 独立模块与暂缓项 | 当前不排 | 开入开出、故障录波、SNTP 单独立项；RS-485 与内存优化按各自重启条件 | +| **8** | 独立模块与暂缓项 | 当前不排 | 开入开出、SNTP、104 文件传输单独立项；RS-485 与内存优化按各自重启条件 | | **独立** | **屏板链路（对上屏板）** | **规划已出（未开工）** | 独立立项，插在任一顺位之间都能做，不占主序列；**端口已裁定（2026-10-28）：屏板占 USART1，日志迁 RS-232 通道**，所以原来的 250 kbps 收发器阻塞已解除；剩下两条前置——**台架串口线挪到 CN1、日志口迁移**（见 docs/任务规划/屏板链路.md §0 与 §3 批 0）；**软件可先用 PC + USB 转 TTL 台架验证，不必等屏板实物** | +| **独立** | **故障录波（1 kHz · 8 路原始码值 · 单通道回放）** | **设计定稿（代码一行未动）** | 用户裁定 2026-10-29 **录波先行**：数据面最小闭环 → 手动与保护启动触发 → 回放页，卡片判据见 docs/任务规划/故障录波.md，口径与设计见 docs/子系统设计/故障录波设计说明.md；**与 UI 道互斥**（菜单树与中文字库是整文件生成物，同刻只允许一条道写） | ### 2.1 关键依赖 - **UI**：写路径、整定 4 页、装置维护 3 页与遥测死区/系数 2 页已收口（含上板判据与真机回读）； 菜单树、页面注册表与字库都是生成物，同刻只允许一条道写。 -- **送检**：已知电压注入（✅ 2026-10-27 闭环）→ 端子/子板变比确认 → 标准源两点标定 → 保护解除闭锁 → 送检。 +- **送检**：已知电压注入（✅ 2026-10-27 闭环）→〔信号发生器动态波形验证 —— 手边可做，与后两关并行、不阻塞送检〕 + → 端子/子板变比确认 → 标准源两点标定 → 保护解除闭锁 → 送检。 - **保护扩展**：标准源未到位前不新增无法验证的判据；跨转换器相位、功率、对称分量类 功能必须等 V0.2 硬件。 - **结构债**：UI 完成后先做 net 收口；RS-485 白名单、内存优化、仓库体积等观察项不抢占 @@ -85,7 +87,7 @@ docs/测试说明/模拟器差距清单.md §2.3「开机账本 boot_stats」一 历史由 `git log` 保留。 2. **当前任务只改 `UI补齐.md`，后续事项只改 `登记簿.md`**；顺序变化才改本文件 §2。 3. `数据可信.md` 的 §2、§4、§7~§10 仍被代码头注释引用为设计依据，不能按“已完成” - 删掉；其待办只认 §5 的两项。 + 删掉；其待办只认 §5 的任务卡表（标识列用语义短语，卡片增减不改本条口径）。 4. 专项文档只放**还没闭环的约束**；已落地事项的规格正文归代码头注释或模块文档， 销项即删文件并把引用改指现行出处（先例：`测试与架构专项.md` 已删除 2026-10-28， 唯一未闭环的「采集链路测试可验证性约束」并入 `暂缓-RS485.md`）。 diff --git a/docs/任务规划/UI补齐.md b/docs/任务规划/UI补齐.md index 5043f303..a268f085 100644 --- a/docs/任务规划/UI补齐.md +++ b/docs/任务规划/UI补齐.md @@ -14,7 +14,7 @@ | 分类 | 数量 | 当前怎么处理 | |---|---:|---| | 无开入硬件 | 3 | 不做：遥信类型、遥信防抖、双点遥信 | -| 缺独立模块或产品定义 | 2 | 不做：手动录波、SNTP 设置 | +| 缺独立模块或产品定义 | 2 | 不做：手动录波（2026-10-29 已随故障录波立项，落地前仍按未绑计）、SNTP 设置 | 现有基础：`ui_w_editor` / `ui_w_setlist` / `ui_page_action` 已就绪；`ui_data` 已扩到**四通道** （rt / par / info + 遥测死区与系数用的第四张注入表）；像素黄金用例与字符集门禁已存在，内容页黄金 @@ -108,7 +108,7 @@ UTC 写入，后写者赢 ⇒ 装置墙钟与主机本地时刻恒差 8 小时 | 项目 | 不做原因 | 重开条件 | |---|---|---| | 遥信类型 / 防抖 / 双点 3 页 | V0.1 无开入硬件，配置没有消费者 | 开入固件立项后，与开入开出一起做 | -| 手动录波 | 录波模块不存在，且工程量口径尚未完成实测闭环 | 故障录波独立立项 | +| 手动录波 | 录波模块尚未落地；旧口径还挂着「工程量口径未闭环」这道前置，**已被「录波存原始码值」解掉**（docs/子系统设计/故障录波设计说明.md §3.2） | **重开条件已满足**（2026-10-29 立项）：随 docs/任务规划/故障录波.md 的「手动触发与保护启动接线」那张卡一起做 | | SNTP 设置 | 当前使用 8888 私有对时协议，SNTP 链路与产品口径均未建立 | SNTP 客户端立项 | | net 层与其他结构债 | 当前只做 UI，避免两条主线互相拖慢 | UI 当前清单完成后，按 README §2 切换 | | RTC 时基统一 | 两套写入口径并存（面板与 8888 写本地钟面、104 写 UTC），恒差 8 小时；统一任一侧都要动 104 上行语义或 UI 判据 | 用户裁定时基方向后，作为跨模块变更单独立项 | diff --git a/docs/任务规划/登记簿.md b/docs/任务规划/登记簿.md index 69053de8..642047db 100644 --- a/docs/任务规划/登记簿.md +++ b/docs/任务规划/登记簿.md @@ -60,7 +60,7 @@ | 条目 | 需要条件 | 要做的事 | 去向 | |---|---|---|---| -| **数据可信两项** | 子板实物或原理图；标准源 | 端子/子板变比确认 → 8 通道两点标定 | 唯一任务卡与验收在 `数据可信.md` §5 | +| **数据可信任务卡** | ① 一台能出 50 Hz 正弦的交流信号发生器（**手边即可，不等外部**）② 子板实物或原理图 ③ 标准源 | 信号发生器动态波形验证 → 端子/子板变比确认 → 8 通道两点标定 | 唯一任务卡与验收在 `数据可信.md` §5 | | **标准源送检与第三方 104 验收** | 两点标定完成、保护 VALID 置位、第三方主站 | 标准源注入判据全部通过；总召、周期、变位、遥控全流程通过；证据归档。送检窗口前 2 日冻结特性 | `../子系统设计/IEC104上行设计说明.md` §7/§8 | | **队列往返基线待重验** | 台架 + PC peer | 下次 Phase 13 窗口重锁基线 | 本文件 §1 | | **网络负向场景台架验证** | 拔线、SPI 故障注入、远显压力条件 | PHY 拔线、芯片级 `net_init` 失败、短写压测 | 本文件 §1 | @@ -79,7 +79,8 @@ | **采集增强** | 等周波调频、零序通道、遥测谐波轨依赖可信工程量 | 标定完成后单独立项 | | **跨转换器三相与功率类功能** | 两片转换器无共同采样触发，V0.1 上相位、功率、对称分量不成立 | V0.2 硬件改版 | | **开入开出与遥信配置 3 页** | 固件和 V0.1 硬件均无可配开入对象；出口还涉及 GPIO 安全电平、保持/脉冲和回读自检 | 开入开出作为独立模块立项，再与 UI 页面同批 | -| **故障录波与 104 文件传输** | 是独立子系统，不是补一个页面 | 产品定义与工程量口径明确后立项 | +| **故障录波** | 独立子系统，不是补一个页面——**2026-10-29 已立项**：卡片与判据 docs/任务规划/故障录波.md，设计与口径 docs/子系统设计/故障录波设计说明.md | 已解除暂缓；执行按该文档 §3 顺序，UI 道互斥 | +| **104 文件传输（规约侧读文件）** | 录波取回走现成 FTP 已够用，规约侧文件服务是另一件事 | 送检或第三方交接需求明确后单独立项 | | **SNTP 设置** | 当前对时走 8888 私有协议，SNTP 客户端与产品口径未定 | SNTP 客户端立项 | | **RS-485 整簇** | 用户决定暂缓 | `暂缓-RS485.md` | diff --git a/docs/架构设计/图形绘制流程.md b/docs/架构设计/图形绘制流程.md index 58e29827..644c8fb0 100644 --- a/docs/架构设计/图形绘制流程.md +++ b/docs/架构设计/图形绘制流程.md @@ -51,6 +51,9 @@ | `gen_watchdog_svg.py` | `docs/images/看门狗心跳模型.svg` | `TASKS` / `REQ_BITS` / `POLL_STEPS` / `TIMELINE` | | `gen_adc_frontend_svg.py` | `docs/images/ADC前端电路.svg` | `SUB1` / `NOTE_*` 等文案常量 + 面板坐标（电路拓扑固定，网表变了才重画） | | `gen_adc_code_scale_svg.py` | `docs/images/ADC码值刻度.svg` | `PANELS` 列表（码范围 / LSB / 实测码标记位置）+ `FOOT`（换芯片才重画） | +| `gen_data_trust_ladder_svg.py` | `docs/images/数据可信台阶.svg` | `STEPS` 五级台阶（状态 / 问题 / 依据）+ `BAND_LABEL_1` / `GATE_LABEL` / `FOOTNOTE`（台阶状态变了才重画） | +| `gen_data_trust_dc_ac_svg.py` | `docs/images/ADC直流标定与交流验证.svg` | `BOXES_A` / `BOXES_B` 两条泳道 + `CHIPS` 六件事 + `NOTES` 红线与"证不到"清单 | +| `gen_wave_record_flow_svg.py` | `docs/images/故障录波数据流.svg` | `CHAIN` 主链四段 + `EDGE` 跨边界标签 + `TRAPS` 三条陷阱 + `FORBID` 四条红线（所有权、段形态或红线变了才重画） | --- diff --git a/docs/问题记录/采集与数据处理短板评测.md b/docs/问题记录/采集与数据处理短板评测.md index dbc332cd..52d598ba 100644 --- a/docs/问题记录/采集与数据处理短板评测.md +++ b/docs/问题记录/采集与数据处理短板评测.md @@ -16,7 +16,7 @@ | 链 | 现状 | 缺什么 | |---|---|---| | **测量链（遥测）** | 104 每 100 ms 直接读相量瞬时值 | 工程量折算、谐波方和根、平均/死区/零漂、品质位 | -| **记录链（录波）** | 只有 64 B 定长 SOE 文本记录 | 波形数据面（4 kHz 过采样）、COMTRADE 文件、104 文件服务 | +| **记录链（录波）** | 只有 64 B 定长 SOE 文本记录 | 波形数据面（**2026-10-29 已按 1 kHz 立项**，docs/任务规划/故障录波.md）、COMTRADE 文件、104 文件服务 | | **就地闭环（开入开出）** | 固件完全没有 | 开入量采集与防抖、遥信变位、遥控出口、跳闸出口 | **四个阻断级短板**（不补则送检必挂）： @@ -179,7 +179,7 @@ **建议动作**（分两步，可分期交付） -- **数据面**：先做 1 kHz 录波（复用现有节拍，8 周波 RAM 环 + 突变量启动），跑通"触发 → 缓存 → 落盘"。这一版能满足"有波形"，但谐波/暂态分析能力弱。 +- **数据面**：先做 1 kHz 录波（复用现有节拍，8 周波 RAM 环 + 突变量启动），跑通"触发 → 缓存 → 落盘"。这一版能满足"有波形"，但谐波/暂态分析能力弱。**已按本条立项**（docs/任务规划/故障录波.md）：采样率与通道集已裁定，突变量启动留二期，触发先做手动与保护启动两路。 - **采样率升级**：若要 80 点/周波，需把 TIM3 提到 4 kHz、保护环按 1/4 抽取、录波环全速。器件不是瓶颈（TPAFE 无过采样时 350 kSPS），瓶颈是 `adcTask` 的 CPU 与 4 倍 RAM——**先实测再定**，不要先改节拍。 - **文件面**：COMTRADE 1999 生成 + 104 文件服务（读目录/读文件/召唤）。 - 规模：**L**（数据面 M，文件面 M，采样率升级另算）。 diff --git a/tools/arch_diagram/README.md b/tools/arch_diagram/README.md index ffe40c2f..730aa19b 100644 --- a/tools/arch_diagram/README.md +++ b/tools/arch_diagram/README.md @@ -18,6 +18,9 @@ | `gen_watchdog_svg.py` | 看门狗心跳模型图 | IWDG + 任务心跳位图（置位→判定→喂狗 + 时间轴） | | `gen_adc_frontend_svg.py` | ADC 前端电路图 | 端子 → 串阻 → 转换节点 → 转换器引脚；含差分负端与 STM32 侧对照 | | `gen_adc_code_scale_svg.py` | ADC 码值刻度图 | 「码」的直观定义：两片转换器的刻度尺对照（16 位双极性 vs 12 位单极性） | +| `gen_data_trust_ladder_svg.py` | 数据可信台阶图 | 采集数据可信度的五级台阶：现在踩在哪一级、下一级挡什么 | +| `gen_data_trust_dc_ac_svg.py` | ADC 直流标定与交流验证图 | 上排直流注入链、下排信号发生器正弦验证，中间列只有正弦能证的六件事 | +| `gen_wave_record_flow_svg.py` | 故障录波数据流图 | 录波段数据的四个所有者与四条「不许」：谁独占写、谁只能读、标志怎么过界 | ## 使用方式