Files
STM32F4-Base/test/host/iec104_netmcu/MATRIX.md
T
wandering1 a2242b7345 fix(iec104): IEC104_Net_Listen 判空与解引用落在同一分支(真 cppcheck 抓出)
装真 cppcheck 2.21.0 后全库扫出 nullPointerRedundantCheck 两条,落在
App/iec60870/104/iec104_net_mcu.c 的 IEC104_Net_Listen:

    if (... || listener == NULL || bound_port == NULL || ...) {
        *listener = IEC104_NET_INVALID_SOCKET;   /* listener 可能就是 NULL */
        *bound_port = 0U;                        /* bound_port 可能就是 NULL */
        return ...;
    }

判空之后在同一个失败分支里解引用这两个指针。真机上当前唯一调用点传的都是
合法对象地址,所以现网不发作;但这是 ABI 的防御分支,任何传 NULL 的新调用点
或测试都会踩空指针——实测坏实现上进程直接 0xC0000005 终止。

同目录 IEC104_Net_Windows.c 的同名函数早已是正确的两步写法(先条件清空输出、
再判空返回),本次把 MCU 版对齐到那个顺序。s_inited 与 owner 两个条件原样保留。
校验之后原来那两行无条件清空同时删除——拆分后走到那里两指针必然非空、输出
已是 INVALID/0,保留只是同值重赋。

TDD:先加 N13~N16 四条入参校验用例(bind_address NULL / 未 Init / listener NULL
/ bound_port NULL),在旧实现上跑是崩溃红(run_rc=0xC0000005、无 FAIL 行),
修完 17/17 绿。四条断言 ERROR+NET_ERR_INVAL、可写输出被清成 INVALID/0、零硬件调用。

顺带修掉 runner 一个假绿:旧口径用例数取 CASE_COUNT - len(failed_cases),进程
被访问违例杀掉时没有 FAIL 行,于是打印 "passed 13/13" 并 return 0。现改为
run_rc != 0 或没跑到汇总行 → 打印 NOT green + return 1。这是本次红证据能成立
的前提——没有它,崩溃会被读成满分。

另:results/ 下三份 report 与 selftest 改为 LF + 尾换行(json.dump 原来不带),
selftest.txt 改记仓库相对路径(原来写绝对路径,跨机器/跨工作树必漂)。
2026-11-19 13:05:22 +08:00

16 KiB
Raw Blame History

板端 IEC104 Net 后端隔离契约测试矩阵

交接说明(最终交付状态)

  • 这组测试证明什么:针对 App/iec60870/104/iec104_net_mcu.c(被测 SHA256 8528f6031180d0fcf7e99c86486123664c9d14ae1931ce9734f7e53ce889c864)的真实后端,在 fake net 层上证明 IEC104 Net ABI 契约:同 fd 语义下 Close 不毁监听、Pending_Input 精确/降级有界续收、Send 短写且不借用 buffer、Now_Ms 跨 32 位 tick 回绕单调、网络代次与句柄失效、断链重连、非 owner 入口拒绝、两句柄模型下代次重建后的监听存活(armed==1)与无 ABA、单 fd 会话的 Accept 一次性语义(已有 CLIENT/CLIENT_EOF 槽时 WOULD_BLOCK、零芯片事务、Close 后释放;旧语义"re-Accept 再发新句柄"已实测导致板端拆活连接,2026-11-18 台架),以及 IEC104_Net_Listen 的入参校验(N13~N16:某个输出指针为 NULL 时必须清空其余输出并返回 ERROR,绝不向 NULL 写入)。最终实测:文本级静态 2/2、静态 checker 变异自测 real_rc=0 mutant_rc=1、动态 17/17(real backend passed 17/17)。
  • 这组测试不证明什么:fake net 层只是按产品头语义实现,不是真实 CH395F 驱动或板端电路;CH395F 板端行为未验(同 fd 语义待板端确认);core / TcpServer 集成未验(完整 STARTDT 建链为 NOT_RUN);netTask 队列/临界区与板端时序未验;MCU WCET / 性能未测;真实后端编译期坏变体未做,历史 TEST DOUBLE B1~B7 仅证明 harness 有效性;S1/S2 是文本级静态检查,不覆盖宏展开或函数指针间接调用。禁止据此写“板端已验证”。
  • N4 的职责边界:monotonic / wrap 断言测的是 fake 受控 tick 下适配层 IEC104_Net_Now_Ms 的调用面契约;实现层的 32 位 tick 回绕扩展由 test/host/sys_clock 覆盖(该套件有回绕变异反证)。两者职责正交,不要用本处断言推断时钟实现正确。
  • 一条命令复现(仓库根执行):python test/host/iec104_netmcu/check_static_selftest.py && python test/host/iec104_netmcu/check_static.py && python test/host/iec104_netmcu/run_netmcu_tests.py && git diff --check -- test/host/iec104_netmcu
  • 产物在哪里:本目录 test/host/iec104_netmcu/;最终动态证据 results/real/{build.log,run.log,report.json},静态证据 results/static/report.json,静态 checker 变异自测 results/static_mutant/{report.json,selftest.txt,iec104_net_mcu_BAD.c},历史 TEST DOUBLE 证据 results/report.json 与 results/{good,B1..B7}/。所有文件未提交、未改产品/供应商源码;第二步 serv 重写后待命做 iec104_serv_net_tick 针对性核查。

状态与边界

  • 被测对象:App/iec60870/104/iec104_net_mcu.c(真实板端 Net 后端,net-cutover 所有)对 IEC104_Net.h 的实现。
  • 测试替身:net_socket_fake.{h,c} 按产品 Drivers/BSP/NET/net_socket.h 声明模拟 net_* owner 出口(包括 net_send_try / net_pending_bytes / net_accept_locked / net_drop_conn_locked / net_ctx_is_owner_task 等),并提供通用时钟 sys_clock_mono_ms 的替身(原 net 栈时钟已搬迁至 App/util/sys_clock,此处按 N-2 采样口径模拟 32 位 tick 回绕扩展);受控注入单连接同 fd、短写 / WOULD_BLOCK / BUSY / RETRY_LATER、EOF / RST、网络代次变化、句柄非复用、芯片接收队列长度与 32 位 tick 回绕。绝不调用真实 CH395F 或 Windows socket。
  • CH395F 同 fd 语义(fake 已如实建模,板端仍待验证):net_accept / net_accept_locked 返回监听 socket 自身(net_socket_fake.c:629-643 的 return sockfd;),并为同一 fake fd 置 established=1;net_close 对监听 fd 会真实销毁监听并递增 listen_closed_attempts(net_socket_fake.c:760-777),而 net_drop_conn 只拆会话、保留监听(net_socket_fake.c:779-797)。因此 fake 不是 Winsock 式独立 fd 语义,N1/N8 断言的“Close 不毁监听”确实在同 fd 规则下判定;但这只是 fake 忠实模拟,CH395F 实际行为仍待板端验证。
  • 本目录不进 MDK-ARM/*.uvprojx,不碰产品构建;只在主机侧用 MSVC 编译运行。
  • 证据边界:这是 真实后端 + fake net 层 的 Net ABI 隔离证据,不等于完整 iec104_core / TcpServer 链路,不等于板端 CH395F / netTask 时序,也不是 MCU WCET。完整 STARTDT 建链流程仍为 NOT_RUN。
  • Lead 三条口径:① Now_Ms = N-2(owner 周期采样),只测回绕后单调,不测“不调用也不漏记”;② Pending_Input 精确:RX=7 报 7、RX=0 报 0,不谎报 1/0;③ Send 返回后不借用 buffer:每次用不同源 buffer,返回即覆写,再断言 fake 内核中字节未被破坏。
  • 已知平台偏离:CH395F 无 setsockopt,App/iec60870/104/iec104_net_mcu.h 注释已入档;恒无 Nagle 视作平台事实,不以 NODELAY 作为 OK 条件。plan.md 的入档由 net-cutover 负责。

静态源码检查(先于动态用例)

编号 检查 判据 实测
S1 IEC104_Net_Close 的 CLIENT/CLIENT_EOF 分支不含 net_close_sock 花括号范围机械匹配,非肉眼 PASS,源文件 582-588 行
S2 IEC104_Net_Recv 的 rc==0 EOF 分支只改角色,不含任何 close/drop 调用 花括号范围机械匹配 PASS,源文件 408-414 行

静态检查源文件 SHA256:08ca22b9d61ec86181973ab97d7fab68ec8f0ecbf944bfd758e1546a80dc8b35;results/static/report.json 记录逐项 source_lines / evidence / passed。

S1/S2 覆盖面(重要):这是文本级静态检查——用花括号范围匹配特定分支,断言其中不出现 net_close_sock 等标识符;它覆盖直接调用形态,不做语法树/控制流分析,宏展开、函数指针或间接调用形态不在覆盖范围。不得把 S1/S2 PASS 表述为“所有关监听路径均不存在”。

静态判据自身有效性有降级证据:check_static_selftest.py 在 results/static_mutant/iec104_net_mcu_BAD.c 中把 net_close_sock 注入真实 Close 的 CLIENT 分支,断言 check_static.py 对该副本返回 passed 1/2(S1 失败)且 RC≠0,同时对真实源文件仍 2/2 RC0。实测:static-checker selftest: real_rc=0 mutant_rc=1;证据 results/static_mutant/{report.json,selftest.txt,iec104_net_mcu_BAD.c}。产品源文件未改。

动态用例矩阵

共 17 个命名用例(N2 拆为 N2a/N2b 两个 case,但同属一个 N2 测试函数;report.json 的 case_count=17、case_names 与 case_count_basis 与此一致)。

编号 用例 关键断言 实测
N1 Close 会话不影响监听 逻辑 client handle ≠ listener handle;Close(client) 后 listen_closed_attempts==0、drop_conn_calls>=1,同一 listener 可再 Accept PASS
N2a Pending_Input 精确值 RX=7 → available==7;排空后 RX=0 → available==0 PASS
N2b 接收队列查询降级/报小不藏数据 300B 在哨兵/报小模式下仍全部交付,不死循环、不提前结束 PASS
N3 Send 短写推进 + 零借用 20B 分多次推进;20 个不同源 buffer 返回后均涂 0xEE;fake 内核仍为涂改前 0x41..0x54 PASS
N4 Now_Ms 跨 32 位回绕单调 tick 0xFFFFFFF0 → 0xFFFFFFFF → 0;64 位值严格递增,回绕差值 1ms PASS
N5 网络代次变化使旧句柄失效 旧 client 的 Send/Recv/Pending/Accept 均 ERROR/BADF;旧 client Close 幂等 OK 且 hardware_calls 零增长;无 Init 的新 Listen 可用 PASS
N6 fd 复用 / 陈旧句柄不串味 Close 后旧 client handle 读写 ERROR、重复 Close 幂等;新 client handle 不同且可收发;监听从未被关 PASS
N7 断链重连(Net 层) RST → Recv ERROR → Close(client) → listener 仍活 → 新 client handle → Send OK;完整 STARTDT 仍 NOT_RUN PASS(Net 层)
N8 Close 后同一 listener 再 Accept 第二次 Accept 成功;listen_closed_attempts==0 机器断言;listener fd 仍活 PASS
N9 非 netTask 上下文拒绝 所有入口 ERROR + NET_ERR_INVAL;available / ready_events 输出不变;hardware_calls 零增长、无死锁 PASS
N10 代次切换的两句柄模型(戊+不变量) h_client ≠ h_listener;代次推进后两句柄均失效;旧 client Close 幂等 OK 且 hardware_calls 不增、listen_closed_attempts==0;代次推进后旧 listener 已失效(armed==0),重建 Listen 后 net_fake_listener_armed()==1 正向断言;不调 Init 重建 h3 严格 >旧句柄(无 ABA);新 client Send OK PASS
N11 单 fd 会话的 Accept 一次性语义(2026-11-18 台架事故修复证据) 已有 CLIENT 槽时第 2 次 Accept 返回 IEC104_NET_WOULD_BLOCK、client 出参不变;drop_conn_calls / hardware_calls 均不增(闸为纯 RAM,零芯片事务);listen_closed_attempts==0;armed==1;H1 正向证明:库手里的首个 client 句柄仍能命中 CLIENT 槽并 Send OK、会话 fd 不变且与监听槽同 fd(旧代码 memset 旧槽会让 H1 悬空 → BADF → Drop_Client,这是"STARTDT 无回应 + 20~33ms EOF"的第一击);Close 旧 client 后新 Accept 成功(无永久静默拒连) PASS
N12 会话在役时 Wait 不报假 ACCEPT(重复 Accept 引擎闸) 无会话时 IEC104_Net_Wait(ACCEPT) 报 READY;会话在役后 ready_events 不含 IEC104_NET_EVENT_ACCEPT(net_listener_armed 对 ESTABLISHED 恒返 1,不挡则库每轮误判可接入、重复调 Accept);Close 后恢复报 READY(非永久静默拒接) PASS
N13 Listen 拒绝 NULL bind_address bind_address==NULL(两个输出非空)→ ERROR + NET_ERR_INVAL;入参预置的哨兵值被清成 INVALID_SOCKET / 0;hardware_calls 零增长 PASS
N14 Listen 拒绝未 Init 态 IEC104_Net_Cleanup() 之后三指针全非空 → ERROR + NET_ERR_INVAL;两个输出同样被清空;零硬件访问 PASS
N15 Listen 拒绝 NULL listener(cppcheck 缺陷回归) listener==NULL、bound_port 非空 → ERROR + NET_ERR_INVAL 且不崩溃;*bound_port 仍被清成 0(证明"清空其余输出"仍生效);零硬件访问 PASS(改前:访问违例 0xC0000005)
N16 Listen 拒绝 NULL bound_port(cppcheck 缺陷回归) bound_port==NULL、listener 非空 → ERROR + NET_ERR_INVAL 且不崩溃;*listener 仍被清成 INVALID_SOCKET;零硬件访问 PASS(改前:访问违例 0xC0000005)

N13~N16 的来源:cppcheck 2.21.0 nullPointerRedundantCheck 指出 IEC104_Net_Listen 在 判空之后、同一个失败分支里写 *listener / *bound_port。旧实现对 N15/N16 两条输入 直接在宿主上访问违例(0xC0000005),进程无 FAIL 行即中止。修复按 App/protocol/iec60870/104/IEC104_Net_Windows.c 的顺序:先各自判空清空输出,再统一 判空返回;s_inited 与 owner 两个条件原样保留。红/绿原始日志见 ci-artifacts/net-listen-null-tdd-red.log / ...-green.log(不入库)。

两句柄模型(net-cutover 第三轮定案):LISTEN 槽 handle 在监听生命周期内不变,Accept 另起 CLIENT 槽与新 handle;不再翻转监听槽 role。这正是 N8 / N10 / N11 的判据来源。 N11 原语义("re-Accept 再发新句柄、只 memset 旧槽")已实测导致板端拆活连接,两层伤害:① 第 2 次 Accept 的 memset(client_slot) 清掉库仍持有的 H1 槽 → slot_by_handle(H1) 失败 → STARTDT_ACT 的 Send 报 BADF → Drop_Client(第一击,解释了 STARTDT 无回应 + 20~33ms EOF);② 即便不清槽而另开 H2,库仍在 IEC104_TcpServer.c:1606 Close(client) 把与监听同 fd 的会话拆掉(第二击)。现行语义 = Accept 一次性硬闸(已有当前代次 CLIENT/CLIENT_EOF 槽一律 WOULD_BLOCK,含 EOF 收尾窗口,先纯 RAM 判后碰芯片)+ Wait 侧 ACCEPT 就绪闸(N12),Close 后自动释放。这是防止同根因复发的行为证据。

坏变体与注入有效性

  • TEST DOUBLE 阶段(历史 harness-validity 证据,不是产品证据):netmcu_stub_test.c + stub_iec104_netmcu.c 的 B1B7 全部变红:good 7/7;B1..B7 red 7/7。注入点:B1 Close 误用 net_close、B2 Pending 降级谎报 0、B3 Send 借用 buffer、B4 tick 强转、B5 忽略代次、B6 陈旧 Close 误关、B7 重连沿用 startup_ack。原始逐变体日志保留在 results/good/ 与 results/B1/results/B7/。
  • 真实后端阶段:B1B7 宏依赖 TEST DOUBLE,不适用于真实后端,标记 NOT_RUN;真实后端的文本级静态面由 S1/S2 + check_static_selftest.py 覆盖,行为面由 N1N16 覆盖。不得把 TEST DOUBLE 的 7/7 红当成真实后端坏变体结果。N15/N16 另有一份单元级别的反向证据:用 HEAD 版后端副本(NETMCU_BACKEND 指向 ci-artifacts/net-listen-null/head_iec104_net_mcu.c,SHA256 与 git show HEAD:... 一致)跑同一套用例,进程以 0xC0000005 中止,runner 报 NOT green。

测试发现的问题(独立验收追溯)

时间 后端 SHA256 发现 处置
2026-11-17 23:20+ bc7154e5…(第三轮两句柄初版,620 行) 首次真实后端跑 N9:Recv/Pending_Input/Send/Wait 四入口缺 owner 闸,非 owner + 无效句柄返回 BADF/OK 而非 ERROR+NET_ERR_INVAL net-cutover 补 owner 闸(最终 08ca22b9…,620 行),复测 PASS
2026-11-17 23:22+ 08ca22b9… 前夕 N10 初版断言暴露:重建 Listen 若走 Init 会重置句柄计数,产生 ABA 风险;测试改为不调 Init 的 listen_only() 并断言 h3 严格大于旧句柄 后端保持单调递增句柄实现,复测 PASS
2026-11-17 23:26+ 08ca22b9… 按 protocol-review/lead 补 A7 正向断言时发现 fake 的 generation_inc 会清掉旧监听 armed(芯片复位语义),“stale 后、重建前 armed==1”不成立;断言改为 stale 后 armed==0、重建后 armed==1 测试口径修正,非后端缺陷;复测 PASS

复现命令与最终实测输出

仓库根执行(最终后端 SHA256 8528f6031180d0fcf7e99c86486123664c9d14ae1931ce9734f7e53ce889c864):

python test/host/iec104_netmcu/check_static.py
python test/host/iec104_netmcu/check_static_selftest.py
python test/host/iec104_netmcu/run_netmcu_tests.py

实测输出:

static source sha256=8528f6031180d0fcf7e99c86486123664c9d14ae1931ce9734f7e53ce889c864
S1: Close CLIENT/CLIENT_EOF branch contains no net_close_sock 642-648 passed=True
S2: Recv EOF branch only changes role; no close/drop call 462-468 passed=True
static passed 2/2
static-checker selftest: real_rc=0 mutant_rc=1
real: build_rc=0 run_rc=0 note= failed_cases=[]
real backend passed 17/17

git diff --check -- test/host/iec104_netmcu 无输出(RC0)。results/real/build.log / results/real/run.log 是逐条原始日志,results/real/report.json 记录被测源文件哈希、测试源文件哈希、case count = 17、失败用例列表、NOT_RUN 项与已知偏离。results/static/report.json 与 results/static_mutant/report.json 记录静态正向/变异结果。

runner 另有一条崩溃闸(本次 N15/N16 红测时暴露的假绿口径):旧版把"用例总数 − FAIL 用例数"当作通过数,进程被访问违例杀掉时没有 FAIL 行 → 打印 passed N/N 并 return 0。现口径为:只有 run_rc==0 且跑到汇总行才打印 passed,否则打印 real backend NOT green: crashed: rc=...(0xC0000005) 并 return 1。NETMCU_BACKEND / NETMCU_OUT 环境变量可把产品源或结果目录指向临时副本,用于在不改产品源的前提下复现历史红线。

证据口径

  • 动态 17/17 + 文本级静态 2/2 + 静态 checker 变异自测 1 red 只证明:真实 Net 后端在 fake net 层上的 ABI 契约、两个文本级静态不变量、N11 单 fd Accept 一次性语义(WOULD_BLOCK + 零芯片事务 + H1 仍有效 + Close 后释放)、N12 Wait 侧 ACCEPT 就绪闸(会话在役不报假 ACCEPT、Close 后恢复),以及 N13~N16 的 Listen 入参校验(NULL 输出指针不清空即崩溃,其余输出仍被条件清空)。
  • 未证明 / NOT_RUN:完整 IEC104 STARTDT 业务链路、真实 CH395F 同 fd 行为(fake 忠实模拟但板端未验)、netTask 队列/临界区、板端时序与 MCU WCET、真实后端编译期坏变体、宏/函数指针间接调用形态的静态覆盖。不得写“板端已验证”。