/* 主示例的参数与文件快照存储;这是Windows应用适配,不属于IEC104通信模块。 * 接口同步执行,调用方须串行访问同一路径及运行值;一个配置文件只能有一个写者。 * 不创建线程、不分配C堆、不保存连接、发送队列或滤波状态。 */ #ifndef IEC104_EXAMPLE_CONFIG_H #define IEC104_EXAMPLE_CONFIG_H #include "IEC104_Parameter.h" #include "IEC60870_Time.h" #include #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