55 lines
2.2 KiB
C
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
|