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

新增 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:
2026-10-26 19:34:28 +08:00
parent 0f8b88337e
commit e7136cbea3
13 changed files with 570 additions and 22 deletions
+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。 */
+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 */
+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 帧上限 */
+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;
}
+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 (;;) {
+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
/*