95 lines
5.0 KiB
C
95 lines
5.0 KiB
C
/* 主示例的参数与文件快照存储;这是Windows应用适配,不属于IEC104通信模块。
|
||
* 接口同步执行,调用方须串行访问同一路径及运行值;一个配置文件只能有一个写者。
|
||
* 不创建线程、不分配C堆、不保存连接、发送队列或滤波状态。 */
|
||
#ifndef IEC104_EXAMPLE_CONFIG_H
|
||
#define IEC104_EXAMPLE_CONFIG_H
|
||
|
||
#include "IEC104_Parameter.h"
|
||
#include "IEC60870_Time.h"
|
||
#include <stddef.h>
|
||
|
||
#ifdef IEC104_EXAMPLE_DTU_PROFILE
|
||
#include "iec104_dtu_settings.h"
|
||
#define EXAMPLE_CONFIG_MAX_POINTS 120U
|
||
#else
|
||
#define EXAMPLE_CONFIG_MAX_POINTS 32U
|
||
#endif
|
||
|
||
typedef enum ExampleConfigResult {
|
||
EXAMPLE_CONFIG_OK = 0,
|
||
EXAMPLE_CONFIG_NOT_FOUND = 1,
|
||
EXAMPLE_CONFIG_INVALID = 2,
|
||
EXAMPLE_CONFIG_IO_ERROR = 3
|
||
} ExampleConfigResult;
|
||
|
||
typedef struct ExampleRemoteConfig {
|
||
uint16_t current_area;
|
||
float deadband;
|
||
uint16_t reset_seconds[5];
|
||
float x_time[5];
|
||
} ExampleRemoteConfig;
|
||
|
||
/* name容量至少228字节,bytes容量至少4096字节;由调用方持有,不分配4KB栈副本。 */
|
||
typedef struct ExampleTempConfig {
|
||
bool present;
|
||
uint8_t *name;
|
||
uint8_t name_length;
|
||
uint8_t *bytes;
|
||
uint32_t size;
|
||
IEC60870_CP56Time2a_t time;
|
||
} ExampleTempConfig;
|
||
|
||
typedef struct ExamplePersistentConfig {
|
||
ExampleRemoteConfig remote;
|
||
#ifdef IEC104_EXAMPLE_DTU_PROFILE
|
||
DtuSettings *dtu; /* Caller-owned committed snapshot; Load publishes only on success. */
|
||
#endif
|
||
ExampleTempConfig temp;
|
||
bool legacy; /* Load读到V1或旧旁文件;业务校验成功后须Save迁移为V2。 */
|
||
} ExamplePersistentConfig;
|
||
|
||
/**
|
||
* 功能:加载统一INI;缺失或V1配置才尝试迁移旧remote/TEMP旁文件,V2是唯一权威来源。
|
||
* 输入参数:path——NUL结尾的宿主文件路径;points——参数点表;values——与点表同序的参数运行值数组;count——参数点表元素数;state——持久配置与TEMP候选状态。
|
||
* 输出参数:values——与点表同序的参数运行值数组;state——持久配置与TEMP候选状态。
|
||
* 返回值:配置操作状态:IO_ERROR、INVALID、OK、NOT_FOUND;OK为成功,其他值保留具体失败原因。
|
||
* 说明:统一INI V2始终完整保存标准参数、五区远程参数和TEMP,与模块开关无关。
|
||
* points为同一CA、IOA唯一的点表,count=1..32;values/state提供缺失旧档时的默认值。
|
||
* V2的[config]/[parameter_IOA]/[remote]/[area_0..4]/[temp]必须完整匹配、字段唯一。
|
||
* present=1时TEMP以128字节hex分块保存,CRC32覆盖元数据及内容;present=0不带其他字段。
|
||
* Load失败不改values、remote和temp元数据;name/bytes是未发布暂存,失败后内容可作废。
|
||
* 只有主文件为V1或不存在时读取.remote.ini/.temp.bin做迁移;V2绝不访问旁文件。
|
||
* 所有旧档均不存在才返回NOT_FOUND;旧档坏档/错站/读失败不会被默认值覆盖。
|
||
* 文件<=65536字节、每行<=511字节;接受UTF8 BOM、LF/CRLF、空白和;或#注释。
|
||
* 标准参数的门限/上下限约束仍由应用校验;所有校验通过后才能发布或迁移保存。
|
||
*/
|
||
ExampleConfigResult Example_Config_Load(const char *path,
|
||
const IEC104_ParameterPoint_t *points, IEC104_ParameterValue_t *values, size_t count,
|
||
ExamplePersistentConfig *state);
|
||
|
||
/**
|
||
* 功能:校验标准参数、远程定值及TEMP快照,写入独占临时文件后刷盘并原子替换统一INI。
|
||
* 输入参数:path——NUL结尾的宿主文件路径;points——参数点表;values——与点表同序的参数运行值数组;count——参数点表元素数;state——持久配置与TEMP候选状态。
|
||
* 输出参数:无独立输出参数。
|
||
* 返回值:EXAMPLE_CONFIG_OK表示完整保存成功,INVALID表示参数或快照非法,IO_ERROR表示创建、写入、同步、关闭或替换失败。
|
||
* 说明:Save只写path,输出V2 ASCII/LF INI;参数浮点9位有效数字,TEMP用大写hex。
|
||
* 独占新建同目录临时文件,完整写入、刷盘、关闭后替换目标;失败保留旧文件。
|
||
* 不删除旧旁文件,不加载或重用遗留.tmp;父目录须存在,Windows窄字符路径<=1023字节
|
||
* (含临时后缀)。单写者,人工编辑须停机;保存重写排版和注释,不提供热加载。
|
||
* OK仅表示存储操作成功,不代表主站ACK或故障硬件下的绝对掉电安全。
|
||
*/
|
||
ExampleConfigResult Example_Config_Save(const char *path,
|
||
const IEC104_ParameterPoint_t *points, const IEC104_ParameterValue_t *values, size_t count,
|
||
const ExamplePersistentConfig *state);
|
||
|
||
/**
|
||
* 功能:返回结果码对应的静态ASCII名称供日志使用,未知值返回unknown,不转移字符串所有权。
|
||
* 输入参数:result——待判定的处理结果。
|
||
* 输出参数:无独立输出参数。
|
||
* 返回值:与结果码对应的静态ASCII名称;未知枚举返回unknown,无需释放。
|
||
* 说明:固定ASCII诊断名称;无需释放,未知枚举返回"unknown"。
|
||
*/
|
||
const char *Example_Config_Result_Name(ExampleConfigResult result);
|
||
|
||
#endif
|