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:
@@ -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 */
|
||||
@@ -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 帧上限 */
|
||||
|
||||
@@ -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(®, 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;
|
||||
}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user