docs(波次): 批 2 道D 销项四卡 + F2/F3 修复态与台架待判 + AGENTS 采集链补快照层

- 数据可信 §5:卡 8~11 销项删行(meas 9c2653c / pts+freq 969fc5c / run_par
  7bbcc9c / 快照消费 969fc5c),台架钉证汇总(大窗 S1/S1b 24 项 + 验收窗
  walk 10/12、SOE 真时标、PN 守卫、持久化);README 数据可信行 7→3 卡在途
- 网络行:F2 按位分账已合入 66f862e、F3 sink 往返喂位已合入 9d90e00,
  两条语义标识改为"修复已合入、待台架两轮 30min 双零才销"
- UI 行:批 1~4 落地摘要(黄金 18 页),余批 5 = 整定 4 页 + 写路径
- AGENTS 数据主线采集行:L2.5 遥测快照(meas 200ms 双区)入链,
  消费者标注 104 与 UI 同源
This commit is contained in:
2026-10-25 19:00:51 +08:00
parent 1a624b1fae
commit ceb753bd44
3 changed files with 6 additions and 8 deletions
+1 -1
View File
@@ -14,7 +14,7 @@
**数据主线**(能力视角;分层图与跨层依赖表 → `docs/架构设计/项目架构总览.md`):
- **采集**:TPAFE5160(计量级 8 路,并行总线)+ 片内 ADC1(9 路,DMA)→ TIM3 1 kHz 节拍 + 原子快照 → adcTask → L1 有效性校验 → L2 相量 → L3 保护(protectTask 20 ms 判据节拍,B5)→ 104 遥信上送
- **采集**:TPAFE5160(计量级 8 路,并行总线)+ 片内 ADC1(9 路,DMA)→ TIM3 1 kHz 节拍 + 原子快照 → adcTask → L1 有效性校验 → L2 相量 → **L2.5 遥测快照(`meas` 200 ms 双区,104 与 UI 共用同一份上游,批 2)**+ L3 保护(protectTask 20 ms 判据节拍,B5)→ 104 遥信/遥测上送
- **存储**:GD5F SPI NAND → dhara FTL → FatFs → `/log` 运行与自检记录、`/config.ini` 配置、FTP 根目录
- **网络**:CH395F → netTask 串行 socket 栈 → FTP(21) / 对时(8888) / RemoDispBus 远程显示(7003) / IEC 60870-5-104 上行(2404)
- **人机**:LVGL 160×160 单色菜单(uiTask),**与 PC 模拟器同一份 UI 源码**,远端可看图 + 注键
+3 -3
View File
@@ -56,15 +56,15 @@
| 类别 | 数量 | 条目 |
|---|---|---|
| 网络 | 4 | N-3(L5 基线重验)· N-16(A2/A4 负向台架)· **复合连击串窗**🟦批2.5道F(time_sync 探针大窗修复 a3c6e89 的判读副产物,看门狗连击按位分账)· **重建窗内回执排队把 net 等待者拖过 800ms**🟦批2.5道F(UI 首例;根治 E-27/28 批 3)。本波道F 原三张条目(日志静默观察 / 探针窗口心跳 / 写回 flush)已于 2026-10-25 台架大窗销项删行——心跳主签名在 9 条 stall 行中 NET 位全程在场 = 旧 44/44 必发归零;复跑暴露的两个新签名以语义标识上行为本表独立条目,详 `登记簿.md` §1 |
| 网络 | 4 | N-3(L5 基线重验)· N-16(A2/A4 负向台架)· **复合连击串窗**(time_sync 探针大窗修复 a3c6e89 的判读副产物)修复**已合入** 66f862e——看门狗连击按位分账,此后每个 stall 行都是真单任务链 · **重建窗内回执排队把 net 等待者拖过 800ms**(UI 首例)修复**已合入** 9d90e00——sink 往返返回点喂位(最窄档,不改等待语义;单往返 >800ms 残留归 E-27/28 批 3)。两条**待台架两轮 30min 双零判据(v1.1 口径)后才销项**。本波道F 原三张条目(日志静默观察 / 探针窗口心跳 / 写回 flush)已于 2026-10-25 台架大窗销项删行——心跳主签名在 9 条 stall 行中 NET 位全程在场 = 旧 44/44 必发归零;复跑暴露的两个新签名以语义标识上行为本表独立条目,详 `登记簿.md` §1 |
| 存储 / 日志 | 3 | **S-3(USART1 TX-only 根治)** · S-4(dhara 重试自旋)· S-5(可选全序列卷锁) |
| 结构 / 健壮性 | 3 | N-23(注册校验残余白名单)· N-25(性能/语义簇)· N-28(uvprojx 空 TU 观察) |
| 仓库 | 1 | N-29(`.git` **233 MB**,**已决策暂不处理、登记观察**) |
| 硬件 | 1 | N-18(V0.2 改版项) |
| 测试 / 基础设施 | 3 | T-7(CI 远端两 job 闭环 + 第二机交叉验证)· A-4(采集链路测试约束,RS485 侧随 B2 暂缓)· 串口助手 A6/A7 补验(待 CH340) |
| UI | 1 | U5 页面落地 🟦**批 2 道E 在途**(2026-10-25 开工;`ui_data` 快照层 + 27 叶 + 3 页回炉) |
| UI | 1 | U5 页面落地 🟦**批 2 道E 大部落地**(批 1~4:`ui_data` 三通道 + 遥信 33 行 + 定值查看 4 页 + 记录页 reader 链,黄金 18 页入库;余批 5 = 整定 4 页 + `param_request` 写路径,板端有状态导航器已备) |
| **暂缓** | 2 簇 | **B2 RS-485 整簇**(`暂缓-RS485.md`)· **N-27 内存优化簇剩余**(R-2 后半 / R-3 / R-4 / R-6;重开条件见 `../内存管理/RAM使用分析与优化方案.md` §4)。⚠ 已落地的 R-9 与 `mem-budget` 门禁/台账/趋势**不回退** |
| **数据可信**(当前波次) | 1 簇 · 在途 7 卡 | 🟦批2道D:遥测快照 200 ms · 104 读快照+死区运行参数化 · 运行参数段 · 频率点绑定 |🔴台架/外部:已知电压注入 · 端子变比确认 · 标准源两点标定。**卡 1~7(口径/CFG_VAL_INT/折算/落盘/闭锁/三常数/量纲回归)已于 2026-10-25 销项**(详表 `数据可信.md` §5) |
| **数据可信**(当前波次) | 1 簇 · 在途 3 卡 | 🔴台架/外部:已知电压注入(卡 0,一块万用表就能开)· 端子变比确认(0b,🟡)· 标准源两点标定(12,🟡)。**卡 1~7 批 1 销项、卡 8~11 批 2 销项(2026-10-25,遥测快照/104 读快照/运行参数段/频率绑定全链 + 大窗与验收窗台架钉证;详表 `数据可信.md` §5)** |
> **网络侧 E-xx 存量项**(历史编号族,属主文档已于 2026-10-15 删除,编号冻结见
> `docs/编号规范.md` §4.3):E-27 / E-28 挂「net 层跨上下文收口」(见 `排期详述.md` §1);
+2 -4
View File
@@ -67,6 +67,8 @@ frame[s] = (float)code;
| IB / IC / IN | STM32 ADC1 | 同上 | 805.66 µV | 同上 | **1611.3 µV/码** | ❌ 削顶 |
| TEMP | STM32 ADC1 | 同上 | 805.66 µV | 同上 | 热敏非线性 | — 不纳入线性标定 |
> **卡 8~11 已销项**(2026-10-25 批 2:卡 8 meas 快照 →merge 9c2653c;卡 9/11 快照消费 + 0x401D 频率绑定 + src 类型 →merge 969fc5c;→ "卡 10 run_par(9 键毫伏死区 + k/b 代理 adc_cal + [run_par] 落盘)→merge 7bbcc9c;台架面已钉:大窗 S1/S1b 读回链24 项 + 验收窗(--walk 10/12、SOE 真时标、51V PN、持久化 500)全绿,详见 `../测试说明/` 与 boot_log_data 留档)。余卡:0 / 0b / 12(🟡 外部依赖与台架实测,见上)。
- 通道数:`ADC_SEM_COUNT = 9`(8 电气 + 温度),定义见 `App/algo/adc_input.h`。
- 分压比出处:`docs/硬件平台/ADC通道映射说明.md` §7"前端偏置"行(每路 1k 串联 + 1k 到 `*_GND`)。
- ✅ **口径已定死(2026-10-25,卡 1 销项)**:`docs/硬件平台/ADC通道映射说明.md` §1/§7 统一为
@@ -290,10 +292,6 @@ typedef struct {
|---|---|---|---|---|---|---|
| **0** | **已知电压注入验证(首次功能级 ADC 验证)** | 在**可安全接触的最低一级**(ADC 引脚侧或端子侧,二选一并在证据里写明注入点)用板载 3.3 V 轨经电位器注入 **3 个直流点**(≈0.3 / 1.0 / 2.0 V),每点**同时**用万用表读注入点实际电压 + 读 `adc_input_raw()` 码值:① 三点线性拟合 **R² ≥ 0.999**;② 注入点在引脚侧时,斜率须与 §2.1 理论值(TPAFE 6553 码/V、STM32 1241 码/V)偏差 **≤2 %**;在端子侧时把斜率记为**实测变比**;③ 注入 0 V(短接 AGND)零点 \|码\| ≤ 10(TPAFE)/ ≤ 5(STM32),并解释首帧 ~1000 码的来源;④ **逐通道映射确认**:8 路电气量逐个注入,确认"注入哪一路、哪一路语义变化",语义与下标不符即映射错;⑤ TPAFE 侧原"BUSY 有脉冲"判据**改用固件帧计数**(注入前后 `tpafe5160_frame_seq()` 仍严格 1000 Hz 递增)——不需要示波器;⑥ 结论写回 `docs/硬件平台/ADC通道映射说明.md` §8,把"尚未执行"改为实测值 + 日期 | 1 | 🔴 + 万用表(**不需信号源 / 示波器**) | `docs/硬件平台/ADC通道映射说明.md`、`docs/测试说明/boot_log_data/` | ⬜ |
| **0b** | **端子 / 子板变比确认** | 给出"端子电压 → ADC 引脚电压"的比值(万用表同时量端子与引脚,或查子板原理图后实测核对),写入 `docs/硬件平台/ADC通道映射说明.md`;据此判定 `eng` 能否置 1;数据缺失则本波只交付引脚电压并登记缺口 | 0 | 🟡 子板实物或原理图 | `docs/硬件平台/` | ⬜ |
| **8** | **遥测快照模块(200 ms)** | 新增 `App/algo/meas.c/h`:`meas_snap_t`(§4.5 布局)、`meas_tick()`(由 `adc_task` 200 ms 分频调用)、`meas_get()`、`meas_seq()`;并发沿用 `phasor` 双区 + 单字节索引翻转,读者无锁;主机单测覆盖 seq 递增、双区切换无撕裂、品质汇总(任一点 CLIPPED → 该点 `qds` 置位);RAM 增量 = 2×72 B ≈ 144 B | 2 | 🟢 | `App/algo/meas.*`(新)、`App/task/adc_task.c` | ⬜ |
| **9** | **104 遥测改读快照 + 死区改运行参数** | `s_src_yc_read()` 改为读 `meas_get()`;`k_yc[].deadband` 从编译期常量改为运行时取值(先读 ROM 默认,M6 后读运行参数段);PC 主站总召读回值与工程量一致(记录到 `docs/测试说明/boot_log_data/`) | 6、8 | 🟢 + 🔴 | `App/protocol/iec104/iec104_pts.c` | ⬜ |
| **10** | **运行参数段 `0x8020~0x8058`** | 新增 `App/algo/run_par.c/h`:至少含遥测死区(9 点)+ 通道系数覆盖;cfg 段持久化(键数受 16 限制,必要时再拆段);104 段读写映射(`C_RD`/`C_SE`);主机单测覆盖读写往返 + 越界拒绝 | 4、9 | 🟢 | `App/algo/run_par.*`(新)、`App/protocol/iec104/`、`App/cfg/` | ⬜ |
| **11** | **频率点 `0x401D` 绑定** | `k_yc[]` 的 `0x401D` 从 `-1` 改为频率源(YC 表加 `src` 类型区分 phasor / freq);`freq_valid()==0` 时品质 IV;PC 主站读回频率与 `freq_get()` 一致(±0.01 Hz) | 6 | 🟢 + 🔴 | `App/protocol/iec104/iec104_pts.c` | ⬜ |
| **12** | **8 通道两点标定与精度验收** | 电压 4 路(UA/UB/UC/UN)+ 电流 4 路(IA/IB/IC/IN)各做两点标定(零点 + 满度,温度不纳入),写入 `[adc_cal]` 并置 `VALID`;误差 ≤ 目标精度(待定:0.5 级 / 1 级);证据归档 | 0、0b、4 | 🟡 标准源 / 继保测试仪 | `docs/算法/`、`docs/测试说明/boot_log_data/` | ⬜ |
> **卡 1~7 已销项**(2026-10-25 批 1 道A:`task/cal-scale-doc`→231dc81、`task/cal-adc-cal`→d39e5c9、