perf(iec104): 参数区按 17 项真实消费者收窄并接上真实定值模型
104 协议侧参数通道此前镜像了厂商点表的全部 430 条参数(697 槽), 但其中 413 条在本设备上没有任何消费者——104 与设备侧真实定值模型 prot_set 之间零调用,主站改定值只落在无人读的 RAM 镜像里,保护功能 毫无感知。本次按"严格按消费者收窄"口径收口: 可见性以 iec104_dtu_protection_mapping() 语义桥表为唯一判据,只放行 三段过流投退/定值/延时(9 项)、低压与过压定值/延时(4 项)、PT 与 CT 一次/二次额定(4 项)。其余参数在位表枚举层即不可见,主站读取 得到 COT=47 + P/N=1 的显式否定确认,不静默丢弃。values[697]→values[53]、 staged[264]→staged[17],并删除生成式 iec104_source_ranks.h。 桥表接真实源:iec104_serv 的 parameter_read/apply 从 NULL 改为直读 prot_set 与整批原子提交,Q10 量化后一次事务落地,持久化仍由 defaultTask 的脏标志闭环负责。 prot_set 因此出现两个运行时写者(netTask 的 104 与 uiTask 的本地整 定),原"写者靠启动时序串行"的约定失效。加入写事务互斥与 seqlock 序号:四个写入口全部进锁,校验与提前返回一律在 enter 之前;序号卡 奇数连续 8 拍即判保护闭锁,避免自检被永久跳过而静默失去防篡改能力。 锁的安装在 defaultTask 的存储 bring-up 阶段,不在 app_main_init—— 后者早于 osKernelInitialize,内核启动前禁止任何 RTOS 创建类 API。 实测:RW_IRAM1 117,304→113,720 B(−3,584 B,89.50%→86.76%); ER_IROM1 413,392→411,668 B(−1,724 B);iec104_source.o 5,656→2,056 B; prot_set.o 344→352 B(+8 B,写事务序号与锁句柄)。Keil 构建 0 错误 0 警告;主机侧 prot_set 175/175、iec104_dtu 7/7;真实 TCP 验收 13/13;暂存口径门禁 18 项全通过。 已知边界:模拟器不链接 iec104_serv.c,TCP 验收不覆盖 prot_set 绑定, 板端需实机确认主站写入能反映到本地定值页;17 项中 15 项的出厂默认 值与点表字面量不同,主站读到的是真实模型的值;绑定真实源后定值区 切换一律拒绝(单套活跃值无原子整区事务)。
This commit is contained in:
+91
-8
@@ -13,17 +13,28 @@
|
||||
* - ⚠ 默认值/范围为**拟定值**:参考 EEPROM 出厂默认表未在本仓库,
|
||||
* 待对照后逐项修订(规划 §10.3 待补项);范围先按 DTU 馈线典型量级。
|
||||
*
|
||||
* 线程约定(B7 定):装载(init/store_parse)在 defaultTask(存储 bring-up,
|
||||
* STORAGE_READY 前);单项写在 iec104Task(C_SE/YK12,经 set_sealed 原子路径);
|
||||
* 落盘在 defaultTask(配置引擎属主)。读在保护消费者任务(快照值原子)。
|
||||
* 双缓冲交换 = 单字写,读侧永远看到一致快照;写者之间靠启动时序串行
|
||||
* (装载先于 NET_READY,104 写在其后)。
|
||||
* 线程约定(多写者 + 写事务锁):
|
||||
* 装载(init/store_parse)在 defaultTask(存储 bring-up);落盘在 defaultTask
|
||||
* (配置引擎属主);读在保护消费者任务(快照值原子,读接口一律不加锁)。
|
||||
* 运行时写者有两个——netTask(104 定值下发,走 apply_batch / set_sealed)与
|
||||
* uiTask(本地整定,经 ui_data 注入的 set_sealed)。
|
||||
* 双缓冲 + 单字交换只保证"读侧看到完整快照",**不保证写者之间不交错**:一方
|
||||
* 已写封存对、尚未交换活跃区时被另一方抢占,后者再交换一次,最终值区与封存
|
||||
* 对失配 → selfcheck 判"定值被非法改写" → 整台保护闭锁。所以写入口统一走
|
||||
* 写事务:可选 enter/exit 钩子(prot_set_lock_install 安装,板端接 RTOS 互斥
|
||||
* 量;模拟器与主机单测不装 = 单写者假设)包住"影子区改值 + 封存 + 交换",
|
||||
* 同时把提交序号置奇/回偶,selfcheck 借它识别"提交进行中"而不误判失配。
|
||||
* 跳过本轮是**有界**的:连撞 8 拍仍是奇数 → 判写者已死 → 闭锁(fail-safe,
|
||||
* 否则一条"锁内提前返回"的 bug 就会让防篡改自检永久静默失效)。
|
||||
* 本模块只持有两个函数指针,不 include 任何 RTOS/HAL 头——纯逻辑三方编译
|
||||
* (固件 / 模拟器 / 主机单测)不受影响。
|
||||
*
|
||||
* 创建日期:2026-10-11
|
||||
*/
|
||||
#ifndef PROT_SET_H
|
||||
#define PROT_SET_H
|
||||
|
||||
#include <stddef.h> /* size_t(批量接口) */
|
||||
#include <stdint.h>
|
||||
|
||||
/* Q10 定点:工程量 × 1024(与参考 2^10 口径一致)。
|
||||
@@ -115,8 +126,18 @@ void prot_set_init(void);
|
||||
*/
|
||||
int prot_set_load_raw(const int32_t *vals);
|
||||
|
||||
/* 越界位图(bit i = 第 i 项越界;load_raw 失败后有效。B8:项数 32→40,
|
||||
* 位图随项数扩为 64 位——消费方仅主机单测,板端闭锁走 prot_set_locked()) */
|
||||
/* 越界位图(bit i = 第 i 项越界)。
|
||||
*
|
||||
* ⚠ 契约(调用方必读):本函数返回的位图**只反映整表装载/解析**
|
||||
* (prot_set_load_raw / prot_set_store_parse)的越界结果,
|
||||
* 最后一次整表操作失败后有效,直到下一次整表操作或 prot_set_init 覆写。
|
||||
* **不随单项写入(prot_set_set / prot_set_set_sealed)或批量写入
|
||||
* (prot_set_apply_batch)变化**:增量写入的失败一律以函数返回 -1 表达,
|
||||
* 既不置位也不清位。
|
||||
* 推论:一笔成功的批量提交**不会**清掉历史上整表装载留下的越界位;
|
||||
* 反过来,一笔失败的批量提交也**不会**在位图上留下痕迹。拿位图反显
|
||||
* "刚才那批哪几项越界"是误用——请用 apply_batch 的返回值。
|
||||
* B8:项数 32→40,位图随项数扩为 64 位;板端闭锁走 prot_set_locked()。 */
|
||||
uint64_t prot_set_bad_mask(void);
|
||||
|
||||
/*
|
||||
@@ -133,7 +154,11 @@ uint8_t prot_set_get_ctl(prot_set_id_t id); /* 投退项:!=0 视为投入
|
||||
/* 校验和(定值校验和):sum32 覆盖 RAM 值区;seal 封存正/反码对 */
|
||||
uint32_t prot_set_checksum(void);
|
||||
void prot_set_seal(void);
|
||||
/* 自检:重算并与封存值比对,失配 → 置闭锁并返回 -1(已闭锁也返回 -1) */
|
||||
/* 自检:重算并与封存值比对,失配 → 置闭锁并返回 -1(已闭锁也返回 -1)。
|
||||
* 提交进行中(写者正在改值区/发封存对)撞见的中间态**只跳过本轮、不判失配**;
|
||||
* 但跳过是有界的:连续撞见"提交进行中"达 8 拍(约 160 ms)即视为写者已死,
|
||||
* 置闭锁并返回 -1(fail-safe:宁可保护停走,不可带不可信定值判据)。
|
||||
* 解锁的唯一合法路径是 prot_set_seal()(或 prot_set_init() 重装)。 */
|
||||
int prot_set_selfcheck(void);
|
||||
uint8_t prot_set_locked(void);
|
||||
|
||||
@@ -148,6 +173,64 @@ uint8_t prot_set_locked(void);
|
||||
*/
|
||||
int prot_set_set_sealed(prot_set_id_t id, int32_t q10);
|
||||
|
||||
/* ---------------- 批量读写(104 定值下发:PRE 预检 + SOL 原子提交) ----------------
|
||||
* 协议一次改 1..17 项,两段式:第一段只校验(不落任何状态),第二段整批提交。
|
||||
* 与单项 set_sealed 同一原子口径:任一项非法则整批一项都不改。
|
||||
*/
|
||||
|
||||
/* 一批定值变更(Q10 工程量)。同一批内 id 不得重复。 */
|
||||
typedef struct {
|
||||
prot_set_id_t id;
|
||||
int32_t q10;
|
||||
} prot_set_change_t;
|
||||
|
||||
/* 单批上限 = 整表 40 项(算法侧上限)。超过上限返回 -1,不做任何改动。
|
||||
* ⚠ 与协议上限的关系:40 是**本模型能接受的最大批量**(整表就 40 项);
|
||||
* IEC 60870-5-104 参数区另有 **17 项**的消费者上限,那是协议/调用方的
|
||||
* 约束,由调用方自己拦——本层不代拦。所以 18 项的一批在这里是合法的,
|
||||
* 接线方若想守 17 项,必须在上层先判,别指望这里替它拒。 */
|
||||
#define PROT_SET_BATCH_MAX ((size_t)PS_ID_COUNT)
|
||||
|
||||
/*
|
||||
* 函数功能:读一批定值当前值(Q10 工程量)
|
||||
* 入口参数:ids - 编号数组;n - 个数;out - 输出数组(out[i] 对应 ids[i])
|
||||
* 返 回 值:0 成功 / -1 参数非法(空指针、n 为 0、n 超过上限、任一号越界)
|
||||
* 限定条件:任意上下文安全——双缓冲保证读侧只看到完整快照,不需要持锁
|
||||
*/
|
||||
int prot_set_read_batch(const prot_set_id_t *ids, size_t n, int32_t *out);
|
||||
|
||||
/*
|
||||
* 函数功能:原子写入一批定值
|
||||
* 入口参数:changes - 变更数组;n - 个数;validate_only - 非 0 只校验
|
||||
* 返 回 值:0 整批合法(validate_only 时仅为"预检通过")/ -1 有非法项
|
||||
* 限定条件:两段式第一段(validate_only 非 0)**零副作用**——不置脏、不动值区、
|
||||
* 不动闭锁位、不进写事务锁;第二段(validate_only 为 0)先整批校验,
|
||||
* 任一项非法即一字未改地返回,全部合法才提交并置脏。
|
||||
* 函数说明:失败条件 = changes 为空、n 为 0、n 超上限、任一号越界、任一值越出
|
||||
* 该项 min/max、同批 id 重复。提交在写事务锁内完成(见下方钩子)。
|
||||
* 返 回 值补充(与 prot_set_bad_mask 的关系):**任何失败都不会反映到位图上**
|
||||
* ——成功也不清、失败也不置。要定位是哪一项不合法,请在调用前自己
|
||||
* 对照 g_prot_set_meta[id] 的 min/max 逐项查,或改用两段式第一段
|
||||
* 预检后自行分组重试;位图上看到的内容属于更早的整表装载。
|
||||
*/
|
||||
int prot_set_apply_batch(const prot_set_change_t *changes, size_t n, int validate_only);
|
||||
|
||||
/* 写事务锁钩子(可选)。未安装 = 调用方保证单写者(模拟器 / 主机单测即如此)。
|
||||
* enter/exit 必须成对;enter 允许阻塞,不得用关中断实现。 */
|
||||
typedef struct {
|
||||
void (*enter)(void);
|
||||
void (*exit)(void);
|
||||
} prot_set_lock_t;
|
||||
|
||||
/*
|
||||
* 函数功能:安装/卸载写事务锁
|
||||
* 入口参数:lock - 钩子(传 NULL = 卸载,退回单写者假设)
|
||||
* 返 回 值:无
|
||||
* 限定条件:应在任何写者启动前安装;本函数本身不加锁、不可重入。
|
||||
* 钩子只在"值区提交"这段临界区里被调用,读接口永不进入。
|
||||
*/
|
||||
void prot_set_lock_install(const prot_set_lock_t *lock);
|
||||
|
||||
/* 脏标志(存在未落盘的定值改动):set_sealed 置位;load/init 不置 */
|
||||
uint8_t prot_set_dirty_peek(void); /* 非消费(生产者用它通知属主任务) */
|
||||
uint8_t prot_set_dirty_take(void); /* 消费(属主任务落盘前取) */
|
||||
|
||||
Reference in New Issue
Block a user