Files
STM32F4-Base/IEC60870-Slave/common/IEC60870_EnergyFreeze.h
T
STF bdcc8b6500
CI / L0 静态门禁 (pre-commit) (push) Failing after 7m46s
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 21s
添加遥控、参数装载、文件传输等业务
2026-11-16 22:19:17 -08:00

335 lines
24 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.
/* 电能量冻结持久核心:维护定时冻结、日冻结、潮流反转及封存事实。
* 不依赖堆、线程、文件系统或104协议;与计数量召唤的FRZ命令限定词无关。
* 调用方持有实例和存储,并串行执行全部操作(含查询、恢复和XML导出);
* 存储回调不得重入同一实例。公开时刻均为UTC纪元毫秒,窗口按固定UTC+8划分。
* INTERVAL与DAY保存采样示值;本模块不计算累计值的差分或日用电量。 */
#ifndef IEC60870_ENERGY_FREEZE_H
#define IEC60870_ENERGY_FREEZE_H
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#ifdef __cplusplus
extern "C" {
#endif
/* 三张点表各最多64点;单条反转事件最多携带其中8点。
* 32个存储窗口供循环复用;XML导出层另限制为最近30个已封存窗口。 */
#define IEC60870_ENERGY_FREEZE_MAX_POINTS 64U
#define IEC60870_ENERGY_FREEZE_EVENT_POINTS 8U
#define IEC60870_ENERGY_FREEZE_DAYS 32U
#define IEC60870_ENERGY_FREEZE_SLOTS 96U
#define IEC60870_ENERGY_FREEZE_FLOW_CAPACITY 256U
#define IEC60870_ENERGY_FREEZE_DEDUP 16U
/* 最大记录 = 44字节公共头 + 64组(4字节值+1字节品质) + 4字节CRC。 */
#define IEC60870_ENERGY_FREEZE_WIRE_MAX 368U
/* 固定UTC+8本地2000-01-01 00:00:00至2099-12-31 23:59:59.999。 */
#define IEC60870_ENERGY_FREEZE_UTC_MIN UINT64_C(946656000000)
#define IEC60870_ENERGY_FREEZE_UTC_MAX UINT64_C(4102415999999)
/* INTERVAL/DAY为示值,FLOWREV为事件;SEAL证明窗口封存,META保存恢复边界。 */
typedef enum {
IEC60870_ENERGY_FREEZE_INTERVAL = 1, IEC60870_ENERGY_FREEZE_DAY = 2,
IEC60870_ENERGY_FREEZE_FLOWREV = 3, IEC60870_ENERGY_FREEZE_SEAL = 4,
IEC60870_ENERGY_FREEZE_META = 5
} IEC60870_EnergyFreezeKind_t;
/* ERROR:实例不可用、介质失败或记录损坏;INVALID:调用参数/初始化配置非法;
* CONFIG:持久记录指纹不匹配;TIME_REVERSED:now低于已观测高水位;
* TIME_REJECTED:网格、延迟、保留范围、封存或写入顺序不允许此次冻结;
* CONFLICT:同一冻结位置已有不同值;EMPTY:无记录或无到期任务;
* OK:成功;DUPLICATE:内容相同、未重复写入;SKIPPED:整条冻结品质不合格。
* 不应把正返回值一概当成新提交,也不能由失败推断介质一定未改变。 */
typedef enum {
IEC60870_ENERGY_FREEZE_ERROR = -1, IEC60870_ENERGY_FREEZE_INVALID = -2,
IEC60870_ENERGY_FREEZE_CONFIG = -3, IEC60870_ENERGY_FREEZE_TIME_REVERSED = -4,
IEC60870_ENERGY_FREEZE_TIME_REJECTED = -5, IEC60870_ENERGY_FREEZE_CONFLICT = -6,
IEC60870_ENERGY_FREEZE_EMPTY = 0, IEC60870_ENERGY_FREEZE_OK = 1,
IEC60870_ENERGY_FREEZE_DUPLICATE = 2, IEC60870_ENERGY_FREEZE_SKIPPED = 3
} IEC60870_EnergyFreezeResult_t;
/* Init按值复制此结构,但借用三张点表;表须持续有效且不可重排或修改。
* 每张表内IOA为非零24位地址且不重复;不同表之间不要求地址互斥。 */
typedef struct {
const uint32_t *interval_ioas; /* INTERVAL值数组的点序。 */
const uint32_t *day_ioas; /* DAY值数组的点序,与INTERVAL共用点数。 */
size_t point_count; /* 0..64;0关闭定时冻结,仍可启用FLOWREV。 */
const uint32_t *flowrev_ioas; /* 事件indices引用的独立点表。 */
size_t flowrev_count; /* 0..64;0表示未配置反转事件点。 */
uint32_t value_semantics; /* 应用定义的值含义/单位/映射版本,参与指纹。 */
uint16_t day_start_minutes; /* UTC+8本地窗口起点,0..1425且为15的倍数。 */
uint32_t grid_tolerance_ms; /* 采样时刻距最近15分钟网格的容差,最大60000。 */
uint32_t max_delay_ms; /* now晚于采样时刻的最大延迟,最大900000。 */
} IEC60870_EnergyFreezeConfig_t;
/* 同步逻辑槽接口:kind区分区域,index范围为[0, Slot_Count(kind))。
* read仅在没有已提交记录时返回EMPTY;成功返回OK并写回实际size。
* 已提交数据损坏必须报错,不能退回旧版本或伪装成EMPTY。
* commit返回true承诺原子、持久地替换该槽;回调返回前须消费完bytes。
* 返回false仍可能已落盘,核心随即锁存faulted;须重新Init核验介质后再用。
* context由调用方持有,核心共用wire工作区,回调不得保留其缓冲指针。 */
typedef struct {
void *context;
IEC60870_EnergyFreezeResult_t (*read)(void *context,
IEC60870_EnergyFreezeKind_t kind, uint32_t index, uint8_t *bytes,
size_t capacity, size_t *size);
bool (*commit)(void *context, IEC60870_EnergyFreezeKind_t kind,
uint32_t index, const uint8_t *bytes, size_t size);
} IEC60870_EnergyFreezeStore_t;
typedef struct {
uint32_t day; /* 窗口起始本地日期距1970-01-01的日序,不是YYYYMMDD。 */
uint16_t slot; /* INTERVAL: 1..96;DAY: 0;第1节为窗口起点,第96节为起点+23:45。 */
uint64_t freeze_utc_ms; /* 实际采样时刻,保留与名义网格的偏差。 */
uint64_t observed_utc_ms; /* 提交该记录时传入的now;派生DAY时可晚于采样。 */
size_t count; /* values/quality的有效长度,等于配置point_count。 */
float values[IEC60870_ENERGY_FREEZE_MAX_POINTS];
uint8_t quality[IEC60870_ENERGY_FREEZE_MAX_POINTS];
} IEC60870_EnergyFreezeRecord_t;
typedef struct {
uint64_t sequence; /* 从1开始的持久到达序号,不按occur排序、不回绕。 */
uint64_t occur_utc_ms; /* 原始发生时刻,允许乱序/回拨,不推进冻结观测高水位。 */
size_t count; /* 1..8;事件可保留坏品质/非有限值,XML仅输出有效项。 */
uint8_t indices[IEC60870_ENERGY_FREEZE_EVENT_POINTS]; /* flowrev_ioas的0起始索引,严格递增。 */
float values[IEC60870_ENERGY_FREEZE_EVENT_POINTS];
uint8_t quality[IEC60870_ENERGY_FREEZE_EVENT_POINTS];
} IEC60870_EnergyFreezeFlowReverse_t;
typedef struct {
uint32_t day;
uint64_t observed_utc_ms; /* 封存时的观测时刻。 */
uint8_t bitmap[13]; /* 位0..95对应INTERVAL,位96对应DAY;剩余7位必须为0。 */
uint8_t count; /* 置位数(含DAY),允许0,表示合法封存的空窗口。 */
uint32_t content_crc; /* 日序、位图及按节序排列的记录正文摘要,不含各记录尾CRC。 */
} IEC60870_EnergyFreezeSeal_t;
typedef struct {
bool interval; /* 当前网格有一次可尝试的定时冻结。 */
uint64_t grid_utc_ms; /* interval为true时有效,只是名义时刻,不可冒充实际采样时刻。 */
bool derive_day; /* 有窗口已存第1节且尚缺DAY;可与interval同时为true。 */
uint32_t day; /* derive_day为true时有效,为最早待派生窗口的日序。 */
} IEC60870_EnergyFreezeDue_t;
typedef struct {
bool sealed_valid;
uint32_t sealed_day; /* sealed_valid时有效,为当前连续封存前沿。 */
bool retained_valid;
uint32_t retained_from; /* retained_valid时有效,为32窗口保留下界R。 */
uint32_t seal_backlog; /* 按当前观测高水位计算的待封存窗口数。 */
uint32_t evicted_unsealed; /* 有数据但未封存即被淘汰的窗口累计数,UINT32_MAX饱和。 */
uint64_t observed_utc_ms; /* 已观测now高水位W;0表示尚未观测。 */
uint64_t flow_sequence; /* 最大已提交FLOWREV序号;0表示尚无事件。 */
size_t flow_count; /* 当前保留事件数,最大256。 */
bool faulted; /* 故障锁存后只供诊断,重新Init成功前不再提供正常读写。 */
} IEC60870_EnergyFreezeStatus_t;
/* 公开布局仅用于调用方静态分配;字段由核心维护,不可直接修改。
* Config/Store结构按值复制,点表及store.context仍为借用对象。
* 只缓存存在位图与边界,不缓存全部示值;读操作也会复用wire并可能锁存故障。 */
typedef struct {
IEC60870_EnergyFreezeConfig_t config;
IEC60870_EnergyFreezeStore_t store;
uint32_t fingerprint;
uint32_t retained_from;
uint32_t sealed_day;
uint32_t evicted_unsealed;
uint64_t observed_utc_ms;
uint64_t latest_interval; /* have_interval时有效,该类已写最大名义网格。 */
uint64_t latest_day; /* have_day时有效;补派生较早DAY也不会降低此值。 */
uint64_t flow_sequence;
size_t flow_count;
bool retained_valid;
bool sealed_valid;
bool have_interval;
bool have_day;
bool have_meta;
bool initialized;
bool faulted;
uint8_t present[IEC60870_ENERGY_FREEZE_DAYS][13]; /* 按day % 32寻址的97位存在图。 */
bool seals[IEC60870_ENERGY_FREEZE_DAYS]; /* 同一物理窗口槽是否已封存。 */
uint8_t wire[IEC60870_ENERGY_FREEZE_WIRE_MAX]; /* 序列化/读取共用的临时字节区。 */
} IEC60870_EnergyFreeze_t;
/**
* 功能:清零配置并将网格容差、最大延迟设为1000ms;点表仍须应用填写。
* 输入参数:无。
* 输出参数:config——写入默认配置;NULL时不操作。
* 返回值:无。
* 说明:NULL无操作。
*/
void IEC60870_EnergyFreeze_Config_Default(IEC60870_EnergyFreezeConfig_t *config);
/**
* 功能:存储后端所需逻辑槽数;未知kind返回0,不含后端自己的双bank冗余。
* 输入参数:kind——记录或文件类别。
* 输出参数:无。
* 返回值:该类别的逻辑槽容量;未知类别返回0。
* 说明:不包含后端双bank等冗余,存储后端据此为各类别分配逻辑区域。
*/
uint32_t IEC60870_EnergyFreeze_Slot_Count(IEC60870_EnergyFreezeKind_t kind);
/**
* 功能:将名义网格时刻映射到业务窗口日序;参数或所得日期越界返回UINT32_MAX。
* 输入参数:nominal_utc_ms——名义UTC毫秒,本入口不进行15分钟取整;day_start_minutes——UTC+8午夜起算的业务日界分钟偏移。
* 输出参数:无。
* 返回值:业务窗口起始日序;时刻、日界偏移或归属日非法时返回UINT32_MAX。
* 说明:调用者提供名义时刻,本函数不负责按15分钟取整。
*/
uint32_t IEC60870_EnergyFreeze_Window_Day(uint64_t nominal_utc_ms,
uint16_t day_start_minutes);
/**
* 功能:日序转窗口起点UTC;失败返回false且不写utc_ms。
* 输入参数:day——相对1970-01-01的本地日序;day_start_minutes——UTC+8午夜起算的业务日界分钟偏移。
* 输出参数:utc_ms——成功写入窗口起点UTC毫秒;失败保持原值。
* 返回值:true表示起点已计算并写回;false表示参数无效且输出不变。
* 说明:日期、偏移或utc_ms无效时返回false且不改写输出,成功才填写*utc_ms。
*/
bool IEC60870_EnergyFreeze_Window_Start(uint32_t day, uint16_t day_start_minutes,
uint64_t *utc_ms);
/**
* 功能:初始化/故障后恢复:先读META,再扫描全部记录并核验封存摘要和事件连续性。
* 输入参数:self——调用方持有的模块实例及当前状态;config——配置及调用期间借用的元数据;store——同步存储回调表及其上下文。
* 输出参数:self——本次操作后的运行状态及复用工作区。
* 返回值:OK表示操作完成;INVALID表示参数或操作状态非法;CONFIG表示持久记录与当前配置指纹不符;ERROR表示实例不可用、I/O失败或内容损坏。
* 说明:全空存储可初始化成功;只读介质,不自动修复、清空或改写不兼容记录。 配置指纹不匹配返回CONFIG,介质/内容错误返回ERROR并锁存faulted。
*/
IEC60870_EnergyFreezeResult_t IEC60870_EnergyFreeze_Init(IEC60870_EnergyFreeze_t *self,
const IEC60870_EnergyFreezeConfig_t *config, const IEC60870_EnergyFreezeStore_t *store);
/**
* 功能:推进观测高水位,每次至多封存一个已到窗口结束+max_delay_ms的窗口。
* 输入参数:self——调用方持有的模块实例及当前状态;now_utc_ms——本次观测UTC毫秒。
* 输出参数:self——本次操作后的运行状态及复用工作区。
* 返回值:OK表示操作完成;INVALID表示参数或操作状态非法;ERROR表示实例不可用、I/O失败或内容损坏;CONFIG表示持久记录与当前配置指纹不符;
* TIME_REVERSED表示观测时间低于高水位;TIME_REJECTED表示网格、延迟或窗口顺序不允许。
* 说明:空窗口也可封存;OK可能只推进时间而未封存,积压量通过Get_Status查询。 先提交SEAL事实再提交META提示;后者失败也不能撤销已完成的封存。
*/
IEC60870_EnergyFreezeResult_t IEC60870_EnergyFreeze_Advance(IEC60870_EnergyFreeze_t *self,
uint64_t now_utc_ms);
/**
* 功能:纯查询:不推进观测高水位、不访问介质;只在OK时写out,EMPTY表示无任务。
* 输入参数:self——只读模块实例;now_utc_ms——本次观测UTC毫秒。
* 输出参数:out——仅OK时写入到期名义网格及窗口任务。
* 返回值:OK表示有任务并写出结果;EMPTY表示无任务;INVALID表示参数非法;ERROR表示实例不可用;TIME_REVERSED表示now_utc_ms低于观测高水位。
* 说明:仅提示当前网格之后容差范围内的INTERVAL及可由已存第1节派生的DAY, 不补造错过网格的值。记录时应传实际采样时间,不要把grid_utc_ms当成采样时刻。
*/
IEC60870_EnergyFreezeResult_t IEC60870_EnergyFreeze_Due(const IEC60870_EnergyFreeze_t *self,
uint64_t now_utc_ms, IEC60870_EnergyFreezeDue_t *out);
/**
* 功能:写一条INTERVAL:count必须等于point_count且非0,数组仅在调用期间借用。
* 输入参数:self——调用方持有的模块实例及当前状态;now_utc_ms——本次观测UTC毫秒;freeze_utc_ms——实际采样UTC毫秒;values——按配置点序排列的值;
* quality——与值数组同序的品质;count——数组项数。
* 输出参数:self——本次操作后的运行状态及复用工作区。
* 返回值:OK表示操作完成;DUPLICATE表示已有相同内容,未重复提交;SKIPPED表示整条冻结品质不合格;INVALID表示参数或操作状态非法;ERROR表示实例不可用、I/O失败或内容损坏;
* CONFIG表示持久记录与当前配置指纹不符;TIME_REVERSED表示观测时间低于高水位;TIME_REJECTED表示网格、延迟或窗口顺序不允许;CONFLICT表示已有记录内容不同。
* 说明:freeze按最近15分钟网格归槽,保留实际时刻;now用于延迟及回拨检查。 任一点品质非0或值非有限则整条SKIPPED;同类最新网格值/品质逐字节相同 返回DUPLICATE,
* 不同返回CONFLICT;更旧网格/封存窗等返回TIME_REJECTED。 参数及回拨检查通过即推进内存观测高水位,后续拒绝或跳过不回退该高水位。
*/
IEC60870_EnergyFreezeResult_t IEC60870_EnergyFreeze_Record_Interval(
IEC60870_EnergyFreeze_t *self, uint64_t now_utc_ms, uint64_t freeze_utc_ms,
const float *values, const uint8_t *quality, size_t count);
/**
* 功能:与Record_Interval同一准入规则,但名义网格必须恰为窗口起点,slot固定为0。
* 输入参数:self——调用方持有的模块实例及当前状态;now_utc_ms——本次观测UTC毫秒;freeze_utc_ms——实际采样UTC毫秒;values——按配置点序排列的值;
* quality——与值数组同序的品质;count——数组项数。
* 输出参数:self——本次操作后的运行状态及复用工作区。
* 返回值:OK表示操作完成;DUPLICATE表示已有相同内容,未重复提交;SKIPPED表示整条冻结品质不合格;INVALID表示参数或操作状态非法;ERROR表示实例不可用、I/O失败或内容损坏;
* CONFIG表示持久记录与当前配置指纹不符;TIME_REVERSED表示观测时间低于高水位;TIME_REJECTED表示网格、延迟或窗口顺序不允许;CONFLICT表示已有记录内容不同。
* 说明:freeze_utc_ms归槽后的名义网格须为窗口起点;count须非零且等于point_count。 其余时间、品质、重复/冲突及状态副作用与Record_Interval一致,
* 透传Record结果。
*/
IEC60870_EnergyFreezeResult_t IEC60870_EnergyFreeze_Record_Day(
IEC60870_EnergyFreeze_t *self, uint64_t now_utc_ms, uint64_t freeze_utc_ms,
const float *values, const uint8_t *quality, size_t count);
/**
* 功能:从指定未封存窗口的已存第1节复制DAY,保留原值、品质和freeze,observed取now。
* 输入参数:self——调用方持有的模块实例及当前状态;now_utc_ms——本次观测UTC毫秒;day——相对1970-01-01的本地日序。
* 输出参数:self——本次操作后的运行状态及复用工作区。
* 返回值:OK表示操作完成;DUPLICATE表示已有相同内容,未重复提交;EMPTY表示没有所需记录或到期任务;INVALID表示参数或操作状态非法;ERROR表示实例不可用、I/O失败或内容损坏;
* CONFIG表示持久记录与当前配置指纹不符;TIME_REVERSED表示观测时间低于高水位;TIME_REJECTED表示网格、延迟或窗口顺序不允许;CONFLICT表示已有记录内容不同。
* 说明:不重新采样或检查源记录的提交延迟;源缺失返回EMPTY,已有DAY则比较内容。 可补较早窗口,但不能降低DAY已写最大网格。
*/
IEC60870_EnergyFreezeResult_t IEC60870_EnergyFreeze_Derive_Day(
IEC60870_EnergyFreeze_t *self, uint64_t now_utc_ms, uint32_t day);
/**
* 功能:追加反转事件:1..8个严格递增索引,引用flowrev_ioas,值及品质原样保存。
* 输入参数:self——调用方持有的模块实例及当前状态;occur_utc_ms——事件发生UTC毫秒;indices——FLOWREV点表的索引数组;values——与indices同序排列的事件值;
* quality——与值数组同序的品质;count——数组项数。
* 输出参数:self——本次操作后的运行状态及复用工作区。
* 返回值:OK表示操作完成;DUPLICATE表示已有相同内容,未重复提交;INVALID表示参数或操作状态非法;ERROR表示实例不可用、I/O失败或内容损坏。
* 说明:最近16条按occur、索引、float原始字节和品质完全匹配去重;occur允许倒退。 先提交事件再更新META;任一提交失败后须恢复实例,不可盲目重试。 不推进冻结观测高水位;
* 环满覆盖最旧事件,序号耗尽返回ERROR且不回绕。
*/
IEC60870_EnergyFreezeResult_t IEC60870_EnergyFreeze_Append_FlowReverse(
IEC60870_EnergyFreeze_t *self, uint64_t occur_utc_ms, const uint8_t *indices,
const float *values, const uint8_t *quality, size_t count);
/**
* 功能:读取保留范围内记录,未封存数据也可读;INTERVAL的slot为1..96。
* 输入参数:self——调用方持有的模块实例及当前状态;day——相对1970-01-01的本地日序;slot——冻结节号;INTERVAL为1..96,DAY为0。
* 输出参数:self——复用工作区及读取校验可能锁存的故障状态;out——成功时写入的独立结果副本。
* 返回值:OK表示操作完成;EMPTY表示没有所需记录或到期任务;INVALID表示参数或操作状态非法;ERROR表示实例不可用、I/O失败或内容损坏;CONFIG表示持久记录与当前配置指纹不符。
* 说明:缺测或范围外返回EMPTY;已知存在的记录丢失/损坏则报错并锁存故障。 两个Read接口仅在OK时写out,结果为副本,不借用内部wire。
*/
IEC60870_EnergyFreezeResult_t IEC60870_EnergyFreeze_Read_Interval(
IEC60870_EnergyFreeze_t *self, uint32_t day, uint16_t slot,
IEC60870_EnergyFreezeRecord_t *out);
/**
* 功能:读取指定业务窗口起点的DAY示值,返回记录slot为0,不计算日用电量。
* 输入参数:self——调用方持有的模块实例及当前状态;day——相对1970-01-01的本地日序。
* 输出参数:self——复用工作区及读取校验可能锁存的故障状态;out——成功时写入的独立结果副本。
* 返回值:OK表示操作完成;EMPTY表示没有所需记录或到期任务;INVALID表示参数或操作状态非法;ERROR表示实例不可用、I/O失败或内容损坏;CONFIG表示持久记录与当前配置指纹不符。
* 说明:透传Read_Record结果,仅OK时填写out;普通缺测或保留范围外返回EMPTY。
*/
IEC60870_EnergyFreezeResult_t IEC60870_EnergyFreeze_Read_Day(
IEC60870_EnergyFreeze_t *self, uint32_t day, IEC60870_EnergyFreezeRecord_t *out);
/**
* 功能:当前保留事件条数;实例未就绪/故障时返回0,可用Get_Status区分故障与空库。
* 输入参数:self——只读模块实例。
* 输出参数:无。
* 返回值:当前保留的FLOWREV事件数;实例不可用时返回0。
* 说明:不能以0单独判断空库,应结合Get_Status检查健康状态。
*/
size_t IEC60870_EnergyFreeze_FlowReverse_Count(const IEC60870_EnergyFreeze_t *self);
/**
* 功能:oldest_index从0起按持久序号由旧到新读取;越界EMPTY,仅OK时写out。
* 输入参数:self——调用方持有的模块实例及当前状态;oldest_index——按提交顺序从最旧记录起的零基索引。
* 输出参数:self——复用工作区及读取校验可能锁存的故障状态;out——成功时写入的独立结果副本。
* 返回值:OK表示操作完成;EMPTY表示没有所需记录或到期任务;INVALID表示参数或操作状态非法;ERROR表示实例不可用、I/O失败或内容损坏。
* 说明:仅OK时填写out,越界返回EMPTY,参数或实例/读取错误返回相应结果。 应存在的事件读取失败或序号不符会锁存故障;不按occur墙钟排序。
*/
IEC60870_EnergyFreezeResult_t IEC60870_EnergyFreeze_Get_FlowReverse(
IEC60870_EnergyFreeze_t *self, size_t oldest_index, IEC60870_EnergyFreezeFlowReverse_t *out);
/**
* 功能:内存状态快照,不访问介质;faulted实例仍可诊断(Init失败时可能是部分恢复状态)。
* 输入参数:self——只读模块实例。
* 输出参数:out——诊断快照,允许Init失败后faulted的部分状态;失败不变。
* 返回值:true表示已复制诊断快照;false表示指针无效或实例既未初始化也未故障。
* 说明:参数无效或既未初始化又未故障时返回false,out保持不变。
*/
bool IEC60870_EnergyFreeze_Get_Status(const IEC60870_EnergyFreeze_t *self,
IEC60870_EnergyFreezeStatus_t *out);
/**
* 功能:Get_Seal读取封存记录自身,不扫描数据正文;无封存返回EMPTY,仅OK时写out。
* 输入参数:self——调用方持有的模块实例及当前状态;day——相对1970-01-01的本地日序。
* 输出参数:self——复用工作区及读取校验可能锁存的故障状态;out——成功时写入的独立结果副本。
* 返回值:OK表示操作完成;EMPTY表示没有所需记录或到期任务;INVALID表示参数或操作状态非法;ERROR表示实例不可用、I/O失败或内容损坏。
* 说明:SEAL一旦提交即是封存事实,后续数据缺失不能退化成缺测;空窗有count=0的合法SEAL。 Validate_Seal另扫描全部97个位置,核对存在位图及规范内容摘要。
* XML导出必须校验通过后才能发布,整个过程禁止并发修改核心或介质。
*/
IEC60870_EnergyFreezeResult_t IEC60870_EnergyFreeze_Get_Seal(
IEC60870_EnergyFreeze_t *self, uint32_t day, IEC60870_EnergyFreezeSeal_t *out);
/**
* 功能:验证SEAL的存在位图及正文摘要,空封存同样验证;整个过程须串行独占。
* 输入参数:self——调用方持有的模块实例及当前状态;day——相对1970-01-01的本地日序。
* 输出参数:self——复用工作区及读取校验可能锁存的故障状态。
* 返回值:OK表示操作完成;EMPTY表示没有所需记录或到期任务;INVALID表示参数或操作状态非法;ERROR表示实例不可用、I/O失败或内容损坏;CONFIG表示持久记录与当前配置指纹不符。
* 说明:全部一致返回OK,无封存返回EMPTY,参数/读取错误透传;摘要不符返回ERROR。 不修改介质,但正文缺失、意外增添或摘要不符会锁存faulted。
*/
IEC60870_EnergyFreezeResult_t IEC60870_EnergyFreeze_Validate_Seal(
IEC60870_EnergyFreeze_t *self, uint32_t day);
#ifdef __cplusplus
}
#endif
#endif