面向用户: 实施工程师 / 项目经理

本文档用于指导实施与测试人员完成 viSCADA 平台标准协议与自定义协议的参数配置、连接验证与数据采集校验。文档以 Modbus TCP(标准协议)与 MySQL 数据库(自定义协议)为例,给出通用验证流程、判定标准、典型配置样例与异常处理建议,确保设备接入前置验证环节有据可依。

1 文档基础信息

2 验证范围与判定标准

2.1 本次验证范围

2.2 通用判定标准

所有协议的验证过程统一按以下 5 项标准进行结果判定:

1. 参数配置正确:协议核心参数必填项填写完整,且格式符合规范。
2. 连接建立成功:目标设备、服务端或数据库能够正常建立网络连接。
3. 数据采集成功:采集任务可正常下发与执行,无报错或超时现象。
4. 采集结果准确:平台采集到的数据值与源端设备/系统的数据保持一致。
5. 验证结论明确:最终能输出清晰的「通过」「待验证」或「异常」结论。

2.3 结论分级定义

3 通用验证流程

所有协议的验证工作均遵循以下标准流程执行。该流程适用于所有协议类型,各协议的具体差异仅体现在「参数配置」环节。

图 1 协议验证通用流程

4 协议验证实例

本章基于第 3 章的通用流程,给出两类协议的具体验证实例。Modbus TCP 代表标准协议,MySQL 代表自定义协议(通过 YAML 脚本定义)。

4.1 Modbus TCP(标准协议)

4.1.1 参数配置

操作路径:设备管控 → 设备类 → 属性 → 技术参数编辑

设备元信息:

协议核心参数:

表 1 Modbus 核心参数配置

ℹ️ 上表仅列出本次验证必填的核心参数。完整的 Modbus 技术参数(如字节序、寄存器最大读取长度等)可在「技术参数」页的**「查看通用参数」**中展开查看。

图 2 Modbus 协议参数配置界面

4.1.2 连接与采集验证

连接验证:

图 3 Modbus 设备网络连接验证结果

点位采集:

图 4 Modbus 设备点位数据采集结果

4.1.3 验证结果

最终结论:通过

Modbus 协议参数配置正确,设备网络连接正常,各项数据采集结果均符合预期,满足本次验证要求。

图 5 Modbus 采集数据列表

图 6 Modbus 采集数据与源端核对

4.2 MySQL 数据库(自定义协议)

4.2.1 参数配置

自定义协议通过 YAML 脚本定义采集行为,并在设备类的技术参数中录入连接信息。

(1) YAML 脚本配置

在「协议管理」页新增或编辑 YAML 脚本,定义 SQL 查询语句、字段映射等采集逻辑。

图 7 自定义协议(YAML)脚本配置界面

(2) 设备核心参数

在设备类的「技术参数编辑」模块录入数据库连接信息:

表 2 MySQL 核心参数配置

图 8 数据库设备参数录入界面

4.2.2 连接与采集验证

连接校验:

图 9 数据库连接校验结果

数据采集:

图 10 数据库表数据采集结果

4.2.3 验证结果

最终结论:通过

MySQL 自定义协议配置正确,数据库连接稳定,采集数据与源端一致,满足本次验证要求。

5 异常处理机制

在协议验证过程中如遇报错或数据异常,请参照本章流程与建议进行排查。

5.1 异常排查标准流程

图 11 异常排查标准流程

排查顺序按「网络连通 → 参数配置 → 采集脚本 → 源端数据」的链路逐层推进,避免跳过基础层直接排查应用层问题。

5.2 常见异常与处理建议

💡 建议:每次排查完成后记录异常现象、根因与解决方式,便于同类问题复用经验,也为后续协议扩展验证(S7、OPC UA、API、MQTT、Kafka)提供参考数据。