Files
STM32F4-Base/test/board
wandering1 7efa58d9a1
CI / 静态门禁 (pre-commit) (push) Failing after 25s
CI / 主机侧单测 (MSVC) (push) Successful in 48s
network: 台架 IP 迁到 192.168.31.100,并把重复写死的值收进单一真源
分两段(用户裁定 2026-11-02):先做地址迁移,再把同类字面量收敛成
单一真源,以后再改地址只动一处。

一、IP 迁移 192.168.1.100 → 192.168.31.100(gw 同步 → .31.1)
- 工厂默认:Drivers/BSP/NETCFG/net_cfg.c 的 NET_CFG_DEF_IP/_GW
- 注释/文档示例、主机与板级测试、台架 py 脚本、两份 sim_config.ini
- 字节序教学点同步换算 hex:0x6401A8C0 → 0x641FA8C0(内存
  C0 A8 1F 64),旧版示例引文与历史 Trap 记录按冻结纪律不动
- UI 黄金基准:网口设置 4 态 + shot_info 共 5 张 .bin 由
  check_content_pages.py --update 重刷(渲染值 IP 变了,属预期变更)
- 保留判定:客户点表引用(IEC104/继电保护规划)、芯片手册摘录、
  日期冻结的变更记录行、已退役台架档案 MDK-ARM/retracted_bench_*

二、单一真源收口(A+B+C+D,用户批准全做)
- 新建 test/host/bench_defaults.py:台架 py 默认值唯一定义点
  (DEVICE_IP/DEVICE_GW/PC_IP/NET_BCAST),22 个脚本改为引用;
  MDK-ARM 两探针与 scripts/board_ui_nav.py 经 sys.path shim 引入
- test/board/net_test_task.h 新增 TEST_PC_PEER_IP,板测三处
  PHASE*_REMOTE_IP 改引该宏(保留 -D 覆盖);Phase1 断言改
  memcmp 数组比较,数组各只出现一次
- simulator/tests/check_content_pages.py 从 net_cfg.c 正则解析
  NET_CFG_DEF_* 推导期望值(解析失败即报错、不静默兜底),
  脚本内台架 IP 字面量清零
- 装饰性注释去具体值(net_cfg.h/net_socket.h/net_socket.c/
  net_socket_sim.c);字节序教学 hex 对刻意保留为唯一写值点
- 刻意不动:主机单测夹具 IP(逐文件钉住的任意值是正确测试
  实践)、文档正文 IP(那是文档内容本身)

顺带:scripts/gen_task_table.py 规范串清掉「,B5」——编号清退提交
72b4b094 改了受管区没重跑生成器,task-table 门禁因此一直红

验证:产品 @build 0/0;CH395F 套件开关构建 0/0 后还原产品态;
6 套主机单测 rc=0;content_pages(含宏推导路径)/菜单 8 态/
推流位比对全 PASS;bom-drift 99 无漂移;doc-links/coding-standard/
cppcheck 绿;py_compile 23 文件 + --help 冒烟(含 shim 绝对路径)
2026-11-02 14:46:42 +08:00
..

test/board/ — 板端测试套件

⚠️ 编入固件的测试代码(由 testTask 执行)。这些 .c 已注册到 Keil 工程 MDK-ARM/STM32F4-Demo.uvprojx,占用 MCU 的 RAM/Flash。

文件一览

文件 测试对象 / 作用
test_config.c/h 测试任务配置:TEST_SUITE_* 套件选择开关(互斥)+ ENABLE_DESTRUCTIVE_TESTS
test_common.h 公共断言内核:test_stats_t + TEST_CHECK_IMPL/TEST_REPORT_IMPL;各套件用一行宏绑定自身统计变量
ch395f_test_task.c/h + ch395f_test.h CH395F 以太网(硬件层 Phase 15 / NET 层 Phase 611)
gd5f_test_task.c/h + gd5f_test.h GD5F2GQ5UE SPI NAND 存储
sd2506_test_task.c/h + sd2506_test.h SD2506 RTC
storage_test_task.c/h + storage_test.h 存储性能
net_test_task.c/h 网络层测试
net_latency_test.c/h 链路时延探针(DWT CYCCNT 时基,MCU 专属)

⚠️ 构建约束(AGENTS.md 详述)

  • 套件互斥:test_config.h 的 TEST_SUITE_CH395F/STORAGE/GD5F/RTC 一次只能启用一个 (违反则 #error);全部注释 = 产品构建
  • ⚠️ 测试固件不得静默提交:TEST_SUITE_* 开关受 pre-commit 钩子 test-suite-switch 门禁——默认要求全部注释。跑完套件回归务必改回产品构建再提交(2026-10-01 实测已提交 HEAD 里 TEST_SUITE_CH395F 就是开启状态,纯靠人记得改;故补此门禁)。确需提交测试构建时用 ALLOW_TEST_BUILD=1 git commit ... 或 python scripts/check_test_suite.py --allow-test-build 显式放行
  • 破坏性用例默认关闭:ENABLE_DESTRUCTIVE_TESTS(默认注释)控制写/擦 NAND、格式化、 坏块注入。关闭时为只读模式(横幅 mode: READ-ONLY),可随时在在用设备上跑
  • ⚠️ 实测一轮破坏性 GD5F 运行即让 dhara 多记一个坏块(容量下降且需全片擦除恢复)—— 只在产线首启或明确需要时打开
  • CH395F 套件:硬件层与 NET 层模式互斥
  • 总线独占:CH395F 硬件层模式下 netTask 自挂起,testTask 独占 CH395F

添加新测试套件

  1. 在 test_config.h 加开关(并入互斥 #error 检查)
  2. 新建 <模块>_test_task.c/h
  3. 注册进 Keil 工程(<FilePath>..\test\board\xxx.c</FilePath>)
  4. 跑回归:/serial-boot-test(.dsh/skills/serial-boot-test/scripts/run_boot_test.py)

相关文档

  • 测试指南:docs/测试说明/板级测试/CH395F_Test_Guide.md、GD5F2GQ5UE_Test_Guide.md、SD2506_Test_Guide.md、FTP_Test_Guide.md
  • 套件配置:AGENTS.md「测试与验证」章
  • 容量恢复:docs/测试说明/专项验证/存储维护与容量恢复.md