¶ 硬件准备
- DTU 网关（ZL-LTE-400）
- USB 数据线
- 485 转 usb 转换器
- 传感器：温湿度光照三合一传感器、二氧化碳传感器、氨气传感器、继电器
¶ 软件准备
注意不要将软件安装到C盘，容易出现问题;
上位机软件包括SD-RTU配置工具DevelopLink SDRTU软件:点我下载
¶ DTU MODBUS 配置
使用 MODBUS 功能前，先对出串口参数，网络通道参数等进行设置。
首先配置串口，再配置网络连接，最后配置ModBus。
因此接下来将对串口、网络连接和ModBus三个配置依次进行演示。
1. 配置串口参数
串口参数的配置需查看传感器说明书，参数应与选择的传感器相对应，不同的传感器参数可能不同。
ZL-LTE-400 485 串口通过串口 1 进行通讯，案例中波特率为 9600bit/s
2. 配置网络连接
网络通道参数配置包含：TCP、UDP、HTTP、MQTT、P2P、OneNET、Aliyun、DevelopLink、TxIOT 等通道类型，不在这里展开，详情请见相关文档，可参考左侧应用教程。
注意数据源要选
自定义1
¶ MODBUS 页面参数 配置说明
- 添加一个读取指令，主要是设置设备ID， 指令读取的寄存器开始地址，读取的寄存器长度；
然后添加一个转换映射
在配置ModBus前，用户可以先大致了解此页面中各个属性的功能说明，例如输入数据源、输入数据源和数据结构。各个属性的功能说明请参考下表。
¶ Modbus 全局配置
| 属性 | 说明 | 必填 |
|---|---|---|
| 读取超时 | 串口数据返回超时，单位秒 | 是 |
| 网络通道 | 通道1-6代表对应的网络通道；不解析代表不对读取到数据解析，上传的数据为原始二进制数组；规则引擎代表手动控制数据；自适应对应从网络通道下面选择modbus实现多路上传 |
是 |
| 数据串口 | 串口1-3，串口4代表USB | 是 |
| 数据结构 | 混合模式或者设备模式，混合模式下所有采集指令键值会组合成一个json对象(键值必须全局唯一):{"a":1,"b":2}；设备模式下每个设备按照ID排序组成json数组(每个指令下键值唯一):[{"i":"id1", "c":"func",v:{"a":1,"b":2}},{"i":"id2", "c":"func",v:{"a":1,"b":2}}] |
是 |
| 写入回复 | 服务端写入新数据到modbus设备后，是否返回结果 | 是 |
| 时间戳 | 将会在数据里面插入为ts的时间戳 |
是 |
| 输出数据源 | MODBUS采集发布后的结果源，如“自定义1”，注意不能与虚拟设备（自定义2）相同 | 是 |
| 输入数据源 | 输入数据的来源，一般为485串口，也可选择网络通道，支持多选 | 是 |
| 小数位数 | 数据小数位保留位数，默认为5位 | 否 |
| 整点对齐 | 启用后，数据按整点时间对齐上报 | 否 |
| 变化容差 | 数据变化超过设定容差时才触发上报，可减少无效数据 | 否 |
| 指令间隔 | 指令1和指令2之间的读取间隔时间，单位为毫秒 | 否 |
| 指令模板 | 可选择预设模板（仅使用特定版本），点击“快速添加”一键配置指令 | 否 |
| 用户参数 | 启用后，在发布的JSON数据中添加用户参数的属性字段 | 否 |
¶ Modbus 指令配置
| 属性 | 说明 | 必填 |
|---|---|---|
| 周期 | 采集指令读取周期，单位秒 | 是 |
| 单独上传 | 勾选后，此采集指令读取成功即上传，会组成单独的json；而其他没有勾选的指令会组成一条json | 是 |
| 变化上传 | 读取的数据和上次比较，发生变化则上传；多条指令有一条发生变化也会上传 | 是 |
| 只写 | 当数据只需要写时，需要设置为只写，支持功能码05、06，此时读取周期无效 |
是 |
| ID | 采集指令，Modbus 设备ID | 是 |
| 功能码 | 采集指令，Modbus 设备功能码，支持1、2、3、4、5、6 | 是 |
| 起始地址 | 采集指令，Modbus 设备寄存器起始地址 | 是 |
| 长度 | 采集指令，Modbus 设备寄存器读写长度，必须包含所有映射中的地址 |
是 |
¶ 数据映射配置
| 属性 | 说明 | 必填 |
|---|---|---|
| 键值 | 数据映射，寄存器键值(别名)，英文字符串，最终JSON结果如{"a":123} |
是 |
| 地址 | 数据映射，寄存器地址，必须包含在采集指令的采集范围中 |
是 |
| 类型 | 数据映射，寄存器值类型，和modbus poll软件格式一致，支持Coils, Short，Unsigned Short，Long，Unsigned Long，Float，Short BCD，Long BCD | 是 |
| 顺序 | 数据映射，寄存器值字节顺序，和modbus poll软件格式一致，支持ABCD， CDAB，BADC，DCBA | 是 |
| 比例 | 数据转换，公式为 y = ax + b，a是比例，例如比例为0.1时，123 → 12.3 |
是 |
| 偏移 | 数据转换，公式为 y = ax + b，b是偏移，例如偏移为2时，12.3 → 14.3 |
是 |
¶ 其它modbus案例教程
| 功能名称 | 功能说明 | 跳转链接 |
|---|---|---|
| 基础 Modbus 配置 | 温湿度光照、CO₂、NH₃ 传感器及继电器等设备的 Modbus 参数配置与数据调试 | 配置 modbus |
| 变化 + 周期上传 | 数据变化超过阈值立即上传，无变化则按周期上传（需固件 sbl ≥ 104） | Modbus 变化加周期传 |
| 数据变化后改变上传周期 | 开发中，待补充 | Modbus 数据变化后改变上传周期 |
| MQTT 写入 Slave | 通过 MQTT 下发 JSON 格式数据，写入 Modbus 从机寄存器 | MQTT 写入 slave |
| Modbus TCP 长连接模式 | 作为 TCP 客户端，连接到 Modbus TCP 从机进行采集 | Modbus TCP 长连接模式 |
| Modbus TCP 短连接模式 | 开发中，待补充 | Modbus TCP 短连接模式 |
| Modbus TCP 转 RTU 透传 | 实现 Modbus TCP 主机与 RTU 从机之间的协议转换与透传 | Modbus TCP 转 RTU 透传 |
4. 配置 MODBUS 参数
接下来是ModBus的配置，在配置ModBus中，请重点注意输入数据源、设备ID、起始地址和读取长度的配置。
以温湿度光照三合一传感器为例:
- 上文其 485 通讯 ID 设为 1，因此这里 ID 对应也设置为 1。
- 监测参数的寄存器地址需要看对应的传感器手册。这里我们可以看到，温度寄存器地址为 8，湿度 9，光照 10。
- 温度数据占一个寄存器，湿度占一个，光照占两个寄存器（设计上考虑了光照 0-20W Lux 需占两位）所以需要读取的寄存器总长度为 4。
- 相应的温湿度数据类型选 Short，光照选 Long。（支持多种寄存器格式，包含 Short，Long，Coils，Float 及字节顺序，和 Modbus Slave 软件一致）
以此类推设置 CO2，NH3 传感器 Modbus 参数，如图
继电器 modbus 参数略有不同，如下图
功能码设为
- 01：读取线圈的状态数值（位操作），DTU 固件中将 01 和 05 功能码相对应（03 和 06 功能码对应）。
- 05 功能码：对单个线圈进行写操作。此处功能码设为 01，即可实现：自动读取，手动写入
写入配置，Modbus 配置完成，DTU 会自动重启。
¶ 数据调试
配置成功后，上电DTU和传感器，可以用上位机连接usb查看日志。
- 数据正常的情况，可以看到下发读取指令后收到正确的传感器回复，下面也打印出了转换后的结果
- 未读取到数据的情况，可以看到此时日志显示读取超时
¶ 常见问题
若配置成功后没有数据，检查如下原因：
- 串口参数是否配置正确：波特率、数据位、校验位、停止位等
- MODBUS 参数是否配置正确：485 通讯地址、功能码、读取地址（长度）、数据类型等
- 键值不能为空，最好不要用数字做开头，也不能用中文
- 键值映射的地址及其长度是否包含指令读取地址加读取长度里面