2e9272cc8a
引入成熟 IEC 60870-5-104 子站的只读子集(App/protocol/iec60870,28 个源文件 按原字节复制,UPSTREAM.sha256 记录来源,兼容补丁保留全部断言与容量),在其上 装配单属主共享核心(Start/Poll/Stop/Get_Status),并把标准 DTU 演示点表全量 接入为唯一真源。 - iec104_core:threadless 推进,poll 零等待,通知/交互/COV 扫描全部有界; 生命周期区分失败启动待重试、重复启动拒绝、断线保固化 RAM。 - iec104_dtu_table / iec104_source:标准 DTU 全点表注册,无数据源的点读 0, 遥控只做模拟状态可读回,不触碰实际出口。 - iec104_sim:仅窗口与独立服务模式起真实 TCP,无头黄金模式保持确定性假统计。 - test/host/iec104_dtu:独立真实 TCP 11 项、传输层 10 项、生命周期与借用负例。 验证:lvgl_sim 真实 TCP 11/11、传输 10/10,UI 像素回归未回退;AC5 单 TU 编译 0 错误 0 诊断。板端尚未切换:完整库闭包 RAM 超 92% 门禁净增预算 25730B, 结论为停止转实施,记录在 IEC104_MCU最小可行性验证.md。旧实现与 board 服务 保持原样,未提交 MDK 工程改动,未烧板。
335 lines
24 KiB
C
335 lines
24 KiB
C
/* 电能量冻结持久核心:维护定时冻结、日冻结、潮流反转及封存事实。
|
||
* 不依赖堆、线程、文件系统或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
|