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

55 lines
2.2 KiB
C

/*
* DTU 定值模型与校验;协议事务见 settings.inc,持久化见 example_config。
*/
#ifndef IEC104_DTU_SETTINGS_H
#define IEC104_DTU_SETTINGS_H
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#include "IEC104_RemoteParameter.h"
/* 包含未配置项,不等于可读点数。 */
#define DTU_SETTINGS_COUNT 430U
#define DTU_SETTINGS_AREAS 5U
typedef struct DtuSettings {
/* 当前动作区:0..4。 */
uint16_t current_area;
/* 0 区含公共及动作参数,1..4 区仅动作参数;第二维为 profile 下标。 */
double values[DTU_SETTINGS_AREAS][DTU_SETTINGS_COUNT];
} DtuSettings;
typedef struct DtuSettingsStage {
/* active:预置占用;complete:末帧已到,尚未固化。 */
bool active, complete;
/* 原事务身份与 SN,不持有 ASDU 数据指针。 */
IEC104_RemoteParameterRequest_t owner;
/* 单区候选,预置期间不供运行读取。 */
double values[DTU_SETTINGS_COUNT];
} DtuSettingsStage;
/* settings 非 NULL;初始化可见项并选择 0 区。 */
void Dtu_Settings_Init(DtuSettings *settings);
/* 未知 IOA 返回 DTU_SETTINGS_COUNT,不能用作数组下标。 */
size_t Dtu_Settings_Index(uint32_t ioa);
/* 越界返回 0;Tag 为线上类型。 */
uint32_t Dtu_Settings_Ioa(size_t index);
uint8_t Dtu_Settings_Tag(size_t index);
/* 排除未配置项及目标区不可见项。 */
bool Dtu_Settings_Visible(size_t index, uint16_t area);
/* 运行/动作参数、遥测倍率和遥信取反可写;仅检查权限,仍须另查 Visible。
* 倍率与取反是公共参数,仅在 0 区可见,不随动作区切换。
*/
bool Dtu_Settings_Writable(size_t index);
/* 单项校验;只读值须等于模板初值。倍率为有限正 binary32 值(<= 1e6),
* 取反仅 0/1;重合次数 0..3,分/合闸脉冲保持时间必须为正值。
*/
bool Dtu_Settings_Value_Valid(size_t index, double value);
/* 校验全部可见项及跨项关系;NULL 返回 false。 */
bool Dtu_Settings_Valid(const DtuSettings *settings);
/* settings 非 NULL;动作参数取当前区,其余取 0 区;未知或不可见项返回 fallback。 */
double Dtu_Settings_Get(const DtuSettings *settings, uint32_t ioa, double fallback);
#endif