wandering1
8c72698666
新增 App/algo/run_par.c/h（「数据可信」卡 10，lead 四裁落地）： - [run_par] cfg 段：遥测死区 9 键 int32 毫单位（db_ua…db_freq），工厂默认 = 卡 6 额定 0.5% 档（500mV×4 / 5mA×4 / 500mHz）；注册走 adc_cal 同款内核前 契约（app_main_init），不挂回调 = 引擎副本即生效值；键数 9≤16 不拆段 - 真源收编（裁③）：pts 层 s_yc_db 运行时副本删除，COV 每拍实时读 run_par （协议→算法向下依赖，同 meas 先例；无投递无缓存 = 顺序/幂等平凡成立）； iec104_pts_yc_set_deadband()/deadband() 保留为转发壳，壳内保留"成功清 半截确认计数"语义并由 TC-IEC104-027 追加断言钉住（裁⑤） - 104 地址映射（裁①）：0x8030~0x8038 死区 9 点 / 0x8040~0x8047 k 覆盖 / 0x8048~0x804F b 覆盖（逐项地址本仓自定——复现规划 §5.4 权威表不在仓， 送检点表到位后替换 run_par.c 顶部常量段一处；已在 IEC104 §3.4 表头挂账）； 路由顺序 = run_par 表先、未命中落 prot_set——0x8027~0x802A 属 prot_set 告警段永不覆盖，TC-IEC104-029 双向往返钉死；空隙地址自然 COT14/PN - 通道系数覆盖 = adc_cal_set 代理（裁②a）：合法带/越带 [ERR] 留痕全复用， run_par 不存第二份系数（防双真源）；单侧写 RMW 用另一侧当前生效值； 回显 = 生效值视图（文件坏值被哨兵回退 ROM 时主站看到的就是下游吃到的）； adc_cal 配套：+adc_cal_b_codes() 读取口（回显/RMW 用）+ set() 授权写者 注记扩至 iec104Task 直通路径（单字原子契约同「数据可信」§4.4） - 持久化（裁②b）：新事件位 SYS_EVT_RUN_PAR_SAVE(1<<8)；iec104Task 主循环 peek 投递 → defaultTask run_par_store_save() 一条事件一趟 cfg_file_save 整档外科（覆盖 [run_par] 9 键 + 联动 [adc_cal] 两段）；失败脏保留 = 天然 重试（B7 prot_set 同款）。C_SE 现行无"暂停/测试态"门控——文档现行如此 不造新语义，送检若要求接线点已写进 §3.4 注（裁④） 测试：新建 test/host/run_par（TC-RUNPAR-001~008，67 断言，真实 cfg 引擎 + 真实 adc_cal + 内存虚拟盘同 adc_cal 套件先例；[run_par] 注册契约/落盘往返/ 外改文件即副本生效/两段式不提交不置脏/合法带拒+RMW+生效值回显/init 幂等 重注册留痕）；iec104 套扩真链 TU（cfg_file+adc_cal+run_par 非桩，141 断言： +TC-IEC104-029 路由 + 壳清确认计数 3 断言）；meas 套静态更名 s_snap*→ s_ms_snap*（与 cfg_file.c s_snap 同 TU 相撞，D1 同款改名法，226 断言不变）； iec104_serv 套补 run_par_dirty_peek 假件。id_registry 建族 TC-HOST-RUNPAR （游标 008）+ TC-HOST-IEC104 游标 028→029；新钩子 run-par-unit-test + iec104 钩子触发面随真链扩；uvprojx +run_par.c（合法入库）+ SIM_EXEMPT 登记 （模拟器不编 104 协议，已核实 CMake 面）。 文档：IEC104 §3.4 运行参数段表（含送检替换账/门控未来条件/代理声明）、§7、 §8 第 4 条、变更记录；网络配置说明新增 §3.5 [run_par] 键表；复现规划 §5.4 补运行参数段落实进度。**遗留（交 lead）**：数据可信 §4.4 "引擎 RAM 副本" 一节当时的措辞对象含 pts 侧副本，s_yc_db 删除后该句过时（裁③b 点名，§4.4 在写域外未动）。 gate：@build 0/0（Code=219620 RO=22036 RW=1280 ZI=132864）；vs 0cbae7d： Flash +1912B、RAM(RW+ZI) +8B（37B 新静态被链接器并洞吸收）；iec104Task 栈 1456B/margin 43%、defaultTask 3032B 不变；id-check/doc-links/cppcheck/ coding-standard 实跑过；--all-files 全量 45 钩子实跑（43 绿 + 仅 mem-budget / mem-numbers 两红 = 台账受管区 vs .map 漂移，回填属 lead 单写者区，批 1/道D-1 /D2 同口径）：gate: only mem-budget/mem-numbers pending lead ledger backfill BOM/CR/U+FFFD/字面量 ASCII 逐文件自查通过。
131 lines
7.4 KiB
C
131 lines
7.4 KiB
C
/*
|
||
* 模块名称：运行参数段（L2/L3 整定层，「数据可信」卡 10）
|
||
* 模块功能：遥测死区（9 点）与通道标定系数覆盖（k/b 各 8 路）的**单一真源**：
|
||
* - 死区 = 本模块 int32 毫单位 RAM 副本（注册进 cfg 引擎 [run_par] 段，
|
||
* 工厂默认 = 「数据可信」卡 6 额定 0.5 % 档），104 消费侧
|
||
* （App/protocol/iec104/iec104_pts.c）每拍实时读取——无投递、无缓存
|
||
* 副本（卡 9 曾在 pts 侧留运行时副本 s_yc_db，卡 10 落地后收编于此，
|
||
* 双源必打架）；
|
||
* - 系数覆盖 = **直通 adc_cal_set()**（[adc_cal]/[adc_cal_ofs] 是系数
|
||
* 唯一真源，卡 4 已定；本模块只加 104 地址映射 + 落盘请求，不另存
|
||
* 一份系数——同 D1 裁"两处判断必打架"逻辑）。
|
||
* 104 地址映射（docs/算法/继电保护功能复现规划.md §5.1 运行参数类
|
||
* 0x8020H~0x8058H；逐项表原文"待补"（参考项目 CommPara_ConfigTable
|
||
* 不在仓），本表即卡 10 的落实，送检点表若另给权威地址只改常量段：
|
||
* 0x8030~0x8038 = 死区 UA/UB/UC/UN/IA/IB/IC/IN/FREQ（工程量 V/A/Hz）；
|
||
* 0x8040~0x8047 = k 覆盖（µV/码）；0x8048~0x804F = b 覆盖（码值，可负）；
|
||
* 其余留白（未启用类别），**0x8027~0x802A 属 prot_set 告警段**，本表
|
||
* 永不让位（两表按精确地址分流，见 iec104_pts.c set 路由）。
|
||
* 持久化（B7 prot_set 先例同款）：任一写成功 → 脏标志只置不清；
|
||
* iec104Task 主循环 peek → 置 SYS_EVT_RUN_PAR_SAVE → defaultTask
|
||
* （配置引擎属主）run_par_store_save() 调 cfg_file_save() 整档外科
|
||
* 保存（含 [run_par] 与刚被 adc_cal_set 改写的 [adc_cal]/[adc_cal_ofs]
|
||
* 副本）→ 成功清脏；失败留脏 = 下轮天然重试。本模块自身零文件 IO
|
||
* （属主纪律）。
|
||
* 并发契约：引擎副本 int32 对齐字读写在 Cortex-M4 上原子；poll 重载 µs 级窗口
|
||
* 为「数据可信」§4.4 明载设计（adc_cal 同款）。写路径 = 104 执行段
|
||
* （iec104Task）与引擎读路径互不加锁，勿改成"读侧缓存"（缓存 = 新真源）。
|
||
* 纯算法：只用 stdint/stddef/math + cfg_file.h/adc_cal.h 头（注册/直通均为
|
||
* 接口级）→ 主机侧可单测（test/host/run_par，链真 cfg 引擎 + 真 adc_cal）。
|
||
* 适用平台：STM32F407ZGTx（Cortex-M4F，硬件 FPU）
|
||
* 作者：DTU 项目组
|
||
* 创建日期：2026-10-25（道D 卡 10）
|
||
* 修改记录：
|
||
* v1.0 2026-10-25 DTU 项目组 创建：[run_par] 段 + 104 地址映射 + 直通
|
||
* adc_cal + B7 式脏标志落盘请求
|
||
*/
|
||
|
||
#ifndef RUN_PAR_H
|
||
#define RUN_PAR_H
|
||
|
||
#include <stdint.h>
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
/* 死区/覆盖点数（死区 = YC 表行数：电气 8 + 频率；覆盖 = 语义电气 8 路） */
|
||
#define RUN_PAR_DB_N 9u
|
||
#define RUN_PAR_CH_N 8u
|
||
|
||
/*
|
||
* 函数功能：运行参数初始化——副本置工厂默认 + 注册 [run_par] 段进 cfg 引擎
|
||
* 入口参数：无
|
||
* 返 回 值：无
|
||
* 限定条件：**内核启动前**调用（app_main_init，adc_cal_init 之后）；注册必须先
|
||
* 于 defaultTask 的 cfg_file_load（N-19 契约，同 adc_cal 先例）；幂等
|
||
* 函数说明：注册失败（段名重复/段数超限）打 [ERR] 后继续——工厂默认照常生效，
|
||
* 仅文件整定失效（adc_cal_init 同款降级）。
|
||
*/
|
||
void run_par_init(void);
|
||
|
||
/*
|
||
* 函数功能：读第 idx 路遥测死区（工程量）
|
||
* 入口参数：idx - 0..7 = 语义通道序（UA..IN），8 = 频率 uint8_t
|
||
* 返 回 值：死区 V / A / Hz；idx 越界返 0.0（调用方按"无死区"保守处理） float
|
||
* 限定条件：任意上下文（int32 单字读原子；104 COV 每拍调用）
|
||
* 函数说明：毫单位 → 浮点的换算点（除以 1000 唯一在此，勿在消费侧另写）。
|
||
*/
|
||
float run_par_deadband(uint8_t idx);
|
||
|
||
/*
|
||
* 函数功能：写第 idx 路死区（工程量，含范围守卫 + 脏置位）
|
||
* 入口参数：idx - 同上 uint8_t；db - 死区工程量（V/A/Hz，≥0） float
|
||
* 返 回 值：0 成功；-1 越界/越程/NaN（副本不动） int
|
||
* 限定条件：**iec104Task 上下文**（104 执行段 / 卡 11 后的整定路径；UI 若整定
|
||
* 需另行走配置引擎属主路径，勿跨任务直写）
|
||
* 函数说明：合法域按点型分档——电压 0~50 V、电流 0~1 A、频率 0~5 Hz（上限 =
|
||
* 额定 × 二档裕量，守卫目的是挡误写不是限工况；见 .c 常量段）。
|
||
* 成功即置脏（落盘请求，见文件头持久化契约）。
|
||
*/
|
||
int run_par_deadband_set(uint8_t idx, float db);
|
||
|
||
/*
|
||
* 函数功能：104 运行参数地址读（C_RD 路由，先于 prot_set 扫描）
|
||
* 入口参数：addr - 通讯地址（0x8020~0x8058 段内） uint32_t；out - 工程量浮点
|
||
* （死区 V/A/Hz；k 覆盖 µV/码；b 覆盖 码值） float *
|
||
* 返 回 值：0 命中并写出；-1 地址不归本段（调用方继续走 prot_set） int
|
||
* 限定条件：iec104Task 上下文
|
||
* 函数说明：命中集 = 0x8030~0x8038 / 0x8040~0x8047 / 0x8048~0x804F 精确匹配；
|
||
* k/b 读回 = adc_cal **当前生效值**（与折算同视图：文件坏值被合法带
|
||
* 哨兵回退 ROM 时，回显的就是 ROM——主站看到的即下游实际吃到的）。
|
||
*/
|
||
int run_par_104_read(uint32_t addr, float *out);
|
||
|
||
/*
|
||
* 函数功能：104 运行参数地址写（C_SE 两段式路由，先于 prot_set 扫描）
|
||
* 入口参数：addr - 通讯地址 uint32_t；v - 工程量浮点 float；
|
||
* select - 1 = 选择段（只校验不落副本）/ 0 = 执行段 uint8_t
|
||
* 返 回 值：0 接受；-1 拒绝（越程/NaN/合法带外/非本段可写地址命中守卫）；
|
||
* -2 地址不归本段（调用方继续走 prot_set） int
|
||
* 限定条件：iec104Task 上下文；执行段成功即置脏
|
||
* 函数说明：k/b 覆盖经 adc_cal_set() 合法带哨兵（µV/码 ×[0.5,2.0]、|b|≤8192，
|
||
* 越带 -1 → 104 侧 PN 否定确认，adc_cal 不留痕由**其自身**越带 [ERR]
|
||
* 机制负责——本模块直通不重复留痕）；两段式与 prot_set 定值写同构。
|
||
*/
|
||
int run_par_104_write(uint32_t addr, float v, uint8_t select);
|
||
|
||
/*
|
||
* 函数功能：落盘脏标志探查（非消费）
|
||
* 入口参数：无
|
||
* 返 回 值：1 = 有已整定未落盘的改动；0 = 干净 uint8_t
|
||
* 限定条件：任意上下文（单字节）；iec104_serv 主循环 peek 后投递事件（B7 同款）
|
||
*/
|
||
uint8_t run_par_dirty_peek(void);
|
||
|
||
/*
|
||
* 函数功能：执行落盘请求（cfg_file_save 整档外科保存 + 成功清脏）
|
||
* 入口参数：无
|
||
* 返 回 值：0 成功（或无脏可存）；-1 写盘失败（脏保持，下轮重试） int
|
||
* 限定条件：**defaultTask（配置引擎属主）上下文**，由 SYS_EVT_RUN_PAR_SAVE 驱动
|
||
* 函数说明：save 走引擎唯一写闸（超长拒写/原子改名，E-01 契约）；本函数不清
|
||
* 引擎以外模块的脏语义（[adc_cal] 副本值已由写路径就位）。
|
||
*/
|
||
int run_par_store_save(void);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* RUN_PAR_H */
|