feat(iec104): 把 104 骨架完整迁到 MCU 板端并在台架跑通总召
把 IEC104 从模拟器端整体搬到板端:协议栈原先由独立 iec104Task 驱动, 现在改为 netTask 单 owner 的 threadless 驱动,退役独立任务。 驱动与后端: - 新增 iec104_net_mcu.c/.h,实现 IEC104_Net.h 的 11 个 ABI 函数, 用槽表加单调句柄映射 net_socket 的单 fd 模型;CLIENT 拆除只走 net_drop_conn_locked,绝不 net_close 监听 fd。 - net_socket 增 5 个 owner-only 接口(net_accept_locked、 net_drop_conn_locked、net_pending_bytes、net_send_try、 net_mono_now_ms)。 - iec104_serv.c 重写为 iec104_serv_net_tick(),在 netTask 1ms 主循环 里驱动 core;无 osDelay/阻塞调用,喂狗是第一句。 - Src/freertos.c 删除 iec104Task 三件套,对应栈水位探针表项同步删除。 内存:目标板 192KB SRAM 装不下 vendor 默认容量档,按实测裁剪到 skeleton 档(TCP 缓冲、业务池、SOE 256->128、值槽密集化), RW_IRAM1 118,408 B / 90.3%,留 2,178 B 余量。 台架修复(只在真硬件暴露): - SNTP s_ctx.fd 零初始化后为 0,而 net fd 0 是合法槽位下标, 首次代次变化时误 net_close(0) 关掉 ftpTask 的监听槽,导致 104 连接被 FTP 的 220 banner 抢走;改为显式 .fd = -1。 - Accept 幂等:单 fd 模型下 vendor 每轮重试 Accept 会拿到同一 fd, 后端改为会话在役时返 WOULD_BLOCK,Close 不再清槽。 验证: - Keil 全量重建 0 error 0 warning,uvprojx 零抖动。 - 模拟器真实 TCP 13/13、transport 10/10。 - netmcu 后端单测 13/13(新增 N12)。 - 台架 serial-boot-test required 全中;板端 2404 总召 129 帧收到 59 遥信(53 有源、全 IV)+ 16 双点 + 30 遥测(PT1 三相非零、 UN/频率/温度按未标定置 IV)、遥控选择执行全否定、校时 COT 7。 - 期间顺带修正 UI 漂移自检文案、.serialtest required 陈旧项、 coding-standard 对 vendor 与外部 ABI 名字的排除口径。
This commit is contained in:
+3
-3
@@ -1059,7 +1059,7 @@ date +%s # 对比 last_online
|
||||
| Runners 页 runner 显示 **`offline`** | daemon 进程不在:`gitea-runner` v4 的 `daemon` **首次 Declare 失败就直接退出**(Gitea 重启/机器重启后无人拉起) | §2.4 用 `ci_runner_bootstrap.ps1` 装看门狗 + 计划任务;`-Status` 复查 |
|
||||
| `static-gates` 报 `no Python with a SYSTEM-visible pre-commit` | runner 是 SYSTEM:PATH 上的 python 无 pre-commit、用户级 site 不可见、`.venv` 未入库(§4.1 三重坑) | `ci_runner_bootstrap.ps1 -SetEnv` 写机器级 `DTU_PRECOMMIT_PYTHON`,或把 pre-commit 装进机器级解释器;**改完必须重启 runner** |
|
||||
| `static-gates` 报 `runner missing cppcheck` | 机器 PATH 无 Cppcheck 且无机器级 `DTU_CPPCHECK` | `-SetEnv`(会自动发现 `C:\Program Files\Cppcheck`)或装 `Cppcheck.Cppcheck` |
|
||||
| **钩子条数对不上**(CI 的 `--all-files` 报告条数 = 定义数 − 1 − 3 manual:定义数 **51** → 报告 **47** 行,另由「手动阶段门禁」步跑 3 根(2026-10-29 起声明数 52 → 报告 48 行,公式不变);2026-10-12 **当时**实测 `master` 18 定义 / 17 报告,`v2-on-ui` 26 定义 / 25 报告——**增删钩子的分支必须重算这个差值**) | 两处都不进 `--all-files` 报告:`gitlint` 的 `stages: [commit-msg]` 写在**上游** `.pre-commit-hooks.yaml`(项目 `.pre-commit-config.yaml` 里 grep 不到,别据此断定"没限制");`cppcheck` / `test-cppcheck` / `test-coverage` 带 `stages: [manual]`,只由「手动阶段门禁」步逐根 `--hook-stage manual` 跑。都会表现为全绿——静默空转 | commit-msg 阶段已由 `scripts/ci_gitlint_range.ps1` 单独校验、manual 三根已由「手动阶段门禁」步兜住;**以后增删钩子必须核对"定义数 == 日志条数 + gitlint + manual 三根"** |
|
||||
| **钩子条数对不上**(CI 的 `--all-files` 报告条数 = 定义数 − 1 − N manual:**当前**定义数 **52**、manual **4** → 报告 **47** 行,另由「手动阶段门禁」步跑其中 3 根,第 4 根 `iec104-tcp` 因需模拟器产物而**只在开发机本地跑**;2026-10-29 当天是定义数 52 / manual 3 → 报告 48 行;2026-10-12 **当时**实测 `master` 18 定义 / 17 报告,`v2-on-ui` 26 定义 / 25 报告——**增删钩子的分支必须重算这个差值**) | 两处都不进 `--all-files` 报告:`gitlint` 的 `stages: [commit-msg]` 写在**上游** `.pre-commit-hooks.yaml`(项目 `.pre-commit-config.yaml` 里 grep 不到,别据此断定"没限制");`cppcheck` / `test-cppcheck` / `test-coverage` / `iec104-tcp` 带 `stages: [manual]`,只由「手动阶段门禁」步逐根 `--hook-stage manual` 跑(`iec104-tcp` 不在 CI 步里,见该步注释)。都会表现为全绿——静默空转 | commit-msg 阶段已由 `scripts/ci_gitlint_range.ps1` 单独校验、manual 四根中 CI 能跑的三根已由「手动阶段门禁」步兜住;**以后增删钩子必须核对"定义数 == 日志条数 + gitlint + manual 根数"** |
|
||||
| gitlint 步骤 **Failed 但提交信息其实合规**(同一条命令在本地全绿),日志里是 `exit code: 254` + `Missing git configuration: please set user.name` | `actions/checkout` 把 HOME 临时指向每次任务的临时目录,而 SYSTEM 账号没有全局 git 身份 → gitlint **在读到任何规则之前**就因配置错误退出(**254 不是规则违规**)。旧脚本末尾那句 `::error::...rule: single-line Chinese title, < 100 chars` 是**写死的猜测文案**,把环境问题伪装成"提交信息不合格";且该步 `exit 1` 会让后面的 `--all-files` **整个不跑**——看着像"门禁拦住了",实际当时 26 个钩子一个都没执行 | `ci_gitlint_range.ps1` 先探测身份,缺失就用 `GIT_CONFIG_COUNT/KEY/VALUE` 注入一次性身份(**不写任何文件**,开发者机器不受影响),并把 254 与真实违规分开报(**2 = 门禁没跑起来**,1 = 信息确实违规)。实测同一命令:空 HOME 下改前 254、改后 `0 failed`(2026-10-12 task 31 首次暴露) |
|
||||
| push 后 Actions 页**空白/无任务** | ① 服务端开关未开 ② workflow 没 push 到远程 ③ 只改了 `docs/**`(被 `paths-ignore` 滤掉) ④ **新建分支的首次 push**(实测 2026-10-12:创建 `v2-on-ui-ci` 那次 push 没产生 run——runner 在线空闲、job 日志零新增;紧接着一次普通 push 立刻出 task。原因:`before` 是全零 SHA,变更文件集算不出来,`paths-ignore` 求值时被滤空) | ①②③ 逐条核对 §1 / §5.1 / §5.2;④ 用 `workflow_dispatch` 手动触发,或再推一个非文档路径的提交 |
|
||||
| 任务一直 **Waiting / 排队** | 没有 label 匹配 `windows` 的 runner | 检查 `--labels "windows:host"`;Settings→Runners 是否 Idle |
|
||||
@@ -1208,9 +1208,9 @@ runner 的日志走 **stderr**,于是上面两个日志文件都栽在这两
|
||||
- **钩子集变化**(`.pre-commit-config.yaml` 增删钩子):CI 自动跟随,无需改 workflow;
|
||||
但**必须核对条数**——`pre-commit run --all-files` 只跑 `pre-commit` stage(现 47 根),
|
||||
`commit-msg` stage 的钩子(gitlint)不在其中,靠 `ci_gitlint_range.ps1` 单独守(见 §7);
|
||||
带 `stages: [manual]` 的三根(`cppcheck` / `test-cppcheck` / `test-coverage`)也不在其中,
|
||||
带 `stages: [manual]` 的四根(`cppcheck` / `test-cppcheck` / `test-coverage` / `iec104-tcp`)也不在其中,
|
||||
靠 static-gates 的「手动阶段门禁」一步逐根 `--hook-stage manual` 跑(新增 manual 钩子须同步加进
|
||||
该步的 `$hooks` 列表,否则只声明不执行);
|
||||
该步的 `$hooks` 列表,否则只声明不执行;⚠ `iec104-tcp` 需模拟器产物而 CI 不构建模拟器,故它**只能本机跑**);
|
||||
- **`/keil-build` / 板端测试套件 / 主机侧回归**:永远留在本地,不要往 CI 加(需 Keil 授权与真机);
|
||||
- **runner 长时间不可用**时:CI 只是"多一道网",**提交前的本地 `ci_local.py` 仍是 静态门禁的唯一保障**,
|
||||
不能因"已经配了 CI"放宽(理由见本文 §0 仓库状态行)。
|
||||
|
||||
@@ -101,6 +101,7 @@ docs/
|
||||
| [`网络/BSD_Socket_API_使用指南.md`](网络/BSD_Socket_API_使用指南.md) | **上层视图**:BSD Socket API 公开语义、示例、常见问题 |
|
||||
| [`网络/BSD_Socket_API_函数调用关系.md`](网络/BSD_Socket_API_函数调用关系.md) | **内部视图**:netTask / 消息队列 / 保护判据挂起 / 重试对账的调用关系与设计意图 |
|
||||
| [`网络/Net层阻塞模型架构设计.md`](网络/Net层阻塞模型架构设计.md) | **等待模型**:recv/send 挂起请求架构、数据结构与挂起槽状态机、recv 五路 + send 四路完成语义、模块接口契约(14 函数)、实现落点(20 集成点)、调用方契约、设计边界与性能特征 |
|
||||
| [`网络/IEC104_Net适配契约.md`](网络/IEC104_Net适配契约.md) | **104 板端 Net 后端契约**:直译 vendor `Close(client)` 会毁掉监听的**反例**、按槽 role 的映射规则、LISTEN 恒定 / CLIENT 每次新建的双句柄模型、代次不变式、单调不复用句柄、`NET_NO_OS` 编译期边界与已知缺口、证据边界(fake 12/12,CH395F 板端未证) |
|
||||
| [`网络/网络自愈架构设计.md`](网络/网络自愈架构设计.md) | **网络自愈架构 + 监听生命周期**:现状权威描述——根因三层证据与 A′ 出局、ioLibrary 代码级对照、设计原则(不变量 I1~I8)、分层职责与三 tick、reconciler 形态①~⑤ + M3 门、驱动原语、读即清信源审计、FUN_PARA bit3 契约、recv 语义、KeepAlive、参数表与 E 锚点速查、红线、编号发现速查、代码级事实清点、决策记录、`net_listener.c` / `net_events.c` 模块化边界、延后项;审计与实施过程已归档 |
|
||||
|
||||
---
|
||||
|
||||
+23
-5
@@ -18,7 +18,7 @@
|
||||
| 相量(有效值/相角) | `App/algo/phasor.h` | 算法层 |
|
||||
| 频率 | `App/algo/freq.h` | 算法层 |
|
||||
| 定值(40 项 + 封存态) | `App/algo/prot_set.h` | 算法层 |
|
||||
| 遥信位图 / 品质 | `App/protocol/iec104/iec104_pts.h` | 协议层 |
|
||||
| 遥信位图 / 品质 / 单双点性质 | `App/protocol/iec104/iec104_dtu_table.h`(2026-11-17 割接前为 `iec104_pts.h`,该实现已删除) | 协议层 |
|
||||
| 时钟 | `App/util/sys_clock.h` | 工具层(**已在 ALLOW 豁免内**) |
|
||||
| 运行/自检记录 | `App/log/sys_log.h` | 服务层 |
|
||||
|
||||
@@ -71,7 +71,7 @@
|
||||
flowchart TB
|
||||
subgraph APP["App 层(业务)"]
|
||||
F["App/app/ui_data_feed.c<br/>组装一帧(唯一填充者)"]
|
||||
SRC["phasor / freq / prot_set / iec104_pts / sys_clock"]
|
||||
SRC["phasor / freq / prot_set / ioboard / iec104_dtu_table / sys_clock"]
|
||||
F --> SRC
|
||||
end
|
||||
subgraph BSP["Drivers/BSP/UI(表现层)"]
|
||||
@@ -123,7 +123,7 @@ flowchart TB
|
||||
|
||||
```c
|
||||
#define UI_DATA_YC_N 9u /* 语义通道数:UA/UB/UC/UN/IA/IB/IC/IN/温度 */
|
||||
#define UI_DATA_YX_N 33u /* 遥信点数(与 104 点表同序) */
|
||||
#define UI_DATA_YX_N 33u /* 遥信点数:产品视图 33 行(割接前与旧 104 点表同序,见下方 yx_dp 要点) */
|
||||
#define UI_DATA_PH_MAX 8u /* 相量实例槽上限(含谐波),见正文槽带说明 */
|
||||
|
||||
/* 品质位(与 104 QDS 语义对齐,页面只消费自己关心的位) */
|
||||
@@ -171,7 +171,25 @@ typedef struct {
|
||||
- **`ph[]` 相量实例槽带**与 `yc[]` 语义通道带并存的理由:谐波(`Ia` 的二次/五次)无法在"语义通道"下标空间里表达——同一通道的谐波会与基波撞位,而交流量页要显示它们(`docs/UI设计/页面扩充详细方案.md` §3.1.1)。槽带按**相量实例序**索引,实际发布槽数由 `ph_n` 给出、超上限的实例本帧不发布(写侧口径在 `App/app/ui_data_feed.c` 的 `fill_rt()`)。两条带的元素同形(数值 + 品质),页面行表按需选一条。上限 8 = 现用 5 实例(UA/UN/IA 基波 + IA 二次/五次)+ 遥测谐波轨留位。
|
||||
- **字符串只用定长数组**:`clock[20]` 在结构体内,无指针、无生命周期问题(跨层传指针是经典事故源)。
|
||||
- **`yx_valid` 与 `yx_bits` 分开**:无效点不参与显示、不参与变位判断(沿用 104 点表的既有做法,避免"IV 通道抖动成变位")。
|
||||
- **`yx_dp`**:单点还是双点是 **104 点表事实**(`App/protocol/iec104/iec104_pts.c` 的 `YX_DP_N` / `iec104_pts_yx_is_dp()`),由写侧 `ui_data_feed.c` 逐点问点表后下发位图;页面只按位图选词(双点"合位/分位"、单点"动作/复归"、无效 "--")。把"前 4 点是双点"抄进表现层就是第二真相:点表改成双点段挪位或加高起始下标,屏上不会报错,只会用错词形容同一个点。V0.1 这 4 点无开入硬件 → 不在 `yx_valid` 内,值列仍打 "--"(本字段不参与无效判定)。点数一致性由写侧一条一次性 `DBG_ERROR` 兜(`UI_DATA_YX_N` 与 `iec104_pts_yx_count()` 不等时留痕),因为该常量在协议层是 .c 内的 `#define`,编译期拿不到。
|
||||
- **`yx_dp`**:单点还是双点是 **104 点表事实**,由写侧 `ui_data_feed.c` 的 `feed_yx_dp()` 逐点问点表 `type` 字段(1 = 单点、3 = 双点)后下发位图;页面只按位图选词(双点"合位/分位"、单点"动作/复归"、无效 "--")。把"前 4 点是双点"抄进表现层就是第二真相:点表改成双点段挪位或加高起始下标,屏上不会报错,只会用错词形容同一个点。
|
||||
**2026-11-17 通信骨架割接后,问的点表换了源**:旧的产品自有 33 点表实现 `App/protocol/iec104/iec104_pts.c`(`YX_N = 33`、`YX_DP_N = 4`,`iec104_pts_yx_is_dp()` 逐点判型)已随割接删除;现在问的是 DTU 标准表 `iec104_dtu_point()`(`App/protocol/iec104/iec104_dtu_table.c`)。两套点表语义不同:新表 index 0~58 是单点(0~42 → IOA 0x0001~0x002B,43~58 → 0x0032~0x0041,源表 0x002C~0x0031 空号)、59~74 是双点(IOA 0x1001 起)、75~104 是测量值,共 59 + 16 = 75 个遥信点,**双点不在 0~3 而在 59~74**。
|
||||
**这不改变任何像素**:本字段只覆盖 `UI_DATA_YX_N = 33` 行,即新表的单点段;双点段落在 33 之外,取不到。而产品视图的 YX1~4(页面名表"位置1~4")在新表里是单点、旧表里是双点——这 4 点 V0.1 无开入硬件,不在 `yx_valid` 内,页面先按 valid 短路打 "--",走不到双点/单点选词分支,所以屏上无差异。**点表口径差异是既有事实,不是本节引入的问题。**
|
||||
点数一致性由写侧一条一次性 `DBG_ERROR` 兜(`UI_DATA_YX_N` 与 DTU 表 `SP_COUNT + DP_COUNT = 75` 不等时留痕)——该口径**自割接起会打且是应打的**:33 行产品视图与 75 点标准表本就不等,这条日志让差异现场可见,不影响显示。
|
||||
- **页面名表与 DTU 标准表同名下标语义不一致——这是既有事实,当前无运行期风险**。产品视图 `s_yx_name`(`Drivers/BSP/UI/ui_page_yx.c`)的前 33 行是按**旧产品点表**起的名;DTU 标准表同位置(前 59 个单点段中的同一 index)是另一批信号。逐点对照(下标取产品视图行号,DTU 侧取 `App/protocol/iec60870/examples/iec104_dtu_profile.h` 的 `dtu_signals[]` 原始名):
|
||||
|
||||
| 下标 | 产品视图名(页面) | DTU 标准表同下标信号(原名 / 释义) |
|
||||
|---|---|---|
|
||||
| 14 | `故障总` | `Battery bank alarm` / 开闭所(环网箱)蓄电池组告警 |
|
||||
| 15 | `过流Ⅰ段` | `SW00 spare` / 00 开关备用 |
|
||||
| 16 | `过流Ⅱ段` | `SW00 closed` / 00 开关合位信号 |
|
||||
| 17 | `过流Ⅲ段` | `SW00 isolator closed` / 00 手车或隔离开关合位信号 |
|
||||
| 22 | `过载` | `SW00 differential trip` / 00 开关光差保护动作 |
|
||||
| 30 | `保护闭锁` | `SW00 reclose` / 00 开关重合闸 |
|
||||
|
||||
这 6 个下标恰好就是 `FEED_YX_VALID_MASK` 的 6 位(`App/app/ui_data_feed.c` 中的 `FEED_YX_BIT_FAULT_ALL` = 14、`OC1` = 15、`OC2` = 16、`OC3` = 17、`OL` = 22、`LOCK` = 30)——**即"屏上真能变的那 6 行,与标准表同下标信号全不是一回事"**。
|
||||
|
||||
**为什么现在不会错**:这 6 行的值来自保护元件状态(`prot_elm`),**不来自 104 点表**;`yx_valid` 由 `feed_yx()` 按保护判据置位,`feed_yx_dp()` 才去问点表类型,而单点/双点的选词差异对有效行无影响(见上一条)。也就是说点表在这里只提供"单点还是双点",不提供语义。
|
||||
**风险在哪**:将来若有人图省事把 `yx_bits` 改成"直接读 DTU 标准表对应下标",屏上就会出现"过流Ⅰ段"位置显示 00 开关备用之类的**静默错配**——不报错、不越界、像素照常刷新,只有对点的人能发现。真要接标准表,必须先重排产品视图名表并升 `UI_DATA_VER`,不能只换数据源。
|
||||
- **板级开入开出四字段**(`dio_di_*` / `dio_do_*`)四条口径:
|
||||
1. **板级引脚 ≠ 104 点表**:这四字段与 `yx_bits` / `yx_valid` / `yx_dp` 互不引用。板级开入 8 路与点表 33 点没有映射关系,把引脚状态塞进点表位图 = 篡改点表事实(点表 YX1~4 开关位置点在 V0.1 仍恒无效)。
|
||||
2. **读失败语义**:开入经 `ioboard_di_snap_lookup()` → `ioboard_di_snap_read()` 取数(defaultTask 的 DI 去抖快照,`App/util/ioboard_di.h`,写侧按序号协议取一致值,不直接读引脚)。读不到(未登记 / 快照无效 / 读期被持续抢占)时 `dio_di_valid = 0`、mask 沿用**上一次成功读到的值**,绝不填 0——全 0 在现场等于"开入全部复归"。开出只读驱动影子寄存器(`ioboard_do_get()`),零硬件访问。
|
||||
@@ -318,7 +336,7 @@ static void pg_refresh(uint16_t row, char *name, char *value) {
|
||||
- **六个实时页全部接入**。seq 恒随帧前进,所以轮询周期 = 稳态整页重绘频率——可见内容变化越慢取档越大:`ac`/`dc` 300 ms(电气量随 rt 帧帧帧推进;取值账目:轮询不得快于 200 ms 发布节拍、避开 400 ms 与其锁相、300 = 15 × LVGL 整刷周期 20 ms(两端 `LV_DEF_REFR_PERIOD` 同值),最坏屏上滞后 200 + 300 = 500 ms;全文在 `ui_page_ac.c` 的 `AC_AUTO_MS` 注释);`yx` 500 ms(变位低频事件,按"1 s 内上屏"到位——最坏 700 ms,较 300 档少 40% 稳态重绘);`clock` 1000 ms(快变项只有墙钟秒尾,快于 1 s 的轮询只会把同一秒多画几遍);`device_info`/`runreport` 1000 ms 并显式 `.auto_seq = ui_data_info_seq`(`info` 与 `rt` 同拍,见 §5.2)。各页取值账目在该页描述符注释里,本文不复述。
|
||||
- **不迁移**:待机屏 `ui_standby.c`(自持 1 s 整屏定时器 + seq 门控)、整定视图 `ui_w_setview.c`(`sv_poll` 定时器盯 `par` 通道)——两处各自已有节拍,纳入框架只会多一只定时器。
|
||||
|
||||
**回归确定性**:无头模式(`--keys` / 74 张黄金参考)从不跑 `lv_timer_handler`,定时器不可能在截屏前触发,且仿真仍是"一次发布冻结帧"——黄金参考逐字节不变(`check_content_pages.py` 实证)。自动失效路径的验证走开关 `--rtlive <键序> <A.bin> <B.bin>`:开页截 A → 发布第 1 号确定性斜坡帧 → **直接调用** `ui_content_page_auto_poll()`(等价定时器到点)→ 截 B;A≠B 即证明"零按键、新帧落屏"。窗口模式每 200 ms 发一帧斜坡值,屏上数值自己会走。
|
||||
**回归确定性**:无头模式(`--keys` / 76 张黄金参考)从不跑 `lv_timer_handler`,定时器不可能在截屏前触发,且仿真仍是"一次发布冻结帧"——黄金参考逐字节不变(`check_content_pages.py` 实证)。自动失效路径的验证走开关 `--rtlive <键序> <A.bin> <B.bin>`:开页截 A → 发布第 1 号确定性斜坡帧 → **直接调用** `ui_content_page_auto_poll()`(等价定时器到点)→ 截 B;A≠B 即证明"零按键、新帧落屏"。窗口模式每 200 ms 发一帧斜坡值,屏上数值自己会走。
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -294,4 +294,4 @@
|
||||
| 远端推流端到端延迟的完整实验 | `docs/测试说明/专项验证/链路延迟测试说明.md` |
|
||||
| UI 数据供给(快照层) | `docs/UI设计/UI_数据供给设计.md` |
|
||||
| 内容页架构与绘制 | `docs/UI设计/内容页架构.md` |
|
||||
| 远端显示协议 | `docs/UI设计/RemoDispBus协议与接收设计说明.md` |
|
||||
| 远端显示协议 | `docs/UI设计/RemoDispBus协议与接收设计说明.md` |
|
||||
|
||||
@@ -26,7 +26,7 @@ cmake --build simulator/build --config Debug # 0) 构建模拟器(须 0 警
|
||||
| 步 | 脚本/命令 | 门禁内容 | 预期输出 |
|
||||
|---|---|---|---|
|
||||
| 1 | `simulator/tests/check_menu_rows.py` | 菜单 8 状态:选中行白带 / 非选行黑底白字 / 框体 1px 边框 / 往返像素一致(MENU-STATE-03==MENU-STATE-01、MENU-STATE-06==MENU-STATE-01、MENU-STATE-07==MENU-STATE-02)+ MENU-STATE-00 池基线 | `PASS: 8 状态全部断言通过(8 图,池基线 5368 B)` |
|
||||
| 2 | `simulator/tests/check_content_pages.py` | ① 文本级断言(字形模板匹配,正向 484 条 + 反向 45 条,独立于 `ref/`)→ ② 74 张截图与 `ref/` 黄金参考**逐字节**比对 + 开页-关页往返池水位 → ③ `--rtlive` 框架自动失效实证(开交流量页截 A → 发布 1 帧确定性斜坡值 → 直调 `ui_content_page_auto_poll()` → 截 B,A≠B 即 PASS;机制见 `UI_数据供给设计说明.md` §5.5) | `PASS: 74 内容页 + 往返池水位 + rtlive 全部通过`(文本断言先于像素比对,失败即中止) |
|
||||
| 2 | `simulator/tests/check_content_pages.py` | ① 文本级断言(字形模板匹配,正向 484 条 + 反向 45 条,独立于 `ref/`)→ ② 76 张截图与 `ref/` 黄金参考**逐字节**比对 + 开页-关页往返池水位 → ③ `--rtlive` 框架自动失效实证(开交流量页截 A → 发布 1 帧确定性斜坡值 → 直调 `ui_content_page_auto_poll()` → 截 B,A≠B 即 PASS;机制见 `UI_数据供给设计说明.md` §5.5) | `PASS: 76 内容页 + 往返池水位 + rtlive 全部通过`(文本断言先于像素比对,失败即中止) |
|
||||
| 3 | `keil-build` skill(`keil_build.py`) | MCU 端编译(UI 源码双端共用,改一端必须过另一端) | 退出码 0 = BUILD_OK |
|
||||
| 4 | `scripts/check_coding_standard.py` | 代码规范 V1.0 机械检查 | PASS |
|
||||
|
||||
@@ -52,7 +52,7 @@ cmake --build simulator/build --config Debug # 0) 构建模拟器(须 0 警
|
||||
| `POOL_AFTER_ROUNDTRIP` | check_content_pages.py | **5448 B** | 开页-关页往返后水位 = 基线 + 一次性残留 80 B |
|
||||
|
||||
> 水位历史:4784 →(2026-09-14 待机模块常驻 +656)5440 / 5520 →(2026-10-11 裁剪 LVGL 控件类 −72)5368 / 5448。
|
||||
> 后一次漂移已核实为**有意且更优**:像素逐字节未变(**裁剪当时黄金参考只有 11 页**,在裁剪**前**生成、裁剪后全部一致;该集合现已扩至 74 张),
|
||||
> 后一次漂移已核实为**有意且更优**:像素逐字节未变(**裁剪当时黄金参考只有 11 页**,在裁剪**前**生成、裁剪后全部一致;该集合现已扩至 76 张),
|
||||
> 且一次性残留仍是 80 B(5448 − 5368)→ 泄漏特征未变,只是 `lv_theme_apply` 不再为已不存在的控件类登记样式条目。
|
||||
|
||||
**漂移处理**:菜单/页面结构或样式变更导致门禁失败时,先确认新值合理(残留分解见
|
||||
@@ -61,7 +61,7 @@ cmake --build simulator/build --config Debug # 0) 构建模拟器(须 0 警
|
||||
|
||||
## 四、黄金参考(入库)与目检 PNG(本地产物)
|
||||
|
||||
`simulator/tests/ref/*.bin`(像素黄金参考,74 张 × 3200 B)**随仓库入库**;派生的 `.png`
|
||||
`simulator/tests/ref/*.bin`(像素黄金参考,76 张 × 3200 B)**随仓库入库**;派生的 `.png`
|
||||
目检图仍是本地产物(`.gitignore`)。入库的理由:比对是**逐字节**的,基线不入库时任何新克隆
|
||||
或新工作树跑 `ui-golden` 都必然 FAIL(缺基准),这条门禁就只在"有老副本的机器"上真实存在。
|
||||
可复现性实测(2026-10-22):两份各自独立构建的 `lvgl_sim`(不同构建目录、相隔 11 天的代码)
|
||||
@@ -154,7 +154,7 @@ cmake --build simulator/build --config Debug # 0) 构建模拟器(须 0 警
|
||||
### 7.3 用法与门禁档位
|
||||
|
||||
```powershell
|
||||
# 认屏快检:74 张黄金参考(+ 若有台架留档帧),秒级,不需要构建产物
|
||||
# 认屏快检:76 张黄金参考(+ 若有台架留档帧),秒级,不需要构建产物
|
||||
& '.venv\Scripts\python.exe' scripts/board_ui_nav.py --selftest-quick
|
||||
# 完整自检:再加全绑定页闭环导航(需模拟器可执行文件,约 30 s)
|
||||
& '.venv\Scripts\python.exe' scripts/board_ui_nav.py --selftest
|
||||
|
||||
+3
-3
@@ -473,7 +473,7 @@ extern const content_page_def_t ui_page_device_info_desc; /* 描述符(Flash
|
||||
## 八、验证与回归
|
||||
|
||||
- **门禁**(`ui-verify` skill / `UI_自动化测试流程.md`):
|
||||
0) 模拟器构建 0 警告 → 1) 菜单 8 状态像素回归 + 池基线 → 2) 内容页文本断言 + 74 张黄金参考逐字节比对
|
||||
0) 模拟器构建 0 警告 → 1) 菜单 8 状态像素回归 + 池基线 → 2) 内容页文本断言 + 76 张黄金参考逐字节比对
|
||||
(网口设置 4 态 + 密码页 4 态等)+ 开页-关页往返水位 → 3) Keil 构建 0 错 0 警 → 4) 代码规范检查
|
||||
- **门禁常量**(脚本头部):`MENU_POOL_BASELINE = 5368 B`、`POOL_AFTER_ROUNDTRIP = 5448 B`
|
||||
- **失败处置**:像素不一致 = 代码 bug(修代码,**禁止**刷参考掩盖);**有意**改视觉 →
|
||||
@@ -531,6 +531,6 @@ YYYY-MM-DD HH:MM:SS ← 底部实时时钟(每秒重绘)
|
||||
| 2026-10-27 | 内容页黄金参考 **47 → 53 页**(通讯设置页落地并绑 `#page=comm`;判据 = `simulator/tests/ref/` 入库 `shot_*.bin` 实数 53 张,`git diff --name-status 31ca4a1f HEAD -- simulator/tests/ref` 实测只有 6 个 `A`、零 `M` ⇒ 存量 47 张逐字节零漂移);本文件的当前态计数已同步 |
|
||||
| 2026-10-26 | 验证与回归段的页数口径修正为 **27 页**黄金参考(`simulator/tests/ref/` 入库 27 个 `shot_*.bin`,含整定 9 态);上方变更记录里的「11 页」是当时事实不动 |
|
||||
| 2026-10-26 | 门禁常量修正为 5368 B / 5448 B(= 两个回归脚本头部现值);本文件正文表早已是 5368/5448,只这一处残留 2026-10-11 裁剪 LVGL 控件类之前的 4784/4864 |
|
||||
| 2026-11-13 | 五个实时页接入框架自动失效(task-3,用户裁定全接):`dc` 300 / `yx` 500 / `clock` 1000(rt 通道)与 `device_info` / `runreport` 1000 + `.auto_seq = ui_data_info_seq`(info 通道,`info` 与 `rt` 同拍 200 ms)描述符加 `.auto_ms`,取值账在各页注释;§三 字段表与 §六 内存表同步;实测黄金参考 74 张、往返水位 5448 B、菜单基线 5368 B 均不动(无头从不跑 `lv_timer_handler`) |
|
||||
| 2026-11-13 | 五个实时页接入框架自动失效(task-3,用户裁定全接):`dc` 300 / `yx` 500 / `clock` 1000(rt 通道)与 `device_info` / `runreport` 1000 + `.auto_seq = ui_data_info_seq`(info 通道,`info` 与 `rt` 同拍 200 ms)描述符加 `.auto_ms`,取值账在各页注释;§三 字段表与 §六 内存表同步;实测当时黄金参考 74 张、往返水位 5448 B、菜单基线 5368 B 均不动(无头从不跑 `lv_timer_handler`) |
|
||||
| 2026-10-26 | 验证与回归段的黄金参考页数 **27 → 40 页**(UI 三页落地后 `simulator/tests/ref/` 实数 40 张);上方变更记录里的 11 / 27 是各当时下限,保留 |
|
||||
| 2026-11-13 | 框架级自动失效(task-2):描述符尾部新增 `auto_ms`/`auto_seq`(当前仅 ac 页启用 300 ms),新增框架 API `ui_content_page_auto_poll()`(§3.1);§3.1 静态块与代码同步(补 `s_perm` 与自动失效 2 变量);回归脚本新增 `--rtlive` 零按键落屏检查(74 张黄金参考逐字节不变,实测 PASS);机制详述在 `UI_数据供给设计说明.md` §5.5 |
|
||||
| 2026-11-13 | 框架级自动失效(task-2):描述符尾部新增 `auto_ms`/`auto_seq`(当前仅 ac 页启用 300 ms),新增框架 API `ui_content_page_auto_poll()`(§3.1);§3.1 静态块与代码同步(补 `s_perm` 与自动失效 2 变量);回归脚本新增 `--rtlive` 零按键落屏检查(当时 74 张黄金参考逐字节不变,实测 PASS);机制详述在 `UI_数据供给设计说明.md` §5.5 |
|
||||
|
||||
@@ -156,6 +156,8 @@ V0.1 **无直流采样通道**(`ADC_SEM` 只有 8 路电气 + 温度),点
|
||||
|
||||
#### 3.1.3 遥信量(新建)
|
||||
|
||||
> **⚠ 2026-11-17 割接后:"33 点表"已不是协议点表;协议侧现为 DTU 标准表 75 个遥信点(SP 59 + DP 16),33 为产品 UI 视图行数。本节以下为立项时原文,保留不动。**
|
||||
|
||||
33 点表,但只有 6 点有硬件来源(`YX_VALID_MASK`:YX15/16/17/18/23/31)。
|
||||
|
||||
| 方案 | 行表 | 优点 | 缺点 |
|
||||
@@ -182,7 +184,7 @@ V0.1 **无直流采样通道**(`ADC_SEM` 只有 8 路电气 + 温度),点
|
||||
| 31~33 | `闭锁1~3` | 31 ✅ | 其余 `--` |
|
||||
|
||||
- 名表放页面侧(Flash const),**不进快照**——显示文案属表现层(`docs/UI设计/UI_数据供给设计.md` §8)。
|
||||
- 双点遥信 4 点用 `iec104_pts_yx_is_dp()` 决定是否显示"分/合",当前恒无效。
|
||||
- 双点遥信 4 点用 `iec104_pts_yx_is_dp()` 决定是否显示"分/合",当前恒无效。(注:`iec104_pts` 实现已于 2026-11-17 割接删除,此处为立项时方案原文)
|
||||
- 规模:**M**(33 行名表 + `refresh` + 值映射,约 150 行)。
|
||||
|
||||
> **落地注(2026-10-25 道E task-15 批 4)**:已按方案 A 落地为 `Drivers/BSP/UI/ui_page_yx.c`
|
||||
@@ -349,15 +351,15 @@ V0.1 **无直流采样通道**(`ADC_SEM` 只有 8 路电气 + 温度),点
|
||||
|
||||
### 3.3 三遥设置(5 页,阻塞于 `run_par`)
|
||||
|
||||
**现状**:死区是**编译期常量**——`App/protocol/iec104/iec104_pts.c` 的 `k_yc[].deadband`(第 244 行 `if (d > k_yc[i].deadband)`)。其余四项(系数/类型/防抖/双点)在固件里**完全没有对应结构**。
|
||||
**现状**:死区是**编译期常量**——`App/protocol/iec104/iec104_pts.c` 的 `k_yc[].deadband`(第 244 行 `if (d > k_yc[i].deadband)`)。其余四项(系数/类型/防抖/双点)在固件里**完全没有对应结构**。(注:`iec104_pts` 实现已于 2026-11-17 割接删除,此处为立项时方案原文;引用的源码行号随之失效)
|
||||
|
||||
**所以这 5 页不是页面工作,是一个参数模型工作。**
|
||||
|
||||
| 页 | 项数 | 数据模型 | 消费方 |
|
||||
|---|---|---|---|
|
||||
| 遥测死区 | 9 | `run_par.deadband[9]`(float,工程量) | `iec104_pts_cov_check`(替换 `k_yc[].deadband`) |
|
||||
| 遥测系数 | 9 | `run_par.gain[9]`(Q10 微调,1.000 基准) | `iec104_pts_yc_read`(乘在 fAmSQ 上) |
|
||||
| 遥信类型 | 33 | `run_par.yx_type[33]`(单点/双点/常闭) | `iec104_pts` 的 `M_SP`/`M_DP` 选择 |
|
||||
| 遥测死区 | 9 | `run_par.deadband[9]`(float,工程量) | `iec104_pts_cov_check`(替换 `k_yc[].deadband`)<br>(注:`iec104_pts` 实现已于 2026-11-17 割接删除,此处为立项时方案原文) |
|
||||
| 遥测系数 | 9 | `run_par.gain[9]`(Q10 微调,1.000 基准) | `iec104_pts_yc_read`(乘在 fAmSQ 上)<br>(注:`iec104_pts` 实现已于 2026-11-17 割接删除,此处为立项时方案原文) |
|
||||
| 遥信类型 | 33 | `run_par.yx_type[33]`(单点/双点/常闭) | `iec104_pts` 的 `M_SP`/`M_DP` 选择<br>(注:`iec104_pts` 实现已于 2026-11-17 割接删除,此处为立项时方案原文) |
|
||||
| 遥信防抖 | 33 | `run_par.yx_debounce[33]`(ms) | 开入采集(尚未实现,**当前无消费方**) |
|
||||
| 双点遥信 | 4 | `run_par.dp_map[4]`(虚端子映射) | 开入采集(同上) |
|
||||
|
||||
@@ -442,7 +444,7 @@ int run_par_set_deadband(uint8_t yc_idx, float v); /* 范围校验 */
|
||||
| 保护告警 | 同上 | `asserted` 上升沿 **且** `*_TRIP` = 0 |
|
||||
| 保护启动 | 同上(新增 `picked` 边沿检测) | `picked` 上升沿 |
|
||||
| 操作记录 | 定值保存成功 / 强制复归 / 时钟设置 / 清除记录(4 处) | 动作成功后写一条 |
|
||||
| 遥控记录 | `iec104_pts_yk_exec()` 返回处 | 每次执行结果(成功/失败/选择态) |
|
||||
| 遥控记录 | `iec104_pts_yk_exec()` 返回处(注:`iec104_pts` 实现已于 2026-11-17 割接删除,此处为立项时方案原文) | 每次执行结果(成功/失败/选择态) |
|
||||
|
||||
> **本表只是页面侧的需求清单**(记录页要消费哪几类),**不是记录层的登记表**:
|
||||
> 5 个 ID 的定名、记录格式、条数与字节上限、写入时机、以及是否真的落地,一律以
|
||||
@@ -626,7 +628,7 @@ SNTP 客户端 ──────→ 批4 SNTP设置
|
||||
| 4 | 无源点显示 `--` | 遥信量无效点、直流量直流通道 |
|
||||
| 5 | 定值整定闭环 | 改 → 保存 → 重启 → 值保持 + 校验和自检通过 + 主站 C_RD 一致。**2026-10-26 半收口**:模拟器侧「改 → 保存 → `OK` → 回首屏新值已在帧里」与「越界被拒、值不落盘」已由像素 + 文本断言覆盖(`sparam_save` / `sparam_landed` / `sparam_oob`);**重启保持与 C_RD 一致只能上板**(模拟器无 NAND)。另注意 40 项里 **13 项 `comm_addr = 0`**(投退、返回系数、过频/低频段、全局软压板)主站不可寻址,不能拿 C_RD 当它们的判据 |
|
||||
| 6 | 分层门禁无新增 | `check_layer_deps.py` 退出码 0,基线 6 → 3。**现状:3**(记录 reader 已削 3 条;写路径走注入式 ops 函数表,未新增 include,见 `docs/UI设计/UI_数据供给设计.md` §6.2) |
|
||||
| 7 | 像素回归稳定 | `ui-golden` 连续两次零差异。**已验(2026-10-26)**:27 页连跑两次逐字节一致——**该下限此后已扩至 66 张**(新增 clock / reset / clear 系列 13 张,其后 47→53→60→66,2026-10-29 录波 UI 道 +6 张),66 张上的双次逐字节一致**已验(2026-10-29:任务树重建模拟器后同一批 66 张连跑三次逐字节一致,页面池水位 5,448 B;菜单侧 `check_menu_rows.py` 8 状态连跑三次亦逐字节一致,5,368 B;三次之间未用更新模式写过任何参考图,故这是同口径的传递性证据)**。集合其后扩至 74 张——2026-11-13 按同口径跑过 74 张零差异(task-3 五页接自动刷新,无头不跑 `lv_timer_handler`,往返水位 5,448 B / 菜单 5,368 B 均不动) |
|
||||
| 7 | 像素回归稳定 | `ui-golden` 连续两次零差异。**已验(2026-10-26)**:27 页连跑两次逐字节一致——**该下限此后已扩至 66 张**(新增 clock / reset / clear 系列 13 张,其后 47→53→60→66,2026-10-29 录波 UI 道 +6 张),66 张上的双次逐字节一致**已验(2026-10-29:任务树重建模拟器后同一批 66 张连跑三次逐字节一致,页面池水位 5,448 B;菜单侧 `check_menu_rows.py` 8 状态连跑三次亦逐字节一致,5,368 B;三次之间未用更新模式写过任何参考图,故这是同口径的传递性证据)**。集合其后扩至 74 张(当时值)——2026-11-13 按同口径跑过 74 张零差异(task-3 五页接自动刷新,无头不跑 `lv_timer_handler`,往返水位 5,448 B / 菜单 5,368 B 均不动) |
|
||||
| 8 | 每个新页有 golden 参考 | `simulator/tests/ref/` 新增对应 `.bin`。**整定 4 页已有 9 张**(含保存/越界/落定/回绕各态);参考图入库,改它 = 改判据,须逐页过目 |
|
||||
|
||||
---
|
||||
|
||||
+1
-1
@@ -17,7 +17,7 @@
|
||||
| 已绑内容页叶子 | **27**;注册表 `UI_PAGE_MAP_COUNT` = 31,差额 4 为「查看/整定」两组叶子的两态复用带来的映射条目 | `Drivers/BSP/UI/ui_page_registry.h` |
|
||||
| 未绑叶子 | **3**(遥信类型 / 遥信防抖 / 双点遥信) | `ui_menu_tree.txt` |
|
||||
| `ui_page_*.c` 源文件 | **30**(含 registry 与密码页两个非节点页) | `Drivers/BSP/UI/` |
|
||||
| 像素黄金参考 | **74 张**(`simulator/tests/ref/shot_*.bin`) | 同目录实数 |
|
||||
| 像素黄金参考 | **76 张**(`simulator/tests/ref/shot_*.bin`) | 同目录实数 |
|
||||
|
||||
> 口径:叶子判定 = 无更深缩进后继者;已绑判定 = 该行带 `#page=`。复核方法与 `docs/UI设计/菜单页面设计.md` §3.9 一致。
|
||||
|
||||
|
||||
@@ -629,7 +629,7 @@ flowchart LR
|
||||
上电次数 + 本次复位原因快照)与 iec104_serv 的四个只读观测计数,经 info 帧下发
|
||||
(口径 docs/UI设计/UI_数据供给设计.md §4.4)。
|
||||
- 判据:五类记录各有写入点、可翻最近 20 条、空记录明确显示"无记录"、共用 reader——**软件面已满足**
|
||||
(空态与四个范围标签由 74 张像素黄金钉住;模拟器侧这些文件没有写入方,只拍到空态)。
|
||||
(空态与四个范围标签由 76 张像素黄金钉住;模拟器侧这些文件没有写入方,只拍到空态)。
|
||||
真记录翻页、掉电后保持(复位代理口径)、清除记录后归零、boot_count 自增、rst_cause=IWDG、
|
||||
conn_up +1 **已于 2026-11-06 Issue #53 台架轮实机复核通过**;四态判定中「拔 RTC 电池落
|
||||
RESTARTED」经用户裁定(2026-11-05)台架不可验销项(证据与口径见 Issue #53 与
|
||||
@@ -1620,7 +1620,7 @@ pre-commit run --all-files
|
||||
- 菜单导航状态**不压层**,返回即原样还原;同一时刻至多一个内容页打开。
|
||||
- 节点→页映射在逻辑层 `menu_content_page_for(node)`;未绑叶子进入空白终点框(不伪造数据)。
|
||||
- 数据供给走**注入通道**(rt / par / info / 遥测死区与系数第四表),页面不直接触算法层;
|
||||
像素黄金用例当前 **74 张**(菜单 8 状态另计;2026-10-28 记录 5 页与运行报告 2 页落地 +7 张;2026-10-29 录波 UI 道 6 张:手动录波 3 态 + 录波回放 3 态;2026-11-04 SNTP 设置页 +8 张)。
|
||||
像素黄金用例当前 **76 张**(菜单 8 状态另计;2026-10-28 记录 5 页与运行报告 2 页落地 +7 张;2026-10-29 录波 UI 道 6 张:手动录波 3 态 + 录波回放 3 态;2026-11-04 SNTP 设置页 +8 张;2026-11-16 DI/DO 状态页 +2 张;同日 DI/DO fold 进遥信页,删 2 加 2 净 0。即 74+2+0=76)。
|
||||
|
||||
### 8.4 密码与权限
|
||||
|
||||
|
||||
@@ -15,7 +15,7 @@ cppcheck 是开源 C/C++ 静态分析工具,**不运行代码**,通过语法
|
||||
|
||||
### 日常速度
|
||||
|
||||
- **提交期**:不跑(`stages: [manual]`),一次带代码的 `git commit` 只跑 49 根快钩子
|
||||
- **提交期**:不跑(`stages: [manual]`),一次带代码的 `git commit` 只跑 48 根快钩子(pre-commit 阶段 47 + `gitlint`)
|
||||
- **全库扫描**(约 20 s;2026-10-28 实测 `cppcheck` 20.5 s、`test-cppcheck` 38.1 s):手工复跑 `& '.venv\Scripts\python.exe' -m pre_commit run --all-files --hook-stage manual <hook-id>`——**一次只能给一个 id**(`pre_commit run a b c` 实测报 `unrecognized arguments`),故 `cppcheck` / `test-cppcheck` 各跑一次
|
||||
|
||||
---
|
||||
|
||||
@@ -39,7 +39,7 @@ git commit
|
||||
|
||||
> **CI 侧的同一套门禁(2026-10-01 起)**:Gitea Actions(`.gitea/workflows/ci.yml`)在 push / PR 时
|
||||
> 以 `pre-commit run --all-files` 复跑 **`pre-commit` 阶段的 47 根**(`mem-numbers` 在无 Keil `.map` 的 runner 上自适应跳过),
|
||||
> 再以「手动阶段门禁」步**逐根** `--hook-stage manual` 复跑 `cppcheck` / `test-cppcheck` / `test-coverage` 三根
|
||||
> 再以「手动阶段门禁」步**逐根** `--hook-stage manual` 复跑 `cppcheck` / `test-cppcheck` / `test-coverage` 三根(本地还有第四根 `iec104-tcp`,需模拟器产物)
|
||||
> (`pre_commit run a b c` 不支持多 id,实测报 `unrecognized arguments`)。
|
||||
> 本地提交前想跑同一套判定:`& '.venv\Scripts\python.exe' scripts/ci_local.py`。详见 `../测试说明/流程与规范/测试开发标准流程.md` §9。
|
||||
|
||||
@@ -93,7 +93,7 @@ git commit
|
||||
|
||||
| 机制 | 口径 |
|
||||
|---|---|
|
||||
| **三个阶段** | pre-commit 阶段 **48** 个钩子 + commit-msg 阶段 `gitlint`(= 一次 `git commit` 实跑 **49**)+ `manual` 阶段 3 根(`cppcheck` / `test-cppcheck` / `test-coverage`:`git commit` 不跑,只在远端 CI 的「手动阶段门禁」步与 `scripts/ci_local.py` 的 manual 段跑;三根实测合计约 165 s ≈ 一次带代码提交耗时的三分之二)→ 口径 = YAML 解析后的 hook 条目数 **51**;自查命令与「声明 / 文档 / 实跑」三数同源核对 → `docs/门禁说明/README.md` §2;`default_install_hook_types: [pre-commit, commit-msg]` 是显式声明的——换机后 `pre-commit install` 才会带上 commit-msg 钩子 |
|
||||
| **三个阶段** | pre-commit 阶段 **47** 个钩子 + commit-msg 阶段 `gitlint`(= 一次 `git commit` 实跑 **48**)+ `manual` 阶段 4 根(`cppcheck` / `test-cppcheck` / `test-coverage` / `iec104-tcp`:`git commit` 不跑,只在远端 CI 的「手动阶段门禁」步与 `scripts/ci_local.py` 的 manual 段跑;前三根实测合计约 165 s ≈ 一次带代码提交耗时的三分之二,`iec104-tcp` 另需模拟器构建产物)→ 口径 = YAML 解析后的 hook 条目数 **52**;自查命令与「声明 / 文档 / 实跑」三数同源核对 → `docs/门禁说明/README.md` §2;`default_install_hook_types: [pre-commit, commit-msg]` 是显式声明的——换机后 `pre-commit install` 才会带上 commit-msg 钩子 |
|
||||
| **一根钩子在输出里出现两次** | 未声明 `stages:` 的钩子**默认属于所有阶段**,pre-commit 与 commit-msg 两遍都会列出它;第二遍的"文件"是提交信息文件,几乎必然 `(no files to check)Skipped`。**只看输出结尾会把"实跑通过"读成"没跑"**——判某钩子跑没跑要认它**第一次**出现的那行(实测 2026-10-24:只改 `.pre-commit-config.yaml` 的提交里 `test-coverage` 与 `bsp-err` 都是 Passed,尾巴那一遍是 Skipped) |
|
||||
| **stash 陷阱** | pre-commit 跑钩子前会 stash 未暂存改动,钩子看到的是"没有你中间状态"的树。**改代码 + 同时更新基线/受管区的,必须先 `git add` 再跑钩子**,否则会拿到假报警(本仓踩过,`docs/门禁说明/bsp-err.md` §4 记了现场)。**它藏不住什么,见下一行** |
|
||||
| **stash 覆盖面:只覆盖已跟踪文件的未暂存改动**(2026-10-26 读源码定案,**对所有钩子通用**) | 机制在 pre-commit 的 `staged_files_only._unstaged_changes_cleared()`:`git diff-index <tree>` 取补丁 → `git checkout -- .` → 跑完 `git apply` 还原。所以「钩子实跑 = 只看到 HEAD + 本笔 staged」这句**对已跟踪文件成立、对未跟踪文件不成立**:未跟踪文件压根不在 `diff-index` 里,**不会被藏**;`git add -N`(intent-to-add)也救不了——pre-commit 只 `git rm --cached` 把它撤下索引(`_intent_to_add_cleared()`),**文件本体仍在盘上**。后果:别人写了尚未入库的文件(新页面实例 / 新单测目录 / 新文档)躺在树里时,**任何一笔碰到该文件所属钩子 `files:` 的提交都会被这份半成品拖红**——红的内容没错,但账不该记在这笔提交上。实测:`ui_page_clock.c`、`ui_page_reset.c` 处于未跟踪且未绑 `#page` 期间,`generated-fresh` 对**所有人**的 UI 提交都会 FAIL(现场日志 `docs/门禁说明/generated-fresh.md` §6 第 8 条)。三条结论:① 提交排序——会让全树变红的半成品要么先落地(绑引用 + 重跑生成器)要么先挪出工作树;② 凡「判定基准取工作区」的钩子(重跑比对类、全库统计类)在多人同树下必须配**静默窗口**;③ 真要 `--no-verify` 抢跑,正文必须点名是哪几个**未跟踪**文件拖的红,别让它被读成「钩子不可信」 |
|
||||
@@ -137,7 +137,7 @@ git commit
|
||||
| BOM 漂移 | `& '.venv\Scripts\python.exe' scripts/check_bom_drift.py --all` | HEAD 有 BOM 而工作区没有 → 1;⚠ **别用「有 BOM 就是错」的外行判据**——`Drivers/BSP/UI/*`、`App/task/ui_task.c` 等本就该带 BOM(名单与理由 → `docs/文档规范.md` §2;本文件 §2.2) |
|
||||
| 乱码 U+FFFD | `& '.venv\Scripts\python.exe' scripts/check_mojibake.py <本笔文件>` | 出现即 1 |
|
||||
| **字节卫生 = 改写型钩子的只读等价** | 下面的一行式 + `git diff --check` | 一次查完**待提交清单(含未跟踪新文件)**的 CR / 缺尾换行 / U+FFFD / 行尾空格,全程不写盘 |
|
||||
| 受影响模块的主机单测 | `& '.venv\Scripts\python.exe' test/host/<模块>/run_unit_test.py` | 只跑你碰的那几套;**改过骨架** `test/host/common/unit_test_harness.py` 就要跑全套(等价 22 根钩子同时触发) |
|
||||
| 受影响模块的主机单测 | `& '.venv\Scripts\python.exe' test/host/<模块>/run_unit_test.py` | 只跑你碰的那几套;**改过骨架** `test/host/common/unit_test_harness.py` 就要跑全套(等价 21 根钩子同时触发) |
|
||||
| 全量单测 + 覆盖率 | `& '.venv\Scripts\python.exe' scripts/check_test_coverage.py` | 0=全过且覆盖率未回退 / 1=有失败或回退 / 2=环境(缺 `cl.exe` / mscoverage) |
|
||||
| 编号 | `& '.venv\Scripts\python.exe' scripts/archive/id_gate/check_ids.py --strict` | 增量拦截:台账之外新错即 1;顺带核「可判定比例」与「不可判定绝对数」两行(2026-10-26 余量只剩 12 处) |
|
||||
| 文档链接与章节 | `& '.venv\Scripts\python.exe' scripts/check_doc_links.py --all` | 0 通过 / 1 有问题(钩子还多带 `--sections-strict`) |
|
||||
@@ -163,7 +163,7 @@ git commit
|
||||
| **改写型钩子** `trailing-whitespace` / `end-of-file-fixer` | 它们会**改文件**。真提交里改的是 stash 之后的树;而手跑 `--files` **不 stash**(§2.2 那两行),直接落在工作区——**列了别人在飞的文件就等于替人改文件** | 只列自己的文件:`-m pre_commit run <id> --files <自己的文件>`;或先用 A 组的一行式查出问题自己修,别让钩子替你动盘 |
|
||||
| **要靠 stash 才能正确归因**的判定:`mem-numbers` / `mem-budget`(读磁盘 `.map`)、`stack_report`(读磁盘 `.htm`)、`ui-golden` / `uinav-selftest`(要模拟器 exe 与台架锁)、`test-coverage`(会编译,可能撞别人的 `.obj`) | 磁盘上的 `.map` / `.htm` / `.exe` 属于**最后一次构建的人**,不是你的 ⇒ 手跑红常常是替别人背账(今天 `mem-budget` 就红在「台账与 `.map` 不同码」,因为 `.map` 里混着三条在飞源码道) | **照样要跑**(宁可多跑),但**红先归因**:`git status --porcelain` 看是谁在飞、`.htm` 的时间戳是哪次构建;确认不属本笔就在提交正文点名,**不要改基线数字去凑绿** |
|
||||
| **只有真提交才会碰到的面**:`gitlint`(commit-msg 阶段)与未声明 `stages:` 会跑两遍的钩子 | 手跑脚本查不到提交信息规范(标题 ≤100、**正文每行 ≤80**) | 提交信息一律 `git commit -F <UTF-8 无 BOM 文件>` 并自查最长行;或先老实提交一次让 `gitlint` 说话,再改成 `--no-verify` |
|
||||
| **`manual` 阶段的三根**(`cppcheck` / `test-cppcheck` / `test-coverage`) | `pre-commit run --all-files` 只跑 `pre-commit` 阶段(47 根),**不会碰它们**——漏跑不会报红,只会静默少一道门禁 | 抢跑时补:`& '.venv\Scripts\python.exe' -m pre_commit run --all-files --hook-stage manual <hook-id>`,一次一个 id(见 §2.2「三个阶段」行) |
|
||||
| **`manual` 阶段的四根**(`cppcheck` / `test-cppcheck` / `test-coverage` / `iec104-tcp`) | `pre-commit run --all-files` 只跑 `pre-commit` 阶段(47 根),**不会碰它们**——漏跑不会报红,只会静默少一道门禁 | 抢跑时补:`& '.venv\Scripts\python.exe' -m pre_commit run --all-files --hook-stage manual <hook-id>`,一次一个 id(见 §2.2「三个阶段」行) |
|
||||
|
||||
#### C. 抢跑之后(三条都来自今天的真事,不是设想)
|
||||
|
||||
@@ -266,7 +266,7 @@ git commit -m "紧急修复" --no-verify
|
||||
SKIP=cppcheck git commit -m "紧急修复"
|
||||
```
|
||||
|
||||
> ⚠️ **不推荐**:`--no-verify` 一次跳过 47 条(连 `gitlint` 一起 = 48 条;manual 阶段三根本来不随提交跑),不是「跳过格式检查」。**跳之前必须先跑 §2.4 抢跑自查表**
|
||||
> ⚠️ **不推荐**:`--no-verify` 一次跳过 47 条(连 `gitlint` 一起 = 48 条;manual 阶段四根本来不随提交跑),不是「跳过格式检查」。**跳之前必须先跑 §2.4 抢跑自查表**
|
||||
> (尤其 `stack_report.py`——它不在钩子清单里,只有人会跑;数字与安全边界类问题不会自己冒出来)。跳之后按 §2.4 C 组
|
||||
> 补齐三件事:`git status` 对交付清单、正文点名「哪些没跑 / 为什么 / 谁在飞」、静默窗口补一次 `run --all-files`。
|
||||
|
||||
@@ -332,7 +332,7 @@ $env:PATH = [Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [Env
|
||||
|
||||
| 文件 | 位置 | 说明 |
|
||||
|---|---|---|
|
||||
| `.pre-commit-config.yaml` | 仓库根 | 钩子配置(**52 个钩子**声明数,一次 `git commit` 实跑 49 根;口径 = YAML 解析后的 hook 条目数,自查命令 → `docs/门禁说明/README.md` §2。声明数与一次提交的实跑数分列,勿混写;计数改动的完整台账只记在 `docs/门禁说明/README.md` §2,本行不重述)。逐项详解在 `docs/门禁说明/`(索引 `docs/门禁说明/README.md`;主机侧单测 **22 根**合一篇,含各套件来历与「22 套无专属钩子」台账(现值 2026-10-29) `docs/门禁说明/host-unit-tests.md` §6;UI 侧另有 `font-charset` 与 `ui-golden` 两篇) |
|
||||
| `.pre-commit-config.yaml` | 仓库根 | 钩子配置(**52 个钩子**声明数,一次 `git commit` 实跑 48 根 = pre-commit 阶段 47 + `gitlint`;口径 = YAML 解析后的 hook 条目数,自查命令 → `docs/门禁说明/README.md` §2。声明数与一次提交的实跑数分列,勿混写;计数改动的完整台账只记在 `docs/门禁说明/README.md` §2,本行不重述)。逐项详解在 `docs/门禁说明/`(索引 `docs/门禁说明/README.md`;主机侧单测 **21 根**合一篇,含各套件来历与「22 套无专属钩子」台账(套数为 2026-10-30 复点值) `docs/门禁说明/host-unit-tests.md` §6;UI 侧另有 `font-charset` 与 `ui-golden` 两篇) |
|
||||
| `.gitlint` | 仓库根 | gitlint 规则(宽松,兼容中文) |
|
||||
| `.cubemx_survival_baseline.json` | 仓库根 | CubeMX 易失定制基线(哈希;`--write` 重建) |
|
||||
| `scripts/check_mojibake.py` | scripts/ | U+FFFD 检测脚本 |
|
||||
|
||||
@@ -47,10 +47,10 @@ dhara 失败类 +84;RO 另 +208,全是该失败类名表)→ `ER_IROM1`
|
||||
<!-- MEM_SNAPSHOT:BEGIN generated by scripts/check_mem_numbers.py -->
|
||||
| 区域 | 用量 | 容量 | 占比 |
|
||||
|---|---|---|---|
|
||||
| ER_IROM1 | 289,800 B (283.01 KB) | 1,048,576 B (1024 KB) | 27.6% |
|
||||
| RW_IRAM1 | 97,368 B (95.09 KB) | 131,072 B (128 KB) | 74.3% |
|
||||
| ER_IROM1 | 415,956 B (406.21 KB) | 1,048,576 B (1024 KB) | 39.7% |
|
||||
| RW_IRAM1 | 118,408 B (115.63 KB) | 131,072 B (128 KB) | 90.3% |
|
||||
| RW_CCM | 57,376 B (56.03 KB) | 65,280 B (64 KB) | 87.9% |
|
||||
| **Flash (ROM 合计)** | **291,904 B (285.1 KB)** | 1,048,576 B (1024 KB) | **27.8%** |
|
||||
| **Flash (ROM 合计)** | **418,244 B (408.4 KB)** | 1,048,576 B (1024 KB) | **39.9%** |
|
||||
<!-- MEM_SNAPSHOT:END -->
|
||||
|
||||
各区的容量与常量来源:
|
||||
|
||||
@@ -15,19 +15,19 @@
|
||||
<!-- MEM_BUDGET:BEGIN generated by scripts/ram_baseline.py -->
|
||||
| 区域 | 用量 | 容量 | 占比 | 门禁(≤92%) |
|
||||
|---|---|---|---|---|
|
||||
| ER_IROM1 (Flash) | 288,628 B | 1,048,576 B | 27.5% | 参考 |
|
||||
| ER_IROM1 (Flash) | 415,956 B | 1,048,576 B | 39.7% | 参考 |
|
||||
| RW_CCM | 57,376 B | 65,280 B | 87.9% | PASS |
|
||||
| UNINIT_CCM | 48 B | 256 B | 18.8% | 参考 |
|
||||
| RW_IRAM1 | 97,248 B | 131,072 B | 74.2% | PASS |
|
||||
| RW_IRAM1 | 118,408 B | 131,072 B | 90.3% | PASS |
|
||||
|
||||
| 子系统(静态 RW+ZI;除 RTOS 堆在 CCM 外均在 SRAM1) | 现值 | 配额 | 状态 |
|
||||
|---|---|---|---|
|
||||
| 网络 | 13,958 B | 12 KB | ⚠ 超 1.6 KB |
|
||||
| 网络 | 13,966 B | 12 KB | ⚠ 超 1.6 KB |
|
||||
| 存储 | 9,144 B | 12 KB | OK |
|
||||
| UI | 36,731 B | 16 KB | ⚠ 超 19.9 KB |
|
||||
| UI | 36,791 B | 16 KB | ⚠ 超 19.9 KB |
|
||||
| RTOS 堆 | 57,376 B | 56 KB | 堆=配额 |
|
||||
| 应用 | 26,609 B | 8 KB | ⚠ 超 18.0 KB |
|
||||
| 其它 | 10,792 B | — | 参考 |
|
||||
| 应用 | 47,699 B | 8 KB | ⚠ 超 38.6 KB |
|
||||
| 其它 | 10,795 B | — | 参考 |
|
||||
<!-- MEM_BUDGET:END -->
|
||||
|
||||
- **门禁**:pre-commit `mem-budget` 钩子(`scripts/ram_baseline.py --gate`)——
|
||||
|
||||
@@ -93,7 +93,7 @@
|
||||
|
||||
**明确推荐**:经逐项批准后,由 netTask 直接运行无线程循环驱动(threadless)的共享核心与仅属主可用的短时尝试式硬件接口(try-BSP);参数耐久提交、时钟落地和文件快照交各自实际属主异步完成。禁止在 netTask 调公开网络 RPC(远程过程调用式队列请求)等待自身,禁止在网络循环内做文件系统操作或等保存结果。此路线复用成熟协议状态机,不增加另一套 TCP 协议实现。
|
||||
|
||||
**实施前提**:先以隔离探针证明精确待收快照、会话代次、监听/数据句柄分离、短写、尾数据和关闭释放;还须核实禁用小包延迟(NODELAY)的真实等效能力。参数、时钟及 Type210 文件业务要新增保持线上格式的“开始/完成/取消/释放”异步生命周期;当前同步回调不能入队后返回已应用,也不能把文件读取 false 当暂忙。所有候选接口仍未实现。
|
||||
**实施前提**:先以隔离探针证明精确待收快照、会话代次、监听/数据句柄分离、短写、尾数据和关闭释放。禁用小包延迟已核实为平台偏离:CH395F 与网络层没有配置 TCP_NODELAY 的接口,等效为链路恒无 Nagle 延迟,板端不把它列为成功条件。参数、时钟及 Type210 文件业务要新增保持线上格式的“开始/完成/取消/释放”异步生命周期;当前同步回调不能入队后返回已应用,也不能把文件读取 false 当暂忙。所有候选接口仍未实现。
|
||||
|
||||
**不推荐的当前替代**:保留 iec104Task 加普通跨任务邮箱,在现接口下无法保持精确待收快照和超时先后边界;阻塞 RPC 更不可接受。若主推荐的栈、时限或硬件契约不能成立,暂停实施并申请实质性异步输入切片/调度合同改造,不能自动切到一个未证明的后备方案。
|
||||
|
||||
@@ -130,7 +130,7 @@
|
||||
|
||||
| 待逐项批准的变化 | 明确推荐与批准前提 | 不批准时的处置 |
|
||||
|---|---|---|
|
||||
| 协议运行属主与网络驱动 | netTask 循环驱动核心并新增属主专用 try-BSP;精确待收、NODELAY、栈/时限探针先证明 | 停在规划/探针,不用阻塞 RPC 或薄包装顶替 |
|
||||
| 协议运行属主与网络驱动 | netTask 循环驱动核心并新增属主专用 try-BSP;精确待收、栈/时限探针先证明。NODELAY 为已核实平台偏离,不作成功条件 | 停在规划/探针,不用阻塞 RPC 或薄包装顶替 |
|
||||
| 库业务异步生命周期 | 参数、校时、Type210 引入开始/完成/取消/释放;保持线上格式与 APPLIED 真实完成含义 | 不能接纳后先肯定再后台保存 |
|
||||
| 规范参数模型与全部读者接缝 | 一个权威提交代次,保护/运行/标定/UI 同代次读取,旧配置文件为派生镜像 | 不声称整批原子;不并列多份可写真源 |
|
||||
| 持久化布局、恢复与故障域 | 优先预分配短名冗余副本及独立提交记录,先界定掉电与卷故障保证;布局/版本迁移逐项核算 | 不以 rename 或两份同卷文件承诺任意故障保持 |
|
||||
@@ -163,6 +163,6 @@
|
||||
|
||||
**当前主推荐**为:netTask 无线程循环驱动成熟核心及属主专用尝试式网络接口;defaultTask 协调全类型参数的规范模型、耐久提交与跨读者同代次发布;历史/日志/录波、电能在既有实际属主补齐未来真实字段并生成不可变兼容导出。保持全部业务与原库并发能力,不用缩容、第二真源或伪历史换资源。
|
||||
|
||||
**推荐的下一步不是直接移植,而是先批准最小可行性工作包**:完整状态结构与峰值预算设计、精确待收/NODELAY 隔离探针、读者同代次与耐久恢复故障模型、文件补采及兼容视图合同。当前资源证据已经表明默认闭包直接迁入超预算,不能把“待更多实测”写成默认可行。工作包不授权改变栈池、第三方行为或硬件;结构变化仍逐项审批。
|
||||
**推荐的下一步不是直接移植,而是先批准最小可行性工作包**:完整状态结构与峰值预算设计、精确待收隔离探针(禁用小包延迟已核实为平台偏离,不再列为探针)、读者同代次与耐久恢复故障模型、文件补采及兼容视图合同。当前资源证据已经表明默认闭包直接迁入超预算,不能把“待更多实测”写成默认可行。工作包不授权改变栈池、第三方行为或硬件;结构变化仍逐项审批。
|
||||
|
||||
**仍未闭环的实施前提**为:完整资源合格、网络关键能力证明、真实读者代次迁移及写旁路封闭、存储故障保证与旧资料处置批准。任一前提不成立就停止转实施,给出保持全功能的替代架构或硬件代价,不把条件推荐当已批准可运行方案。调查冻结与独立审查完成只表示规划可决策,**不表示 MCU 完整落地、既有旧栈可删或任何产品改动已获批准**。
|
||||
|
||||
@@ -46,6 +46,8 @@
|
||||
|
||||
`iec104_source_clock_set()` / `iec104_source_clock_read()` / `iec104_source_clock_ms()` 只维护虚拟设备墙钟,**不得改 Windows 系统钟**;超时使用独立单调时基。对时不应改变选择/链路超时或宿主时间。UI 时间一致性由适配层验证,不能据此推断 UI 参数已同源。
|
||||
|
||||
**C_CS 对时的落点在骨架迁移中收窄**:迁移后的共享核心收到 C_CS 只调用 `iec104_source_clock_seed()` 更新虚拟设备墙钟种子,**不写 SD2506 实时时钟**;这与下文 §5 旧实现经 `sys_clock_set_unix()` 写回硬件 RTC 的行为不同,属行为变更,不能按旧口径宣称对时已落硬件。当前调用 `sys_clock_set_unix()` 的只有 `App/task/ui_task.c`(UI 手动校时)和 `App/sync/time_sntp.c`(SNTP 对时)两处;旧 `iec104Task` 的 C_CS 写 RTC 路径随该任务退役后不再存在。
|
||||
|
||||
### 0.4 验证状态与资源限制
|
||||
|
||||
- **仅模拟器首个里程碑通过,不代表全部替换完成**:最终二进制 SHA256 为 `d2285bbc68ce4353c814dbcc455a2083b56e81fc54bf88081402e821c6a92833`,测试作者及审查人独立真实 TCP 各 11 项通过,证据分别为 `ci-artifacts/iec104-tests/tcp-final/report.json`、`ci-artifacts/iec104-review/tcp-final/report.json`,各目录保留逐帧、点对象及运行日志。测试作者前轮 11 项通过报告仍保留在 `ci-artifacts/iec104-tests/tcp-snapshot2-corrected/report.json`;首轮失败快照 `ci-artifacts/iec104-tests/tcp-snapshot1/` 保留作修复轨迹。同哈希菜单 8 状态、内容 76 页及往返/实时数据回归通过,日志 `ci-artifacts/iec104-sim-menu-release.log`、`ci-artifacts/iec104-sim-content-release.log`;编译输入身份见 `ci-artifacts/iec104-sim-release-sources.sha256`(95 个编译 C 文件、160 个输入文件哈希)。未刷新黄金参考,不将旧二进制结果冒充最终结果。
|
||||
@@ -56,6 +58,25 @@
|
||||
- **历史日志与录波不另起示例文件栈**:未导入示例历史、录波及升级存储后端;后续接入复用现有 `App/log/` 与录波子系统,不宣称接缝已验证。
|
||||
- **统计语义分开**:`written_i_frames` 是完整 I 帧交给本地 TCP 的记录,可能在协议确认或关闭时延迟交付;`acknowledged_i_frames` 是 IEC104 N(R),不是 TCP ACK。总召及命令完成计数是业务语义,不证明远端收到或物理动作完成;UI 须按实际观测展示。
|
||||
|
||||
### 0.5 骨架阶段的记录缺口(有意收窄,不是回归 bug)
|
||||
|
||||
**旧板端实现会写遥控与对时记录。** `git show HEAD:App/protocol/iec104/iec104_pts.c` 的 `s_src_yk_exec()` 有 7 处 `syslog_post_quiet()` 写 `SYSLOG_YK`(`/log/yk.log`),覆盖 8 种文案:`YK11 select`、`YK11 exec`、`YK12 select`、`YK12 exec on`、`YK12 exec off`、`YK12 exec fail`、`YK12 bad dpc`、`YK unknown ioa`;同一函数另有 2 处写 `SYSLOG_OPER`(`/log/oper.log`),覆盖 3 种文案:YK11 执行段调 `prot_elm_request_reset()` 后写 `force reset`,YK12 执行段调 `prot_set_set_sealed(PS_GLOBAL_EN, …)` 成功/失败后写 `plate in` / `plate out`。`git show HEAD:App/task/iec104_serv.c` 的 `s_clock_sync()` 在 `sys_clock_set_unix()` 返回 0 时写 `SYSLOG_OPER` 的 `clock set by 104`。
|
||||
|
||||
**迁移后的共享核心不写这些记录,因为无真事实可写。** `iec104_source_command()`(`App/protocol/iec104/iec104_source.c`,函数头注释「改变模拟遥信并标识替代源,绝不驱动物理出口」)是纯模拟态变更:选择段立即返回,执行段只改模拟 IOA 的状态与统计,其中复位动作的注释明确「只复归模拟锁存,绝不复归真实保护状态」。`App/protocol/` 与 `App/task/iec104_serv.c` 对 `prot_elm_request_reset` 与 `PS_GLOBAL_EN` 均为 0 次引用,即新核心不触碰任何真实控制目标(与 §0.2「遥控全部为模拟动作」同一事实)。因此骨架档若照旧写 `force reset` 或 `plate in/out`,写下的将是**伪造记录**——不写是当前唯一诚实的做法。
|
||||
|
||||
**可感知后果**(按用户可见面):
|
||||
|
||||
| 面 | 现状 |
|
||||
|---|---|
|
||||
| `/log/yk.log` | 全仓已无生产者(`SYSLOG_YK` 仅在记录类型定义、UI 编号映射表与容量表中出现) |
|
||||
| UI「遥控记录」页(`node 38`) | 读该日志 → 恒为空态,显示伪行「无记录」,页脚「共 1 页」 |
|
||||
| `/log/oper.log` | 少 3 类文案:`force reset`、`plate in/out`、`clock set by 104`;面板侧操作(`App/task/ui_task.c` 的操作记录写入口)与 SNTP 侧(`App/sync/time_sntp.c` 的 `clock set by SNTP`)仍保留 |
|
||||
| 审计面「面板操作 vs 主站操作」 | 远端那一半当前不存在 |
|
||||
|
||||
该日志文件与容量仍登记在 `App/log/sys_log_mcu.c` 的路径/容量表中,「清除记录」页仍列出该条目——即**页面与文件都还在,只是没有写入方**,现场容易误判为设备故障。
|
||||
|
||||
**结论**:骨架阶段**有意不记录遥控与 104 对时**,原因是该阶段不驱动物理出口;这不是回归 bug,是交付范围收窄。恢复记录能力需要**新增观测接缝**(在源层命令路径加观测回调,或给核心加逐条命令结果回调)——现有接口不提供:厂商库无命令观察者 API,`iec104_core.h` 只暴露聚合计数 `commands_completed`,`iec104_source_command_feedback()` 仅告知命令影响了哪几个 IOA 且不区分成功/失败/拒绝。该新增涉及 `netTask` 栈预算(`iec104_serv_net_tick()` 在 `netTask` 上下文运行),**待另行立项,不并入本轮骨架割接**。
|
||||
|
||||
## 1. 范围(V0.1 子集)
|
||||
|
||||
| 面 | 本期做 | 本期不做(登记 §8) |
|
||||
|
||||
@@ -567,7 +567,7 @@ bench 锁全程持有(任务 `exec-issue-84`,`_wt` 规范锁区手工获取
|
||||
§4 与 §8(坏段轮 reject 行 = 预期内,其余 `[ERR]` 照旧停幕)。画面零改动:判废态仍
|
||||
「该段不可读」逐比特不变(ui-golden `wave_play_bad` 零刷新实证)。
|
||||
|
||||
主机面:ui-golden 全绿(内容页 74 张 + 菜单行 + 水位;三态帧零刷新);主机套件 ui_data 295 /
|
||||
主机面:ui-golden 全绿(当时内容页 74 张 + 菜单行 + 水位;三态帧零刷新);主机套件 ui_data 295 /
|
||||
ui_sink 17 / wave_ring 113 / wave_store 170 / wave_trig 110 全过;Keil 0 错误 0 警告
|
||||
(ER_IROM1 285,716→285,940 B:判废留痕单调用点含格式串常量共 +224 B,与 #93「每调用点约
|
||||
90 B」的账同量级)。
|
||||
|
||||
@@ -66,7 +66,7 @@ epoch 定宽 10 位是因为 2001-09-23 起 Unix 秒已是 10 位;uint32 到 2
|
||||
| `/log/alarm.log` | `SYSLOG_ALARM` | 保护告警(告警型元件动作) | 1024 条(64 KB) | 同上 |
|
||||
| `/log/start.log` | `SYSLOG_START` | 保护启动(越限电平上升沿) | 1024 条(64 KB) | 同上 |
|
||||
| `/log/oper.log` | `SYSLOG_OPER` | 操作(改动了装置状态的运维动作) | 512 条(32 KB) | 同上 |
|
||||
| `/log/yk.log` | `SYSLOG_YK` | 遥控(104 命令的选择/执行/拒绝) | 256 条(16 KB) | 同上 |
|
||||
| `/log/yk.log` | `SYSLOG_YK` | ⚠ 原为遥控(104 命令的选择/执行/拒绝);该写入点随 2026-11-17 通信骨架割接删除,**当前无生产者**,骨架阶段有意不记(不驱动物理出口,照旧写即为伪造),见本文档 §2.2 与 `docs/子系统设计/IEC104上行设计说明.md` §0.5 | 256 条(16 KB) | 同上 |
|
||||
|
||||
- **上限是逻辑上限,不是预分配**:文件按追加写自然增长,一条不写就不占簇;到顶才删除重建(串口打 `cap full, recreate`)。七类全满的名义峰值 = 4864 条 × 64 B = **304 KB**,相对 NAND 容量可忽略,且这些只在事件边沿写。
|
||||
- 告警/启动给到 1024 条,是因为一次故障会连片触发多个元件,别让最能说明故障过程的两类最先被截掉。
|
||||
|
||||
@@ -176,7 +176,7 @@
|
||||
**已落地**:脚本、基线台账、口径(本文);`test-coverage` 已并进 `scripts/ci_local.py` 的 manual 段(`--coverage` 旗标保留只为兼容旧命令)。
|
||||
|
||||
**接线状态:已挂**(2026-10-24,`test-coverage` 落在 `.pre-commit-config.yaml` 第 8 节,用户裁定 **FAIL** 语义)。
|
||||
它带 `stages: [manual]`——**`git commit` 阶段不跑**(一次带代码的提交只跑 49 根快钩子),由远端 CI 的
|
||||
它带 `stages: [manual]`——**`git commit` 阶段不跑**(一次带代码的提交只跑 48 根快钩子 = pre-commit 阶段 47 + `gitlint`),由远端 CI 的
|
||||
「手动阶段门禁(覆盖率总闸 + 全量 cppcheck)」步与 `scripts/ci_local.py` 的 manual 段承担;手工复跑
|
||||
`& '.venv\Scripts\python.exe' -m pre_commit run --all-files --hook-stage manual test-coverage`。
|
||||
|
||||
@@ -736,7 +736,7 @@ uint16_t ch395f_link_change_count(void);
|
||||
| 类别 | 体量 | 为什么不做 | 那它靠什么把关 |
|
||||
|---|---|---|---|
|
||||
| 芯片驱动(寄存器/时序) | `ch395f.c`(801)、`gd5f2gq5ue.c`(689)、`sd2506.c`(264)、`tpafe5160.c`(157)、`rs485.c`(79) = **1,990 行** | 把 HAL 与寄存器假到底 ≈ **重写一遍驱动**,测的是自己的桩而不是硬件行为(SPI 分频必须 8、DMA 流、I2C 时序在桩里怎么编都"对") | 板级套件(`board-test-suite` skill)+ `/serial-boot-test` 真机日志 + 4 个 Fault 现场;陷阱逐条登记在 `docs/问题记录/CH395F_Trap_Records.md`、`docs/问题记录/GD5F2GQ5UE_Trap_Records.md`、`docs/问题记录/SD2506_Trap_Records.md` |
|
||||
| UI 侧 | 18 个 `.c` = **2,373 行**(2026-11-04 随 `ui_page_sntp.c` 从 17 个/1,942 行递增) | 与 PC 模拟器是**同一份源码**,行为回归已由 `ui-golden`(菜单 8 状态 + 内容页 74 张像素黄金参考)覆盖;再写单测是第三份重复投资 | `ui-verify` skill 五步 + `docs/UI设计/UI_自动化测试流程.md` |
|
||||
| UI 侧 | 18 个 `.c` = **2,373 行**(2026-11-04 随 `ui_page_sntp.c` 从 17 个/1,942 行递增) | 与 PC 模拟器是**同一份源码**,行为回归已由 `ui-golden`(菜单 8 状态 + 内容页 76 张像素黄金参考)覆盖;再写单测是第三份重复投资 | `ui-verify` skill 五步 + `docs/UI设计/UI_自动化测试流程.md` |
|
||||
| 任务编排 | `default_task.c`(281)、`adc_task.c`(171)、`net_task.c`(123)、`protect_task.c`(90)、`ui_task.c`(71)、`rs485_task.c`(11) = **747 行** | 每个只有 4~5 个函数,主体是"按顺序调别人";真逻辑在被调模块里(那些已测或在 P1/P2)。给编排层写单测最容易写成"断言我调了几次"的自证 | 真机启动锚点计数 + IWDG `required_mask`(`/serial-boot-test`)+ `docs/架构设计/项目启动顺序管理.md` |
|
||||
| 内核前装配 | `app_main.c`(135) | 被测对象本身就是"`osKernelStart` 之前不许调内核 API"的时序,主机侧无法忠实复现(PC 上没有那个约束) | 同上 + `cubemx-survival` 审计 |
|
||||
|
||||
|
||||
@@ -45,7 +45,7 @@
|
||||
| A2 | 产品构建 0/0 | `& '.venv\Scripts\python.exe' .dsh\skills\keil-build\scripts\keil_build.py` | 末行 `BUILD_OK: 0 errors, 0 warnings` |
|
||||
| A3 | 构建产物为**产品态** | 检查 `test/board/test_config.h` L30-33 | 四个 `TEST_SUITE_*` **全部注释** |
|
||||
| A4 | `.map` 非测试态 | 看 `MDK-ARM/STM32F407-Demo/STM32F407-Demo.map` 的 `ER_IROM1` | 产品态基线随已接受的修复增长:262,100(初版)→ 262,836 B(10-02 第 1~6 轮台架)→ 264,284 B(第 7~9 轮台架)→ **264,936 B(当前,含 A2/A3/A4 补码)**;明显阶跃 ≈3.7KB 及以上(10-02 实测产品 262,836 → 套件 266,540)= 停在套件态 → 重跑 A2 |
|
||||
| A5 | 全量静态门禁 | `pre-commit run --all-files`(现只覆盖 `pre-commit` 阶段 47 根;manual 阶段三根另跑 `--hook-stage manual <id>`) | **当时 17/17 Passed**(2026-10-03 实测;含新增 `test-cppcheck`) |
|
||||
| A5 | 全量静态门禁 | `pre-commit run --all-files`(现只覆盖 `pre-commit` 阶段 47 根;manual 阶段四根另跑 `--hook-stage manual <id>`) | **当时 17/17 Passed**(2026-10-03 实测;含新增 `test-cppcheck`) |
|
||||
| A6 | ST-LINK 探针可见 | `& '.venv\Scripts\python.exe' .dsh\skills\stlink-flash\scripts\stlink_flash.py list`(CLI 经 `DTU_STLINK_CLI` / PATH 解析) | 列出探针 SN `0B250D12A218303030303032` |
|
||||
| A7 | 串口端口正确 | 检查 `.serialtest/config.json` 的 `portName` | 端口单一配置源 = 此文件(当前 COM6,2026-09-21 台架重插后由 COM7 变更);变更后先杀旧 daemon 再 `open` |
|
||||
| A8 | 串口助手 daemon 可用 | `& '.venv\Scripts\python.exe' .dsh/skills/serial-assistant/scripts/serial_tool.py status` | 返回 JSON,`open: true/false` 可读 |
|
||||
|
||||
@@ -373,7 +373,7 @@ cmake --build simulator/build --config Debug # 0) 构建模拟器(须 0 警
|
||||
| 层 | 载体 | 抓住什么 |
|
||||
|---|---|---|
|
||||
| 文本层 | `check_content_pages.py` 字形模板匹配(310 条、覆盖当时 37 页,解析字体 cmap / glyph_dsc / bitmap) | 缺字显示空白 / 标签写错等**静默失败**(不依赖 `ref/`,先于像素比对运行、失败即中止防误刷参考) |
|
||||
| 像素层 | 内容页黄金参考 74 张 + 菜单 8 状态,与黄金参考逐字节比对 | 几何 / 样式 / 光标反显 / 整体外观 |
|
||||
| 像素层 | 内容页黄金参考 76 张 + 菜单 8 状态,与黄金参考逐字节比对 | 几何 / 样式 / 光标反显 / 整体外观 |
|
||||
| 池水位层 | `MENU_POOL_BASELINE=5368 B` / `POOL_AFTER_ROUNDTRIP=5448 B` | LVGL 内存池泄漏 / 结构性漂移(量的是 `used`,与 `LV_MEM_SIZE` 总大小无关) |
|
||||
|
||||
### 5.3 黄金参考与字体纪律
|
||||
|
||||
@@ -119,7 +119,7 @@
|
||||
|
||||
- **初始化回归**:`App/task/ui_task.c` 已有 `UI port init: OK` / `UI menu init: OK` / `UI net sink: started`
|
||||
打印(见 `run_boot_test.py` 命令示例);将其加入 `--required` 即可经串口自动回归 UI 初始化。
|
||||
- **屏幕内容回归**:由 LVGL 模拟器像素回归覆盖(文本级断言 + 74 张黄金参考 + 池水位门禁,
|
||||
- **屏幕内容回归**:由 LVGL 模拟器像素回归覆盖(文本级断言 + 76 张黄金参考 + 池水位门禁,
|
||||
见 `docs/UI设计/UI_自动化测试流程.md`);上机屏幕仍需人工目检(见 `测试开发标准流程.md` §1)。
|
||||
|
||||
## 扩展用法
|
||||
|
||||
@@ -199,14 +199,14 @@ python tools/font_gen/extract_cn.py # 任意 python3:
|
||||
|
||||
| 项 | 要求 | 说明 |
|
||||
|---|---|---|
|
||||
| pre-commit | 已安装并 `pre-commit install` | 提交门禁:`.pre-commit-config.yaml` 共 **53 个钩子**,一次提交实跑 **50 个**(pre-commit 阶段 49 + commit-msg 阶段 `gitlint`);余下 3 个带 `stages: [manual]`,归远端 CI 与 `ci_local.py` |
|
||||
| cppcheck | 在 PATH 中 | 钩子直接调 `cppcheck --enable=warning,performance,portability,style`(`language: system`)。⚠ `cppcheck` / `test-cppcheck` / `test-coverage` 三根带 `stages: [manual]`:`git commit` 不跑,由远端 CI 的「手动阶段门禁」步与 `scripts/ci_local.py` 的 manual 段跑(CI runner 缺 cppcheck 则该步失败) |
|
||||
| pre-commit | 已安装并 `pre-commit install` | 提交门禁:`.pre-commit-config.yaml` 共 **52 个钩子**,一次提交实跑 **48 个**(pre-commit 阶段 47 + commit-msg 阶段 `gitlint`);余下 4 个带 `stages: [manual]`,归远端 CI 与 `ci_local.py`(⚠ `iec104-tcp` 远端 CI 不构建模拟器、跑不了,只在本地跑) |
|
||||
| cppcheck | 在 PATH 中 | 钩子直接调 `cppcheck --enable=warning,performance,portability,style`(`language: system`)。⚠ `cppcheck` / `test-cppcheck` / `test-coverage` / `iec104-tcp` 四根带 `stages: [manual]`:`git commit` 不跑,由远端 CI 的「手动阶段门禁」步与 `scripts/ci_local.py` 的 manual 段跑(CI runner 缺 cppcheck 则该步失败;`iec104-tcp` 需模拟器产物,远端 CI 因不构建模拟器而跑不了) |
|
||||
| python | 在 PATH 中 | 本地钩子调 `scripts/check_mojibake.py`(U+FFFD 乱码)、`scripts/check_coding_standard.py`(规范 V1.0,纯标准库) |
|
||||
| **MSVC `cl.exe`** | **装了 VS 即有(§2.3)** | **`watchdog-unit-test` 钩子必需**:改 `App/util/task_watchdog.*` 或 `test/host/watchdog/**` 时触发,用 `cl.exe` 离线编译真实源码跑单测。**未装 VS 时该钩子报环境错误(退出码 2)→ 拦截提交** |
|
||||
| gitlint | 随 pre-commit 自动拉取 | commit message 格式(宽松规则,兼容中文标题) |
|
||||
|
||||
> 检查范围仅项目自有代码;`Lib/`、`Middlewares/`、`Drivers/BSP/UI`、`lftpd`、`dhara`、`test/` 等被排除。
|
||||
> 全库扫描:`pre-commit run --all-files`(跑提交期那 49 个;gitlint 属 commit-msg 阶段,不在其中);三根 manual 钩子逐根复跑:
|
||||
> 全库扫描:`pre-commit run --all-files`(跑 pre-commit 阶段的 47 个;`gitlint` 属 commit-msg 阶段,不在其中);四根 manual 钩子逐根复跑:
|
||||
> `& '.venv\Scripts\python.exe' -m pre_commit run --all-files --hook-stage manual <hook-id>`(一次只能一个 id)。
|
||||
> 详见 `docs/代码规范/pre-commit使用说明.md`、`docs/代码规范/cppcheck使用说明.md`。
|
||||
>
|
||||
@@ -326,8 +326,8 @@ npm i -g lv_font_conv # 手动:https://www.npmjs.com/package/lv
|
||||
winget install cppcheck # 安装位置任意;入 PATH 或用 DTU_CPPCHECK 指向
|
||||
# pre-commit 随 .venv 安装(§2.4,requirements.txt 已含),用 .venv 的解释器装钩子:
|
||||
& '.venv\Scripts\python.exe' -m pre_commit install
|
||||
pre-commit run --all-files # 首次全库基线扫描(提交期 49 个)
|
||||
# manual 阶段三根(cppcheck / test-cppcheck / test-coverage,提交期不跑)逐根跑,一次一个 id:
|
||||
pre-commit run --all-files # 首次全库基线扫描(提交期 47 个)
|
||||
# manual 阶段四根(cppcheck / test-cppcheck / test-coverage / iec104-tcp,提交期不跑)逐根跑,一次一个 id:
|
||||
& '.venv\Scripts\python.exe' -m pre_commit run --all-files --hook-stage manual cppcheck
|
||||
```
|
||||
|
||||
@@ -366,7 +366,7 @@ pre-commit run --all-files # 首次全库基线扫描(提交期 49
|
||||
& '.venv\Scripts\python.exe' simulator\tests\check_content_pages.py # PASS(基准 ref/*.bin 已入库,无需先生成)
|
||||
& '.venv\Scripts\python.exe' .dsh\skills\serial-assistant\scripts\serial_tool.py selftest # → SELFTEST PASS
|
||||
& '.venv\Scripts\python.exe' test\host\watchdog\run_unit_test.py # 主机侧单测 → 47/47 PASSED(退出码 0)
|
||||
pre-commit run --all-files # 提交期 49 个(manual 三根另跑:--hook-stage manual <id>,或直接 ci_local.py)
|
||||
pre-commit run --all-files # 提交期 47 个(manual 四根另跑:--hook-stage manual <id>,或直接 ci_local.py)
|
||||
```
|
||||
|
||||
**搭建清单汇总**(随步骤逐项打勾):
|
||||
|
||||
@@ -0,0 +1,134 @@
|
||||
# IEC 104 板端 Net 适配契约
|
||||
|
||||
> **定位**:`App/protocol/iec104/iec104_net_mcu.c` 把成熟 104 库的 `IEC104_Net.h` 后端 ABI 接到
|
||||
> `Drivers/BSP/NET/net_socket.h` 的 `net_*` 接口上,本契约说明**为什么不能直译、按什么规则映射、
|
||||
> 哪些不变量必须成立**。代码落点:`App/protocol/iec104/iec104_net_mcu.c` / `.h`。
|
||||
> **验证边界**:见 §7——经 fake net 层 12/12 与代码审查,**CH395F 板端行为未证**。
|
||||
|
||||
## 1. 反例:直译 vendor 的 `Close(client)` 会毁掉监听
|
||||
|
||||
成熟库按 **Windows/Winsock 式的"独立 client fd"** 设计:监听 socket 与接入后的数据 socket
|
||||
是两个不同句柄,因此 `Accept` 失败清理、以及"已有客户端时又来一个"的分支,一律
|
||||
`IEC104_Net_Close(client, NULL)`——`App/protocol/iec60870/104/IEC104_TcpServer.c` 里共 **7 处**
|
||||
(约 1606 / 1611 / 1616 / 1628 / 1636 / 1652 / 1665 行)。在 Winsock 下这让两侧各自独立,语义自洽。
|
||||
|
||||
CH395F 是**单连接模型**:`net_accept()` 返回的是**监听 socket 自己**,接入瞬间同一个 fd 从
|
||||
"监听"变成"数据通道"(见 `docs/网络/BSD_Socket_API_使用指南.md` §2.3 的 fd 模型对照表)。
|
||||
若把上面 7 处直译成 `net_close`:
|
||||
|
||||
```
|
||||
Accept 成功 → 同 fd 转 ESTABLISHED → 走 Accept 失败/重复客户端分支 → net_close(client)
|
||||
→ 底层真的关闭该 fd → 监听消失
|
||||
→ 一次会话结束后再也接不进新连接(不是"等下一个主站",是"监听没了")
|
||||
```
|
||||
|
||||
这不是"偶发多关一次",而是**每次命中那条分支就把监听铲掉**,故障形态是静默的:
|
||||
没有任何错误码,只是之后永远 Accept 不到。
|
||||
|
||||
> 反例的可执行版本见 `test/host/iec104_netmcu/MATRIX.md` 的 N1 / N8 / N11:
|
||||
> fake net 层如实建模"`net_close` 对监听 fd 真实销毁监听并递增 `listen_closed_attempts`",
|
||||
> 因此 `listen_closed_attempts == 0` 这条断言就是"没有踩这个反例"的机器判据。
|
||||
|
||||
## 2. 映射规则:按槽的 role 分流,不按句柄本身
|
||||
|
||||
正确做法是后端自己维护一张**槽表**,每个槽记录 `role`,`IEC104_Net_Close()` 先查槽再按 role 分流:
|
||||
|
||||
| 关闭目标 | 后端动作 | 含义 |
|
||||
|---|---|---|
|
||||
| `role == SLOT_CLIENT` / `SLOT_CLIENT_EOF` | `net_drop_conn_locked()` | **拆会话、保监听**。这是 7 处 `Close(client)` 的正确落点 |
|
||||
| `role == SLOT_LISTEN` | 真正关闭监听 fd(`net_close_sock()`)+ 清槽 | 仅库的 `TcpServer_Close` / Init 失败清理会走到 |
|
||||
|
||||
判据是**槽的 role**,不是句柄值本身:两个槽可能持有同一个 fd 号,光看 fd 无法回答
|
||||
"它此刻代表谁"。后端内 CLIENT 分支**不存在关闭监听 fd 的任何调用路径**——这一点由
|
||||
`test/host/iec104_netmcu/` 的 S1 文本级静态检查机械断言(花括号范围匹配,不靠肉眼)。
|
||||
|
||||
LISTEN 分支还有一个顺序约束:若此时仍存在客户端槽,**先按 CLIENT 语义拆掉再关监听**,
|
||||
避免留下无主的 client 槽。
|
||||
|
||||
## 3. 双句柄模型:LISTEN 恒定,CLIENT 每次 Accept 新建
|
||||
|
||||
库内 `server->listen_socket` 在 `IEC104_TcpServer.c` 里**只被赋值一次**(Listen 成功时,约
|
||||
2129 行),此后在 Accept、Wait、事件匹配等多处使用(约 1579 / 1782 / 1874 / 1983 行),
|
||||
**整个监听生命周期内永不更新**。因此:
|
||||
|
||||
- **LISTEN 槽**:`handle` 在监听生命周期内**不变**,`role` 恒为 `SLOT_LISTEN`。
|
||||
**绝不翻转监听槽的 role**,否则库的 `Close(listen)` / `Wait(ACCEPT)` 会失联。
|
||||
- **CLIENT 槽**:每次 `Accept` 成功另起一个**独立槽**、分配**新 handle**;
|
||||
该槽与监听槽同 fd、同代次(同一个 `net_gen`)。
|
||||
- **re-Accept 同 fd 时只清槽、绝不 drop_conn**:`net_accept_locked` 刚在同一个 fd 上完成新的
|
||||
ESTABLISHED,此刻对旧 client 槽调 `net_drop_conn` 会**拆掉刚接进来的新连接**。
|
||||
这是最容易写错的一条,也是 N11 用例的判据来源(`drop_conn_calls` 不增、
|
||||
`net_fake_listener_armed() == 1`)。
|
||||
|
||||
## 4. 代次不变式(逐字,不得改写)
|
||||
|
||||
> 后端槽的有效性只由 `slot->net_gen == net_get_generation()` 判定;网络初始化复位芯片后
|
||||
> (`net_init()` 做 `memset(s_net_socks, ...)` + `ch395f_reset()`)旧句柄一律失效,
|
||||
> 后端绝不向跨代次的 fd 发任何硬件操作。
|
||||
|
||||
理由是**fd 号会复用**:跨代的旧槽里存的 fd 号,在新代次可能已经是另一个会话。
|
||||
所以"代次已变"必须直接等于"这个句柄作废";陈旧/跨代的 Close 一律**幂等返回 OK 且不碰硬件**
|
||||
(不是报错,因为库会在失败路径上重复 Close)。这条不变式的行为证据是 N5 / N10:
|
||||
代次推进后旧句柄的 Send/Recv/Pending/Accept 均 ERROR/BADF,旧 Close 幂等 OK 且
|
||||
`hardware_calls` 零增长。
|
||||
|
||||
## 5. 句柄分配:单调递增、永不复用
|
||||
|
||||
`IEC104_NetSocket_t` 只有一个 `uintptr_t` 整数,**装不下 session 身份**(拿不到"这个句柄是哪次
|
||||
Listen 发的")。因此不能靠句柄内嵌校验,只能靠**值本身不复用**来消灭 ABA:
|
||||
|
||||
- 每次 Listen / Accept 成功都分配**新的 handle 值**,旧 handle 永远不会再次出现在表中;
|
||||
- 溢出前整表重建;
|
||||
- **不是**"fd + 1"这类编码——早前曾定过该方案,已撤回。
|
||||
|
||||
表容量等于 net 层 fd 上限(`NET_MAX_SOCKETS` = 8)。N6 是这条的反例自证:连续多次
|
||||
listen/close 后旧 handle 必然查表失败。
|
||||
|
||||
## 6. 编译期边界:5 个 MCU 专有接口模拟器看不到
|
||||
|
||||
后端需要的 5 个 owner 出口声明在 `net_socket.h` 的 `#ifndef NET_NO_OS` … `#endif` 段内
|
||||
(约 702–809 行):`net_drop_conn_locked`、`net_accept_locked`、`net_pending_bytes`、
|
||||
`net_send_try`、`net_mono_now_ms`。**模拟器定义 `NET_NO_OS`,因此看不到它们**——
|
||||
这也正是 `iec104_net_mcu.c` 只进 MCU 构建、模拟器由 `sim/iec104_sim.c` 提供同 ABI 替身的原因。
|
||||
|
||||
**已知一致性缺口**:头文件有 `NET_NO_OS` 门控,但 `net_socket.c` 里 `NET_NO_OS` 零命中——
|
||||
5 个实现**无条件编译**。当前不构成故障(模拟器不编 `net_socket.c`),但如果将来把
|
||||
`net_socket.c` 编进模拟器,会得到"实现存在但未声明"的孤儿符号:**链接不报错、
|
||||
调用处静默走空**。改这一块之前必须先把这个不对称补齐。
|
||||
|
||||
## 7. 证据边界:证明到哪、没证明什么
|
||||
|
||||
| 层面 | 状态 |
|
||||
|---|---|
|
||||
| fake net 层行为契约(N1~N11,共 12 个用例) | **12/12 PASS**(`test/host/iec104_netmcu/results/report.json`,逐次运行日志 `results/real/run.log`) |
|
||||
| 静态检查(S1/S2,花括号范围机械匹配) | **2/2 PASS** + 变异自测 `real_rc=0 mutant_rc=1`(`results/static/`、`results/static_mutant/`) |
|
||||
| 代码审查 | 通过(`ci-artifacts/iec104-cutover/review-net-backend.md`) |
|
||||
| **CH395F 板端同 fd 语义** | **未证**——fake 只是按产品头语义忠实建模,不是真实驱动 |
|
||||
| **core / TcpServer 完整链接** | **NOT_RUN**(完整 STARTDT 建链未跑) |
|
||||
| **netTask 队列时序 / MCU WCET / 性能** | **未测** |
|
||||
|
||||
> **禁止据此写"板端已验证"。** 本契约是**接口契约 + 反例防护**的证据,不是硬件行为证据。
|
||||
|
||||
---
|
||||
|
||||
## 附:源码行号索引(以 2026-11-17 本工作树为准)
|
||||
|
||||
> `net_socket.c` / `net_socket.h` 的行号会随改动漂移(同一天已经漂过两次)。
|
||||
> **正文一律用函数名指代,行号只在此处集中登记**,引用时请重新 grep 核对。
|
||||
|
||||
| 符号 / 事实 | 位置 |
|
||||
|---|---|
|
||||
| `net_wait_result()` 定义 | `Drivers/BSP/NET/net_socket.c:930` |
|
||||
| 其阻塞点 `xTaskNotifyWait(..., portMAX_DELAY)` | `net_socket.c:945`(`:939` 是零等待那一次,不是阻塞点) |
|
||||
| 公开 `net_close` / `net_drop_conn`(无 owner 分支) | `net_socket.c:2515` / `:2574` |
|
||||
| `net_close_locked`(static,非对外接口) | `net_socket.c:2098` |
|
||||
| `net_drop_conn_locked`(owner 出口,拆会话保监听) | `net_socket.c:2174` |
|
||||
| `net_close_sock`(owner 出口,关单个 socket) | `net_socket.c:3041` |
|
||||
| `net_init` 内 `memset(s_net_socks, ...)` / `ch395f_reset()` | `net_socket.c:337` / `:351` |
|
||||
| 5 个新声明所在的 `#ifndef NET_NO_OS` 段 | `net_socket.h:702` ~ `:809` |
|
||||
| `net_drop_conn_locked` / `net_accept_locked` 声明 | `net_socket.h:769` / `:770` |
|
||||
| `net_pending_bytes` / `net_send_try` / `net_mono_now_ms` 声明 | `net_socket.h:777` / `:785` / `:792` |
|
||||
| 后端的 LISTEN / CLIENT 分流 | `App/protocol/iec104/iec104_net_mcu.c` 的 `IEC104_Net_Close()` |
|
||||
| 后端的 role 查表 | 同文件 `find_role()` / `slot_by_handle()` |
|
||||
| 7 处 `IEC104_Net_Close(client, NULL)` | `App/protocol/iec60870/104/IEC104_TcpServer.c` 约 1606/1611/1616/1628/1636/1652/1665 |
|
||||
| `server->listen_socket` 赋值点 | 同文件 `:2129`(Listen 成功)/ `:322`、`:2146`、`:3322`(置无效) |
|
||||
@@ -538,6 +538,8 @@ net_pending_capture_owner() ← 捕获执行者
|
||||
- 清除掩码必须全 1(传 0 = 不清除,会残留上次结果被误读为本次结果);
|
||||
- **禁止在本路径加逐调用日志**——该路径每条 API 调用都过一遍,会淹没排查用的证据日志。
|
||||
|
||||
**源码定位与 netTask 内调用边界**(板端割接实测,`Drivers/BSP/NET/net_socket.c`):`net_wait_result()` 定义在 `:930`,真正阻塞的是 `:945` 的 `xTaskNotifyWait(0xFFFFFFFFU, 0xFFFFFFFFU, &v, portMAX_DELAY)`;`:939` 的零等待那次是防丢通知的第一段,不是阻塞点。`net_send()` 本体的入队在 `:2289`(紧接 `:2297` 调 `net_wait_result("snd")`);全文件 `osMessageQueuePut(..., osWaitForever)` 共 12 处(`:1086` / `:1313` / `:1480` / `:1650` / `:2289` / `:2370` / `:2472` / `:2541` / `:2600` / `:2718` / `:2852` / `:2973`),即公开 `net_*` 入队一律无上界等待。公开版 `net_close`(`:2515`)、`net_drop_conn`(`:2574`)没有 owner 上下文分支,在 netTask 内调用就是等自己的回执而死锁;netTask 内要关单个 socket 用 `net_close_sock(net_sock_t *)`(`:3041`),要拆会话保留监听用 `net_drop_conn_locked(net_sock_t *)`(`:2174`)——不存在名为 `net_close_locked` 的对外接口,它只是 `net_close` 内部的 static 实现。本轮新增的 5 个声明 `net_drop_conn_locked`(`:769`)、`net_accept_locked`(`:770`)、`net_pending_bytes`(`:777`)、`net_send_try`(`:785`)、`net_mono_now_ms`(`:792`)都位于 `net_socket.h` 的 `:702` `#ifndef NET_NO_OS` … `:809` `#endif` 段内,模拟器(定义 `NET_NO_OS`)看不到它们。所以在 netTask 内写非阻塞代码时,凡 `net_*` 都要先问它内部是不是 `osWaitForever`。
|
||||
|
||||
**13. 发送有界自旋**(`net_send_locked`):两个等待循环都在 `net_poll()` 之后判预算,
|
||||
**判定顺序不可交换**:
|
||||
|
||||
|
||||
+30
-22
@@ -1,7 +1,7 @@
|
||||
# 门禁逐项说明(每种门禁一篇)
|
||||
|
||||
> 本目录逐项说明各门禁:**声明的 52 个钩子到底在干什么、拦谁、放谁、什么时候会骗人**——其中 3 根慢钩子带
|
||||
> `stages: [manual]`,一次 `git commit` 只实跑 49 根(口径见下条)。
|
||||
> 本目录逐项说明各门禁:**声明的 52 个钩子到底在干什么、拦谁、放谁、什么时候会骗人**——其中 4 根慢钩子带
|
||||
> `stages: [manual]`,一次 `git commit` 只实跑 48 根(口径见下条)。
|
||||
> 每个门禁一篇,八段固定结构:查什么 / 为什么要它 / 触发面 / 报错怎么读 / 好处 /
|
||||
> **限制与盲区** / 豁免与基线 / 改门禁本身要注意什么。**最后一节是这套文档存在的理由**——
|
||||
> 一份只看"拦了什么"的门禁文档,会让人以为绿就是对的。
|
||||
@@ -9,54 +9,61 @@
|
||||
- 配置事实源:`.pre-commit-config.yaml`。**钩子数的唯一口径 = YAML 解析后的 hook 条目数**,不是文件里的文本行数。
|
||||
自查(打印声明数;加/删一条钩子后,这个数要与 **AGENTS.md 的「共 N 个钩子」**、**本目录 §2 标题**同时对齐):
|
||||
`& '.venv\Scripts\python.exe' -c "import yaml; d=yaml.safe_load(open('.pre-commit-config.yaml', encoding='utf-8')); print(sum(len(r['hooks']) for r in d['repos']))"`
|
||||
→ **51**(2026-10-26:49 → 50 加 `generated-fresh`;2026-10-27:50 → 51 加 `nested-comment`;
|
||||
→ **52**(2026-10-26:49 → 50 加 `generated-fresh`;2026-10-27:50 → 51 加 `nested-comment`;
|
||||
2026-10-28:51 → 52 加 `id-check-new`、随即 52 → 51 摘掉 `id-check`(退役全库语料审计);2026-10-29:51 → 52 加 `skill-size`(SKILL.md 写侧上限与 reference 指针,详见 [`skill-size.md`](skill-size.md));
|
||||
同日 52 → **51** 退役 `id-check-new`——只查新增行的编号门禁整体退场,脚本与白名单移入
|
||||
`scripts/archive/id_gate/`,此后**编号形态没有机器面**(留档 [`id-check-new.md`](id-check-new.md));
|
||||
2026-10-30:51 → **52** 加 `mermaid-syntax`(mermaid 围栏内确定性语法:坏图渲染失败靠肉眼才逮过,
|
||||
详见 [`mermaid-syntax.md`](mermaid-syntax.md)))。
|
||||
详见 [`mermaid-syntax.md`](mermaid-syntax.md));
|
||||
2026-11-17:52 → 51 摘掉 `iec104-unit-test`(旧自研协议层三源随 vendor 库接入整体删除,测试脚本
|
||||
`test/host/iec104/run_unit_test.py` 已不存在 ⇒ 死钩子,每次触发必 RC=2);
|
||||
2026-11-18:51 → **52** 加 `iec104-tcp`(IEC 104 真实回环 11 条 TCP 用例,`stages: [manual]`))。
|
||||
⇒ **两笔合并后声明数仍是 52,但结构变了:pre-commit 阶段 48 → 47、manual 3 → 4。**
|
||||
⚠ **别用 `grep -c` 去数配置里的声明行**:该文件里有一条**注释掉的**候选钩子(clang-format,第 65 行),
|
||||
文本 grep 会多算 1(当前口径 52 会数成 53)——「声明比文档多 1 / 实跑又少一档」这种三个数不同源的争执就是这么来的。真要 grep,
|
||||
用**锚定行首缩进**的模式(它天然跳过以 # 开头的注释行)2026-10-28 实测直接得 **51**(当时口径)、
|
||||
2026-10-30 复测得 **52**,均与 YAML 口径一致;
|
||||
2026-11-18 复测得 **52**,均与 YAML 口径一致;
|
||||
会多算 1(比口径多 1)的是**不锚定行首、按子串**匹配声明行的写法(那条被注释掉的候选也被它算进去)。
|
||||
⚠ 反过来的坑也真踩过(2026-10-27):在配置**注释里复述那个 grep 字面量**,会让文本 grep 再虚高 1——
|
||||
数数只认 YAML 解析,注释与文档里都别写出那个字面量(`docs/门禁说明/nested-comment.md` §8 记了现场)。
|
||||
实跑侧口径:`scripts/ci_local.py` 的静态门禁汇总行 `[SUMMARY] …: pre-commit hooks -- passed=A failed=B skipped=C`(方括号里那一段是**层级名**,脚本输出与文档层的语义名正分头迁移 → 抓这行**按 `passed=` 字段匹配**,别把层级名前缀写死进字面量,否则会 grep 不到而误判「没有实跑数」),
|
||||
`A+B+C` = **pre-commit 阶段**的钩子数(48 = 52 − 3 根 `stages: [manual]` − `gitlint`;2026-10-30 加
|
||||
`mermaid-syntax` 前该式子右侧是 51/47),再加 `gitlint` 1 条(它声明在本配置的 `repo: jorisroovers/gitlint`
|
||||
条目、`stages: [commit-msg]`(第 70 行),`--hook-stage commit` 的枚举不含它——2026-10-30 实测:
|
||||
`--hook-stage commit` 枚举 **47 行** / `manual` 枚举 **50 行** / YAML 解析声明 **51**(加本钩后 48/51/52),
|
||||
47 + 3 + 1 = 51,差的那个就是 `gitlint`;旧说法「gitlint 声明在上游清单、本配置里查不到」已于当日随
|
||||
`A+B+C` = **pre-commit 阶段**的钩子数(**47** = 52 − 4 根 `stages: [manual]` − `gitlint`;2026-11-17 摘
|
||||
`iec104-unit-test` 前是 48,2026-10-30 加 `mermaid-syntax` 前该式子右侧是 51/47),再加 `gitlint` 1 条
|
||||
(它声明在本配置的 `repo: jorisroovers/gitlint` 条目、`stages: [commit-msg]`(第 70 行),
|
||||
`--hook-stage commit` 的枚举不含它——**2026-11-18 实测**:
|
||||
`--hook-stage commit` 枚举 **47 行** / `manual` 枚举 **51 行** / YAML 解析声明 **52**(47 + 4 + 1 = 52,
|
||||
差的那个就是 `gitlint`;旧说法「gitlint 声明在上游清单、本配置里查不到」已于 2026-10-30 随
|
||||
`stages:` 接线作废)
|
||||
→ 48 + 1 = **49 = 一次 `git commit` 实跑的钩子数**;再加 3 根 manual 阶段的慢钩子才是声明数 52,三数同源(2026-10-29 加 `skill-size` 之前这四个数是 51 / 47 / 48;2026-10-30 加 `mermaid-syntax` 后是 52 / 48 / 49)。
|
||||
→ 47 + 1 = **48 = 一次 `git commit` 实跑的钩子数**;再加 4 根 manual 阶段的慢钩子才是声明数 52,三数同源(2026-10-29 加 `skill-size` 之前这四个数是 51 / 47 / 48;2026-10-30 加 `mermaid-syntax` 后是 52 / 48 / 49;**2026-11-18 摘 `iec104-unit-test` 并加 `iec104-tcp` 后是 52 / 47 / 48**)。
|
||||
枚举自查(不执行任何钩子,`SKIP` 列全部 id):`SKIP=<全部 id> -m pre_commit run --all-files --hook-stage commit`
|
||||
输出 47 行、`--hook-stage manual` 输出 50 行(47 常规 + 3 慢的)。
|
||||
- **三根慢钩子在 manual 阶段**:`cppcheck`、`test-cppcheck`、`test-coverage` 带 `stages: [manual]` → `git commit`
|
||||
阶段**不跑**(实测三根合计约 165 s,占一次带代码提交耗时的约三分之二),只在**远端 CI 的「手动阶段门禁」步**
|
||||
(`.gitea/workflows/ci.yml`,逐根 `--hook-stage manual`)与 `scripts/ci_local.py` 的 **manual 段**里跑。
|
||||
输出 47 行、`--hook-stage manual` 输出 51 行(47 常规 + 4 慢的)。
|
||||
- **四根慢钩子在 manual 阶段**:`cppcheck`、`test-cppcheck`、`test-coverage`、`iec104-tcp` 带
|
||||
`stages: [manual]` → `git commit` 阶段**不跑**(实测前三根合计约 165 s,占一次带代码提交耗时的约三分之二;
|
||||
`iec104-tcp` 另需模拟器构建产物、单跑约 14 s),只在**远端 CI 的「手动阶段门禁」步**
|
||||
(`.gitea/workflows/ci.yml`,逐根 `--hook-stage manual`;⚠ `iec104-tcp` **远端 CI 跑不了**——CI 不构建模拟器)
|
||||
与 `scripts/ci_local.py` 的 **manual 段**里跑。
|
||||
本地手工复跑:`& '.venv\Scripts\python.exe' -m pre_commit run --all-files --hook-stage manual <hook-id>`
|
||||
(**一次只能给一个 id**,多 id 实测报 `unrecognized arguments`)。声明数仍是 52,变的是「提交期实跑几根」。
|
||||
- 通用机制(三个阶段 = `pre-commit` / `commit-msg` / `manual`、stash 陷阱、`always` 已废、增量拦截三段式、旧 §2.x 查号表):
|
||||
`docs/代码规范/pre-commit使用说明.md` §2。
|
||||
- 快速自查(不等提交):`& '.venv\Scripts\python.exe' scripts/ci_local.py`(静态段 48 根 + manual 段三根 + 提交信息门禁 + 体积门禁 + 主机侧纯逻辑单测;manual 段默认跑)。
|
||||
- 快速自查(不等提交):`& '.venv\Scripts\python.exe' scripts/ci_local.py`(静态段 47 根 + manual 段四根 + 提交信息门禁 + 体积门禁 + 主机侧纯逻辑单测;manual 段默认跑)。
|
||||
|
||||
## 1. 三种拦截姿态(先分清这个,报错时才知道该干什么)
|
||||
|
||||
| 姿态 | 含义 | 有哪些 | 失败时该做什么 |
|
||||
|---|---|---|---|
|
||||
| **改写型** | 不报错,直接改你的文件 | `trailing-whitespace`、`end-of-file-fixer` | 重新 `git add` 被改的文件再提交(它改的是工作区,不是索引) |
|
||||
| **硬拦截** | 违反即失败,没有存量豁免 | `cppcheck`、`coding-standard`、`doc-links`、`no-mojibake`、`mem-budget`、`ui-golden`、`font-charset`、`lv-conf-sync`、`task-table`、`mem-numbers`、`registration-check`、`cubemx-survival`、`test-suite-switch`、`mermaid-syntax`(基线为空,先例是已退役的 `id-check-new`「零语料」;唯一排除面 = 外部资料目录,见其专篇 §7)、22 个主机单测、官方 5 个、`gitlint` | 只能改代码或改文档;**不要**找豁免开关 |
|
||||
| **硬拦截** | 违反即失败,没有存量豁免 | `cppcheck`、`coding-standard`、`doc-links`、`no-mojibake`、`mem-budget`、`ui-golden`、`font-charset`、`lv-conf-sync`、`task-table`、`mem-numbers`、`registration-check`、`cubemx-survival`、`test-suite-switch`、`mermaid-syntax`(基线为空,先例是已退役的 `id-check-new`「零语料」;唯一排除面 = 外部资料目录,见其专篇 §7)、21 个主机单测、官方 5 个、`gitlint` | 只能改代码或改文档;**不要**找豁免开关 |
|
||||
| **增量拦截** | 规则恒生效,但存量钉在基线/台账里,只许减不许增 | `layer-deps`(3 条,2026-10-25 还清 UI 记录 3 条)、`bsp-err`(38 条)、`generated-fresh`(5 处 `docs/images/` 配图存量,脚本内 `BASELINE`)、`nested-comment`(2 处主机侧假件头,`test/host/common/`,脚本内 `BASELINE`) | 报错先分清是**新增**还是**存量搬家**:`--verbose` 看归类,`--prune` 看已还清 |
|
||||
| **只查新增** | 只看本次改动的增量,没有存量基线,也没有台账 | ~~`id-check-new`~~(**2026-10-29 退役**,脚本在 `scripts/archive/id_gate/`;这一姿态已无现役门禁) | 手工复查时才谈得上:改成语义短语(门禁不再跑,行内 `[编号豁免]` 也随之失效) |
|
||||
|
||||
⚠ 增量拦截最容易误会的一点:**绿灯不等于没问题**,只等于"没有比上次更差"。
|
||||
每个增量拦截门禁的基线数字都写进它自己的文档,读那篇时第一眼看的就是"现在在册多少条"。
|
||||
|
||||
## 2. 索引(52 个 hook → 30 篇,其中 2 篇是已退役门禁的留档 + 1 根只有本表指针(专篇待补)+ 1 根详解在 docs/测试说明/)
|
||||
## 2. 索引(52 个 hook → 30 篇,其中 2 篇是已退役门禁的留档 + 2 根只有本表指针(专篇待补)+ 1 根详解在 docs/测试说明/)
|
||||
|
||||
> 带 `stages: [manual]` 的三根(`cppcheck` / `test-cppcheck` / `test-coverage`)**提交期不跑**,只在远端 CI 的
|
||||
> 「手动阶段门禁」步与 `scripts/ci_local.py` 的 manual 段跑;下表对应两行的「文档」列已标注。
|
||||
> 带 `stages: [manual]` 的四根(`cppcheck` / `test-cppcheck` / `test-coverage` / `iec104-tcp`)**提交期不跑**,只在远端 CI 的
|
||||
> 「手动阶段门禁」步与 `scripts/ci_local.py` 的 manual 段跑(⚠ `iec104-tcp` 远端 CI 跑不了,见该行说明);下表对应各行的「文档」列已标注。
|
||||
|
||||
| 门禁文档 | 覆盖的 hook id | 一句话它在查什么 | 改了哪类文件才会跑 | 文档 |
|
||||
|---|---|---|---|---|
|
||||
@@ -80,11 +87,12 @@
|
||||
| [`cubemx-survival.md`](cubemx-survival.md) | `cubemx-survival` | CubeMX 重生成会不会把定制静默抹掉(人工目检审计兜底) | `.ioc`、`Src/`、`Inc/` | 已写 |
|
||||
| [`test-suite-switch.md`](test-suite-switch.md) | `test-suite-switch` | 板级套件开关必须互斥;全注释 = 产品构建 | `test/board/test_config.h` | 已写 |
|
||||
| [`font-charset.md`](font-charset.md) | `font-charset` | UI 用到的汉字是否都在子集字体里(缺字 = 白框) | `Drivers/BSP/UI/**`、字体脚本 | 已写 |
|
||||
| [`ui-golden.md`](ui-golden.md) | `ui-golden` | UI 像素回归:菜单 8 状态 + 内容页 74 张黄金参考图比对 | UI 源码、模拟器 | 已写 |
|
||||
| [`ui-golden.md`](ui-golden.md) | `ui-golden` | UI 像素回归:菜单 8 状态 + 内容页 76 张黄金参考图比对 | UI 源码、模拟器 | 已写 |
|
||||
| [`bom-guard.md`](bom-guard.md) | `bom-guard` | 带 BOM 的文件被编辑工具剥掉 BOM(ARMCC 换解码 → 假语法错) | `Drivers/BSP/UI/**` 等名单内文件 | 已写 |
|
||||
| [`setview-check.md`](setview-check.md) | `setview-check` | 定值查看行表与 `prot_set` 枚举序 / `g_prot_set_meta` 上下限是否同一份口径 | `tools/setview_check/**`、`ui_w_setview.*` | 已写 |
|
||||
| (专篇待补,档位与限度正文在 [`../UI设计/UI_自动化测试流程.md`](../UI设计/UI_自动化测试流程.md) §7.3) | `uinav-selftest` | 板端 UI 导航器认屏快检(黄金参考帧分类;完整闭环档=合入前/上板前手工跑,快检不互替) | `scripts/board_ui_nav.py`、`simulator/tests/ref/*.bin` | 指针 |
|
||||
| [`host-unit-tests.md`](host-unit-tests.md) | 22 个 `*-unit-test` | 主机侧单测(同一机制 22 个实例):逻辑层在无硬件的 PC 上编译并跑断言 | 各自被测模块与其测试目录 | 已写 |
|
||||
| (专篇待补,判据与包装器说明在 `scripts/check_iec104_tcp.py` 文件头的注释块里) | `iec104-tcp` | IEC 104 真实回环验收:`test/host/iec104_dtu/run_tcp_test.py` 的 11 条真实 TCP 用例(STARTDT/TESTFR、总召、电度、读、定值、区间、未知请求、最大 APDU、命令一律否定确认、校时不改主机钟) | IEC 104 装配层 / 协议库 / 该测试目录 / 模拟器源码 / 门禁自身 | 指针(`stages: [manual]`;⚠ 远端 CI 跑不了——CI 不构建模拟器) |
|
||||
| [`host-unit-tests.md`](host-unit-tests.md) | 21 个 `*-unit-test` | 主机侧单测(同一机制 21 个实例):逻辑层在无硬件的 PC 上编译并跑断言 | 各自被测模块与其测试目录 | 已写 |
|
||||
| 详解在 [`../测试说明/单元测试/主机单测覆盖率口径.md`](../测试说明/单元测试/主机单测覆盖率口径.md)(口径 / 分母 / 基线 / 盲区都在那篇,本目录不重复) | `test-coverage` | **覆盖率总闸**:跑全部 47 套主机单测 + 已覆盖行只增不减的回退台账 | `App/`、`Drivers/BSP/`、`test/host/`、脚本与基线 | 已写(在 `docs/测试说明/`;`stages: [manual]`) |
|
||||
| [`trailing-whitespace.md`](trailing-whitespace.md) | `trailing-whitespace` | 行尾空白(改写型;CubeMX/Keil 生成文件豁免) | 全部 | 已写 |
|
||||
| [`end-of-file-fixer.md`](end-of-file-fixer.md) | `end-of-file-fixer` | 文件末尾必须恰好一个换行(改写型;同豁免) | 全部 | 已写 |
|
||||
|
||||
@@ -27,7 +27,7 @@
|
||||
|
||||
## 3. 触发面 / 看不见什么
|
||||
|
||||
- `git commit`、`--amend`、`-F`、合并生成的提交都会跑;**`--no-verify` 连它和其它 47 个 `pre-commit` 阶段钩子一起跳过**(`stages: [manual]` 的三根慢钩子(`cppcheck` / `test-cppcheck` / `test-coverage`)本来就不随提交跑,不受影响)。
|
||||
- `git commit`、`--amend`、`-F`、合并生成的提交都会跑;**`--no-verify` 连它和其它 47 个 `pre-commit` 阶段钩子一起跳过**(`stages: [manual]` 的四根慢钩子(`cppcheck` / `test-cppcheck` / `test-coverage` / `iec104-tcp`)本来就不随提交跑,不受影响)。
|
||||
- 不校验:提交说明与 diff 是否相符、是否真的构建/测试过、是否夹带无关改动、是否该拆成多笔。
|
||||
|
||||
## 4. 报错怎么读
|
||||
|
||||
@@ -90,14 +90,16 @@
|
||||
4. **专属钩子不是唯一防线,而「没有专属钩子」也不等于「没被跑」**。2026-10-26 按 git 历史与实测重新
|
||||
清点(2026-10-28 复点、2026-10-29 录波三套入库后再复点:下列数字已按复点值更新;上一版写「16 个模块有专属钩子、另有 12 套、总闸跑 28 套」——三个数都随 2026-10-25 的
|
||||
六根新钩子与后续新增套件过期了,正是本目录反复在防的"文档与机器面不同码"):
|
||||
- **22** 根专属钩子 = 有独立 `files:` 触发面、需要**秒级归因**的那个子集;
|
||||
- **21** 根专属钩子 = 有独立 `files:` 触发面、需要**秒级归因**的那个子集(2026-11-17 由 22 → 21:
|
||||
旧 IEC 104 协议栈单测钩子随 `iec104_asdu/pts/link` 三源退役而摘除,其测试脚本已不存在);
|
||||
⚠ 紧随其后的套数与无钩子数是 **2026-10-30 的复点值**,套数复点另立一项,本页未同步;
|
||||
- `test/host/` 下带 `run_unit_test.py` 的套件实测 **47** 套(48 个目录,除 `common` 与
|
||||
`__pycache__`;两个数分别来自 `check_test_coverage.py --list`(47 行)与 `ls -d test/host/*/`(48 个目录),2026-10-30 复点)
|
||||
⇒ **没有专属钩子的是 25 套**:`boot_stats`、`cfg_file_store_mcu`、`console_log`、
|
||||
`ftp_cfg`、`iec104_serv`、`lftpd`、`lftpd_inet`、`lftpd_io`、`net_cfg`、`net_events`、
|
||||
`net_listener`、`net_pending`、`net_select`、`net_socket`、`prot_set_store`、`sb_led_map`、`sb_link`、`sb_proto`、`soe_store`、
|
||||
`sys_log_mcu`、`task_prof`、`ui_sink`、`wave_ring`、`wave_store`、`wave_trig`(末三套 2026-10-29 随
|
||||
故障录波入库,屏板三套(`sb_proto`/`sb_link` 2026-10-29、`sb_led_map` 2026-10-30)随屏板链路入库,同一条 Lead 裁定不补专属钩子;25 = 47 套 − 22 根专属钩子,逐点数与两处机器源互证);
|
||||
故障录波入库,屏板三套(`sb_proto`/`sb_link` 2026-10-29、`sb_led_map` 2026-10-30)随屏板链路入库,同一条 Lead 裁定不补专属钩子;25 = 47 套 − 22 根专属钩子,逐点数与两处机器源互证。**这三个数整体是 2026-10-30 复点口径**:2026-11-17 摘钩后专属钩子为 21 根,套数复点另立,勿把 21 与 25 直接相减);
|
||||
- 这 22 套每次 CI 与 `scripts/ci_local.py` 都由 `test-coverage` **总闸**真跑(该钩子带 `stages: [manual]`:
|
||||
`git commit` 阶段不跑它,这一根与 `cppcheck` / `test-cppcheck` 同属 CI 与 `ci_local.py` 的 manual 段);
|
||||
发现规则是
|
||||
|
||||
@@ -92,5 +92,6 @@ R1 改图类型头;R2 改 `-.->|t|` 或 `-. t .->`;R3 补/删 `end`(打印
|
||||
是两份字面拷贝,改一处必改另一处——手跑面与提交面不一致就会变成「两个数」。
|
||||
- 判定用「行首 token / 邻接字符」这类保守形态学,**不要**用「看起来像标签」的启发式——
|
||||
本仓围栏里混排中英文、全角符号、`µ`/`≠`/`→` 等字符,启发式必误伤。
|
||||
- 本条钩子使 YAML 解析口径 **51 → 52**、提交期实跑 **48 → 49**;加/摘钩子按
|
||||
- 本条钩子使 YAML 解析口径 **51 → 52**、提交期实跑 **48 → 49**(历史行,其后的 2026-11-17/18 两笔
|
||||
——摘 `iec104-unit-test`、加 `iec104-tcp`——把口径收敛回 52 / 47 / 48);加/摘钩子按
|
||||
`docs/门禁说明/README.md` §2 首条的自查命令三数同核(索引 §2 标题与 §1 计数同批改)。
|
||||
|
||||
@@ -35,7 +35,7 @@
|
||||
|---|---|
|
||||
| 全树实扫 | \`.dsh/skills\` 共 **17 个 SKILL.md:0 FAIL、0 WARN**,最大 \`task-worktree\` 28139 字节(42%);退出码 0 |
|
||||
| \`--selftest\` 五形态 | **5/5**:干净树 0 / 75% 线 0(带 WARN)/ 65546 字节 1 / 悬空指针 + BOM 1 / 根不存在 2 |
|
||||
| 钩子接线 | YAML 解析条目 **51 → 52**;\`stages: [manual]\` 仍 **3** 根(一次 \`git commit\` 实跑 49);\`pre-commit run skill-size --all-files\` 与 \`--files .dsh/skills/task-worktree/SKILL.md\` 两种触发都 **Passed** |
|
||||
| 钩子接线 | YAML 解析条目 **51 → 52**;\`stages: [manual]\` 仍 **3** 根(一次 \`git commit\` 实跑 49);\`pre-commit run skill-size --all-files\` 与 \`--files .dsh/skills/task-worktree/SKILL.md\` 两种触发都 **Passed**(以上为 2026-10-29 接线当时的实测值,保留原样;当前口径见 \`docs/门禁说明/README.md\` §2:声明 52 / pre-commit 阶段 47 / 一次 commit 实跑 48 / manual 4) |
|
||||
| 解释器面 | 钩子 entry 用裸 \`python\`:\`.venv\` 3.12 与 PATH 上的 3.14.7 都跑通——本脚本纯标准库,**不属于**「裸 `python` 不等于 `.venv`」那条教训的适用面(判据在 `keil-build` skill「调用形态」;那条针对 fontTools 这类第三方依赖) |
|
||||
| 负例落点 | 在 \`--selftest\` 的**临时树**里造,不在 \`.dsh/skills/\` 下造探针目录:那是活动技能目录,加载器与自进化都会看见它(见 §8) |
|
||||
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
# `ui-golden` — UI 像素回归(菜单 8 状态 + 内容页 74 张黄金参考)
|
||||
# `ui-golden` — UI 像素回归(菜单 8 状态 + 内容页 76 张黄金参考)
|
||||
|
||||
> 一句话:改 UI 源码时,把模拟器增量重编 + 两条 golden 回归串成一次提交门禁,**像素对不上就拦**。
|
||||
> 它是包装器:真正的判据在被包装的两条脚本与参考图里。
|
||||
@@ -11,7 +11,7 @@
|
||||
## 1. 它在查什么
|
||||
|
||||
- 菜单侧:整棵菜单树的行渲染结果(8 个状态)与参考图逐像素比对;
|
||||
- 内容页侧:74 张黄金参考(= 74 个截图态条目,同一内容页的多个状态各一张:分页页多拍的第 2 屏与确认链/录波的各态都单独计条目),逐张与参考图比对;
|
||||
- 内容页侧:76 张黄金参考(= 76 个截图态条目,同一内容页的多个状态各一张:分页页多拍的第 2 屏与确认链/录波的各态都单独计条目),逐张与参考图比对;
|
||||
- 参考图 `simulator/tests/ref/*.bin` **就是判据本身**。
|
||||
|
||||
## 2. 为什么要它(有牙的实测)
|
||||
@@ -57,7 +57,7 @@
|
||||
|
||||
1. **参考图即判据**:刷新参考图 = 修改判据。评审时必须盯 `simulator/tests/ref/` 的 diff;
|
||||
一旦"顺手更新",此后所有回归都只在和错的基线比。**门禁无法阻止这件事**,只能靠评审。
|
||||
2. 只覆盖 8 个菜单状态 + 74 张内容页黄金参考:未列入的状态(密码错误态、超长文本、缺字渲染、
|
||||
2. 只覆盖 8 个菜单状态 + 76 张内容页黄金参考:未列入的状态(密码错误态、超长文本、缺字渲染、
|
||||
无 SD 卡 / 挂载失败的降级显示)**不会有任何回归**。
|
||||
3. 跑的是**模拟器那份配置**,不是固件那份 —— 两份 `lv_conf.h` 漂移时,回归结论不能外推到固件
|
||||
(所以 `lv-conf-sync` 是本门有效性的前提)。
|
||||
|
||||
Reference in New Issue
Block a user