边缘智能
边缘智能
- Documentation
边缘智能边缘智能平台用户指南设备管理驱动模板官方驱动使用官方 Modbus 驱动
Copy page
Download PDFCopy pageDownload PDFModbus 驱动是边缘智能提供的内置驱动，支持标准 Modbus TCP、Modbus RTU 和 Modbus-ASCII 协议。
本文介绍了如何部署 Modbus 驱动并接入设备。
Modbus 驱动介绍
查看 Modbus 驱动
您可以在边缘智能控制台的 设备管理 > 驱动模板 页面，查看 Modbus驱动。
子协议配置
Modbus 驱动的子协议配置说明请见下表。
配置项 | 参数名称 | 说明 |
|---|---|---|
modbus-tcp | IP 地址 | 目标设备的 IP 地址，用于指定 Modbus 设备的通信地址 |
端口号 | Modbus TCP 通信的端口号，取值范围为 1-65535。 | |
主站地址 | Modbus 从设备地址，用于标识目标设备。 | |
超时时间 | 设置 Modbus 请求的超时时间（单位为秒）。在节点发出请求后，如果在该时间内没有收到设备的响应，则认为请求超时。默认值为 3。 | |
空闲超时时间 | 在设定的空闲时间（单位为秒）内无数据传输时，将自动断开连接。默认为 0，表示禁用空闲超时。 | |
报文聚合 | 决定是否启用报文聚合。启用后，客户端会尝试合并多个报文请求，以减少请求次数，从而提高通信效率。默认为 false。 | |
modbus-rtu、 | 串口号 | 指定用于通信的串口，用于连接 Modbus 设备的物理串口。 |
波特率 | 数据传输速度，单位为 bps，默认值为 9600。 | |
数据位 | 每个数据包中的数据位数。默认为 8 位。 | |
校验位 | 用于检测数据传输过程中是否发生错误的位。可选值包括：无校验、偶校验和奇校验。默认为无校验。 | |
停止位 | 用于指示每个字符的结束。默认值为 2。 | |
主站地址 | Modbus 从设备地址，用于标识从设备。 | |
超时时间 | Modbus 请求的超时时间（单位为秒）。默认值为 3。在节点发出请求后，如果在该时间内没有收到响应，则认为请求超时。 | |
空闲超时时间 | 空闲时间的超时时间（单位为秒）。在设定时间内无数据传输时将自动断开连接。默认为 0 ，表示禁用空闲超时。 | |
报文聚合 | 决定是否启用报文聚合。启用后，客户端会尝试将多个请求合并为一个报文，以减少请求次数，提高效率。默认为 false。 |
点表配置
Modbus 驱动的点表配置说明请见下表。
参数 | 说明 |
|---|---|
操作类型 | Modbus 协议中的不同功能码：
|
起始地址 | 数据点的起始地址，线圈地址或者寄存器起始地址。 |
原始数据类型 | 原始数据的类型：
|
交换寄存器内高低字节 | 是否把寄存器内 16 位数据的前后 8 个 bits 互换。 |
交换寄存器顺序 | 是否把原始数据 32 位数据的 bits 互换。 |
采样周期 | 节点采集设备数据的频率。单位：毫秒。默认值：10000。 |
变化上报 | 用于控制节点进行数据上报的触发条件。
默认值：true。 |
缩放因子 | 表示对原始数据放大的倍数。 tip 当缩放因子为小数时，对应物模型属性的数据类型需是 float 或者 double 才可以生效。 |
准备工作
使用 Modbus 驱动前，您需要准备一台边缘智能节点，并完成以下工作：
使用限制
限制名称 | 限制数量 |
|---|---|
账户中部署总次数 | 无 |
项目中部署总次数 | 无 |
节点中部署次数 | ≤1 |
最大接入设备实例数 | 无 |
每个设备实例中最大的属性点数量 | 1000 |
操作步骤
步骤一：创建设备模板
登录边缘智能控制台。
在左侧导航栏，从 我的项目 下拉列表选择一个项目。
- 在左侧导航栏，选择 设备管理 > 设备模板。
- 在 设备模板 页面，单击 创建设备模板。
- 在 创建设备模板 对话框，输入模板 名称 和 描述，并选择 设备类型 为 其他设备。
- 单击 确定。
新建的设备模板将展示在设备模板列表中。
步骤二：添加物模型
在设备模板列表中，单击创建的设备模板名称，进入设备模板详情。
单击 物模型定义 页签。
单击 编辑。
在 编辑物模型 页面左侧，可以看到 模块列表。
您可以选择系统自动创建的 默认模块（default） ，或者根据需要单击 新建模块，创建新的模块。
在 新建模块 对话框，参照以下说明配置相关参数，单击 确定，然后单击已添加模块名称。配置项
说明
名称
为模块设置一个名称。输入要求如下：
- 允许使用以下字符：汉字、英文大小写字母、数字、下划线（_）。长度不超过 32 个字符。
- 开头和结尾不允许使用下划线（_），并且不允许使用连续的下划线（_）
唯一标识
为模块设置一个标识符。该标识符在当前设备模板下必须唯一。输入要求如下：
- 允许使用以下字符：英文大小写字母、数字、下划线（_）。长度不超过 32 个字符。
- 开头和结尾不允许使用下划线（_），并且不允许使用连续的下划线（_）。
描述
为模块添加描述信息。长度不超过 128 个字符。
单击 添加自定义功能。
在 添加自定义功能 对话框，根据 Modbus 设备的实际功能和数据点，添加所需功能，并单击 确定。相关参数说明，请参见添加自定义功能。
以下是一个结合 Modbus 设备实际情况的自定义功能示例，例如：读取Modbus设备中的温度传感器数据，返回当前温度值。配置项
说明
功能类型
选择 属性。
功能名称
为功能设置一个名称，例如”温度读取“。
标识符
为功能设置一个标识符。例如”tempRead“。
读写类型
选择 只读。
数据类型
选择 float。
取值范围
设置数值取值范围。本教程中保持默认配置。
步长
设置数值步长。本教程中保持默认配置。
描述
为功能添加描述信息。
单击页面右下角的 保存。
在 发布新版本 对话框，为版本设置 版本号 和 描述，然后单击 确定。
步骤三：创建点表
单击 点表 页签，然后单击 创建点表。
在 创建点表 页面，完成以下配置，并单击 确认。
类别
配置项
说明
基本信息
名称
为点表设置一个名称。
本教程中使用 device-virtual-dp 作为点表名称。
驱动模板
选择 Modbus驱动。
配置信息
物模型中定义的属性
- 操作类型：选择 Modbus 操作类型，这里选择保持寄存器（0x03）。
- 起始地址：指定 Modbus 设备中温度数据的起始地址。
- 原始数据类型：指定从 Modbus 设备读取的数据类型。这里选择 Int16。
- 交换寄存器内高低字节：false
- 交换寄存器顺序：false
- 采样周期：10000 毫秒
- 变化上报：true
- 缩放因子：1
步骤四：部署 Modbus 驱动
- 在左侧导航栏，单击 节点管理。
- 在 节点管理 页面，找到要部署 Modbus 驱动的节点，单击节点名称。
- 单击 设备接入 页签。
- 根据节点上是否部署过驱动实例，执行相应操作：
- 如果节点上未部署驱动，单击页面提示信息中的 立即部署。
- 如果节点上部署了驱动，请检查 驱动实例 列表是否包含 Modbus驱动。
- 如果 Modbus驱动 包含在列表中，您可跳过本步骤，直接前往步骤五：添加设备。
- 如果 Modbus驱动 没有包含在列表中，单击 驱动实例 列表右上方的 新建驱动实例。
- 如果节点上未部署驱动，单击页面提示信息中的 立即部署。
- 在 新建驱动实例 对话框，选择 Modbus驱动 的最新版本，然后单击 确定。
提交部署请求后，系统将在节点上部署 Modbus驱动。部署过程涉及到数据传输。根据现场网络环境不同，部署所需时间不同。请确保您的节点在线，并耐心等待部署完成。
驱动部署成功后，对应的 驱动实例状态 将变为 运行中。
步骤五：添加设备
单击已部署的 Modbus驱动，然后单击 添加设备。
在 添加设备 面板，参照以下说明设置设备参数，然后单击确定。
配置项
描述
名称
为设备设置一个名称。
标识符
为设备设置一个标识符。
设备模板
选择在步骤一：创建设备模板中创建的设备模板。
点表
选择在点表配置中创建的点表。
子协议名称
选择一种子协议：
- modbus-tcp
- modbus-rtu
- modbus-ascii
子协议配置
根据选择的子协议，完成对应参数配置。具体内容，请参见子协议配置。
标签
为设备添加标签。如果需要创建新的标签，输入 key 和 value 后，单击 创建标签。
描述
为设备添加描述信息。
完成以上操作后，您可以在设备列表查看新添加的设备。最初，设备的 状态 为 添加中。当设备的状态变为 在线 后，表示设备已经添加成功。
步骤六（可选）：复制设备到其他节点
您可以将当前已接入节点的设备复制到同项目的不同节点上。
- 在设备列表中，选择需要复制的设备。
- 单击 复制到节点。
- 在 复制到节点 对话框中，完成以下配置，并单击 确定。
- 已选设备：需要复制的设备。
- 目标节点：选择要将设备复制到的节点。
tip
目标节点需要部署 Modbus 驱动，并且驱动实例的状态为运行中。
- 完成设备复制后，您可以前往目标节点的设备接入页面。在 Modbus 驱动下，您可以看到复制过来的新设备。这些设备相关配置与源设备一致，设备标识符为系统自动生成。
