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 名字的排除口径。
This commit is contained in:
2026-11-18 10:29:18 +08:00
parent 2e9272cc8a
commit 90cc9a7d99
125 changed files with 7463 additions and 5335 deletions
+64 -16
View File
@@ -2,20 +2,28 @@
* 模块名称:SOE 记录编解码主机侧纯逻辑单元测试(B9)
* 模块功能:离线验证 App/log/soe_rec.c——64B 定长记录构建/解析往返、
* 校验和硬门槛(撕裂/半写拒绝)、版本门槛、CP56Time2a 时标
* 编码正确性(与 iec104_asdu.c 的 CP56 解码交叉验证:同一算法族
* 两个实现互证)、IV 语义、钳位、保留区清零。
* 编码正确性(与 vendor 公共时间库的 CP56 解码交叉验证)、
* IV 语义、钳位、保留区清零。
*
* 被测对象:真实源文件(#include 原样纳入):
* soe_rec.c(B9 记录编解码)
* iec104_asdu.c(交叉验证用 CP56 解码器,纯逻辑)
* IEC60870_Time.c(交叉验证用 CP56 公共编解码器)
*
* 交叉验证对象说明(2026-11-18 换人):
* 原先交叉验证的是我方过渡层 iec104_asdu.c 的 iec104_cp56_to_epoch_ms()。
* task-18 割接把那一层整族删除(104 现由 vendor 子集 + iec104_core 承担),
* 于是改与 vendor 的 IEC60870_Time_From_CP56()/CP56_To_Seconds() 互证——
* 这比原来更有意义:soe_rec 编出来的字节要能被**真正上行的那套**解码器读懂。
* 两者口径差已在此显式钉住(vendor 上限 2099 年、IV 分「解码保留」与
* 「转秒拒绝」两步),不假装它们可以无条件互换。
*
* 覆盖点:
* TC-SOE-001 构建/解析字段往返(type/elm/flags/seq/epoch/value)
* TC-SOE-002 校验和硬门槛:单字节翻转 → -3;版本篡改 → -2
* TC-SOE-003 CP56 编码正确性:已知 epoch → 期望字节序列;
* 与 iec104_cp56_to_epoch_ms 往返互证(含闰日 2024-02-29)
* 与 vendor CP56 解码 + 转秒往返互证(含闰日 2024-02-29)
* TC-SOE-004 IV 语义:flags IV → CP56 byte2 bit7 置位 + epoch 字段 0
* TC-SOE-005 钳位:epoch < 2000 → 2000-01-01;epoch > 2127 上界 → 2127-12-31
* TC-SOE-005 钳位:epoch < 2000 → 2000-01-01;2106 落在 vendor 2099 上限之外
* TC-SOE-006 结构不变量:size=64、保留区 [23..62] 恒 0、sum=sum8([0..62])
* TC-SOE-007 序号域:0 / 0xFFFFFFFF 边界往返(uint32 回绕语义)
*
@@ -35,7 +43,43 @@ static int s_total = 0, s_passed = 0, s_failed = 0;
} while (0)
#include "soe_rec.c"
#include "iec104_asdu.c"
/* 交叉验证用 vendor 公共时间库:**强制纯整数路径**(IEC60870_TIME_USE_PLATFORM=0),
* 与固件一致——MCU 侧非 _WIN32,该宏恒为 0,走的是 Days_From_Civil 那套整数算法。
* 主机侧若留着默认值 1,就会去调 _gmtime64_s,测到的是一条固件永远不会走的路径。 */
#define IEC60870_TIME_USE_PLATFORM 0
#include "IEC60870_Time.c"
/*
* 函数功能:交叉验证辅助——CP56 七字节 → UTC 毫秒
* 入口参数:buf - 7B CP56;epoch_ms - 输出毫秒
* 返回值:0 成功;-2 = IV=1(解码保留有效但不可当有效时间);-3 = 格式/字段非法
* 函数说明:与 task-18 删掉的 iec104_cp56_to_epoch_ms() 保持同一套返回约定,
* 于是本文件的既有断言不必为「换了解码器」而改写——换的只是实现来源。
* vendor 把「解码保留 IV」和「转有效时间时拒绝 IV」分成两步,
* 这里把第二步的拒绝折成 -2,语义与旧解码器一致。
*/
static int s_cross_cp56_to_epoch_ms(const uint8_t *buf, uint64_t *epoch_ms)
{
IEC60870_CP56Time2a_t v;
uint32_t secs;
if ((buf == NULL) || (epoch_ms == NULL)) {
return -3;
}
if (!IEC60870_Time_From_CP56(buf, IEC60870_CP56_LEN, &v)) {
return -3;
}
if (v.is_invalid != 0u) {
return -2;
}
/* 偏移 0:SOE 记录里的 CP56 就是 UTC 分解,不做本地时区换算 */
if (!IEC60870_Time_CP56_To_Seconds(&v, 0, &secs)) {
return -3;
}
*epoch_ms = ((uint64_t)secs * 1000u) + (uint64_t)v.time.ms;
return 0;
}
/* ---------------- TC-SOE-001 字段往返 ---------------- */
static void tc_roundtrip(void)
@@ -102,7 +146,7 @@ static void tc_cp56(void)
/* 显式字段:12:34:56 → ms 域 = 56*1000(秒域时基如实编码,亚秒 0) */
CHECK(((uint32_t)out.cp56[0] | ((uint32_t)out.cp56[1] << 8)) == 56000u,
"TC-SOE-003 ms field = sec*1000 (56000)");
rc = iec104_cp56_to_epoch_ms(out.cp56, &back);
rc = s_cross_cp56_to_epoch_ms(out.cp56, &back);
CHECK(rc == 0, "TC-SOE-003 cross decode ok");
CHECK(back == 1791808496000ULL, "TC-SOE-003 cross roundtrip exact");
@@ -111,13 +155,13 @@ static void tc_cp56(void)
(void)soe_rec_parse(rec, &out);
CHECK(out.cp56[4] == 29u && out.cp56[5] == 2u && out.cp56[6] == 24u,
"TC-SOE-003 leap day fields");
rc = iec104_cp56_to_epoch_ms(out.cp56, &back);
rc = s_cross_cp56_to_epoch_ms(out.cp56, &back);
CHECK((rc == 0) && (back == 1709164800000ULL), "TC-SOE-003 leap roundtrip");
/* 2000-01-01 00:00:00 边界 */
soe_rec_build(rec, (uint8_t)SOE_T_PLATE_IN, 0u, 0u, 3u, 946684800u, 0u);
(void)soe_rec_parse(rec, &out);
rc = iec104_cp56_to_epoch_ms(out.cp56, &back);
rc = s_cross_cp56_to_epoch_ms(out.cp56, &back);
CHECK((rc == 0) && (back == 946684800000ULL), "TC-SOE-003 year-2000 boundary");
}
@@ -132,7 +176,7 @@ static void tc_iv(void)
(void)soe_rec_parse(rec, &out);
CHECK((out.cp56[2] & 0x80u) != 0u, "TC-SOE-004 cp56 IV bit set");
CHECK(out.epoch_s == 0u, "TC-SOE-004 epoch field zeroed");
CHECK(iec104_cp56_to_epoch_ms(out.cp56, &back) == -2,
CHECK(s_cross_cp56_to_epoch_ms(out.cp56, &back) == -2,
"TC-SOE-004 cross decoder rejects IV");
}
@@ -147,16 +191,20 @@ static void tc_clamp(void)
(void)soe_rec_parse(rec, &out);
CHECK((out.cp56[4] == 1u) && (out.cp56[5] == 1u) && (out.cp56[6] == 0u),
"TC-SOE-005 clamp low -> 2000-01-01");
(void)iec104_cp56_to_epoch_ms(out.cp56, &back);
(void)s_cross_cp56_to_epoch_ms(out.cp56, &back);
CHECK(back == 946684800000ULL, "TC-SOE-005 clamp low exact");
/* epoch_s 为 uint32 → 最大 2106-02-07(0xFFFFFFFF),恒在 CP56 域内:
* 上界钳位是防御性死分支(epoch 域扩展时生效),此处断言精确往返 */
/* epoch_s 为 uint32 → 最大 2106-02-07(0xFFFFFFFF),CP56 年字段装得下(106 年偏移)。
* **但 vendor 公共库的 CP56 只认 2000..2099 年**(IEC60870_CP56_MAX_YEAR),
* 2106 会被 From_CP56 直接判为非法。这不是缺陷而是两层的口径差:
* soe_rec 的 7bit 年字段能编码到 2127,而 104 上行只接受 2099 以内。
* 因此这里断言的是「soe_rec 编码成功 + 交叉解码器明确拒绝」,
* 不假装它还能往返——假装才是骗人(旧解码器宽到 2127,才显得能往返)。 */
soe_rec_build(rec, (uint8_t)SOE_T_ELM_ASSERT, 0u, 0u, 5u, 0xFFFFFFFFu, 0u);
(void)soe_rec_parse(rec, &out);
CHECK(out.cp56[6] == 106u, "TC-SOE-005 uint32 max -> year 2106 (no clamp needed)");
(void)iec104_cp56_to_epoch_ms(out.cp56, &back);
CHECK(back == 4294967295000ULL, "TC-SOE-005 uint32 max exact roundtrip");
CHECK(out.cp56[6] == 106u, "TC-SOE-005 uint32 max -> year 2106 (cp56 year field)");
CHECK(s_cross_cp56_to_epoch_ms(out.cp56, &back) == -3,
"TC-SOE-005 year 2106 rejected by vendor CP56 (limit 2099)");
}
/* ---------------- TC-SOE-006 结构不变量 ---------------- */