refactor(net): 单调时钟搬回时间模块,owner-only 入口补机器守卫

起因: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 条断言。
This commit is contained in:
2026-11-19 00:38:09 +08:00
parent dda30d9897
commit 1f51e8fa2f
24 changed files with 353 additions and 114 deletions
+5 -1
View File
@@ -39,6 +39,7 @@
*/
#include "IEC104_Net.h"
#include "net_socket.h"
#include "sys_clock.h" /* IEC104_Net_Now_Ms:通用 64 位单调毫秒(从 net 栈搬出) */
#include <string.h>
/* 映射表容量 = 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();
}
/* 函数功能:导出后端只读统计(当前只有接收字节数)。
+1
View File
@@ -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`
+25
View File
@@ -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;
}
+16
View File
@@ -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 字节)
+12 -27
View File
@@ -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;
}
+4 -13
View File
@@ -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 控制块指针
@@ -47,10 +47,10 @@ dhara 失败类 +84;RO 另 +208,全是该失败类名表)→ `ER_IROM1`
<!-- MEM_SNAPSHOT:BEGIN generated by scripts/check_mem_numbers.py -->
| 区域 | 用量 | 容量 | 占比 |
|---|---|---|---|
| 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%** |
<!-- MEM_SNAPSHOT:END -->
各区的容量与常量来源:
+3 -3
View File
@@ -15,18 +15,18 @@
<!-- MEM_BUDGET:BEGIN generated by scripts/ram_baseline.py -->
| 区域 | 用量 | 容量 | 占比 | 门禁(≤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 | — | 参考 |
<!-- MEM_BUDGET:END -->
@@ -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 */
```
---
+34 -26
View File
@@ -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()` 收尾 |
@@ -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()` 之后判预算,
**判定顺序不可交换**:
+1 -1
View File
@@ -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
1 date code ro rw zi er_irom1 er_pct iram1 iram1_pct ccm ccm_pct top_rwzi
23 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
24 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
25 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
26 2026-11-18 367584 367612 48604 2736 173104 416188 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
+6 -6
View File
@@ -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
+2 -1
View File
@@ -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。
+10 -7
View File
@@ -3,6 +3,7 @@
* 只服务 test/host/iec104_netmcu/,不进产品构建。
*/
#include "net_socket_fake.h"
#include "sys_clock.h" /* 声明本文件提供的 sys_clock_mono_ms 替身,签名漂移即编译期暴露 */
#include <stdio.h>
#include <string.h>
@@ -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;
+3 -3
View File
@@ -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"
},
@@ -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 }"
}
@@ -39,6 +39,7 @@
*/
#include "IEC104_Net.h"
#include "net_socket.h"
#include "sys_clock.h" /* IEC104_Net_Now_Ms:通用 64 位单调毫秒(从 net 栈搬出) */
#include <string.h>
/* 映射表容量 = 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();
}
/* 函数功能:导出后端只读统计(当前只有接收字节数)。
@@ -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 }"
}
@@ -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
+13
View File
@@ -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 <stdint.h>
uint64_t sys_clock_mono_ms(void);
#endif /* NETMCU_TEST_SYS_CLOCK_H */
+63
View File
@@ -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();
+14 -2
View File
@@ -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)");
+55
View File
@@ -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);