merge: 合入网络单调时钟归位与 owner-only 守卫(含 104 文档合并解冲突)
合入 dsh-204f318c-38b4 的 4 个提交:单调时钟搬回时间模块、owner-only 入口补 机器守卫、两份网络文档与 sys_clock 设计文档同步、以及角色文件的 TDD 纪律。 冲突共 10 个文件,分两类处理: 一、纯数字/机器快照 8 个(RAM 台账 2 篇、ram_baseline.tsv、size_attestation.json、 iec104_netmcu 的 4 个 results 产物):一律取 master 侧,随后在 master 用本轮权威 构建重新回填,不手工搬数字。这些文件的数值只在特定构建下有意义,跨树搬运必然 制造假账。 二、含真实语义的 2 个,逐块人工合并: - docs/网络/IEC104_Net适配契约.md:两侧各改了同一处。取 master 的目录路径 (App/iec60870/104/,master 已把 104 收编为自有代码)叠加本分支的内容改动 (行号锚点改函数名、net_mono_now_ms 迁出说明、owner 四入口)。同时修掉一处 本分支带入的旧路径 App/protocol/iec104/iec104_net_mcu.c。 - test/host/iec104_netmcu/MATRIX.md:同样取 master 路径 + 本分支的时钟替身说明。 合并后校验:net-handle 扫 495 个文件 0 违规、selftest 42 条断言 PASS; net_mono_now_ms 全仓 0 命中;sys_clock_mono_ms 声明在位;net_socket.c 四处 owner 守卫齐;104 适配层已改调通用时钟。
This commit is contained in:
@@ -221,6 +221,7 @@ spawn_teammate({
|
||||
- 角色文件修改后**不需要重启 DSH**,下次委派时自动读取最新版本
|
||||
- **在 worktree 里新增/改角色文件,persona 不会注入**(2026-11-18 实测):插件按 `spawn_teammate` 那一刻的**工作目录**向上找 `.git` 定项目根(`lib/roles.js` 的 `projectRootFor()`,标记只有 `.git`),而团队成员的角色查找用的是**主树** cwd(诊断日志 `role-inject-diag.log` 记 `role "x" not found (cwd=<主树>)` → `install FAILED`)。所以新增角色的验收顺序是:先在**主树** `.dsh/roles/` 放好文件 → 再起探针成员确认 persona 首行与工具白名单都对 → 最后才谈合并提交。反过来做(只在 worktree 建文件就 spawn)会得到一个「有角色名、无 persona、工具面全开」的成员,且失败只落 diag,调用方看不到任何报错。
|
||||
- 所有 12 个角色均为双层结构(第一部分通用知识体系 + 第二部分项目专项)
|
||||
- **测试驱动(TDD)纪律**:写代码/测试的角色(`algo` / `network` / `storage` / `ui` / `mcu` / `test-engineer`)铁律里都要求——**新增或修改功能先写对应的单元测试再写实现,至少同步进行,不许写完再补**;先写测试 = 先把"正确是什么"钉成可复跑判据,再由实现去满足。纯注释/命名/常量调整且不改行为者豁免。这条写在各角色文件里而非只在本文,是因为 teammate 只注入 `@role:<id>` 对应的那个角色文件(见上方 worktree 实测),总纲不进角色文件就等于没下发。
|
||||
|
||||
## `tools` 字段说明
|
||||
|
||||
|
||||
@@ -131,6 +131,8 @@ onToolCallBudget: wrap-up
|
||||
- **动手前必须知道的一条硬事实**:`rs485.c` 是全局 HAL UART 回调的**唯一实现处**(`HAL_UARTEx_RxEventCallback` / `HAL_UART_ErrorCallback` / `HAL_UART_TxCpltCallback` 三个),其中屏板链路(USART1,`sb_link_*`)也在同一组回调里转发。在别处再定义一份 = 链接期 multiple definition。开 RS-485 消费者时只能沿用这套转发结构,不许另起一套回调。
|
||||
- **权威落点**:`docs/产品需求/产品需求设计文档.md` §5.10(状态 / 重启门禁 / 三条约束 / 完成判据)、`docs/产品需求/产品需求设计文档.md` §9 的资产盘点行(17 项对下采集)、`docs/门禁说明/registration-check.md`(uvprojx 白名单缺口)、`docs/架构设计/项目启动顺序管理.md` §1.1 的 `rs485_task` 行。
|
||||
|
||||
10. **测试驱动(TDD):新增/修改算法或保护判据逻辑,先写对应的主机侧单测再写实现,至少同步进行**(不许写完再补)。先写测试 = 先把"正确是什么"钉成可复跑判据,再让实现去满足它——`test/host/` 已有对应套件(`adc_input`、`protection` 等)就把用例加进去,没有则先按 `test-engineer` 约定建骨架。纯注释/命名/常量值调整且不改行为者不在此列。
|
||||
|
||||
## 工作方式
|
||||
|
||||
- 接到任务后,先读相关模块的现有代码和设计文档(`docs/算法/采集与算法层设计说明.md`、`App/algo/README.md`),理解当前状态再动手。
|
||||
|
||||
@@ -138,6 +138,7 @@ BSP 层回答的问题是「让硬件动起来并如实汇报状态」,不回
|
||||
9. **HAL 时基是 TIM7 不是 SysTick**,`SysTick` 归 FreeRTOS;不要在 FreeRTOS 启动后改 SysTick。
|
||||
10. **只 Keil MDK-ARM (ARMCC, C99)**。不要用 GCC 特性(`__attribute__` 里的 ARMCC 不认的、`typeof` 等)。
|
||||
11. **任何代码修改后必须先 `/keil-build` 验证(0 错误 0 警告)**。烧录闭环用 `/serial-boot-test`。
|
||||
12. **测试驱动(TDD):新增/修改可脱离寄存器单测的纯逻辑(引脚译码、时序常量计算、位操作封装等),先写对应的主机侧单测再写实现,至少同步进行**(不许写完再补);能剥出纯逻辑的按 §3.3 先剥离再测。纯寄存器时序、CubeMX 生成或硬件回读类无法 host 复现的,先写板级验证步骤再改实现,以 `/keil-build` 0/0 与 `/serial-boot-test` 取证为准。无行为变化的注释/常量调整不在此列。
|
||||
|
||||
## 本项目的引脚与器件事实
|
||||
|
||||
|
||||
@@ -129,6 +129,8 @@ Wireshark/tcpdump 是必备工具。关注点:握手时序、重传率、窗
|
||||
8. **自研代码禁用 C 库堆分配**:只用 `pvPortMalloc/vPortFree`。
|
||||
9. **就绪屏障位必须 `osFlagsNoClear`**:`osEventFlagsWait` 默认消费所等位,`NET_READY` / `STORAGE_READY` 被先消费掉会导致后续消费者永久阻塞。
|
||||
|
||||
10. **测试驱动(TDD):新增/修改 net 协议逻辑或 socket 生命周期行为,先写对应的主机侧单测再写实现,至少同步进行**(不许写完再补)。`test/host/` 已有对应套件(`net_socket`、`net_listener`、`net_pending`、`sntp`、`lftpd` 等)就把用例加进去,没有则先按 `test-engineer` 约定建骨架。fd 失效值这类"假对象域与生产域是否一致"的坑,必须先让 fake 具备复现条件再写实现;无行为变化的注释/常量调整不在此列。
|
||||
|
||||
## 工作方式
|
||||
|
||||
- 接到任务后,先读 `docs/网络/网络自愈架构设计.md`(读清点审计 + 新增读清的三条准入判据见该篇 `docs/网络/网络自愈架构设计.md` §4.10)和 `docs/子系统设计/网络配置说明.md`。
|
||||
|
||||
@@ -163,6 +163,8 @@ Flash Translation Layer 负责三项核心任务:
|
||||
8. **自研代码禁用 C 库堆分配**:只用 `pvPortMalloc/vPortFree`。
|
||||
9. **破坏性测试默认关闭**:`ENABLE_DESTRUCTIVE_TESTS` 开启后跑一轮 GD5F 即让 dhara 多记一个坏块且持久化。开此开关须用户明确指示。
|
||||
|
||||
10. **测试驱动(TDD):新增/修改 FTL、FatFs 适配、日志或卷自愈逻辑,先写对应的主机侧单测再写实现,至少同步进行**(不许写完再补)。`test/host/` 已有对应套件(`fatfs`、`sys_log`、`nand_ftl` 等)就把用例加进去,没有则先按 `test-engineer` 约定建骨架;掉电/坏块类无法在 host 复现的,先写板级用例再改实现。无行为变化的注释/常量调整不在此列。
|
||||
|
||||
## 工作方式
|
||||
|
||||
- 接到任务后,先读 `docs/架构设计/STM32F4-Base存储架构说明.md`(含 §10.1 FatFs 标志位编号表与两条陷阱详解)。
|
||||
|
||||
@@ -124,6 +124,7 @@ ASIL-D要求故障注入测试验证安全机制有效性;软件单元之间
|
||||
6. **字符串字面量必须纯 ASCII**:中文只写注释。
|
||||
7. **自研代码禁用 C 库堆分配**:测试代码同样适用此规则(模拟器宿主 CRT 堆正常不代表板端安全)。
|
||||
8. **测试命名用语义短语**:不用字母+数字编号(如 TC-XXX-07),直接用描述性名称。
|
||||
9. **测试驱动(TDD)的守门人**:你是其他角色 TDD 纪律的落点——模块专家来加功能时,先与他确认对应用例已写(或同步写),再谈实现验收。**先写测试再实现是本仓铁律**:判据先立,实现才能被证明正确。你自己写测试工具/生成器时同样先写自测(如 `check_*.py --selftest` 的变异断言),确保门禁本身能抓到它要抓的缺陷。
|
||||
|
||||
## 工作方式
|
||||
|
||||
|
||||
@@ -140,6 +140,8 @@ LVGL Pro CLI 提供完整的 headless 测试链:`lvglpro generate` → `lvglpr
|
||||
8. **UI 改动回归按第三部分 ui-verify 手册跑 5 步门禁**(模拟器构建、菜单像素回归、内容页黄金参考、Keil 构建、代码规范)。
|
||||
9. **注释里写作用域别写星号形态**:`Drivers/BSP/UI/**` 里的 `/*` 会被 ARMCC 当第二次注释起点。写全目录或用尖括号 `<Drivers/BSP/UI/ui_x.c>`。
|
||||
|
||||
10. **测试驱动(TDD):新增/修改菜单树、页面行为或 UI 数据供给逻辑,先写对应回归用例再写实现,至少同步进行**(不许写完再补)。页面/像素变化先登记黄金参考(按第三部分 `ui-verify` 手册),纯逻辑先加 `test/host/` 对应用例;先钉住"正确长什么样/输出什么"再实现。无行为变化的注释/配色常量微调解耦于此列。
|
||||
|
||||
## 工作方式
|
||||
|
||||
- 接到任务后,先读 `docs/UI设计/UI_设计架构.md` 和 `docs/UI设计/LVGL模拟器部署与使用说明.md`。
|
||||
|
||||
@@ -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();
|
||||
}
|
||||
|
||||
/* 函数功能:导出后端只读统计(当前只有接收字节数)。
|
||||
|
||||
@@ -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`
|
||||
|
||||
|
||||
@@ -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;
|
||||
}
|
||||
|
||||
@@ -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 字节)
|
||||
|
||||
@@ -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;
|
||||
}
|
||||
|
||||
@@ -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 控制块指针
|
||||
|
||||
@@ -1,15 +1,7 @@
|
||||
* IEC104 协议,增加了很多 netsocket 函数,这些函数是必须要有的嘛?是通用的网络函数嘛?这些函数不能通过已经有的 netsocket 中的函数得到嘛?增加的函数别的地方也调用嘛?如果别的地方不用,为什么非要单独增加到公共的网络协议栈中呢?
|
||||
|
||||
* 对任务分工角色,增加 测试驱动的编程思想,要是增加内容,先写对应的单元测试代码,然后再实现。或者同时进行。
|
||||
|
||||
* 我觉得时间同步任务,IEC104协议任务,还有保护任务都可以放到同一个freeRTOS 线程中。这样可以节约内存。而且他们的任务放在一起也没有什么问题,这些都不是什么基础设施。
|
||||
|
||||
* 单元测试文件,我见增加了假netsocket,我们有好多网络测试,能不能统一出来大家共用的假网络测试底层,而不是每个模型创建各自的。
|
||||
|
||||
* 为了提交代码,IEC 进入了代码规划豁免,仔细查看豁免的内容,能不豁免的就不要豁免
|
||||
|
||||
* 板端 104 连不上的真因已钉死:App/sync/time_sntp.c 的静态 s_ctx.fd 零初始化是 0(不是 -1),而 s_socket_close() 判据是 if (s_ctx.fd >= 0)。如何系统性的解决这个问题,而不是遇见一个修一个。
|
||||
|
||||
* 把临时的探针,测试IEC104协议正确性的脚本都保存下来,有组织的进行存储和管理。下次可以重复利用测试。
|
||||
|
||||
* 确认 6 脚真实去向及 PC15 是否外接驱动(10 个物理位号已落地,其中 9 路对外可控 + KO_24V 继电器供电自动使能;口径见 `docs/硬件平台/开入开出实施说明.md` §2.1)
|
||||
|
||||
@@ -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
@@ -9,8 +9,8 @@
|
||||
|
||||
成熟库按 **Windows/Winsock 式的"独立 client fd"** 设计:监听 socket 与接入后的数据 socket
|
||||
是两个不同句柄,因此 `Accept` 失败清理、以及"已有客户端时又来一个"的分支,一律
|
||||
`IEC104_Net_Close(client, NULL)`——`App/iec60870/104/IEC104_TcpServer.c` 里共 **7 处**
|
||||
(约 1606 / 1611 / 1616 / 1628 / 1636 / 1652 / 1665 行)。在 Winsock 下这让两侧各自独立,语义自洽。
|
||||
`IEC104_Net_Close(client, NULL)`——`App/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/iec60870/104/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/iec60870/104/iec104_net_mcu.c` 的 `IEC104_Net_Close()` |
|
||||
| 后端的 role 查表 | 同文件 `find_role()` / `slot_by_handle()` |
|
||||
| 7 处 `IEC104_Net_Close(client, NULL)` | `App/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/iec60870/104/iec104_net_mcu.c` 的 `IEC104_Net_Now_Ms()` |
|
||||
| 7 处 `IEC104_Net_Close(client, NULL)` | `App/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()` 之后判预算,
|
||||
**判定顺序不可交换**:
|
||||
|
||||
@@ -4,13 +4,14 @@
|
||||
|
||||
- **这组测试证明什么**:针对 `App/iec60870/104/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/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_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。
|
||||
|
||||
@@ -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;
|
||||
|
||||
@@ -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();
|
||||
}
|
||||
|
||||
/* 函数功能:导出后端只读统计(当前只有接收字节数)。
|
||||
|
||||
@@ -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 */
|
||||
@@ -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();
|
||||
|
||||
|
||||
@@ -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)");
|
||||
|
||||
@@ -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);
|
||||
|
||||
Reference in New Issue
Block a user