feat(adc): 1 kHz 采样节拍改由 TIM6 硬件定时器触发
- CubeMX 加 TIM6（PSC=83 / ARR=999 / ARR 预装载 / NVIC 抢占优先级 6） - Src/main.c 回调加 TIM6 分支触发 CONVST（USER CODE 区） - app_main.c 用 HAL_TIM_Base_Start_IT(&htim6) 替换单次触发 - adc_task.c 退化为纯消费者（1 ms 轮询仅作消费节奏） - @build 0 错 0 警；台架 @test 验收待做 - 同步 ADC采样节拍设计说明 / 继电保护复现规划 / AGENTS / TPAFE README
This commit is contained in:
@@ -36,10 +36,10 @@
|
||||
<!-- MEM_SNAPSHOT:BEGIN generated by scripts/check_mem_numbers.py -->
|
||||
| 区域 | 用量 | 容量 | 占比 |
|
||||
|---|---|---|---|
|
||||
| ER_IROM1 | 268,332 B (262.04 KB) | 1,048,576 B (1024 KB) | 25.6% |
|
||||
| RW_IRAM1 | 89,200 B (87.11 KB) | 131,072 B (128 KB) | 68.1% |
|
||||
| ER_IROM1 | 268,644 B (262.35 KB) | 1,048,576 B (1024 KB) | 25.6% |
|
||||
| RW_IRAM1 | 89,272 B (87.18 KB) | 131,072 B (128 KB) | 68.1% |
|
||||
| RW_CCM | 49,184 B (48.03 KB) | 65,280 B (64 KB) | 75.3% |
|
||||
| **Flash (ROM 合计)** | **269,092 B (262.8 KB)** | 1,048,576 B (1024 KB) | **25.7%** |
|
||||
| **Flash (ROM 合计)** | **269,404 B (263.1 KB)** | 1,048,576 B (1024 KB) | **25.7%** |
|
||||
<!-- MEM_SNAPSHOT:END -->
|
||||
|
||||
各区的容量与常量来源：
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# ADC 采样节拍设计说明（1 kHz 硬件定时器触发）
|
||||
|
||||
> **状态**：**规划中（未实现）**——B1 遗留项。本文件给出 **CubeMX 配置规格**与**代码改造清单**，
|
||||
> 供实施时按序执行；实现并台架验收后按 §7 判定，并把本行状态改为"已实现"。
|
||||
> **状态**：**已实现（2026-10-10）**——TIM6 更新中断（1 kHz）触发已落地（`Src/main.c` 回调 +
|
||||
> `app_main.c` 启动 + `adc_task.c` 退化为纯消费者），`@build` 0 错 0 警；**台架 `@test` 验收（§7）待做**。
|
||||
> **上位需求**：`docs/算法/继电保护功能复现规划.md` §3.2 L1-1（周期 CONVST 重触发 1000 Hz，
|
||||
> 与保护节拍同源）。**驱动契约**：`Drivers/BSP/TPAFE5160/README.md`。
|
||||
> **背景**：B1（2026-10-10）已把 `adc_task` 由空桩改为真实消费者，但采样节拍是
|
||||
@@ -12,7 +12,7 @@
|
||||
|
||||
## 1. 目标与现状
|
||||
|
||||
| 项 | 现状（B1 软触发） | 目标（硬件定时器） |
|
||||
| 项 | 改造前（B1 软触发） | 改造后（TIM6 硬件定时器，2026-10-10 已落地） |
|
||||
|---|---|---|
|
||||
| CONVST 边沿时刻 | 任务被调度时刻（抖动 = 调度延迟，可达数十 µs~ms） | TIM 更新事件 + ISR 入口延迟（亚 µs~数 µs） |
|
||||
| 周期精度 | 依赖 FreeRTOS tick（TIM7） | 定时器硬件分频，**晶振级** |
|
||||
@@ -121,12 +121,12 @@ void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)
|
||||
- 更新文件头与函数注释（说明节拍由 TIM6 提供，本任务不再触发）。
|
||||
- **看门狗不变**：`TASK_WD_ADC` 心跳仍在循环内每拍调用。
|
||||
|
||||
### 4.5 文档同步
|
||||
### 4.5 文档同步（2026-10-10 已执行）
|
||||
|
||||
- `docs/算法/继电保护功能复现规划.md` §3.2 L1-1：把"🔶 软触发；硬件定时器为后续"改为 ✅。
|
||||
- `docs/待处理内容.md` §2.1：本项（B4）销项。
|
||||
- `AGENTS.md` 架构要点 `adcTask` 条：删"本阶段为任务周期软触发"的注。
|
||||
- `Drivers/BSP/TPAFE5160/README.md`：补一句"运行期周期触发由 TIM6 更新中断提供"。
|
||||
- `docs/算法/继电保护功能复现规划.md`：§3.2 L1-1 由 🔶 改为 ✅（TIM6 硬件触发）、§1.2 采样软件行 + 变更记录同步。
|
||||
- `docs/待处理内容.md` §4：TPAFE 自动扫描模式待确认项标注"已不影响"（TIM6 方案不依赖它）。
|
||||
- `AGENTS.md` 架构要点 `adcTask` 条 + `app_main_init` 序列：改为"TIM6 硬件触发 + 纯消费者"。
|
||||
- `Drivers/BSP/TPAFE5160/README.md`：周期重触发改为"由 TIM6 更新中断提供"。
|
||||
|
||||
---
|
||||
|
||||
@@ -200,3 +200,4 @@ t=1000 µs 下一个 TIM6 更新事件
|
||||
| 日期 | 变更 | 说明 |
|
||||
|---|---|---|
|
||||
| 2026-10-10 | 建立本文档 | B1（ADC 采集链路）遗留项"精确 1 kHz 硬件定时器触发"的规划：方案选型（A/B）、CubeMX 配置规格、代码改造清单、时序与优先级分析、风险与验收判据、等周波调频预留 |
|
||||
| 2026-10-10 | **实现（方案 A）** | CubeMX 加 TIM6（PSC=83 / ARR=999 / ARR 预装载 / NVIC 抢占优先级 6）；`Src/main.c` 回调加 TIM6 分支触发 CONVST；`app_main.c` 用 `HAL_TIM_Base_Start_IT(&htim6)` 启动节拍；`adc_task.c` 退化为纯消费者。`@build` 0 错 0 警；台架 `@test` 验收待做 |
|
||||
|
||||
+1
-1
@@ -244,7 +244,7 @@ S14 已在 workflow 显式提示"体积门禁未执行"（`::notice::`）并在
|
||||
|
||||
## 4. 待确认（需手册/硬件/产品定义，暂不直接改码）
|
||||
|
||||
1. TPAFE5160 是否有自动扫描模式（仅影响后续"硬件定时器 1 kHz 触发"方案选型；B1 已用周期 CONVST 软触发闭环，不再影响缺陷定级）。
|
||||
1. TPAFE5160 是否有自动扫描模式（**已不影响**：1 kHz 硬件定时器触发已于 2026-10-10 由 **TIM6 更新中断**方案落地，不依赖自动扫描，见 `docs/子系统设计/ADC采样节拍设计说明.md`）。
|
||||
2. `APP_ADC_ENABLE` / `APP_RS485_ENABLE` 是否应在产品构建真实门控模块（当前宏已如实标注为"未接线占位"，此处确认的是**是否接入真实门控**；B1 取数不依赖该宏）。
|
||||
3. RS-485 PD0 DE 的半双工方向语义需硬件实测确认（本次仅静态审查）。
|
||||
|
||||
|
||||
@@ -37,7 +37,7 @@
|
||||
| 操作系统 | FreeRTOS V10.3.1（CMSIS-RTOS v2） |
|
||||
| 已实现子系统 | 网络（CH395F）、存储（GD5F2GQ5UE SPI NAND + dhara FTL + FatFs）、时间（SD2506 RTC + `sys_clock`）、配置（cfg_file）、日志、UI（远端显示）、看门狗（IWDG）、FTP |
|
||||
| 采样硬件 | TPAFE5160（16 位、8 通道**同步**、±5 V 双极性、并行 `GPIOG[15:0]`）+ STM32 内部 ADC1（12 位、9 通道**顺序**扫描、0~3.3 V 单极性） |
|
||||
| 采样软件 | `Drivers/BSP/TPAFE5160/tpafe5160.h` 驱动就绪（原子快照 API）；`App/task/adc_task.c` **已实现真实消费者（B1，2026-10-10）**——每 1 ms 触发 CONVST + `tpafe5160_snapshot()` 取数 + 帧统计；STM32 侧仍无 `HAL_ADC_Start` |
|
||||
| 采样软件 | `Drivers/BSP/TPAFE5160/tpafe5160.h` 驱动就绪（原子快照 API）；`App/task/adc_task.c` **已实现真实消费者（B1，2026-10-10）**——`tpafe5160_snapshot()` 取数 + 帧统计；**采样节拍由 TIM6 更新中断（1 kHz）硬件触发**（2026-10-10）；STM32 侧仍无 `HAL_ADC_Start` |
|
||||
| 保护算法层 | **完全缺失**（无傅氏、无保护元件、无出口、无定值模型） |
|
||||
| 已知硬件缺陷 | **N-18**：8 路电气量分属两片转换器 → V0.1 上禁止跨转换器做相位/功率/矢量运算 |
|
||||
|
||||
@@ -238,7 +238,7 @@
|
||||
|
||||
| # | 功能点 | 关键参数 | 完成判据 | 状态 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| L1-1 | 周期 CONVST 重触发 | 1000 Hz（与保护节拍同源） | 示波器见 U3 `BUSY` 连续脉冲；`tpafe5160_frame_seq()` 持续递增 | 🔶 B1 已软触发（`osDelayUntil`）并台架确认 `frame_seq` 严格 1000 Hz 递增；硬件定时器 1 kHz 为后续 |
|
||||
| L1-1 | 周期 CONVST 重触发 | 1000 Hz（与保护节拍同源） | 示波器见 U3 `BUSY` 连续脉冲；`tpafe5160_frame_seq()` 持续递增 | ✅ 2026-10-10：**TIM6 更新中断（1 kHz）硬件触发**（ISR 内 `tpafe5160_start_conv_irq()`；方案 A，零引脚/零驱动改动）；B1 阶段已台架确认 `frame_seq` 严格 1000 Hz 递增 |
|
||||
| L1-2 | TPAFE 快照消费 | 8 通道 / 帧 | `adc_task` 每拍调 `tpafe5160_snapshot()`，返回 1/0/-1 有处理 | ✅ B1 已实现并 `@test` 闭环（`adc_task.c`；台架 `idle=0`、`frst_err=0`） |
|
||||
| L1-3 | STM32 ADC1 启动与扫描 | 9 通道、144 cycles、软件触发 | 全库出现 `HAL_ADC_Start`；9 通道码值随注入变化 | ⬜ |
|
||||
| L1-4 | 通道语义映射 | 见 `docs/硬件平台/ADC通道映射说明.md`（**按语义取数，不写死下标**） | `UA→buf[6]`、`UN→buf[5]`、`IA→buf[2]`；STM32 侧 `UB→ADC_CHANNEL_14` | ⬜ |
|
||||
@@ -593,3 +593,4 @@ B0 产品定义 ✅（2026-10-10 已确认，见 §1.5）
|
||||
| 2026-10-10 | B0 残留项闭环 + 新增 §1.6 范围评估 | B0-a **本期不做**（`UBA`/`V1`/`V2` 无硬件通道）、B0-b **保留 TCP 8888**（SNTP 5105 不做）；B0-c **定为"骨架全做 + 有效通道子集闭环"**；新增 **§1.6** 由 V0.1 硬件（N-18 + 无中点偏置）推导本期可做保护范围 = TPAFE 三路（`UA`/`UN`/`IA`）有效子集；同步 §1.3、§3.3、§6.4（零序口径更正）、§7.1/§7.2、§9 R1 |
|
||||
| 2026-10-10 | 恢复被外部工具回写的旧稿 | 文件曾被外部格式化工具回写为旧稿：**§1.5/§1.6/§5 丢失、§10 混入 66 组下划线（u）标签、表格被填充对齐**。本次按权威来源重建 §1.5/§1.6、补齐 **§5 定值参数模型**，清除全部下划线标签并把表格压回仓库紧凑风格；内容与 §1.3/§3.3/§6.4/§7/§9 的定稿一致 |
|
||||
| 2026-10-10 | **B1 落地：ADC 采集链路实现** | `App/task/adc_task.c` 由空桩转为真实消费者——每 1 ms 触发 `tpafe5160_start_conv_irq()` + `tpafe5160_snapshot()` 原子取数 + 帧统计 + 每 10 s 心跳日志；`Src/freertos.c` 手工创建 `adcTask`（512 words / Normal，落 `USER CODE` 保护区）+ 纳入 IWDG 必需掩码（`TASK_WD_ADC`，`0x37`→`0x77`）。§1.4 采样软件行、§1.4 依赖表 B1 行、§3.2 任务表（L1-1/L1-2）、§4 栈预算行、§7.1 P0 行同步更新。⚠ 本阶段为**任务周期软触发**（`osDelayUntil`）；硬件定时器 1 kHz 触发为后续。同日 `@test` 实机闭环 PASS（`frame_seq` 严格 1000 Hz 递增、`idle=0`、`frst_err=0`、栈峰值 496/2048） |
|
||||
| 2026-10-10 | **1 kHz 硬件定时器触发（TIM6）** | 采样节拍由任务周期软触发改为 **TIM6 更新中断（1 kHz）**：`Src/main.c` 的 `HAL_TIM_PeriodElapsedCallback` 加 TIM6 分支触发 `tpafe5160_start_conv_irq()`（`USER CODE` 区）；`app_main.c` 用 `HAL_TIM_Base_Start_IT(&htim6)` 替换单次触发（在 `tpafe5160_init()` 之后）；`adc_task.c` 退化为**纯消费者**（1 ms 轮询仅作消费节奏）。§1.2 采样软件行、§3.2 L1-1 同步。详见 `docs/子系统设计/ADC采样节拍设计说明.md` |
|
||||
|
||||
Reference in New Issue
Block a user