docs(iec60870): 把 104 板端落地文档归入 docs/iec60870/板端落地
四篇讲「本项目怎么接 104」的文档原来散在子系统设计与网络两个目录, 和随库迁入的 36 篇协议库设计混在一起。现集中到 docs/iec60870/板端落地/: - IEC104上行设计说明.md(原 docs/子系统设计/) - IEC104_Net适配契约.md(原 docs/网络/) - IEC104_MCU落地规划.md(原 docs/子系统设计/) - IEC104_MCU最小可行性验证.md(原 docs/子系统设计/) 改动: - 四篇 git mv 保留历史,全库引用经 rename_ref.py 逐篇改写(27 个文件 54 处引用行),旧路径残留扫描为 0。 - docs/README.md:§5.3 改为「IEC 60870-5-104 文档(40 篇)」,拆成 「板端落地 4 篇」与「协议库设计与接口 36 篇」两张表,说明两条轴的分工; 从 §5.1 功能子系统表里移除这三篇的重复条目。 - docs/iec60870/README.md:新增两条轴入口与板端落地表,原阅读顺序 改标注为「协议库部分」。 验证: - check_doc_links.py --all --sections-strict:310 篇 0 问题。 - 三份索引 markdown 链接可达性逐个 exists() 校验,断链 0;索引表覆盖 36 篇协议库文档,与实际磁盘文件双向差集为空。 - 板端落地目录 4 篇 BOM / CR / U+FFFD 均为 0。 - 工作树 Keil 权威构建 0 errors 0 warnings(Code=365896 RO=48336 RW=2736 ZI=173104),此后预提交 21 Passed / 0 Failed。
This commit is contained in:
+1
-1
@@ -41,7 +41,7 @@ FreeRTOS/CMSIS-RTOS API**(本条与「就绪屏障位必须 `osFlagsNoClear`
|
||||
|
||||
改动口径:全部按项目自有代码对待(命名、注释、结构遵循 `docs/代码规范/`);
|
||||
`iec104_*` 是本项目自己的装配与平台层,`IEC104_*` / `IEC60870_*` 是协议主体与共享编解码。
|
||||
设计入口 → `docs/子系统设计/IEC104上行设计说明.md`;目录说明与改动纪律 → [`iec60870/README.md`](iec60870/README.md)。
|
||||
设计入口 → `docs/iec60870/板端落地/IEC104上行设计说明.md`;目录说明与改动纪律 → [`iec60870/README.md`](iec60870/README.md)。
|
||||
|
||||
## 相关文档
|
||||
|
||||
|
||||
@@ -28,7 +28,7 @@ Net 后端,装配代码与它服务的传输层放在一起才能一眼看清
|
||||
`iec104_net_mcu.c`(经 CH395F)实现,模拟器由 `IEC104_Net_Windows.c` 实现。
|
||||
同时链接两份会重复定义符号,或者更隐蔽地链到错的那份——两条路径的阻塞语义完全不同,
|
||||
后者不会报错,只会让时序对不上。板端后端的句柄规则(LISTEN/CLIENT 双槽、代次不变式)
|
||||
见 `docs/网络/IEC104_Net适配契约.md`。
|
||||
见 `docs/iec60870/板端落地/IEC104_Net适配契约.md`。
|
||||
|
||||
**非阻塞 I/O 与部分发送是这一层的前提。** `Slave`/`TcpServer` 假定 Net 后端从不在调用内
|
||||
阻塞,因而发送必须能返回「已写一部分」,由 `SendManager` 记住偏移下轮续写。
|
||||
@@ -46,7 +46,7 @@ Net 后端,装配代码与它服务的传输层放在一起才能一眼看清
|
||||
|
||||
- **它是「标准 DTU 演示表」,不等于现场点表。** 按 IEC 60870-5-104 标准 DTU 的典型配置
|
||||
编排,用于跑通协议栈与主站对点工具,不代表现场实际接线。新旧通信地址相同**不代表
|
||||
语义相同**;当前哪些点真接了硬件来源,见 `docs/子系统设计/IEC104上行设计说明.md`
|
||||
语义相同**;当前哪些点真接了硬件来源,见 `docs/iec60870/板端落地/IEC104上行设计说明.md`
|
||||
的平台接缝章节。
|
||||
- **改点数要同步别处。** 遥信总数的事实来源是 `iec104_dtu_table.h` 的
|
||||
`IEC104_DTU_SP_COUNT`(59)/ `IEC104_DTU_DP_COUNT`(16),遥测为
|
||||
@@ -82,7 +82,7 @@ Net 后端,装配代码与它服务的传输层放在一起才能一眼看清
|
||||
## 5. 相关文档
|
||||
|
||||
- 完整协议栈与目录总览 → [`../README.md`](../README.md)
|
||||
- 板端设计与落地结论 → `docs/子系统设计/IEC104上行设计说明.md`
|
||||
- 板端设计与落地结论 → `docs/iec60870/板端落地/IEC104上行设计说明.md`
|
||||
- 点表与 UI 视图的语义差异 → `docs/UI设计/UI_数据供给设计.md`
|
||||
- Net 适配契约 → `docs/网络/IEC104_Net适配契约.md`
|
||||
- Net 适配契约 → `docs/iec60870/板端落地/IEC104_Net适配契约.md`
|
||||
- 阻塞模型与 `netTask` 调用边界 → `docs/网络/Net层阻塞模型架构设计.md`
|
||||
|
||||
@@ -43,4 +43,4 @@
|
||||
|
||||
- 完整协议栈与目录总览 → [`../../README.md`](../../README.md)
|
||||
- 容量表与 RAM 口径 → [`../../README.md`](../../README.md) §4
|
||||
- 板端落地与已知缺口 → `docs/子系统设计/IEC104上行设计说明.md`、`docs/子系统设计/IEC104_MCU落地规划.md`
|
||||
- 板端落地与已知缺口 → `docs/iec60870/板端落地/IEC104上行设计说明.md`、`docs/iec60870/板端落地/IEC104_MCU落地规划.md`
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
* getter 合法带自愈 + setter 守卫。契约、线程约定与生效语义
|
||||
* (改后重启生效、不挂回调不置事件位、主站地址不做)→
|
||||
* iec104_comm.h 文件头;键表口径 → docs/子系统设计/网络配置说明.md
|
||||
* §3.6;热生效代价分析 → docs/子系统设计/IEC104上行设计说明.md §8。
|
||||
* §3.6;热生效代价分析 → docs/iec60870/板端落地/IEC104上行设计说明.md §8。
|
||||
* 适用平台:STM32F407ZGTx / PC 模拟器(双端编译:模拟器运行期无 104 任务,
|
||||
* 本 TU 不产生行为,按双端注册口径入 CMakeLists 保持构建事实一致)
|
||||
* 创建日期:2026-10-26(道G task-8,「UI 补齐」第 5 项非 UI 前置)
|
||||
|
||||
@@ -20,7 +20,7 @@
|
||||
* (拆链/网络代次重建)自然生效,不必整机重启。不挂段回调、不新增
|
||||
* 事件位、不走 SYS_EVT_NET_RECONFIG(网络代次链语义不同;且 CH395F
|
||||
* 单连接 socket 上"换端口/拒绝重听"= close + re-listen,扫描主机
|
||||
* 可打成风暴,详见 docs/子系统设计/IEC104上行设计说明.md §8)。
|
||||
* 可打成风暴,详见 docs/iec60870/板端落地/IEC104上行设计说明.md §8)。
|
||||
* 主站地址(accept 过滤)本卡**不做**:现无既有消费点,理由同上 §8。
|
||||
* 创建日期:2026-10-26(道G task-8,「UI 补齐」第 5 项非 UI 前置)
|
||||
*/
|
||||
|
||||
@@ -151,7 +151,7 @@ CA,此后 `Find_Point` 在二分查找前先比对 CA,不匹配直接走与
|
||||
|
||||
## 8. 相关文档
|
||||
|
||||
- 板端设计与落地结论 → `docs/子系统设计/IEC104上行设计说明.md`、`docs/子系统设计/IEC104_MCU落地规划.md`
|
||||
- 板端设计与落地结论 → `docs/iec60870/板端落地/IEC104上行设计说明.md`、`docs/iec60870/板端落地/IEC104_MCU落地规划.md`
|
||||
- 网络层阻塞模型与 `netTask` 调用边界 → `docs/网络/Net层阻塞模型架构设计.md`
|
||||
- Net 适配契约(LISTEN/CLIENT 双句柄、代次不变式)→ `docs/网络/IEC104_Net适配契约.md`
|
||||
- Net 适配契约(LISTEN/CLIENT 双句柄、代次不变式)→ `docs/iec60870/板端落地/IEC104_Net适配契约.md`
|
||||
- 目录总览 → [`App/README.md`](../README.md)
|
||||
|
||||
@@ -40,4 +40,4 @@ IOA 各占几个字节以及 ASDU 上限。通用上限是 254;接入本工程
|
||||
|
||||
- 完整协议栈与目录总览 → [`../README.md`](../README.md)
|
||||
- 信息对象与品质位口径在平台侧怎么消费 → `App/algo/meas.h` 的 `MEAS_QDS_*` 注释
|
||||
- ASDU 头与 COT 宽度 → `docs/子系统设计/IEC104上行设计说明.md`
|
||||
- ASDU 头与 COT 宽度 → `docs/iec60870/板端落地/IEC104上行设计说明.md`
|
||||
|
||||
+2
-2
@@ -62,8 +62,8 @@
|
||||
| 事故 | `SYSLOG_ACCIDENT` / `accid.log` | 512 | `App/task/protect_task.c:188` | `asserted` 上升沿**且**该元件跳闸投退项 = 1 |
|
||||
| 保护告警 | `SYSLOG_ALARM` / `alarm.log` | 1024 | 同文件 `191` | `asserted` 上升沿**且**跳闸投退项 = 0 或该元件无此项 |
|
||||
| 保护启动 | `SYSLOG_START` / `start.log` | 1024 | 同文件 `183` | `picked` 上升沿(越限电平,早于/等于动作) |
|
||||
| 操作 | `SYSLOG_OPER` / `oper.log` | 512 | `App/task/default_task.c`(`default_task_func()`,`settings saved`)、`App/log/sys_log_mcu.c`(`s_clear_service()`,清除记录成功)、`App/task/ui_task.c`(`ui_task_maint_oper_note()`,面板操作)、`App/sync/time_sntp.c`(`clock set by SNTP`);宿主侧 `simulator/main.c` 与 `simulator/sim/sim_syslog.c` | 定值**真落盘成功** / 清除记录成功 / 面板运维动作 / SNTP 对时。⚠ 104 侧不再投递:原旧 `App/protocol/iec104/iec104_pts.c` 写 `force reset` 与 `plate in/out`,该实现已于 2026-11-17 割接删除(文件在 2026-11-18 随骨架迁 MCU 移除),骨架阶段不驱动物理出口故无记录(见 `docs/子系统设计/IEC104上行设计说明.md` §0.5) |
|
||||
| 遥控 | `SYSLOG_YK` / `yk.log` | 256 | **当前无生产者**——原写入点旧 `App/protocol/iec104/iec104_pts.c`(`s_src_yk_exec()`:选择段、执行段、非法 DPC、未知 IOA;该文件 2026-11-18 已删除) | ⚠ 骨架阶段**有意不记**:模拟动作绝不驱动物理出口,照旧写"选择/执行"即为伪造记录(判据与后果见 `docs/子系统设计/IEC104上行设计说明.md` §0.5)。恢复记录需新增观测接缝,待另行立项 |
|
||||
| 操作 | `SYSLOG_OPER` / `oper.log` | 512 | `App/task/default_task.c`(`default_task_func()`,`settings saved`)、`App/log/sys_log_mcu.c`(`s_clear_service()`,清除记录成功)、`App/task/ui_task.c`(`ui_task_maint_oper_note()`,面板操作)、`App/sync/time_sntp.c`(`clock set by SNTP`);宿主侧 `simulator/main.c` 与 `simulator/sim/sim_syslog.c` | 定值**真落盘成功** / 清除记录成功 / 面板运维动作 / SNTP 对时。⚠ 104 侧不再投递:原旧 `App/protocol/iec104/iec104_pts.c` 写 `force reset` 与 `plate in/out`,该实现已于 2026-11-17 割接删除(文件在 2026-11-18 随骨架迁 MCU 移除),骨架阶段不驱动物理出口故无记录(见 `docs/iec60870/板端落地/IEC104上行设计说明.md` §0.5) |
|
||||
| 遥控 | `SYSLOG_YK` / `yk.log` | 256 | **当前无生产者**——原写入点旧 `App/protocol/iec104/iec104_pts.c`(`s_src_yk_exec()`:选择段、执行段、非法 DPC、未知 IOA;该文件 2026-11-18 已删除) | ⚠ 骨架阶段**有意不记**:模拟动作绝不驱动物理出口,照旧写"选择/执行"即为伪造记录(判据与后果见 `docs/iec60870/板端落地/IEC104上行设计说明.md` §0.5)。恢复记录需新增观测接缝,待另行立项 |
|
||||
|
||||
- **"哪些元件算跳闸"只有一个真源**:定值表 `g_prot_set_meta` 里的 `PS_*_TRIP`(枚举注释
|
||||
即"0 告警 / 1 跳闸")+ 实例表 `k_pe[]` 的 `trip_ctl` 列。分类入口
|
||||
|
||||
@@ -8,7 +8,7 @@
|
||||
* 触发判据 = 104 遥控的选择 / 执行 / 拒绝(含未知类型与参数越界);
|
||||
* 写入点 = 旧 App/protocol/iec104/iec104_pts.c 的遥控段(该文件 2026-11-18
|
||||
* 已删除);骨架阶段**当前无生产者**——模拟动作绝不驱动物理出口,
|
||||
* 见 docs/子系统设计/IEC104上行设计说明.md §0.5;
|
||||
* 见 docs/iec60870/板端落地/IEC104上行设计说明.md §0.5;
|
||||
* "记录类型 = 日志 ID 本身"(一类记录一个文件,记录体内没有类型字段位,
|
||||
* Lead 裁定 2026-10-26)——本页只读 yk.log 一个文件,不做跨文件混排。
|
||||
* 台架复核已完成(2026-11-06,Issue #53 台架轮、实机 boot 188–193,证据贴 Issue #53 评论):
|
||||
|
||||
@@ -417,7 +417,7 @@ pre-commit run --all-files
|
||||
| `docs/网络/BSD_Socket_API_使用指南.md` | BSD Socket API 使用指南(`net_socket` / `net_select`:线程安全 / 快速开始 / TCP / UDP / I/O 多路复用 / 事件回调 / API 参考 / 常见问题) |
|
||||
| `docs/网络/Net层阻塞模型架构设计.md` | NET 阻塞模型(挂起请求表五路语义,recv 一期 / SEND 二期已落地) |
|
||||
| `docs/网络/网络自愈架构设计.md` | 网络自愈架构(监听重建 / 沉降隔离 / 周期对账) |
|
||||
| `docs/子系统设计/IEC104上行设计说明.md` | IEC 60870-5-104 上行(工厂默认 :2404 监听) |
|
||||
| `docs/iec60870/板端落地/IEC104上行设计说明.md` | IEC 60870-5-104 上行(工厂默认 :2404 监听) |
|
||||
| `docs/子系统设计/ADC采样节拍设计.md` | TIM3 1kHz 采样节拍(两片转换器同源硬件驱动) |
|
||||
| `docs/UI设计/UI_设计架构.md` | LVGL UI 系统架构(菜单 / 内容页 / 内存预算) |
|
||||
| `docs/UI设计/菜单页面设计.md` | 菜单导航行为、数据流与内容页设计 |
|
||||
|
||||
+15
-7
@@ -15,7 +15,7 @@ docs/
|
||||
├── 产品需求/ 产品需求设计文档(需求基线)+ 参考产品复刻明细(逐项差额)
|
||||
├── 架构设计/ 全局架构与设计方法论(含 软件架构与运行时规格 / 硬件规格与能力边界:位表与引脚权威)
|
||||
├── 子系统设计/ 各功能子系统的设计说明
|
||||
├── iec60870/ IEC 60870-5-104 协议库设计与接口文档(36 篇,导航 iec60870/README.md)
|
||||
├── iec60870/ IEC 60870-5-104 文档(40 篇:板端落地 4 + 协议库设计 36,导航 iec60870/README.md)
|
||||
├── 算法/ 傅氏算法与继电保护算法专题
|
||||
├── 网络/ BSD Socket API 使用与内部实现
|
||||
├── 测试说明/ 测试流程与规范 · 单元测试 · 板级测试 · 专项验证 · 测试工具 · 测试数据(六个子目录,导航 `测试说明/README.md`)
|
||||
@@ -96,13 +96,10 @@ docs/
|
||||
| [`看门狗设计说明.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) | **IEC 104 上行规约**:既有板端范围/点表/链路与历史验证;新增成熟共享核心迁入边界、标准演示集合、独立 RAM 参数、模拟动作和虚拟设备时间;真实 TCP 业务与板端替换状态分别说明,不把构建或旧台架结果当新核心验收 |
|
||||
| [`IEC104_MCU落地规划.md`](子系统设计/IEC104_MCU落地规划.md) | **MCU 全功能规划(尚未实施)**:全点、全参数持久化及原子生效、通信切换、电能与严格兼容文件、网络与完整资源调查、逐项审批及分波次全量验收 |
|
||||
| [`屏板链路设计.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 集成点)、调用方契约、设计边界与性能特征 |
|
||||
| [`网络/IEC104_Net适配契约.md`](网络/IEC104_Net适配契约.md) | **104 板端 Net 后端契约**:直译 vendor `Close(client)` 会毁掉监听的**反例**、按槽 role 的映射规则、LISTEN 恒定 / CLIENT 每次新建的双句柄模型、代次不变式、单调不复用句柄、`NET_NO_OS` 编译期边界与已知缺口、证据边界(fake 12/12,CH395F 板端未证) |
|
||||
| [`网络/网络自愈架构设计.md`](网络/网络自愈架构设计.md) | **网络自愈架构 + 监听生命周期**:现状权威描述——根因三层证据与 A′ 出局、ioLibrary 代码级对照、设计原则(不变量 I1~I8)、分层职责与三 tick、reconciler 形态①~⑤ + M3 门、驱动原语、读即清信源审计、FUN_PARA bit3 契约、recv 语义、KeepAlive、参数表与 E 锚点速查、红线、编号发现速查、代码级事实清点、决策记录、`net_listener.c` / `net_events.c` 模块化边界、延后项;审计与实施过程已归档 |
|
||||
| [`网络/网络句柄失效值契约.md`](网络/网络句柄失效值契约.md) | **fd 失效值契约(0 是合法句柄)**:220 banner 误导链、三层根因(失效值落合法域 / 数值形态判据 / 主机假 fd 域不同域)+「MISRA 9.1 与 cppcheck 为何抓不到」、契约条款 C1~C7 各带正反例、提交门禁 `net-handle` 的 R1~R5 与失败读法、新代码接入八条自查清单 |
|
||||
|
||||
@@ -120,10 +117,21 @@ docs/
|
||||
|
||||
---
|
||||
|
||||
### 5.3 IEC 60870-5-104 协议库文档(`docs/iec60870/`,36 篇)
|
||||
### 5.3 IEC 60870-5-104 文档(`docs/iec60870/`,40 篇)
|
||||
|
||||
入口:[`iec60870/README.md`](iec60870/README.md)——按「想干什么」组织的导航(构建、点表、召唤、遥控、参数、文件、升级、历史、录波、日志、排障)。
|
||||
这批文档随 104 协议库从 `IEC60870-Slave/docs/` 迁入本仓文档库(2026-11-18),文中指向源码的链接已改指 `App/iec60870/`;**标「本项目未实现」的 7 篇是能力参考,不代表功能可用**。
|
||||
这个目录里有两条轴:**板端落地**是本项目自己的约定(怎么接、接成什么样),**协议库设计**是库内部各模块怎么实现(随库从 `IEC60870-Slave/docs/` 迁入,文中指向源码的链接已改指 `App/iec60870/`,标「本项目未实现」的 7 篇只是能力参考)。
|
||||
|
||||
**板端落地(本项目自有,4 篇)**
|
||||
|
||||
| 文档 | 内容 |
|
||||
|---|---|
|
||||
| [`iec60870/板端落地/IEC104上行设计说明.md`](iec60870/板端落地/IEC104上行设计说明.md) | **104 上行规约基线**:范围、点表、链路流程、板端接入、RAM/栈预算与测试方案;含成熟核心迁入后的状态与验证边界(§0) |
|
||||
| [`iec60870/板端落地/IEC104_Net适配契约.md`](iec60870/板端落地/IEC104_Net适配契约.md) | **板端 Net 后端契约**:直译 vendor `Close(client)` 会毁掉监听的**反例**、按槽 role 的映射规则、LISTEN 恒定 / CLIENT 每次新建的双句柄模型、代次不变式、`NET_NO_OS` 编译期边界与证据边界 |
|
||||
| [`iec60870/板端落地/IEC104_MCU落地规划.md`](iec60870/板端落地/IEC104_MCU落地规划.md) | **MCU 全功能规划(尚未实施)**:全点、全参数持久化及原子生效、通信切换、电能与严格兼容文件、网络与完整资源调查、逐项审批及分波次全量验收 |
|
||||
| [`iec60870/板端落地/IEC104_MCU最小可行性验证.md`](iec60870/板端落地/IEC104_MCU最小可行性验证.md) | **最小可行性验证记录**:已批准工作包的隔离验证结果与资源域 STOP 结论;记录当时的决策与证据,不是产品落地完成报告 |
|
||||
|
||||
**协议库设计与接口(随库迁入,36 篇)**
|
||||
|
||||
| 文档 | 内容 |
|
||||
|---|---|
|
||||
@@ -164,7 +172,7 @@ docs/
|
||||
| [`iec60870/104/README.md`](iec60870/104/README.md) | 104 目录自身说明:文件分工、关键约束、平台适配层 |
|
||||
| [`iec60870/README.md`](iec60870/README.md) | 本批文档的总导航(按目的索引) |
|
||||
|
||||
> **与项目自有 104 文档的关系**:[`子系统设计/IEC104上行设计说明.md`](子系统设计/IEC104上行设计说明.md) 讲**板端怎么接**(点表、数据源、Net 后端、验收状态);本节这批讲**协议库内部怎么实现**。两者不重复:前者是本项目约定与落地状态,后者是协议模块的设计推理。
|
||||
> **两条轴的分工**:`板端落地/` 讲**本项目怎么接**(点表、数据源、Net 后端、资源与验收状态),是项目约定与落地状态的唯一出处;下面这批讲**协议库内部怎么实现**,是模块设计推理。两者不重复。
|
||||
|
||||
## 6. 测试说明
|
||||
|
||||
|
||||
+21
-3
@@ -1,10 +1,28 @@
|
||||
# 文档索引
|
||||
|
||||
说明文档统一放在 `docs/`,源码分别位于根目录的 `104/`、`common/`、`examples/` 和 `test/`。目录总览及快速构建入口见[项目 README](../README.md)。本文中的文档链接相对于当前文件;文档内的构建命令均从项目根目录执行。
|
||||
目录总览见[项目文档索引](../README.md)。本文中的文档链接相对于当前文件;文档内的构建命令均从项目根目录执行。
|
||||
|
||||
## 推荐阅读顺序
|
||||
这个目录有两条轴,先认准是哪一条:
|
||||
|
||||
专用示例的点表、定值、运行与恢复见 [DTU 配置演示](examples/DTU配置演示.md),验证入口见 [DTU 测试](test/IEC104测试文档.md#dtu-tests)。
|
||||
| 轴 | 位置 | 讲什么 |
|
||||
|---|---|---|
|
||||
| **本项目板端落地** | [`板端落地/`](板端落地/) | 本项目自己怎么写:104 上行基线(范围/点表/链路/接入/预算)、板端 Net 后端契约、MCU 落地规划、最小可行性验证记录 |
|
||||
| **协议库设计与接口** | `104/` `common/` `examples/` `test/` | 协议库各模块内部怎么实现(随库迁入,源码落点 `App/iec60870/`) |
|
||||
|
||||
要判断「这块功能在本项目能不能用」,看 `板端落地/`;要理解「协议库内部某个模块怎么工作」,看下面这批。
|
||||
|
||||
## 板端落地(本项目自有,4 篇)
|
||||
|
||||
| 文档 | 内容 |
|
||||
|---|---|
|
||||
| [104 上行设计说明](板端落地/IEC104上行设计说明.md) | 范围、点表、链路流程、板端接入、RAM/栈预算与测试方案;含成熟核心迁入后的状态与验证边界 |
|
||||
| [104 板端 Net 适配契约](板端落地/IEC104_Net适配契约.md) | 把库的 `IEC104_Net.h` 后端 ABI 接到 `net_*` 的规则、双句柄模型、代次不变式与证据边界 |
|
||||
| [MCU 全功能落地规划](板端落地/IEC104_MCU落地规划.md) | 全点、全参数持久化、通信切换、电能与文件服务、资源调查与分波次验收(尚未实施) |
|
||||
| [MCU 最小可行性验证](板端落地/IEC104_MCU最小可行性验证.md) | 已批准工作包的隔离验证结果与资源域 STOP 结论(决策记录,不是落地完成报告) |
|
||||
|
||||
## 推荐阅读顺序(协议库部分)
|
||||
|
||||
以下是协议库内部的阅读路径,源码落点见上文。专用示例的点表、定值、运行与恢复见 [DTU 配置演示](examples/DTU配置演示.md),验证入口见 [DTU 测试](test/IEC104测试文档.md#dtu-tests)。
|
||||
|
||||
<a id="firmware-update-guide"></a>
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
> **定位**:记录已批准的最小可行性工作包及隔离验证结果,不是 MCU 产品落地完成报告。
|
||||
> **状态**:网络、持久化与文件机制已完成隔离验证并经独立审查接受;资源域已终版审查并接受,结论为 STOP(见 `ci-artifacts/iec104-mcu-feasibility/resources/STOP.md`)。机制通过与资源停止结论分开,不表示 MCU 产品可部署。
|
||||
> **关联规划**:`docs/子系统设计/IEC104_MCU落地规划.md`;本报告补充新发现,不改写已冻结规划及历史产物。
|
||||
> **关联规划**:`docs/iec60870/板端落地/IEC104_MCU落地规划.md`;本报告补充新发现,不改写已冻结规划及历史产物。
|
||||
|
||||
## 1. 固定一次验证范围,避免可行性工作包扩成无限优化
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
> **定位**:把已验证的模拟器共享核心推进到微控制器(MCU)产品所需的实施决策与验收方案,**不是实现完成报告**。
|
||||
> **状态**:四域冻结调查汇总,待独立审查;明确推荐是实施决策依据,不表示方案已实现、资源已满足或产品改动获批。
|
||||
> **现状入口**:`docs/子系统设计/IEC104上行设计说明.md`;本文不改写既有模拟器和板端历史验证结论。
|
||||
> **现状入口**:`docs/iec60870/板端落地/IEC104上行设计说明.md`;本文不改写既有模拟器和板端历史验证结论。
|
||||
|
||||
## 1. 先固定全量交付边界,避免分批实施被误当成缩减产品范围
|
||||
|
||||
@@ -307,7 +307,7 @@
|
||||
|---|---|
|
||||
| 主机侧纯逻辑单测 | `test/host/iec104/`(已删除 2026-11-18):APCI 重组/坏帧、STARTDT 握手、总召全流程(含 RBT/分片/预算)、COV、k/w 窗、t1/t2/t3(假时基)、遥控两段式与 PN、YK12 软压板两段转真 + 置脏(保护定值持久化)、定值两段写 + set_sealed 后 selfcheck、C_RD(含本地项不可寻址)、C_CS(含闰年)、错地址/错类型 EVI;**板端默认源真实链**(ring→phasor→freq→meas 快照,非桩):值/品质透传、CLIPPED→IV、0x401D 绑频(收敛 ±0.02 Hz / 未新鲜 IV)、死区运行时化 + 2 点确认/回摆撤销、seq 去重(104 改读快照与频率点绑定,TC-IEC104-025~028)+ 运行参数段路由/两段式/RMW(TC-IEC104-029)+ `[comm]` 段真链(道G task-8,TC-IEC104-031~033:注册/出厂模板/沉降重载/带外自愈/setter 守卫/ca 端到端 = C_RD 正答与旧写死 ca=1 转 COT13+EVI);`test/host/iec104_serv/`(已不存在,2026-11-18 复核)钉端口与 ca 取值来源(TC-I104SRV-001b/c);`test/host/cfg_file/` 钉段/键容量上限(TC-CONFIG-056/057);`test/host/run_par/`:[run_par] 注册/落盘往返/守卫/系数直通合法带(TC-RUNPAR-001~008);`test/host/prot_set/`:blob 往返 + 损坏整表拒绝(all-or-nothing)|
|
||||
| 静态门禁 | `iec104-unit-test` 钩子 + cppcheck/coding-standard |
|
||||
| 台架 | `/serial-boot-test` 锚点(104 服务启动/监听行);**PC 主站客户端 `test/host/bench/iec104/iec104_master.py`(纯标准库,台架复测 2026-10-12 就绪)**:STARTDT/总召四组+actterm/C_SE 定值两段写→YX15·16 变位(COT=3)/恢复复归/YK11 两段正答/C_RD 读回,台架往返 **18/18 PASS**(证据 `../测试说明/测试数据/boot_log_data/20261012_B6_iec104_roundtrip_log.txt`);**保护定值持久化模式 `--b7-pre/--b7-post/--b7-mark/--b7-check`**(中间 ST-LINK 复位):YK12 两段投退→保护退出/联动、**定值与压板态跨复位保持**(含非默认 7.5 往返),**21/21 + 13/13 + 4/4+4/4 PASS**(证据 `../测试说明/测试数据/boot_log_data/20261012_B7_iec104_persist_log.txt`);**SOE 记录腿**(同工具同轮回归):自发 YX 断言 **M_SP_TB_1 带 ts**(工具解析 type 30/1 双型)+ FTP 下载 `/log/soe.log` 经 `test/host/soe/decode_soe.py` 解码断言(校验和/seq 单调/CP56↔epoch UTC 交叉),pre 21/21 + post 13/13 不回归;lib60870 级第三方全流程归 第三方送检验收 |
|
||||
| 台架 | `/serial-boot-test` 锚点(104 服务启动/监听行);**PC 主站客户端 `test/host/bench/iec104/iec104_master.py`(纯标准库,台架复测 2026-10-12 就绪)**:STARTDT/总召四组+actterm/C_SE 定值两段写→YX15·16 变位(COT=3)/恢复复归/YK11 两段正答/C_RD 读回,台架往返 **18/18 PASS**(证据 `../../测试说明/测试数据/boot_log_data/20261012_B6_iec104_roundtrip_log.txt`);**保护定值持久化模式 `--b7-pre/--b7-post/--b7-mark/--b7-check`**(中间 ST-LINK 复位):YK12 两段投退→保护退出/联动、**定值与压板态跨复位保持**(含非默认 7.5 往返),**21/21 + 13/13 + 4/4+4/4 PASS**(证据 `../../测试说明/测试数据/boot_log_data/20261012_B7_iec104_persist_log.txt`);**SOE 记录腿**(同工具同轮回归):自发 YX 断言 **M_SP_TB_1 带 ts**(工具解析 type 30/1 双型)+ FTP 下载 `/log/soe.log` 经 `test/host/soe/decode_soe.py` 解码断言(校验和/seq 单调/CP56↔epoch UTC 交叉),pre 21/21 + post 13/13 不回归;lib60870 级第三方全流程归 第三方送检验收 |
|
||||
|
||||
## 8. V0.1 限制与待办(如实登记)
|
||||
|
||||
@@ -640,7 +640,7 @@ flowchart LR
|
||||
### 5.15 IEC 60870-5-104 上行(FR-IEC104)✅
|
||||
|
||||
本产品为**被控站(受控端)**:104 **TCP 服务器**,端口 `[comm]` 段 `port`(工厂默认 **2404**),主站主动连入。
|
||||
点表口径见 §6.8,设计细节见 [`docs/子系统设计/IEC104上行设计说明.md`](../子系统设计/IEC104上行设计说明.md)。
|
||||
点表口径见 §6.8,设计细节见 [`docs/iec60870/板端落地/IEC104上行设计说明.md`](../iec60870/板端落地/IEC104上行设计说明.md)。
|
||||
|
||||
**FR-IEC104-1 链路层**
|
||||
- 需求:APCI U/S/I 帧、STARTDT/STOPDT/TESTFR、k/w 窗、t1/t2/t3;TCP 流重组与坏帧自恢复。
|
||||
@@ -1215,7 +1215,7 @@ for (i = 1; i < LED_COUNT; i++) /* LE
|
||||
| FTP | TCP **21** | 文件上传/下载(根目录 `/`,NAND 存储) | 登录后任意 FTP 客户端列目录/读写(鉴权见 §7.6) |
|
||||
| 墙钟对时(SNTP 客户端) | UDP 出向 **123**(主/备服务器 `[sntp]` 段,enable=0 出厂默认) | 设备主动取 NTP 源时间写 RTC(:8888 推送监听**已删除**,2026-11-04,§6.3) | 使能后核对设备时间 / 日志时间戳与 `[SNTP] step offset=` 留痕 |
|
||||
| 远程显示(RemoDispBus) | TCP **7003** | 远端看图(160×160 1bpp)+ 远端导航按键 | DTU-RemoteLCD 或任意 TCP 客户端连 7003 收帧 |
|
||||
| IEC 60870-5-104 上行 | TCP **工厂默认 2404** | 被控站接入:遥测/遥信上送、总召、遥控/定值下发(点表见 §6.8) | 任意 104 主站连 2404,STARTDT+总召往返(→ `docs/子系统设计/IEC104上行设计说明.md`) |
|
||||
| IEC 60870-5-104 上行 | TCP **工厂默认 2404** | 被控站接入:遥测/遥信上送、总召、遥控/定值下发(点表见 §6.8) | 任意 104 主站连 2404,STARTDT+总召往返(→ `docs/iec60870/板端落地/IEC104上行设计说明.md`) |
|
||||
|
||||
> **现场组网要求**:设备与客户端**同网段**(默认 .100/24、网关 .1);跨网段先改 IP 再上线。
|
||||
|
||||
@@ -1354,7 +1354,7 @@ mac=00:00:00:00:00:00
|
||||
### 6.8 IEC 60870-5-104 点表摘要
|
||||
|
||||
> **权威口径**:验收以《检测平台配电终端送检要求(点表)》为准;本表是 V0.1 实现摘要,
|
||||
> 逐点细节与未实现项见 [`docs/子系统设计/IEC104上行设计说明.md`](../子系统设计/IEC104上行设计说明.md) §3。
|
||||
> 逐点细节与未实现项见 [`docs/iec60870/板端落地/IEC104上行设计说明.md`](../iec60870/板端落地/IEC104上行设计说明.md) §3。
|
||||
> **段基址与参考产品逐字对齐**(8 段全表见 复刻明细 §1):遥信 `0x0001`、保护 `0x1001`、遥测 `0x4001`、
|
||||
> 参数 `0x5001`、遥控 `0x6001`、设定 `0x6201`、电能 `0x6401`、步位置 `0x6601`。
|
||||
> **点表规模是当前最大差距**:本产品 9 遥测 / 33 遥信 / 2 遥控,参考产品 31 遥测 / 138 开入 / 31 开出。
|
||||
@@ -1397,7 +1397,7 @@ mac=00:00:00:00:00:00
|
||||
> 同期(13)、看门狗(63)、遥测越限(10)等整单元(复刻明细 §1)。
|
||||
|
||||
**链路参数**:k=12 / w=8 / t1=15 s / t2=10 s / t3=20 s;IOA 3 字节、公共地址 2 字节、传送原因 2 字节;
|
||||
公共地址与端口可配(`[comm]` 段,工厂默认 1 / 2404)。**生效语义**(用户裁定 2026-10-30):两者都按「保存即生效」要求;现实现 = 公共地址改后重启、端口下次重 bind 才生效;差距的代码语义与重 bind 时机见 `docs/子系统设计/IEC104上行设计说明.md` §8。
|
||||
公共地址与端口可配(`[comm]` 段,工厂默认 1 / 2404)。**生效语义**(用户裁定 2026-10-30):两者都按「保存即生效」要求;现实现 = 公共地址改后重启、端口下次重 bind 才生效;差距的代码语义与重 bind 时机见 `docs/iec60870/板端落地/IEC104上行设计说明.md` §8。
|
||||
|
||||
---
|
||||
|
||||
@@ -1826,7 +1826,7 @@ pre-commit run --all-files
|
||||
| ADC 采样节拍与 DMA | [`docs/子系统设计/ADC采样节拍设计.md`](../../docs/子系统设计/ADC采样节拍设计.md) |
|
||||
| ADC 通道映射与实测 | [`docs/硬件平台/ADC通道映射说明.md`](../../docs/硬件平台/ADC通道映射说明.md) |
|
||||
| ADC 前端注入验证流程 | [`docs/测试说明/专项验证/ADC前端注入验证流程.md`](../测试说明/专项验证/ADC前端注入验证流程.md) |
|
||||
| IEC 60870-5-104 上行 | [`docs/子系统设计/IEC104上行设计说明.md`](../../docs/子系统设计/IEC104上行设计说明.md) |
|
||||
| IEC 60870-5-104 上行 | [`docs/iec60870/板端落地/IEC104上行设计说明.md`](../iec60870/板端落地/IEC104上行设计说明.md) |
|
||||
| 数据可信(标定 / 快照 / 运行参数) | [`docs/算法/采集与算法层设计说明.md`](../算法/采集与算法层设计说明.md) §13 |
|
||||
| 页面补齐规划 | [`docs/UI设计/页面补齐规划.md`](../../docs/UI设计/页面补齐规划.md) |
|
||||
| 条目命名与编号规则 | [`docs/文档规范.md`](../../docs/文档规范.md) §7.1 |
|
||||
|
||||
@@ -141,7 +141,7 @@ write=1
|
||||
|
||||
遥测死区 9 点的持久载体(引擎属主 defaultTask;**现场远程写入口 = 104 段
|
||||
`0x8030~0x8038`**,本段键供 FTP 手改 / 排障直读,逐项语义与地址表 →
|
||||
`docs/子系统设计/IEC104上行设计说明.md` §3.4)。**值 = 工程量毫单位 int32 有符号**
|
||||
`docs/iec60870/板端落地/IEC104上行设计说明.md` §3.4)。**值 = 工程量毫单位 int32 有符号**
|
||||
(`db_ua=500` 即 0.5 V;电流域 `db_ia=5` 即 0.005 A;频率域 `db_freq=500` 即 0.5 Hz)。
|
||||
|
||||
| 键 | 通道 | 工厂默认 | 104 写路径合法域(毫单位) |
|
||||
@@ -177,7 +177,7 @@ write=1
|
||||
端口另在下次重 bind(拆链/代次重建)自然生效。不挂段回调、不新增事件位——
|
||||
CH395F 单连接 socket 上「换端口/拒绝重听」= close + re-listen,做成热生效
|
||||
会被端口扫描打成 SPI/看门狗风暴(详论 → 本段只登记,正文唯一详述处 =
|
||||
`docs/子系统设计/IEC104上行设计说明.md` §8)。
|
||||
`docs/iec60870/板端落地/IEC104上行设计说明.md` §8)。
|
||||
- **主站地址(accept 侧 IP 白名单)本段不做**:无既有消费点 + 上述拒绝代价 +
|
||||
配错即锁死真主站,待送检/现场需求立项;读者勿假设该键已存在。
|
||||
- 落盘:UI 保存(task-9)经 `net_cfg_save_request()` → `SYS_EVT_CFG_SAVE` 整档
|
||||
|
||||
@@ -66,7 +66,7 @@ epoch 定宽 10 位是因为 2001-09-23 起 Unix 秒已是 10 位;uint32 到 2
|
||||
| `/log/alarm.log` | `SYSLOG_ALARM` | 保护告警(告警型元件动作) | 1024 条(64 KB) | 同上 |
|
||||
| `/log/start.log` | `SYSLOG_START` | 保护启动(越限电平上升沿) | 1024 条(64 KB) | 同上 |
|
||||
| `/log/oper.log` | `SYSLOG_OPER` | 操作(改动了装置状态的运维动作) | 512 条(32 KB) | 同上 |
|
||||
| `/log/yk.log` | `SYSLOG_YK` | ⚠ 原为遥控(104 命令的选择/执行/拒绝);该写入点随 2026-11-17 通信骨架割接删除,**当前无生产者**,骨架阶段有意不记(不驱动物理出口,照旧写即为伪造),见本文档 §2.2 与 `docs/子系统设计/IEC104上行设计说明.md` §0.5 | 256 条(16 KB) | 同上 |
|
||||
| `/log/yk.log` | `SYSLOG_YK` | ⚠ 原为遥控(104 命令的选择/执行/拒绝);该写入点随 2026-11-17 通信骨架割接删除,**当前无生产者**,骨架阶段有意不记(不驱动物理出口,照旧写即为伪造),见本文档 §2.2 与 `docs/iec60870/板端落地/IEC104上行设计说明.md` §0.5 | 256 条(16 KB) | 同上 |
|
||||
|
||||
- **上限是逻辑上限,不是预分配**:文件按追加写自然增长,一条不写就不占簇;到顶才删除重建(串口打 `cap full, recreate`)。七类全满的名义峰值 = 4864 条 × 64 B = **304 KB**,相对 NAND 容量可忽略,且这些只在事件边沿写。
|
||||
- 告警/启动给到 1024 条,是因为一次故障会连片触发多个元件,别让最能说明故障过程的两类最先被截掉。
|
||||
|
||||
+1
-1
@@ -395,7 +395,7 @@ flowchart LR
|
||||
| ADC 通道映射(网名/板级/通道号 13 路置换) | `docs/硬件平台/ADC通道映射说明.md` |
|
||||
| 故障录波(数据面/段格式/回放契约) | `docs/子系统设计/故障录波设计说明.md` |
|
||||
| 屏板链路(USART1 主出口 / 帧 A 帧 B / 实测证据) | `docs/子系统设计/屏板链路设计.md` |
|
||||
| IEC 60870-5-104 上行(默认 :2404,可经 `[comm]` 改) | `docs/子系统设计/IEC104上行设计说明.md` |
|
||||
| IEC 60870-5-104 上行(默认 :2404,可经 `[comm]` 改) | `docs/iec60870/板端落地/IEC104上行设计说明.md` |
|
||||
| 配置文件引擎(/config.ini 多段注册制) | `docs/子系统设计/配置文件设计.md` |
|
||||
| 运行与自检记录(64B 记录 + SOE) | `docs/子系统设计/运行与自检记录设计.md` |
|
||||
| 墙钟时间维护 | `docs/子系统设计/系统墙钟时间维护说明.md` |
|
||||
|
||||
@@ -74,7 +74,7 @@
|
||||
|
||||
### 2.4 IEC104 显式共享核心模式
|
||||
|
||||
`--iec104` 在同一 `lvgl_sim.exe` 中启用成熟 Slave/TcpServer 的真实 TCP 路径;按新增授权监听 `0.0.0.0`,即所有 IPv4 网卡。主站连接宿主实际 IPv4 地址(例如 `192.168.31.13`),不连接 `0.0.0.0`;程序不自动修改防火墙,仅应在可信内网使用,尚未证明另一台机器连接通过。它与上文默认 UI/黄金模式分开,也不替换旧板端 `iec104_serv.c`。以下哈希及本机回环测试是监听范围变更前历史证据,不代表新二进制或跨机验证,历史产物不重写。历史冻结哈希 `d2285bbc68ce4353c814dbcc455a2083b56e81fc54bf88081402e821c6a92833` 的审查人独立 TCP 复跑 11 项通过,证据 `ci-artifacts/iec104-review/tcp-final/report.json`;同哈希黄金菜单 8 状态与内容 76 页回归通过,证据 `ci-artifacts/iec104-sim-menu-release.log`、`ci-artifacts/iec104-sim-content-release.log`,未刷新参考。**仅模拟器首个里程碑通过**,不能写成全部门禁、板端替换或旧栈删除完成。详细状态见 `docs/子系统设计/IEC104上行设计说明.md` §0。
|
||||
`--iec104` 在同一 `lvgl_sim.exe` 中启用成熟 Slave/TcpServer 的真实 TCP 路径;按新增授权监听 `0.0.0.0`,即所有 IPv4 网卡。主站连接宿主实际 IPv4 地址(例如 `192.168.31.13`),不连接 `0.0.0.0`;程序不自动修改防火墙,仅应在可信内网使用,尚未证明另一台机器连接通过。它与上文默认 UI/黄金模式分开,也不替换旧板端 `iec104_serv.c`。以下哈希及本机回环测试是监听范围变更前历史证据,不代表新二进制或跨机验证,历史产物不重写。历史冻结哈希 `d2285bbc68ce4353c814dbcc455a2083b56e81fc54bf88081402e821c6a92833` 的审查人独立 TCP 复跑 11 项通过,证据 `ci-artifacts/iec104-review/tcp-final/report.json`;同哈希黄金菜单 8 状态与内容 76 页回归通过,证据 `ci-artifacts/iec104-sim-menu-release.log`、`ci-artifacts/iec104-sim-content-release.log`,未刷新参考。**仅模拟器首个里程碑通过**,不能写成全部门禁、板端替换或旧栈删除完成。详细状态见 `docs/iec60870/板端落地/IEC104上行设计说明.md` §0。
|
||||
|
||||
| 差距 | 模拟器行为 | 真机行为 | 影响 | 回归补测 |
|
||||
|---|---|---|---|---|
|
||||
|
||||
@@ -11,7 +11,7 @@
|
||||
> [`测试开发标准流程.md`](../流程与规范/测试开发标准流程.md)(测试分层与门禁总览)、
|
||||
> [`主机单测覆盖率口径.md`](主机单测覆盖率口径.md)(覆盖率总闸如何收编本套)、
|
||||
> [`系统墙钟时间维护说明.md`](../../子系统设计/系统墙钟时间维护说明.md)(`docs/子系统设计/系统墙钟时间维护说明.md` §13.1——同一块 70 B 用户 SRAM 的占用分配表,本模块占 0..7)、
|
||||
> [`../../子系统设计/IEC104上行设计说明.md`](../../子系统设计/IEC104上行设计说明.md)
|
||||
> [`../../iec60870/板端落地/IEC104上行设计说明.md`](../../iec60870/板端落地/IEC104上行设计说明.md)
|
||||
> (同一张运行报告页的另一半数据源:104 观测计数)
|
||||
|
||||
---
|
||||
|
||||
@@ -403,7 +403,7 @@
|
||||
9 路对外可控开出分别对应"跳闸""告警""闭锁"还是别的含义,**不在本文档定义**(供电使能 bit6 由驱动自动算出,不在此列)。这是保护逻辑层的职责,去向:
|
||||
|
||||
- 保护判据与动作逻辑 → `docs/算法/采集与算法层设计说明.md`、`docs/算法/继电保护功能复现规划.md`
|
||||
- 104 规约的遥信/遥控点表 → `docs/子系统设计/IEC104上行设计说明.md`
|
||||
- 104 规约的遥信/遥控点表 → `docs/iec60870/板端落地/IEC104上行设计说明.md`
|
||||
|
||||
在业务层把这些定义清楚之前,**这些开出只能用于台架验证,不得用于真实跳闸**;新增 6 脚的真实去向尚未由网表确认,PC15 仅作信号位。
|
||||
|
||||
@@ -418,7 +418,7 @@
|
||||
| 未接入项 | 现状 | 去向 |
|
||||
|---|---|---|
|
||||
| 开入去抖 | 未实现 | 业务层接线任务,落点在 `App/task/default_task.c` |
|
||||
| 开入 → 104 遥信点表 | 未接入 | `docs/子系统设计/IEC104上行设计说明.md` |
|
||||
| 开入 → 104 遥信点表 | 未接入 | `docs/iec60870/板端落地/IEC104上行设计说明.md` |
|
||||
| UI 遥信配置页(遥信类型/防抖/双点遥信) | 三叶未绑,原因是**缺数据源**而非缺硬件 | `docs/UI设计/页面补齐规划.md` |
|
||||
|
||||
---
|
||||
|
||||
@@ -411,7 +411,7 @@
|
||||
>
|
||||
> **2026-10-25 运行参数段落实进度**:这一项已落 `App/algo/run_par.c`——本仓自定逐项地址
|
||||
> 0x8030~0x8038(死区 9 点)/ 0x8040~0x804F(k/b 覆盖直通 adc_cal),表与理由见
|
||||
> `docs/子系统设计/IEC104上行设计说明.md` §3.4;**送检点表到位后以送检为准替换常量段**。
|
||||
> `docs/iec60870/板端落地/IEC104上行设计说明.md` §3.4;**送检点表到位后以送检为准替换常量段**。
|
||||
> 变比/报警/录波/功率置负等其余运行参数类项目前无消费者,留白不预埋。
|
||||
>
|
||||
> **2026-10-11 落实进度**:`App/algo/prot_set.c` 已建 RAM 模型(Q10 定点,31 项),**通讯地址逐项对照参考 `Comm/Pub/Const_CommSetPara.c` `g_tCommSetParaTab`**(基址 0x8820:过流 Ⅰ/Ⅱ/Ⅲ = 0x8856~0x8861、过负荷 = 0x8871~0x8874、零序过压 = 0x888E~0x8890;过压/欠压沿用告警段 0x8027~0x802A)。⚠ **默认值/范围为拟定值**(参考 EEPROM 出厂默认表不在本仓库,按 DTU 馈线典型量级拟定),待对照参考出厂表逐项修订。
|
||||
|
||||
@@ -65,7 +65,7 @@
|
||||
| 保护判据 | 9 元件(三段过流/过负荷/过压/欠压/零序过压/过频/低频) | 复现规划 §3.3(「三段式相间过流」~「零序过压」) |
|
||||
| 出口与记录 | SOE + 动作记录(64 B 定长、CP56 时标、SPSC 环异步落盘) | 复现规划 §3.4(「SOE 记录」) |
|
||||
| 动作留痕 | 定值校验和 + 持久化 + 全局软压板 + 采样故障闭锁 | 复现规划 §3.5(「定值校验和」) |
|
||||
| 上行 | 104 总召/变位/遥控/定值读写/时钟同步 | `docs/子系统设计/IEC104上行设计说明.md` |
|
||||
| 上行 | 104 总召/变位/遥控/定值读写/时钟同步 | `docs/iec60870/板端落地/IEC104上行设计说明.md` |
|
||||
|
||||
### 3.2 部分闭环
|
||||
|
||||
@@ -337,7 +337,7 @@
|
||||
| 运行参数段 | 未登记 | **新发现**,建议按语义标识登记("运行参数段 0x8020~0x8058") |
|
||||
| 开入开出 | 未登记 | **新发现**,建议登记("开入量采集与遥信"、"遥控与出口") |
|
||||
| 削顶检测 | 复现规划 §3.5(「采样通道自检」残余,"码值越界待做") | 给出两条具体判据 |
|
||||
| 频率点 | `docs/子系统设计/IEC104上行设计说明.md` §8 第 4 条 | 明确它现在就能做(算法已就绪,只差绑定) |
|
||||
| 频率点 | `docs/iec60870/板端落地/IEC104上行设计说明.md` §8 第 4 条 | 明确它现在就能做(算法已就绪,只差绑定) |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -260,8 +260,8 @@ P-6 号必须能反查到定义(属主登记处得存在)· P-7 编号不语
|
||||
| 「卡」+ 数字 7 | 量纲回归用例 | 原数据可信 3 节 退出判据第 ⑥ 条;用例在 `test/host/prot_dim` |
|
||||
| 「卡」+ 数字 8 | 遥测快照发布 | 原数据可信 4.5 节 |
|
||||
| 「卡」+ 数字 9 | 104 改读快照 | 原数据可信 4.5 节 |
|
||||
| 「卡」+ 数字 10 | 运行参数段 | `App/algo/run_par.h` 头注释 + `docs/子系统设计/IEC104上行设计说明.md` |
|
||||
| 「卡」+ 数字 11 | 频率点绑定 | `docs/子系统设计/IEC104上行设计说明.md` 的 `0x401D` 行 |
|
||||
| 「卡」+ 数字 10 | 运行参数段 | `App/algo/run_par.h` 头注释 + `docs/iec60870/板端落地/IEC104上行设计说明.md` |
|
||||
| 「卡」+ 数字 11 | 频率点绑定 | `docs/iec60870/板端落地/IEC104上行设计说明.md` 的 `0x401D` 行 |
|
||||
| 「卡」+ 数字 12 | 两点标定 | 原数据可信 5 节(未开始,等标准源) |
|
||||
|
||||
**本表把形态写成「卡」+ 数字、不复述字面量**:本文是门禁语料,复述形态会把"讲规则的文档"变成
|
||||
|
||||
+1
-1
@@ -150,7 +150,7 @@ LVGL 场景(同一份 ui_menu.c)
|
||||
|
||||
用户后续授权的全部 IPv4 监听变更已单独构建并在本机验证:二进制 SHA256 `dde0f0512624518b223564b47ce6bbafab01586532b82ff36fb490288ef012a7`,证据位于 `ci-artifacts/iec104-lan/`。OS 监听地址为 `0.0.0.0`;`127.0.0.1` 与本机确实配置的 `192.168.31.13` 均完成 STARTDT 握手,有限时服务退出后无监听残留。**这是本机连接验证,不证明其他机器可穿过防火墙访问;下述完整业务与黄金证据属于此前里程碑二进制,不冒充新哈希的全套复验。**
|
||||
|
||||
**仅模拟器首个里程碑通过(历史验收快照)**:当时二进制 SHA256 为 `d2285bbc68ce4353c814dbcc455a2083b56e81fc54bf88081402e821c6a92833`(`ci-artifacts/iec104-sim-release.sha256`)。同哈希审查人独立 TCP 复跑 11 项通过,报告 `ci-artifacts/iec104-review/tcp-final/report.json`;菜单 8 状态、内容 76 页、往返池水位及实时数据回归通过,日志 `ci-artifacts/iec104-sim-menu-release.log`、`ci-artifacts/iec104-sim-content-release.log`,未刷新黄金参考。构建、正常 READY/STOP 与端口占用失败证据分别为 `ci-artifacts/iec104-sim-build-release.log`、`ci-artifacts/iec104-sim-smoke-release.log`、`ci-artifacts/iec104-sim-bind-failure.log`;编译输入清单 `ci-artifacts/iec104-sim-release-sources.sha256` 记录 95 个编译 C 文件及 160 个输入文件哈希。**MCU 替换、旧栈删除及真实 UI 参数绑定仍未完成,cppcheck 尚未运行,不等于全部门禁或板端通过。**测试精确集合与矩阵见 `test/host/iec104_dtu/MATRIX.md`;完整边界见 `docs/子系统设计/IEC104上行设计说明.md` §0 和 `docs/测试说明/专项验证/模拟器差距清单.md`。
|
||||
**仅模拟器首个里程碑通过(历史验收快照)**:当时二进制 SHA256 为 `d2285bbc68ce4353c814dbcc455a2083b56e81fc54bf88081402e821c6a92833`(`ci-artifacts/iec104-sim-release.sha256`)。同哈希审查人独立 TCP 复跑 11 项通过,报告 `ci-artifacts/iec104-review/tcp-final/report.json`;菜单 8 状态、内容 76 页、往返池水位及实时数据回归通过,日志 `ci-artifacts/iec104-sim-menu-release.log`、`ci-artifacts/iec104-sim-content-release.log`,未刷新黄金参考。构建、正常 READY/STOP 与端口占用失败证据分别为 `ci-artifacts/iec104-sim-build-release.log`、`ci-artifacts/iec104-sim-smoke-release.log`、`ci-artifacts/iec104-sim-bind-failure.log`;编译输入清单 `ci-artifacts/iec104-sim-release-sources.sha256` 记录 95 个编译 C 文件及 160 个输入文件哈希。**MCU 替换、旧栈删除及真实 UI 参数绑定仍未完成,cppcheck 尚未运行,不等于全部门禁或板端通过。**测试精确集合与矩阵见 `test/host/iec104_dtu/MATRIX.md`;完整边界见 `docs/iec60870/板端落地/IEC104上行设计说明.md` §0 和 `docs/测试说明/专项验证/模拟器差距清单.md`。
|
||||
|
||||
## 三、构建与运行
|
||||
|
||||
|
||||
@@ -2,8 +2,8 @@
|
||||
# -*- coding: utf-8 -*-
|
||||
"""B6 bench leg: IEC 60870-5-104 master client (GI + COV round-trip).
|
||||
|
||||
Historical bench leg; acceptance criteria: docs/子系统设计/IEC104上行设计说明.md §8.
|
||||
docs/子系统设计/IEC104上行设计说明.md §3/§4. Constants mirror the old in-house
|
||||
Historical bench leg; acceptance criteria: docs/iec60870/板端落地/IEC104上行设计说明.md §8.
|
||||
docs/iec60870/板端落地/IEC104上行设计说明.md §3/§4. Constants mirror the old in-house
|
||||
protocol layer (App/protocol/iec104/iec104_asdu.h / iec104_link.h, both deleted
|
||||
2026-11-18 with the skeleton MCU migration); current wire layout is governed by
|
||||
App/iec60870/common/IEC60870_Asdu.h + App/iec60870/104/IEC104_Types.h.
|
||||
|
||||
@@ -12,7 +12,7 @@
|
||||
|
||||
退出码:0=PASS / 1=测试失败 / 2=环境错误。
|
||||
|
||||
设计依据:docs/算法/采集与算法层设计说明.md §13(运行参数段)+ docs/子系统设计/IEC104上行设计说明.md §3.4。
|
||||
设计依据:docs/算法/采集与算法层设计说明.md §13(运行参数段)+ docs/iec60870/板端落地/IEC104上行设计说明.md §3.4。
|
||||
创建日期:2026-10-25(道D 运行参数段)
|
||||
"""
|
||||
import os
|
||||
|
||||
Reference in New Issue
Block a user