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:
@@ -0,0 +1,355 @@
|
||||
/*
|
||||
* 模块名称:保护定值持久化胶水层(prot_set_store)主机侧单元测试
|
||||
* 模块功能:在 PC 上离线验证 Drivers/... 侧的平台胶水 App/cfg/prot_set_store.c 的
|
||||
* **返回码分流**与**脏标志回置**:读不到=1(按无档处理)、装载成功=0、
|
||||
* 版本/项数换代=2 且只打 INFO、magic 或校验被破坏=-1;保存无脏不写盘、
|
||||
* 写失败必须把脏标志还回去(否则一轮卷忙就永久丢定值)。
|
||||
*
|
||||
* 被测对象:真实源文件 ../../../App/cfg/prot_set_store.c,并且**同时纳入真实的**
|
||||
* ../../../App/cfg/prot_set.c —— 因为 blob 的 serialize/parse/脏标志都在
|
||||
* prot_set.c 里(纯逻辑,已另有 test/host/prot_set/ 覆盖其算法)。本模块
|
||||
* 不重测算法,只测"胶水层在真实 blob 上把返回码分对没有":只有拿真
|
||||
* serialize 产出的 blob 去改 magic/ver/cnt/校验,才能构造出"换代"与
|
||||
* "损坏"这两种真实形态;自己手搓 blob 会把测试写成对自己的桩。
|
||||
* 平台后端 cfg_store_read / cfg_store_write_atomic 用**真实头**
|
||||
* App/cfg/cfg_file_store.h(接口原汁)+ 本文件的可控实现。
|
||||
*
|
||||
* 为什么要主机侧单测(而不是只靠台架):
|
||||
* 1. **换代与损坏必须分开**(B8 定值表 32→40 项时定下的契约):magic 完好但
|
||||
* ver/cnt 与当前固件不符是**预期的升级路径**,归 2 并打 INFO;把它当损坏(-1)
|
||||
* 会让设备在正常升级后报 ERROR + 自检留痕,现场查成一个根本不存在的故障。
|
||||
* 2. 读失败与"文件不存在"同归 1 是**安全侧**选择(启动期卷锁本任务独占,
|
||||
* try-lock 失败即真 I/O 故障,此时保持出厂默认比拿半截数据更安全)——钉住它,
|
||||
* 防止将来有人"优化"成把读失败也当损坏重刷。
|
||||
* 3. 写失败必须回置脏:定值经 iec104Task 下发,落盘在 defaultTask;一轮卷忙就把
|
||||
* 脏标志吞掉,表现为"改了定值、重启又变回旧的",而且没有任何错误提示。
|
||||
*
|
||||
* 覆盖点:
|
||||
* —— load 返回码分流(TC-PROTSTOR-001..008)——
|
||||
* TC-PROTSTOR-001 后端读失败 → 1(按"无档"处理,保持出厂默认)
|
||||
* TC-PROTSTOR-002 有效 blob → 0,且装载后定值生效
|
||||
* TC-PROTSTOR-003 **ver 换代 → 2**(不是 -1)
|
||||
* TC-PROTSTOR-004 ver 换代只打 **INFO**(不打 ERROR、不进自检留痕)
|
||||
* TC-PROTSTOR-005 **cnt 换代 → 2**(B8 32→40 项就是这个形态)
|
||||
* TC-PROTSTOR-006 magic 被破坏 → -1(真损坏)
|
||||
* TC-PROTSTOR-007 magic/ver/cnt 都好但数据被改(校验不过)→ -1
|
||||
* TC-PROTSTOR-008 长度不足头部 → -1,且**不得**误判为换代
|
||||
* TC-PROTSTOR-009 装载成功路径不打 INFO("version change"措辞不许乱出现)
|
||||
* —— 后端调用契约(TC-PROTSTOR-010..011)——
|
||||
* TC-PROTSTOR-010 读取用的路径 = "/prot_set.bin"(8.3 合规,FF_USE_LFN=0 约束)
|
||||
* TC-PROTSTOR-011 读取请求的容量 = PROT_SET_BLOB_SZ(blob 缓冲是静态区,不压栈)
|
||||
* —— save 脏标志与写失败重试(TC-PROTSTOR-012..016)——
|
||||
* TC-PROTSTOR-012 无脏标志 → 返回 0 且**一次都不写盘**
|
||||
* TC-PROTSTOR-013 有脏 + 写成功 → 返回 0,路径与长度正确
|
||||
* TC-PROTSTOR-014 写成功后脏被消费:紧接着再调不再写(不重复刷 Flash)
|
||||
* TC-PROTSTOR-015 写失败 → 返回 -1 且**脏回置**
|
||||
* TC-PROTSTOR-016 上一轮写失败后,下一轮仍会真的再写一次(定值不会静默丢失)
|
||||
*
|
||||
* 说明:serialize 失败这条分支在真实 prot_set.c 下不可达(缓冲尺寸恒等于
|
||||
* PROT_SET_BLOB_SZ),故不硬造用例;胶水层里它是防御性代码,记录在此。
|
||||
*
|
||||
* 通过:全部 TC PASS(main 返回 0)。
|
||||
* 入口:int main(void),返回 0=PASS / 1=FAIL(由 run 脚本判读)。
|
||||
*
|
||||
* 创建日期:2026-10-23
|
||||
*/
|
||||
|
||||
#include <stdio.h>
|
||||
#include <string.h>
|
||||
|
||||
#include "cfg_file_store.h"
|
||||
#include "prot_set.h"
|
||||
#include "prot_set_store.h"
|
||||
|
||||
/* 真实定值层(blob 编解码与脏标志在这里)+ 被测胶水层,均原样纳入 */
|
||||
#include "prot_set.c"
|
||||
#include "prot_set_store.c"
|
||||
|
||||
/* ===================== 断言框架 ===================== */
|
||||
|
||||
static int s_total;
|
||||
static int s_passed;
|
||||
static int s_failed;
|
||||
|
||||
#define CHECK(cond, name) do { \
|
||||
s_total++; \
|
||||
if (cond) { s_passed++; printf(" PASS %s\n", name); } \
|
||||
else { s_failed++; printf(" FAIL %s (line %d)\n", name, __LINE__); } \
|
||||
} while (0)
|
||||
|
||||
/* ===================== dbg_log 桩计数 ===================== */
|
||||
|
||||
int g_pstore_info_count;
|
||||
int g_pstore_error_count;
|
||||
int g_pstore_debug_count;
|
||||
|
||||
static void logs_clear(void)
|
||||
{
|
||||
g_pstore_info_count = 0;
|
||||
g_pstore_error_count = 0;
|
||||
g_pstore_debug_count = 0;
|
||||
}
|
||||
|
||||
/* ===================== 假平台后端(原型来自真实 cfg_file_store.h) ========= */
|
||||
|
||||
static uint8_t g_img[512]; /* 注入给 cfg_store_read 的文件内容 */
|
||||
static uint32_t g_img_len;
|
||||
static int g_read_rc; /* 注入:cfg_store_read 返回值 */
|
||||
static int g_write_rc; /* 注入:cfg_store_write_atomic 返回值 */
|
||||
static int g_read_calls;
|
||||
static int g_write_calls;
|
||||
static size_t g_read_cap;
|
||||
static size_t g_write_len;
|
||||
static char g_read_path[32];
|
||||
static char g_write_path[32];
|
||||
|
||||
static void rec_path(char *dst, const char *src, size_t cap)
|
||||
{
|
||||
size_t i;
|
||||
|
||||
if (src == NULL) {
|
||||
dst[0] = '\0';
|
||||
return;
|
||||
}
|
||||
for (i = 0u; (i + 1u < cap) && (src[i] != '\0'); i++) {
|
||||
dst[i] = src[i];
|
||||
}
|
||||
dst[i] = '\0';
|
||||
}
|
||||
|
||||
int cfg_store_read(const char *p_path, uint8_t *p_buf, size_t cap, size_t *p_nread)
|
||||
{
|
||||
uint32_t i;
|
||||
|
||||
g_read_calls++;
|
||||
rec_path(g_read_path, p_path, sizeof(g_read_path));
|
||||
g_read_cap = cap;
|
||||
if (p_nread != NULL) {
|
||||
*p_nread = 0u;
|
||||
}
|
||||
if (g_read_rc != 0) {
|
||||
return g_read_rc;
|
||||
}
|
||||
for (i = 0u; (i < g_img_len) && ((size_t)i < cap); i++) {
|
||||
p_buf[i] = g_img[i];
|
||||
}
|
||||
if (p_nread != NULL) {
|
||||
*p_nread = (size_t)i;
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
|
||||
int cfg_store_write_atomic(const char *p_path, const uint8_t *p_buf, size_t len)
|
||||
{
|
||||
g_write_calls++;
|
||||
rec_path(g_write_path, p_path, sizeof(g_write_path));
|
||||
g_write_len = len;
|
||||
(void)p_buf;
|
||||
return g_write_rc;
|
||||
}
|
||||
|
||||
/* 其余后端函数本模块不触发,给出空实现以满足链接 */
|
||||
void *cfg_store_alloc(size_t size) { (void)size; return NULL; }
|
||||
void cfg_store_free(void *p_buf) { (void)p_buf; }
|
||||
uint32_t cfg_store_heap_free(void) { return 0u; }
|
||||
int cfg_store_stat(const char *p_path, cfg_file_stat_t *p_st)
|
||||
{
|
||||
(void)p_path;
|
||||
if (p_st != NULL) {
|
||||
(void)memset(p_st, 0, sizeof(*p_st));
|
||||
}
|
||||
return -1;
|
||||
}
|
||||
int cfg_store_remove(const char *p_path) { (void)p_path; return -1; }
|
||||
|
||||
/* ===================== 辅助 ===================== */
|
||||
|
||||
static void backend_reset(void)
|
||||
{
|
||||
g_img_len = 0u;
|
||||
g_read_rc = 0;
|
||||
g_write_rc = 0;
|
||||
g_read_calls = 0;
|
||||
g_write_calls = 0;
|
||||
g_read_cap = 0u;
|
||||
g_write_len = 0u;
|
||||
g_read_path[0] = '\0';
|
||||
g_write_path[0] = '\0';
|
||||
logs_clear();
|
||||
}
|
||||
|
||||
/* 用**真实** serialize 造一份合法 blob,再按需改坏指定字段 */
|
||||
static uint32_t make_blob(uint8_t *p_dst, uint32_t cap)
|
||||
{
|
||||
uint32_t len = 0u;
|
||||
|
||||
prot_set_init();
|
||||
if (prot_set_store_serialize(p_dst, cap, &len) != 0) {
|
||||
return 0u;
|
||||
}
|
||||
return len;
|
||||
}
|
||||
|
||||
static void stage_blob(uint32_t len)
|
||||
{
|
||||
g_img_len = len;
|
||||
g_read_rc = 0;
|
||||
}
|
||||
|
||||
/* 把脏标志清干净(消费掉所有存量) */
|
||||
static void dirty_clear(void)
|
||||
{
|
||||
while (prot_set_dirty_take() != 0u) {
|
||||
/* 逐个消费直到 0 */
|
||||
}
|
||||
}
|
||||
|
||||
/* ===================== load 返回码分流 ===================== */
|
||||
|
||||
static void tc_load_triage(void)
|
||||
{
|
||||
uint8_t blob[PROT_SET_BLOB_SZ];
|
||||
uint32_t len;
|
||||
int rc;
|
||||
|
||||
printf("-- TC-PROTSTOR-001..009 load triage --\n");
|
||||
|
||||
backend_reset();
|
||||
g_read_rc = -1;
|
||||
rc = prot_set_store_load();
|
||||
CHECK(rc == 1, "TC-PROTSTOR-001 读失败归 1(按无档处理)");
|
||||
|
||||
backend_reset();
|
||||
len = make_blob(blob, sizeof(blob));
|
||||
memcpy(g_img, blob, len);
|
||||
stage_blob(len);
|
||||
rc = prot_set_store_load();
|
||||
CHECK(rc == 0, "TC-PROTSTOR-002 有效 blob 装载成功");
|
||||
|
||||
/* ver 换代:magic 完好、ver 与当前固件不同 → 预期升级路径,归 2 */
|
||||
backend_reset();
|
||||
len = make_blob(blob, sizeof(blob));
|
||||
memcpy(g_img, blob, len);
|
||||
g_img[4] = (uint8_t)(PROT_SET_BLOB_VER + 1u);
|
||||
stage_blob(len);
|
||||
rc = prot_set_store_load();
|
||||
CHECK(rc == 2, "TC-PROTSTOR-003 ver 换代归 2(不是 -1)");
|
||||
CHECK((g_pstore_info_count == 1) && (g_pstore_error_count == 0),
|
||||
"TC-PROTSTOR-004 换代只打 INFO,不误报 ERROR");
|
||||
|
||||
/* cnt 换代:B8 定值表 32→40 项就是这个形态 */
|
||||
backend_reset();
|
||||
len = make_blob(blob, sizeof(blob));
|
||||
memcpy(g_img, blob, len);
|
||||
g_img[6] = (uint8_t)((uint32_t)PS_ID_COUNT + 1u);
|
||||
stage_blob(len);
|
||||
rc = prot_set_store_load();
|
||||
CHECK(rc == 2, "TC-PROTSTOR-005 cnt 换代归 2");
|
||||
|
||||
/* magic 坏 = 真损坏 */
|
||||
backend_reset();
|
||||
len = make_blob(blob, sizeof(blob));
|
||||
memcpy(g_img, blob, len);
|
||||
g_img[0] = (uint8_t)(g_img[0] ^ 0xFFu);
|
||||
stage_blob(len);
|
||||
rc = prot_set_store_load();
|
||||
CHECK((rc == -1) && (g_pstore_error_count == 0), "TC-PROTSTOR-006 magic 坏归 -1");
|
||||
|
||||
/* magic/ver/cnt 全好,但数据被改 → 校验不过 = 损坏 */
|
||||
backend_reset();
|
||||
len = make_blob(blob, sizeof(blob));
|
||||
memcpy(g_img, blob, len);
|
||||
g_img[PROT_SET_BLOB_HDR_SZ] = (uint8_t)(g_img[PROT_SET_BLOB_HDR_SZ] ^ 0x5Au);
|
||||
stage_blob(len);
|
||||
rc = prot_set_store_load();
|
||||
CHECK(rc == -1, "TC-PROTSTOR-007 数据被改(校验失败)归 -1");
|
||||
|
||||
/* 截断到不足头部:不得误判为换代 */
|
||||
backend_reset();
|
||||
len = make_blob(blob, sizeof(blob));
|
||||
memcpy(g_img, blob, len);
|
||||
stage_blob(PROT_SET_BLOB_HDR_SZ - 1u);
|
||||
rc = prot_set_store_load();
|
||||
CHECK(rc == -1, "TC-PROTSTOR-008 长度不足头部归 -1 且不误判换代");
|
||||
|
||||
backend_reset();
|
||||
len = make_blob(blob, sizeof(blob));
|
||||
memcpy(g_img, blob, len);
|
||||
stage_blob(len);
|
||||
rc = prot_set_store_load();
|
||||
CHECK((rc == 0) && (g_pstore_info_count == 0),
|
||||
"TC-PROTSTOR-009 成功路径不打 INFO(version change 措辞不许乱出现)");
|
||||
}
|
||||
|
||||
/* ===================== 后端调用契约 ===================== */
|
||||
|
||||
static void tc_backend_contract(void)
|
||||
{
|
||||
uint8_t blob[PROT_SET_BLOB_SZ];
|
||||
uint32_t len;
|
||||
|
||||
printf("-- TC-PROTSTOR-010..011 backend contract --\n");
|
||||
backend_reset();
|
||||
len = make_blob(blob, sizeof(blob));
|
||||
memcpy(g_img, blob, len);
|
||||
stage_blob(len);
|
||||
(void)prot_set_store_load();
|
||||
CHECK(strcmp(g_read_path, "/prot_set.bin") == 0,
|
||||
"TC-PROTSTOR-010 路径 = /prot_set.bin(8.3 合规)");
|
||||
CHECK(g_read_cap == (size_t)PROT_SET_BLOB_SZ,
|
||||
"TC-PROTSTOR-011 读取容量 = PROT_SET_BLOB_SZ(静态缓冲,不压栈)");
|
||||
}
|
||||
|
||||
/* ===================== save 与脏标志 ===================== */
|
||||
|
||||
static void tc_save_dirty(void)
|
||||
{
|
||||
int rc;
|
||||
|
||||
printf("-- TC-PROTSTOR-012..016 save + dirty retry --\n");
|
||||
|
||||
backend_reset();
|
||||
dirty_clear();
|
||||
rc = prot_set_store_save();
|
||||
CHECK((rc == 0) && (g_write_calls == 0), "TC-PROTSTOR-012 无脏不写盘");
|
||||
|
||||
prot_set_dirty_mark();
|
||||
g_write_rc = 0;
|
||||
rc = prot_set_store_save();
|
||||
CHECK((rc == 0) && (g_write_calls == 1) &&
|
||||
(strcmp(g_write_path, "/prot_set.bin") == 0) && (g_write_len > 0u),
|
||||
"TC-PROTSTOR-013 有脏且写成功:路径与长度正确");
|
||||
|
||||
rc = prot_set_store_save();
|
||||
CHECK((rc == 0) && (g_write_calls == 1),
|
||||
"TC-PROTSTOR-014 脏已消费,紧接着再调不再刷 Flash");
|
||||
|
||||
prot_set_dirty_mark();
|
||||
g_write_rc = -1;
|
||||
rc = prot_set_store_save();
|
||||
CHECK((rc == -1) && (g_write_calls == 2), "TC-PROTSTOR-015 写失败返回 -1");
|
||||
|
||||
/* 关键:失败必须把脏标志还回去,否则这一轮定值永久丢失 */
|
||||
g_write_rc = 0;
|
||||
g_write_calls = 0;
|
||||
rc = prot_set_store_save();
|
||||
CHECK((rc == 0) && (g_write_calls == 1),
|
||||
"TC-PROTSTOR-016 上一轮写失败后下一轮仍真的再写(脏已回置)");
|
||||
|
||||
dirty_clear();
|
||||
}
|
||||
|
||||
/* ===================== 入口 ===================== */
|
||||
|
||||
int main(void)
|
||||
{
|
||||
printf("=== Prot Set Store Tests ===\n");
|
||||
|
||||
tc_load_triage();
|
||||
tc_backend_contract();
|
||||
tc_save_dirty();
|
||||
|
||||
printf("\n=== Prot Set Store Tests: %d/%d PASSED (failed=%d) ===\n",
|
||||
s_passed, s_total, s_failed);
|
||||
return (s_failed == 0) ? 0 : 1;
|
||||
}
|
||||
@@ -0,0 +1,52 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""保护定值持久化胶水层(prot_set_store)的主机侧单元测试运行器(L0.5,纯标准库)。
|
||||
|
||||
做什么:
|
||||
用本机 MSVC 编译 test/host/prot_set_store/prot_set_store_test.c(同时纳入**生产源**
|
||||
App/cfg/prot_set_store.c 与 App/cfg/prot_set.c),在 PC 上离线验证 blob 装载的
|
||||
返回码分流(1 无档 / 0 成功 / 2 换代 / -1 损坏)与保存的脏标志回置,失败即非 0
|
||||
退出。工具链与判定委托 test/host/common/unit_test_harness.py。
|
||||
|
||||
为什么要主机侧单测(而不是只用台架):
|
||||
换代与损坏必须分开(B8:定值表 32→40 项)——把正常的固件升级当损坏,会让设备在
|
||||
升级后报 ERROR + 自检留痕,现场查一个不存在的故障;写盘失败若不把脏标志还回去,
|
||||
表现是"改了定值、重启又变回旧的"且无任何提示。这两条真机上都要靠故障注入才碰得到。
|
||||
为什么连 prot_set.c 一起编:blob 的编解码与脏标志都在它里面,只有拿**真** serialize
|
||||
产出的 blob 去改 magic/ver/cnt/校验,才能造出真实的"换代"与"损坏"形态;手搓 blob
|
||||
等于测自己的桩。定值算法本身归 test/host/prot_set/,本模块不重测。
|
||||
|
||||
用法(仓库根目录):
|
||||
python test/host/prot_set_store/run_unit_test.py
|
||||
|
||||
退出码:0=PASS / 1=测试失败 / 2=环境错误。
|
||||
|
||||
设计依据:App/cfg/prot_set_store.h 的返回码表、docs/测试说明/主机单测覆盖率口径.md §9 P1
|
||||
创建日期:2026-10-23
|
||||
"""
|
||||
import os
|
||||
import sys
|
||||
|
||||
HERE = os.path.dirname(os.path.abspath(__file__))
|
||||
ROOT = os.path.dirname(os.path.dirname(os.path.dirname(HERE)))
|
||||
sys.path.insert(0, os.path.join(ROOT, "test", "host", "common"))
|
||||
|
||||
from unit_test_harness import TestBuild, run_host_unit_test # noqa: E402
|
||||
|
||||
# 顺序敏感:stub 先于生产目录(覆盖 dbg_log.h)。cfg_file_store.h / prot_set.h /
|
||||
# prot_set_store.h 全用真实头,后端两个被调函数由测试单元给可控实现。
|
||||
BUILD = TestBuild(
|
||||
name="Prot Set Store Tests",
|
||||
src=os.path.join(HERE, "prot_set_store_test.c"),
|
||||
include_dirs=[
|
||||
os.path.join(HERE, "stub"),
|
||||
os.path.join(ROOT, "App", "cfg"),
|
||||
os.path.join(ROOT, "App", "algo"),
|
||||
HERE,
|
||||
],
|
||||
summary_marker="=== Prot Set Store Tests:",
|
||||
)
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(run_host_unit_test(BUILD))
|
||||
|
||||
@@ -0,0 +1,20 @@
|
||||
/*
|
||||
* 模块名称:主机侧单测桩 - dbg_log.h(prot_set_store 模块专用)
|
||||
* 模块功能:把 MCU 版 DBG_* 宏替换为计数,让"换代只打 INFO、损坏不打"这类
|
||||
* 留痕差异成为可断言的行为(B8 的分流契约一半就在措辞上)。
|
||||
* ⚠ 仅供 test/host/prot_set_store/ 使用,不参与 MCU 构建。
|
||||
* 创建日期:2026-10-23
|
||||
*/
|
||||
|
||||
#ifndef DBG_LOG_H
|
||||
#define DBG_LOG_H
|
||||
|
||||
extern int g_pstore_info_count;
|
||||
extern int g_pstore_error_count;
|
||||
extern int g_pstore_debug_count;
|
||||
|
||||
#define DBG_INFO(fmt, ...) do { (void)(fmt); g_pstore_info_count++; } while (0)
|
||||
#define DBG_DEBUG(fmt, ...) do { (void)(fmt); g_pstore_debug_count++; } while (0)
|
||||
#define DBG_ERROR(fmt, ...) do { (void)(fmt); g_pstore_error_count++; } while (0)
|
||||
|
||||
#endif /* DBG_LOG_H */
|
||||
Reference in New Issue
Block a user