Files
STM32F4-Base/IEC60870-Slave/examples/iec104_example_config.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

95 lines
5.0 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.
/* 主示例的参数与文件快照存储;这是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