wandering1
90db528032
W1-0 台账三件套：scripts/ram_baseline.py（四模式）+ ram_baseline.tsv 趋势 + docs/内存管理/RAM预算台账.md + pre-commit mem-budget 钩子（RW_IRAM1/RW_CCM >92% 即 FAIL + Top-10 附表）；审查报告 §5.5 三条闭环。 B4 IEC 60870-5-104 上行（被控站，TCP 2404）：App/protocol/iec104/ 三模块 （asdu 编解码 / pts 点表+数据源 vtable / link APCI+FSM，纯逻辑零 I/O）+ App/task/iec104_serv.c（iec104Task，NET_READY 屏障 100ms 分片喂位）。 82 断言 L0.5 全绿 + iec104-unit-test 钩子（第 31 钩子）； 设计说明 docs/子系统设计/IEC104上行设计说明.md 全量回填。 B5 protectTask（L3 板端接线）：App/task/protect_task.c——20ms 判据节拍 prot_elm_run + L5-4 采样故障闭锁（adc_health 电平位→元件复位）+ L5-1 定值 校验和巡检；新增 prot_elm_request_reset() 收口跨上下文复归（104 YK11 落请求、 eval 头部消费）；定值/元件初始化移入 app_main_init（内核前）。TC-PE-010 （prot_elm 28 用例）。 门禁与内存：TASK_WD_PROTECT=8 入 required_mask（产品 0x77→0x1F7、HW 层 0x1F5，看门狗单测 39 断言同步）；FreeRTOS 堆 48→56KB（.ioc L1 参数 + FreeRTOSConfig.h 同步，RAM预算台账 §6 登记配额 48→56KB）。 ZI 144,008→152,204（+8,196 B = 堆 +8KB，B5 扩容）；Code=204,348。 stack_report：protectTask 512 words 静态链 872 B/余 57%、iec104Task 640 words 1456 B/余 43% 均 PASS；RW_IRAM1 73.1% / RW_CCM 87.9%（<92%）。 验证：@build 0 错 0 警；ci_local 全绿（31 钩子 + 13 主机侧单测）； doc-links 135 文档 PASS。登记簿 B4/B5 销项、W1 波次完成；保护规划/看门狗 说明/AGENTS（9 任务）/RAM 三文档全部同步。 遗留（验收窗口，非代码空洞）：台架第三方 104 主站往返（送检窗口）、 标准源注入动作判据、@test PROT 锚点 + protect 栈水位 + 新堆 min_ever 复测。
95 lines
5.1 KiB
C
95 lines
5.1 KiB
C
/*
|
||
* 模块名称：IEC 60870-5-104 点表与数据源适配（纯逻辑 + 源注入）
|
||
* 模块功能：104 点表（遥测 YC / 遥信 YX / 遥控 YK / 定值）的定义、读取与变化检测
|
||
* （COV：遥信变位 + 遥测死区）。**数据源经 vtable 注入**：板端绑
|
||
* phasor/prot_elm/prot_set 真实源；主机单测绑假源 → 协议栈全链
|
||
* （asdu+pts+link）可离线跑（登记簿 A-4 约束 1）。
|
||
* 点表口径（docs/算法/继电保护功能复现规划.md §1.5，验收 = 省电科院点表）：
|
||
* - YC：IOA 0x4011~0x4018 + 0x401d（频率），短浮点、系数 1；
|
||
* ⚠ V0.1 有效通道仅 UA/UN/IA（TPAFE 三路，§1.6）——其余点**存在但置 IV**
|
||
* （无效位），频率随 L1-7 落地前同样置 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_init）外一律否定确认（COT|PN），如实回；
|
||
* - 定值：IOA = prot_set 元数据 comm_addr（0x8820 基址 + 告警段 0x8027~0x802A），
|
||
* 读经 C_RD、写经 C_SE_NC（选择/执行两段，执行完成统一 seal 校验和）；
|
||
* - 固有参数 8001H~800AH：本期**不实现**（字符串类无法用短浮点上送），
|
||
* 按未知 IOA（COT 14 + EVI）应答，登记为待办（设计文档）。
|
||
* 线程约定：init/bind 内核启动前或建服务前；cov_check/read 仅 104 服务任务上下文。
|
||
* 创建日期：2026-10-12（B4）
|
||
*/
|
||
#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);
|
||
} 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 等）。返回 0/无效-1 */
|
||
int iec104_pts_yc_read(uint8_t idx, float *v, uint8_t *qds);
|
||
|
||
/* ---------------- 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 一次） ---------------- */
|
||
/*
|
||
* 函数功能：读全表快照并与上次比对（变位 + 死区），输出变化集
|
||
* 入口参数：cov - 输出（可为 NULL = 只刷快照不取变化）
|
||
* 函数说明：首次调用只建快照、变化集全 0（突发由初始化/总召覆盖）。
|
||
* 死区 = 点表内置绝对值（§1.5 运行参数 8020H 段本期取内置默认）。
|
||
*/
|
||
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 */
|