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:
@@ -1,7 +1,7 @@
|
||||
/*
|
||||
* 模块名称：IEC 60870-5-104 点表与数据源适配（实现）
|
||||
* 模块功能：实现 iec104_pts.h——YC/YX/YK/定值点表（ROM）、板端默认源
|
||||
* （**L2 遥测快照**（104 改读快照）/ prot_elm / prot_set）、COV 比对（遥信变位 +
|
||||
* （**测频与遥测快照**（104 改读快照）/ prot_elm / prot_set）、COV 比对（遥信变位 +
|
||||
* 遥测死区 2 点确认 + 品质变化）。点表口径见 iec104_pts.h 文件头与
|
||||
* 设计文档 §3。
|
||||
* 线程约定：init/bind 建服务前；其余仅 104 服务任务上下文（快照非原子）。
|
||||
@@ -12,7 +12,7 @@
|
||||
* k_yc 表头注释；数值随 104 改读快照迁运行参数，本表将退化为
|
||||
* ROM 默认载体。
|
||||
* 2026-10-25 DTU 项目组 104 改读快照与频率点绑定（「数据可信」，道D）：YC 板端源改读
|
||||
* L2 遥测快照（App/algo/meas.h，meas_get 无锁双区）；
|
||||
* 测频与遥测快照（App/algo/meas.h，meas_get 无锁双区）；
|
||||
* 削顶五路由快照品质 CLIPPED 驱动线上 IV（不再绑死 -1，
|
||||
* V0.2 消除双转换器无共同采样触发后零改动自动启用）；0x401d 绑频率源（频率点绑定）；
|
||||
* 死区改运行时副本 + set/get 入口；COV 遥测腿 = 死区
|
||||
@@ -36,7 +36,7 @@
|
||||
#include <string.h>
|
||||
|
||||
#include "iec104_asdu.h" /* QDS/DIQ 品质位常量 */
|
||||
#include "meas.h" /* 板端源：遥测 = L2 遥测快照（104 改读快照；品质域位同源） */
|
||||
#include "meas.h" /* 板端源：遥测 = 测频与遥测快照（104 改读快照；品质域位同源） */
|
||||
#include "run_par.h" /* 运行参数段：死区真源 + 104 读写路由 */
|
||||
#include "prot_elm.h" /* 板端源：遥信 = 元件状态 */
|
||||
#include "prot_set.h" /* 板端源：定值 + 闭锁 */
|
||||
@@ -45,7 +45,7 @@
|
||||
|
||||
/* ---------------- YC 表（§1.5 点号 4011+；死区列 = ROM 默认值） ------------ */
|
||||
/* 源类型（「数据可信」频率点绑定：YC 表加 src 类型区分相量/频率） */
|
||||
#define PTS_SRC_MEAS 0u /* L2 快照槽 sem（电气量，yc/qds 直读） */
|
||||
#define PTS_SRC_MEAS 0u /* 全周傅氏相量快照槽 sem（电气量，yc/qds 直读） */
|
||||
#define PTS_SRC_FREQ 1u /* 快照频率（freq_valid 门 → IV） */
|
||||
|
||||
typedef struct {
|
||||
@@ -458,7 +458,7 @@ int iec104_pts_set_write(uint32_t addr, float v, uint8_t select) {
|
||||
/* ============================ 板端默认源 ================================= */
|
||||
|
||||
/*
|
||||
* 函数功能：板端默认源 - 遥测 = L2 遥测快照直读（「数据可信」104 改读快照与频率点绑定）
|
||||
* 函数功能：板端默认源 - 遥测 = 测频与遥测快照直读（「数据可信」104 改读快照与频率点绑定）
|
||||
* 入口参数：idx - YC 表下标 out/qds - 值 + uint16 域品质（MEAS_QDS_*）
|
||||
* 返 回 值：0 / -1 越界或频率未新鲜（IV）/ -2 快照从未发布（NT） int
|
||||
* 限定条件：iec104Task 上下文（meas_get 为双区无锁读，App/algo/meas.h）
|
||||
|
||||
@@ -6,7 +6,7 @@
|
||||
* （asdu+pts+link）可离线跑（分层约束：协议解析与硬件 I/O 分离）。
|
||||
* 点表口径（docs/算法/继电保护功能复现规划.md §1.5，验收 = 省电科院点表）：
|
||||
* - YC：IOA 0x4011~0x4018 + 0x401d（频率），短浮点、系数 1；数据源 =
|
||||
* L2 遥测快照（App/algo/meas.h，「数据可信」104 改读快照与频率点绑定）：电气 8 路绑快照槽，
|
||||
* 测频与遥测快照（App/algo/meas.h，「数据可信」104 改读快照与频率点绑定）：电气 8 路绑快照槽，
|
||||
* 有效性由快照品质驱动——V0.1 削顶路（docs/算法/继电保护功能复现规划.md
|
||||
* §1.6）快照置 CLIPPED → 本层映射为线上 IV（V0.2 后自动启用，绑定零
|
||||
* 改动，见 docs/任务规划/数据可信.md §10「双转换器无共同采样触发」行）；0x401d 绑频率源，
|
||||
@@ -25,7 +25,7 @@
|
||||
* 线程约定：init/bind 内核启动前或建服务前；cov_check/read 仅 104 服务任务上下文。
|
||||
* 创建日期：2026-10-12（B4）
|
||||
* 修改记录：
|
||||
* 2026-10-25 DTU 项目组 104 改读快照与频率点绑定（「数据可信」，道D）：YC 数据源 = L2 遥测
|
||||
* 2026-10-25 DTU 项目组 104 改读快照与频率点绑定（「数据可信」，道D）：YC 数据源 = 全周傅氏相量遥测
|
||||
* 快照（削顶路由品质驱动 IV）；死区改运行时副本 +
|
||||
* set/get 入口；COV 遥测腿 = 死区 2 点确认（seq 去重）
|
||||
* + 品质变化即报；0x401d 绑频率源（freq_valid → IV）。
|
||||
|
||||
Reference in New Issue
Block a user