viSCADA 设备操作手册

面向用户: 项目经理 / 实施工程师 版本: v1.0

设备(Device)是 viSCADA 中实际运行的物联终端实例,每个设备归属于某一个设备类并继承其物模型与通讯模板,或在独立模式下单独维护属性。本手册介绍设备的列表查看、增删改查、启用/禁用、批量与导入导出操作,以及设备详情的四个配置页签(设备信息 / 物模型 / Topics / 历史数据)。

1 整体流程

图 1 设备配置整体流程

ℹ️ 标准模式 vs 独立模式: 标准模式关联设备类、继承其物模型与通讯模板,适合批量接入同类设备;独立模式不关联设备类、在设备级单独维护属性,适合物模型差异较大的场景。优先选择标准模式以提升属性标准化程度。

2 设备列表

进入 「设备管控」 → 「设备」 菜单,系统展示当前平台下已创建的所有设备。

图 2 设备列表

2.1 列表字段

⚠️ 设备所关联的设备类未配置 「标准化名称」 时,采集的数据不会推送到 Kafka。

2.2 搜索过滤

设备列表支持多维度筛选,便于在数量较多时快速定位目标设备。

操作步骤:

1. 在列表上方搜索区输入关键词或选择筛选条件。
2. 点击 「确定」 执行查询;点击 「重置」 清除筛选条件。

2.3 行级操作

2.4 顶部工具栏与批量操作

操作步骤:

1. 在列表最左侧勾选目标设备(批量操作前置条件)。
2. 点击顶部对应按钮执行操作。
3. 在确认弹窗中点击 「确认」 完成。

2.5 列显示与布局

2.5.1 自定义显示字段

平台中凡是带有 「显示」 按钮的页面均支持自定义勾选展示字段。

操作步骤:

1. 点击列表右上角的 「显示」 按钮。
2. 在弹出面板中勾选需要展示的字段,取消勾选则隐藏。
3. 点击 「确认」 保存配置。

2.5.2 列固定与样式

3 新增设备

在设备列表点击 「+ 新增设备」 按钮,弹出 「新增设备」 对话框。窗口顶部 「关联设备类」 开关决定本次创建走 标准模式 还是 独立模式。

3.1 标准模式

关联一个设备类,设备继承该设备类的物模型属性,同时支持在设备级追加私有属性,适用于批量接入同类设备的场景。

图 3 新增标准设备弹窗

3.1.1 字段说明

3.1.2 操作步骤

1. 在设备列表点击 「+ 新增设备」 按钮,弹出 「新增设备」 窗口。
2. 确认顶部 「关联设备类」 开关处于开启状态(标准模式)。
3. 依次填写 「设备标识」、「设备名称」、「标准化名称」,选择 「设备类」、「通讯类型」、「通讯协议」、「位置信息」、「部门信息」。设备标识建议使用”业务编码 + 序号”的方式命名(如 MOT-005、FAN-010),便于后期排查。
4. 点击 「确定」 完成创建;点击 「取消」 放弃创建。

3.2 独立模式

不关联设备类,直接在设备上创建和管理属性,适用于设备物模型差异较大或没有合适设备类可复用的场景。详细说明参考独立设备配置示例 。

图 4 新增独立设备弹窗

3.2.1 字段说明

3.2.2 操作步骤

1. 在设备列表点击 「+ 新增设备」 按钮。
2. 将顶部 「关联设备类」 开关关闭,切换至独立模式。
3. 依次填写设备标识、设备名称、标准化名称、设备类标准化名称、设备类时间格式、设备类 jsonQuery、通讯类型、通讯协议、位置信息、部门信息等字段。
4. 点击 「确定」 完成创建。

⚠️ 独立模式下,物模型属性需在设备的 「物模型」 页签中单独维护,与其他设备无法共享。

4 编辑设备

在设备列表中点击 「编辑」 按钮,可对已有设备的基础信息进行修改。

图 5 编辑设备弹窗

4.1 可编辑字段

4.2 操作步骤

1. 在设备列表中找到目标设备,点击 「编辑」 按钮,弹出编辑窗口。
2. 系统自动回填当前设备的配置信息,根据需要修改可编辑字段。
3. 点击 「确定」 提交修改,系统自动更新设备信息并刷新 「最近更新时间」。

⚠️ 「设备 ID」 与 「设备标识」 创建后不可修改;修改 「标准化名称」 后须同步更新上位平台的对接配置,否则数据会丢失。

5 启用 / 禁用设备

在设备列表 「启用状态」 列点击开关切换设备的启用状态。设备被禁用后,平台停止向其下发新的配置和任务,可有效避免异常配置或网络问题导致的连锁故障。

5.1 适用场景

当设备出现以下异常时,可通过禁用暂停相关任务或配置继续执行:

• 设备因网络异常导致配置下发失败
• 设备离线状态下接收到配置后出现容器启动异常(典型如 S7 设备离线后,平台仍向其下发配置,导致设备恢复后容器启动异常)

图 6 S7 设备离线下发配置异常示例

5.2 操作步骤

1. 进入 「设备管控」 → 「设备」,通过筛选或搜索定位目标设备。
2. 在 「启用状态」 列点击开关,切换为禁用状态。
3. 在弹出的确认弹窗中点击 「确定」 完成禁用。

图 7 设备禁用操作入口

💡 重新启用前先检查最近一次配置下发记录,确认无残留异常配置,再切换 「启用状态」 开关恢复设备。

6 删除设备

图 8 删除设备入口

6.1 操作步骤

1. 在设备列表中找到需要删除的设备。

2. 在目标行的 「操作」 列点击 「删除」 按钮。

3. 在弹出的二次确认中点击 「确定」 完成删除。

   

   图 9 删除成功提示

6.2 批量删除

1. 在列表最左侧勾选需要删除的多条设备。
2. 点击顶部 「批量删除」 按钮。
3. 在确认弹窗中点击 「确认」 完成批量删除。

⚠️ 设备删除后其关联配置和历史数据可能一并清除,且不可恢复。删除前确认该设备未被任何规则、看板、告警策略引用。

7 设备详情配置

在设备列表的 「操作」 列点击 「详情」 进入设备详情页。详情页提供 「设备信息」、「物模型」、「Topics」、「历史数据」 四个页签。

图 10 设备详情页

7.1 设备信息

「设备信息」 页签展示设备的基础信息与技术参数,并支持参数验证。

7.1.1 基础信息

操作步骤:点击 「基础信息」 旁的 「编辑」 按钮,修改可编辑字段后保存。

7.1.2 技术参数

技术参数用于配置设备与平台之间的连接参数,字段随通讯协议不同而不同。配置位置依协议而异:

以 MODBUS 协议为例:

操作步骤:

1. 在设备详情页切换到 「设备信息」 页签。
2. 点击 「技术参数」 旁的 「编辑」 按钮进入编辑状态。
3. 根据协议类型填写各参数值,必填字段标有红色星号。
4. 如需添加自定义参数,点击 「+ 新增项」。
5. 点击 「保存」 完成。点击 「查看通用参数」 可展开查看协议的通用参数。

7.1.3 参数验证

参数验证用于测试当前连接参数是否正确。验证通过后方可成功读取设备点位。详细操作说明参考参数验证操作示例 。

操作步骤:

1. 在 「技术参数」 区域点击 「参数验证」 按钮。
2. 系统按当前参数尝试连接设备并读取点位。
3. 页面展示验证结果。连接成功可继续配置物模型;连接失败按错误提示调整参数后重试。

⚠️ 修改技术参数后立即执行一次参数验证,避免参数错误导致数据采集中断而未被及时发现。

7.2 物模型

「物模型」 页签用于管理设备的属性集合,是设备数据采集与控制下发的核心配置。属性的详细编辑说明参考物模型属性编辑 。

图 11 物模型属性列表

7.2.1 属性字段说明

⚠️ 「属性标识」 一旦确定不建议修改,否则会影响历史数据查询与上位对接。

7.2.2 公式示例

• 数据上报公式:MODBUS 采集到寄存器值 230,需显示为 23.0 ℃,公式写为 ${m_002t} / 10。
• 控制下发公式:若上报公式为 ${value} / 10,用户下发 23.0,则下发公式为 ${value} * 10,设备实际收到 230。

7.2.3 添加属性

1. 在物模型页左上角点击 「+ 添加属性」 按钮,弹出添加属性窗口。
2. 依次填写 「属性标识」、「属性名称」、「标准化名称」、「单位标识」、「数据类型」、「读写模式」、「数据上报公式」、「控制下发公式」 等字段。
3. 配置 「排序基准对象」 和 「排序方式」(之前 / 之后 / 默认)。
4. 点击 「确认保存并同步」 完成新增。

7.2.4 编辑属性

图 12 编辑属性弹窗

操作步骤:

1. 在属性列表 「操作」 列点击 「编辑」,弹出 「编辑属性」 窗口。
2. 窗口自动回填当前属性的配置,根据需要修改属性名称、标准化名称、单位标识、数据类型、读写模式等字段。
3. 点击 「确认保存并同步」 完成编辑。

⚠️ 当前属性若被设备类下多个设备共用,修改将同步到该设备类下的所有设备(页面顶部会给出明确提示);若属性同时被多个模板使用,修改也会同步到其他模板下的此属性。

7.2.5 删除属性

1. 在属性列表 「操作」 列点击 「删除」。
2. 在弹出的二次确认中点击 「确定」 完成删除。

⚠️ 属性删除将影响历史数据的展示和查询。

7.2.6 数据上报开关

「数据上报」 开关用于控制该属性的数据是否推送至 Kafka:

• 「启动」:将该属性的数据上报至 Kafka(开关蓝色)。
• 「禁止」:不将该属性的数据上报至 Kafka(开关灰色)。

操作步骤:在属性列表 「数据上报」 列找到目标属性,点击开关切换状态。

7.2.7 控制下发

控制下发用于向设备发送控制指令,仅对 「读写」 模式的属性可用。

操作步骤:

1. 在属性列表 「操作」 列点击 「控制下发」。
2. 在弹出的下发窗口中输入目标值。
3. 确认后下发指令,系统返回执行结果。

⚠️ 对危险操作(如断路器合分闸、水泵启停)下发前二次确认目标值,避免误操作引发现场事故。

7.3 Topics

「Topics」 页签展示设备对应的消息上下行通道,通常用于 MQTT 等基于主题的消息协议,随设备创建自动生成,一般无需手动修改。

7.4 历史数据

「历史数据」 页签用于查询设备各属性在指定时间段内的变化记录,支持时间范围筛选、降采样、字段过滤及 Excel 导入导出。

7.4.1 查询时间范围

图 13 时间范围选择器

操作步骤:

1. 在历史数据页点击顶部的时间输入框,弹出时间选择器。
2. 左侧提供 「最近 5 分钟」、「最近 10 分钟」、「最近 30 分钟」、「最近 1 小时」、「今天」、「最近 3 天」、「最近 7 天」 等快捷选项,点击即可快速选择。
3. 也可通过日历分别选择开始时间和结束时间,支持精确到秒。
4. 选择完成后点击 「确定」 应用;点击 「清空」 清除时间。
5. 返回历史数据页后点击 「确定」 按钮,按所选时间范围查询数据。

7.4.2 降采样粒度

降采样用于控制数据的聚合粒度,便于在较大时间范围下查看趋势,避免一次性加载过多原始点。

图 14 降采样粒度选择

操作步骤:

1. 在历史数据页点击 「降采样粒度」 下拉框。
2. 选择需要的粒度。
3. 点击 「确定」 按钮重新加载数据。

💡 查询跨度超过 1 天时优先选择 「分钟」 或 「小时」 粒度;查询跨度在数分钟内时使用 「无」 粒度查看原始数据。

7.4.3 字段查询

字段查询用于筛选历史数据列表展示的属性字段,避免一次展示过多字段影响阅读。

图 15 字段查询弹窗

操作步骤:

1. 在历史数据页点击 「字段查询」 按钮,弹出字段查询窗口。
2. 在 「查询方式」 处选择查询模式:「现有物模型查询」 / 「自定义字段查询」。
3. 在左侧 「待选列表」 中勾选需要展示的字段,点击 「→」 按钮移入右侧 「已选列表」;点击 「←」 按钮可将字段从已选中移回。
4. 列表较长时可在搜索框中输入关键字快速过滤,并通过底部分页切换。
5. 选择完成后点击 「确定」,列表仅展示已选字段。

7.4.4 导入导出

导入导出支持以 Excel 表格形式批量导入数据或导出当前查询结果,便于线下分析与数据归档。

图 16 导入导出入口

操作步骤:

1. 在历史数据页右上角找到 「导入」、「导出」、「下载模板」 等图标按钮。
2. 点击 「导出」 将当前查询结果导出为 Excel 文件。
3. 点击 「下载模板」 获取标准导入模板。
4. 点击 「导入」,选择按模板填写好的 Excel 文件完成数据导入。

⚠️ 导入 Excel 时严格按照下载模板的格式填写,字段顺序、列名不可改动,否则导入失败。

7.4.5 数据刷新

图 17 数据刷新按钮

操作步骤:在历史数据页右上角点击 「刷新」 图标,系统按当前时间范围、降采样粒度和字段筛选条件重新加载数据。

8 常见问题