13ed84a0f0
104 从 App/protocol 迁入 App/iec60870 时,协议核心(common/ 104/ examples/) 与我方平台适配层(原 104_port/)仍分成两个平行目录。既然这个库已转为项目自有 代码,适配层没有独立存在的理由——它本来就是对协议的装配与平台后端。 本次只做目录合并,不动任何协议逻辑: - App/iec60870/104_port/ 的 11 个文件全部移入 App/iec60870/104/ (iec104_core / iec104_source / iec104_source_ranks / iec104_net_mcu / iec104_dtu_table / iec104_comm 的 .c/.h),空目录删除 - Keil 删掉 ../App/iec60870/104_port include 路径;模拟器 CMake 把重复的 104_port include 行合并进既有的 IEC60870_DIR/104 - 单测运行器里硬拼的 "104_port" 路径段改成 "104"(rename_ref 只认斜杠形态) - .pre-commit-config.yaml 的 iec104-tcp 触发面去掉 104_port 前缀;coding-standard 的排除注释改写为「库已转为自有代码,排除项待收编完成后删除」 - 文档与生成物同步:项目架构总览、软件架构与运行时规格、IEC104 上行设计说明、 产品需求、网络配置说明、App/README、仓根 README,以及引用关系图与架构 SVG 验证(均为实跑): - Keil UV4 RC=0,0 errors 0 warnings,Code=367464 RO=48492 RW=2288 ZI=173544 - 模拟器构建 OK,编译告警 0,iec104-tcp 13/13 真实 TCP 回环通过 - 受影响单测:iec104_comm 50/50、iec104_serv 50/50、iec104_netmcu 13/13 与 static 2/2、soe 32/32、iec104_dtu 7 tests OK - 覆盖率门禁 RC=0,line 8204/9185 (89.3%),49/49 套件 - 全仓 104_port 残留:仅 App/README 里一句「原 104_port 并入 104」的历史说明
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