Files
STM32F4-Base/App/cfg/prot_set_store.c
T
wandering1 7d1db02164 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 项的出厂默认
值与点表字面量不同,主站读到的是真实模型的值;绑定真实源后定值区
切换一律拒绝(单套活跃值无原子整区事务)。
2026-11-19 15:48:21 +08:00

160 lines
5.9 KiB
C
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/*
* 模块名称:prot_set_store(B7 定值持久化)——实现
* 模块功能:见 prot_set_store.h。blob 格式/校验/原子装载全在 prot_set.c
* (纯逻辑,主机单测覆盖),本文件只做"读文件→parse、
* serialize→原子写"的平台胶水。
* 文件口径:"/prot_set.bin"(卷根,8.3 合规,FF_USE_LFN=0 约束);
* 原子写临时名由 cfg_store_write_atomic 按目标目录推导
* (固定 config.TMP),与 /config.ini 的保存同在 defaultTask
* 串行执行,无并发竞争。
* 本文件同时是 prot_set 写事务互斥钩子的平台胶水:内核启动后由
* defaultTask 安装 osMutex,netTask 的 104 整定写与本地整定共用
* 同一把锁,保证“取影子—改—封存—切区”全程互斥。
* 创建日期:2026-10-12(B7)
*/
#include "prot_set_store.h"
#include <stddef.h>
#include "cmsis_os2.h"
#define DBG_TAG "[CFG]"
#include "dbg_log.h"
#include "cfg_file_store.h"
#include "prot_set.h"
#define PROT_SET_STORE_PATH "/prot_set.bin"
/* blob 收发缓冲(静态:defaultTask 栈深已是全项目最深链,勿再压局部 blob;
* B8 定值表 32→40 项 → blob 144→176 B,随 PROT_SET_BLOB_SZ 自动适配) */
static uint8_t s_blob[PROT_SET_BLOB_SZ];
/* prot_set 写事务钩子:未安装时 enter/exit 都是空操作,保持单任务构建可用。 */
static osMutexId_t s_prot_set_mutex;
/*
* 函数功能:进入 prot_set 写事务(拿互斥)
* 入口参数:无
* 返 回 值:无
* 函数说明:未安装互斥时为空操作,退化为单写者行为;
* 不得在中断上下文调用(osWaitForever 会阻塞)。
*/
static void s_prot_set_lock_enter(void)
{
if (s_prot_set_mutex != NULL) {
(void)osMutexAcquire(s_prot_set_mutex, osWaitForever);
}
}
/*
* 函数功能:退出 prot_set 写事务(放互斥)
* 入口参数:无
* 返 回 值:无
* 函数说明:与 s_prot_set_lock_enter 成对出现,未安装互斥时为空操作。
*/
static void s_prot_set_lock_exit(void)
{
if (s_prot_set_mutex != NULL) {
(void)osMutexRelease(s_prot_set_mutex);
}
}
/*
* 函数功能:安装 prot_set 写事务互斥(幂等)
* 入口参数:无
* 返 回 值:0 已安装或重复调用 / -1 创建失败(无锁降级)
* 函数说明:仅在内核启动后的 defaultTask 上下文调用;创建失败时不安装钩子,
* 写事务退化为无锁(单写者时代的行为),不把启动拖死。
*/
int prot_set_store_lock_init(void)
{
static const prot_set_lock_t lock = { s_prot_set_lock_enter, s_prot_set_lock_exit };
osMutexId_t mutex;
if (s_prot_set_mutex != NULL) { return 0; }
mutex = osMutexNew(NULL);
if (mutex == NULL) {
DBG_ERROR("prot set lock create failed, no-lock fallback");
return -1;
}
s_prot_set_mutex = mutex;
prot_set_lock_install(&lock);
return 0;
}
/*
* 函数功能:从小端缓冲读 16 位值(仅头部判别用,与 prot_set.c 内部同字节序)
* 入口参数:p - 读位置
* 返 回 值:值 uint16_t
*/
static uint16_t s_ld16(const uint8_t *p) {
return (uint16_t)((uint32_t)p[0] | ((uint32_t)p[1] << 8));
}
/*
* 函数功能:从小端缓冲读 32 位值
* 入口参数:p - 读位置
* 返 回 值:值 uint32_t
*/
static uint32_t s_ld32(const uint8_t *p) {
return (uint32_t)p[0] | ((uint32_t)p[1] << 8) | ((uint32_t)p[2] << 16)
| ((uint32_t)p[3] << 24);
}
/*
* 函数功能:开机装载定值 blob
* 入口参数:无
* 返 回 值:0 已装载 / 1 文件缺失或读失败(保持默认)/
* 2 版本或项数换代(旧档被拒,保持默认;本函数已落 INFO 日志)/
* -1 损坏被拒
* 函数说明:读失败与"文件不存在"同归 1——启动期卷锁无竞争(本任务独占
* bring-up),try-lock 失败即真 I/O 故障,此时保持出厂默认并让
* 调用方按"无档"处理是安全侧(定值仍封存自洽,定值校验和不误锁)。
* **换代与损坏分开**(B8):magic 完好但 ver/cnt 与当前固件不符 =
* 定值表升级(如 B8 32→40 项),是**预期升级路径**不是损坏 →
* 归 2 并打 INFO("version change"措辞),调用方不得按 CORRUPT
* 报 ERROR/自检留痕;magic 或校验对被破坏才是 -1。
*/
int prot_set_store_load(void) {
size_t nread = 0u;
if (cfg_store_read(PROT_SET_STORE_PATH, s_blob, sizeof(s_blob), &nread) != 0) {
return 1;
}
if (prot_set_store_parse(s_blob, (uint32_t)nread) == 0) {
return 0;
}
/* 拒绝原因分流:头部 magic 完好 + 版本/项数与当前固件不符 = 换代 */
if ((nread >= (size_t)PROT_SET_BLOB_HDR_SZ)
&& (s_ld32(s_blob) == (uint32_t)PROT_SET_BLOB_MAGIC)
&& ((s_ld16(s_blob + 4u) != (uint16_t)PROT_SET_BLOB_VER)
|| (s_ld16(s_blob + 6u) != (uint16_t)PS_ID_COUNT))) {
DBG_INFO("prot set blob version change (ver=%u cnt=%u), defaults in use",
(unsigned)s_ld16(s_blob + 4u), (unsigned)s_ld16(s_blob + 6u));
return 2;
}
return -1;
}
/*
* 函数功能:落盘当前定值(消费脏标志;失败回置等重试)
* 入口参数:无
* 返 回 值:0 无待写或成功 / -1 写失败
*/
int prot_set_store_save(void) {
uint32_t len = 0u;
if (prot_set_dirty_take() == 0u) {
return 0;
}
if (prot_set_store_serialize(s_blob, (uint32_t)sizeof(s_blob), &len) != 0) {
prot_set_dirty_mark();
return -1;
}
if (cfg_store_write_atomic(PROT_SET_STORE_PATH, s_blob, (size_t)len) != 0) {
prot_set_dirty_mark(); /* 卷忙/写失败:脏保留,netTask 的 104 tick 下轮再通知 */
return -1;
}
return 0;
}