feat(sntp): 板端 SNTP 校时接入——coreSNTP 序列化器 + [sntp] 段 + 设置页(#73)
CI / 静态门禁 (pre-commit) (push) Failing after 5m1s
CI / 主机侧单测 (MSVC) (push) Successful in 42s
CI / 静态门禁 (pre-commit) (pull_request) Has been cancelled
CI / 主机侧单测 (MSVC) (pull_request) Has been cancelled

- vendored coreSNTP v2.0.0 序列化器(MIT,仅 serializer+LICENSE,零堆),
  48 字节报文编解码在库,节奏与准入判据在本方(RFC 4330 §10 调研口径)
- App/sync/time_sntp.c 挂 timeSyncTask 的 8888 事件循环,等待切片 ≤50 ms,
  不饿任务狗与 IWDG;懒建 UDP socket,代际变化/禁用/死错误码即关闭归还
- 防伪 = OriginTimestamp 逐位等于发出时 T1(含低 16 位随机小数位);
  mode/stratum/闰秒指示/KoD 按 RFC 拒收;DENY·RSTR 换服务器、RATE 只退避
- 主备轮换 + 失败指数退避(5 s 起、60 s 封顶)+ 首轮 1~5 分钟随机错峰;
  成功恢复 poll_min 周期(1~1440 分,出厂默认 60,默认不启用不发包)
- 钟面 = 本地时间:UTC+8 固定偏移落 sys_clock_set_unix(§1.1 时基裁定,
  第三个写入口,装置仍不存时区);|offset|<2 s 只记日志不步进,冷启动或
  更大偏差步进并回写 SD2506,留痕 [SNTP] step 与 syslog OPER
- 首个校验通过的同步置 SYS_EVT_TIMESYNC_READY(就绪位,消费方按需 NoClear)
- [sntp] 配置段(enable/server1/server2/poll_min)属主 sntp_cfg.c,
  注册在 net_cfg_load();UI 页 31「SNTP 设置」(密码叶):启用开关 +
  主/备服务器 octet 编辑 + 周期(分) + 保存,复用 net_cfg_save_request 链
- 测试与门禁:test/host/sntp 新套件(报文/防伪/KoD/退避周期/阶跃域/配置
  注册表)、net_cfg 与 time_sync 套件补 fake、黄金参考 66→74 张零漂移、
  字符集 228 字、Keil 0 错 0 警(RO +5,848 B 含字体)、覆盖率基线回填
- 文档:墙钟维护说明 §16、网络配置说明 [sntp] 节、配置文件设计说明变更记录、
  产品需求 FR-TIME-3 与 8.3/9.1.2 台账、UI 补齐规划/UI补齐 31 叶口径、
  登记簿销项并登记「SNTP 校时真机判据」等台架(PC 时间源 192.168.31.161/.13)
This commit is contained in:
2026-11-04 15:27:41 +08:00
parent c1beec50e7
commit 10322208fd
73 changed files with 4695 additions and 281 deletions
+43 -5
View File
@@ -16,6 +16,11 @@
* 口令判定归 test/host/ftp_cfg/ 模块,两边不重复也不互相顶包。
* (不能把 ftp_cfg.c 也 include 进来:两个 .c 都有 static s_cfg,
* 同一个 TU 里直接重定义。)
* - [sntp] 段:描述符由 net_cfg.c 的 s_sntp_register() 组装(分层
* 门禁后 sntp_cfg.c 不再自注册),所以本测试直接**编译真实的
* sntp_cfg.c 数据本体**(纯 stdint/string,无引擎依赖,改名后的
* s_sntp_cfg 与 net_cfg.c 的 s_cfg 不再同名冲突),并用假引擎
* 截获注册内容——段键表/偏移/默认值的机器钉在这里打。
* ⚠ 引擎的解析/写盘/沉降契约已由 test/host/cfg_file/(103 条)覆盖,
* 本模块刻意不重测引擎,只测 net_cfg.c 这一层的编排与交接。
*
@@ -37,8 +42,10 @@
* TC-NETCFG-003 未 load 时 gw = 192.168.31.1
* TC-NETCFG-004 未 load 时 mac = 全零(哨兵 = 不覆盖芯片内置 MAC)
* —— 注册与 load(TC-NETCFG-005..011)——
* TC-NETCFG-005 首次 load 注册 [network] 段恰好一次(且 load 返回 0)
* TC-NETCFG-005 首次 load 注册 [network]+[sntp] 各恰好一次(且 load 返回 0)
* TC-NETCFG-006 首次 load 一并注册 [ftp] 段(FTP 鉴权:所有受管段先注册、后 load)
* TC-NETCFG-006b [sntp] 描述符内容:段名/键表(enable/server1/server2/poll_min
* 偏移 0/1/5/10 长 1/4/4/2)/默认值(关 + 60 分钟)/无变更回调
* TC-NETCFG-007 重复 load 不重复注册(幂等;否则引擎按"段名重复"拒登 → 静默失配)
* TC-NETCFG-008 注册描述符内容:段名/尺寸/键数/默认值指针/变更回调/数据指针 = RAM 副本
* TC-NETCFG-009 load 成功:返回 0 且留一条 INFO、不误报 ERROR
@@ -100,8 +107,10 @@
/* 真实引擎头(接口原汁)+ 被测生产源(原样纳入);dbg_log.h 命中本目录 stub */
#include "cfg_file.h"
#include "net_cfg.h"
#include "sntp_cfg.h"
#include "net_cfg.c"
#include "sntp_cfg.c"
/* ===================== 断言框架 ===================== */
@@ -137,6 +146,7 @@ typedef struct {
const void *p_defaults;
size_t data_size;
uint8_t key_count;
const cfg_key_def_t *p_keys; /* 键表是生产文件里的 static const,指针长期有效,不必深拷贝 */
void (*p_cb)(void);
} fake_reg_t;
@@ -179,6 +189,7 @@ int cfg_file_register(const cfg_section_reg_t *p_reg)
rec->p_defaults = p_reg->p_defaults;
rec->data_size = p_reg->data_size;
rec->key_count = p_reg->key_count;
rec->p_keys = p_reg->p_keys;
rec->p_cb = p_reg->p_cb;
g_reg_n++;
return 0;
@@ -278,14 +289,41 @@ static void tc_register_load(void)
printf("-- TC-NETCFG-005..011 register + load --\n");
fake_reset();
rc = net_cfg_load();
CHECK((rc == 0) && (g_reg_n == 1) && (strcmp(g_regs[0].name, "network") == 0),
"TC-NETCFG-005 first load registers [network] exactly once");
CHECK((rc == 0) && (g_reg_n == 2) && (strcmp(g_regs[0].name, "network") == 0),
"TC-NETCFG-005 first load registers [network] + [sntp] exactly once each");
CHECK((g_ftp_reg_calls == 1) && (g_load_calls == 1),
"TC-NETCFG-006 also registers [ftp], registered before load");
{
const fake_reg_t *rs = (g_reg_n == 2) ? &g_regs[1] : NULL;
const sntp_cfg_t *d = (const sntp_cfg_t *)(rs != NULL ? rs->p_defaults : NULL);
int keys_ok = (rs != NULL) && (rs->key_count == 4u) && (rs->p_keys != NULL);
CHECK((rs != NULL) && (strcmp(rs->name, "sntp") == 0) && keys_ok &&
(rs->data_size == sizeof(sntp_cfg_t)) &&
(rs->p_data == (const void *)sntp_cfg_data()) &&
(rs->p_cb == NULL),
"TC-NETCFG-006b [sntp] descriptor: name/4 keys/size/RAM copy/no cb");
CHECK(keys_ok &&
(strcmp(rs->p_keys[0].name, "enable") == 0) &&
(rs->p_keys[0].type == CFG_VAL_UINT) &&
(rs->p_keys[0].offset == 0u) && (rs->p_keys[0].len == 1u) &&
(strcmp(rs->p_keys[1].name, "server1") == 0) &&
(rs->p_keys[1].type == CFG_VAL_IP4) &&
(rs->p_keys[1].offset == 1u) && (rs->p_keys[1].len == 4u) &&
(strcmp(rs->p_keys[2].name, "server2") == 0) &&
(rs->p_keys[2].type == CFG_VAL_IP4) &&
(rs->p_keys[2].offset == 5u) && (rs->p_keys[2].len == 4u) &&
(strcmp(rs->p_keys[3].name, "poll_min") == 0) &&
(rs->p_keys[3].type == CFG_VAL_UINT) &&
(rs->p_keys[3].offset == 10u) && (rs->p_keys[3].len == 2u),
"TC-NETCFG-006c [sntp] key table: enable/server1/server2/poll_min at 0/1/5/10");
CHECK((d != NULL) && (d->enable == 0u) && (d->poll_min == 60u) &&
(d->server_pri[0] == 0u) && (d->server_bak[0] == 0u),
"TC-NETCFG-006d [sntp] factory defaults: off + empty servers + 60 min");
}
rc = net_cfg_load();
CHECK((rc == 0) && (g_reg_n == 1) && (g_ftp_reg_calls == 2),
"TC-NETCFG-007 repeated load does not re-register [network]");
CHECK((rc == 0) && (g_reg_n == 2) && (g_ftp_reg_calls == 2),
"TC-NETCFG-007 repeated load does not re-register [network]/[sntp]");
CHECK((strcmp(g_regs[0].name, "network") == 0) &&
(g_regs[0].data_size == sizeof(net_cfg_t)) &&
+3
View File
@@ -21,6 +21,9 @@
桩的边界(细节见测试单元文件头):
配置文件引擎用**真实头**(接口原汁)+ 测试单元内的可控实现;[ftp] 段的
ftp_cfg_register 只计数——它归 test/host/ftp_cfg/ 模块,两边不互相顶包。
sntp_cfg.c 是分层门禁后的纯数据本体,随 net_cfg.c 一并编译入 TU,
[sntp] 段描述符(键表/偏移/工厂默认)由假引擎截获断言——段注册契约
的机器钉在本模块(TC-NETCFG-005/006b..d/007)。
用法(仓库根目录):
python test/host/net_cfg/run_unit_test.py