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

feat(104): [comm] 配置段落地，公共地址与端口由 defaultTask 读、iec104 服务端消费

Browse Source 
新增 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 台账不同码，按约定由收
尾一笔统一回填。
This commit is contained in:
Wanderingss
2026-10-26 19:34:28 +08:00
parent 0f8b88337e
commit e7136cbea3
13 changed files with 570 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files
App/app/app_main.c
+13
View File
@@ -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。 */
App/protocol/iec104/iec104_comm.h
+97
View File
@@ -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 <stdint.h>
/* 段名（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 */
App/protocol/iec104/iec104_link.h
+3 -2
View File
@@ -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 帧上限 */
App/protocol/iec104/iec104_pts.c
+111
View File
@@ -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 <string.h>
#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(&reg, 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(&reg);
}
/*
* 函数功能：取生效公共地址
* 返回值：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;
}
App/task/iec104_serv.c
+29 -8
View File
@@ -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 (;;) {
App/task/iec104_serv.h
+4 -1
View File
@@ -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
/*
docs/子系统设计/IEC104上行设计说明.md
+17 -4
View File
@@ -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）|
docs/子系统设计/网络配置说明.md
+26
View File
@@ -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，且本仓库无携带旧档的设备 |
docs/子系统设计/配置文件设计说明.md
+2
View File
@@ -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 端到端）
scripts/id_registry.json
+3 -3
View File
@@ -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,
test/host/cfg_file/cfg_file_test.c
+92
View File
@@ -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();
test/host/iec104/iec104_test.c
+138
View File
@@ -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;
test/host/iec104_serv/iec104_serv_test.c
+35 -4
View File
@@ -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;