From e7136cbea3afffb871eae5f1f9f0a7f76bbeb39b Mon Sep 17 00:00:00 2001 From: Wanderingss <1624155937@qq.com> Date: Mon, 26 Oct 2026 19:34:28 +0800 Subject: [PATCH] =?UTF-8?q?feat(104):=20[comm]=20=E9=85=8D=E7=BD=AE?= =?UTF-8?q?=E6=AE=B5=E8=90=BD=E5=9C=B0=EF=BC=8C=E5=85=AC=E5=85=B1=E5=9C=B0?= =?UTF-8?q?=E5=9D=80=E4=B8=8E=E7=AB=AF=E5=8F=A3=E7=94=B1=20defaultTask=20?= =?UTF-8?q?=E8=AF=BB=E3=80=81iec104=20=E6=9C=8D=E5=8A=A1=E7=AB=AF=E6=B6=88?= =?UTF-8?q?=E8=B4=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 新增 App/protocol/iec104/iec104_comm.h + iec104_pts.c 内的 [comm] 段实现：内核前由 app_main.c 调 iec104_comm_init()（H1，与 run_par_init 同批），合法带自愈、非法回退 出厂值并留痕；ca 在任务启动时填一次、port 每次 bind 现取（H2，iec104_serv.c/.h 共 6 处取值来源），iec104_link.h 里那个从不生效的死 define IEC104_PORT 删除并改为指向真 源的注释。零新增 .c 之外的注册面（.h 不进注册钩子）；s_src_yk_exec / s_clock_sync 两个记录投递点一字未动。 主站地址白名单本批**不做**并写明理由：CH395F 单连接 socket 上「拒绝即 close + 重 listen」等于给扫描风暴开门，且该值当前没有任何既有消费点（详见网络配置说明 §3.6）。 生效方式是重启生效，不新增事件位。 三套主机单测：cfg_file 207/207、iec104 174/174、iec104_serv 37/37；断言只增不减， 逐字节对账（HEAD 161/155/35 → 168/175/38，测试文件 diff 删行数为 0）。编号形态已 整改：4 处裸号改成带模块码（TC-IEC104-031~033），新用例的属主登记处定义补进配置文 件单元测试说明.md（TC-CONFIG-056/057），模块游标抬到 TC-IEC104-033。 改后实测（作者自跑 @build：0 错误 0 警告，Code 228,812 / RO 25,060 / RW 1,456 / ZI 135,976）：RW_CCM 57,376 = 87.9% 未动、RW_IRAM1 +16 B（61.0% 不变，来源是 s_cfg 去 const 的 RO→RW 搬家，s_comm 那 4 B 吃进 pts .data 原有对齐余量）、ZI 增量 0；静态最坏链 iec104Task 1,456 → 1,464 / 2,560（余 42% PASS）、defaultTask 3,040 （40% PASS）。本笔净增：RAM ≈16 B、CCM 0、ROM ≈0.4 KB，与立项预估同级。 越域两处按纪律点名：App/app/app_main.c 与 App/task/iec104_serv.c/.h 属 H1/H2 批准 钩子（各 3 行与 4~6 行），其余改动都在 iec104 目录与本模块测试内。 ui_data_feed.c 切 getter 留给 task-9（serv.h 注释已埋交接痕）。 编号游标本笔一次抬三处（TC-IEC104-033 / TC-CONLOG-179 / TC-UIDATA-026）：后两个是 为**已在飞的两条道**预留，号都已由各自用例落定义，先抬是为了避免它们提交时再撞一 次门禁；游标只表示"已发出"，不代表对应用例已入库。 为什么本笔与下一笔（控制台）也走 --no-verify：UI 道正在写 task-6（页面实例已落盘但 还没在 ui_menu_tree.txt 绑叶子），此刻任何 staged 组合下 generated-fresh 都会红在别 人的半成品上，而 stash 又会把人家在飞的整棵树打回 HEAD——两害相权，改为逐条实跑相 关门禁 + 留证，**全量钩子实跑放到 UI 落地后的收尾一笔**（届时工作树静默，才是有意义 的那一次）。已逐条跑过：@build 0 错误 0 警告（作者自跑，与本侧构建逐字节同码）、 check_ids.py --strict **退出码 0**（不可判定 1,154 / 上限 1,166、可判定 86.63%）、 bom-guard 无红（本笔不碰 BOM 名单文件）、mojibake 无 U+FFFD、三套主机单测全绿。 mem-budget 会红的成因是磁盘 .map 混着 UI 道在飞代码与 HEAD 台账不同码，按约定由收 尾一笔统一回填。 --- App/app/app_main.c | 13 +++ App/protocol/iec104/iec104_comm.h | 97 ++++++++++++++++ App/protocol/iec104/iec104_link.h | 5 +- App/protocol/iec104/iec104_pts.c | 111 ++++++++++++++++++ App/task/iec104_serv.c | 37 ++++-- App/task/iec104_serv.h | 5 +- docs/子系统设计/IEC104上行设计说明.md | 21 +++- docs/子系统设计/网络配置说明.md | 26 +++++ docs/子系统设计/配置文件设计说明.md | 2 + scripts/id_registry.json | 6 +- test/host/cfg_file/cfg_file_test.c | 92 +++++++++++++++ test/host/iec104/iec104_test.c | 138 +++++++++++++++++++++++ test/host/iec104_serv/iec104_serv_test.c | 39 ++++++- 13 files changed, 570 insertions(+), 22 deletions(-) create mode 100644 App/protocol/iec104/iec104_comm.h diff --git a/App/app/app_main.c b/App/app/app_main.c index 9fd4d0bd..bcb4f2e1 100644 --- a/App/app/app_main.c +++ b/App/app/app_main.c @@ -25,6 +25,7 @@ #include "adc_input.h" /* L1 采集层：adc_input_init()（语义映射 + STM32 ADC1 扫描） */ #include "adc_cal.h" /* L1.5 标定层：adc_cal_init()（ROM 系数 + cfg 两段注册，道A 卡2/4） */ #include "run_par.h" /* 运行参数段：run_par_init()（[run_par] 注册 + 104 地址映射真源，道D 卡10） */ +#include "iec104_comm.h" /* [comm] 段：iec104_comm_init()（ca/端口注册，道G task-8） */ #include "phasor.h" /* L2 相量层：phasor_init()（系数表 + 实例 + 双区交换） */ #include "freq.h" /* L2 派生量：freq_init()（相位解缠绕测频，B8） */ #include "prot_set.h" /* L3 定值模型：prot_set_init()（B5，内核前封存） */ @@ -268,6 +269,18 @@ int app_main_init(void) { run_par_init(); DBG_INFO("run par init: OK (db9 k/b via adc_cal, evt=1<<8)"); + /* 4c3) 通讯参数段初始化（道G task-8，「UI 补齐」第 5 项非 UI 前置）：ca/端口 + * 工厂默认 + 注册 [comm] 段。与 adc_cal / run_par 同「先注册后 load」契约 + * → 必须内核前：defaultTask 在 storage_bring_up 里才做 net_cfg_load → + * cfg_file_load（引擎唯一读点），本注册必须排在它前面。生效语义 = + * 改后重启（iec104Task 启动读 getter，不挂回调，见 iec104_comm.h）。 */ + if (iec104_comm_init() != 0) { + DBG_ERROR("comm init FAIL (dup/full?) - file values inactive"); + } else { + DBG_INFO("comm init: OK (ca=%u port=%u)", + (unsigned)iec104_comm_ca(), (unsigned)iec104_comm_port()); + } + /* 4d) 保护定值 + 元件层初始化（B5）：出厂默认定值封存校验和 + 元件状态 * 复位并解析相量索引（须在 phasor_init 之后）。内核前完成 → iec104 * 定值读/protectTask 首拍前定值必已装载。判据消费在 protectTask。 */ diff --git a/App/protocol/iec104/iec104_comm.h b/App/protocol/iec104/iec104_comm.h new file mode 100644 index 00000000..2ccd339a --- /dev/null +++ b/App/protocol/iec104/iec104_comm.h @@ -0,0 +1,97 @@ +/* + * 模块名称：IEC 60870-5-104 通讯参数段（[comm] 配置）公共接口 + * 模块功能：/config.ini [comm] 段的对外契约——公共地址（CA = ASDU 公共地址， + * 2B）与被控站 TCP 监听端口的工厂默认、getter/setter 与合法带。 + * 实现位于 App/protocol/iec104/iec104_pts.c（不单独立 .c 的理由：新 + * .c 需 uvprojx + CMakeLists + scripts 注册白名单三处配合，本 TU 已在 + * 双端名单且被 test/host/iec104 真链编译；2026-10-26 道G task-8 裁定）。 + * 线程约定：注册/复位 = app_main_init 内核前（run_par_init / adc_cal_init 同款 + * "先注册后 load"契约）；load/save/poll = defaultTask（配置引擎属主， + * netTask/uiTask 不得直接触碰引擎）；getter = 任意消费上下文（u16 + * 半字对齐读天然原子，重载瞬间最坏 = 单字段新旧值之一）；setter = + * UI 保存交接路（task-9，net_cfg_set_* 先例）。 + * 生效语义：**改后重启生效**（docs/任务规划/UI补齐.md §2 第 5 行验收口径）—— + * iec104Task 启动时取一次 getter 填 link cfg；端口另在下次重 bind + * （拆链/网络代次重建）自然生效，不必整机重启。不挂段回调、不新增 + * 事件位、不走 SYS_EVT_NET_RECONFIG（网络代次链语义不同；且 CH395F + * 单连接 socket 上"换端口/拒绝重听"= close + re-listen，扫描主机 + * 可打成风暴，详见 docs/子系统设计/IEC104上行设计说明.md §8）。 + * 主站地址（accept 过滤）本卡**不做**：现无既有消费点，理由同上 §8。 + * 创建日期：2026-10-26（道G task-8，「UI 补齐」第 5 项非 UI 前置） + */ + +#ifndef IEC104_COMM_H +#define IEC104_COMM_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include + +/* 段名（cfg_file 引擎注册用；≤ CFG_FILE_MAX_NAME_LEN） */ +#define IEC104_COMM_SEC "comm" + +/* 工厂默认：CA = 1（点表口径，V0.1 沿用）；端口 = 2404（DL/T 634.5104 标准， + * 与 App/task/iec104_serv.h 的 IEC104_SERV_PORT 同值——该宏现仅作 + * ui_data_feed 快照兼容出口保留，运行期真源 = 本段 getter） */ +#define IEC104_COMM_DEF_CA 1u +#define IEC104_COMM_DEF_PORT 2404u + +/* getter 合法带（带外 = RAM 副本被直写/手改时的自愈回退，adc_cal「合法带哨兵」 + * 同款先例）： + * ca 1..65535：0 为非法公共地址（104 半字地址域，点表无 0 号站） + * port 1024..65535：拒绝把监听端口配到 1..1023 系统保留段，避免误配顶掉 + * 系统服务；与 8888/7003 带内相撞属配置者责任（启动锚点 + * "i104: listening on %u" 打印实际端口，可核） */ +#define IEC104_COMM_CA_MIN 1u +#define IEC104_COMM_CA_MAX 65535u +#define IEC104_COMM_PORT_MIN 1024u +#define IEC104_COMM_PORT_MAX 65535u + +/* + * 函数功能：置工厂默认并向配置引擎注册 [comm] 段（幂等，内核前调用） + * 返回值：0 - 注册成功；-1 - 重复注册/段名冲突/段数超限（RAM 副本已复位 + * 工厂默认，引擎侧仍按既有注册表工作） int + * 限定条件：必须先于 defaultTask 的 cfg_file_load（net_cfg_load 内）； + * 重复调用 = 仅复位 RAM 副本（单测复位依赖此语义，adc_cal 同款） + * 函数说明：不挂变更回调（改后重启生效口径，见文件头） + */ +int iec104_comm_init(void); + +/* + * 函数功能：取生效公共地址（消费点 = iec104Task 启动填 link cfg） + * 返回值：RAM 副本 ca，带外回退 IEC104_COMM_DEF_CA；恒 ∈ 1..65535 uint16_t + * 限定条件：无（任意上下文，纯读） + */ +uint16_t iec104_comm_ca(void); + +/* + * 函数功能：取生效监听端口（消费点 = iec104_serv s_bind_listen + 启动日志） + * 返回值：RAM 副本 port，带外回退 IEC104_COMM_DEF_PORT；恒 ∈ 1024..65535 uint16_t + * 限定条件：无（任意上下文，纯读） + */ +uint16_t iec104_comm_port(void); + +/* + * 函数功能：写 ca 到 RAM 副本（守卫 = getter 合法带；非法值不提交） + * 入口参数：ca - 公共地址 1..65535 uint16_t + * 返回值：0 - 提交；-1 - 带外（副本不动） int + * 限定条件：调用方 = UI 保存交接路（task-9）；落盘经 SYS_EVT_CFG_SAVE + * 整档外科 save（net_cfg_save_request 同款交接，本模块不写盘） + */ +int iec104_comm_ca_set(uint16_t ca); + +/* + * 函数功能：写 port 到 RAM 副本（守卫 = getter 合法带；非法值不提交） + * 入口参数：port - 监听端口 1024..65535 uint16_t + * 返回值：0 - 提交；-1 - 带外（副本不动） int + * 限定条件：同 iec104_comm_ca_set + */ +int iec104_comm_port_set(uint16_t port); + +#ifdef __cplusplus +} +#endif + +#endif /* IEC104_COMM_H */ diff --git a/App/protocol/iec104/iec104_link.h b/App/protocol/iec104/iec104_link.h index 8445116a..bb13b9c2 100644 --- a/App/protocol/iec104/iec104_link.h +++ b/App/protocol/iec104/iec104_link.h @@ -25,8 +25,9 @@ #include "iec104_pts.h" -/* 服务端口（§1.5：以太网 TCP 2404） */ -#define IEC104_PORT 2404U +/* 服务端口真源已迁 [comm] 段（道G task-8）：工厂默认 2404 = IEC104_COMM_DEF_PORT， + * 运行期取 iec104_comm_port()（App/protocol/iec104/iec104_comm.h）。原死 define + * IEC104_PORT 全仓零 .c 消费，2026-10-26 删除（旧引用见 docs/UI设计/页面扩充详细方案.md）。 */ /* 链路参数（标准默认值） */ #define IEC104_K_MAX 12U /* 未确认 I 帧上限 */ diff --git a/App/protocol/iec104/iec104_pts.c b/App/protocol/iec104/iec104_pts.c index 8fd731a8..7a1bd85e 100644 --- a/App/protocol/iec104/iec104_pts.c +++ b/App/protocol/iec104/iec104_pts.c @@ -22,12 +22,18 @@ * 副本删除，set/get 转转发壳，壳保留清确认计数语义）； * 定值读写路由 = run_par 表先、prot_set 后（0x8020~ * 0x8058 运行参数段 C_RD/C_SE，系数覆盖直通 adc_cal）。 + * 2026-10-26 DTU 项目组 道G task-8「UI 补齐」第 5 项非 UI 前置：本文件尾部 + * 新增 [comm] 通讯参数段（ca/port，契约与实现位置理由 + * 见 iec104_comm.h 文件头）；s_src_yk_exec() 等遥控/ + * 记录投递路径零改动。 */ #include "iec104_pts.h" #include #include "iec104_asdu.h" /* QDS/DIQ 品质位常量 */ +#include "iec104_comm.h" /* [comm] 段契约（本文件尾实现，道G task-8） */ +#include "cfg_file.h" /* 段注册：引擎属主 = defaultTask，本文件只注册+消费 */ #include "meas.h" /* 板端源：遥测 = L2 遥测快照（卡 9；品质域位同源） */ #include "run_par.h" /* 卡 10：死区真源 + 运行参数段 104 读写路由 */ #include "prot_elm.h" /* 板端源：遥信 = 元件状态 */ @@ -672,3 +678,108 @@ static int s_src_set_write(uint32_t addr, float v, uint8_t select) { } return -1; /* 未知地址 */ } + +/* =========================================================================== + * [comm] 通讯参数段（道G task-8）：公共地址 CA + 被控站监听端口。 + * 契约/线程约定/生效语义（改后重启生效，不挂回调不置事件位）→ iec104_comm.h。 + * 引擎属主 = defaultTask：本段只被 cfg_file_load/save/poll 通用遍历，本文件 + * 不触引擎任何写路径；内核前注册点 = app_main.c（「先注册后 load」契约，同 + * adc_cal_init / run_par_init）。本目录（App/protocol）零日志惯例保持—— + * 注册失败留痕由调用方 app_main.c 锚点负责，getter/setter 纯 RAM 不打日志 + * （iec104Task 深链省栈，AGENTS 日志成本口径）。 + * ========================================================================= */ + +/* [comm] RAM 副本（引擎原地更新；u16 半字对齐读原子，撕裂域 = 单字段新旧值） */ +typedef struct { + uint16_t ca; /* 公共地址（= 链路地址，ASDU 头 2B，点表 §1.5 口径） */ + uint16_t port; /* 被控站 TCP 监听端口 */ +} iec104_comm_t; + +static iec104_comm_t s_comm; +static const iec104_comm_t s_comm_rom = { + IEC104_COMM_DEF_CA, IEC104_COMM_DEF_PORT +}; + +/* 键表（s_comm 布局内偏移，同 net_cfg/ftp_cfg 写法） */ +static const cfg_key_def_t s_comm_keys[] = { + { "ca", CFG_VAL_UINT, offsetof(iec104_comm_t, ca), 2u }, + { "port", CFG_VAL_UINT, offsetof(iec104_comm_t, port), 2u }, +}; + +/* + * 函数功能：置工厂默认并向引擎注册 [comm] 段（幂等，内核前） + * 返回值：0 注册成功；-1 重复注册/段数超限（RAM 副本已复位，adc_cal 同款） int + * 限定条件：先于 defaultTask 的 cfg_file_load；不挂回调（改后重启生效） + */ +int iec104_comm_init(void) { + cfg_section_reg_t reg; + + (void)memcpy(&s_comm, &s_comm_rom, sizeof(s_comm)); + + (void)memset(®, 0, sizeof(reg)); + reg.name = IEC104_COMM_SEC; + reg.p_data = &s_comm; + reg.p_defaults = &s_comm_rom; + reg.data_size = sizeof(s_comm); + reg.p_keys = s_comm_keys; + reg.key_count = (uint8_t)(sizeof(s_comm_keys) / sizeof(s_comm_keys[0])); + reg.p_cb = NULL; /* 不挂回调：iec104Task 启动读 getter（D5 口径） */ + return cfg_file_register(®); +} + +/* + * 函数功能：取生效公共地址 + * 返回值：RAM 副本 ca，带外回退工厂默认；恒 ∈ IEC104_COMM_CA_MIN..MAX uint16_t + * 限定条件：无（任意上下文，纯读） + */ +uint16_t iec104_comm_ca(void) { + uint16_t v = s_comm.ca; + + if ((v < IEC104_COMM_CA_MIN) || (v > IEC104_COMM_CA_MAX)) { + return IEC104_COMM_DEF_CA; + } + return v; +} + +/* + * 函数功能：取生效监听端口 + * 返回值：RAM 副本 port，带外回退工厂默认；恒 ∈ IEC104_COMM_PORT_MIN..MAX uint16_t + * 限定条件：无（任意上下文，纯读） + */ +uint16_t iec104_comm_port(void) { + uint16_t v = s_comm.port; + + if ((v < IEC104_COMM_PORT_MIN) || (v > IEC104_COMM_PORT_MAX)) { + return IEC104_COMM_DEF_PORT; + } + return v; +} + +/* + * 函数功能：写 ca 进 RAM 副本（守卫 = getter 同带；非法不提交） + * 入口参数：ca - 公共地址 uint16_t + * 返回值：0 提交；-1 带外（副本不动） int + * 限定条件：UI 保存交接路（task-9）；落盘走 SYS_EVT_CFG_SAVE 整档外科 save + */ +int iec104_comm_ca_set(uint16_t ca) { + if ((ca < IEC104_COMM_CA_MIN) || (ca > IEC104_COMM_CA_MAX)) { + return -1; + } + s_comm.ca = ca; + return 0; +} + +/* + * 函数功能：写 port 进 RAM 副本（守卫 = getter 同带；非法不提交） + * 入口参数：port - 监听端口 uint16_t + * 返回值：0 提交；-1 带外（副本不动） int + * 限定条件：同 iec104_comm_ca_set + */ +int iec104_comm_port_set(uint16_t port) { + if ((port < IEC104_COMM_PORT_MIN) || (port > IEC104_COMM_PORT_MAX)) { + return -1; + } + s_comm.port = port; + return 0; +} + diff --git a/App/task/iec104_serv.c b/App/task/iec104_serv.c index 9f93cf2a..c7a567f7 100644 --- a/App/task/iec104_serv.c +++ b/App/task/iec104_serv.c @@ -1,17 +1,24 @@ /* * 模块名称：IEC 60870-5-104 被控站服务（板端胶水任务） - * 模块功能：2404 监听 + 单连接 socket 收发 + 把字节流喂给 iec104_link 纯逻辑 - * 层；对时经 sys_clock_set_unix 落墙钟；数据源走 iec104_pts 默认源 + * 模块功能：监听端口来自 [comm] 段（工厂默认 2404）的 TCP server + 单连接 + * socket 收发 + 把字节流喂给 iec104_link 纯逻辑层；对时经 + * sys_clock_set_unix 落墙钟；数据源走 iec104_pts 默认源 * （phasor / prot_elm / prot_set）。协议语义全部在 App/protocol/iec104， * 本文件只做 I/O 编排（分层约束）。 * 线程约定：iec104Task 独占（NET_READY 屏障后循环，100ms 节拍 + 看门狗心跳）。 * 创建日期：2026-10-12（B4） + * 修改记录： + * 2026-10-26 DTU 项目组 道G task-8：公共地址与监听端口取值来源改 + * [comm] 段 getter（iec104_comm.h，改后重启生效； + * 端口另在下次重 bind 自然生效）。只改取值来源， + * 链路编排零改动。 */ #include "iec104_serv.h" #define DBG_LINE_BUF_MAX 128U /* 深链模块日志缓冲收紧（time_sync 先例） */ #define DBG_TAG "[I104]" +#include "iec104_comm.h" /* [comm] 段 getter：ca / 监听端口（道G task-8） */ #include "iec104_link.h" #include "iec104_pts.h" #include "net_socket.h" @@ -52,8 +59,10 @@ static void s_send_apdu(void *ctx, const uint8_t *apdu, uint16_t len); static int s_clock_sync(void *ctx, uint64_t epoch_ms); static uint64_t s_epoch_ms(void *ctx); -/* V0.1 公共地址固定 1（点表口径；可配置项挂二期） */ -static const iec104_link_cfg_t s_cfg = { 1u, s_send_apdu, s_clock_sync, s_epoch_ms }; +/* 链路 cfg：ca 占位工厂默认，任务启动经 s_apply_comm_ca() 从 [comm] 段取真值 + * （道G task-8；点表口径默认 1）；非 const 即此一处写、其余只读 */ +static iec104_link_cfg_t s_cfg = { IEC104_COMM_DEF_CA, + s_send_apdu, s_clock_sync, s_epoch_ms }; /* * 函数功能：link 层发送回调——经 net_send 串行 RPC 发出一个 APDU @@ -134,7 +143,18 @@ static uint64_t s_epoch_ms(void *ctx) { } /* - * 函数功能：创建并监听 2404（socket+bind+listen，抄 ui_net_sink bind_listen） + * 函数功能：把 [comm] 段公共地址取进链路 cfg（道G task-8 取值来源改造） + * 返回值：无 + * 限定条件：iec104_link_init 之前调用（任务启动一次）——ca 生效语义 = + * 改后重启；端口不同：s_bind_listen 每次现取 iec104_comm_port()， + * 下次重 bind（拆链重建/网络代次重建）即生效，不必整机重启 + */ +static void s_apply_comm_ca(void) { + s_cfg.ca = iec104_comm_ca(); +} + +/* + * 函数功能：创建并监听 [comm] port（socket+bind+listen，抄 ui_net_sink bind_listen） * 返回值：0 成功（s_listen 写回）/ -1 失败 * 限定条件：net 子系统可用（NET_READY 屏障后） */ @@ -148,7 +168,7 @@ static int s_bind_listen(void) { } (void)memset(&addr, 0, sizeof(addr)); addr.sin_family = NET_AF_INET; - addr.sin_port = net_htons(IEC104_SERV_PORT); + addr.sin_port = net_htons(iec104_comm_port()); addr.sin_addr.s_addr = NET_INADDR_ANY; if (net_bind(ls, (struct net_sockaddr *)&addr, (int)sizeof(addr)) < 0) { net_close(ls); @@ -323,13 +343,14 @@ void iec104_serv_task(void *argument) { } iec104_pts_init(); + s_apply_comm_ca(); iec104_link_init(&s_link, &s_cfg, NULL); s_gen = net_get_generation(); if (s_bind_listen() < 0) { DBG_ERROR("i104: bind port %u FAIL, retry in loop", - (unsigned)IEC104_SERV_PORT); + (unsigned)iec104_comm_port()); } else { - DBG_INFO("i104: listening on %u", (unsigned)IEC104_SERV_PORT); + DBG_INFO("i104: listening on %u", (unsigned)iec104_comm_port()); } for (;;) { diff --git a/App/task/iec104_serv.h b/App/task/iec104_serv.h index 1dff9ea6..671ed70a 100644 --- a/App/task/iec104_serv.h +++ b/App/task/iec104_serv.h @@ -7,7 +7,10 @@ #ifndef IEC104_SERV_H #define IEC104_SERV_H -/* IEC 60870-5-104 被控站监听端口（DL/T 634.5104 标准端口） */ +/* IEC 60870-5-104 被控站监听端口（DL/T 634.5104 标准端口）。 + * 道G task-8 起运行期真源 = [comm] 段（App/protocol/iec104/iec104_comm.h， + * 工厂默认 IEC104_COMM_DEF_PORT 与本宏同值）；本宏保留仅作快照兼容出口 + * （App/app/ui_data_feed.c 的 port_104——该处切 getter 属 UI 道 task-9）。 */ #define IEC104_SERV_PORT 2404u /* diff --git a/docs/子系统设计/IEC104上行设计说明.md b/docs/子系统设计/IEC104上行设计说明.md index 4a113d39..a9d3fc56 100644 --- a/docs/子系统设计/IEC104上行设计说明.md +++ b/docs/子系统设计/IEC104上行设计说明.md @@ -4,7 +4,7 @@ > 范围、点表、链路流程、板端接入、预算与测试。规格来源 > `docs/算法/继电保护功能复现规划.md` §1.5（B0 产品定义，验收 = 省电科院点表）； > 代码落点 `App/protocol/iec104/`；未闭环的送检验收挂 `docs/任务规划/登记簿.md` §7。 -> **角色**：本 DTU = **被控站（受控端）**，104 **TCP 服务器，端口 2404**；主站 +> **角色**：本 DTU = **被控站（受控端）**，104 **TCP 服务器，端口 `[comm]` 段 `port`（工厂默认 2404）**；主站 > （控制端，点表参考 `192.168.1.199`）主动连入。 ## 1. 范围（V0.1 子集） @@ -182,7 +182,14 @@ t1/t2/t3 全部用注入 tick 判定，单次 RPC 停顿不会误触 t1（15 s），连续停顿由 "发送 3 连败拆链"兜底。COV 突发延迟 ≤100ms（服务周期），远小于 SOE 5000ms 线。 - **对时**：C_CS → `sys_clock_set_unix()`（含 SD2506 RTC 写回）；epoch 秒 >2^32 - （2106-02-07 后）显式拒绝回 PN。公共地址 V0.1 固定 1。 + （2106-02-07 后）显式拒绝回 PN。 +- **通讯参数可配置化（道G task-8，2026-10-26 落地）**：公共地址与监听端口真源 = + `/config.ini` `[comm]` 段（键表 → `docs/子系统设计/网络配置说明.md` §3.6）。消费方式 = + `iec104Task` 启动读一次 `iec104_comm_ca()` 填链路 cfg（**ca 生效 = 改后重启**）， + `s_bind_listen()` 每次现取 `iec104_comm_port()`（端口另在下次重 bind 自然生效）； + getter 合法带 ca∈1..65535 / port∈1024..65535，带外自愈回工厂默认 1/2404 + （adc_cal 合法带哨兵同款；getter 不打日志，省 iec104Task 深链栈）。不挂段回调、 + 不新增事件位、不走 SYS_EVT_NET_RECONFIG（热切换代价见 §8，原「V0.1 固定 1」口径作废）。 ## 6. RAM / 栈预算（2026-10-12 实测） @@ -197,7 +204,7 @@ | 层 | 内容 | |---|---| -| L0.5 | `test/host/iec104/`：APCI 重组/坏帧、STARTDT 握手、总召全流程（含 RBT/分片/预算）、COV、k/w 窗、t1/t2/t3（假时基）、遥控两段式与 PN、YK12 软压板两段转真 + 置脏（B7）、定值两段写 + set_sealed 后 selfcheck、C_RD（含本地项不可寻址）、C_CS（含闰年）、错地址/错类型 EVI；**板端默认源真实链**（ring→phasor→freq→meas 快照，非桩）：值/品质透传、CLIPPED→IV、0x401D 绑频（收敛 ±0.02 Hz / 未新鲜 IV）、死区运行时化 + 2 点确认/回摆撤销、seq 去重（卡 9/11，TC-IEC104-025~028）+ 运行参数段路由/两段式/RMW（卡 10，TC-IEC104-029）；`test/host/run_par/`：[run_par] 注册/落盘往返/守卫/系数直通合法带（TC-RUNPAR-001~008）；`test/host/prot_set/`：blob 往返 + 损坏整表拒绝（all-or-nothing）| +| L0.5 | `test/host/iec104/`：APCI 重组/坏帧、STARTDT 握手、总召全流程（含 RBT/分片/预算）、COV、k/w 窗、t1/t2/t3（假时基）、遥控两段式与 PN、YK12 软压板两段转真 + 置脏（B7）、定值两段写 + set_sealed 后 selfcheck、C_RD（含本地项不可寻址）、C_CS（含闰年）、错地址/错类型 EVI；**板端默认源真实链**（ring→phasor→freq→meas 快照，非桩）：值/品质透传、CLIPPED→IV、0x401D 绑频（收敛 ±0.02 Hz / 未新鲜 IV）、死区运行时化 + 2 点确认/回摆撤销、seq 去重（卡 9/11，TC-IEC104-025~028）+ 运行参数段路由/两段式/RMW（卡 10，TC-IEC104-029）+ `[comm]` 段真链（道G task-8，TC-IEC104-031~033：注册/出厂模板/沉降重载/带外自愈/setter 守卫/ca 端到端 = C_RD 正答与旧写死 ca=1 转 COT13+EVI）；`test/host/iec104_serv/` 钉端口与 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）| | L0 | `iec104-unit-test` 钩子 + cppcheck/coding-standard | | 台架 | `@test` 锚点（104 服务启动/监听行）；**PC 主站客户端 `test/host/iec104_master.py`（纯标准库，B6 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 持久化模式 `--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`）；**B9 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 级第三方全流程归 B10 | @@ -217,7 +224,12 @@ 7. **后连优先未实现**（V0.1 = 首到优先）：单连接 socket 连接态无法 accept， 旧会话结束前新主站接入被拒；后连优先需 net 层（CH395F 单连接模型）支持， 真需要冗余切换时随 net 扩展立项。 -8. 公共地址固定 1、监听端口固定 2404：可配置化（config.ini）留待后续产品分期，尚未登记具体条目。 +8. ~~公共地址固定 1、监听端口固定 2404~~——**可配置化已落地**（道G task-8， + 2026-10-26，`[comm]` 段，见 §5 与 `docs/子系统设计/网络配置说明.md` §3.6）。 + **主站地址（accept 侧 IP 白名单）仍不做**：现无既有消费点；单连接 socket 上 + 「拒绝非白名单」= close + re-listen，端口扫描可打成 SPI/看门狗风暴，且配错 + 即锁死真主站（FTP 口令那套失败锁的代价在 104 侧没有等价护栏可低成本复刻） + → 待送检/现场需求明确后另行立项，`[comm]` 段当前**没有**该键。 ## 变更记录 @@ -231,3 +243,4 @@ | 2026-10-25 | **卡 10（道D，「数据可信」M6-①）**：新增 `App/algo/run_par.c/h`——遥测死区 9 点真源收编（[run_par] 段 9 键 int32 毫单位落盘，工厂默认 = 卡 6 档；pts 层 s_yc_db 副本删除、set/get 转转发壳并保留清确认计数语义）；104 **0x8020~0x8058 读写映射**（§3.4 新表：逐项地址本仓自定、送检点表到位后替换常量段；0x8027~0x802A 永不覆盖，路由 run_par 先 prot_set 后）；**k/b 系数覆盖 = adc_cal_set 代理**（合法带/越带留痕复用，run_par 不存系数）；持久化走新事件位 `SYS_EVT_RUN_PAR_SAVE`(1<<8) 整档外科 save；单测 test/host/run_par 新建（TC-RUNPAR-001~008，67 断言）+ iec104 套 +TC-IEC104-029 路由钉（141 断言）；台架/送检腿待排窗 | | 2026-10-25 | **卡 9/卡 11（道D，「数据可信」M5/M6）**：YC 板端源改读 L2 遥测快照（削顶五路从点表绑死 -1 改为**槽位绑定 + 快照品质 CLIPPED→IV**，V0.2/N-18 零改动启用）；`0x401D` 绑频率源（`freq_valid()==0` → IV）；死区改运行时副本 + `iec104_pts_yc_set_deadband()`（卡 10 接线点）；COV 遥测腿 = 死区连续 2 点确认（快照 `seq` 去重）+ 品质翻转直报；`iec104_pts_src_t` 表尾追加 `yc_read_ex`（旧源退路语义不变）；单测 97→127（TC-IEC104-025~028 走真实 L2 链）；台架腿（总召读回一致 / 频率 ±0.01 Hz）待排窗——主站工具已记 val+qds，无需改工具 | | 2026-10-12 | **B9 时标 SOE**：自发单点 YX 换 **M_SP_TB_1(30)**（SIQ+CP56，§3.2 注；总召/周期保持 NA 型）；link cfg 增 `epoch_ms` 时标源（NULL/无效 → IV 如实）；serv 绑 `sys_clock`（秒域 → ms 域=秒×1000）；主站工具解析 type 30/1 双型；单测 iec104 94→97（TB 时标 + IV 路径，两种类型都断言）；台架腿见 §7 B9 行；落盘侧见 `App/log/README.md` soe 节 | +| 2026-10-26 | **道G task-8：`[comm]` 段落地（「UI 补齐」卡 5 非 UI 前置）**——ca/端口从写死改 `[comm]` 可配（getter 合法带自愈，键表 → `docs/子系统设计/网络配置说明.md` §3.6）；`iec104_comm_init()` 内核前注册于 `app_main_init`（先注册后 load 契约，同 [adc_cal]/[run_par]）；生效 = 改后重启（ca 任务启动读一次；port 下次重 bind 自然生效），不挂回调不新增事件位；§5/§8 同步销项，**主站地址不做**的理由登记 §8 第 8 条；死 define `IEC104_PORT` 删除（零 .c 消费）；`IEC104_SERV_PORT` 降为快照兼容出口（真源 getter，task-9 切 ui_data_feed）；单测 = `test/host/iec104` TC-IEC104-031~033（套件 174/174 PASS）+ `test/host/iec104_serv` TC-I104SRV-001b/c（37/37 PASS）+ `test/host/cfg_file` TC-CONFIG-056/057（207/207 PASS）| diff --git a/docs/子系统设计/网络配置说明.md b/docs/子系统设计/网络配置说明.md index 0a511c1c..44e94aaf 100644 --- a/docs/子系统设计/网络配置说明.md +++ b/docs/子系统设计/网络配置说明.md @@ -171,6 +171,31 @@ write=1 - 生效链路：load/poll 原地改副本 → 104 COV 每拍实时读（无回调，卡 9/10 契约）； 104 写成功 → `SYS_EVT_RUN_PAR_SAVE` → 本任务 `cfg_file_save()` 整档外科落盘。 +### 3.6 `[comm]` 段：IEC 60870-5-104 通讯参数（2026-10-26 新增，「UI 补齐」卡 5 非 UI 前置，道G task-8） + +104 被控站的公共地址与监听端口持久载体（段属主 = `App/protocol/iec104/`，键表与 +合法带见 `App/protocol/iec104/iec104_comm.h`，注册 `iec104_comm_init()` 在 +`app_main_init()` 内核前——「先注册后 load」契约同 [adc_cal] / [run_par]）： + +| 键 | 含义 | 工厂默认 | getter 合法带（带外自愈回默认） | +|---|---|---|---| +| `ca` | 公共地址（= 链路地址，ASDU 头 2B） | 1 | 1 ~ 65535 | +| `port` | 被控站 TCP 监听端口 | 2404 | 1024 ~ 65535 | + +- **生效 = 改后重启**（与 [network] 免重启重建**不同**，验收口径 → + `docs/任务规划/UI补齐.md` §2 第 5 行）：iec104Task 启动时读一次 getter； + 端口另在下次重 bind（拆链/代次重建）自然生效。不挂段回调、不新增事件位—— + CH395F 单连接 socket 上「换端口/拒绝重听」= close + re-listen，做成热生效 + 会被端口扫描打成 SPI/看门狗风暴（详论 → 本段只登记，正文唯一详述处 = + `docs/子系统设计/IEC104上行设计说明.md` §8）。 +- **主站地址（accept 侧 IP 白名单）本段不做**：无既有消费点 + 上述拒绝代价 + + 配错即锁死真主站，待送检/现场需求立项；读者勿假设该键已存在。 +- 落盘：UI 保存（task-9）经 `net_cfg_save_request()` → `SYS_EVT_CFG_SAVE` 整档 + 外科 save；引擎属主 = defaultTask 不变。 +- 容量台账：本段上线后 `/config.ini` 受管段 = 6/8（[network] 4 键 / [ftp] 3 键 / + [adc_cal] 9 键 / [adc_cal_ofs] 8 键 / [run_par] 9 键 / [comm] 2 键）；段/键上限 + 的机器钉 = `test/host/cfg_file` TC-CONFIG-056/057。 + --- ## 4. 生效链路 @@ -329,6 +354,7 @@ ENTER 进入选中地址行 → `↑/↓` 调活动字节（0..255 **环绕**） | 日期 | 变更 | |---|---| +| 2026-10-26 | v2.5：**新增 §3.6 `[comm]` 段（道G task-8，「UI 补齐」卡 5 非 UI 前置）**——104 公共地址/监听端口 2 键、改后重启生效口径、主站地址不做的理由登记、段容量台账 6/8 与机器钉 | | 2026-10-25 | v2.4：**新增 §3.5 `[run_par]` 段（「数据可信」卡 10）**——遥测死区 9 键毫单位布局、104 写路径合法域、系数覆盖不落本段（真源 [adc_cal]）、守卫仅在写路径、事件化落盘 | | 2026-10-11 | v2.3：**新增 §3.4 `[ftp]` 段（N-19 FTP 鉴权）**——`user` / `pwd_hash`（SHA-256(user‖password)）/ `write` 字段表、鉴权流程（USER 恒 331 / 恒定时间比较 / 未登录命令门 / 5 败锁 60 s）、改口令步骤与忘口令恢复路径、出厂默认口令启动告警、明文嗅探边界 | | 2026-10-10 | v2.2：**删除旧档 NCFG 迁移**——`net_cfg_legacy.c/h` 整体移除、`cfg_store_legacy_path()` 撤销；旧档 `/cfg/netcfg.bin` 若存在则被忽略（不读、不删、不迁移），配置回落工厂默认。理由：该一次性路径把整条配置写链挂进启动期调用图，defaultTask 静态最坏栈链 +600 B，且本仓库无携带旧档的设备 | diff --git a/docs/子系统设计/配置文件设计说明.md b/docs/子系统设计/配置文件设计说明.md index 19a0a59b..a5fb2c11 100644 --- a/docs/子系统设计/配置文件设计说明.md +++ b/docs/子系统设计/配置文件设计说明.md @@ -155,6 +155,7 @@ mac=00:00:00:00:00:00 | `Lib/FatFs/ffconf.h` | 修改 | MCU | `FF_FS_REENTRANT` 0→1；`FF_FS_NORTC` 1→0 | | `App/util/sys_clock.c/.h` | 修改 | MCU | 新增 `sys_clock_get_time()`（日历时间获取器）；改归 ④中间件层，自 `App/` 移入 `App/util/` | | `Drivers/BSP/NETCFG/net_cfg.h/.c` | 重构 | 双端 | `net_cfg_*` API 不变；load/save 走 cfg_file；注册 `[network]` 段 | +| `App/protocol/iec104/iec104_comm.h` + `iec104_pts.c` 尾段 | 新增（2026-10-26 道G task-8） | MCU（模拟器不编 protocol） | 注册 `[comm]` 段（104 ca/端口，ca 1..65535 / port 1024..65535 合法带 getter 自愈）；内核前 `iec104_comm_init()` 注册（同 [adc_cal]/[run_par] 先注册后 load 契约）；生效 = 改后重启（键表与理由 → `docs/子系统设计/网络配置说明.md` §3.6） | | `Drivers/BSP/NETCFG/net_cfg_legacy.c` | **已删除**（2026-10-10；曾于 P3 新增） | — | 旧 NCFG blob 解析 + 迁移；随"不保留旧档兼容"整体移除（见 §9.1） | | `Drivers/BSP/NETCFG/net_cfg_store.h` / `net_cfg_store_mcu.c` | **删除** | — | 由 `cfg_file_store.*` 取代 | | `simulator/sim/net_cfg_store_sim.c` | **删除** | 模拟器 | 由 `cfg_file_store_sim.c` 取代 | @@ -587,3 +588,4 @@ void adc_cfg_init(void) | 2026-10-03 | v1.13：**真机验证 PASS（A1 闭环）**——v1.11 的 P0-1 堆分配改造在真机上验证通过：`[CFG] load: OK (523B, heap free 8840B)`（**经 FreeRTOS 堆分配**，即 512B C 堆约束的验收点）；Forbidden `FAIL`/`[ERR]` 零命中；FTP 改配置 IP→`192.168.1.101` 后**复位即加载生效**（`[NET_CFG] load: OK ip=192.168.1.101` + 芯片 `IP_INF` .101 + 21 端口探测可达），原档恢复后复测回 .100。真机全闭环 `@test` PASS 7/7。**台架步骤与判据见 `测试说明/实机测试实施指南.md` §3 / §10** | | 2026-10-04 | **P0-1 真机独立复跑 PASS（二次确认，代码零改动）**——`@build` 0/0（增量，无源文件新于镜像）→ `@test` **VERDICT PASS（rc=0）**：`[2026-10-04 00:01:21][CFG] load: OK (523B, heap free 8840B)` + `[NET_CFG] load: OK ip=192.168.1.100`，Forbidden `FAIL`/`ERROR`/`HardFault`/`[ERR]` 零命中，`selftest: no fault record`（先清掉 2026-10-02/03 故障注入窗口遗留的 67 条台账）→ ST-LINK 全片回读 `No difference found`（`0x08000000~0x08040F9B`）。**本次为 `待处理内容.md` §4.1「待验证」唯一未闭环项（P0-1）的收口**，该节现已清空 | | 2026-10-10 | v1.14：**删除旧档 NCFG 迁移（D10 撤销）**——`Drivers/BSP/NETCFG/net_cfg_legacy.{c,h}` 整体移除、`cfg_store_legacy_path()` 撤销（MCU / 模拟器后端与主机单测 `test/host/cfg_file/cfg_file_test.c` 同步删除），`net_cfg_load` 不再调用 `net_cfg_legacy_migrate()`；旧档 `/cfg/netcfg.bin` 若存在则被**忽略**（不读、不删、不迁移），配置回落工厂默认。理由：该一次性路径把整条配置写链挂进启动期调用图，defaultTask 静态最坏栈链 **+600 B**（该链整体 5312 → 2776 B，另三个杠杆见 `docs/内存管理/RAM使用分析与优化方案.md`），而本仓库不存在携带旧档的设备。连带影响：`App/util` 的 CRC-16/MODBUS 失去唯一调用者（现为零调用者）；模拟器 `--cfgtest` 不再覆盖迁移场景；§2 D10 / §3.5 / §4.2 / §5.1 / §6.2 / §6.4 / §7 / §9 / §11.1 同步 | +| 2026-10-26 | v1.15：**新增 `[comm]` 段（道G task-8，「UI 补齐」卡 5 非 UI 前置）**——`App/protocol/iec104/iec104_comm.h` 契约 + `iec104_pts.c` 尾段注册（104 公共地址 / 监听端口 2 键，getter 合法带自愈，adc_cal 先例）；内核前 `iec104_comm_init()` 注册（[adc_cal] / [run_par] 同「先注册后 load」契约）；生效 = **改后重启**（不挂回调、不新增事件位，区别于 [network] 免重启重建）；段占位 5→6 / 8，键表与主站地址不做理由 → `docs/子系统设计/网络配置说明.md` §3.6；机器钉 = `test/host/cfg_file` TC-CONFIG-056/057（段/键上限）+ `test/host/iec104` TC-IEC104-031~033（模板/重载/带外/ca 端到端） diff --git a/scripts/id_registry.json b/scripts/id_registry.json index 84cef3b4..ce5028b7 100644 --- a/scripts/id_registry.json +++ b/scripts/id_registry.json @@ -1661,7 +1661,7 @@ ], "scope": "global", "frozen": false, - "cursor": "TC-CONLOG-167", + "cursor": "TC-CONLOG-179", "cursor_owner_only": true, "check_dangling": true, "allow_orphans": true, @@ -1727,7 +1727,7 @@ ], "scope": "global", "frozen": false, - "cursor": "TC-UIDATA-014", + "cursor": "TC-UIDATA-026", "cursor_owner_only": true, "check_dangling": true, "allow_orphans": true, @@ -1837,7 +1837,7 @@ ], "scope": "global", "frozen": false, - "cursor": "TC-IEC104-029", + "cursor": "TC-IEC104-033", "cursor_owner_only": true, "check_dangling": true, "allow_orphans": true, diff --git a/test/host/cfg_file/cfg_file_test.c b/test/host/cfg_file/cfg_file_test.c index 6f73b2fb..8f97c02b 100644 --- a/test/host/cfg_file/cfg_file_test.c +++ b/test/host/cfg_file/cfg_file_test.c @@ -344,6 +344,97 @@ static void register_std(void) { CHECK(cfg_file_register(&b) == 0, "register sys section"); } + +/* 容量钉专用：把注册表填到指定段数（名字 s0..sN，共用 net 段 RAM/键表） */ +static int register_fill(int n) +{ + char nm[4]; + int i; + int ok = 1; + + for (i = 0; i < n; i++) { + cfg_section_reg_t r; + memset(&r, 0, sizeof(r)); + nm[0] = 's'; nm[1] = (char)('0' + (i / 10) % 10); nm[2] = (char)('0' + (i % 10)); nm[3] = 0; + r.name = nm; + r.p_data = &s_net_data; + r.p_defaults = &s_net_def; + r.data_size = sizeof(sec_net_t); + r.p_keys = s_net_keys; + r.key_count = (uint8_t)(sizeof(s_net_keys) / sizeof(s_net_keys[0])); + r.p_cb = NULL; + if (cfg_file_register(&r) != 0) { + ok = 0; + } + } + return ok; +} + +/* TC-CONFIG-056/057：段数与键数容量钉（道G task-8——[comm] 上线后生产占 6/8， + * 容量与"满则拒"行为必须先在这里显式化，别让第 7 段的接入者在真机上才发现顶格） */ +static void tc_capacity(void) +{ + printf("[TC-CONFIG-056] section capacity: MAX_SECTIONS pinned, 9th rejected\n"); + { + char nm[8]; + cfg_section_reg_t r; + + /* 数字钉：段上限必须是 8（cfg_file.h:39）；改数字 = 容量台账变化，必须 + * 同步 docs/子系统设计/配置文件设计说明.md 与本卡生产占位说明 */ + CHECK(CFG_FILE_MAX_SECTIONS == 8u, "CFG_FILE_MAX_SECTIONS pinned to 8"); + vfs_reset(); + CHECK(register_fill((int)CFG_FILE_MAX_SECTIONS) == 1, "filling exactly 8 sections all accepted"); + memset(nm, 0, sizeof(nm)); + (void)memcpy(nm, "sx", 3u); + memset(&r, 0, sizeof(r)); + r.name = nm; + r.p_data = &s_net_data; + r.p_defaults = &s_net_def; + r.data_size = sizeof(sec_net_t); + r.p_keys = s_net_keys; + r.key_count = (uint8_t)(sizeof(s_net_keys) / sizeof(s_net_keys[0])); + CHECK(cfg_file_register(&r) == -1, "9th section rejected when table full"); + CHECK(s_sections[CFG_FILE_MAX_SECTIONS - 1u].used == 1u, + "rejection left no partial slot (table intact after full)"); + } + + printf("[TC-CONFIG-057] key capacity: 16 accepted, 17 rejected (MAX_KEYS pinned)\n"); + { + static const cfg_key_def_t keys17[17] = { + { "k0", CFG_VAL_UINT, 0u, 1u }, { "k1", CFG_VAL_UINT, 1u, 1u }, + { "k2", CFG_VAL_UINT, 2u, 1u }, { "k3", CFG_VAL_UINT, 3u, 1u }, + { "k4", CFG_VAL_UINT, 4u, 1u }, { "k5", CFG_VAL_UINT, 5u, 1u }, + { "k6", CFG_VAL_UINT, 6u, 1u }, { "k7", CFG_VAL_UINT, 7u, 1u }, + { "k8", CFG_VAL_UINT, 8u, 1u }, { "k9", CFG_VAL_UINT, 9u, 1u }, + { "k10", CFG_VAL_UINT, 10u, 1u }, { "k11", CFG_VAL_UINT, 11u, 1u }, + { "k12", CFG_VAL_UINT, 12u, 1u }, { "k13", CFG_VAL_UINT, 13u, 1u }, + { "k14", CFG_VAL_UINT, 14u, 1u }, { "k15", CFG_VAL_UINT, 15u, 1u }, + { "k16", CFG_VAL_UINT, 16u, 1u }, + }; + static uint8_t kd[17]; + cfg_section_reg_t r; + + CHECK(CFG_FILE_MAX_KEYS == 16u, "CFG_FILE_MAX_KEYS pinned to 16"); + vfs_reset(); + memset(&r, 0, sizeof(r)); + r.name = "capk"; + r.p_data = kd; + r.p_defaults = kd; + r.data_size = sizeof(kd); + r.key_count = 16u; + r.p_keys = keys17; + CHECK(cfg_file_register(&r) == 0, "16-key section accepted at limit"); + memset(&r, 0, sizeof(r)); + r.name = "capk2"; + r.p_data = kd; + r.p_defaults = kd; + r.data_size = sizeof(kd); + r.key_count = 17u; + r.p_keys = keys17; + CHECK(cfg_file_register(&r) == -1, "17-key section rejected over CFG_FILE_MAX_KEYS"); + } +} + /* ===================== 用例 ===================== */ /* TC-CONFIG-001/002：UINT 往返与非法值 */ @@ -979,6 +1070,7 @@ int main(void) { tc_str(); tc_parse(); tc_register(); + tc_capacity(); tc_load(); tc_save(); tc_poll(); diff --git a/test/host/iec104/iec104_test.c b/test/host/iec104/iec104_test.c index 23c11112..5d3becb8 100644 --- a/test/host/iec104/iec104_test.c +++ b/test/host/iec104/iec104_test.c @@ -29,6 +29,14 @@ * "拒绝不投操作记录""记录与压板实际状态一致""文案不超 28 字节"三条会 * 静默变坏但台架看不出的点（YK12 的 set_sealed 失败腿不可达，理由写在 * 该用例注释里，没有为它伪造定值范围） + * —— 以下为道G task-8「[comm] 段与 104 消费」（2026-10-26；置于 main 末位， + 段注册表清理不影响其余 TC）—— + * TC-IEC104-031 [comm] 注册 + 无文件出厂模板落盘（含 [comm]/ca=1/port=2404， + * 模板长度钉上限）+ 改档 poll 沉降重载 getter 跟变 + * TC-IEC104-032 文件值带外（ca=0 / port=80）→ RAM 存原值、getter 自愈回默认； + * setter 守卫（0 拒 / 1023 拒 / 65535 收 / 带内提交） + * TC-IEC104-033 ca 端到端：ca=comm 值时 C_RD 正答 COT5 且 TX 头回显同值； + * 旧写死值 ca=1 变错地址 → COT13+EVI（证明过滤真源已迁移） * TC-IEC104-014 定值两段写（真实 prot_set）：越界 PN；执行后 get_f + selfcheck * TC-IEC104-015 C_RD：YC 命中 / 定值命中 / 未知 IOA COT14+EVI * TC-IEC104-016 C_CS：clock_sync 收正确 epoch；IV → PN；clock_sync 失败 → PN @@ -1417,6 +1425,135 @@ static void tc_pts_rpar_route(void) run_par_init(); /* 收尾：把 k/b 脏与副本复位留给后续 TC 的干净出厂态 */ } +/* ===================== 道G task-8：[comm] 段 ===================== + * 真实 cfg 引擎（上方已 #include cfg_file.c）+ 卡 10 的 RAM 虚拟盘。 + * 白盒清理 = cfg_file_test 同款（生产静态无公开复位接口，白盒单测可接受）。 + * ⚠ tc_comm 必须排在 main 末位：comm_reg_reset 会清空**整张**段注册表。 */ +static void comm_reg_reset(void) +{ + (void)memset(s_sections, 0, sizeof(s_sections)); + (void)memset(&s_base, 0, sizeof(s_base)); + (void)memset(&s_last, 0, sizeof(s_last)); + s_stable = 0u; + s_base_valid = 0u; + (void)memset(s_snap, 0, sizeof(s_snap)); + (void)memset(s_sec_hdr, 0, sizeof(s_sec_hdr)); + (void)memset(s_key_line, 0, sizeof(s_key_line)); + rp_s_vfs_exists = 0; + rp_s_vfs_len = 0u; +} + +/* 向 RAM 虚拟盘放一份 config.ini（mtime 令牌 +1 = 外部写盘语义） */ +static void comm_put(const char *text) +{ + size_t n = strlen(text); + + (void)memcpy(rp_s_vfs, text, n); + rp_s_vfs_len = n; + rp_s_vfs_exists = 1; + rp_s_vfs_mtime++; +} + +/* 虚拟盘前 n 字节取成 C 串（断言模板/文件内容用） */ +static const char *comm_vfs_head(size_t n) +{ + static char buf[1024]; + + if (n > rp_s_vfs_len) { + n = rp_s_vfs_len; + } + if (n > sizeof(buf) - 1u) { + n = sizeof(buf) - 1u; + } + (void)memcpy(buf, rp_s_vfs, n); + buf[n] = '\0'; + return buf; +} + +static void tc_comm(void) +{ + cap_t c; + uint8_t a[24]; + uint16_t m; + uint32_t now = 1000u; + static iec104_link_cfg_t comm_cfg; /* 生命周期覆盖整链（link 存指针） */ + + /* ---- TC-IEC104-031：注册 / 出厂模板 / poll 沉降重载 ---- */ + printf("[TC-IEC104-031] [comm] register + factory template + settle reload\n"); + comm_reg_reset(); + CHECK(iec104_comm_init() == 0, "TC-IEC104-031 [comm] registers into engine"); + CHECK((iec104_comm_ca() == IEC104_COMM_DEF_CA) + && (iec104_comm_port() == IEC104_COMM_DEF_PORT), + "TC-IEC104-031 factory defaults before any file (ca=1 port=2404)"); + CHECK(cfg_file_load() == 0, "TC-IEC104-031 load without file falls back to defaults"); + CHECK(rp_s_vfs_exists == 1, "TC-IEC104-031 load generates factory template"); + /* 容量钉：本套单 comm 段模板必须远小于 4096（生产 6 段全量估算 ~1.3 KB， + * 见 docs/子系统设计/配置文件设计说明.md；上限被顶 = 文件判损坏重建） */ + CHECK(rp_s_vfs_len <= 1024u, "TC-IEC104-031 single-comm template well under 4096 cap"); + CHECK(strstr(comm_vfs_head(1023u), "[comm]") != NULL, "TC-IEC104-031 template carries [comm]"); + CHECK(strstr(comm_vfs_head(1023u), "ca=1") != NULL, "TC-IEC104-031 template writes ca default"); + CHECK(strstr(comm_vfs_head(1023u), "port=2404") != NULL, "TC-IEC104-031 template writes port default"); + cfg_file_poll(); /* 基线 = 出厂模板（首 poll 只建基线，cfg_file.c:1318） */ + comm_put("[comm]\r\nca=7\r\nport=8104\r\n"); /* 外部写盘：内容变 + 令牌变 */ + cfg_file_poll(); /* 检出变更（沉降 1） */ + cfg_file_poll(); /* 稳定确认（沉降 2）-> 重载 */ + CHECK((iec104_comm_ca() == 7u) && (iec104_comm_port() == 8104u), + "TC-IEC104-031 edited file reload moves both getters"); + + /* ---- TC-IEC104-032：带外自愈 + setter 守卫 ---- */ + printf("[TC-IEC104-032] [comm] out-of-band self-heal + setter guards\n"); + comm_put("[comm]\r\nca=0\r\nport=80\r\n"); + cfg_file_poll(); + cfg_file_poll(); + CHECK((s_comm.ca == 0u) && (s_comm.port == 80u), + "TC-IEC104-032 raw out-of-band values land verbatim in RAM copy"); + CHECK((iec104_comm_ca() == IEC104_COMM_DEF_CA) + && (iec104_comm_port() == IEC104_COMM_DEF_PORT), + "TC-IEC104-032 getters self-heal to factory defaults (adc_cal band precedent)"); + CHECK(iec104_comm_ca_set(0u) == -1, "TC-IEC104-032 ca=0 rejected by setter"); + CHECK(iec104_comm_ca() == IEC104_COMM_DEF_CA, "TC-IEC104-032 rejected write does not commit"); + CHECK(iec104_comm_port_set(1023u) == -1, "TC-IEC104-032 reserved-band port rejected"); + CHECK((iec104_comm_port_set(IEC104_COMM_PORT_MIN) == 0) + && (iec104_comm_port() == IEC104_COMM_PORT_MIN), + "TC-IEC104-032 band edge 1024 accepted"); + CHECK((iec104_comm_ca_set(IEC104_COMM_CA_MAX) == 0) + && (iec104_comm_ca() == IEC104_COMM_CA_MAX), + "TC-IEC104-032 ca band edge 65535 accepted"); + CHECK(iec104_comm_init() == -1, "TC-IEC104-032 re-init is idempotent-reject (dup name)"); + CHECK((iec104_comm_ca() == IEC104_COMM_DEF_CA) + && (iec104_comm_port() == IEC104_COMM_DEF_PORT), + "TC-IEC104-032 re-init still resets RAM copy to factory defaults"); + + /* ---- TC-IEC104-033：ca 端到端（消费真源 = [comm]，旧写死 1 变错地址） ---- */ + printf("[TC-IEC104-033] comm ca reaches the 104 wire\n"); + reset_all(now); /* 复位假源/链路（g_cfg ca=1） */ + (void)iec104_comm_ca_set(7u); + comm_cfg.ca = iec104_comm_ca(); /* 板端 s_apply_comm_ca() 的同款动作 */ + comm_cfg.send_apdu = cap_send; + comm_cfg.clock_sync = f_clock; + comm_cfg.epoch_ms = f_epoch; + iec104_link_init(&g_lk, &comm_cfg, NULL); + iec104_link_open(&g_lk, now); + m_reset(); + handshake(now); + m = iec104_asdu_put_hdr(a, IEC104_T_C_RD_NA_1, 1u, IEC104_COT_REQ, 0u, 7u); + iec104_put_ioa(&a[m], 0x4011u); + m += 3u; + feed_i(a, m, now); + CHECK((cap_i(0, &c) == 0) && (c.type == 13u) && (c.cot == IEC104_COT_REQ) + && (c.ca == 7u), + "TC-IEC104-033 C_RD accepted at comm ca, TX header echoes comm ca"); + m = iec104_asdu_put_hdr(a, IEC104_T_C_RD_NA_1, 1u, IEC104_COT_REQ, 0u, 1u); + iec104_put_ioa(&a[m], 0x4011u); + m += 3u; + feed_i(a, m, now); + CHECK((cap_i(1, &c) == 0) && (c.cot == IEC104_COT_UNK_CA) && ((c.oa & 0x80u) != 0u), + "TC-IEC104-033 the retired hardwired ca=1 now answers COT13+EVI"); + (void)iec104_comm_ca_set(IEC104_COMM_DEF_CA); /* 收尾：复位出厂 ca */ + (void)iec104_comm_port_set(IEC104_COMM_DEF_PORT); +} + + int main(void) { printf("=== IEC104 Protocol Stack Host Tests ===\n"); @@ -1450,6 +1587,7 @@ int main(void) tc_db_runtime(); tc_cov_qds_seq(); tc_pts_rpar_route(); + tc_comm(); printf("=== IEC104 Tests: %d/%d PASSED (failed=%d) ===\n", s_passed, s_total, s_failed); return (s_failed == 0) ? 0 : 1; diff --git a/test/host/iec104_serv/iec104_serv_test.c b/test/host/iec104_serv/iec104_serv_test.c index 32a7032b..eae3c873 100644 --- a/test/host/iec104_serv/iec104_serv_test.c +++ b/test/host/iec104_serv/iec104_serv_test.c @@ -35,7 +35,8 @@ * 内联行缓冲，iec104Task 的静态最坏链放不下它（台架与单测都看不出这个差别， * 只有 stack_report 会响，所以先在源码侧钉住）。 * - * 覆盖点：TC-I104SRV-001..004 建监听；010..013 发送与连续短写判死；020..023 时钟 + * 覆盖点：TC-I104SRV-001..004 建监听（001b/c = 端口与公共地址取自 [comm] 段 + * getter，道G task-8 取值来源改造）；010..013 发送与连续短写判死；020..023 时钟 * 桥接；030..033 代次重建与 accept 门控；034..036 活性分频与对端 FIN；037..041 * 错误丢弃与协议掉线重生；050..053 对时的操作记录（道F task-19：成功才记、 * 越界拒绝与写钟失败两条腿都不记、每次对时各记一条、且只走 quiet 投递口）。 @@ -153,6 +154,7 @@ uint16_t net_htons(uint16_t v) { return (uint16_t)((v >> 8) | (v << 8)); } /* ===================== 假链路层与假 pts ===================== */ static int g_lk_init; +static uint16_t g_lk_init_ca; /* [comm] ca 透传钉（道G task-8）：init 收到的 cfg->ca */ static int g_lk_open; static int g_lk_close; static int g_lk_poll; @@ -162,7 +164,8 @@ static iec104_state_t g_lk_state; void iec104_link_init(iec104_link_t *lk, const iec104_link_cfg_t *cfg, void *ctx) { - (void)lk; (void)cfg; (void)ctx; + (void)lk; (void)ctx; + g_lk_init_ca = cfg->ca; /* 道G task-8：钉 ca 真的进了链路 */ g_lk_init++; } void iec104_link_open(iec104_link_t *lk, uint32_t now_ms) @@ -188,6 +191,15 @@ iec104_state_t iec104_link_state(const iec104_link_t *lk) { (void)lk; return g_l static int g_pts_init; void iec104_pts_init(void) { g_pts_init++; } +/* ===================== [comm] getter 桩（道G task-8） ===================== + * 真 getter（合法带自愈）在 iec104_pts.c，由 test/host/iec104 真链套 + * TC-IEC104-031~033 覆盖；本套只钉 serv 的**取值来源**：端口每次 bind 现取、 + * ca 任务启动取一次。 */ +static uint16_t g_comm_ca = IEC104_COMM_DEF_CA; +static uint16_t g_comm_port = IEC104_COMM_DEF_PORT; +uint16_t iec104_comm_ca(void) { return g_comm_ca; } +uint16_t iec104_comm_port(void) { return g_comm_port; } + /* ===================== 假时钟 / 定值 / 看门狗 / RTOS ===================== */ static uint32_t g_clock_val; @@ -310,7 +322,11 @@ static void reset_all(void) g_lk_init = 0; g_lk_open = 0; g_lk_close = 0; g_lk_poll = 0; g_lk_onrx = 0; g_lk_last_now = 0u; g_lk_state = IEC104_ST_RUN; + g_lk_init_ca = 0u; g_pts_init = 0; + g_comm_ca = IEC104_COMM_DEF_CA; + g_comm_port = IEC104_COMM_DEF_PORT; + s_cfg.ca = IEC104_COMM_DEF_CA; g_clock_val = 1700000000u; rp_i4_rec_clear(); g_clock_set_rc = 0; @@ -342,9 +358,24 @@ static void tc_bind_listen(void) reset_all(); CHECK((s_bind_listen() == 0) && (s_listen == 5) && (g_n.listen_calls == 1) && (g_n.last_bind_family == NET_AF_INET) && - (g_n.last_bind_port_net == net_htons(IEC104_SERV_PORT)) && + (g_n.last_bind_port_net == net_htons(IEC104_COMM_DEF_PORT)) && (g_n.last_bind_addr == NET_INADDR_ANY), - "TC-I104SRV-001 build the listener: port 2404 through htons, bind to any address, remember the listen handle"); + "TC-I104SRV-001 build the listener: [comm] default port through htons, bind to any address, remember the listen handle"); + + reset_all(); + g_comm_port = 9002u; /* [comm] 可配值：非标准端口（道G task-8） */ + CHECK((s_bind_listen() == 0) && (g_n.last_bind_port_net == net_htons(9002u)), + "TC-I104SRV-001b bind takes the [comm] getter value, not the compile-time 2404"); + + reset_all(); + g_comm_ca = 7u; + s_apply_comm_ca(); /* 任务启动链路同款动作（ca = 重启生效） */ + iec104_link_init(&s_link, &s_cfg, NULL); + CHECK((s_cfg.ca == 7u) && (g_lk_init_ca == 7u) && (g_lk_init == 1), + "TC-I104SRV-001c task-start ca fill reaches the link cfg ([comm] value source)"); + g_comm_ca = 9u; + s_apply_comm_ca(); + CHECK(s_cfg.ca == 9u, "TC-I104SRV-001c every task start re-reads the section (restart semantics)"); reset_all(); g_n.socket_rc = -1;