wandering1
0f7b5a87fb
登记簿、文档与代码注释里的存量字母加数字编号（N-x / S-x / T-x / E-x / A-x / 卡号） 一律改写为语义短语，净删 2,028 处引用；删除基线与待确认、并行分道方案、排期详述、 采集保护收尾 4 篇（内容已并入 docs/任务规划/README 与登记簿）。 门禁机器与三张账同批重打：check_ids.py 新增变更记录行豁免与第二根护栏 undecidable_total_ceiling；check_test_traceability.py 只加 stdout/stderr UTF-8 reconfigure（TC_RE 未动）；check_cubemx_survival.py 的 --write 固定 newline=LF； id_registry / id_aliases（+19 条 retired-to-phrase）/ id_known_backlog 重打。 test/ 56 个文件同步 TC 标签语义化，其中 18 个 TU 改了 CHECK / printf 里的标签文字， 是本批唯一改变构建产物的文件集合。 为什么合成一笔、不拆四笔（实测撞闸，非偏好）：pre-commit 跑钩子前会 stash 未 staged 部分，拆开后中间提交必然是「新规则 + 旧语料」——实跑可判定 85.15% < 基线 86.00%、 不可判定 1,453 > 上限 1,166，编号门禁直接拦下。编号识别面与它描述的语料只能同码移动。 实跑基线（工作区全量）：754 文件 / 8,230 处编号字面量 / 可判定 7,079 = 86.01% （基线 86.0%，容差 0.1pp）/ 不可判定绝对数 1,151（上限 1,166）/ 校验 1-6 错误级 0 / 告警 = 悬空 2（App/algo/freq.c 的 S2，属 §4.4 同号不同义）+ 孤儿 50。 基线从 84.0 抬到 86.0 的理由见 docs/门禁说明/id-check.md §7.6：本批真删了 2,028 处 引用，可判定面随真实内容上升，不是把分母做小。同批新增排除 docs/硬件平台/ 语料，使 识别面少 264 处——芯片手册位号与网表料号不属编号空间（registry 有 excluded_paths_note）。 ⚠ 余量只剩 0.11pp（约 10 处）与绝对数 15 处：把「可判定的引用」改成散文会立刻撞第二 根护栏。另遗留一项：id_aliases 里 retired 的 N / S / T / A 别名没有 scope（U1~U5 有）， 今后有人新写一个 A-4，校验 3 不会响，只能靠人，建议下批补 scope。 固件不变证据：115 个 .c/.h 剥注释并归一字符串后与 HEAD 逐字节全等，残留代码差异 0； App / Src / Drivers 的字符串字面量零改动。@build 0 错误 0 警告；40/40 主机套件、2,889 断言全通过；覆盖率 line 89.2% / func 92.6%；pre-commit 48 钩子 --all-files 全绿； check_doc_links --all 通过（176 文档，章节引用无法判定 0）；逐字节卫生核过：14 个带 BOM 文件与 HEAD 一致、0 个 CR、0 个 U+FFFD，字符串字面量纯 ASCII。 .cubemx_survival_baseline.json 的 watchdog-module 哈希 56bf27 变 2bb051 属合法： Src/freertos.c 的 USER CODE 区内只有注释文字随编号改写，代码未变。 同批带上体积同码凭证与 RAM 台账行（@build 之后盖戳）：RW_IRAM1 79,008 B / 60.3%， RW_CCM 57,376 B / 87.9%，阈值 92%。
131 lines
8.2 KiB
C
131 lines
8.2 KiB
C
/*
|
||
* 模块名称：IEC 60870-5-104 点表与数据源适配（纯逻辑 + 源注入）
|
||
* 模块功能：104 点表（遥测 YC / 遥信 YX / 遥控 YK / 定值）的定义、读取与变化检测
|
||
* （COV：遥信变位 + 遥测死区）。**数据源经 vtable 注入**：板端绑
|
||
* phasor/prot_elm/prot_set 真实源；主机单测绑假源 → 协议栈全链
|
||
* （asdu+pts+link）可离线跑（分层约束：协议解析与硬件 I/O 分离）。
|
||
* 点表口径（docs/算法/继电保护功能复现规划.md §1.5，验收 = 省电科院点表）：
|
||
* - YC：IOA 0x4011~0x4018 + 0x401d（频率），短浮点、系数 1；数据源 =
|
||
* L2 遥测快照（App/algo/meas.h，「数据可信」卡 9/11）：电气 8 路绑快照槽，
|
||
* 有效性由快照品质驱动——V0.1 削顶路（docs/算法/继电保护功能复现规划.md
|
||
* §1.6）快照置 CLIPPED → 本层映射为线上 IV（V0.2 后自动启用，绑定零
|
||
* 改动，见 docs/任务规划/数据可信.md §10「双转换器无共同采样触发」行）；0x401d 绑频率源，
|
||
* freq_valid()==0 → IV；
|
||
* - YX：IOA 1~33（§1.5 表(3)）；双点 = 开关位置类（YX1~4，本期无硬件 → IV），
|
||
* 保护动作类 YX15~23 映射 prot_elm 状态，闭锁类 YX31~33 映射 prot_set；
|
||
* - YK：IOA 0x6000+（§1.5 表(3)）；V0.1 无出口硬件（规划 R7）——
|
||
* YK11 信号复归（→ prot_elm_request_reset）与 YK12 全局软压板
|
||
* （→ PS_GLOBAL_EN 两段式转真，B7）转真执行，其余一律否定确认（COT|PN），如实回；
|
||
* - 定值：IOA = prot_set 元数据 comm_addr（0x8820 基址 + 告警段 0x8027~0x802A；
|
||
* comm_addr=0 本地项不可寻址），
|
||
* 读经 C_RD、写经 C_SE_NC（选择/执行两段，执行段原子写+封存并置脏，
|
||
* 持久化 /prot_set.bin 由 defaultTask 执行，B7）；
|
||
* - 固有参数 8001H~800AH：本期**不实现**（字符串类无法用短浮点上送），
|
||
* 按未知 IOA（COT 14 + EVI）应答，登记为待办（设计文档）。
|
||
* 线程约定：init/bind 内核启动前或建服务前；cov_check/read 仅 104 服务任务上下文。
|
||
* 创建日期：2026-10-12（B4）
|
||
* 修改记录：
|
||
* 2026-10-25 DTU 项目组 卡 9/卡 11（「数据可信」，道D）：YC 数据源 = L2 遥测
|
||
* 快照（削顶路由品质驱动 IV）；死区改运行时副本 +
|
||
* set/get 入口；COV 遥测腿 = 死区 2 点确认（seq 去重）
|
||
* + 品质变化即报；0x401d 绑频率源（freq_valid → IV）。
|
||
* 2026-10-25 DTU 项目组 卡 10：死区真源迁 run_par（[run_par] cfg 段 +
|
||
* 0x8020~0x8058 读写映射；本层 set/get 为转发壳）。
|
||
*/
|
||
#ifndef IEC104_PTS_H
|
||
#define IEC104_PTS_H
|
||
|
||
#include <stdint.h>
|
||
|
||
/* ---------------- 数据源 vtable（NULL 项 = 该能力不可用 → 按无效/拒绝处理） -- */
|
||
typedef struct {
|
||
/* 遥测读：idx = YC 表下标；out = 工程量浮点。
|
||
* 返回 0 有效 / -1 无效（发 IV）/ -2 数据未就绪（发 NT，如相量未满一周波） */
|
||
int (*yc_read)(uint8_t idx, float *out);
|
||
/* 遥信位图：bit i = YX 表下标 i 的"合/动作"态（双点按 ON 计） */
|
||
uint64_t (*yx_bits)(void);
|
||
/* 遥信有效位图：bit i = 1 该点有效；0 → 发 IV（无硬件/未实现） */
|
||
uint64_t (*yx_valid)(void);
|
||
/* 遥控：select=1 选择段 / 0 执行段（dpc 已剥 S 位）。返回 0 接受 / -1 拒绝 */
|
||
int (*yk_exec)(uint32_t ioa, uint8_t dpc, uint8_t select);
|
||
/* 定值读：addr = 通讯地址；返回 0 存在 / -1 未知地址 */
|
||
int (*set_read)(uint32_t addr, float *out);
|
||
/* 定值写：select=1 预置校验（范围）/ 0 执行写入。返回 0 / -1 越界或未知 */
|
||
int (*set_write)(uint32_t addr, float v, uint8_t select);
|
||
/* 遥测读（带品质，卡 9 追加于表尾——旧源 NULL = 走 yc_read 退路，品质由
|
||
* 返回值推导：-1 → IV、-2 → NT、0 → 无位，行为与旧源完全一致）。
|
||
* qds = uint16 域位（App/algo/meas.h MEAS_QDS_*：低字节 = 线上 QDS 同值，
|
||
* 高字节 CLIPPED 由本层映射线上 IV）；返回 0 / -1 IV / -2 NT */
|
||
int (*yc_read_ex)(uint8_t idx, float *out, uint16_t *qds);
|
||
} iec104_pts_src_t;
|
||
|
||
/* ---------------- 变化检测结果（cov_check 输出） ---------------- */
|
||
typedef struct {
|
||
uint64_t yx_changed; /* bit i = YX 下标 i 变位（相对上次快照） */
|
||
uint16_t yc_changed; /* bit i = YC 下标 i 越过死区（相对上次快照） */
|
||
} iec104_pts_cov_t;
|
||
|
||
/*
|
||
* 函数功能：点表层初始化（清快照、绑板端默认源）
|
||
* 限定条件：内核启动前或 104 服务启动前，调一次
|
||
*/
|
||
void iec104_pts_init(void);
|
||
|
||
/*
|
||
* 函数功能：覆盖数据源（主机单测注假源）
|
||
* 入口参数：src - vtable（浅拷贝，调用方保生命周期）；NULL = 恢复板端默认源
|
||
*/
|
||
void iec104_pts_bind_src(const iec104_pts_src_t *src);
|
||
|
||
/* ---------------- YC ---------------- */
|
||
uint8_t iec104_pts_yc_count(void);
|
||
uint32_t iec104_pts_yc_ioa(uint8_t idx);
|
||
/* 读 YC：v 有效值（无效时为 0）；qds 输出线上品质位（IV/NT/OV，CLIPPED 已映射
|
||
* 为 IV）。返回 0/无效-1（NT 亦无效，品质位区分） */
|
||
int iec104_pts_yc_read(uint8_t idx, float *v, uint8_t *qds);
|
||
/* 死区写（卡 9 API；卡 10 起 = 转发 App/algo/run_par.c 真源 + 清本层确认计数）：
|
||
* db = 工程量绝对值 ≥0（电压 50 V / 电流 1 A / 频率 5 Hz 分档上限）；越界/负值/
|
||
* NaN → -1 且真源不动；成功时清零该点待确认计数（跨档位不残留半截确认——此壳
|
||
* 行为有单测钉住）。仅 104 服务任务上下文调用。落盘 = run_par 脏 → 事件 →
|
||
* defaultTask（卡 10 持久化链，docs/子系统设计/IEC104上行设计说明.md §3.4）。 */
|
||
int iec104_pts_yc_set_deadband(uint8_t idx, float db);
|
||
/* 读当前生效死区（越界 idx 返 0） */
|
||
float iec104_pts_yc_deadband(uint8_t idx);
|
||
|
||
/* ---------------- YX ---------------- */
|
||
uint8_t iec104_pts_yx_count(void);
|
||
uint32_t iec104_pts_yx_ioa(uint8_t idx);
|
||
uint8_t iec104_pts_yx_is_dp(uint8_t idx); /* 1 = 双点（M_DP） */
|
||
/* 读 YX：out = DIQ/SIQ 值（含 IV）。 */
|
||
void iec104_pts_yx_read(uint8_t idx, uint8_t *out);
|
||
|
||
/* ---------------- COV（每 poll 一次） ---------------- */
|
||
/*
|
||
* 函数功能：读全表并与上次比对（遥信变位 + 遥测死区 2 点确认 + 品质变化），
|
||
* 输出变化集
|
||
* 入口参数：cov - 输出（可为 NULL = 只刷快照不取变化）
|
||
* 函数说明：遥测判据（「数据可信」卡 9，对标参考系统 CalfYcMea 死区 2 点确认，
|
||
* 短板评测口径）：**连续 2 个新测量点** |v - 上次上送值| > 死区才置变化位
|
||
* （单点尖峰不确认——噪声回摆即撤销候选）；品质位（线上 qds）相对上次
|
||
* 上送值翻转 → 当拍直接置位（不等 2 点，有效性变化必须即时可见，
|
||
* 含 0x401d 的 IV 进出）。死区 = 运行时副本（ROM 默认 = 点表列，
|
||
* iec104_pts_yc_set_deadband() 覆盖——卡 10 运行参数段的接线点）。
|
||
* 测量点定义：板端默认源 = **快照换帧**（meas seq 前进；100 ms poll 对
|
||
* 200 ms 快照，同一帧重复比对会计数两次 → seq 去重是确认语义成立的
|
||
* 前提）；注入源（单测假源）= 每次调用一测点。首次读到有效值只建基线
|
||
* 不上报（突发由总召覆盖）。
|
||
*/
|
||
void iec104_pts_cov_check(iec104_pts_cov_t *cov);
|
||
|
||
/* ---------------- 遥控 ---------------- */
|
||
/* 遥控两段式（转发 src->yk_exec；无源 = 一律拒绝）。返回 0 接受 / -1 拒绝 */
|
||
int iec104_pts_yk_exec(uint32_t ioa, uint8_t dpc, uint8_t select);
|
||
|
||
/* ---------------- 定值 ---------------- */
|
||
/* 按通讯地址读定值（转发 src->set_read）。返回 0 / -1 未知地址 */
|
||
int iec104_pts_set_read(uint32_t addr, float *out);
|
||
/* 按通讯地址写定值（两段）。返回 0 / -1 */
|
||
int iec104_pts_set_write(uint32_t addr, float v, uint8_t select);
|
||
|
||
#endif /* IEC104_PTS_H */
|