test(NETCFG,CFG): P1①四个主机单测模块,并修 net_cfg 的 WAIT 契约与定长错记
按 docs/测试说明/主机单测覆盖率口径.md §9 的清单吃 P1 第①批「配置与工具」四块, 新增 4 个主机单测模块共 104 条断言,全部 MSVC 编译通过并 PASS: - test/host/net_cfg/(45 条):出厂默认可用、注册幂等与内容、load 报 -1 仍返回 0 (RAM 恒有效契约)、跨任务保存交接状态机 IDLE/WAIT/OK/FAIL、MAC 三态优先级、 IPv4 定长格式化。 - test/host/ftp_cfg/(16 条):[ftp] 段注册(**p_cb 必须为 NULL**,口令下次登录才 生效)、默认口令判定大小写不敏感、NULL 一律判不等(fail-closed)。 - test/host/prot_set_store/(16 条):blob 返回码分流 1 无档 / 0 成功 / **2 换代 (只打 INFO)** / -1 损坏;写盘失败必须回置脏标志(否则定值静默丢失)。 - test/host/task_prof/(27 条):无效样本闸门(防 DWT 复位把 max 抬到 2^32)、 未 enter 就 exit 不记账、首次 5s + 每 2s 节流、环形缓冲与裸发两通道、 周期→微秒换算随 SystemCoreClock 变。 覆盖率收益(已 --update-baseline 登记):套件 16 → 20 全绿;files_tested 19 → 23; 未触及 125 → 121 个文件(.c 47 → 43、9,657 → 9,228 行);分母 2,893 → 3,163 插桩 行;line=2811/3163(88.9%)、func=225/240(93.8%)。§9 的恒等式同步更新且仍咬合: 43 = 9(P1 剩) + 5(P2) + 29(P3)、9,228 = 2,188 + 2,226 + 4,814。 新单测照出并修掉两处真问题(都在 net_cfg,不是测试写错): 1. 实现违反自己的文档契约:net_cfg.h 明写"属主任务写盘中显示 WAIT",但 net_cfg_save_run 为了不丢新请求会先清 pending 再写盘 → 写盘那几百毫秒里 UI 保存行退回上一轮的 OK/IDLE(第一次保存按 ENTER 后屏幕上还是 ENTER),用户只 会再按一次。补 s_save_busy 标志,TC-NETCFG-028/026/030 钉死(含失败路径必须 清 busy,否则 UI 永久卡 WAIT)。 2. "定长 11 字符"是错的:%03u.%03u.%03u.%03u = 4 段×3 位 + 3 个点 = **15**。这个数 错了 4 处(net_cfg.h、net_cfg.c、网络配置说明.md 两处)——是我照抄它才撞上 FAIL,错在文档不是代码。已全部更正,并确认 len ≥ 16 的要求与 UI_BUF_STRLEN=32 本来就没问题(无截断风险)。 桩的口径(沿用既有模块,不另起一套):真实头优先——cfg_file.h / cfg_file_store.h / console_log.h / prot_set.h 全用真头(接口一漂移就编译期报错),只有 main.h 必须桩 (真实 main.h 拉整棵 HAL 头树,PC 上编不动;桩里字段名与位掩码宏名与 CMSIS 一致)。 prot_set_store 连真实 prot_set.c 一起编:blob 的编解码与脏标志在它里面,只有拿真 serialize 产出的 blob 才能造出"换代"与"损坏"两种真实形态,手搓等于测自己的桩。 配置引擎本身(解析/写盘/沉降)归 test/host/cfg_file 的 103 条,本批不重复测。 编号门禁:按 2026-10-21 批 3 的 B 层口径补建 4 族 TC-HOST-*(NETCFG 游标 056 / FTPCFG 014 / PROTSTOR 016 / TASKPROF 020,代码即属主登记处)。这一步不是走形式: 建族之前文档里引用 TC-NETCFG-028 被判「台账之外新账」直接卡提交,建族后才通过; 编号规范 §8.4 变更记录加一行说明族数 9 → 13。id_registry.json 只做增量插入(+88 行, 无重排)。 自查(提交时 pre-commit run --all-files,**仅 3 条失败且都与本分支改动无关**): - mem-numbers / mem-budget:本 worktree 因需验证代码改动而 @build 过,新生成的 .map 与 docs/内存管理 受管快照漂移。实测增量 ER_IROM1 +12 B、RW_IRAM1 +8 B、Flash +16 B、**CCM 0**,水位百分比全不变(改动 = 1 个静态字节 + 几条指令)。按并行分支 约定**不在分支里 --write**,台账由 Lead 合并后统一回填。 - ui-golden:simulator/tests/ref/*.bin 写在 .gitignore 里(黄金参考是本地生成物), 新建的 worktree 天生没有,报的是"缺黄金参考"而非像素差异;本分支零 UI 文件改动。 - 其余全部 Passed,含 @build 0 错误 0 警告、test-cppcheck(它抓到过我一条 p!=NULL 后又解引用的写法,已改为断言+显式守卫)、coding-standard、doc-links(35 处=存量)、 id-check --strict、mojibake 与 BOM/CR/U+FFFD/行尾逐项卫生。 - 自审修掉自己写的两条恒真断言(形如 x==0?1:1 的假绿)与一个重复编号标签。 - 4 个新模块**尚未挂 pre-commit 钩子**:.pre-commit-config.yaml 是单写文件,任务工作 树内不改;覆盖率脚本按 test/host/**/run_unit_test.py 自动发现,已实跑 20/20。 - 未跑 @test:改动仅 1 个静态字节 + UI 保存行的显示时序,无硬件语义变化。
This commit is contained in:
@@ -60,6 +60,7 @@ static uint8_t s_active_mac[6]; /* 芯片实际 MAC 影子(netTask 回写
|
||||
static uint8_t s_active_valid; /* 影子有效标志(0 = 尚未回写) */
|
||||
static net_cfg_apply_cb_t s_apply_cb; /* "立即应用"平台回调(未注册 = 空操作) */
|
||||
static volatile uint8_t s_save_pending; /* 1 = 有待执行保存请求(UI 投递/属主执行) */
|
||||
static volatile uint8_t s_save_busy; /* 1 = 属主任务正在写盘(维持 UI 的 WAIT 显示) */
|
||||
static volatile uint8_t s_save_result; /* 最近一次保存结果:0 = 无;1 = 成功;2 = 失败 */
|
||||
static net_cfg_save_req_cb_t s_save_req_cb; /* "保存请求"平台通知(未注册 = 空操作) */
|
||||
|
||||
@@ -234,7 +235,10 @@ int net_cfg_save_request(void) {
|
||||
* 函数说明:见 net_cfg.h 同名函数说明
|
||||
*/
|
||||
int net_cfg_save_state(void) {
|
||||
if (s_save_pending != 0u) {
|
||||
/* "请求已投递未执行"与"正在写盘"都显示 WAIT:pending 在写盘前就被清掉
|
||||
* (为了不让写盘期间的新请求丢失),单看它会在这几百毫秒里退回上一轮的
|
||||
* OK/IDLE —— 用户按了 ENTER 却看不到反馈,只会再按一次。busy 补上这一段。 */
|
||||
if ((s_save_pending != 0u) || (s_save_busy != 0u)) {
|
||||
return (int)NET_CFG_SAVE_ST_WAIT;
|
||||
}
|
||||
if (s_save_result == 1u) {
|
||||
@@ -252,8 +256,10 @@ int net_cfg_save_state(void) {
|
||||
* 返回值:0 - 无待处理请求或保存成功;-1 - 写盘失败 int
|
||||
* 限定条件:仅配置引擎属主任务上下文(MCU = defaultTask;模拟器 = 主循环)
|
||||
* 函数说明:先清"待保存"标志(写盘期间的新请求重位置位,下轮再执行,
|
||||
* 不丢失);写盘成功 → 置 OK 并触发"立即应用"(netTask 重建
|
||||
* 网络,无需重启);失败 → 置 FAIL,不触发应用(网络保持)
|
||||
* 不丢失),同时置"写盘中"标志让 UI 在这段窗口里仍显示 WAIT
|
||||
* (否则退回上一轮结果,见 net_cfg_save_state);写盘成功 → 置 OK
|
||||
* 并触发"立即应用"(netTask 重建网络,无需重启);失败 → 置 FAIL,
|
||||
* 不触发应用(网络保持)。两条路径都会清"写盘中"标志
|
||||
*/
|
||||
int net_cfg_save_run(void) {
|
||||
int r;
|
||||
@@ -262,8 +268,11 @@ int net_cfg_save_run(void) {
|
||||
return 0; /* 无待处理请求(空醒/周期轮询) */
|
||||
}
|
||||
s_save_pending = 0u;
|
||||
s_save_busy = 1u; /* 写盘期间维持 WAIT(见 net_cfg_save_state 注释) */
|
||||
|
||||
r = net_cfg_save();
|
||||
|
||||
s_save_busy = 0u;
|
||||
if (r == 0) {
|
||||
s_save_result = 1u;
|
||||
net_cfg_request_apply();
|
||||
@@ -352,7 +361,8 @@ void net_cfg_get_mac(uint8_t *p_out) {
|
||||
* len - 缓冲长度 size_t
|
||||
* 返回值:无
|
||||
* 限定条件:p_ip/p_buf 非空;len ≥ 16
|
||||
* 函数说明:"192.168.001.100"(定长 11 字符,UI 编辑光标按固定偏移定位字节)
|
||||
* 函数说明:"192.168.001.100"(定长 **15** 字符 = 4 段 × 3 位 + 3 个点,UI 编辑
|
||||
* 光标按固定偏移定位字节:段 i 起点 4i、点号在 3/7/11)
|
||||
*/
|
||||
void net_cfg_fmt_ipv4(const uint8_t *p_ip, char *p_buf, size_t len) {
|
||||
if (p_ip == NULL || p_buf == NULL || len == 0u) {
|
||||
|
||||
@@ -204,7 +204,7 @@ void net_cfg_get_mac(uint8_t *p_out);
|
||||
* p_buf - 输出缓冲(不可为 NULL) char *
|
||||
* len - 缓冲长度 size_t
|
||||
* 返回值:无
|
||||
* 限定条件:p_ip/p_buf 非空;len ≥ 16(输出 11 字符 + '\0')
|
||||
* 限定条件:p_ip/p_buf 非空;len ≥ 16(输出 15 字符 + '\0')
|
||||
* 函数说明:"192.168.001.100"——每段 3 位补零使字符串定长,UI 编辑光标
|
||||
* 可按固定偏移(4i/3i 起始)定位字节;net_init 的 parse_ip_string
|
||||
* 对前导零兼容(十进制逐段解析)
|
||||
|
||||
Reference in New Issue
Block a user