refactor(编号·批次二): 代码与测试侧 215 处保护功能号改成功能名,零行为改动
用户裁定「不要用字母加数字的编号,语义标识是最好的」后的批次二代码半(道 ui-param 执行,逐文件站点数与 自证见其交付)。唯一口径 = 映射表 ci-artifacts/lprot_map.tsv 的功能名列原文,**零自造同义词**;L2.5 与 L-TEST 经实测各 0 处(不是本族),TC 族一字未动。 固件 22 文件 128 处(adc_task.c 21、phasor.c 22、phasor.h 13…),主机测试 13 文件 87 处(pha sor_test.c 57…);设计文档指针新增 19 行,另 16 只文件本来就写着规划文档 ⇒ 不重复加。 **两条只有真改过 215 处才会踩到的坑,都写进注释规范实践**: · 指针**不能接在原句尾部**——那会替原文一个未闭合的半括号封口,实测咬坏 App/algo/sample_ring.h 这类 跨行句 ⇒ 指针一律**单独成行**; · 号删掉会留下**叠词**(「自检失败闭锁 闭锁判定」「定值校验和 定值巡检」)⇒ 复扫并收口 4 处,措辞只用 映射名本身;具体对象需要留住时写成「自检失败闭锁(采样故障闭锁)」。 自证(不靠嘴说):改前把 35 只文件原文备份到仓外 temp,逐文件比 `/*`、`*/` 计数、三类括号计数、行数增量 恰等于指针行数、全角括号增删相等、残留号 0 ⇒ **35/35 通过**;Lead 复核后跑权威 @build **0 错 0 警**, Program Size `Code=233900 RO=26104 RW=1536 ZI=136808` —— **与三条道各自改前改后测的四数逐 字节同数**, 这就是「只动注释与文本」的机器证据;八套主机单测 exit 0,cppcheck 按钩子参数零发现,coding-standard 0。 文件头「修改记录」里的号**一并换名、不还原**(Lead 裁定):这些号是全仓退役的,留一个查无此号的引用比 留一条改过名的条目更坏——「冻结历史不回改」保护的是**别替历史改口**,不是保护一个再也查不到的字符串; id-check 对变更记录行本就豁免,两种选择都不影响门禁。
This commit is contained in:
+14
-14
@@ -9,21 +9,21 @@
|
||||
|
||||
| 文件 | 层 | 作用(一句话) | 主要对外入口 | 覆盖规划项 |
|
||||
|---|---|---|---|---|
|
||||
| `adc_input.h` / `.c` | L1 | 统一语义取数:两片转换器的码值按语义(`UA…IN` / 温度)暴露,并消费 STM32 ADC1 的 DMA 乒乓缓冲 | `adc_input_init()` `adc_input_poll()` `adc_input_raw()` | L1-2 / L1-3 / L1-4 |
|
||||
| `adc_health.h` / `.c` | L1 | 采样有效性判定:吃计数快照,产出静默 / 丢帧 / 单调性 / 错误增量故障位(判定与告警编排分离);L5-2 残余的码值贴轨观察器同层 | `adc_health_check()` `adc_health_flags()` `adc_health_rail_watch()` | L1-6 / L5-2(残余) |
|
||||
| `adc_cal.h` / `.c` | L1.5 | 通道标定折算(「数据可信」卡 2/卡 4):工程量 =(code+b)×k,Q16 系数/零点两段落盘 + 三态 flags + 合法带哨兵 + 两点公式 | `adc_cal_apply()` `adc_cal_flags()` `adc_cal_set()` | L1-5(M4 半边) |
|
||||
| `adc_input.h` / `.c` | L1 | 统一语义取数:两片转换器的码值按语义(`UA…IN` / 温度)暴露,并消费 STM32 ADC1 的 DMA 乒乓缓冲 | `adc_input_init()` `adc_input_poll()` `adc_input_raw()` | TPAFE 快照消费 / STM32 ADC1 启动与扫描 / 通道语义映射 |
|
||||
| `adc_health.h` / `.c` | L1 | 采样有效性判定:吃计数快照,产出静默 / 丢帧 / 单调性 / 错误增量故障位(判定与告警编排分离);「采样通道自检」残余的码值贴轨观察器同层 | `adc_health_check()` `adc_health_flags()` `adc_health_rail_watch()` | 「采样有效性校验」/「采样通道自检」(残余) |
|
||||
| `adc_cal.h` / `.c` | L1.5 | 通道标定折算(「数据可信」卡 2/卡 4):工程量 =(code+b)×k,Q16 系数/零点两段落盘 + 三态 flags + 合法带哨兵 + 两点公式 | `adc_cal_apply()` `adc_cal_flags()` `adc_cal_set()` | 「通道标定(一次系数 + 零漂)」(M4 半边) |
|
||||
| `meas.h` / `.c` | L2 发布 | 遥测快照(「数据可信」卡 8,M5 地基):200 ms 基波有效值 + 品质快照,双区无锁读,全仓唯一发布者 = adcTask | `meas_tick()` `meas_get()` `meas_seq()` | M5(卡 9/11 与 UI 是读者) |
|
||||
| `sample_ring.h` / `.c` | L2 输入 | 按语义通道存最近 2 周波(40 点),供相量层"以当前时刻为终止"取窗 | `sample_ring_push_frame()` `sample_ring_window()` | L2 输入(为 L2-6 供数) |
|
||||
| `phasor.h` / `.c` | L2 | 全周傅氏:一周波 20 点 DFT → 基波 / 谐波相量(有效值口径),双区原子切换供无锁读 | `phasor_run()` `phasor_get()` `phasor_calc()` | L2-1 / L2-2 / L2-3 / L2-6 / L2-7 |
|
||||
| `freq.h` / `.c` | L2 派生量 | 频率测量:相邻两拍基波相量共轭乘积取角 + 自适应窗滑动平均 + 假值钳制 + 幅值门(UA→IA 源回退) | `freq_run()` `freq_get()` `freq_valid()` | L3-5 测量侧(测频范围 → `docs/算法/继电保护功能复现规划.md` §4.2) |
|
||||
| `prot_set.h` / `.c` | L3 输入 | 保护定值模型:Q10 定点 RAM 表 + 范围校验 + 校验和封存 / 自检 / 闭锁 + 持久化 blob 纯逻辑 | `prot_set_load_raw()` `prot_set_get_f()` `prot_set_selfcheck()` | L5-1 载体 |
|
||||
| `prot_elm.h` / `.c` | L3 | 保护元件框架:通用"越限 + 返回系数滞回 + 定时限"核 + 数据驱动实例表(过流三段 / 过负荷 / 过压 / 欠压 / 零序过压 / 过频 / 低频) | `prot_elm_run()` `prot_elm_eval()` `prot_elm_active_mask()` | L3-1 / L3-3 / L3-4 / L3-5 / L3-6(软件侧) |
|
||||
| `sample_ring.h` / `.c` | L2 输入 | 按语义通道存最近 2 周波(40 点),供相量层"以当前时刻为终止"取窗 | `sample_ring_push_frame()` `sample_ring_window()` | L2 输入(为「每 1 ms 滑动窗刷新」供数) |
|
||||
| `phasor.h` / `.c` | L2 | 全周傅氏:一周波 20 点 DFT → 基波 / 谐波相量(有效值口径),双区原子切换供无锁读 | `phasor_run()` `phasor_get()` `phasor_calc()` | 全周傅氏系数表 / 基波相量实例 / 相量有效值输出 / 每 1 ms 滑动窗刷新 / 双区指针原子交换 |
|
||||
| `freq.h` / `.c` | L2 派生量 | 频率测量:相邻两拍基波相量共轭乘积取角 + 自适应窗滑动平均 + 假值钳制 + 幅值门(UA→IA 源回退) | `freq_run()` `freq_get()` `freq_valid()` | 「过频 / 低频」测量侧(测频范围 → `docs/算法/继电保护功能复现规划.md` §4.2) |
|
||||
| `prot_set.h` / `.c` | L3 输入 | 保护定值模型:Q10 定点 RAM 表 + 范围校验 + 校验和封存 / 自检 / 闭锁 + 持久化 blob 纯逻辑 | `prot_set_load_raw()` `prot_set_get_f()` `prot_set_selfcheck()` | 「定值校验和」载体 |
|
||||
| `prot_elm.h` / `.c` | L3 | 保护元件框架:通用"越限 + 返回系数滞回 + 定时限"核 + 数据驱动实例表(过流三段 / 过负荷 / 过压 / 欠压 / 零序过压 / 过频 / 低频) | `prot_elm_run()` `prot_elm_eval()` `prot_elm_active_mask()` | 「三段式相间过流」/「过负荷」/「过压 / 欠压」/「过频 / 低频」/「零序过压」(软件侧) |
|
||||
|
||||
依赖(自下而上、无环):`adc_input.h`(纯枚举 + 声明)← `adc_cal`(另依赖 `cfg_file.h` 接口,
|
||||
纯头文件级)← `sample_ring` ← `phasor` ← `freq`;`meas` ← `sample_ring` + `phasor`
|
||||
(仅 `phasor_calc` 纯核;频率/品质由调用方注入,**不链** `freq`/`adc_cal`);
|
||||
`prot_set` **独立**;`prot_elm` ← `prot_set` + `phasor` + `freq`。
|
||||
`adc_health` 只吃调用方喂进来的计数 / 码值,不反向依赖 L1 实现(L5-2 贴轨门限由调用方
|
||||
`adc_health` 只吃调用方喂进来的计数 / 码值,不反向依赖 L1 实现(「采样通道自检」贴轨门限由调用方
|
||||
从 `adc_cal_rail_ths()` 取,本层仍零算法依赖)。
|
||||
|
||||
**除 `adc_input.c` 外全部零平台依赖**(只用 `stdint.h` / `math.h` / `stddef.h` 与本目录头)
|
||||
@@ -33,7 +33,7 @@
|
||||
## 2. 一拍的数据流(一眼版)
|
||||
|
||||
`adc_input_poll()` → `adc_input_raw()` ×9 → `adc_cal_apply()` ×9(L1.5 折算,现口径 =
|
||||
ADC 引脚电压 V)+ `adc_health_rail_watch()` ×9(L5-2,码值域)→ `sample_ring_push_frame()`
|
||||
ADC 引脚电压 V)+ `adc_health_rail_watch()` ×9(「采样通道自检」,码值域)→ `sample_ring_push_frame()`
|
||||
→ `phasor_run()` → `freq_run()` → 消费者(`adcTask` 心跳与 L1 健康判定;`protectTask` 每 20 ms 取相量 / 频率跑
|
||||
`prot_elm_run()`;**每 200 ms** `meas_tick()` 发布遥测快照供 iec104Task / uiTask 读,卡 8)。节拍 = TIM3 1 kHz 更新事件,两片转换器同源触发。
|
||||
完整数据流图与初始化落点 → `docs/算法/采集与算法层设计说明.md` §2。
|
||||
@@ -70,7 +70,7 @@ ADC 引脚电压 V)+ `adc_health_rail_watch()` ×9(L5-2,码值域)→ `s
|
||||
- **gap 不告警**(消费者超拍是已知现象);告警编排在 `adc_task.c`,不在本层。
|
||||
- 首拍 `check()` 只建基线。→ `docs/算法/采集与算法层设计说明.md` §4。
|
||||
|
||||
### 3.5 `prot_set.c` / `.h` — 保护定值模型(L5-1 载体)
|
||||
### 3.5 `prot_set.c` / `.h` — 保护定值模型(「定值校验和」载体)
|
||||
- 装载 **all-or-nothing**:任一项越界整表不装载,越界项由 `prot_set_bad_mask()` 指认。
|
||||
- 批量 `prot_set_set()` 后**必须** `prot_set_seal()`;单项原子写用 `prot_set_set_sealed()`。
|
||||
- 定值项 / 实例**只许尾部追加**(枚举序 = 数组序 = 校验和覆盖序)。
|
||||
@@ -82,7 +82,7 @@ ADC 引脚电压 V)+ `adc_health_rail_watch()` ×9(L5-2,码值域)→ `s
|
||||
- 零序过流(IN 走 STM32)**故意不在实例表**;OF / UF 无独立 104 遥信点,只经 YX15 总聚合可见。
|
||||
- `prot_elm_init()` 须在 `phasor_init()` 之后。→ `docs/算法/采集与算法层设计说明.md` §9。
|
||||
|
||||
### 3.7 `freq.c` / `.h` — 频率测量(L3-5 的测量输入)
|
||||
### 3.7 `freq.c` / `.h` — 频率测量(「过频 / 低频」的测量输入)
|
||||
- `freq_run()` **仅 adcTask 上下文**,须在 `phasor_run()` 之后同拍调;保护口径 =
|
||||
`freq_get() == 0 && freq_valid() == 1`。
|
||||
- 精度靠**自适应窗长**(窗长 = 泄漏纹波周期的整数倍);定长平均压不到 0.02 Hz,
|
||||
@@ -115,9 +115,9 @@ ADC 引脚电压 V)+ `adc_health_rail_watch()` ×9(L5-2,码值域)→ `s
|
||||
- 值口径(批 2 卡 8 A-lite 裁决):**基波有效值瞬时透传**,与 phasor 使用区
|
||||
**同拍同核逐位相等**(单测钉死);**不做** 4 点平均 / 谐波方和根——按
|
||||
docs/任务规划/数据可信.md §4.5"上送节拍非平均窗,再平均引入滞后";谐波 k-bin 轨
|
||||
(docs/算法/继电保护功能复现规划.md L2-8)扩展只许结构尾部追加,
|
||||
(docs/算法/继电保护功能复现规划.md 「遥测谐波轨(可选)」)扩展只许结构尾部追加,
|
||||
docs/任务规划/数据可信.md §4.5 字段序 = 协议(布局由单测按偏移钉死,72 B × 双区)。
|
||||
- 并发 = phasor 双区 + 单字节索引翻转(L2-7 同型,无锁);seq 只增供消费者判换帧。
|
||||
- 并发 = phasor 双区 + 单字节索引翻转(「双区指针原子交换」同型,无锁);seq 只增供消费者判换帧。
|
||||
- 品质注入:削顶位图唯一源 = `adc_cal_flags()`(口径 docs/任务规划/数据可信.md §4.2
|
||||
三态表;由 adc_task 编排注入,本层不链 `adc_cal`);TEMP = 最新一拍原始值透传 +
|
||||
`NT`(「数据可信」决策 5);`MEAS_QDS_*` 低字节与 104 QDS 线上字节同值
|
||||
|
||||
+2
-1
@@ -403,7 +403,8 @@ int adc_cal_two_point(int32_t c_lo, int32_t c_hi, int32_t v_lo_uv, int32_t v_hi_
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能:通道码值域贴轨带门限(L5-2 判定的门限来源,按 FS 百分比)
|
||||
* 函数功能:通道码值域贴轨带门限(采样通道自检 判定的门限来源,按 FS 百分比)
|
||||
*(保护功能清单见 docs/算法/继电保护功能复现规划.md)
|
||||
* 入口参数:sem - 语义通道;p_lo_th/p_hi_th - 输出下/上轨带界 int32_t *
|
||||
* 返 回 值:0 - 已给出门限;-1 - TEMP/越界/参数空(不做贴轨监视) int
|
||||
* 限定条件:无
|
||||
|
||||
+5
-4
@@ -111,7 +111,8 @@ uint32_t adc_cal_flags(adc_semantic_t sem);
|
||||
* 的测量通道;UB/UC/IB/IC/IN 即使将来标定也另受 `CLIPPED` 品质约束
|
||||
* (M5 快照层处理),不掺进本闭锁源。
|
||||
* ② ⚠ **不得当「保护在跑」的总括用**:判据停走共四路来源,本函数只覆盖
|
||||
* 第二路——(a) L5-4 采样故障闭锁(`adc_health_flags()`);(b) 本函数
|
||||
* 第二路——(a) 自检失败闭锁 采样故障闭锁(`adc_health_flags()`);(b) 本函数
|
||||
*(保护功能清单见 docs/算法/继电保护功能复现规划.md)
|
||||
* (未标定);(c) 定值校验和失配闭锁(`prot_set_locked()`);(d) 全局软压板
|
||||
* 退出(`PS_GLOBAL_EN` = 0)。要判「这拍到底评估了没有」必须四路一起看
|
||||
* (编排顺序见 `App/task/protect_task.c`)。
|
||||
@@ -134,7 +135,7 @@ uint8_t adc_cal_prot_blocked(void);
|
||||
* 入口参数:sem - 语义通道 adc_semantic_t
|
||||
* 返 回 值:k[µV/码](回退后口径);TEMP / 越界返 0 float
|
||||
* 限定条件:无
|
||||
* 函数说明:L5-2 门限换算、日志与整定界面回显用;勿据其反推二次值(看 flags)
|
||||
* 函数说明:采样通道自检 门限换算、日志与整定界面回显用;勿据其反推二次值(看 flags)
|
||||
*/
|
||||
float adc_cal_k_uv(adc_semantic_t sem);
|
||||
|
||||
@@ -177,14 +178,14 @@ int adc_cal_two_point(int32_t c_lo, int32_t c_hi, int32_t v_lo_uv, int32_t v_hi_
|
||||
int32_t *p_k_q16, int32_t *p_b);
|
||||
|
||||
/*
|
||||
* 函数功能:通道码值域「贴轨带」门限(L5-2 越界检出的门限来源,按 FS 百分比)
|
||||
* 函数功能:通道码值域「贴轨带」门限(采样通道自检 越界检出的门限来源,按 FS 百分比)
|
||||
* 入口参数:sem - 语义通道 adc_semantic_t
|
||||
* p_lo_th - 下轨带上界(code ≤ 此值判触底) int32_t *
|
||||
* p_hi_th - 上轨带下界(code ≥ 此值判触顶) int32_t *
|
||||
* 返 回 值:0 - 已给出门限;-1 - TEMP/越界(不做贴轨监视) int
|
||||
* 限定条件:无
|
||||
* 函数说明:TPAFE 双极性 ±98% FS(±32112);STM32 上轨 98% FS(4013)、
|
||||
* 下轨 2% FS(81);判定状态机在 adc_health_rail_watch()(L5-2)
|
||||
* 下轨 2% FS(81);判定状态机在 adc_health_rail_watch()(采样通道自检)
|
||||
*/
|
||||
int adc_cal_rail_ths(adc_semantic_t sem, int32_t *p_lo_th, int32_t *p_hi_th);
|
||||
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
/*
|
||||
* 模块名称:ADC 采样有效性校验(L1 采集与预处理,规划项 L1-6)
|
||||
* 模块名称:ADC 采样有效性校验(L1 采集与预处理)
|
||||
*(保护功能清单见 docs/算法/继电保护功能复现规划.md)
|
||||
* 模块功能:见 adc_health.h 文件头。本文件为**纯逻辑实现**:输入计数快照、
|
||||
* 输出故障位/事件位,零平台依赖(仅 stdint.h/string.h 标准 C)→
|
||||
* 主机侧免桩单测。
|
||||
@@ -7,18 +8,18 @@
|
||||
* 作者:王建锋
|
||||
* 创建日期:2026-10-11
|
||||
* 修改记录:
|
||||
* v1.0 2026-10-11 王建锋 创建:L1-6 采样有效性校验
|
||||
* v1.0 2026-10-11 王建锋 创建:采样有效性校验
|
||||
* v1.1 2026-10-21 王建锋 新增 adc_health_age_stale():无模块状态的帧年龄
|
||||
* 纯判据(参照系由调用方自存),供 protectTask 的
|
||||
* 兜底新鲜度门使用,见 adc_health.h 同名声明
|
||||
* v1.2 2026-10-25 DTU 项目组 新增 L5-2 残余:码值越界(贴轨)观察器
|
||||
* v1.2 2026-10-25 DTU 项目组 新增 采样通道自检 残余:码值越界(贴轨)观察器
|
||||
* (rail_watch/rail_sticky/rail_init),判据与释放
|
||||
* 沿理由见 adc_health.h L5-2 段注释
|
||||
* 沿理由见 adc_health.h 采样通道自检 段注释
|
||||
*/
|
||||
|
||||
#include "adc_health.h"
|
||||
|
||||
#include <string.h> /* memset(L5-2 贴轨观察器数组复位) */
|
||||
#include <string.h> /* memset(采样通道自检 贴轨观察器数组复位) */
|
||||
|
||||
/* ===================== 内部状态 ===================== */
|
||||
|
||||
@@ -42,7 +43,7 @@ static uint32_t s_flags; /* 电平位(stall 可自愈;backward 锁存在
|
||||
static uint32_t s_sticky; /* 锁存位(含电平位历史并集) */
|
||||
static uint32_t s_tpafe_gaps;
|
||||
|
||||
/* L5-2 贴轨观察器(每通道独立小状态机,单写者 = adcTask) */
|
||||
/* 采样通道自检 贴轨观察器(每通道独立小状态机,单写者 = adcTask) */
|
||||
typedef struct {
|
||||
uint16_t run_hi; /* 连续贴上轨计数(饱和 0xFFFF) */
|
||||
uint16_t run_lo; /* 连续贴下轨计数 */
|
||||
@@ -257,7 +258,7 @@ uint32_t adc_health_tpafe_gaps(void) {
|
||||
return s_tpafe_gaps;
|
||||
}
|
||||
|
||||
/* ===================== L5-2 贴轨观察器实现 ===================== */
|
||||
/* ===================== 采样通道自检 贴轨观察器实现 ===================== */
|
||||
|
||||
/*
|
||||
* 函数功能:贴轨观察器复位(幂等;adc_health_init() 已内含)
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
/*
|
||||
* 模块名称:ADC 采样有效性校验(L1 采集与预处理,规划项 L1-6)
|
||||
* 模块名称:ADC 采样有效性校验(L1 采集与预处理)
|
||||
*(保护功能清单见 docs/算法/继电保护功能复现规划.md)
|
||||
* 模块功能:对两片转换器的"节拍是否还在喂数据"做**判定层**(观测计数由
|
||||
* `adc_input` / `tpafe5160` 驱动提供,本模块只做判定与告警位):
|
||||
* ① 静默(stall):帧序号连续 >= ADC_HEALTH_STALL_MS 无前进;
|
||||
@@ -13,14 +14,14 @@
|
||||
* 作者:王建锋
|
||||
* 创建日期:2026-10-11
|
||||
* 修改记录:
|
||||
* v1.0 2026-10-11 王建锋 创建:L1-6 采样有效性校验(静默/丢帧/单调性/错误增量)
|
||||
* v1.0 2026-10-11 王建锋 创建:采样有效性校验(静默/丢帧/单调性/错误增量)
|
||||
* v1.1 2026-10-21 王建锋 新增 adc_health_age_stale()(无模块状态的帧年龄
|
||||
* 纯判据,参照系由调用方自存)与 ADC_HF_STALE 位:
|
||||
* 判定层的 stall/backward 位只在 adcTask 每拍跑
|
||||
* check() 时才可能置起,节拍源停摆会把本任务卡在
|
||||
* osThreadFlagsWait 上 → 那些位永远是 0,而相量冻在
|
||||
* 最后一帧仍被 protectTask 用于判据。该纯判据让保护侧
|
||||
* 能用**自己的时基 + 中断侧计数器**独立判"数据还新不新" * v1.2 2026-10-25 DTU 项目组 新增 L5-2 残余「码值越界(贴轨)检出」:
|
||||
* 能用**自己的时基 + 中断侧计数器**独立判"数据还新不新" * v1.2 2026-10-25 DTU 项目组 新增 采样通道自检 残余「码值越界(贴轨)检出」:
|
||||
* adc_health_rail_watch()/rail_sticky()/rail_init()
|
||||
* ——连续 N 拍贴满量程带且该通道见过释放沿才锁存
|
||||
* (空载恒 0 / 开机恒 0 是合法工况,不误报);
|
||||
@@ -44,7 +45,7 @@ extern "C" {
|
||||
#define ADC_HEALTH_STALL_MS 100U
|
||||
|
||||
/* 电平故障位(adc_health_flags(),当前活跃;stall 可自愈清除,backward 锁存)
|
||||
* ——供后续 L5-4「自检失败闭锁」直接消费 */
|
||||
* ——供后续「自检失败闭锁」直接消费 */
|
||||
#define ADC_HF_TPAFE_STALL (1uL << 0) /* TPAFE 帧序号静默 */
|
||||
#define ADC_HF_STM32_STALL (1uL << 1) /* STM32 DMA 完成计数静默 */
|
||||
#define ADC_HF_SEQ_BACKWARD (1uL << 2) /* 帧序号倒退(锁存,不自愈) */
|
||||
@@ -142,7 +143,7 @@ uint8_t adc_health_age_stale(adc_health_age_t *a_p_age, uint32_t a_cur_seq,
|
||||
* 入口参数:无
|
||||
* 返 回 值:ADC_HF_TPAFE_STALL / ADC_HF_STM32_STALL / ADC_HF_SEQ_BACKWARD 组合
|
||||
* 限定条件:无
|
||||
* 函数说明:供 L5-4 闭锁判定与 UI;与 check() 出参 flags 同源。
|
||||
* 函数说明:供自检失败闭锁判定与 UI;与 check() 出参 flags 同源。
|
||||
*/
|
||||
uint32_t adc_health_flags(void);
|
||||
|
||||
@@ -165,7 +166,7 @@ uint32_t adc_health_sticky(void);
|
||||
*/
|
||||
uint32_t adc_health_tpafe_gaps(void);
|
||||
|
||||
/* ===================== L5-2 残余:码值越界(贴轨)检出,2026-10-25 ===================== */
|
||||
/* ===================== 采样通道自检 残余:码值越界(贴轨)检出,2026-10-25 ===================== */
|
||||
|
||||
/* 贴轨锁存的连续拍数:20 拍 = 1 kHz 节拍下一个 50 Hz 周波。削顶/触轨波形的
|
||||
* 贴带段持续 ≥ 半周波;噪声毛刺不可能连续 20 拍钉在同侧轨带内(短板评测 §6.2
|
||||
@@ -185,7 +186,7 @@ uint32_t adc_health_tpafe_gaps(void);
|
||||
void adc_health_rail_init(void);
|
||||
|
||||
/*
|
||||
* 函数功能:单通道单拍贴轨观察(L5-2 码值越界检出,纯算术)
|
||||
* 函数功能:单通道单拍贴轨观察(采样通道自检 码值越界检出,纯算术)
|
||||
* 入口参数:ch - 通道号(0..ADC_RAIL_CH_NUM-1,越界忽略) uint8_t
|
||||
* code - 本拍原始码值(**码值域**,与标定无关) int32_t
|
||||
* lo_th - 下轨带上界(code ≤ 此值算贴底) int32_t
|
||||
|
||||
@@ -1,13 +1,14 @@
|
||||
/*
|
||||
* 模块名称:ADC 输入层(L1 采集与预处理)
|
||||
* 模块功能:语义通道映射(L1-4)+ STM32 ADC1 采样消费(L1-3,TIM3 TRGO 触发 +
|
||||
* 模块功能:语义通道映射(通道语义映射)+ STM32 ADC1 采样消费(STM32 ADC1 启动与扫描,TIM3 TRGO 触发 +
|
||||
*(保护功能清单见 docs/算法/继电保护功能复现规划.md)
|
||||
* DMA 双缓冲)+ TPAFE 快照消费。
|
||||
* 消费侧经 adc_input_raw() 按语义取数,不写死下标。
|
||||
* 适用平台:STM32F407ZGTx + TPAFE5160
|
||||
* 作者:王建锋
|
||||
* 创建日期:2026-10-10
|
||||
* 修改记录:
|
||||
* v1.0 2026-10-10 王建锋 创建:L1-3(STM32 ADC1 扫描)+ L1-4(语义映射)
|
||||
* v1.0 2026-10-10 王建锋 创建:STM32 ADC1 启动与扫描(STM32 ADC1 扫描)+ 通道语义映射(语义映射)
|
||||
* v2.0 2026-10-10 王建锋 STM32 侧由"软件触发 + 逐通道轮询"改为
|
||||
* "TIM3 TRGO 硬件触发 + DMA 双缓冲消费":本层不再触发
|
||||
* 也不等待转换(消除最坏 2~3 ms 忙等);新增三个 HAL
|
||||
@@ -37,7 +38,7 @@
|
||||
/* 连续"无新帧"达到该拍数才计一次停摆故障(单拍是相位伪影,见 stm32_take 注释) */
|
||||
#define ADC_INPUT_STALL_RUN_MAX 2U
|
||||
|
||||
/* ===== 语义映射表(L1-4)=====
|
||||
/* ===== 语义映射表(通道语义映射)=====
|
||||
* 权威口径:docs/硬件平台/ADC通道映射说明.md(2026-10-09 硬件确认的语义分配)。
|
||||
* index 含义:TPAFE 源 = 驱动 buf 下标 0..7;STM32 源 = ADC1 通道号 0..15。
|
||||
* ⚠ 消费侧一律经本表按语义取数,**不得写死下标**(V0.1 有 13/17 路被置换,
|
||||
@@ -83,7 +84,7 @@ static int s_stm32_rc; /* STM32 最近一次扫描状态码 */
|
||||
static uint32_t s_stm32_errs; /* STM32 扫描累计失败次数 */
|
||||
|
||||
/*
|
||||
* 函数功能:消费一帧 STM32 ADC1 采样(L1-3,DMA 双缓冲)
|
||||
* 函数功能:消费一帧 STM32 ADC1 采样(STM32 ADC1 启动与扫描,DMA 双缓冲)
|
||||
* 入口参数:无
|
||||
* 返 回 值:0 - 取到新一帧;-2 - 本拍无新帧(TIM3 未启动 / ADC 停摆 / DMA 出错)
|
||||
* 限定条件:仅任务上下文调用;adc_input_init() 已挂好 DMA
|
||||
|
||||
@@ -2,8 +2,9 @@
|
||||
* 模块名称:ADC 输入层(L1 采集与预处理)
|
||||
* 模块功能:把两片转换器的原始码值按**语义**(UA/UB/UC/UN/IA/IB/IC/IN/温度)统一
|
||||
* 暴露,使上层(UI / 自检 / 保护算法)**按语义取数,不写死下标**:
|
||||
* ① 语义通道映射表(L1-4)——权威口径 docs/硬件平台/ADC通道映射说明.md;
|
||||
* ② STM32 ADC1 9 通道采样(L1-3)——由 **TIM3 TRGO 硬件触发 + DMA 双缓冲
|
||||
* ① 语义通道映射表(通道语义映射)——权威口径 docs/硬件平台/ADC通道映射说明.md;
|
||||
*(保护功能清单见 docs/算法/继电保护功能复现规划.md)
|
||||
* ② STM32 ADC1 9 通道采样(STM32 ADC1 启动与扫描)——由 **TIM3 TRGO 硬件触发 + DMA 双缓冲
|
||||
* 搬运**,本层只消费、不触发、不等待。
|
||||
* V0.1 上 8 路电气量分属两片转换器(硬件缺陷:双转换器无共同采样触发):UA/UN/IA 走
|
||||
* TPAFE5160(16 位 / ±5 V 双极性),UB/UC/IB/IC/IN 走 STM32 ADC1
|
||||
@@ -13,7 +14,7 @@
|
||||
* 作者:王建锋
|
||||
* 创建日期:2026-10-10
|
||||
* 修改记录:
|
||||
* v1.0 2026-10-10 王建锋 创建:L1-3(STM32 ADC1 扫描)+ L1-4(语义映射)
|
||||
* v1.0 2026-10-10 王建锋 创建:STM32 ADC1 启动与扫描(STM32 ADC1 扫描)+ 通道语义映射(语义映射)
|
||||
* v2.0 2026-10-10 王建锋 STM32 侧改 TIM3 TRGO 硬件触发 + DMA 双缓冲消费:
|
||||
* 消除逐通道轮询的 2 ms 忙等;节拍源 TIM6 -> TIM3
|
||||
* (换源判据:F4 上 ADC1 收不到 TIM6/TIM7 的 TRGO,见
|
||||
|
||||
+3
-2
@@ -1,5 +1,6 @@
|
||||
/*
|
||||
* 模块名称:频率测量层(L2 派生量,L3-5 过频/低频的测量输入)
|
||||
* 模块名称:频率测量层(L2 派生量,过频 / 低频的测量输入)
|
||||
*(保护功能清单见 docs/算法/继电保护功能复现规划.md)
|
||||
* 模块功能:由 L2 相量使用区的基波相量导出系统频率——相邻两拍基波相量取
|
||||
* **共轭乘积** P = Z(m)·conj(Z(m-1))(其角 = 每拍相位增量,纯音 =
|
||||
* +2πf/Fs,免显式解缠绕),再对**自适应窗长**的相位增量做滑动平均:
|
||||
@@ -7,7 +8,7 @@
|
||||
* -> 非整周波 DFT 负序泄漏造成的 ~10 ms 周期相位纹波相消
|
||||
* (定长窗平均实测扫频误差 0.2~0.32 Hz,自适应窗进入 0.01 Hz 量级,
|
||||
* 推导与实测见 freq.c 文件头与 test/host/freq 输出)。
|
||||
* 覆盖规划 §3.3 L3-5 的测量侧与 §4.2 测频范围(45~55 Hz 建议段)。
|
||||
* 覆盖规划 §3.3 过频 / 低频 的测量侧与 §4.2 测频范围(45~55 Hz 建议段)。
|
||||
*
|
||||
* 原理与判据(详见 docs/算法/采集与算法层设计说明.md §7 与 test/host/freq/):
|
||||
* - 采样率 Fs = 1000 Hz(TIM3 节拍,与 phasor 同源);45~55 Hz 段每拍
|
||||
|
||||
+3
-2
@@ -3,7 +3,8 @@
|
||||
* 模块功能:实现见 meas.h——200 ms 基波有效值 + 品质快照,双区无锁读。
|
||||
* 本文件纯算法:输入 = sample_ring 取窗 + 调用方注入(频率/削顶位图),
|
||||
* 无 RTOS / 无寄存器 / 无日志(「数据可信」层内禁令:本目录不写日志)。
|
||||
* 双区不变量(docs/任务规划/数据可信.md §4.5,L2-7 同型,先例 = App/algo/
|
||||
* 双区不变量(docs/任务规划/数据可信.md §4.5,双区指针原子交换 同型,先例 = App/algo/
|
||||
*(保护功能清单见 docs/算法/继电保护功能复现规划.md)
|
||||
* phasor.c 的双区注释):写侧只碰**非使用区**,全部字段填完后一次
|
||||
* volatile 单字节 store 翻转使用区;读者先取索引再整体拷贝 → 拷贝期
|
||||
* 间写者不可能改读者所在区(两帧间隔 200 ms 远大于 72 B 拷贝)。
|
||||
@@ -22,7 +23,7 @@
|
||||
#include "phasor.h" /* phasor_calc():基波 DFT 纯函数核(与使用区同核) */
|
||||
#include "sample_ring.h" /* sample_ring_window():以本拍为终止的一周波窗 */
|
||||
|
||||
/* ===== 双区(计算区 / 使用区),口径同 App/algo/phasor.c 的 L2-7 ===== */
|
||||
/* ===== 双区(计算区 / 使用区),口径同 App/algo/phasor.c 的 双区指针原子交换===== */
|
||||
static meas_snap_t s_ms_snap[2];
|
||||
static volatile uint8_t s_ms_use;
|
||||
static uint8_t s_ms_ready; /* 使用区是否已产出过有效结果 */
|
||||
|
||||
+3
-2
@@ -11,13 +11,14 @@
|
||||
* docs/算法/采集与算法层设计说明.md §10 红线③);**不做** 4 点平均 /
|
||||
* 谐波方和根——docs/任务规划/数据可信.md §4.5 明示"200 ms 是上送节拍
|
||||
* 不是平均窗,再平均引入滞后";谐波 k-bin 轨(docs/算法/继电保护功能
|
||||
* 复现规划.md L2-8)将来扩展时只许在本结构**尾部追加**或留在发布侧
|
||||
* 复现规划.md 遥测谐波轨(可选))将来扩展时只许在本结构**尾部追加**或留在发布侧
|
||||
*(保护功能清单见 docs/算法/继电保护功能复现规划.md)
|
||||
* 内部状态,既有字段序不得变更。
|
||||
* TEMP 通道(「数据可信」决策 5:不参与线性标定):yc = 最新一拍原始
|
||||
* 帧值透传,qds 恒置 NT——值在场但非交流量语义,UI 按「数据可信」§4.2
|
||||
* 三态表显示占位符,104 无对应点。
|
||||
* 并发(docs/任务规划/数据可信.md §4.5 原文口径):沿用 phasor 的
|
||||
* **双区 + 单字节活跃索引翻转**(L2-7 同型,不是新机制)——写侧填满
|
||||
* **双区 + 单字节活跃索引翻转**(双区指针原子交换 同型,不是新机制)——写侧填满
|
||||
* 计算区后一次 store 翻转,读者先取索引再整体拷贝,全程无锁;
|
||||
* seq 只增,消费者据此判"是否换帧"。
|
||||
* 本层**纯算法**:不碰寄存器、不碰 RTOS、不自己取数(窗自 sample_ring、
|
||||
|
||||
+14
-14
@@ -1,12 +1,12 @@
|
||||
/*
|
||||
* 模块名称:相量计算层(L2 相量计算)
|
||||
* 模块功能:全周傅氏算法(单频 DFT)——系数表预乘 √2/N,fAmSQ 直接即有效值。
|
||||
* 覆盖 L2-1 系数表 / L2-2 实例 / L2-3 有效值 / L2-6 滑动窗 / L2-7 双区交换。
|
||||
* 覆盖 全周傅氏系数表 / 基波相量实例 / 相量有效值输出 / 每 1 ms 滑动窗刷新 / 双区指针原子交换。
|
||||
* 适用平台:STM32F407ZGTx(Cortex-M4F,硬件 FPU)
|
||||
* 作者:王建锋
|
||||
* 创建日期:2026-10-10
|
||||
* 修改记录:
|
||||
* v1.0 2026-10-10 王建锋 创建:L2-1/2/3/6/7
|
||||
* v1.0 2026-10-10 王建锋 创建:全周傅氏系数表 等
|
||||
*/
|
||||
|
||||
#include "phasor.h"
|
||||
@@ -16,7 +16,7 @@
|
||||
|
||||
#include "sample_ring.h"
|
||||
|
||||
/* ===== L2-1 全周傅氏系数表 =====
|
||||
/* ===== 全周傅氏系数表 =====
|
||||
* g_fFFTSin20[k] = sin(2πk/N)·(√2/N)
|
||||
* g_fFFTCos20[k] = cos(2πk/N)·(√2/N) N = PHASOR_N = 20
|
||||
* 权威口径:docs/算法/傅氏算法详解.md §2.3("把 √2 藏进系数表")。
|
||||
@@ -41,23 +41,23 @@ static const float k_fft_cos[PHASOR_N] = {
|
||||
/* √2:幅值 = √2 × 有效值(与系数表的 √2 折算互逆) */
|
||||
#define PHASOR_SQRT2 1.4142135623730951f
|
||||
|
||||
/* ===== L2-2 相量实例表 =====
|
||||
/* ===== 基波相量实例表 =====
|
||||
* 参考项目为 **4 个实例**(C01 基波 I/U、C02 零序基波、C03 二次谐波、C04 五次谐波,
|
||||
* `APP/CLS100_Dsp/InstCalCell.c`)。本项目按 V0.1 **有效通道**(`UA`/`UN`/`IA`,
|
||||
* 见 docs/算法/继电保护功能复现规划.md §1.6:`UB/UC/IB/IC/IN` 无中点偏置 → 削顶不可用)展开——C01 的"I/U"
|
||||
* 拆为两行(IA 电流 / UA 电压),并补出 C04 的五次谐波轨(L1-9)。
|
||||
* 拆为两行(IA 电流 / UA 电压),并补出 C04 的五次谐波轨(二次谐波/五次谐波提取入口)。
|
||||
* 新增实例只需在表尾加一行,其余代码自动适配。 */
|
||||
static const phasor_inst_t k_inst[] = {
|
||||
{ "C01-IA-F1", ADC_SEM_IA, 1u }, /* A 相电流基波(L3-1 过流 / L3-3 过负荷) */
|
||||
{ "C02-UA-F1", ADC_SEM_UA, 1u }, /* A 相电压基波(L3-4 过压/欠压、L3-5 频率) */
|
||||
{ "C03-UN-F1", ADC_SEM_UN, 1u }, /* 零序电压基波(L3-6 零序过压) */
|
||||
{ "C04-IA-F2", ADC_SEM_IA, 2u }, /* 二次谐波(L3-7 涌流制动) */
|
||||
{ "C05-IA-F5", ADC_SEM_IA, 5u }, /* 五次谐波(L1-9 选线) */
|
||||
{ "C01-IA-F1", ADC_SEM_IA, 1u }, /* A 相电流基波(三段式相间过流 / 过负荷) */
|
||||
{ "C02-UA-F1", ADC_SEM_UA, 1u }, /* A 相电压基波(过压 / 欠压、过频 / 低频) */
|
||||
{ "C03-UN-F1", ADC_SEM_UN, 1u }, /* 零序电压基波(零序过压) */
|
||||
{ "C04-IA-F2", ADC_SEM_IA, 2u }, /* 二次谐波(涌流制动) */
|
||||
{ "C05-IA-F5", ADC_SEM_IA, 5u }, /* 五次谐波(二次谐波/五次谐波提取入口(选线用)) */
|
||||
};
|
||||
|
||||
#define PHASOR_INST_N (sizeof(k_inst) / sizeof(k_inst[0]))
|
||||
|
||||
/* ===== L2-7 双区(计算区 / 使用区)=====
|
||||
/* ===== 双区指针原子交换(计算区 / 使用区)=====
|
||||
* 本拍结果先写入"计算区",全部实例写完后**一次性**切换 s_use_zone
|
||||
* (单字节 store,Cortex-M 上原子),消费侧读"使用区" → 无锁、无撕裂。
|
||||
* s_use_zone 声明 volatile:阻止编译器把结果写入挪到切换之后
|
||||
@@ -83,7 +83,7 @@ static void phasor_zero(phasor_t *p) {
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能:对 n 点窗口算 harm 次相量(L2-1 系数表 + L2-3 有效值)
|
||||
* 函数功能:对 n 点窗口算 harm 次相量(全周傅氏系数表 + 相量有效值输出)
|
||||
* 入口参数:x - 采样窗(按时间序,旧 → 新)
|
||||
* n - 窗长(必须等于 PHASOR_N)
|
||||
* harm - 谐波次数(>=1)
|
||||
@@ -134,7 +134,7 @@ int phasor_init(void) {
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能:取相量实例数(L2-2)
|
||||
* 函数功能:取相量实例数
|
||||
* 入口参数:无
|
||||
* 返 回 值:实例个数
|
||||
* 限定条件:无
|
||||
@@ -159,7 +159,7 @@ const phasor_inst_t *phasor_inst(uint8_t idx) {
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能:重算全部实例 + 双区原子切换(L2-6 / L2-7)
|
||||
* 函数功能:重算全部实例 + 双区原子切换(每 1 ms 滑动窗刷新 / 双区指针原子交换)
|
||||
* 入口参数:无
|
||||
* 返 回 值:无
|
||||
* 限定条件:仅任务上下文调用;须先 sample_ring_push_frame() 压入本拍数据
|
||||
|
||||
+9
-8
@@ -4,15 +4,16 @@
|
||||
* 产出基波/谐波相量。系数表**预乘 √2/N**(口径见
|
||||
* `docs/算法/傅氏算法详解.md` §2.3),故 `fAmSQ = √(fRe²+fIm²)`
|
||||
* **直接就是有效值**,无需再除 √2。
|
||||
* 覆盖规划 §3.2:L2-1 系数表 / L2-2 实例 / L2-3 有效值输出 /
|
||||
* L2-6 每 1 ms 滑动窗 / L2-7 双区指针原子交换。
|
||||
* 覆盖规划 §3.2:全周傅氏系数表 / 基波相量实例 / 相量有效值输出 /
|
||||
*(保护功能清单见 docs/算法/继电保护功能复现规划.md)
|
||||
* 每 1 ms 滑动窗刷新 / 双区指针原子交换。
|
||||
* ⚠ 本层**纯算法**:不碰寄存器、不碰任务调度、不自己取数(输入由
|
||||
* `sample_ring` 提供)→ 主机侧可单测(L0.5)。
|
||||
* 适用平台:STM32F407ZGTx(Cortex-M4F,硬件 FPU)
|
||||
* 作者:王建锋
|
||||
* 创建日期:2026-10-10
|
||||
* 修改记录:
|
||||
* v1.0 2026-10-10 王建锋 创建:L2-1/2/3/6/7(基波 + 谐波相量)
|
||||
* v1.0 2026-10-10 王建锋 创建:全周傅氏系数表 等(基波 + 谐波相量)
|
||||
*/
|
||||
|
||||
#ifndef PHASOR_H
|
||||
@@ -35,7 +36,7 @@ extern "C" {
|
||||
* fIm - 虚部 = b1/√2(有效值相量虚部)
|
||||
* fAm - 幅值 = √2·√(fRe²+fIm²)(正弦峰值 A1)
|
||||
* fAmSQ - 有效值 = √(fRe²+fIm²)(系数已折算 √2/N,故直接即有效值)
|
||||
* 相位(L2-4)按需由 `atan2(fIm, fRe)` 导出,不常驻本结构。 */
|
||||
* 相位输出按需由 `atan2(fIm, fRe)` 导出,不常驻本结构。 */
|
||||
typedef struct {
|
||||
float fRe;
|
||||
float fIm;
|
||||
@@ -43,7 +44,7 @@ typedef struct {
|
||||
float fAmSQ;
|
||||
} phasor_t;
|
||||
|
||||
/* 相量实例(L2-2):**数据驱动**——新增实例只需在实例表尾加一行 */
|
||||
/* 基波相量实例:**数据驱动**——新增实例只需在实例表尾加一行 */
|
||||
typedef struct {
|
||||
const char *name; /* 实例名(日志 / UI 用) */
|
||||
adc_semantic_t sem; /* 语义通道 */
|
||||
@@ -60,7 +61,7 @@ typedef struct {
|
||||
int phasor_init(void);
|
||||
|
||||
/*
|
||||
* 函数功能:取相量实例数(L2-2)
|
||||
* 函数功能:取相量实例数
|
||||
* 入口参数:无
|
||||
* 返 回 值:实例个数
|
||||
* 限定条件:无
|
||||
@@ -78,7 +79,7 @@ uint8_t phasor_inst_count(void);
|
||||
const phasor_inst_t *phasor_inst(uint8_t idx);
|
||||
|
||||
/*
|
||||
* 函数功能:重算全部实例并从计算区原子切换到使用区(L2-6 滑动窗 + L2-7 双区交换)
|
||||
* 函数功能:重算全部实例并从计算区原子切换到使用区(每 1 ms 滑动窗刷新 + 双区指针原子交换)
|
||||
* 入口参数:无
|
||||
* 返 回 值:无
|
||||
* 限定条件:仅任务上下文调用;须先经 `sample_ring_push_frame()` 压入本拍数据
|
||||
@@ -99,7 +100,7 @@ void phasor_run(void);
|
||||
int phasor_get(uint8_t idx, phasor_t *out);
|
||||
|
||||
/*
|
||||
* 函数功能:对 n 点窗口算 harm 次相量(L2-1 系数表 + L2-3 有效值)
|
||||
* 函数功能:对 n 点窗口算 harm 次相量(全周傅氏系数表 + 相量有效值输出)
|
||||
* 入口参数:x - 采样窗(按时间序,旧 → 新;长度须 = PHASOR_N)
|
||||
* n - 窗长(必须等于 PHASOR_N)
|
||||
* harm - 谐波次数(>=1)
|
||||
|
||||
+3
-2
@@ -53,7 +53,7 @@ static const pe_cfg_t k_pe[PE_COUNT] = { /* ← 表头注释见上,行内列
|
||||
{ "OV-UA", 1u, PE_SRC_PHASOR, PS_OV_EN, PROT_ELM_NO_TRIP, PS_OV_VOL, PS_OV_DLY, PS_RET_OVER, "C02" },
|
||||
{ "UV-UA", 0u, PE_SRC_PHASOR, PS_UV_EN, PROT_ELM_NO_TRIP, PS_UV_VOL, PS_UV_DLY, PS_RET_UNDER, "C02" },
|
||||
{ "3U0-UN", 1u, PE_SRC_PHASOR, PS_3U0_EN, PROT_ELM_NO_TRIP, PS_3U0_VOL, PS_3U0_DLY, PS_RET_OVER, "C03" },
|
||||
/* 过频/低频(L3-5,B8):测量量 = freq 层测得频率(Hz),返回系数独立
|
||||
/* 过频/低频(过频 / 低频,B8):测量量 = freq 层测得频率(Hz),返回系数独立
|
||||
* (RET_OF/RET_UF——频率滞回带与电气量不同量级,勿共用 0.95/1.05) */
|
||||
{ "OF-F", 1u, PE_SRC_FREQ, PS_OF_EN, PROT_ELM_NO_TRIP, PS_OF_HZ, PS_OF_DLY, PS_RET_OF, 0 },
|
||||
{ "UF-F", 0u, PE_SRC_FREQ, PS_UF_EN, PROT_ELM_NO_TRIP, PS_UF_HZ, PS_UF_DLY, PS_RET_UF, 0 },
|
||||
@@ -136,7 +136,8 @@ void prot_elm_request_reset(void) {
|
||||
* 入口参数:now_ms - 单调时基(tick ms,差值法回绕安全)
|
||||
* meas - PE_COUNT 个测量值(工程量 A/V);NULL 视为全 0
|
||||
* 返 回 值:无
|
||||
* 函数说明:投退=0 或定值闭锁(L5-1)→ 状态整体复位、不判据;
|
||||
* 函数说明:投退=0 或定值闭锁(定值校验和)→ 状态整体复位、不判据;
|
||||
*(保护功能清单见 docs/算法/继电保护功能复现规划.md)
|
||||
* 滞回 = 已启动用返回门槛(定值×系数)、未启动用动作门槛;
|
||||
* 延时 dly=0 → 启动同拍即动作;返回即时(P4 接出口时再补返回延时)。
|
||||
*/
|
||||
|
||||
+9
-8
@@ -5,11 +5,12 @@
|
||||
* 主机侧可离线单测;出口/SOE(L4)与任务编排为后续。
|
||||
*
|
||||
* V0.1 有效实例(双转换器无共同采样触发 → 仅 TPAFE 三路):
|
||||
* OC1/OC2/OC3 三段式相间过流(A 相 IA,L3-1)
|
||||
* OL 过负荷(A 相 IA,L3-3)
|
||||
* OV/UV 过压/欠压(UA,L3-4)
|
||||
* 3U0 零序过压(UN 外部零序电压通道,L3-6)
|
||||
* OF/UF 过频/低频(测量量 = freq 层测得频率,L3-5,B8 落地)
|
||||
* OC1/OC2/OC3 三段式相间过流(A 相 IA)
|
||||
*(保护功能清单见 docs/算法/继电保护功能复现规划.md)
|
||||
* OL 过负荷(A 相 IA)
|
||||
* OV/UV 过压/欠压(UA,过压 / 欠压)
|
||||
* 3U0 零序过压(UN 外部零序电压通道)
|
||||
* OF/UF 过频/低频(测量量 = freq 层测得频率,过频 / 低频,B8 落地)
|
||||
*
|
||||
* 测量数组口径:相量类实例 = 基波有效值(A/V);OF/UF = 测得频率(Hz)。
|
||||
* run() 按实例表 src 字段取数(0=phasor rms,1=freq)。freq 无有效读数
|
||||
@@ -48,8 +49,8 @@ typedef enum {
|
||||
PE_OV, /* 过压(UA) */
|
||||
PE_UV, /* 欠压(UA,欠量方向) */
|
||||
PE_3U0, /* 零序过压(UN) */
|
||||
PE_OF, /* 过频(测量量 = freq 层测得频率,B8,L3-5) */
|
||||
PE_UF, /* 低频(测量量 = freq 层测得频率,欠量方向,B8,L3-5) */
|
||||
PE_OF, /* 过频(测量量 = freq 层测得频率,B8,过频 / 低频) */
|
||||
PE_UF, /* 低频(测量量 = freq 层测得频率,欠量方向,B8,过频 / 低频) */
|
||||
PE_COUNT
|
||||
} prot_elm_id_t;
|
||||
|
||||
@@ -81,7 +82,7 @@ void prot_elm_request_reset(void);
|
||||
* meas - PE_COUNT 个测量值(工程量:A / V),NULL 视为全 0
|
||||
* 返 回 值:无
|
||||
* 限定条件:仅保护消费者任务上下文;调用方保证定值已装载
|
||||
* 函数说明:越限方向由实例表决定;投退=0 或定值闭锁(L5-1)→ 状态复位、
|
||||
* 函数说明:越限方向由实例表决定;投退=0 或定值闭锁(定值校验和)→ 状态复位、
|
||||
* 不判据。延时判定用 (uint32_t)(int32_t)(now - t0) >= dly,回绕安全。
|
||||
*/
|
||||
void prot_elm_eval(uint32_t now_ms, const float meas[PE_COUNT]);
|
||||
|
||||
+5
-4
@@ -1,5 +1,6 @@
|
||||
/*
|
||||
* 模块名称:保护定值模型(P1,L5-1 载体)——实现
|
||||
* 模块名称:保护定值模型(P1,定值校验和 载体)——实现
|
||||
*(保护功能清单见 docs/算法/继电保护功能复现规划.md)
|
||||
* 模块功能:见 prot_set.h。纯逻辑,零平台依赖(仅 stdint.h + 自身头)。
|
||||
*
|
||||
* ⚠ 默认值/范围为拟定值(参考 EEPROM 出厂默认表不在本仓库,规划 §10.3 待补);
|
||||
@@ -55,7 +56,7 @@ const prot_set_meta_t g_prot_set_meta[PS_ID_COUNT] = {
|
||||
{ 0x8825, 0u, PROT_SET_Q10(100.0), PROT_SET_Q10(1.0), PROT_SET_Q10(10000.0) },
|
||||
{ 0x8826, 0u, PROT_SET_Q10(5.0), PROT_SET_Q10(1.0), PROT_SET_Q10(10.0) },
|
||||
{ 0x0000, 1u, PROT_SET_Q10(1), 0, PROT_SET_Q10(1) }, /* 全局软压板投退(YK12,B7) */
|
||||
/* --- 过频 / 低频(L3-5,B8):地址全 0 = 本地项(参考逐项地址不在
|
||||
/* --- 过频 / 低频(B8):地址全 0 = 本地项(参考逐项地址不在
|
||||
* 本仓库,规划 §5.1 仅示"8820~8882 含低压/低频"类目);
|
||||
* 默认值/范围**拟定**(DTU 馈线典型量级),待对照参考出厂表修订 --- */
|
||||
{ 0x0000, 1u, PROT_SET_Q10(1), 0, PROT_SET_Q10(1) }, /* OF 投退(本地) */
|
||||
@@ -75,7 +76,7 @@ static volatile uint8_t s_act; /* 活跃区下标(0/1);交换 =
|
||||
static uint32_t s_sum; /* 封存的正码 */
|
||||
static uint32_t s_sumn; /* 封存的反码 */
|
||||
static uint64_t s_bad_mask; /* load_raw/parse 越界位图(B8:40 项 → 64 位) */
|
||||
static uint8_t s_locked; /* 定值非法 → 闭锁(L5-1) */
|
||||
static uint8_t s_locked; /* 定值非法 → 闭锁(定值校验和) */
|
||||
static uint8_t s_dirty; /* 未落盘定值改动(B7 持久化脏标志) */
|
||||
|
||||
/*
|
||||
@@ -293,7 +294,7 @@ void prot_set_seal(void) {
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能:定值自检(L5-1)——重算 sum32 并与封存值比对
|
||||
* 函数功能:定值自检(定值校验和)——重算 sum32 并与封存值比对
|
||||
* 入口参数:无
|
||||
* 返 回 值:0 通过 / -1 失配(已置闭锁)
|
||||
* 函数说明:失配 → s_locked 置位并保持,直到下一次 seal;
|
||||
|
||||
+8
-8
@@ -1,5 +1,5 @@
|
||||
/*
|
||||
* 模块名称:保护定值模型(P1,L5-1 载体)
|
||||
* 模块名称:保护定值模型(P1,定值校验和 载体)
|
||||
* 模块功能:保护定值的 RAM 模型——编号 / 通讯地址 / 范围 / 默认值 / 校验和自检,
|
||||
* 以及 B7 定值持久化的**纯逻辑层**(blob 序列化/解析 + 原子装载)。
|
||||
* 文件读写胶水在 App/cfg/prot_set_store.c(MCU 端)。
|
||||
@@ -8,7 +8,7 @@
|
||||
* - 定点存储:Q10(×1024),与参考系统定点系数 2^10 一致(§5.3);
|
||||
* - 通讯地址:与参考 g_tCommSetParaTab(Comm/Pub/Const_CommSetPara.c)逐项对齐,
|
||||
* 基址 0x8820(=34848);告警类沿用运行参数段 0x8027/0x8029;
|
||||
* - 校验和(L5-1):sum32 正码 + 反码成对封存(参考 tagPRS 的
|
||||
* - 校验和(定值校验和):sum32 正码 + 反码成对封存(参考 tagPRS 的
|
||||
* dwTagSum/dwTagSumN 模式),selfcheck 失配 → 置闭锁;
|
||||
* - ⚠ 默认值/范围为**拟定值**:参考 EEPROM 出厂默认表未在本仓库,
|
||||
* 待对照后逐项修订(规划 §10.3 待补项);范围先按 DTU 馈线典型量级。
|
||||
@@ -36,7 +36,7 @@
|
||||
|
||||
/* 定值项编号(枚举序 = RAM 数组序 = 校验和覆盖序,只增不删不改序) */
|
||||
typedef enum {
|
||||
/* --- 三段式相间过流(A 相,L3-1):投退/跳闸投退/电流/延时 --- */
|
||||
/* --- 三段式相间过流(A 相):投退/跳闸投退/电流/延时 --- */
|
||||
PS_OC1_EN = 0, /* 0x8856 Ⅰ段投退 */
|
||||
PS_OC1_TRIP, /* 0x8857 Ⅰ段跳闸投退(0 告警 / 1 跳闸) */
|
||||
PS_OC1_CUR, /* 0x8858 Ⅰ段电流定值(A,二次值) */
|
||||
@@ -49,19 +49,19 @@ typedef enum {
|
||||
PS_OC3_TRIP, /* 0x885F */
|
||||
PS_OC3_CUR, /* 0x8860 */
|
||||
PS_OC3_DLY, /* 0x8861 */
|
||||
/* --- 过负荷(A 相,L3-3) --- */
|
||||
/* --- 过负荷(A 相) --- */
|
||||
PS_OL_EN, /* 0x8871 */
|
||||
PS_OL_TRIP, /* 0x8872 */
|
||||
PS_OL_CUR, /* 0x8873 */
|
||||
PS_OL_DLY, /* 0x8874 */
|
||||
/* --- 过压 / 欠压(UA,L3-4;沿用参考告警段 0x8029/0x8027) --- */
|
||||
/* --- 过压 / 欠压(UA;沿用参考告警段 0x8029/0x8027) --- */
|
||||
PS_OV_EN, /* 本地投退(参考告警类无独立投退,V0.1 补) */
|
||||
PS_OV_VOL, /* 0x8029 过电压门限(V,二次值) */
|
||||
PS_OV_DLY, /* 0x802A 过电压延时(ms) */
|
||||
PS_UV_EN, /* 本地投退 */
|
||||
PS_UV_VOL, /* 0x8027 低电压门限(V,二次值) */
|
||||
PS_UV_DLY, /* 0x8028 低电压延时(ms) */
|
||||
/* --- 零序过压(UN,L3-6) --- */
|
||||
/* --- 零序过压(UN) --- */
|
||||
PS_3U0_EN, /* 0x888E */
|
||||
PS_3U0_VOL, /* 0x888F 3U0 定值(V,二次值) */
|
||||
PS_3U0_DLY, /* 0x8890 延时(ms) */
|
||||
@@ -74,7 +74,7 @@ typedef enum {
|
||||
PS_CT_SEC, /* 0x8826 CT 二次额定(A) */
|
||||
/* --- 全局软压板(B7):104 YK12 两段式投退;0 = 保护退出服务 --- */
|
||||
PS_GLOBAL_EN, /* 本地项(无通讯地址,经 YK12 写、C_RD 不可读) */
|
||||
/* --- 过频 / 低频(L3-5,B8):投退/动作频率/延时 + 各自返回系数 ---
|
||||
/* --- 过频 / 低频(B8):投退/动作频率/延时 + 各自返回系数 ---
|
||||
* ⚠ 通讯地址:参考 g_tCommSetParaTab 的保护定值段(0x8820~0x8882)
|
||||
* 含"低压/低频"类目(规划 §5.1),但 OF/UF 的**逐项地址不在本仓库**
|
||||
* (参考 Comm 源文件未随仓库提供)→ 按"找不到对应即本地项"规则全部
|
||||
@@ -130,7 +130,7 @@ int32_t prot_set_get(prot_set_id_t id); /* Q10 原值 */
|
||||
float prot_set_get_f(prot_set_id_t id); /* 工程量浮点 */
|
||||
uint8_t prot_set_get_ctl(prot_set_id_t id); /* 投退项:!=0 视为投入 */
|
||||
|
||||
/* 校验和(L5-1):sum32 覆盖 RAM 值区;seal 封存正/反码对 */
|
||||
/* 校验和(定值校验和):sum32 覆盖 RAM 值区;seal 封存正/反码对 */
|
||||
uint32_t prot_set_checksum(void);
|
||||
void prot_set_seal(void);
|
||||
/* 自检:重算并与封存值比对,失配 → 置闭锁并返回 -1(已闭锁也返回 -1) */
|
||||
|
||||
@@ -117,7 +117,8 @@ uint16_t sample_ring_filled(void) {
|
||||
* 入口参数:无
|
||||
* 返 回 值:累计入环帧数
|
||||
* 限定条件:无
|
||||
* 函数说明:供心跳日志 / 丢帧观测(L1-6 判据之一)。
|
||||
* 函数说明:供心跳日志 / 丢帧观测(采样有效性校验 判据之一)。
|
||||
*(保护功能清单见 docs/算法/继电保护功能复现规划.md)
|
||||
*/
|
||||
uint32_t sample_ring_frames(void) {
|
||||
return s_frames;
|
||||
|
||||
@@ -76,7 +76,8 @@ uint16_t sample_ring_filled(void);
|
||||
* 入口参数:无
|
||||
* 返 回 值:累计入环帧数(32 位,1 kHz 下约 49.7 天回绕)
|
||||
* 限定条件:无
|
||||
* 函数说明:与 L1 的 `tpafe5160_frame_seq()` 对照可判丢帧(L1-6 采样有效性校验
|
||||
* 函数说明:与 L1 的 `tpafe5160_frame_seq()` 对照可判丢帧(采样有效性校验
|
||||
*(保护功能清单见 docs/算法/继电保护功能复现规划.md)
|
||||
* 的判据之一,本层只提供计数,不做判定)。
|
||||
*/
|
||||
uint32_t sample_ring_frames(void);
|
||||
|
||||
Reference in New Issue
Block a user