/* * 模块名称: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 定值源回调,按语义 ID 从 prot_set 实时读 Q10 工程量。 * 入口参数:ctx - 未用;id - 语义编号(保护映射表保证有效);value - 输出值 * 返回值:true = 读到;false = 语义号越界或模型读失败 * 限定条件:仅 netTask(core poll 串行调用);禁止任何配置 I/O 或阻塞 * 函数说明:ID 先按 PS_ID_COUNT 复核,再走 prot_set 的无锁一致读; * 比例换算仍由 source 层按参数表的 source_scale 完成。 */ static bool s_parameter_read(void *ctx, uint16_t id, float *value) { (void)ctx; if (value == NULL || id >= (uint16_t)PS_ID_COUNT) { return false; } *value = prot_set_get_f((prot_set_id_t)id); return true; } /* 函数功能:104 定值整批 apply 回调,把语义变更翻译成 prot_set 原子事务。 * 入口参数:ctx - 未用;v/n - 变更数组;validate_only - 只校验不提交 * 返回值:true = 整批合法(校验阶段零副作用);false = 任一项越界/非法 * 限定条件:仅 netTask(core poll 串行调用);禁止逐项写和阻塞等待 * 函数说明:先拒空批与超过 17 项消费者上限的批次;栈上 17×8=136 B 的 * prot_set_change_t 在 netTask 960 words 栈预算内可控;Q10 量化后 * 交给 prot_set_apply_batch 一次提交,校验/提交两阶段由 source 层调用。 */ static bool s_parameter_apply(void *ctx, const iec104_source_change_t *v, size_t n, bool validate_only) { prot_set_change_t batch[IEC104_DTU_CONSUMER_COUNT]; size_t i; (void)ctx; if (v == NULL || n == 0U || n > IEC104_DTU_CONSUMER_COUNT) { return false; } for (i = 0U; i < n; ++i) { if (v[i].id >= (uint16_t)PS_ID_COUNT) { return false; } batch[i].id = (prot_set_id_t)v[i].id; batch[i].q10 = PROT_SET_Q10(v[i].value); } return prot_set_apply_batch(batch, n, validate_only ? 1 : 0) == 0; } /* 函数功能:绑定板端数据源到 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"且无任何日志。 * 17 个消费者的 read/apply 在此成对注册:read 直读 prot_set 当前值, * apply 只构造批量事务,持久化仍由 defaultTask 的脏标志闭环负责。 */ static void s_bind_mcu_source(void) { static const iec104_source_bindings_t bindings = { NULL, s_measure, s_signal, s_parameter_read, s_parameter_apply }; 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; }