Files
STM32F4-Base/App/task/iec104_serv.c
T
wandering1 ed25fc5a4d perf(iec104): 删死仿真数组并按类型分表存变化检测基线,省 816 B RAM
104 的内存大头不在协议栈本身,而在两处「每层各留一份、且按最宽类型统一
存储」的静态数组。本次按实测逐项瘦身,行为等价有证:

一、iec104_source.c 删掉 5 个无写者的模拟注入数组(ZI -288 B)
   singles / single_set / doubles / measurements / measurement_set 的唯一
   写入点是 init() 的 memset,全仓无 setter、无导出写 API、simulator 与
   test 也无人写。故 single_set/measurement_set 恒 0 使对应 if 分支永假、
   doubles 恒 0 使 type3 分支恒返回零值+NO_SOURCE_QUALITY。
   保留 steps/bits:iec104_source_find() 用它们响应 IOA 0x1201..0x1208 与
   0x1301..0x1308,删掉会把「返回 0+品质」变成「未知地址」,属协议行为变化。
   实测 ZI 5912 -> 5624,比数组名义总和 284 多 4 B,因两处 2 字节对齐空隙
   一并消失。

二、iec104_core.c 变化检测基线按点类型分表(ZI -528 B)
   原 core_previous_t previous[105] 每点 8 字节(uint32 value + quality +
   bool,对齐补到 8),840 B。改为按点表顺序分三段:单点 u8 x59、双点
   u8 x16、测量值 u32 x30,品质按原索引逐点存,initialized 改位图 14 B。
   测量值仍按 32 位位模式比较,不是浮点比较,NaN/-0 判等语义不变。
   加两道防护:编译期断言「SP+DP+ME == 105 且段边界为 0/59/75」;启动期
   逐点校验 type_id 必须依次为 1/3/13,错序即启动失败——否则会静默把一种
   类型的值当另一种比较。校验在每次 core_start 跑 105 次,刻意不缓存成
   静态标志:重连后点表若被改坏,这一次就是唯一防线。

等价性证据(独立审查员复算,非自述):
  iec104_source_point() 225 点全表 x 回调三态 x 边界 4089 条轨迹逐字节一致;
  变化检测 133,560 次判定/读回零差异;4 个位置的变异体各自红在埋点行,
  证明这几条判据不是恒真摆设;去掉启动校验后乱序点表在主机用例里静默通过。

实测(权威构建,同一台机器前后对比):
  RW_IRAM1   118,120 -> 117,304 B(-816,90.1% -> 89.5%)
  ER_IROM1   413,416 -> 413,392 B(-24)
  iec104_source.o ZI 5912 -> 5624;iec104_core.o ZI 3192 -> 2664
  s_core 2928 -> 2400 B

顺带把 App/task/iec104_serv.c 两处写死的源码行号改为「文件路径+函数名」
锚点,重构后不会漂移。
2026-11-19 12:51:45 +08:00

372 lines
19 KiB
C
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/*
* 模块名称:IEC 60870-5-104 被控站服务(netTask 单属主驱动)
* 模块功能:在 netTask 的 1 ms 主循环里驱动 threadless 的 iec104_core:
* 代次自愈 -> iec104_core_start/poll/stop -> 四字段统计单调化。
* 协议解析、socket I/O、点表全部在 App/iec60870/104/ 与 common/
* App/iec60870/ 内,本文件只做属主编排与对外只读契约。
* 线程约定:**所有 core 调用只在 iec104_serv_net_tick() 内**(netTask 上下文)。
* iec104_core 是单属主、零等待对象,绝不跨任务调用;本文件不含
* 任何 osDelay / 阻塞等待,避免拖垮 netTask 的 1 ms 网络循环。
* 创建日期:2026-10-12(B4,原 iec104Task 胶水)
* 改造日期:2026-11-17(task-18 板端网络割接:退役独立 iec104Task)
*/
#include "iec104_serv.h"
#define DBG_LINE_BUF_MAX 128U /* 深链模块日志缓冲收紧(time_sync 先例) */
#define DBG_TAG "[I104]"
#include "iec104_comm.h" /* [comm] 段 getter:ca / 监听端口(改后重启/下次重 bind 生效) */
#include "iec104_core.h" /* threadless 104 核心:start/poll/stop/get_status */
#include "iec104_source.h" /* 数据源回调表:bind 入口(板端真实数据源接线) */
#include "iec104_net_mcu.h" /* 后端唯一导出:rx_bytes(不在本文件重复计数) */
#include "meas.h" /* 遥测快照:meas_get() 双区无锁读(唯一许可的板端遥测取数面) */
#include "adc_cal.h" /* 标定有效性:adc_cal_flags() 未标定闭锁判据 */
#include "ioboard_di.h" /* 开入快照读口(TODO 段预留,当前 s_signal 恒 false) */
#include "net_socket.h" /* net_get_generation():网络代次自愈 */
#include "prot_set.h" /* 定值脏标志 peek(B7 落盘通知) */
#include "run_par.h" /* 运行参数脏 peek(运行参数段落盘通知) */
#include "sys_events.h"
#include "task_watchdog.h"
#include "dbg_log.h"
#include "cmsis_os2.h"
/* 统计饱和值:到顶停在 0xFFFFFFF0,不回绕(回绕成个位数会被读成"刚上电")。 */
#define I104_STAT_SAT 0xFFFFFFF0u
/* 启动失败重试节流(ms):避免 core start 持续失败时每 1 ms 空转重建。 */
#define I104_START_RETRY_MS 100u
/* 100 ms 业务节拍:脏标志投递按旧 iec104Task 的 100 ms 周期导出。 */
#define I104_DIRTY_TICK_MS 100u
/* ---------------- 属主状态(仅 netTask 的 net_tick 写) ---------------- */
static uint32_t s_gen; /* 网络代次基线(重建自愈) */
static uint8_t s_started; /* core 是否已成功 start */
static uint32_t s_retry_tick; /* 上次启动尝试的 tick(节流基准) */
static uint32_t s_dirty_next; /* 下次脏标志投递的 tick 期限(不漏窗) */
static uint8_t s_link_run; /* core.status.active 镜像(供任意上下文只读) */
static uint8_t s_last_active; /* 上一轮 active,仅用于 0->1 跃迁日志(自愈可观测) */
/* 对外四字段:跨 core start 单调发布;写者 netTask,读者 uiTask/feed。 */
static iec104_serv_stats_t s_stats;
/* 单调化基线:core/后端计数器在每次 start 归零,这里记住上一代末值与累计搬运量。 */
static uint32_t s_last_conn, s_carry_conn;
static uint32_t s_last_apdu, s_carry_apdu;
static uint32_t s_last_txfail, s_carry_txfail;
static uint32_t s_last_rx, s_carry_rx;
/* core 启动配置静态存储:bind_address 指向 ROM 字面量;端口/CA 从 [comm] 现取。 */
static iec104_core_config_t s_core_cfg = { "0.0.0.0",
IEC104_COMM_DEF_PORT,
IEC104_COMM_DEF_CA };
/* ---------------- 板端数据源绑定(netTask 单属主,回调在 core poll 内串行调用) ---------------- */
/* 104 点表 source_addr(XML 源地址)→ 板端遥测语义通道。
* 只列**真实存在**的物理量;PT2 全部点 / 电池 / 湿度 / 功率 / 局放等无对应通道,
* 不在表内 → 回调返回 false,source 层置 0 + IV(不拿 PT1 冒充 PT2)。
* 电流说明:本仓只有一组电流通道(ADC_SEM_IA/IB/IC 即 TPAFE/STM32 唯一一路,
* 见 adc_input.c 通道表与 ADC通道映射说明.md §1)。点表的 "SW00 measurement
* Ia/Ib/Ic"(0x961F/9620/9621) 与 "SW00 protection Ia/Ib/Ic"(0x9622/23/24)
* 在现场 XML 里是两组 CT,本仓硬件只有一组——该组已按 protection 语义占用,
* 故 measurement 三点不接(同一物理量不能以两个语义同时上送)。
* 0xFF = 频率点特殊处理(取 meas_snap_t.freq_hz,不是 yc[] 下标)。 */
#define I104_SRC_FREQ 0xFFU
static const struct {
uint16_t source_addr;
uint8_t sem; /* ADC_SEM_xxx;I104_SRC_FREQ = snap.freq_hz */
} s_meas_map[] = {
{ 0x9605U, ADC_SEM_UA }, /* PT1 Ua */
{ 0x9606U, ADC_SEM_UB }, /* PT1 Ub */
{ 0x9607U, ADC_SEM_UC }, /* PT1 Uc */
{ 0x960BU, ADC_SEM_UN }, /* PT1 零序电压(台架无接线,cal flags 无 VALID → 恒 IV) */
{ 0x9622U, ADC_SEM_IA }, /* SW00 保护 Ia */
{ 0x9623U, ADC_SEM_IB }, /* SW00 保护 Ib */
{ 0x9624U, ADC_SEM_IC }, /* SW00 保护 Ic */
{ 0x9625U, ADC_SEM_IN }, /* SW00 零序电流 */
{ 0x960DU, I104_SRC_FREQ }, /* PT1 频率 */
{ 0x9617U, ADC_SEM_TEMP } /* 环境温度(NT 非交流量,meas.qds 已置) */
};
/* 函数功能:104 遥测源回调(按 source_addr 查真实存在的板端物理量)。
* 入口参数:ctx - 未用(绑定的 context 恒 NULL)
* source_addr - 104 点表 XML 源地址
* v - 输出工程量;q - 输出 104 QDS 品质字节
* 返回值:true = 取到值(品质另有 IV/NT 位);false = 无源,由 source 层置 0+IV
* 限定条件:仅 netTask(core poll 串行调用);不阻塞、不碰硬件
* 函数说明:meas 双区快照是唯一许可的板端遥测取数面——直接调
* tpafe5160_snapshot() 会抢 adcTask 的 consumer_seq,破坏其取数节奏。
* 品质 = meas.qds 低字节(与 IEC104_QDS_* 同值)AND adc_cal_flags() 的
* VALID:未标定路一律补 IV,落实"未标定闭锁"口径(UN 路台架永远 IV)。
* 快照用栈上 72 B 缓冲,静态 RAM 0 B;GI 一轮 30 点 × 72 B 拷贝
* 相对 200 ms 发布间隔可忽略,无需跨调用缓存(栈变量也缓存不住)。 */
static bool s_measure(void *ctx, uint16_t source_addr, float *value, uint8_t *quality)
{
meas_snap_t snap;
uint32_t i;
uint8_t sem;
(void)ctx;
if (value == NULL || quality == NULL) { return false; }
for (i = 0U; i < sizeof(s_meas_map) / sizeof(s_meas_map[0]); ++i) {
if (s_meas_map[i].source_addr == source_addr) { break; }
}
if (i >= sizeof(s_meas_map) / sizeof(s_meas_map[0])) { return false; }
if (meas_get(&snap) != 0) { return false; } /* 未发布过 = 无源 */
sem = s_meas_map[i].sem;
if (sem == I104_SRC_FREQ) {
if (snap.freq_valid == 0U) { return false; }
*value = snap.freq_hz;
*quality = 0U;
return true;
}
if (sem >= ADC_SEM_COUNT) { return false; }
*value = snap.yc[sem];
*quality = (uint8_t)(snap.qds[sem] & 0xFFU);
/* 未标定的通道不可信:0x80 与 IEC104_QDS_IV 同值(meas.h 明示
* 低字节与线上 104 QDS 同值,故本层不反向 include 协议头)。
* UN 路台架永久无标定,该位始终置上。 */
if ((adc_cal_flags((adc_semantic_t)sem) & ADC_CAL_F_VALID) == 0U) {
*quality |= 0x80U; /* IEC104_QDS_IV */
}
return true;
}
/* 函数功能:104 遥信源回调(当前板端 8 路开入无业务语义映射,恒无源)。
* 入口参数:ctx / source_addr / v / q(同 s_measure)
* 返回值:恒 false
* 限定条件:无
* 函数说明:docs/硬件平台/开入开出实施说明.md 的「1.2 现在能不能用」一节明确
* "104 遥信点表未接开入、继电器动作语义未定义"。板端 8 路开入是
* bit0=A..bit7=H 的无语义电平,点表 59 个遥信 source_addr 是 0x9146/...
* 具体业务点。硬接 = 编造。
* 将来 Lead/用户给出对照表后,只在本函数查一张 static const 映射表
* (读 ioboard_di_snap_lookup() + ioboard_di_snap_read()),函数签名与
* bind 流程均不用改;详见 ci-artifacts/iec104-cutover/source-bind-plan.md §3.3。 */
static bool s_signal(void *ctx, uint16_t source_addr, uint8_t *value, uint8_t *quality)
{
(void)ctx; (void)source_addr; (void)value; (void)quality;
return false;
}
/* 函数功能:绑定板端数据源到 104 source(每次 core_start 成功后调用)。
* 入口参数:无
* 返回值:无
* 限定条件:仅 netTask,在 iec104_core_start() 成功分支、首次 poll 之前
* 函数说明:**为什么不能在系统初始化时绑一次就完事**——
* iec104_source_init() 的首条语句就是 memset(&bindings, 0, ...),而它唯一的
* 产品侧调用点是 iec104_core.c 的 initialize_core(),由 iec104_core_start()
* 每次 start 触发(网络代次变化 / poll 服务级失败都会 stop→start)。
* 若只在开机时绑一次,第一次重连后 bindings 被清零且再无人重绑,
* 主站又退回"0 + IV"且无任何日志——这是下一个接手人最容易踩的坑。
* parameter_read/parameter_apply 两个都保持 NULL:source.h 要求成对注册,
* 而 NOSTORE 档明确禁止写,只注册 read 会破坏配对语义、掩盖参数整定不可用。 */
static void s_bind_mcu_source(void)
{
static const iec104_source_bindings_t bindings = {
NULL, s_measure, s_signal, NULL, NULL
};
iec104_source_bind(&bindings);
}
/*
* 函数功能:把"每次 start 归零"的源计数折算成上电以来单调不回退的对外值。
* 入口参数:now = 本轮源计数;last = 上一轮源计数;carry = 已封存的历代总和
* 返回值:对外发布值(饱和 I104_STAT_SAT)
* 限定条件:仅 net_tick 内调用(单写者)
* 函数说明:now < last 唯一原因是 core/后端重启把源计数清零;此时先把上一代
* 末值进 carry,再从 0 起算。三个状态都是 u32,Cortex-M4 单字原子,
* 读者(get_stats)只读 s_stats 不读这些基线,无撕裂风险。
*/
static uint32_t s_monotonic(uint32_t now, uint32_t *last, uint32_t *carry)
{
if (now < *last) {
if (*carry > (I104_STAT_SAT - *last)) {
*carry = I104_STAT_SAT;
} else {
*carry += *last;
}
}
*last = now;
if (*carry > (I104_STAT_SAT - now)) {
return I104_STAT_SAT;
}
return *carry + now;
}
/*
* 函数功能:强制重建 104 core(网络代次变化 / core poll 服务级失败时调用)。
* 入口参数:now = 当前 tick(用于启动节流基准)
* 返回值:无
* 限定条件:netTask 上下文;NET_READY 已置位
* 函数说明:代次一变即代表 net_init 已复位芯片并清空 net 层控制块,旧 fd 在
* 芯片与 net 层都不存在;后端匮乏次句柄一律 find 失败、Close 幂等返回,
* 因此**绝不把"Close(旧 listener) 成功"当作 start 的前置条件**——否则
* stop 静默失败 -> owns_resources 仍 1 -> start 被拒 -> 104 永久起不来。
* 这里按"core 已停止"处理:无条件调一次 stop 兜底清理(幂等),再 start。
* start 失败不在此死等,交下一轮按 I104_START_RETRY_MS 节流重试。
*/
static void s_restart_core(uint32_t now)
{
(void)iec104_core_stop();
s_started = 0U;
s_retry_tick = now; /* 允许本轮末尾立即尝试一次 start */
}
/*
* 函数功能:尝试启动(或重启)core;成功置 s_started。
* 入口参数:now = 当前 tick
* 返回值:无
* 限定条件:netTask 上下文;NET_READY 已置位
*/
static void s_try_start(uint32_t now)
{
if ((now - s_retry_tick) < I104_START_RETRY_MS) {
return; /* 节流窗口内不重复尝试 */
}
s_retry_tick = now;
/* 这是 core owns_resources=1 的唯一重试点:上一实例 stop 失败残留时,
* 靠这里的兜底 stop 再试一次(core 契约要求失败后必须重试 stop)。
* I104_START_RETRY_MS 同时就是 stop 重试周期——改这个宏等于改 stop 重试
* 策略,不只是改 start 节奏。core stop 在 slave==NULL 时直接返回 0。
* stop 不 memset(status):重试期间 status 保持最后一次真值,不会出现
* "看起来像活着"的假零值,因此本窗口无第二个混淆源。 */
(void)iec104_core_stop();
s_core_cfg.port = iec104_comm_port();
s_core_cfg.common_address = iec104_comm_ca();
if (iec104_core_start(&s_core_cfg) == 0) {
s_started = 1U;
/* 数据源必须**每次 start 成功后**重绑:iec104_source_init() 在每次
* core_start 里把 bindings 清零(见 s_bind_mcu_source 注释)。
* 必须在首次 poll 之前,且只在成功分支——失败时 core 不持有资源。 */
s_bind_mcu_source();
DBG_INFO("i104: listening on %u", (unsigned)s_core_cfg.port);
} else {
DBG_ERROR("i104: start fail port=%u, retry", (unsigned)s_core_cfg.port);
}
}
/*
* 函数功能:netTask 内唯一的 104 推进入口(每轮一次,零阻塞)。
* 入口参数:无
* 返回值:无
* 限定条件:**netTask 上下文**;由 App/task/net_task.c 主循环在
* net_process_messages() 之后、osDelay(1) 之前调用。
* 函数说明:一轮顺序 = 喂狗 -> NET_READY 查询 -> 代次自愈 -> start ->
* core_poll(Prepare(0)->Wait->Process->NextEvent + 有界业务) ->
* 四字段单调化 -> 100 ms 脏标志投递。全程不 osDelay、不取信号量、
* 不读 socket 阻塞面;NET_READY 用 osFlagsNoClear 查询位、不消费。
*/
void iec104_serv_net_tick(void)
{
iec104_core_status_t st;
uint32_t rx = 0U;
uint32_t now;
/* 喂狗点从退役的 iec104Task 移到这里:掩码仍含 IEC104 位,只是置位者换任务。
* 100 ms 抽样 / 800 ms 缺席停喂口径不变,netTask 1 ms 循环天然满足。
* 必须放在所有 early-return 之前:否则 NET_READY 未置位/代次重建等任一
* 分支提前返回都会让看门狗判 104 死、周期复位。这一位置是硬约束。 */
task_wd_beat(TASK_WD_IEC104);
if (sys_evtHandle != NULL) {
if ((osEventFlagsWait(sys_evtHandle, SYS_EVT_NET_READY,
osFlagsWaitAny | osFlagsNoClear, 0U) & osFlagsError) != 0U) {
return; /* 网络未就绪:本轮不动 core,也不喂统计 */
}
}
now = osKernelGetTickCount();
if (net_get_generation() != s_gen) {
uint32_t old_gen = s_gen;
s_gen = net_get_generation();
/* 代次重建自愈时序(可观测日志:old_gen -> new_gen -> start ok/fail):
* net_stack_bring_up 先 net_init(芯片复位+清控制块) 后 net_generation_inc;
* X = 代次变化的这一轮内完成强制 stop -> 重新 start,期间不依赖旧句柄
* Close 成功(见 s_restart_core 注释),监听由 net 层 auto_relisten 自理。 */
s_restart_core(now);
DBG_INFO("i104: net gen %u -> %u, restart", (unsigned)old_gen, (unsigned)s_gen);
}
if (s_started == 0U) {
s_try_start(now);
if (s_started == 0U) {
return; /* 启动未成功:本轮无 poll、无统计刷新 */
}
}
/* 一轮一次零等待推进。core 内部 Prepare(0)->Wait(纯查询)->Process->
* NextEvent + drain_events(16) + 有界业务;最多一次,防止 1 ms 循环里
* 反跑多轮挤占 FTP/UI 的网络时隙。 */
if (iec104_core_poll() != 0) {
/* 服务/装配级失败(非 TCP 断链):core 契约要求 stop 后重建。 */
s_restart_core(now);
DBG_ERROR("i104: poll fail, restart");
return;
}
iec104_core_get_status(&st);
iec104_net_mcu_stats(&rx);
s_link_run = st.active; /* connected && status_valid && data_transfer_started */
/* 代次重建后的可观测收尾:old_gen -> new_gen -> start ok(上一行)-> active 1。
* 主站重连后应看到这一行;若只看到 gen 迁移而无本行,说明 core 起来了但
* STARTDT 未握手,属主站侧问题,不是本端监听重建失败。 */
if ((s_link_run != 0U) && (s_last_active == 0U)) {
DBG_INFO("i104: link active after gen %u", (unsigned)s_gen);
}
s_last_active = s_link_run;
s_stats.conn_up = s_monotonic(st.connections, &s_last_conn, &s_carry_conn);
s_stats.apdu_tx = s_monotonic(st.written_i_frames, &s_last_apdu, &s_carry_apdu);
s_stats.tx_fail = s_monotonic(st.frame_failures, &s_last_txfail, &s_carry_txfail);
/* rx 随每次 core start(IEC104_Net_Init 内 s_rx_bytes=0U)归零,
* 故服务层单调化在重连后生效,与其它三个 core 计数同形态。 */
s_stats.rx_bytes = s_monotonic(rx, &s_last_rx, &s_carry_rx);
/* 100 ms 导出的脏标志投递(旧 iec104Task 的 100 ms 周期语义):peek 非消费,
* 写盘失败时脏标志仍在、下一轮再投 = 天然重试;本任务不碰文件系统
* (配置引擎属主 = defaultTask,模块约定)。用期限递推而非 now%100==0,
* netTask 偶发延迟一轮也不会错过整个 100 ms 窗口。 */
if ((int32_t)(now - s_dirty_next) >= 0) {
s_dirty_next = now + I104_DIRTY_TICK_MS;
if ((prot_set_dirty_peek() != 0U) && (sys_evtHandle != NULL)) {
(void)osEventFlagsSet(sys_evtHandle, SYS_EVT_PROT_SET_SAVE);
}
if ((run_par_dirty_peek() != 0U) && (sys_evtHandle != NULL)) {
(void)osEventFlagsSet(sys_evtHandle, SYS_EVT_RUN_PAR_SAVE);
}
}
}
/*
* 函数功能:读 104 观测计数(契约见 iec104_serv.h 的 iec104_serv_get_stats)
* 入口参数:p_out - 输出缓冲;NULL 时无害返回
* 返回值:无
* 限定条件:任意上下文;不取锁、不读时刻、不碰 socket、不阻塞
* 函数说明:先读进局部再整体赋出——读者拿到的是同一轮读取的四元组。本函数
* 不清零、不复位任何计数;四字段口径见 .h 注释。
*/
void iec104_serv_get_stats(iec104_serv_stats_t *p_out)
{
iec104_serv_stats_t s;
if (p_out == NULL) {
return;
}
s = s_stats;
*p_out = s;
}
/*
* 函数功能:读 104 链路是否处于 RUN 态(契约见 iec104_serv.h)
* 返回值:1 = core.status.active(STARTDT 数据传输已启动);0 = 其它
* 限定条件:任意上下文;单字节镜像,原子读
* 函数说明:s_link_run 由 net_tick 从 core.status.active 镜像,等价于旧
* link_state==RUN;屏板通信灯 ID 3 消费。
*/
uint8_t iec104_serv_link_run(void)
{
return s_link_run;
}