更多内容点击：边缘智联专栏

概述

数源系统全部公共数据结构，包括三层模型基类、置数/控制接口、事件通知机制、通讯状态查询等，是整个数源系统的数据契约层。

---

一、三层模型基类（通道→设备→测点）

通道 (Channel) ──▶ 设备 (Dev) ──▶ 测点 (Point)

类名	层级	核心字段	说明
通道基类	顶层	通道ID、名称、使能标志、设备列表	承载一组设备，对应一个物理通讯链路
设备基类	中层	设备ID、名称、使能标志、测点Map	承载一组测点，对应通道下的一个终端
测点基类	底层	三级索引ID、名称/单位、值数据、状态标志、控制信息	最小的数据单元，所有具体测点类型的父类

测点基类关键组成

类别	字段	说明
类型定义	功能类型（遥测/遥信/遥脉/遥控/遥调/设备变量）、数据类型（浮点/长整/字符串）	决定值的存储方式和处理逻辑
值数据	浮点值、长整值、字符串值	根据数据类型三选一使用
状态标志	数据质量位、置数标志、溢出标志	位域联合体，标识值是否有效
控制信息	控制类型（选择/执行/取消）、控制起止时间	用于遥控操作的四个阶段

---

二、置数接口类

外部向系统写入人工值的接口。

类名	用途	关键字段
置数项	描述单条置数操作	三级索引ID、置数类型（置数/清理置数）、字符串值、处理结果码
置数批量	承载多条置数项	置数项列表

---

三、控制接口类

外部向系统下发遥控/遥调指令的接口。

类名	用途	关键字段
控制高级模式	描述控制方式	控制模式（正常/闪开闪断/保持取反）、保持时间
控制项	描述单条控制操作	三级索引ID、控制类型、字符串值、控制模式、处理结果码
控制批量	承载多条控制项	操作类型（单点/组控）、控制项列表

---

四、通讯状态类

查询通道和设备级别通讯状况。

类名	用途	关键字段
通道通讯状态	通道级通讯统计	在线/离线/异常状态、收发帧数、错误帧数、超时次数、各时间戳
设备通讯状态	设备级通讯统计	正常/异常/超时状态、查询成功/失败次数、有效/无效测点数

---

五、通讯交互类

类名	用途	关键字段
通道监测	开启/关闭通道报文监测	通道ID、监测开关
透明传输	透传原始报文帧	通道ID、帧类型（Hex/字符串）、帧内容

---

六、变位事件类（观察者模式）

测点值变化时的事件通知机制。

类/接口	角色	关键字段
变位通知参数	驱动内部通知数据	三级索引ID、变位类型、新旧值
变位事件	对外推送事件	变位类型、三级索引ID、新旧值、时间戳
变位监测者接口	订阅者需实现的回调	OnDataChange(事件) 纯虚方法

变位类型：信号量变位（0↔1）、模拟量变化超限

---

七、告警事件类（观察者模式）

测点值越限或通讯中断时的告警通知机制。

类/接口	角色	关键字段
告警通知参数	驱动内部通知数据	三级索引ID、告警类型/等级/状态、告警值
告警事件	对外推送事件	告警类型/等级/状态、三级索引ID、告警值、时间戳
告警监测者接口	订阅者需实现的回调	OnAlarm(事件) 纯虚方法

告警类型：上上限/上限/下限/下下限/通讯中断
告警等级：信息/警告/错误/严重
告警状态：激活/恢复/确认

---

八、全局枚举汇总

枚举	取值	说明
模块类型	采集/定义/系统	区分数源系统下的三大子模块
变位类型	信号量变位/模拟量变化超限	区分变位事件的触发方式
告警类型	上上限/上限/下限/下下限/通讯中断	区分告警的触发条件
告警等级	信息/警告/错误/严重	区分告警的严重程度
告警状态	激活/恢复/确认	区分告警的生命周期阶段