From 1f51e8fa2f24a4e8821ac618050ae98ea6b9f349 Mon Sep 17 00:00:00 2001 From: Wanderingss <1624155937@qq.com> Date: Thu, 19 Nov 2026 00:38:09 +0800 Subject: [PATCH] =?UTF-8?q?refactor(net):=20=E5=8D=95=E8=B0=83=E6=97=B6?= =?UTF-8?q?=E9=92=9F=E6=90=AC=E5=9B=9E=E6=97=B6=E9=97=B4=E6=A8=A1=E5=9D=97?= =?UTF-8?q?=EF=BC=8Cowner-only=20=E5=85=A5=E5=8F=A3=E8=A1=A5=E6=9C=BA?= =?UTF-8?q?=E5=99=A8=E5=AE=88=E5=8D=AB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 起因:104 适配层的 net 栈净增 5 个对外声明,其中 3 个是真新增。逐个查过: net_pending_bytes / net_send_try 位置正确、不可替代(前者是 BSD FIONREAD 语义, 后者必须截到 NET_SEND_CHUNK_MAX 才不丢进度),保留不动;另外 2 个 net_accept_locked / net_drop_conn_locked 在更早的提交里只是把 static 去掉, 函数体一字未改,不是新函数。真正有问题的是三处: 一、net_mono_now_ms 放错层。这是"把 32 位 HAL_GetTick 扩成 64 位单调毫秒"的 时间工具,却挂在 socket 栈上。搬到 App/util/sys_clock,改名 sys_clock_mono_ms, 临界区保护读改写,零 NET 依赖(旧实现里的 owner 判定与非 owner 返回 0 语义 不再搬过来——时钟是纯读取,ABI 未要求)。 二、头注释把通用能力绑死到单个消费者。原文写"以下五个入口专供 netTask 内 IEC104 Net 后端使用",下一个读者要么不敢用、要么直接删掉。改写成通用 owner-only 能力描述,入口计数核准为 4。 三、两个 locked 函数没有任何 owner 校验,只在注释里写"必须在 netTask 上下文"。 而 net_accept_locked 函数体第一句就 net_poll() 跑真实 CH395F SPI 事务——别的 任务误调会与 netTask 抢同一根 SPI 总线,正是 TRAP-NET-14 的形态。两个函数头 各补 if (net_ctx_is_owner_task() == 0U) 守卫,非 owner 返回 NET_ERR_INVAL。 用户提出的关键疑问「项目里本来就有时间模块,用现成的不行吗」的答案是: 功能确实已搬进时间模块,但不能复用 sys_clock_get()。三条硬理由—— 其一是单位,sys_clock_get() 内部整除 1000 返回 Unix 秒,而 104 退避常量 是毫秒级(TCP_SEND_RETRY_DELAY_MS = 10、TCP_ACCEPT_RETRY_DELAY_MS = 100), 拿秒比毫秒会把退避放大 1000 倍;其二是单调性,sys_clock_set() 第一句直接给 s_base_unix_secs 赋新值,SNTP 校时与 UI 改时都会调它,墙钟会跳变;其三是 语义,104 用 now_ms < at_ms 判退避是否到期,墙钟回拨会让重试长期不触发。 所以同一模块两个入口分工:sys_clock_get() 管墙钟 epoch 秒(可跳变,给日志 与文件时间戳),sys_clock_mono_ms() 管 64 位单调毫秒(只增不减,给定时器 与超时判定)。 测试:net_socket 677→683(新增 6 条守卫用例,删守卫变异必红)、 sys_clock 100→111(正常累加/回绕单调/不吞时间三类)、iec104_netmcu 13/13。 104 适配层改调 sys_clock_mono_ms 后,原先因旧函数被删而红的 netmcu runner 恢复全绿;host 侧新增 stub/sys_clock.h 替身(真头带 sd2506.h 依赖,主机编不了), 签名与真头逐字一致。 构建:0 Error(s), 0 Warning(s),Code 367584→367612(+28 B),RO/RW/ZI 全 0, IRAM1 90.3%(阈值 92%)。+0 增量是符号级真抵消——sys_clock.o 新增 s_prev_lo/s_hi 共 8 B,net_socket.o 删掉同名两个 static 共 8 B。 文档:两份网络文档里 38 处写死的源码行号全部改成「文件路径 + 函数名」锚点 (那些行号本来就已随重构失效),owner 条目数 5→4;sys_clock 设计文档 §5 对外 API 表补 sys_clock_mono_ms 行,新增 §5.1 写清「墙钟 vs 单调:测超时该用 哪个」,§1 里「业务逻辑中基于真实时间的判定(定时、超时、调度等)」这句 会教人拿墙钟测超时的表述改成「墙钟不用于计时」。 门禁:net-handle 488 文件 0 违规 + selftest 42 条断言。 --- App/protocol/iec104/iec104_net_mcu.c | 6 +- App/util/README.md | 1 + App/util/sys_clock.c | 25 ++++++++ App/util/sys_clock.h | 16 +++++ Drivers/BSP/NET/net_socket.c | 39 ++++-------- Drivers/BSP/NET/net_socket.h | 17 ++--- docs/内存管理/RAM使用分析与优化方案.md | 4 +- docs/内存管理/RAM预算台账.md | 6 +- docs/子系统设计/系统墙钟时间维护说明.md | 37 ++++++++++- docs/网络/IEC104_Net适配契约.md | 60 ++++++++++-------- docs/网络/Net层阻塞模型架构设计.md | 8 ++- scripts/ram_baseline.tsv | 2 +- scripts/size_attestation.json | 12 ++-- test/host/iec104_netmcu/MATRIX.md | 3 +- test/host/iec104_netmcu/net_socket_fake.c | 17 ++--- test/host/iec104_netmcu/results/report.json | 6 +- .../iec104_netmcu/results/static/report.json | 12 ++-- .../static_mutant/iec104_net_mcu_BAD.c | 33 ++++++++-- .../results/static_mutant/report.json | 12 ++-- .../results/static_mutant/selftest.txt | 4 +- test/host/iec104_netmcu/stub/sys_clock.h | 13 ++++ test/host/net_socket/net_socket_test.c | 63 +++++++++++++++++++ test/host/net_socket/ns_s3_msg.c | 16 ++++- test/host/sys_clock/sys_clock_test.c | 55 ++++++++++++++++ 24 files changed, 353 insertions(+), 114 deletions(-) create mode 100644 test/host/iec104_netmcu/stub/sys_clock.h diff --git a/App/protocol/iec104/iec104_net_mcu.c b/App/protocol/iec104/iec104_net_mcu.c index a33d237c..acf91ec3 100644 --- a/App/protocol/iec104/iec104_net_mcu.c +++ b/App/protocol/iec104/iec104_net_mcu.c @@ -39,6 +39,7 @@ */ #include "IEC104_Net.h" #include "net_socket.h" +#include "sys_clock.h" /* IEC104_Net_Now_Ms:通用 64 位单调毫秒(从 net 栈搬出) */ #include /* 映射表容量 = net 层 fd 数上限(NET_MAX_SOCKETS=8)。 */ @@ -659,7 +660,10 @@ IEC104_NetResult_t IEC104_Net_Close( uint64_t IEC104_Net_Now_Ms(void) { - return net_mono_now_ms(); + /* 单调时钟是纯读取,无 owner 概念:旧 net 栈版本的“非 owner 返 0 + + * NET_ERR_NOT_IN_NETTASK”语义已随函数搬到通用时钟模块并取消,本适配层 + * 不再做上下文保护(ABI 未要求)。 */ + return sys_clock_mono_ms(); } /* 函数功能:导出后端只读统计(当前只有接收字节数)。 diff --git a/App/util/README.md b/App/util/README.md index 8e16ff20..96b381c6 100644 --- a/App/util/README.md +++ b/App/util/README.md @@ -21,6 +21,7 @@ - 以 SD2506 RTC 为基准,HAL tick 计数补齐亚秒精度 - **49.7 天 tick 回绕防护**:每 30 天惰性再基准化(`sys_clock_get` 内部触发) +- **64 位单调毫秒**:`sys_clock_mono_ms()` 把 32 位 `HAL_GetTick()` 扩成跨 `0xFFFFFFFF` 不回退的 64 位单调时钟,临界区保护、任意任务上下文可调(**禁 ISR**),无网络层依赖;自 2026-11-18 起取代 net 栈上的旧 `net_mono_now_ms` - RTC 故障时降级到默认时间基准并返回 -1,触发"时钟芯片异常"自检上报 - 设计详见 `docs/子系统设计/系统墙钟时间维护说明.md` diff --git a/App/util/sys_clock.c b/App/util/sys_clock.c index 308b2cb2..84e6d540 100644 --- a/App/util/sys_clock.c +++ b/App/util/sys_clock.c @@ -487,3 +487,28 @@ int sys_clock_set_unix(uint32_t unix_secs) { /* 更新运行期基准并写回 RTC,实现掉电保持 */ return sys_clock_set(unix_secs, &sd); } + +/* + * 函数功能:64 位单调毫秒(32 位 HAL_GetTick 的宽扩展) + * 返回值:64 位单调毫秒 + * 限定条件:任意任务上下文可调用;**禁止中断上下文调用**(见 sys_clock.h) + * 函数说明:cur < s_prev_lo 即 32 位 tick 跨 0xFFFFFFFF 回绕,s_hi 加 1; + * 读-改-写整体由 taskENTER_CRITICAL/taskEXIT_CRITICAL 保护, + * 任意任务并发调用不会撕裂状态。回绕前提与 49.7 天保证见头注释。 + */ +uint64_t sys_clock_mono_ms(void) { + static uint32_t s_prev_lo; + static uint32_t s_hi; + uint32_t cur; + uint64_t ret; + + taskENTER_CRITICAL(); + cur = HAL_GetTick(); + if (cur < s_prev_lo) { + ++s_hi; + } + s_prev_lo = cur; + ret = (((uint64_t)s_hi) << 32) | (uint64_t)cur; + taskEXIT_CRITICAL(); + return ret; +} diff --git a/App/util/sys_clock.h b/App/util/sys_clock.h index 5874b0dd..6d0c52e0 100644 --- a/App/util/sys_clock.h +++ b/App/util/sys_clock.h @@ -40,6 +40,22 @@ int sys_clock_init(void); */ uint32_t sys_clock_get(void); +/* + * 函数功能:64 位单调毫秒(32 位 HAL_GetTick 的宽扩展) + * 入口参数:无 + * 返回值:64 位单调毫秒,跨 HAL_GetTick 的 0xFFFFFFFF -> 0 回绕不回退 + * 限定条件:**禁止在中断上下文调用**——内部用 taskENTER_CRITICAL() 保护 + * 读-改-写,该临界区 API 在 ISR 内不成立;任意任务上下文可安全调用。 + * 回绕前提:HAL_GetTick 是 32 位毫秒,回绕周期约 49.7 天;本函数靠"两次调用 + * 间隔不足一整圈"识别回绕(cur < s_prev_lo 即高位 +1),故调用方须 + * 保证至少每 49.7 天调用一次。本仓调用者是 netTask 的 1 ms 主循环 + * (104 tick),IWDG 兜底;若两次调用间隔真超过 49.7 天,那是 + * netTask 停摆,IWDG 早已复位,计时基线本就归零。 + * 函数说明:纯时间读取,不依赖任何网络/上下文身份;内部 static 状态由临界区 + * 整体保护,高低 32 位由同一次计算得出,不会撕裂。 + */ +uint64_t sys_clock_mono_ms(void); + /* * 函数功能:格式化系统墙钟时间为字符串 * 入口参数:buf - 输出缓冲区(至少 20 字节) diff --git a/Drivers/BSP/NET/net_socket.c b/Drivers/BSP/NET/net_socket.c index 32d60633..2a90c9ad 100644 --- a/Drivers/BSP/NET/net_socket.c +++ b/Drivers/BSP/NET/net_socket.c @@ -1368,6 +1368,12 @@ int net_listen(int sockfd) { * (FUN_PARA §5.52 ② 保留现场契约,TRAP-NET-20 三次定案) */ int net_accept_locked(int sockfd, struct net_sockaddr *addr, int *addrlen) { + /* owner 守卫:本函数第一句实质动作是 net_poll()(CH395F SPI 事务),非 owner + * 误调会与 netTask 抢总线(TRAP-NET-14)。与 net_pending_bytes / net_send_try + * 同口径:失败返回 -1 + NET_ERR_INVAL,不新造错误码。 */ + if (net_ctx_is_owner_task() == 0U) { + return NET_ERR_RETURN_1(NET_ERR_INVAL); + } /* 监听 Socket 控制块 */ net_sock_t *p_listen_sock; /* 取控制块(sockfd 已在上层校验范围) */ @@ -2175,6 +2181,12 @@ static int net_close_locked(net_sock_t *p_sock) { * 4. 挂起 recv 先结束(settle_close:排空尝试或取消,必通知) */ int net_drop_conn_locked(net_sock_t *p_sock) { + /* owner 守卫:本函数会拆会话、清挂起表并对监听型 fd 登记重建,非 owner 误调 + * 会破坏 netTask 串行语义(TRAP-NET-14 同族)。须在 APP_ASSERT 之前拦截: + * 断言只对测试构建有效,守卫才是真机上的机器表达。 */ + if (net_ctx_is_owner_task() == 0U) { + return NET_ERR_RETURN_1(NET_ERR_INVAL); + } /* S12 试点②(状态机不变量,规格 §2.1):函数头「限定条件:p_sock 在用且为 * TCP 流」+ 分派处的"非 ESTABLISHED/CONNECTING 视为幂等成功"这两条契约, * 在本函数体内**没有任何机器表达**,而函数体是无条件的:置 CLOSED、清 @@ -3591,30 +3603,3 @@ int net_send_try(net_sock_t *p_sock, const void *buf, int len, int *sent) } return NET_ERR_RETURN_1((err < 0) ? err : NET_ERR); } - -/* - * 函数功能:32 位 tick → 64 位单调毫秒(now_ms 由 netTask 每轮驱动) - * 返回值:64 位单调毫秒 - * 限定条件:**只能在 netTask 上下文调用** - * 函数说明:内部维护 static prev_lo + hi;cur < prev_lo 即回绕,hi 加 0x100000000。 - * 不漏回绕由 netTask 1 ms 主循环与 IWDG 复位共同保证,本函数不承诺在 - * 被永久搁置的上下文里不漏回绕;若两次调用间隔真超过 49.7 天,那是 - * netTask 停摆,IWDG 早已复位——此时进程已重新开始,计时基线本就归零。 - * 读取只在单 owner 内发生,prev_lo/hi 不需要原子快照;高低位由同一次 - * 计算得出,不会撕裂。 - */ -uint64_t net_mono_now_ms(void) -{ - static uint32_t s_prev_lo; - static uint32_t s_hi; - uint32_t cur; - if (net_ctx_is_owner_task() == 0U) { - return 0U; - } - cur = HAL_GetTick(); - if (cur < s_prev_lo) { - ++s_hi; - } - s_prev_lo = cur; - return (((uint64_t)s_hi) << 32) | (uint64_t)cur; -} diff --git a/Drivers/BSP/NET/net_socket.h b/Drivers/BSP/NET/net_socket.h index 8aad5f95..e457a326 100644 --- a/Drivers/BSP/NET/net_socket.h +++ b/Drivers/BSP/NET/net_socket.h @@ -768,8 +768,10 @@ int net_listen_locked(int sockfd); */ uint8_t net_ctx_is_owner_task(void); -/* task-18 割接:以下五个入口专供 netTask 内 IEC104 Net 后端使用。 - * 它们只去 static 或做 ≤10 行包装,不经过 netMsgQueue,绝不等待。 */ +/* owner-only 入口(netTask 上下文专用,任何 netTask 内消费者均可用): + * 这些函数不经过 netMsgQueue,调用即执行、绝不等待;非 owner 任务误调会与 + * netTask 抢同一根 CH395F SPI 总线(TRAP-NET-14),函数头已加机器守卫。 + * 共计四个入口,新增前须同步更新本行计数。 */ /* * 函数功能:丢弃一条 TCP 会话并释放其 Socket(owner-only,绝不关监听 fd) @@ -811,17 +813,6 @@ int net_pending_bytes(int sockfd); */ int net_send_try(net_sock_t *p_sock, const void *buf, int len, int *sent); -/* - * 函数功能:32 位 tick 扩展的 64 位单调毫秒(owner-only) - * 返回值:单调递增的 64 位毫秒计数(跨 32 位 tick 回绕不回退) - * 限定条件:**只能在 netTask 上下文调用**;由 netTask 每轮驱动, - * 不漏回绕由 1 ms 主循环与 IWDG 复位共同保证。 - * 函数说明:IEC104_Net Now_Ms 的唯一数据来源。库的超时判定依赖 64 位 - * 单调量,直接把 32 位 tick 强转成 64 位会在约 49.7 天回绕处 - * 让所有定时器一次性过期,故在此做高位进位扩展。 - */ -uint64_t net_mono_now_ms(void); - /* * 函数功能:发送数据(内部锁定版本,TCP 与 UDP 共用同一份分块实现) * 入口参数:p_sock - Socket 控制块指针 diff --git a/docs/内存管理/RAM使用分析与优化方案.md b/docs/内存管理/RAM使用分析与优化方案.md index 72dc2237..ed251aa9 100644 --- a/docs/内存管理/RAM使用分析与优化方案.md +++ b/docs/内存管理/RAM使用分析与优化方案.md @@ -47,10 +47,10 @@ dhara 失败类 +84;RO 另 +208,全是该失败类名表)→ `ER_IROM1` | 区域 | 用量 | 容量 | 占比 | |---|---|---|---| -| ER_IROM1 | 416,188 B (406.43 KB) | 1,048,576 B (1024 KB) | 39.7% | +| ER_IROM1 | 416,216 B (406.46 KB) | 1,048,576 B (1024 KB) | 39.7% | | RW_IRAM1 | 118,416 B (115.64 KB) | 131,072 B (128 KB) | 90.3% | | RW_CCM | 57,376 B (56.03 KB) | 65,280 B (64 KB) | 87.9% | -| **Flash (ROM 合计)** | **418,924 B (409.1 KB)** | 1,048,576 B (1024 KB) | **40.0%** | +| **Flash (ROM 合计)** | **418,952 B (409.1 KB)** | 1,048,576 B (1024 KB) | **40.0%** | 各区的容量与常量来源: diff --git a/docs/内存管理/RAM预算台账.md b/docs/内存管理/RAM预算台账.md index f1e39a9d..40e4d058 100644 --- a/docs/内存管理/RAM预算台账.md +++ b/docs/内存管理/RAM预算台账.md @@ -15,18 +15,18 @@ | 区域 | 用量 | 容量 | 占比 | 门禁(≤92%) | |---|---|---|---|---| -| ER_IROM1 (Flash) | 416,188 B | 1,048,576 B | 39.7% | 参考 | +| ER_IROM1 (Flash) | 416,216 B | 1,048,576 B | 39.7% | 参考 | | RW_CCM | 57,376 B | 65,280 B | 87.9% | PASS | | UNINIT_CCM | 48 B | 256 B | 18.8% | 参考 | | RW_IRAM1 | 118,416 B | 131,072 B | 90.3% | PASS | | 子系统(静态 RW+ZI;除 RTOS 堆在 CCM 外均在 SRAM1) | 现值 | 配额 | 状态 | |---|---|---|---| -| 网络 | 13,966 B | 12 KB | ⚠ 超 1.6 KB | +| 网络 | 13,958 B | 12 KB | ⚠ 超 1.6 KB | | 存储 | 9,144 B | 12 KB | OK | | UI | 36,791 B | 16 KB | ⚠ 超 19.9 KB | | RTOS 堆 | 57,376 B | 56 KB | 堆=配额 | -| 应用 | 47,699 B | 8 KB | ⚠ 超 38.6 KB | +| 应用 | 47,707 B | 8 KB | ⚠ 超 38.6 KB | | 其它 | 10,797 B | — | 参考 | diff --git a/docs/子系统设计/系统墙钟时间维护说明.md b/docs/子系统设计/系统墙钟时间维护说明.md index 2c5b5f51..fb0e8e40 100644 --- a/docs/子系统设计/系统墙钟时间维护说明.md +++ b/docs/子系统设计/系统墙钟时间维护说明.md @@ -13,9 +13,12 @@ - 日志/调试信息打时间戳; - 文件系统的文件创建/修改时间(FatFS 需要); -- 业务逻辑中基于真实时间的判定(定时、超时、调度等); - 对外接口(如 FTP `LIST` 返回的文件时间、SNTP/NTP 校时等)。 +**墙钟不用于计时。** 定时、超时、退避调度这类"过了多久"的判定必须用单调时钟 +`sys_clock_mono_ms()`(毫秒、只增不减),**不能用墙钟 `sys_clock_get()`**——后者会被 +校时跳变、且单位是秒。两类时间的选择依据见 §5.1。 + 本模块在 **SD2506 硬件 RTC(掉电保持)** 与 **HAL 系统节拍(运行期计时)** 之间做桥接: - 启动时从 SD2506 读取一次真实时间,换算为 Unix 时间戳,建立"墙钟基准"; @@ -108,6 +111,35 @@ static volatile uint32_t s_base_unix_secs = UINT32_MAX; /* 基准对应的 Unix | `uint32_t sys_clock_get(void)` | 获取当前 Unix 时间戳(秒) | 当前秒数;未初始化返回 `UINT32_MAX` | `sys_clock_init()` 已调用 | | `char *sys_clock_get_str(char *buf, size_t buf_size)` | 获取格式化字符串 `YYYY-MM-DD HH:MM:SS` | `buf` 指针;未初始化输出 `----/--/-- --:--:--` | `buf` 有效且 `buf_size ≥ 20` | | `int sys_clock_set(uint32_t unix_secs, const sd2506_time_t *sd_time)` | 更新基准,可写回 SD2506 | `0`(始终成功) | `unix_secs` 为合法时间戳 | +| `uint64_t sys_clock_mono_ms(void)` | 64 位单调毫秒(32 位 `HAL_GetTick()` 的宽扩展),跨 tick 回绕不回退;用于定时/超时/退避判定 | 64 位单调毫秒,跨回绕只增不减 | 任意任务上下文可调用;**禁止中断上下文**(内部 `taskENTER_CRITICAL()` 在 ISR 不成立);调用方须至少每 49.7 天调用一次 | + +> 表中 `sys_clock_mono_ms()` 的签名直接取自 `App/util/sys_clock.h` 的声明(表格内省略语句末尾分号, +> 与其余各行风格相同)。它于 2026-11-18 从网络层迁入本模块(原为 +> `Drivers/BSP/NET/net_socket.c` 的 `net_mono_now_ms`),现已不依赖任何网络接口。 + +### 5.1 墙钟 vs 单调:测超时该用哪个 + +**这一节回答"我要取时间时该用哪个入口"——先分清两类时间,选错会让超时判定静默失效。** +本模块提供两类时间,职责不重叠: + +| 时间类型 | 入口 | 单位与范围 | 会被校时跳变吗 | 该用于什么 | +|---|---|---|---|---| +| 墙钟(日历时间) | `sys_clock_get()` | Unix epoch **秒**,`uint32_t` | **会**——`sys_clock_set()` 直接改基准,SNTP 校时与 UI 改时都会调用它 | 日志/文件时间戳、日历显示、对外时间字段 | +| 单调时钟 | `sys_clock_mono_ms()` | **毫秒**,`uint64_t`,只增不减 | 不会——只基于 `HAL_GetTick()`,不读 RTC 基准 | 定时器、超时、退避调度等"过了多久"的判定 | + +**测超时、计间隔一律用 `sys_clock_mono_ms()`,不能用 `sys_clock_get()` 顶替。** 三条硬理由: + +1. **单位不对**:`sys_clock_get()` 内部整除 1000 返回秒;而 IEC 60870-5-104 的退避常量是毫秒级 + (`IEC104_TcpServer.c` 的 `TCP_SEND_RETRY_DELAY_MS` = 10、`TCP_ACCEPT_RETRY_DELAY_MS` = 100)。 + 拿秒去比较毫秒期限,会把退避放大 1000 倍。 +2. **会被校时跳变**:`sys_clock_get()` 的基准由 `sys_clock_set()` 直接赋值改写,调用方包括 + SNTP 校时(`App/sync/time_sntp.c`)与 UI 手工改时(`App/task/ui_task.c`)。校时回拨时墙钟倒退。 +3. **语义会被破坏**:104 的重试用 `now_ms < at_ms` 判退避是否到期 + (`IEC104_TcpServer.c` 的 `Send_Retry_Paused()` / `Accept_Retry_Paused()`)。若用可回拨的墙钟, + 回拨后 `now_ms` 长期小于 `at_ms`,**重试会长期不触发**;单调时钟只增不减就没这个问题。 + +> 单调时钟的回绕前提(两次调用间隔不足一圈、约 49.7 天)与禁止中断上下文的约束见上表与 +> `App/util/sys_clock.h` 的函数头注释。本仓调用者是 netTask 的 1 ms 主循环(104 tick),IWDG 兜底。 > `sys_clock_init()` 返回 `-1` 表示 RTC 芯片不可用:`RTC_DEFAULT_INIT_ENABLE=1` 时墙钟降级为编译期默认时间基准(日志时间戳仍有效),`app_main` 记录"时钟芯片异常"自检;禁用时墙钟保持"未初始化"(各取时接口返回无效哨兵)。`sys_clock_set()` 只更新基准(写回 RTC 尽力而为),恒返回 `0`。 @@ -267,7 +299,8 @@ sys_clock_init(); /* 再建立墙钟基准:所有后续日志即带正确时 char ts[24]; DBG_INFO("now: %s", sys_clock_get_str(ts, sizeof(ts))); -uint32_t now = sys_clock_get(); /* Unix 秒,可用于 FatFS 文件时间、超时判定等 */ +uint32_t now = sys_clock_get(); /* Unix 秒,用于 FatFS 文件时间等日历场景; + 测超时/计间隔请用 sys_clock_mono_ms(),见 §5.1 */ ``` --- diff --git a/docs/网络/IEC104_Net适配契约.md b/docs/网络/IEC104_Net适配契约.md index ca73721c..d9c837c6 100644 --- a/docs/网络/IEC104_Net适配契约.md +++ b/docs/网络/IEC104_Net适配契约.md @@ -9,8 +9,8 @@ 成熟库按 **Windows/Winsock 式的"独立 client fd"** 设计:监听 socket 与接入后的数据 socket 是两个不同句柄,因此 `Accept` 失败清理、以及"已有客户端时又来一个"的分支,一律 -`IEC104_Net_Close(client, NULL)`——`App/protocol/iec60870/104/IEC104_TcpServer.c` 里共 **7 处** -(约 1606 / 1611 / 1616 / 1628 / 1636 / 1652 / 1665 行)。在 Winsock 下这让两侧各自独立,语义自洽。 +`IEC104_Net_Close(client, NULL)`——`App/protocol/iec60870/104/IEC104_TcpServer.c` 的 `Accept_Clients()` 内共 **7 处** +(按源码顺序集中在同函数中)。在 Winsock 下这让两侧各自独立,语义自洽。 CH395F 是**单连接模型**:`net_accept()` 返回的是**监听 socket 自己**,接入瞬间同一个 fd 从 "监听"变成"数据通道"(见 `docs/网络/BSD_Socket_API_使用指南.md` §2.3 的 fd 模型对照表)。 @@ -47,9 +47,10 @@ LISTEN 分支还有一个顺序约束:若此时仍存在客户端槽,**先 ## 3. 双句柄模型:LISTEN 恒定,CLIENT 每次 Accept 新建 -库内 `server->listen_socket` 在 `IEC104_TcpServer.c` 里**只被赋值一次**(Listen 成功时,约 -2129 行),此后在 Accept、Wait、事件匹配等多处使用(约 1579 / 1782 / 1874 / 1983 行), -**整个监听生命周期内永不更新**。因此: +库内 `server->listen_socket` 在 `IEC104_TcpServer.c` 的 `IEC104_TcpServer_Init()` 里**只被赋值一次** +(Listen 成功时),此后在 `Accept_Clients()` / `Wait_For_Events()` / `Process_Events()` 等多处使用, +**整个监听生命周期内永不更新**;置无效只发生在 `Reset_Server()`、`IEC104_TcpServer_Init()` 的失败清理与 +`IEC104_TcpServer_Close()` 收尾。因此: - **LISTEN 槽**:`handle` 在监听生命周期内**不变**,`role` 恒为 `SLOT_LISTEN`。 **绝不翻转监听槽的 role**,否则库的 `Close(listen)` / `Wait(ACCEPT)` 会失联。 @@ -84,15 +85,24 @@ Listen 发的")。因此不能靠句柄内嵌校验,只能靠**值本身不 表容量等于 net 层 fd 上限(`NET_MAX_SOCKETS` = 8)。N6 是这条的反例自证:连续多次 listen/close 后旧 handle 必然查表失败。 -## 6. 编译期边界:5 个 MCU 专有接口模拟器看不到 +## 6. 编译期边界:4 个 owner-only 入口模拟器看不到 -后端需要的 5 个 owner 出口声明在 `net_socket.h` 的 `#ifndef NET_NO_OS` … `#endif` 段内 -(约 702–809 行):`net_drop_conn_locked`、`net_accept_locked`、`net_pending_bytes`、 -`net_send_try`、`net_mono_now_ms`。**模拟器定义 `NET_NO_OS`,因此看不到它们**—— +这一节回答"哪些 net 接口只有 MCU 能用、为什么模拟器必须走替身"——定位靠门控宏与函数名,不靠行号。 + +后端需要的 **4 个 owner-only 入口**声明在 `net_socket.h` 的 `#ifndef NET_NO_OS` … `#endif` 段内: +`net_drop_conn_locked` / `net_accept_locked` / `net_pending_bytes` / `net_send_try`。它们不经过 +`netMsgQueue`,在 netTask 上下文调用即执行、绝不等待。原先另有一个单调毫秒入口挂在 net 栈上, +现已从 net 栈删除并**迁出**:功能搬迁到 `App/util/sys_clock.h` 的 `sys_clock_mono_ms()`, +由 `App/protocol/iec104/iec104_net_mcu.c` 的 `IEC104_Net_Now_Ms()` 直接调用(纯读取、无 owner 保护)。 +**模拟器定义 `NET_NO_OS`,看不到这四个声明**—— 这也正是 `iec104_net_mcu.c` 只进 MCU 构建、模拟器由 `sim/iec104_sim.c` 提供同 ABI 替身的原因。 +**owner 约束已有机器表达(不再只是文档约定)**:`net_accept_locked` 与 `net_drop_conn_locked` +的函数体开头都先判 `net_ctx_is_owner_task()`,非 owner 立即返回 `NET_ERR_INVAL`(在任何 SPI 事务之前), +因此"必须在 netTask 上下文调用"由代码守卫而非注释保证。 + **已知一致性缺口**:头文件有 `NET_NO_OS` 门控,但 `net_socket.c` 里 `NET_NO_OS` 零命中—— -5 个实现**无条件编译**。当前不构成故障(模拟器不编 `net_socket.c`),但如果将来把 +4 个实现**无条件编译**。当前不构成故障(模拟器不编 `net_socket.c`),但如果将来把 `net_socket.c` 编进模拟器,会得到"实现存在但未声明"的孤儿符号:**链接不报错、 调用处静默走空**。改这一块之前必须先把这个不对称补齐。 @@ -111,24 +121,22 @@ listen/close 后旧 handle 必然查表失败。 --- -## 附:源码行号索引(以 2026-11-17 本工作树为准) +## 附:源码定位索引(按函数名,不写行号) -> `net_socket.c` / `net_socket.h` 的行号会随改动漂移(同一天已经漂过两次)。 -> **正文一律用函数名指代,行号只在此处集中登记**,引用时请重新 grep 核对。 +这一节回答"正文提到的符号在哪个文件的哪个函数里"——项目文档规范禁止写死源码行号, +定位一律用 `文件路径 + 函数名`;同一事实正文已有详述的,这里只给检索坐标。 -| 符号 / 事实 | 位置 | +| 符号 / 事实 | 定位(文件路径 + 函数名) | |---|---| -| `net_wait_result()` 定义 | `Drivers/BSP/NET/net_socket.c:930` | -| 其阻塞点 `xTaskNotifyWait(..., portMAX_DELAY)` | `net_socket.c:945`(`:939` 是零等待那一次,不是阻塞点) | -| 公开 `net_close` / `net_drop_conn`(无 owner 分支) | `net_socket.c:2515` / `:2574` | -| `net_close_locked`(static,非对外接口) | `net_socket.c:2098` | -| `net_drop_conn_locked`(owner 出口,拆会话保监听) | `net_socket.c:2174` | -| `net_close_sock`(owner 出口,关单个 socket) | `net_socket.c:3041` | -| `net_init` 内 `memset(s_net_socks, ...)` / `ch395f_reset()` | `net_socket.c:337` / `:351` | -| 5 个新声明所在的 `#ifndef NET_NO_OS` 段 | `net_socket.h:702` ~ `:809` | -| `net_drop_conn_locked` / `net_accept_locked` 声明 | `net_socket.h:769` / `:770` | -| `net_pending_bytes` / `net_send_try` / `net_mono_now_ms` 声明 | `net_socket.h:777` / `:785` / `:792` | +| `net_wait_result()` 两段等待(零等待拾取 + `xTaskNotifyWait` 阻塞) | `Drivers/BSP/NET/net_socket.c` 的 `net_wait_result()` | +| 公开 API 的 `osMessageQueuePut(..., osWaitForever)`(12 处) | 同文件 `net_bind()` / `net_listen()` / `net_accept()` / `net_connect()` / `net_send()` / `net_recv()` / `net_recv_to()` / `net_close()` / `net_drop_conn()` / `net_udp_set_peer()` / `net_udp_get_mode()` | +| `net_close_locked`(static,非对外接口)/ 对外版 | 同文件 `net_close_locked()` / `net_close()` | +| `net_drop_conn_locked`(owner 出口,拆会话保监听)/ 公开版 | 同文件 `net_drop_conn_locked()` / `net_drop_conn()` | +| `net_close_sock`(owner 出口,关单个 socket) | 同文件 `net_close_sock()` | +| `net_init` 里 `memset(s_net_socks, ...)` 与 `ch395f_reset()` | 同文件 `net_init()` | +| 4 个 owner-only 声明所在 `#ifndef NET_NO_OS` 段 | `Drivers/BSP/NET/net_socket.h` 的 `NET_NO_OS` 段(声明 `net_drop_conn_locked` / `net_accept_locked` / `net_pending_bytes` / `net_send_try`) | | 后端的 LISTEN / CLIENT 分流 | `App/protocol/iec104/iec104_net_mcu.c` 的 `IEC104_Net_Close()` | | 后端的 role 查表 | 同文件 `find_role()` / `slot_by_handle()` | -| 7 处 `IEC104_Net_Close(client, NULL)` | `App/protocol/iec60870/104/IEC104_TcpServer.c` 约 1606/1611/1616/1628/1636/1652/1665 | -| `server->listen_socket` 赋值点 | 同文件 `:2129`(Listen 成功)/ `:322`、`:2146`、`:3322`(置无效) | +| 单调毫秒时钟(已迁出 net 栈) | `App/util/sys_clock.h` 的 `sys_clock_mono_ms()`;调用方 `App/protocol/iec104/iec104_net_mcu.c` 的 `IEC104_Net_Now_Ms()` | +| 7 处 `IEC104_Net_Close(client, NULL)` | `App/protocol/iec60870/104/IEC104_TcpServer.c` 的 `Accept_Clients()` | +| `server->listen_socket` 赋值 / 置无效 | 同文件 `IEC104_TcpServer_Init()`(Listen 成功)/ `Reset_Server()` / `IEC104_TcpServer_Init()` 失败清理 / `IEC104_TcpServer_Close()` 收尾 | diff --git a/docs/网络/Net层阻塞模型架构设计.md b/docs/网络/Net层阻塞模型架构设计.md index 18b8e801..bbb4ca50 100644 --- a/docs/网络/Net层阻塞模型架构设计.md +++ b/docs/网络/Net层阻塞模型架构设计.md @@ -538,7 +538,13 @@ net_pending_capture_owner() ← 捕获执行者 - 清除掩码必须全 1(传 0 = 不清除,会残留上次结果被误读为本次结果); - **禁止在本路径加逐调用日志**——该路径每条 API 调用都过一遍,会淹没排查用的证据日志。 -**源码定位与 netTask 内调用边界**(板端割接实测,`Drivers/BSP/NET/net_socket.c`):`net_wait_result()` 定义在 `:930`,真正阻塞的是 `:945` 的 `xTaskNotifyWait(0xFFFFFFFFU, 0xFFFFFFFFU, &v, portMAX_DELAY)`;`:939` 的零等待那次是防丢通知的第一段,不是阻塞点。`net_send()` 本体的入队在 `:2289`(紧接 `:2297` 调 `net_wait_result("snd")`);全文件 `osMessageQueuePut(..., osWaitForever)` 共 12 处(`:1086` / `:1313` / `:1480` / `:1650` / `:2289` / `:2370` / `:2472` / `:2541` / `:2600` / `:2718` / `:2852` / `:2973`),即公开 `net_*` 入队一律无上界等待。公开版 `net_close`(`:2515`)、`net_drop_conn`(`:2574`)没有 owner 上下文分支,在 netTask 内调用就是等自己的回执而死锁;netTask 内要关单个 socket 用 `net_close_sock(net_sock_t *)`(`:3041`),要拆会话保留监听用 `net_drop_conn_locked(net_sock_t *)`(`:2174`)——不存在名为 `net_close_locked` 的对外接口,它只是 `net_close` 内部的 static 实现。本轮新增的 5 个声明 `net_drop_conn_locked`(`:769`)、`net_accept_locked`(`:770`)、`net_pending_bytes`(`:777`)、`net_send_try`(`:785`)、`net_mono_now_ms`(`:792`)都位于 `net_socket.h` 的 `:702` `#ifndef NET_NO_OS` … `:809` `#endif` 段内,模拟器(定义 `NET_NO_OS`)看不到它们。所以在 netTask 内写非阻塞代码时,凡 `net_*` 都要先问它内部是不是 `osWaitForever`。 +**源码定位与 netTask 内调用边界**(板端割接实测)。这一小节回答"在 netTask 内部写代码时哪些 `net_*` 能直接调、哪些会自等死锁"——判断依据是函数在什么层,不是记行号;下面所有定位都用 `文件路径 + 函数名`。 + +- **两段式等待**:`Drivers/BSP/NET/net_socket.c` 的 `net_wait_result()` 先做一次零等待拾取(防"入队 → 等待入口"间隙丢通知),第二段 `xTaskNotifyWait(0xFFFFFFFFU, 0xFFFFFFFFU, &v, portMAX_DELAY)` 才是真正阻塞点;两段不可互换,且判据必须用 `pdTRUE`/`pdFALSE`,不能判值 ≠ 0(`0 = EOF` 是合法通知)。 +- **公开 API 一律无上界入队**:同一文件 `osMessageQueuePut(..., osWaitForever)` 共 12 处,分布在 `net_bind()` / `net_listen()` / `net_accept()` / `net_connect()` / `net_send()` / `net_recv()` / `net_recv_to()` / `net_close()` / `net_drop_conn()`(两处)/ `net_udp_set_peer()` / `net_udp_get_mode()`。其中 `net_send()` 本体入队后紧接着调 `net_wait_result("snd")`。这些入口在 netTask 内调用就是等自己的回执而死锁。 +- **netTask 内该用什么**:关单个 socket 用 `net_close_sock(net_sock_t *)`;拆会话保留监听用 `net_drop_conn_locked(net_sock_t *)`;`net_close_locked` 只是 `net_close()` 内部的 static 实现,不存在同名对外接口。 +- **owner-only 入口(4 个,均在 `Drivers/BSP/NET/net_socket.h` 的 `#ifndef NET_NO_OS` … `#endif` 段内)**:`net_drop_conn_locked` / `net_accept_locked` / `net_pending_bytes` / `net_send_try`——不经过 `netMsgQueue`,调用即执行、绝不等待;模拟器定义 `NET_NO_OS`,看不到这些声明。原先另有一个单调毫秒入口挂在 net 栈上,现已从 net 栈删除并**迁出**:现由 `App/util/sys_clock.h` 的 `sys_clock_mono_ms()` 提供,不再是 net 栈声明面。 +- **owner 约束已有机器表达**:`net_accept_locked()` 与 `net_drop_conn_locked()` 的函数体开头都有 `if (net_ctx_is_owner_task() == 0U) { return NET_ERR_RETURN_1(NET_ERR_INVAL); }`,位于任何 SPI 事务之前。非 owner 任务误调立即拿到 `NET_ERR_INVAL`,不再只是文档里"必须在 netTask 上下文调用"的约定。 **13. 发送有界自旋**(`net_send_locked`):两个等待循环都在 `net_poll()` 之后判预算, **判定顺序不可交换**: diff --git a/scripts/ram_baseline.tsv b/scripts/ram_baseline.tsv index 8192cce9..763fc9c2 100644 --- a/scripts/ram_baseline.tsv +++ b/scripts/ram_baseline.tsv @@ -23,4 +23,4 @@ date code ro rw zi er_irom1 er_pct iram1 iram1_pct ccm ccm_pct top_rwzi 2026-11-11 256024 31760 2080 152368 287784 27.4 97024 74.0 57376 87.9 heap_4.o=57376;lv_mem_core_builtin.o=16384;nand_ftl.o=8288;lftpd.o=7884;ui_net_sink.o=6802;ui_port.o=6432;wave_ring.o=5332;sb_link.o=4376;ch395f.o=4162;console_log.o=4132 2026-11-13 256592 32036 2088 152584 288628 27.5 97248 74.2 57376 87.9 heap_4.o=57376;lv_mem_core_builtin.o=16384;nand_ftl.o=8288;lftpd.o=7884;ui_net_sink.o=6802;ui_port.o=6432;wave_ring.o=5332;sb_link.o=4376;ch395f.o=4162;console_log.o=4132 2026-11-15 256592 32036 2088 152584 288628 27.5 97248 74.2 57376 87.9 heap_4.o=57376;lv_mem_core_builtin.o=16384;nand_ftl.o=8288;lftpd.o=7884;ui_net_sink.o=6802;ui_port.o=6432;wave_ring.o=5332;sb_link.o=4376;ch395f.o=4162;console_log.o=4132 -2026-11-18 367584 48604 2736 173104 416188 39.7 118416 90.3 57376 87.9 heap_4.o=57376;lv_mem_core_builtin.o=16384;nand_ftl.o=8288;lftpd.o=7884;iec104_tcpserver.o=7656;ui_net_sink.o=6802;ui_port.o=6432;iec104_source.o=5944;wave_ring.o=5332;sb_link.o=4376 +2026-11-18 367612 48604 2736 173104 416216 39.7 118416 90.3 57376 87.9 heap_4.o=57376;lv_mem_core_builtin.o=16384;nand_ftl.o=8288;lftpd.o=7884;iec104_tcpserver.o=7656;ui_net_sink.o=6802;ui_port.o=6432;iec104_source.o=5944;wave_ring.o=5332;sb_link.o=4376 diff --git a/scripts/size_attestation.json b/scripts/size_attestation.json index d5326612..581dbdd2 100644 --- a/scripts/size_attestation.json +++ b/scripts/size_attestation.json @@ -1,15 +1,15 @@ { - "built_at": "2026-11-18T22:01:16+08:00", - "fingerprint": "27c4be92b1f2096a195e449cefdc615860a572f3ed2caca9bbdcfa60084d4ade", + "built_at": "2026-11-18T23:59:49+08:00", + "fingerprint": "c68db1ccfab1b1c09aec7c66a481cfd0dc80a827aab94f611c867e9b3c05bf91", "fingerprint_files": 1584, "fingerprint_source": "git-index", "gated_regions": [ "RW_IRAM1", "RW_CCM" ], - "git_head": "50ee1b44021c7cc291f70fcad1c73f3385e15dc6", + "git_head": "dda30d9897eb75be4540b5274a242cc6f8e8a21a", "map": "MDK-ARM/STM32F407-Demo/STM32F407-Demo.map", - "map_mtime": 1795010439, + "map_mtime": 1795017540, "pct": { "ER_IROM1": 39.69, "RW_CCM": 87.89, @@ -19,7 +19,7 @@ "regions": { "ER_IROM1": { "max": 1048576, - "size": 416188 + "size": 416216 }, "RW_CCM": { "max": 65280, @@ -37,7 +37,7 @@ "schema": 2, "scope_note": "\u540c\u7801\u51ed\u8bc1\uff1a\u6307\u7eb9\u8986\u76d6\u56fa\u4ef6\u4f53\u79ef\u76f8\u5173\u6e90\u7801\uff0c\u53e3\u5f84\u89c1\u672c\u811a\u672c docstring", "sizes": { - "code": 367584, + "code": 367612, "ro_data": 48604, "rw_data": 2736, "zi_data": 173104 diff --git a/test/host/iec104_netmcu/MATRIX.md b/test/host/iec104_netmcu/MATRIX.md index 5cf6b20d..3b621827 100644 --- a/test/host/iec104_netmcu/MATRIX.md +++ b/test/host/iec104_netmcu/MATRIX.md @@ -4,13 +4,14 @@ - **这组测试证明什么**:针对 `App/protocol/iec104/iec104_net_mcu.c`(被测 SHA256 `08ca22b9d61ec86181973ab97d7fab68ec8f0ecbf944bfd758e1546a80dc8b35`)的真实后端,在 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 台架)。最终实测:文本级静态 2/2、静态 checker 变异自测 `real_rc=0 mutant_rc=1`、动态 12/12(`real backend passed 12/12`)。 - **这组测试不证明什么**: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/protocol/iec104/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_mono_now_ms` / `net_accept_locked` / `net_drop_conn_locked` / `net_ctx_is_owner_task` 等),并受控注入单连接同 fd、短写 / WOULD_BLOCK / BUSY / RETRY_LATER、EOF / RST、网络代次变化、句柄非复用、芯片接收队列长度与 32 位 tick 回绕。绝不调用真实 CH395F 或 Windows socket。 +- 测试替身:`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。 diff --git a/test/host/iec104_netmcu/net_socket_fake.c b/test/host/iec104_netmcu/net_socket_fake.c index 41c82144..fc103455 100644 --- a/test/host/iec104_netmcu/net_socket_fake.c +++ b/test/host/iec104_netmcu/net_socket_fake.c @@ -3,6 +3,7 @@ * 只服务 test/host/iec104_netmcu/,不进产品构建。 */ #include "net_socket_fake.h" +#include "sys_clock.h" /* 声明本文件提供的 sys_clock_mono_ms 替身,签名漂移即编译期暴露 */ #include #include @@ -41,8 +42,10 @@ static fake_peer_t peers[FAKE_PEER_QUEUE]; static int peer_count; static uint32_t generation = 1; /* 注意:板端 tick 源已由 net-cutover 钉为 HAL_GetTick(),fake 直接受控。 - * N-2 口径:netTask 每轮调用 net_mono_now_ms() 采样一次 tick;这里模拟 - * 两次采样之间的累计,不把“不调用就不丢时间”塞进用例。 */ + * N-2 口径:通用时钟 sys_clock_mono_ms() 由 netTask 每轮采样一次 tick;这里模拟 + * 两次采样之间的累计,不把“不调用就不丢时间”塞进用例。函数体语义与生产 + * App/util/sys_clock.c 的 sys_clock_mono_ms 一致(32 位增量累加 + 跨 0xFFFFFFFF + * 自然回绕),但本 fake 无临界区(单线程宿主)、无 owner 概念。 */ static uint32_t tick_low; static int fake_errno; static uint8_t fake_owner = 1; @@ -493,14 +496,14 @@ int net_send_try(net_sock_t *p_sock, const void *buf, int len, int *sent) return rc; } -uint64_t net_mono_now_ms(void) +/* sys_clock_mono_ms 的测试替身:被测 iec104_net_mcu.c 通过 sys_clock.h 调它。 + * 语义对齐生产 App/util/sys_clock.c 的 sys_clock_mono_ms:32 位 HAL_GetTick + * 增量累加成 64 位单调量,跨 0xFFFFFFFF→0 由无符号减法自然回绕;纯读取, + * 不做 owner 校验(旧 net 栈时钟的 NET_ERR_NOT_IN_NETTASK 语义已搬迁取消)。 */ +uint64_t sys_clock_mono_ms(void) { uint32_t now = HAL_GetTick(); uint32_t delta; - if (fake_owner == 0U) { - net_set_errno(NET_ERR_NOT_IN_NETTASK); - return mono_ms; - } if (!mono_seeded) { mono_last = now; mono_seeded = 1; diff --git a/test/host/iec104_netmcu/results/report.json b/test/host/iec104_netmcu/results/report.json index bfeab168..ef4cbedc 100644 --- a/test/host/iec104_netmcu/results/report.json +++ b/test/host/iec104_netmcu/results/report.json @@ -1,10 +1,10 @@ { "scope": "REAL backend App/protocol/iec104/iec104_net_mcu.c + fake net layer; host-only isolation evidence, not full core/TcpServer/hardware", - "backend_sha256": "7b787ec910fad31da3ea530089c0ca817bdbd62203d9fa1ae8223da64185112a", + "backend_sha256": "888facdfc3516af8510337881b6d36ff57a16024574b6ebbea1ebdca9e0a2e8c", "sources": { - "MATRIX.md": "e8c913cac2a852173f052ce806a3da101a272e2a4dff8751499fdcf39788deab", + "MATRIX.md": "5a00446c12791b26b9c59ebd37aa7b33ae4451d88f8e17ef9545598540df5877", "net_socket_fake.h": "c7c712256b5ac4b5162fd445319296dd32ada4abc6efa0384e65e2635bba38c9", - "net_socket_fake.c": "3dbf75dcaf1d5159480a41c2783644bbf4892f102694de57f9816c1b9d402dd5", + "net_socket_fake.c": "f1eab03db48da3de3cd3e7211fb51eaba7068b45e377f42afd1468e49a7f247c", "netmcu_test.c": "09c203941c41fbb543580f45192c1604b984daaeb10135548756d4e42e8ebe02", "check_static.py": "8f08695a6c6bffec6047558b5b6d0aff0c7393665853357d1176f61b1aac1132" }, diff --git a/test/host/iec104_netmcu/results/static/report.json b/test/host/iec104_netmcu/results/static/report.json index 326fbb7b..1ca31db8 100644 --- a/test/host/iec104_netmcu/results/static/report.json +++ b/test/host/iec104_netmcu/results/static/report.json @@ -1,14 +1,14 @@ { - "source": "D:\\Code\\DTU Code\\STM32F4-Base\\.agents\\worktrees\\dsh-d2fd6422-281a\\App\\protocol\\iec104\\iec104_net_mcu.c", - "source_sha256": "4d6b8d9e8ed3404372f274d99c16bc87a06fecbee8db0b30b044b24d0562d73d", + "source": "D:\\Code\\DTU Code\\STM32F4-Base\\.agents\\worktrees\\dsh-204f318c-38b4\\App\\protocol\\iec104\\iec104_net_mcu.c", + "source_sha256": "888facdfc3516af8510337881b6d36ff57a16024574b6ebbea1ebdca9e0a2e8c", "checks": [ { "id": "S1", "description": "Close CLIENT/CLIENT_EOF branch contains no net_close_sock", "passed": true, "source_lines": [ - 615, - 621 + 634, + 640 ], "evidence": "{\n /* CLIENT 分支:只拆本客户端会话、清 CLIENT 槽,监听槽的 handle/fd/\n * net_gen/role 一概不动(库侧 listen_socket 是固定值,必须始终有效)。" }, @@ -17,8 +17,8 @@ "description": "Recv EOF branch only changes role; no close/drop call", "passed": true, "source_lines": [ - 435, - 441 + 454, + 460 ], "evidence": "{\n /* 只读 EOF 事实:槽角色保持 CLIENT_EOF,绝不置回 LISTEN——\n * 否则紧随其后的 Close 会落到 LISTEN 分支真关监听(不可逆事故)。 */\n slot->role = SLOT_CLIENT_EOF;\n out.result = IEC104_NET_EOF;\n return out;\n }" } diff --git a/test/host/iec104_netmcu/results/static_mutant/iec104_net_mcu_BAD.c b/test/host/iec104_netmcu/results/static_mutant/iec104_net_mcu_BAD.c index 6a00d34c..0eb9b5ef 100644 --- a/test/host/iec104_netmcu/results/static_mutant/iec104_net_mcu_BAD.c +++ b/test/host/iec104_netmcu/results/static_mutant/iec104_net_mcu_BAD.c @@ -39,6 +39,7 @@ */ #include "IEC104_Net.h" #include "net_socket.h" +#include "sys_clock.h" /* IEC104_Net_Now_Ms:通用 64 位单调毫秒(从 net 栈搬出) */ #include /* 映射表容量 = net 层 fd 数上限(NET_MAX_SOCKETS=8)。 */ @@ -53,12 +54,20 @@ typedef enum { typedef struct { uintptr_t handle; /* 0 = 空闲;非 0 单调,不复用 */ - int fd; /* net 层 fd,同 fd 模型下 LISTEN/CLIENT 相同 */ + int fd; /* net 层 fd(0 合法;失效值只认 NET_FD_INVALID) */ uint32_t net_gen; /* 成功 Listen 时的网络代次,跨代旧句柄一律失效 */ uint8_t role; /* slot_role_t */ } slot_t; -static slot_t s_slots[IEC104_MCU_MAP_SIZE]; +/* 槽位初值:fd 必须显式写成契约失效值,禁止依赖静态零初始化(0 是合法 fd)。 + * 条目数必须等于 IEC104_MCU_MAP_SIZE(8)。 */ +#define IEC104_SLOT_INIT { .handle = 0U, .fd = NET_FD_INVALID, \ + .net_gen = 0U, .role = SLOT_FREE } + +static slot_t s_slots[IEC104_MCU_MAP_SIZE] = { + IEC104_SLOT_INIT, IEC104_SLOT_INIT, IEC104_SLOT_INIT, IEC104_SLOT_INIT, + IEC104_SLOT_INIT, IEC104_SLOT_INIT, IEC104_SLOT_INIT, IEC104_SLOT_INIT, +}; static uintptr_t s_next_handle = 1U; static uint8_t s_inited; @@ -174,6 +183,7 @@ static void client_slot_drop(slot_t *slot) /* 代次自锁:跨代槽的 fd 号可能已被复用,绝不能对它做任何硬件读取/拆除。 */ if (slot->net_gen != net_get_generation()) { memset(slot, 0, sizeof(*slot)); + slot->fd = NET_FD_INVALID; return; } state = net_sock_state(slot->fd); @@ -185,6 +195,7 @@ static void client_slot_drop(slot_t *slot) } /* 只清客户端槽;监听槽的 handle/fd/net_gen/role 原地不动。 */ memset(slot, 0, sizeof(*slot)); + slot->fd = NET_FD_INVALID; } /* 函数功能:分配一个新句柄值(单调递增、永不复用),必要时先整表作废重启。 @@ -198,6 +209,9 @@ static uintptr_t handle_new(void) uintptr_t h = s_next_handle; if (h >= (uintptr_t)(UINTPTR_MAX - IEC104_MCU_MAP_SIZE)) { memset(s_slots, 0, sizeof(s_slots)); + for (uint32_t i = 0U; i < IEC104_MCU_MAP_SIZE; ++i) { + s_slots[i].fd = NET_FD_INVALID; + } h = 1U; } s_next_handle = h + 1U; @@ -214,6 +228,9 @@ IEC104_NetResult_t IEC104_Net_Init(int *native_error) * 这里只清后端映射表、不向任何旧 fd 发 net_close_sock——fd 号可能已被 * 复用,误关会打掉新会话。不变量见本文件头。 */ memset(s_slots, 0, sizeof(s_slots)); + for (uint32_t i = 0U; i < IEC104_MCU_MAP_SIZE; ++i) { + s_slots[i].fd = NET_FD_INVALID; + } s_next_handle = 1U; s_rx_bytes = 0U; s_inited = 1U; @@ -235,7 +252,8 @@ IEC104_NetResult_t IEC104_Net_Listen( const char *bind_address, uint16_t port, IEC104_NetSocket_t *listener, uint16_t *bound_port, int *native_error) { - int fd, rc, addrlen; + int fd = NET_FD_INVALID; + int rc, addrlen; uint32_t i; uint32_t ip; struct net_sockaddr_in addr; @@ -259,6 +277,7 @@ IEC104_NetResult_t IEC104_Net_Listen( for (i = 0U; i < IEC104_MCU_MAP_SIZE; ++i) { if (s_slots[i].handle != 0U && s_slots[i].net_gen != gen) { memset(&s_slots[i], 0, sizeof(s_slots[i])); + s_slots[i].fd = NET_FD_INVALID; } } } @@ -268,7 +287,7 @@ IEC104_NetResult_t IEC104_Net_Listen( return result(IEC104_NET_ERROR, NET_ERR_INVAL, native_error); } fd = net_socket(NET_AF_INET, NET_SOCK_STREAM); - if (fd < 0) { + if (fd == NET_FD_INVALID) { return result(IEC104_NET_ERROR, net_get_errno(), native_error); } memset(&addr, 0, sizeof(addr)); @@ -636,12 +655,16 @@ IEC104_NetResult_t IEC104_Net_Close( } } memset(slot, 0, sizeof(*slot)); + slot->fd = NET_FD_INVALID; return result(IEC104_NET_OK, 0, native_error); } uint64_t IEC104_Net_Now_Ms(void) { - return net_mono_now_ms(); + /* 单调时钟是纯读取,无 owner 概念:旧 net 栈版本的“非 owner 返 0 + + * NET_ERR_NOT_IN_NETTASK”语义已随函数搬到通用时钟模块并取消,本适配层 + * 不再做上下文保护(ABI 未要求)。 */ + return sys_clock_mono_ms(); } /* 函数功能:导出后端只读统计(当前只有接收字节数)。 diff --git a/test/host/iec104_netmcu/results/static_mutant/report.json b/test/host/iec104_netmcu/results/static_mutant/report.json index 26c22c6e..c7d53349 100644 --- a/test/host/iec104_netmcu/results/static_mutant/report.json +++ b/test/host/iec104_netmcu/results/static_mutant/report.json @@ -1,14 +1,14 @@ { - "source": "D:\\Code\\DTU Code\\STM32F4-Base\\.agents\\worktrees\\dsh-d2fd6422-281a\\test\\host\\iec104_netmcu\\results\\static_mutant\\iec104_net_mcu_BAD.c", - "source_sha256": "87bf283ec6b61ac14a0de3ab0f8a0352db4c62f03d4ea4479db36f9e0c546719", + "source": "D:\\Code\\DTU Code\\STM32F4-Base\\.agents\\worktrees\\dsh-204f318c-38b4\\test\\host\\iec104_netmcu\\results\\static_mutant\\iec104_net_mcu_BAD.c", + "source_sha256": "cef808625abe44cba7ddaedfe40be040762c2b1d5edb0d32d37fdad53bfe3901", "checks": [ { "id": "S1", "description": "Close CLIENT/CLIENT_EOF branch contains no net_close_sock", "passed": false, "source_lines": [ - 615, - 622 + 634, + 641 ], "evidence": "{\n /* CLIENT 分支:只拆本客户端会话、清 CLIENT 槽,监听槽的 handle/fd/\n * net_gen/role 一概不动(库侧 listen_socket 是固定值,必须始终有效)。" }, @@ -17,8 +17,8 @@ "description": "Recv EOF branch only changes role; no close/drop call", "passed": true, "source_lines": [ - 435, - 441 + 454, + 460 ], "evidence": "{\n /* 只读 EOF 事实:槽角色保持 CLIENT_EOF,绝不置回 LISTEN——\n * 否则紧随其后的 Close 会落到 LISTEN 分支真关监听(不可逆事故)。 */\n slot->role = SLOT_CLIENT_EOF;\n out.result = IEC104_NET_EOF;\n return out;\n }" } diff --git a/test/host/iec104_netmcu/results/static_mutant/selftest.txt b/test/host/iec104_netmcu/results/static_mutant/selftest.txt index 3a793c2d..8cb493a1 100644 --- a/test/host/iec104_netmcu/results/static_mutant/selftest.txt +++ b/test/host/iec104_netmcu/results/static_mutant/selftest.txt @@ -1,4 +1,4 @@ real_rc=0 mutant_rc=1 -real source: D:\Code\DTU Code\STM32F4-Base\.agents\worktrees\dsh-d2fd6422-281a\App\protocol\iec104\iec104_net_mcu.c -mutant: D:\Code\DTU Code\STM32F4-Base\.agents\worktrees\dsh-d2fd6422-281a\test\host\iec104_netmcu\results\static_mutant\iec104_net_mcu_BAD.c +real source: D:\Code\DTU Code\STM32F4-Base\.agents\worktrees\dsh-204f318c-38b4\App\protocol\iec104\iec104_net_mcu.c +mutant: D:\Code\DTU Code\STM32F4-Base\.agents\worktrees\dsh-204f318c-38b4\test\host\iec104_netmcu\results\static_mutant\iec104_net_mcu_BAD.c diff --git a/test/host/iec104_netmcu/stub/sys_clock.h b/test/host/iec104_netmcu/stub/sys_clock.h new file mode 100644 index 00000000..8810f30f --- /dev/null +++ b/test/host/iec104_netmcu/stub/sys_clock.h @@ -0,0 +1,13 @@ +/* 主机测试固件(test/host/iec104_netmcu):sys_clock.h 替身。 + * 生产 iec104_net_mcu.c 现在 include "sys_clock.h" 并调用 sys_clock_mono_ms(); + * 真实声明在 App/util/sys_clock.h(带 sd2506.h 依赖,主机套件用不到 RTC 面)。 + * 本替身只声明被测代码实际使用的那一个入口,实现由 net_socket_fake.c 提供, + * 按 N-2 采样口径模拟真实 sys_clock_mono_ms 的 32 位 tick 回绕扩展。 */ +#ifndef NETMCU_TEST_SYS_CLOCK_H +#define NETMCU_TEST_SYS_CLOCK_H + +#include + +uint64_t sys_clock_mono_ms(void); + +#endif /* NETMCU_TEST_SYS_CLOCK_H */ diff --git a/test/host/net_socket/net_socket_test.c b/test/host/net_socket/net_socket_test.c index b579d538..b756ef5a 100644 --- a/test/host/net_socket/net_socket_test.c +++ b/test/host/net_socket/net_socket_test.c @@ -703,6 +703,66 @@ static void tc_121_errno_slot_isr(void) reset_all(); } +/* TC-NETSOCK-130 owner-only 入口的机器守卫:net_accept_locked 的第一句就是 + * net_poll()(CH395F SPI 事务),net_drop_conn_locked 会拆会话并动挂起表/监听器。 + * 文档写"必须在 netTask 上下文"不构成机器表达,非 owner 误调会与 netTask 抢 + * SPI 总线(TRAP-NET-14)。两者都必须在函数头按 net_ctx_is_owner_task() 拒绝, + * 错误码沿用 net_pending_bytes / net_send_try 的 NET_ERR_INVAL,不新造码。 */ +static void tc_130_owner_guard_locked_entries(void) +{ + int fd; + int chip_log_base; + int settle_base; + int req_base; + + /* 非 owner accept:必须在进 net_poll 之前被拒 */ + bring_up_netctx(); + fd = mk_sock(NET_SOCK_STREAM, NET_SOCK_STATE_ESTABLISHED); + g_ns_cur_task = (TaskHandle_t)&g_ns_task_caller; + chip_log_base = g_chip.log_n; + CHECK(net_accept_locked(fd, NULL, NULL) < 0 && + net_get_errno() == NET_ERR_INVAL, + "TC-NETSOCK-130a non-owner net_accept_locked -> -1 plus INVAL"); + CHECK(s_net_socks[fd].state == NET_SOCK_STATE_ESTABLISHED && + g_peers.lost_probe_calls == 0 && g_chip.log_n == chip_log_base, + "TC-NETSOCK-130b rejected accept leaves state and chip untouched"); + + /* 非 owner drop:不得拆会话、不得碰挂起表、不得登记监听器重建 */ + bring_up_netctx(); + fd = mk_sock(NET_SOCK_STREAM, NET_SOCK_STATE_ESTABLISHED); + s_net_socks[fd].auto_relisten = 1U; + g_ns_cur_task = (TaskHandle_t)&g_ns_task_caller; + settle_base = g_peers.listener_settle_calls; + req_base = g_peers.listener_req_calls; + CHECK(net_drop_conn_locked(&s_net_socks[fd]) < 0 && + net_get_errno() == NET_ERR_INVAL, + "TC-NETSOCK-130c non-owner net_drop_conn_locked -> -1 plus INVAL"); + CHECK(s_net_socks[fd].state == NET_SOCK_STATE_ESTABLISHED && + g_peers.pending_settle_calls == 0 && + g_peers.send_cancel_calls == 0 && + g_peers.listener_settle_calls == settle_base && + g_peers.listener_req_calls == req_base, + "TC-NETSOCK-130d rejected drop leaves session, pending tables and listener alone"); + + /* owner 回归:原行为一字不改——accept 仍返回已建立会话 fd;drop 仍走 + * settle + REQ_DROP 登记并把会话收口 CLOSED。 */ + bring_up_netctx(); + fd = mk_sock(NET_SOCK_STREAM, NET_SOCK_STATE_ESTABLISHED); + CHECK(net_accept_locked(fd, NULL, NULL) == fd, + "TC-NETSOCK-130e owner net_accept_locked still returns the established session fd"); + + s_net_socks[fd].auto_relisten = 1U; + settle_base = g_peers.listener_settle_calls; + req_base = g_peers.listener_req_calls; + CHECK(net_drop_conn_locked(&s_net_socks[fd]) == 0 && + s_net_socks[fd].state == NET_SOCK_STATE_CLOSED && + g_peers.listener_settle_calls == settle_base + 1 && + g_peers.listener_req_calls == req_base + 1 && + g_peers.last_req_reason == NET_LISTENER_REQ_DROP, + "TC-NETSOCK-130f owner net_drop_conn_locked still settles and registers REQ_DROP"); + reset_all(); +} + /* ===================== 主入口 ===================== */ int main(void) @@ -726,6 +786,9 @@ int main(void) tc_120_errno_slot_per_task(); tc_121_errno_slot_isr(); + printf("[shard2b] owner-only entry guards\n"); + tc_130_owner_guard_locked_entries(); + printf("[shard3] cross-context messages and notify-value return\n"); ns_run_s3(); diff --git a/test/host/net_socket/ns_s3_msg.c b/test/host/net_socket/ns_s3_msg.c index ae38e8b8..f890c7a3 100644 --- a/test/host/net_socket/ns_s3_msg.c +++ b/test/host/net_socket/ns_s3_msg.c @@ -18,6 +18,18 @@ static int s_close_base_clear; static int s_close_base_settle; +/* 直接手投消息后跑分派:net_process_messages 在生产里只由 netTask 主循环调用, + * 假内核的阻塞等待路径(ns_rtos.c)会自动切到 netTask 身份,但这里手投后直接调 + * 分派必须自己切。owner-only 入口加了机器守卫后,漏切就会把正常路径测成 INVAL。 */ +static void dispatch_as_owner(void) +{ + TaskHandle_t save = g_ns_cur_task; + + g_ns_cur_task = (TaskHandle_t)&g_ns_task_net; + net_process_messages(); + g_ns_cur_task = save; +} + /* 造一条已建立的 TCP 会话(多数消息场景的前置) */ static int mk_established(int type) { @@ -488,7 +500,7 @@ static void tc_231_close_badfd(void) msg.sockfd = 5; msg.caller = (TaskHandle_t)&g_ns_task_caller; (void)ns_rtos_q_put_raw(&msg); - net_process_messages(); + dispatch_as_owner(); /* 生产里分派只在 netTask 内跑 */ CHECK(g_ns_notify_last_val == (uint32_t)NET_ERR_INVAL, "TC-NETSOCK-231c accept on an unused fd -> INVAL (control-block check, not fd range)"); reset_all(); @@ -546,7 +558,7 @@ static void tc_240_drop_conn_branches(void) msg.sockfd = fd; msg.caller = (TaskHandle_t)&g_ns_task_caller; (void)ns_rtos_q_put_raw(&msg); - net_process_messages(); + dispatch_as_owner(); /* 分派在生产里恒在 netTask 上下文 */ CHECK(g_peers.pending_settle_calls == 1 && g_peers.send_cancel_calls == 1, "TC-NETSOCK-240e both pending tables are ended before dropping the session (with notification)"); diff --git a/test/host/sys_clock/sys_clock_test.c b/test/host/sys_clock/sys_clock_test.c index 774a051d..47201f57 100644 --- a/test/host/sys_clock/sys_clock_test.c +++ b/test/host/sys_clock/sys_clock_test.c @@ -35,6 +35,9 @@ * TC-SYSCLK-017 set sd_time=NULL 不碰 RTC * TC-SYSCLK-018 set_unix 写回 RTC 且日历字段正确(含星期) * TC-SYSCLK-019 星期(Zeller)与已知日期对照穷举(跨世纪/闰/月末) + * TC-SYSCLK-030 mono_ms 正常累加:32 位 tick 直读扩展为 64 位 + * TC-SYSCLK-031 mono_ms 跨 0xFFFFFFFF 回绕单调不回退(回绕判据变异必红) + * TC-SYSCLK-032 mono_ms 连续调用不吞时间(无跳变、无重复扣除) * * 通过:全部 TC PASS(main 返回 0)。 * 入口:int main(void),返回 0=PASS / 1=FAIL(由 run 脚本判读)。 @@ -559,6 +562,55 @@ static void tc_019_week_known_dates(void) { } } +static void tc_030_mono_accumulate(void) { + uint64_t a, b; + + s_tick = 1000u; + a = sys_clock_mono_ms(); + CHECK_EQ_U32(a, 1000u, "mono: tick 1000 -> 1000 ms"); + + s_tick += 250u; + b = sys_clock_mono_ms(); + CHECK_EQ_U32(b, 1250u, "mono: tick +250 -> 1250 ms"); + CHECK(b > a, "mono: 正常累加单调增"); +} + +static void tc_031_mono_wrap_monotonic(void) { + uint64_t before, after; + + s_tick = 0xFFFFFFF0u; + before = sys_clock_mono_ms(); + CHECK(before >= 0xFFFFFFF0uLL, "mono: 回绕前读数接近 32 位上限"); + + s_tick += 32u; /* 0xFFFFFFF0 -> 0x00000010 */ + after = sys_clock_mono_ms(); + + CHECK(after > before, "mono: 跨 0xFFFFFFFF 回绕仍单调不回退"); + CHECK_EQ_U32((uint32_t)after, 16u, "mono: 回绕后低 32 位 = 16"); + { + uint64_t t0 = sys_clock_mono_ms(); /* cur == prev,正常态不得再加高位 */ + CHECK(t0 == after, "mono: 连续同值调用不得误判回绕加高位"); + } + CHECK(after == 0x100000010uLL, "mono: 回绕后 64 位累计值 = 0x100000010"); +} + +static void tc_032_mono_no_time_swallow(void) { + uint64_t t0, t1, t2, delta1, delta2; + + s_tick = 0xFFFFFFF0u; + t0 = sys_clock_mono_ms(); + s_tick += 16u; /* 0xFFFFFFF0 -> 0x00000000 */ + t1 = sys_clock_mono_ms(); + s_tick += 16u; /* 0x00000000 -> 0x00000010 */ + t2 = sys_clock_mono_ms(); + + delta1 = t1 - t0; + delta2 = t2 - t1; + CHECK_EQ_U32(delta1, 16u, "mono: 回绕段 +16 ms 不吞"); + CHECK_EQ_U32(delta2, 16u, "mono: 回绕后连续调用 +16 ms 不吞"); + CHECK(t2 - t0 == 32uLL, "mono: 两段合计 32 ms,无重复扣减"); +} + int main(void) { printf("=== System Clock host-side unit tests ===\n"); printf("Target: App/util/sys_clock.c (time conversion + wall-clock base)\n\n"); @@ -585,6 +637,9 @@ int main(void) { tc_017_set_no_rtc(); tc_018_set_unix_fields(); tc_019_week_known_dates(); + tc_030_mono_accumulate(); + tc_031_mono_wrap_monotonic(); + tc_032_mono_no_time_swallow(); printf("\n=== System Clock Tests: %d/%d PASSED (failed=%d) ===\n", s_passed, s_total, s_failed);