wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 30 Pull Requests Actions Packages Projects 2 Releases Wiki Activity

实施A2/A3/A4并通过真机验证：net_task失败重试自检、ch395f有限超时故障锁存、remo_send短写阻断；@test 7/7，A1含配置持久化闭环

Browse Source
This commit is contained in:
Wanderingss
2026-10-03 09:05:57 +08:00
parent ddbba714f7
commit 1780e5320b
8 changed files with 165 additions and 33 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/内存管理/RAM使用分析与优化方案.md
+2 -2
View File
@@ -36,10 +36,10 @@
<!-- MEM_SNAPSHOT:BEGIN generated by scripts/check_mem_numbers.py -->
| 区域 | 用量 | 容量 | 占比 |
|---|---|---|---|
| ER_IROM1 | 264,284 B (258.09 KB) | 1,048,576 B (1024 KB) | 25.2% |
| ER_IROM1 | 264,936 B (258.73 KB) | 1,048,576 B (1024 KB) | 25.3% |
| RW_IRAM1 | 84,952 B (82.96 KB) | 131,072 B (128 KB) | 64.8% |
| RW_CCM | 49,184 B (48.03 KB) | 65,280 B (64 KB) | 75.3% |
| **Flash (ROM 合计)** | **265,012 B (258.8 KB)** | 1,048,576 B (1024 KB) | **25.3%** |
| **Flash (ROM 合计)** | **265,668 B (259.4 KB)** | 1,048,576 B (1024 KB) | **25.3%** |
<!-- MEM_SNAPSHOT:END -->
各区的容量与常量来源：
docs/审查记录/下一步任务规划.md
+2
View File
@@ -49,6 +49,8 @@
### 阶段 A：立即执行（改动小、风险高、当周可完）
> **状态（2026-10-03）**：A1~A4 全部**已实施并通过真机验证**——详见 `测试说明/实机测试实施指南.md` §3.2（A1 判定 PASS 含配置持久化；A2/A3/A4 正常路径零回归；芯片级失败分支/短写/拔线负向场景记为待办，待专项台架窗口）。A5 待查手册。
> 目标：清掉"会静默坏事"的产品级风险 + 还清验证债。全部是一档性质，无架构变更。
| 序 | 任务 | 为什么现在 | 入口 | 完成判据 |
docs/待处理内容.md
+1
View File
@@ -29,6 +29,7 @@
| # | 事项 | 说明 | 出处 |
|---|---|---|---|
| N-4 | **pending 机制二期：ACCEPT + SEND 阻塞路径 pending 化**——E-06（accept 轮询计时失真）、E-20（lftpd 控制通道 errno 分类/501）、E-21（timeSync errno 分级）剩余分量共用该机制扩展；届时 L3/L5 基线再重锁、探针族扩充（close/reconfig/EOF/disconnect-during-pending）、看门狗接 selftest 留痕、模拟器差距清单 +1 | 一期（RECV）已落地并入主线：`a45c0cb`（+文档闭环 `7ff2958`）；架构现状见 `Net层阻塞模型架构设计.md`，二期设计基线与门禁见 `下一步任务规划.md` §3.1 | 同左 + `错误码传播审计.md` 第二档 #2 |
| N-16 | **A2/A4 专项场景台架验证待办**（正常路径已实测零回归，2026-10-03）：① PHY 拔线负向测试——断链需断 **DTU 侧**线缆或关**受管交换机端口**（拔交换机侧线缆链路仍 UP，CH395 对交换机拓扑），断链后复位验证 `PHY: DISCONNECT` + 自检台账 `comms fault` 降级放行；② A2 芯片级 `net_init` 失败分支（需 SPI 故障注入，验证 `net init fail` 自检 + 30s 重试恢复）；③ A4 短写压测（需远显客户端 + UI 推流压力，验证 `remo send short` 告警/阻断/重连恢复） | 2026-10-03（台架；台架拓扑 = CH395↔交换机，拔线操作受限） | `实机测试实施指南.md` §3.2 真机判定表 |
## 可靠性与自恢复
docs/测试说明/实机测试实施指南.md
+27 -10
View File
@@ -42,7 +42,7 @@
| A1 | 工作区干净 | `git status --short` | 无输出（或有明确待提交项） |
| A2 | 产品构建 0/0 | `& "MDK-ARM\build.bat"` | 末行 `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 round 1~6）→ **264,284 B（当前，含 round 7~9）**；明显阶跃 ≈3.7KB 及以上（10-02 实测产品 262,836 → 套件 266,540）= 停在套件态 → 重跑 A2 |
| A4 | `.map` 非测试态 | 看 `MDK-ARM/STM32F407-Demo/STM32F407-Demo.map` 的 `ER_IROM1` | 产品态基线随已接受的修复增长：262,100（初版）→ 262,836 B（10-02 round 1~6）→ 264,284 B（round 7~9）→ **264,936 B（当前，含 A2/A3/A4 补码）**；明显阶跃 ≈3.7KB 及以上（10-02 实测产品 262,836 → 套件 266,540）= 停在套件态 → 重跑 A2 |
| A5 | 全量静态门禁 | `pre-commit run --all-files` | **16/16 Passed** |
| A6 | ST-LINK 探针可见 | `& "MDK-ARM\reset.bat" list`（CLI 经 `DTU_STLINK_CLI` / PATH 解析） | 列出探针 SN `0B250D12A218303030303032` |
| A7 | 串口端口正确 | 检查 `.opencode/serial_config.json` 的 `portName` | 端口单一配置源 = 此文件（当前 COM6，2026-09-21 台架重插后由 COM7 变更）；变更后先杀旧 daemon 再 `open` |
@@ -89,15 +89,24 @@
| 序 | 事项 | 代码状态（2026-10-02 核对） | 上板判据 | 命令/入口 |
|---|---|---|---|---|
| **A1** | **P0-1 `cfg_file` 堆分配改造** | **已落地**（分配收进 `cfg_store_alloc/free` 平台后端；模拟器用宿主堆，**照不出** `Heap_Size=0x200`（512B）约束——真机是最后一道门） | 串口日志出现 `/config.ini` **`load: OK`**；Forbidden `FAIL`/`[ERR]` 零命中；**保存配置后复位，值持久** | `& '.venv\Scripts\python.exe' test/host/run_boot_test.py` |
| **A2** | **P1-8 网络重建失败恢复** | **部分落地**：首启链路超时已有 `comms fault` 自检（`net_task.c` L131）；重建（reconfig）失败路径仅一条 `DBG_ERROR`，**无自检记录、无周期重试**；首启 `net_init` 失败 = netTask 无限驻留（L206-210） | 补码后：失败路径写 syslog 自检 + 30s 周期重试；**不自驻留死循环**；恢复后各 TCP 服务据代次号重建监听；`@test` PASS | 补码 → `@build` → `@test`；UI 网口设置页改 IP；`test/host/e02_probe.py` |
| **A3** | **E-34 CH395F 字节命令超时** | **未落地**（`ch395f.c` L181/195/210 仍 `HAL_MAX_DELAY` → SPI 异常时 netTask 永久挂死） | 补码后：有限超时（100~500ms）+ 返回值检查；构建 0/0；**正常通信零回归**（FTP 传输正常） | 补码 → `@build` + `@test` |
| **A4** | **E-04 `remo_send` 返回值** | **未落地**（`ui_net_sink.c` L119 仍丢弃 `net_send` 返回值；短写 → 客户端 CRC 失败 → 画面卡死黑屏而设备侧日志全正常） | 补码后：改返回 `int` 校验 `ret == len`；短写 `DBG_ERROR` + 连续失败强制重连；**UI 推流压力下无黑屏** | 补码 → `@build` + UI 远显推流压力回归 |
| **A1** | **P0-1 `cfg_file` 堆分配改造** | **已落地**（分配收进 `cfg_store_alloc/free` 平台后端；模拟器用宿主堆，**照不出** `Heap_Size=0x200`（512B）约束——真机是最后一道门） | 串口日志出现 `[CFG]` **`load: OK (…B, heap free …B)`**（实测行格式）；Forbidden `FAIL`/`[ERR]` 零命中；**保存配置后复位，值持久** | `& '.venv\Scripts\python.exe' test/host/run_boot_test.py` |
| **A2** | **P1-8 网络重建失败恢复** | **已落地**（2026-10-02 补码）：首启组网失败 = 自检 `net init fail` + 30s 周期重试（1s 分片喂心跳，**不自驻留**）；重建（reconfig）失败 = 自检 `net reinit fail` + 30s 延迟重触发事件位（tick 回绕安全），成功即清零；PHY 链路超时仍走既有 `comms fault`（降级放行，语义不变） | 失败路径写 syslog 自检 + 30s 周期重试；**不自驻留死循环**；恢复后各 TCP 服务据代次号重建监听；`@test` PASS | `@build` → `@test`；UI 网口设置页改 IP（触发重建路径）；`test/host/e02_probe.py` |
| **A3** | **E-34 CH395F 字节命令超时** | **已落地**（2026-10-02 补码）：3 处字节级 SPI 调用 = 有限超时 100ms + 返回值检查；失败锁存 `ch395f_spi_byte_fault()`（仅首条故障记日志，防刷屏）——SPI 异常不再挂死 netTask | 构建 0/0；**正常通信零回归**（FTP 传输正常、启动无 `SPI byte op fail` 行） | `@build` + `@test` |
| **A4** | **E-04 `remo_send` 返回值** | **已落地**（2026-10-02 补码）：`remo_send` 改返回 `int` 校验 `ret == total`；短写/失败 → `DBG_ERROR` + 连续失败计数；连续 3 次 → **阻断推送**（客户端察觉无帧自行重连，芯片侧 DISCONNECT/TIMEOUT 自动重开监听；MCU 单连接模型**不** `net_close` 数据 fd），新连接/网络重建时解除 | 短写可观测（串口 `remo send short` 告警）+ 连续失败阻断 → 重连恢复；**UI 推流压力下无黑屏** | `@build` + UI 远显推流压力回归 |
> **A5（P1-7 MAC 写入顺序）**：**先查手册**（CH395F §9.2.1 INIT 是否锁存 MAC），
> 再决定改或文档化"无需调整"——**属离线可做部分**，不在本文强绑。
### 3.3 自检项清单（S7 判定对象，18 处）
**真机判定（2026-10-03，本机 MCU，新固件全闭环 `@test` PASS 7/7）**：
| 项 | 判定 | 证据 |
|---|---|---|
| A1 | ✅ **PASS（含持久化）** | `[CFG] load: OK (523B, heap free 8840B)`（经 FreeRTOS 堆分配——512B C 堆约束的验收点）；Forbidden 零命中；FTP 改配置 IP→.101 后复位即加载生效（`[NET_CFG] load: OK ip=192.168.1.101` + 芯片 `IP_INF` .101 + 21 端口探测可达），原档恢复后复测回 .100 |
| A2 | ⚠️ **正常路径零回归**；失败分支待专项窗口 | 开机 `net init: OK` / `PHY: 100M FULL` / `netTask: started`，**无 `init FAIL` / `retry in 30s` 误触发**；芯片级 `net_init` 失败分支需故障注入、UI 重建路径需 UI 操作，台架无自然触发（PHY 链路超时走既有 `comms fault` 降级路径，未改动）；拔线负向测试因台架线缆拓扑记待办（N-16） |
| A3 | ⚠️ **正常路径零回归**；故障分支待专项窗口 | 开机全部芯片 SPI 命令正常（MAC/IP_INF 回读正确），**`SPI byte op fail` 零出现**；SPI 异常分支（故障锁存）只能经故障注入验证 |
| A4 | ⚠️ **无误报基线**；推流压测待专项窗口 | 开机 UI 远显服务正常启动（port 7003 监听），无客户端连接时**零 `remo send short` 误报**；短写判定/阻断重连路径需远显客户端 + 推流压力验证 |
### 3.3 自检项清单（S7 判定对象，20 处）
> 来源：全库 `syslog_post(SYSLOG_SELFTEST, ...)` 调用点。**这是 S7 的判定覆盖面基准**。
@@ -106,7 +115,7 @@
| `App/app/app_main.c` | `watchdog reset` / `clock chip fault` / `NAND fault` / `ADC fault` |
| `App/cfg/cfg_file.c` | `cfg heap alloc fail`(×3) / `cfg template write fail` / `cfg load oversized` / `cfg load read fail` / `cfg save read fail` / `cfg save overflow` / `cfg save write fail` / `cfg poll oversized` |
| `App/task/default_task.c` | `filesystem fault`(×2) / `storage fault`(×2) |
| `App/task/net_task.c` | `comms fault` |
| `App/task/net_task.c` | `comms fault` / `net init fail` / `net reinit fail` |
**联动**：`syslog_post` 的两级自愈（L1 文件级重试 / L2 错误去重 `s_fault_reported[]`）
决定**持续故障只留第一条**——故 S7 判定"有记录即 FAIL"是**充分**的（不会被去重掩盖）。
@@ -167,12 +176,13 @@ $cli = if ($env:DTU_STLINK_CLI) { $env:DTU_STLINK_CLI } else { (Get-Command ST-L
## 5. 堆低水位告警实测（P1-B，S11）
**现状证据**：上一轮实测 `free=8,784 / min_ever=4,848 B`（初始 `configTOTAL_HEAP_SIZE` 48KB），
**min_ever 已低于 5KB**，余量不到 10%——新增任务/缓冲可能触发分配失败。
**现状证据**：2026-10-03 上板复测 `free=8,688 / min_ever=3,712~4,728 B`
（两次开机，运行间波动 ≈1KB；初始 `configTOTAL_HEAP_SIZE` 48KB）——
**min_ever 下限已跌破 4KB**，余量不到 8%，新增任务/缓冲可能触发分配失败。
现有代码仅有周期性 `[STACK]` 报告（每周期打印 `heap free/min_ever`），**无阈值告警、不写自检记录**。
**待补代码**（约 15 行 + 1 个编译期常量，在 `defaultTask` 低频循环（LED 闪烁节拍）内）：
检查 `xPortGetMinimumEverFreeHeapSize()`，低于阈值（建议 **4096 B**）时
检查 `xPortGetMinimumEverFreeHeapSize()`，低于阈值（建议 **3072 B**，低于 10-03 实测下限 3,712 B，防运行间波动误报）时
`DBG_ERROR("[HEAP] low water: %u B")` + 写 syslog selftest。
**判据**：台架长跑（复用 §4.2 V5 窗口）下，若发生低水位 → 串口出现告警行 + `selftest.log` 有记录；
@@ -375,6 +385,12 @@ cppcheck --enable=warning --error-exitcode=1 test/ 2>&1 | tee test_cppcheck_base
- 现场改寄存器（如 IWDG PR/RLR 验证手段）须在**一次调用**内完成整段键序列
（解锁→参数→键锁）——分多次调用会超过看门狗超时、中途被复位；寄存器随复位丢失，
只能用于验证，不是修复。
8. **开机良性 `MISS start` 行**（2026-10-03 上板）：看门狗抽样在**开机屏障等待期**偶见
UI 位单抽样缺席，每 episode 记一条裸 UART `MISS start snap=0x… req=0x… t=…`
（`task_watchdog.c` 的停摆起点标记，round-7 取证件）。实测每次开机 2 条
（t≈0.6s / t≈2.8s，snap 仅缺 UI 位），NET_READY 解除后立即恢复——**未达 800ms 停喂
阈值、不触发复位**，属分片心跳与 100ms 抽样边界的固有交错，非回归；
处置：见到该行不必恐慌，**连续**出现 `task stall` 行/复位才是真停摆。
---
@@ -402,6 +418,7 @@ cppcheck --enable=warning --error-exitcode=1 test/ 2>&1 | tee test_cppcheck_base
| 日期 | 变更 |
|---|---|
| 2026-10-02 | **更名**：`实机测试规划.md` → `实机测试实施指南.md`（与文档性质对齐——常设执行判据，非规划；引用面改造后仅剩 `docs/README.md` 索引 1 处，同步更新） |
| 2026-10-03 | **A2/A3/A4 实施 + 真机验证**：A2 = `net_task.c` 初始组网失败/重建失败 → 自检留痕 + 30s 周期重试（分片喂心跳，不自驻留）；A3 = `ch395f.c` 3 处字节级 SPI 调用 `HAL_MAX_DELAY` → 100ms 有限超时 + 返回值检查 + 故障锁存 `ch395f_spi_byte_fault()`（首条记日志）；A4 = `ui_net_sink.c` `remo_send` 校验 `net_send` 返回值，短写告警、连续 3 次失败阻断推送、新连接/网络重建解除（单连接模型不 `net_close` 数据 fd）。`@build` 0/0 + L0/L0.5 全绿 + 模拟器构建通过；上板 `@test` PASS 7/7：A1 判定 PASS（含 IP 改→复位→持久→可达闭环，原档已恢复）、A2/A3/A4 正常路径零回归；自检清单 18→20 处（`net init fail` / `net reinit fail`）；上板新数据：min_ever 下限 3,712 B（S11 阈值建议改 3,072 B）、开机良性 `MISS start` 行新增陷阱 §9.8；拔线负向/短写压测记 `待处理内容.md` N-16 |
| 2026-10-02 | 初版：无 MCU 窗口建立。汇总 P0-A 环境预检 / P0-B `@test`+S7 / P1-A IWDG V2/V4/V5 / P1-B S11 / P2-A S9 / P2-B P1-8+N-2+N-3 / P3 S5+S4+待核实项，共 **7 批**。每项含现状证据 / 目标 / 判据（量化）/ 执行步骤（精确命令）/ 风险回滚。18 处自检调用点清单 + 模拟器差距清单 §3 决策规则交叉引用 |
| 2026-10-02 | **台架窗口执行交接**：新增 **§0.5**（P0-A 通过；S7 已落地并提交 `4a4cd29`；P0-B 唯一阻断 = 0 字节 STOR → IWDG 误复位（round 3~6 后仍 5/5 复现）；round 1~6 修复集摘要；**round 7 纯取证埋点设计 + 判据表**；P0-B 出口闭环（含 FTL flush 诱导式清台账）；设备/台账/本地证据快照；**7 条实测陷阱**）；§2.1 标注 S7 已落地、命令形态已确认 |
| 2026-10-02 | **文档改造**（同 `本地工具路径环境变量方案.md` 思路）：删除一次性台架窗口状态（原 §0.5——round 1~9 取证全过程、快照、未提交警告：结论已沉淀 `看门狗设计说明.md`/`STM32F4-Base存储架构说明.md` §5.4.1/`控制台单写者日志设计说明.md` §12，修复随 `930215f` 提交）与规划框架（预估耗时/阶段措辞），重组为执行判据说明——§1 事项总览 / §2 环境预检 / §3 `@test` 闭环+自检判定+待上板项 / §4 IWDG 注入长跑 / §5 堆告警 / §6 GD5F 错误通道 / §7 网络基线 / §8 工程卫生 / §9 实测陷阱 / §10 引用闭环；A1~A4 代码状态按当日代码核对改写（A1 已落地 / A2 部分 / A3、A4 未补码）；A4 基线更新 264,284 B、A7 端口更正 COM6；原 §0.5.x 的 8 处代码注释、`待处理内容.md` 3 行、`看门狗设计说明.md` 变更记录、`docs/README.md` 同步重指向模块文档 |