refactor(编号): 采集链分层 L1/L1.5/L2/L2.5/L3/L4/L5 → 语义名（批次 1）
用户裁定（2026-10-28）：L1/L1.5/L2/L2.5/L3 这套层号「谁能看懂」，改用语义名。 映射（同一批定稿，含 L4/L5）： L1 → 语义取数与有效性 L1.5 → 标定折算 L2 → 全周傅氏相量 L2.5 → 测频与遥测快照 L3 → 保护判据 L4 → 出口与记录 L5 → 动作留痕 实测规模：384 站点 / 62 文件（App/algo、App/task、test/host 六个套件、docs/算法、 产品需求、架构总览、启动顺序、ADC 采样节拍、IEC104 上行、采集短板评测、内存管理、 AGENTS.md、README.md、docs/README.md、.pre-commit-config.yaml 与 scripts 里的注释）。 改法（不是全局替换，逐模式有上下文规则）： - 先吃同位语再落裸词：L1 有效性校验 → 语义取数与有效性校验、L2 相量层 → 全周傅氏 相量层、L3 保护 → 保护判据、L2.5 遥测快照 → 测频与遥测快照，避免「保护判据保护判据」 这类重复（第一版就是这么坏掉的，已整体回滚重做）。 - .c/.h 只改注释：先把字符串字面量切出去（引号数为奇数的跨行注释按整行处理）， C 字符串里的 L2-in ring 之类原样保留——AGENTS 铁律「字符串字面量必须纯 ASCII」。 - 层内条目号（L1-3 / L2-3 这类）**本批不动**，属批次 2；另外三族（UI 菜单层级 L0~L3、链路延迟分段 L1~L8、CubeMX 防丢失三层）也不动，属批次 3。 - 顺手修的措辞：范围写法 L1~L3 → 「分层（语义取数与有效性 → 保护判据）」、 CI 段「不含 L1/L2/L3」→「不含采集链分层」、目录地图里同一处并列表述。 验证：@build 0 错 0 警（Code=236456，与改前逐字节同尺寸——纯注释改动）； 内存布局配图已按新脚本重生成（自检通过）；doc-links --all --sections-strict 通过 （195 文档）；mojibake / bom-guard / coding-standard / 新编号门禁自查 全 rc=0； git diff --check 干净。
This commit is contained in:
+22
-22
@@ -1,7 +1,7 @@
|
||||
/*
|
||||
* 模块名称：ADC Sampling Task
|
||||
* 模块功能：ADC 采集消费 + L2 相量计算——TPAFE5160 快照 + STM32 ADC1 DMA 乒乓帧消费
|
||||
* （经 L1 层 App/algo/adc_input.c 按语义取数）→ 压入采样环
|
||||
* 模块功能：ADC 采集消费 + 全周傅氏相量计算——TPAFE5160 快照 + STM32 ADC1 DMA 乒乓帧消费
|
||||
* （经 语义取数与有效性层 App/algo/adc_input.c 按语义取数）→ 压入采样环
|
||||
* （App/algo/sample_ring.c）→ 全周傅氏相量重算（App/algo/phasor.c）
|
||||
* + 帧统计（节拍由 TIM3 硬件定时器提供）
|
||||
* 状态说明：**B1 已落地（2026-10-10）**——本任务从空桩转为真实消费者：
|
||||
@@ -15,7 +15,7 @@
|
||||
* 消除 0~1 ms 的 tick 量化相位抖动与"超拍永久落后 → 空转"风险；本任务优先级
|
||||
* 同步由 Normal 提到 **AboveNormal**（唤醒即抢占）。详见
|
||||
* docs/子系统设计/ADC采样节拍设计说明.md §6。
|
||||
* **L1 采集层**：取数改走 App/algo/adc_input.c——
|
||||
* **语义取数与有效性层**：取数改走 App/algo/adc_input.c——
|
||||
* 本任务每拍调 adc_input_poll()（TPAFE 快照 + STM32 ADC1 9 通道扫描），
|
||||
* 经 adc_input_raw() **按语义**读通道（STM32 ADC1 启动与扫描 / 通道语义映射），不再直接触碰驱动缓冲。
|
||||
*（保护功能清单见 docs/算法/继电保护功能复现规划.md）
|
||||
@@ -41,7 +41,7 @@
|
||||
* v2.3 2026-10-10 王建锋 STM32 ADC1 启动与扫描 / 通道语义映射：取数改走 App/algo/adc_input.c（语义映射 +
|
||||
* STM32 ADC1 9 通道扫描）；首帧日志补全 8 路电气量 + 温度，
|
||||
* 心跳日志增 adc1_rc / adc1_err 观测 STM32 侧健康度。
|
||||
* v2.4 2026-10-10 王建锋 L2：接入相量层——每拍把 9 路语义值压入采样环
|
||||
* v2.4 2026-10-10 王建锋 全周傅氏相量：接入相量层——每拍把 9 路语义值压入采样环
|
||||
* （sample_ring）并重算全部相量实例（phasor_run）；
|
||||
* 攒满一周波后**首拍即落一次相量日志**（开机证据，不等
|
||||
* 10 s 心跳），心跳日志增 ring / skip 计数与各实例相量
|
||||
@@ -85,7 +85,7 @@
|
||||
* 者；该入口同时不再打日志——它落在本任务静态最坏链上，
|
||||
* 每条 DBG_* 约 216 B 栈，而这一行毫无诊断价值（本任务
|
||||
* 存活由首帧日志与 TASK_WD_ADC 心跳证明）
|
||||
* v3.1 2026-10-25 DTU 项目组 L1.5 折算 + 采样通道自检 贴轨观测（「数据可信」标定折算落地，道A）：
|
||||
* v3.1 2026-10-25 DTU 项目组 标定折算折算 + 采样通道自检 贴轨观测（「数据可信」标定折算落地，道A）：
|
||||
* frame[s] 由 (float)code 改 adc_cal_apply()——工程量 =
|
||||
* (code+b)×k，现口径 = ADC 引脚电压 V（eng=0，量程口径冻结的
|
||||
* ROM 系数，docs/硬件平台/ADC通道映射说明.md §7.1）；同拍
|
||||
@@ -93,7 +93,7 @@
|
||||
* 门限 adc_cal_rail_ths，码值域与标定正交），锁存边沿 →
|
||||
* DBG_ERROR + 每开机一次 SYSLOG；心跳增 cal: 行（mV 定点
|
||||
* + valid/clipped 位图 + rail 锁存），台架注入口径见该行判读
|
||||
* v3.2 2026-10-25 DTU 项目组 L2 遥测快照发布（「数据可信」这一项，道D，M5）：新模块
|
||||
* v3.2 2026-10-25 DTU 项目组 测频与遥测快照发布（「数据可信」这一项，道D，M5）：新模块
|
||||
* App/algo/meas.c——本任务为唯一发布者，新帧拍内
|
||||
* freq_run() 之后按 200 ms **tick 经过**分频调
|
||||
* meas_tick()（全仓调用点 = 1，评审判据）；品质注入源 =
|
||||
@@ -111,13 +111,13 @@
|
||||
#include "adc_task.h"
|
||||
#include "cmsis_os.h"
|
||||
#include "task_handles.h" /* adcTaskHandle（原为本文件局部 extern） */
|
||||
#include "adc_input.h" /* L1 采集层：adc_input_poll()/adc_input_raw()（按语义取数） */
|
||||
#include "sample_ring.h" /* L2 输入：sample_ring_push_frame()（采样环缓冲） */
|
||||
#include "phasor.h" /* L2 相量层：phasor_run()/phasor_get()（全周傅氏） */
|
||||
#include "freq.h" /* L2 派生量：freq_run()/freq_get()（测频，B8） */
|
||||
#include "adc_input.h" /* 语义取数与有效性层：adc_input_poll()/adc_input_raw()（按语义取数） */
|
||||
#include "sample_ring.h" /* 全周傅氏相量输入：sample_ring_push_frame()（采样环缓冲） */
|
||||
#include "phasor.h" /* 全周傅氏相量层：phasor_run()/phasor_get()（全周傅氏） */
|
||||
#include "freq.h" /* 全周傅氏相量的派生量：freq_run()/freq_get()（测频，B8） */
|
||||
#include "adc_health.h" /* 采样有效性校验（静默/丢帧/单调性/错误增量/贴轨） */
|
||||
#include "adc_cal.h" /* L1.5：通道标定折算（「数据可信」标定折算落地；flags 供 cal 心跳行） */
|
||||
#include "meas.h" /* L2 发布侧：遥测快照 meas_tick()（「数据可信」遥测快照发布，道D） */
|
||||
#include "adc_cal.h" /* 标定折算：通道标定折算（「数据可信」标定折算落地；flags 供 cal 心跳行） */
|
||||
#include "meas.h" /* 全周傅氏相量发布侧：遥测快照 meas_tick()（「数据可信」遥测快照发布，道D） */
|
||||
#include "tpafe5160.h"
|
||||
#include "task_watchdog.h"
|
||||
#include "console_log.h"
|
||||
@@ -133,7 +133,7 @@
|
||||
#define ADC_TASK_REPORT_MS 10000U
|
||||
|
||||
/* 统计：已消费帧数 / 无新帧次数（首拍必为无新帧，之后应稳定为 0 增量）。
|
||||
* 原始码值缓冲由 L1 层 App/algo/adc_input.c 持有（消费侧按语义取数，不写死下标） */
|
||||
* 原始码值缓冲由 语义取数与有效性层 App/algo/adc_input.c 持有（消费侧按语义取数，不写死下标） */
|
||||
static uint32_t s_frames_consumed;
|
||||
static uint32_t s_frames_idle;
|
||||
/* 因通道尚未首次成功而**整拍跳过入环**的次数（不向相量窗注入 0 点） */
|
||||
@@ -194,7 +194,7 @@ void adc_tick_irq_notify(void) {
|
||||
* 限定条件：仅任务上下文；调用方须保证 dbg_console_writer_ready() 为真
|
||||
* 函数说明：MicroLIB 的 snprintf **不支持 %f** → 以 ×0.1 定点整数打印
|
||||
* （打印值 = 实际值 × 10，分辨率 0.1）。逐实例数据驱动输出，
|
||||
* 实例表加行即自动覆盖。输入自 v3.1 起为 L1.5 折算后的工程量
|
||||
* 实例表加行即自动覆盖。输入自 v3.1 起为 标定折算折算后的工程量
|
||||
* （现口径 = ADC 引脚电压 V，见 cal: 心跳行与文件头 v3.1 记录）；
|
||||
* 二次值语义仅在 adc_cal_flags() 出 VALID 后成立。
|
||||
*/
|
||||
@@ -329,7 +329,7 @@ void adc_task_func(void *arg) {
|
||||
* （osPriorityBelowNormal），是"UI 心跳缺席"的候选占用者之一 */
|
||||
task_prof_enter(TASK_PROF_ADC_BEAT);
|
||||
|
||||
/* 1) 采集一拍：L1 层 adc_input_poll() = TPAFE 原子快照 + 消费一帧 STM32 ADC1
|
||||
/* 1) 采集一拍：语义取数与有效性层 adc_input_poll() = TPAFE 原子快照 + 消费一帧 STM32 ADC1
|
||||
* DMA 双缓冲（仅任务上下文；TPAFE 侧 1=有新帧 0=无新帧 -1=参数错）。
|
||||
* 采样节拍由 TIM3 更新事件提供（ISR 内触发 CONVST + TRGO 触发 ADC1），
|
||||
* 本任务既不触发也不等待转换。
|
||||
@@ -347,7 +347,7 @@ void adc_task_func(void *arg) {
|
||||
/* r == -1：参数错。调用点 count 为常量，不可达；不计入 idle 以区分异常 */
|
||||
}
|
||||
|
||||
/* 2) L2 输入 + 相量重算：把本拍 9 路语义值转浮点帧压入采样环，再重算全部
|
||||
/* 2) 全周傅氏相量输入 + 相量重算：把本拍 9 路语义值转浮点帧压入采样环，再重算全部
|
||||
* 相量实例（每 1 ms 滑动窗刷新：每拍以"当前时刻为终止的前一周波"整窗重算）。
|
||||
*
|
||||
* ⚠ **仅在本拍确有新帧（r == 1）时**才压环。
|
||||
@@ -374,7 +374,7 @@ void adc_task_func(void *arg) {
|
||||
all_ok = 0u;
|
||||
break;
|
||||
}
|
||||
/* L1.5 折算（「数据可信」标定折算落地，§4.1 模型）：工程量 = (code + b) × k。
|
||||
/* 标定折算折算（「数据可信」标定折算落地，§4.1 模型）：工程量 = (code + b) × k。
|
||||
* 现口径 = **ADC 引脚电压 V**（eng=0，量程口径冻结的 ROM 系数，见
|
||||
* docs/硬件平台/ADC通道映射说明.md §7.1）；端子变比确认与两点标定写入标定
|
||||
* 系数（adc_cal_flags() 出 VALID）后才按二次值消费。TEMP 透传码值
|
||||
@@ -394,11 +394,11 @@ void adc_task_func(void *arg) {
|
||||
if (all_ok != 0u) {
|
||||
(void)sample_ring_push_frame(frame, (uint8_t)ADC_SEM_COUNT);
|
||||
phasor_run();
|
||||
/* L2 派生量测频（B8）：同拍紧随 phasor_run——本拍使用区已
|
||||
/* 全周傅氏相量的派生量测频（B8）：同拍紧随 phasor_run——本拍使用区已
|
||||
* 切换，freq 读的就是本拍相量（1 ms 同上下文，无竞态） */
|
||||
freq_run();
|
||||
|
||||
/* L2 遥测快照发布（「数据可信」这一项，道D，M5）：200 ms tick 经过分频。
|
||||
/* 测频与遥测快照发布（「数据可信」这一项，道D，M5）：200 ms tick 经过分频。
|
||||
* 唯一发布者 = 本任务（全仓 meas_tick 调用点数 = 1 为评审判据，
|
||||
* 「数据可信」§8 风险表"快照双写"行）；只在**压环成功的真新帧拍**发布
|
||||
* ——idle/skip 拍压环未推进，发布 = 重复旧窗。品质注入唯一源 =
|
||||
@@ -480,7 +480,7 @@ void adc_task_func(void *arg) {
|
||||
(long)ia, (long)ib, (long)ic, (long)in, (long)temp);
|
||||
}
|
||||
|
||||
/* 4) 首拍相量上报：攒满一周波（20 ms）后立即落一次，作为 L2 链路的开机证据。
|
||||
/* 4) 首拍相量上报：攒满一周波（20 ms）后立即落一次，作为 全周傅氏相量链路的开机证据。
|
||||
* 不依赖 10 s 心跳 → 台架 @test 的 settle 窗口内即可见（否则会被静默判据
|
||||
* 截断，见 docs/测试说明/自动化测试流程.md 的 settle 口径）。 */
|
||||
if ((first_phasor_logged == 0u) && (dbg_console_writer_ready() != 0u)) {
|
||||
@@ -495,7 +495,7 @@ void adc_task_func(void *arg) {
|
||||
/* 5) 看门狗心跳（本任务已纳入 required_mask） */
|
||||
task_wd_beat(TASK_WD_ADC);
|
||||
|
||||
/* 6) 周期心跳日志：帧统计 + 驱动侧 FRSTDATA 错误计数 + L2 相量。
|
||||
/* 6) 周期心跳日志：帧统计 + 驱动侧 FRSTDATA 错误计数 + 全周傅氏相量。
|
||||
* 写者就绪前抑制（同 3) 的交错理由）；到点无论是否落日志都推进下个上报点 */
|
||||
{
|
||||
if ((int32_t)(now - report_at) >= 0) {
|
||||
@@ -552,7 +552,7 @@ void adc_task_func(void *arg) {
|
||||
(long)rc[ADC_SEM_TEMP]);
|
||||
}
|
||||
|
||||
/* L1.5/采样通道自检 台架观测面（×1000 mV 定点，MicroLIB 无 %f）：
|
||||
/* 标定折算/采样通道自检 台架观测面（×1000 mV 定点，MicroLIB 无 %f）：
|
||||
* ua/un/ia_mv = 三路 TPAFE 引脚电压毫伏（未标定域，**不是**
|
||||
* 二次值；两点标定注入验证的读数落点，偏差判据 ≤2 %）
|
||||
* vl = VALID 位图（默认构建应恒 0x00——未标定即未标定，
|
||||
|
||||
Reference in New Issue
Block a user