/* * DTU 定值模型与校验;协议事务见 settings.inc,持久化见 example_config。 */ #ifndef IEC104_DTU_SETTINGS_H #define IEC104_DTU_SETTINGS_H #include #include #include #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