518e12f200
起因:装真 cppcheck 2.21.0 后本钩子暴露 106 条命中,其中 76 条本就不该被扫。 cppcheck 与 coding-standard 两个钩子的注释都自称「范围一致」,实际各漏一块, 而本钩子此前从未真正跑起来(C:\cppcheck\cppcheck.exe 是坏 zipapp,进程根本没起, --error-exitcode 对「没跑起来」不生效),所以没人发现。两轮合计 834 条命中里 802 条是「不该被扫的」,真问题被完全淹没。 一、范围对齐(106 → 30) cppcheck 钩子 exclude 补三条 104 上游前缀:App/iec60870/common/、 App/iec60870/104/business/、App/iec60870/104/IEC104[_.]。三条只豁免上游库 尚未改造的部分,我们自己的小写适配文件(iec104_core/net_mcu/source/comm)仍受检。 不能改写成祖先目录 App/iec60870/,那会把适配层一起豁免。 test-cppcheck 钩子排除 test/host/iec104_netmcu/results(按 check_static_selftest.py 生成的自检变异体是故意写坏的副本,不是被测代码)。 二、剩余 30 条直接改代码清零(未建抑制基线) 逐条核过:cppcheck 判对了,它们违反本仓 docs/代码规范/嵌入式C语言代码规范_V1.0.md §6.1.1「变量应在使用前声明,并尽可能在靠近使用的地方声明」。仓内对「永久免检」 有明确反对立场(coding-standard 的 104 排除注释写着「改完必须删掉这三行,否则等于 自建代码永久免检」),故不建抑制基线,直接改对: - iec104_comm.c:4 处 v > IEC104_COMM_CA_MAX / PORT_MAX 删除。上界 65535 是 uint16_t 类型极限,比较恒为假(compareValueOutOfTypeRangeError);宏本身保留, App/app/ui_data_feed.c 的 UI 范围提示仍要用它表达合法带上界。 - ioboard_bits.c:删 && (i < IOBOARD_DI_COUNT),外层 for 已限定,且它在取下标之后才判。 - iec104_source.c:三处 ifdef 哑变量(a/p/raw、e/i/b/raw/p/element、i/m/g/valid) 把声明搬进各自编译档内,删掉全部 (void)x 抑制句——正是这些抑制句让 cppcheck 认为「读了未赋值变量」(unassignedVariable)。另 remote_lookup / parameter_config 的 i/n/p、g/m 就近声明。 - iec104_net_mcu.c:Listen 的 uint32_t i、Wait 的 listen_slot/client_slot/sock 移进各自分支;sock 加 const。 - net_socket.c:net_pending_bytes 的 p_sock 加 const。 - ui_task.c:ui_task_wave_load_head 的 FRESULT fr 移进 if (ofr == FR_OK) 块。 - ioboard_di.c:ioboard_di_snap_read 的 s1/s2 移进重试循环。 - ui_page_yx.c:pg_refresh 的 dio_row 移进板级开入开出区分支。 三、实证 - cppcheck 钩子:106 → 30 → 0,Passed。 - 反证钩子没被排除条款吞掉:注入 variableScope 探针 → 立即报出 variableScope + unreadVariable 两条;恢复后重新 Passed。 - Keil BUILD_OK 0 errors 0 warnings,Program Size 逐项不变 (Code=365896 RO=48336 RW=2736 ZI=173104)=本轮全是纯排版,零目标码变化。 - test-cppcheck Passed(0 命中)。 - 全量 manual 阶段 52 根钩子全绿、0 失败。 - host 套件:iec104_comm 50/50、ioboard 131/131、iec104_dtu 7 tests OK、 iec104_serv 50/50、net_socket 683/683、sys_clock 111/111、iec104_netmcu 17/17、 net_events 34/34、net_listener 34/34、net_pending 43/43、net_select 22/22、 ui_sink 17/17、lftpd 35/35、lftpd_inet 29/29、time_sync 33/33。 - UI golden:77 个页面 + 待机水位 + rtlive 全通过。 - net-handle:495 文件 PASS 0 违规。 - 裁剪档 IEC104_SOURCE_NO_VALUE_STORE 隔离编译 rc=0 无 error/warning (声明搬进 #else 后必须保证该档仍成立)。 - BOM:ui_page_yx.c / ui_task.c 编辑后 BOM 被剥,已补回,check_bom_drift rc=0。 四、顺带修掉的两处真实漏项 - ram_baseline.py 的 subsystem_of() 前缀表漏 ioboard:App/util/ioboard_di.c 编出的 ioboard_di.o(4 B)一直静默算进「其它」而非「应用」,台账配额表看不见。 - 内存台账回填:a2242b73(IEC104_Net_Listen 修复)是上次回填d2c328e8之后的 代码改动,内存数字从未重测,mem-numbers / mem-budget 两根钩子因此红。 本轮按当前权威构建重新回填(Code=365896,相对d2c328e8的 365924 减 28 B)。 五、文档 docs/代码规范/cppcheck使用说明.md: - §4.2 新增「安装陷阱:cppcheck.exe 可能是假 zipapp」——识别方法、根因、 2.21.0 正确装法(MSI 截断与续传、管理式解包、必须整目录)、为什么不用 pip 版、 教训(Failed 里没有命中/条数/文件名就当工具没跑起来)。 - §4.5 修正「Drivers/BSP/UI/ 不检查」的过期说法——它在本仓是手写 UI 页面代码 (库在 Lib/lvgl/),实测本钩子直接报了 ui_page_yx.c。 - §4.6 新增两根钩子的范围关系表:共享 11 项共同核心,各自另有小块豁免 (cppcheck 多排 test/,coding-standard 多排 Src/ Inc/ nand_ftl),是设计意图 不是漏配;改共同核心必须两边一起改。
test/ — 测试代码与主机端脚本
测试分两部分,物理隔离在两个子目录:
board/—— 板端测试套件(.c/.h,编入固件由 testTask 执行)host/—— 主机端脚本(.py,PC 侧驱动板子并判读结果)
目录结构
| 目录 | 内容 | README |
|---|---|---|
board/ |
板端测试套件(编入 Keil 工程,占 RAM) | board/README.md |
host/ |
PC 端测试/判读脚本(Python) | host/README.md |
run_all_suites.py |
多套件回归编排(改宏 → 构建 → 烧录 → 采集,try/finally 保证还原开关);--check-build = 只编译不烧录(纯离机) |
本文 §多套件回归 |
运行方式
# /serial-boot-test 一键闭环(推荐)
& '.venv\Scripts\python.exe' .dsh/skills/serial-boot-test/scripts/run_boot_test.py
# 单独校验日志
& '.venv\Scripts\python.exe' .dsh/skills/serial-boot-test/scripts/verify_log.py <日志文件>
# 多套件回归编排(需真机;自动改开关 + 构建 + 烧录 + 采集,结束后还原)
& '.venv\Scripts\python.exe' test/run_all_suites.py
& '.venv\Scripts\python.exe' test/run_all_suites.py --suites STORAGE,GD5F
& '.venv\Scripts\python.exe' test/run_all_suites.py --dry-run # 只看计划
# 只编译不烧录(不需要 MCU / 串口 / ST-LINK,验证 4 套件可编译性)
& '.venv\Scripts\python.exe' test/run_all_suites.py --check-build
退出码约定:0=PASS / 1=FAIL / 2=采集或烧录错误 / 3=用法或预检错误。
多套件回归(run_all_suites.py)
套件互斥(编译期 #error)意味着跑 4 个套件要手工循环 4 轮。本脚本把它编排成一条
命令,并且无条件还原 test_config.h——跑完忘还原 = 测试固件进库,这是它存在的
核心理由(与提交期门禁 test-suite-switch 互为独立防线)。
⚠️ 每轮要真机烧录 + 采集,4 套件约数分钟起;破坏性套件还会改设备持久状态。 仅回归窗口用,绝不挂 pre-commit。
--check-build 则相反:只改宏 + /keil-build,不烧录不采集,无需任何硬件,用于防止
"测试套件长期编不过而无人知"(2026-08~09 CH395F 套件实例)。改动 test/board/ 下测试
代码后建议先跑它——实测 4 套件均 BUILD_OK: 0 errors, 0 warnings。
⚠️ 注意
- 本目录被 pre-commit 门禁排除(测试代码不受 C 规范约束)
board/套件占用 RAM,启用前先核算预算(见docs/内存管理/)- Keil 工程已同步:
board/下 7 个.c编入MDK-ARM/STM32F4-Demo.uvprojx, IncludePath 含../test/board;移动文件须同步改工程文件 - 套件选择开关:
board/test_config.h的TEST_SUITE_*(互斥,一次只启用一个) - 测试缓冲用分 Phase 复用静态缓冲(避免
L6406E溢出)
相关文档
docs/测试说明/流程与规范/测试开发标准流程.md— 测试验证分层与门禁决策表docs/测试说明/流程与规范/自动化测试流程.md—/serial-boot-test细节与失败模式- 各模块测试指南:
docs/测试说明/板级测试/*_Test_Guide.md docs/测试说明/专项验证/链路延迟测试说明.md