网关数据
数据管理是网关的核心功能模块，通过"通道-设备-变量"三级模型组织数据采集点位，支持配置管理、实时监控和数据导入导出。
功能入口
点击左侧菜单"网关数据"进入管理页面。
数据模型
| 层级 | 说明 |
|---|---|
| 通道 | 通讯连接，如TCP客户端、TCP服务端、串口等。通道定义了与外部设备的通信方式和连接参数 |
| 设备 | 物理或逻辑设备，归属于通道。设备定义了具体的采集目标及其参数 |
| 变量 | 数据点位，归属于设备。变量定义了具体的数据地址、数据类型和报警配置 |
页面布局
页面采用可拖拽分割面板布局：
| 区域 | 说明 |
|---|---|
| 左侧面板 | 通道设备树，以树形结构展示通道和设备，宽度可拖拽调整（280-600px） |
| 右侧面板 | 变量列表或设备详情面板 |
提示
左右面板之间的分割线可拖拽调整宽度，根据需要调整查看区域大小。
通道设备树
视图模式
| 模式 | 说明 |
|---|---|
| 变量显示 | 点击设备显示变量列表 |
| 设备显示 | 点击设备显示设备详情面板 |
树形操作
| 操作 | 说明 |
|---|---|
| 点击节点 | 选中通道或设备 |
| 右键菜单 | 新增、编辑、删除、复制等操作 |
| 设备状态筛选 | 按在线/离线状态筛选设备 |
| 搜索 | 搜索通道或设备名称 |
变量列表
工具栏
| 功能 | 说明 |
|---|---|
| 搜索变量名称 | 按变量名称搜索 |
| 搜索地址 | 按寄存器地址搜索 |
| 设备筛选 | 按设备筛选变量 |
| 状态筛选 | 按正常/异常状态筛选 |
| 刷新 | 手动刷新变量列表 |
| 自动刷新 | 开启后自动刷新变量值 |
| 新增变量 | 创建新变量 |
| 批量编辑 | 批量编辑选中变量 |
| 批量删除 | 批量删除选中变量 |
| 导出变量 | 导出变量配置到 Excel |
| 导入变量 | 从 Excel 导入变量配置 |
| 测试数据 | 打开设备调试界面 |
| 列设置 | 自定义显示的列，支持恢复默认 |
设备调试
点击"测试数据"按钮打开设备调试界面，用于测试和验证设备通讯配置。
提示
设备调试功能支持多种协议的在线调试，帮助快速定位通讯问题。详细使用方法请参考 设备调试 文档。
表格功能
| 功能 | 说明 |
|---|---|
| 列排序 | 点击列头可按该列排序（如变量名称、设备名称等） |
| 多选 | 通过复选框选择多个变量，用于批量操作 |
| 列设置 | 通过"列设置"按钮自定义显示/隐藏列 |
可显示的列
| 列 | 说明 |
|---|---|
| 设备名称 | 变量所属设备 |
| 变量名称 | 变量标识名称，显示在线状态和报警状态标识 |
| 描述 | 变量描述 |
| 寄存器地址 | 变量在设备中的地址 |
| 当前值 | 当前采集值（含单位） |
| 原始值 | 原始采集值 |
| 最后设定值 | 最后写入的值 |
| 数据类型 | 数据类型 |
| 单位 | 变量单位 |
| 间隔时间 | 采集间隔 |
| 采集组 | 采集分组 |
| 业务组 | 业务分组 |
| 数组长度 | 数组变量长度 |
| 其他方法 | 其他方法配置 |
| 保护类型 | 变量保护类型 |
| 读表达式 | 读取表达式 |
| 写表达式 | 写入表达式 |
| 初始值 | 变量初始值 |
| 备注1-5 | 自定义备注字段 |
| 索引 | 变量索引 |
| 在线状态 | 在线/离线状态 |
| 启用 | 是否启用 |
| RPC写使能 | 是否允许RPC写入 |
| RPC写校验 | 是否启用RPC写校验 |
| 保存值 | 是否保存变量值 |
| 业务组更新触发 | 是否触发业务组更新 |
| 业务更新 | 业务更新配置 |
| 采集时间 | 最后采集时间 |
| 变化时间 | 值最后变化时间 |
| 错误信息 | 最后错误信息 |
| 报警使能 | 是否启用报警 |
变量操作
| 操作 | 说明 |
|---|---|
| 详情 | 打开变量详情抽屉 |
| 设备 | 查看所属设备详情 |
| 写入 | 对可写变量进行写入操作 |
| 编辑 | 编辑变量配置 |
| 删除 | 删除变量 |
变量详情
点击"详情"按钮打开变量详情抽屉：
基本信息
| 信息 | 说明 |
|---|---|
| ID | 变量ID |
| 名称 | 变量名称 |
| 设备 | 所属设备 |
| 描述 | 变量描述 |
| 状态 | 正常/异常 |
| 使能 | 是否启用 |
地址配置
| 信息 | 说明 |
|---|---|
| 寄存器地址 | 变量地址 |
| 数组长度 | 数组长度 |
| 其他方法 | 其他方法配置 |
| 索引 | 变量索引 |
| 变量源地址 | 源变量地址 |
| 变量源长度 | 源变量长度 |
| 变量源错误 | 源变量错误信息 |
数据信息
| 信息 | 说明 |
|---|---|
| 当前值 | 当前采集值（含单位） |
| 原始值 | 原始采集值 |
| 最后设置值 | 最后写入的值 |
| 初始值 | 变量初始值 |
| 数据类型 | 数据类型 |
| 保护类型 | 保护类型 |
| 单位 | 变量单位 |
| 间隔时间 | 采集间隔 |
分组信息
| 信息 | 说明 |
|---|---|
| 采集分组 | 采集分组名称 |
| 业务分组 | 业务分组名称 |
控制配置
| 信息 | 说明 |
|---|---|
| 使能 | 是否启用变量 |
| RPC写使能 | 是否允许远程RPC写入 |
| RPC写校验 | 写入后再次读取检查值是否一致 |
| 保存值 | 是否保存变量值（重启后恢复） |
| 业务组更新触发 | 是否作为业务组更新触发变量 |
表达式配置
| 信息 | 说明 |
|---|---|
| 读取表达式 | 读取时应用的表达式 |
| 读表达式参数 | 表达式参数配置 |
| 写入表达式 | 写入时应用的表达式 |
| 写表达式参数 | 表达式参数配置 |
报警配置
| 信息 | 说明 |
|---|---|
| 报警使能 | 是否启用报警 |
| 报警等级 | 报警级别（数值越大越严重） |
| 报警延时 | 报警触发延时时间（毫秒） |
| 布尔开报警使能 | 布尔类型变量，值为true时触发报警 |
| 布尔关报警使能 | 布尔类型变量，值为false时触发报警 |
| 高报使能 | 启用高限报警 |
| 高报阈值 | 高限报警阈值 |
| 高报文本 | 高限报警描述文本 |
| 高高报使能 | 启用高高限报警 |
| 高高报阈值 | 高高限报警阈值 |
| 高高报文本 | 高高限报警描述文本 |
| 低报使能 | 启用低限报警 |
| 低报阈值 | 低限报警阈值 |
| 低报文本 | 低限报警描述文本 |
| 低低报使能 | 启用低低限报警 |
| 低低报阈值 | 低低限报警阈值 |
| 低低报文本 | 低低限报警描述文本 |
| 自定义报警使能 | 启用自定义报警条件 |
| 抑制表达式 | 报警抑制条件表达式 |
异常值过滤配置
| 信息 | 说明 |
|---|---|
| 合理范围过滤使能 | 启用合理范围过滤，超出范围的值将被过滤 |
| 最小值 | 合理范围最小值 |
| 最大值 | 合理范围最大值 |
| 变化幅度过滤使能 | 启用变化幅度过滤，变化过大的值将被过滤 |
| 最大变化幅度 | 允许的最大变化绝对值 |
| 最大变化幅度百分比 | 允许的最大变化百分比（%） |
| 连续异常过滤使能 | 启用连续异常过滤，连续多次异常后接受该值 |
| 连续异常最大次数 | 连续异常的最大次数，超过此次数后接受该值 |
设备详情面板
在"设备显示"模式下，点击设备显示设备详情面板：
设备信息
| 信息 | 说明 |
|---|---|
| 设备名称 | 设备标识名称 |
| 所属通道 | 设备所属通道 |
| 在线状态 | 在线/离线 |
| 使能状态 | 是否启用 |
| 设备描述 | 设备描述信息 |
通道配置
点击"新增通道"或右键菜单"新增通道"打开配置对话框。
基本配置
| 字段 | 说明 |
|---|---|
| 通道名称 | 通道标识名称 |
| 插件类型 | 通讯插件类型，不同插件有不同的属性配置，详见插件参考。采集插件用于从设备读取数据(如Modbus、OPC UA)，业务插件用于将数据转发到外部系统(如MQTT、Kafka) |
| 使能 | 是否启用通道。禁用后该通道下所有设备停止采集 |
| 描述 | 通道描述信息 |
通道类型说明
- TcpClient: 主动连接远程设备，适用于网关主动发起连接的场景
- TcpService: 监听端口等待设备连接，适用于设备主动连接网关的场景
- UdpSession: UDP通讯模式，适用于无需可靠连接的场景
- SerialPort: 串口通讯(RS232/RS485)，适用于串口设备直连
- Other: 其他类型，MQTT、Kafka等业务插件使用此通道类型
插件属性
选择不同的插件类型后，通道配置对话框会显示该插件特有的属性字段（如Modbus的"Modbus类型"和"默认站号"、S7的"PLC类型"和"Rack/Slot"等）。详细的插件属性说明请参考 插件参考。
设备配置
选中通道后，点击"新增设备"或右键菜单"新增设备"打开配置对话框。
基本配置
| 字段 | 说明 |
|---|---|
| 设备名称 | 设备标识名称 |
| 设备模板 | 设备模板（可选），可快速复用已有设备的配置 |
| 使能 | 是否启用设备。禁用后该设备下所有变量停止采集 |
| 描述 | 设备描述信息 |
| 执行间隔 | 采集执行间隔。支持毫秒数(如1000)或Cron表达式(如 */5 * * * * * 表示每5秒)。Cron格式: 秒 分 时 日 月 周 |
| 扫描间隔 | 设备状态扫描间隔（毫秒），用于检测设备在线/离线状态 |
| 启用冗余 | 是否启用设备级冗余，启用后设备在冗余从站模式下也可独立采集 |
| 冗余模式 | 冗余采集模式：独立采集或跟随主站 |
变量配置
选中设备后，点击"新增变量"打开配置对话框。
基本配置
| 字段 | 说明 |
|---|---|
| 变量名称 | 变量标识名称 |
| 寄存器地址 | 变量地址，格式因采集插件而异，详见插件参考 |
| 数据类型 | 数据类型，如Bool、Int16、UInt32、Float、Double、String等 |
| 读写类型 | 只读/读写。只读变量仅采集数据，读写变量支持通过RPC写入 |
| 描述 | 变量描述 |
变量高级配置
基础配置：
- 保护类型: 变量值的保护策略，防止意外写入
- 采集分组: 同一分组的变量在同一采集周期内批量读取，提高效率
- 业务分组: 同一分组的变量在同一业务周期内批量上报
- 业务更新触发: 业务分组数据更新的触发方式
表达式配置：
- 读取表达式: 采集值经过表达式计算后再显示，如
(value - 273.15)将开尔文转为摄氏度 - 读表达式参数: 读取表达式的自定义参数配置
- 写入表达式: 写入值经过表达式计算后再发送到设备
- 写表达式参数: 写入表达式的自定义参数配置
RPC配置：
- RPC写使能: 允许外部系统通过API写入此变量
- RPC写校验: 写入后再次读取检查值是否一致
- 启用后，写入操作会自动读取验证
- 如果读取值与写入值不一致，返回错误
- 确保写入操作的可靠性
持久化配置：
- 保存值: 将变量值持久化存储，重启后恢复
异常值过滤：
- 合理范围过滤: 启用后，超出[min, max]范围的值将被过滤
- 最小值、最大值：合理范围边界
- 变化幅度过滤: 启用后，变化过大的值将被过滤
- 最大变化幅度：允许的绝对变化值
- 最大变化幅度百分比：允许的变化百分比
- 连续异常过滤: 启用后，连续多次异常值将被接受
- 连续异常最大次数：超过此次数后接受该值
报警配置：
- 报警等级: 报警级别（数值越大越严重）
- 报警延时: 报警触发延时时间（毫秒）
- 布尔报警: 布尔类型变量的开/关报警
- 限值报警: 高报、高高报、低报、低低报
- 各限值阈值和报警文本
- 自定义报警: 自定义报警条件和抑制表达式
寄存器地址格式
不同采集插件的寄存器地址格式各不相同，例如Modbus使用4XXXX格式、S7使用DB1.DBW0格式、DLT645使用数据标识等。详细的地址格式说明请参考 插件参考 - 寄存器地址格式。
变量插件属性
变量配置中可能包含插件特有的属性字段（如Modbus从站的"从站变量地址"、MQTT的"允许RPC写入"等），这些字段由所选插件决定。详细的变量插件属性说明请参考 插件参考。
数据导入导出
系统支持通过Excel文件对通道、设备、变量进行批量导入导出，方便快速配置和备份。
通道导入导出
通过通道设备树的右键菜单操作：
| 操作 | 入口 | 说明 |
|---|---|---|
| 导出当前通道 | 右键菜单 → 导出当前通道 | 导出选中通道及其下属设备和变量到Excel |
| 导出全部通道 | 右键菜单 → 导出全部通道 | 导出所有通道及其下属设备和变量到Excel |
| 导入通道 | 右键菜单 → 导入通道 | 从Excel文件导入通道配置 |
设备导入导出
通过通道设备树的右键菜单操作：
| 操作 | 入口 | 说明 |
|---|---|---|
| 导出当前设备 | 右键菜单 → 导出当前设备 | 导出选中设备及其下属变量到Excel |
| 导出全部设备 | 右键菜单 → 导出全部设备 | 导出所有设备及其下属变量到Excel |
| 导入设备 | 右键菜单 → 导入设备 | 从Excel文件导入设备配置 |
变量导入导出
通过变量列表工具栏操作：
| 操作 | 入口 | 说明 |
|---|---|---|
| 导出当前变量 | 工具栏 → 导出变量 → 导出当前变量 | 导出当前筛选条件下的变量列表到Excel |
| 导出全部变量 | 工具栏 → 导出变量 → 导出全部变量 | 导出所有变量到Excel |
| 导入变量 | 工具栏 → 导入变量 | 从Excel文件导入变量配置 |
导入结果
导入完成后会显示导入结果对话框，包含以下信息：
| 信息 | 说明 |
|---|---|
| 导入状态 | 成功/错误 |
| 表名 | Excel工作表名称 |
| 数据条数 | 导入的数据总条数 |
| 错误详情 | 如有错误，显示具体错误信息 |
提示
- 导入Excel时，系统会自动校验数据格式，校验不通过的数据会显示在导入结果中
- 导出的Excel文件可直接用于导入，格式保持一致
- OPC UA/DA设备还支持通过设备调试界面浏览节点后直接导入变量