Files
STM32F4-Base/App/task/iec104_serv.c
T
wandering1 90cc9a7d99 feat(iec104): 把 104 骨架完整迁到 MCU 板端并在台架跑通总召
把 IEC104 从模拟器端整体搬到板端:协议栈原先由独立 iec104Task 驱动,
现在改为 netTask 单 owner 的 threadless 驱动,退役独立任务。

驱动与后端:
- 新增 iec104_net_mcu.c/.h,实现 IEC104_Net.h 的 11 个 ABI 函数,
  用槽表加单调句柄映射 net_socket 的单 fd 模型;CLIENT 拆除只走
  net_drop_conn_locked,绝不 net_close 监听 fd。
- net_socket 增 5 个 owner-only 接口(net_accept_locked、
  net_drop_conn_locked、net_pending_bytes、net_send_try、
  net_mono_now_ms)。
- iec104_serv.c 重写为 iec104_serv_net_tick(),在 netTask 1ms 主循环
  里驱动 core;无 osDelay/阻塞调用,喂狗是第一句。
- Src/freertos.c 删除 iec104Task 三件套,对应栈水位探针表项同步删除。

内存:目标板 192KB SRAM 装不下 vendor 默认容量档,按实测裁剪到
skeleton 档(TCP 缓冲、业务池、SOE 256->128、值槽密集化),
RW_IRAM1 118,408 B / 90.3%,留 2,178 B 余量。

台架修复(只在真硬件暴露):
- SNTP s_ctx.fd 零初始化后为 0,而 net fd 0 是合法槽位下标,
  首次代次变化时误 net_close(0) 关掉 ftpTask 的监听槽,导致 104
  连接被 FTP 的 220 banner 抢走;改为显式 .fd = -1。
- Accept 幂等:单 fd 模型下 vendor 每轮重试 Accept 会拿到同一 fd,
  后端改为会话在役时返 WOULD_BLOCK,Close 不再清槽。

验证:
- Keil 全量重建 0 error 0 warning,uvprojx 零抖动。
- 模拟器真实 TCP 13/13、transport 10/10。
- netmcu 后端单测 13/13(新增 N12)。
- 台架 serial-boot-test required 全中;板端 2404 总召 129 帧收到
  59 遥信(53 有源、全 IV)+ 16 双点 + 30 遥测(PT1 三相非零、
  UN/频率/温度按未标定置 IV)、遥控选择执行全否定、校时 COT 7。
- 期间顺带修正 UI 漂移自检文案、.serialtest required 陈旧项、
  coding-standard 对 vendor 与外部 ABI 名字的排除口径。
2026-11-18 10:29:18 +08:00

371 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/protocol/iec104/ 与 vendor
* App/protocol/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:28 明确"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:573 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;
}