二次开发协议
功能码介绍
| 功能码 | 备注 |
|---|---|
| 03 | 读取保持寄存器 |
| 06 | 写单个保持寄存器 |
| 10 | 写多个保持寄存器 |
寄存器地址介绍
| 地址 (HEX) | 地址存储内容 | 寄存器取值 | 权限 | Modbus 功能码 |
|---|---|---|---|---|
| 4x0000 4x0001 | 通道 1 频率高 16 位 通道 1 频率低 16 位 | 数值为无符号 32 进制,单位 0.01 Hz,范围:100~20000000,即 1 Hz~200 kHz | 读/写 | 0x03,0x06,0x10 |
| 4x0002 | 通道 1 占空比 | 数值为无符号 16 进制,单位 0.01%,范围 0~1000,即 0~100% | 读/写 | 0x03,0x06,0x10 |
| 4x0003 4x0004 | 通道 2 频率高 16 位 通道 2 频率低 16 位 | 数值为无符号 32 进制,单位 0.01 Hz,范围:100~20000000,即 1 Hz~200 kHz | 读/写 | 0x03,0x06,0x10 |
| 4x0005 | 通道 2 占空比 | 数值为无符号 16 进制,单位 0.01%,范围 0~1000,即 0~100% | 读/写 | 0x03,0x06,0x10 |
| 4x0006 4x0007 | 通道 3 频率高 16 位 通道 3 频率低 16 位 | 数值为无符号 32 进制,单位 0.01 Hz,范围:100~20000000,即 1 Hz~200 kHz | 读/写 | 0x03,0x06,0x10 |
| 4x0008 | 通道 3 占空比 | 数值为无符号 16 进制,单位 0.01%,范围 0~1000,即 0~100% | 读/写 | 0x03,0x06,0x10 |
| 4x0009 4x000A | 通道 4 频率高 16 位 通道 4 频率低 16 位 | 数值为无符号 32 进制,单位 0.01 Hz,范围:100~20000000,即 1 Hz~200 kHz | 读/写 | 0x03,0x06,0x10 |
| 4x000B | 通道 4 占空比 | 数值为无符号 16 进制,单位 0.01%,范围 0~1000,即 0~100% | 读/写 | 0x03,0x06,0x10 |
| 4x2000 | 串口参数 | 高八位为校验方式:0x00~0x02 低八位为波特率方式:0x00~0x07 | 读/写 | 0x03,0x06 |
| 4x4000 | 设备地址 | 直接存储 Modbus 地址 设备地址:0x0001-0x00FF | 读/写 | 0x03,0x06 |
| 4x8000 | 软件版本 | 转为十进制然后小数点左移两位即表示软件版本 0x0064 = 100 = V1.00 | 读 | 0x03 |
- 注意:频率设置推荐使用 10 功能码多寄存器同时设置,使用 06 功能码操作单个寄存器可能会输出未知频率。
操作指令介绍
设置通道输出指令
发送码:01 10 00 00 00 03 06 00 01 86 A0 13 88 FF 7C
| 字段 | 含义 | 备注 |
|---|---|---|
| 01 | 设备地址 | 0x00 表示广播地址;0x01-0xFF 表示设备地址 |
| 10 | 写多寄存器指令 | |
| 00 00 | 寄存器起始地址 | 通道起始寄存器 |
| 00 03 | 寄存器数量 | 设置寄存器数量 |
| 06 | 字节数量 | 设置输出字节数 |
| 00 01 86 A0 13 88 | 寄存器数据 频率高 16 位 频率低 16 位 占空比 | 频率为无符号 32 进制,单位 0.01 Hz,范围:100~20000000,即 1 Hz~200 kHz 占空比为无符号 16 进制,单位 0.01%,范围 0~1000,即 0~100% |
| FF 7C | CRC16 | 前 6 字节数据的 CRC16 校验和 |
返回码: 01 10 00 00 00 03 80 08
| 字段 | 含义 | 备注 |
|---|---|---|
| 01 | 设备地址 | 0x00 表示广播地址;0x01-0xFF 表示设备地址 |
| 10 | 写多寄存器指令 | |
| 00 00 | 寄存器起始地址 | 0x0000 - 0x0007 对应 1~8 输出通道 |
| 00 03 | 寄存器数量 | 设置寄存器数量,不能超过最大通道数量 |
| 80 08 | CRC16 | 前 6 字节数据的 CRC16 校验和 |
示例:[1 号地址设备]
设置 2 通道输出 200 Hz 10%占空比 : 01 10 00 00 00 03 06 00 00 4E 20 03 E8 F0 DC
设置 1\~4 通道输出 1 kHz 50%占空比 : 01 10 00 00 00 0C 18 00 01 86 A0 13 88 00 01 86 A0 13 88 00 01 86 A0 13 88 00 01 86 A0 13 88 6E E5
设置通道频率指令
发送码:01 10 00 00 00 02 04 00 01 86 A0 C0 77
| 字段 | 含义 | 备注 |
|---|---|---|
| 01 | 设备地址 | 0x00 表示广播地址;0x01-0xFF 表示设备地址 |
| 10 | 写多寄存器指令 | |
| 00 00 | 寄存器起始地址 | 通道起始寄存器,00 00 表示通道 1 起始寄存器 |
| 00 02 | 寄存器数量 | 设置寄存器数量,数值为无符号 32 进制,单个寄存器 16 位 |
| 02 | 字节数量 | 设置输出字节数 |
| 00 01 86 A0 | 寄存器数据 频率高 16 位 频率低 16 位 | 频率为无符号 32 进制,单位 0.01 Hz,范围:100~20000000,即 1 Hz~200 kHz |
| C0 77 | CRC16 | 前 6 字节数据的 CRC16 校验和 |
返回码: 01 10 00 00 00 02 41 C8
| 字段 | 含义 | 备注 |
|---|---|---|
| 01 | 设备地址 | 0x00 表示广播地址;0x01-0xFF 表示设备地址 |
| 10 | 写多寄存器指令 | |
| 00 00 | 寄存器起始地址 | 0x0000 - 0x0007 对应 1~8 输出通道 |
| 00 02 | 寄存器数量 | 设置寄存器数量,不能超过最大通道数量 |
| 41 C8 | CRC16 | 前 6 字节数据的 CRC16 校验和 |
示例:[1 号地址设备]
设置 2 通道输出 200 Hz : 01 10 00 00 00 02 04 00 00 4E 20 C7 D7
设置通道占空比指令
发送码:01 06 00 02 07 D0 2B A6
| 字段 | 含义 | 备注 |
|---|---|---|
| 01 | 设备地址 | 0x00 表示广播地址;0x01-0xFF 表示设备地址 |
| 06 | 06 指令 | 写单个保持寄存器 |
| 00 02 | 寄存器地址 | 通道 1 占空比寄存器 |
| 07 D0 | 寄存器数据 | 占空比为无符号 16 进制,单位 0.01%,范围 0~1000,即 0~100% |
| 2B A6 | CRC16 | 前 6 字节数据的 CRC16 校验和 |
返回码:01 06 00 02 07 D0 2B A6
| 字段 | 含义 | 备注 |
|---|---|---|
| 01 | 设备地址 | 0x00 表示广播地址;0x01-0xFF 表示设备地址 |
| 06 | 06 指令 | 写单个保持寄存器 |
| 00 02 | 寄存器地址 | 通道占空比寄存器 |
| 07 D0 | 寄存器数据 | 占空比为无符号 16 进制,单位 0.01%,范围 0~1000,即 0~100% |
| 2B A6 | CRC16 | 前 6 字节数据的 CRC16 校验和 |
示例:[1 号地址设备]
设置 1 通道占空比 20% : 01 06 00 02 07 D0 2B A6
设置 2 通道占空比 50% : 01 06 00 05 13 88 94 9D
设置 4 通道占空比 20% : 01 06 00 0B 23 28 E1 26
读取通道输出指令
发送码:01 03 00 00 00 0C 45 CF
| 字段 | 含义 | 备注 |
|---|---|---|
| 01 | 设备地址 | 0x00 表示广播地址;0x01-0xFF 表示设备地址 |
| 03 | 03 指令 | 读取保持寄存器 |
| 00 00 | 寄存器起始地址 | 0x0000 - 0x0007 对应 1~8 输入通道 |
| 00 0C | 寄存器数量 | 读取寄存器数量,不能超过最大通道数量 |
| 45 CF | CRC16 | 前 6 字节数据的 CRC16 校验和 |
返回码:01 03 18 00 01 86 A0 13 88 00 01 86 A0 13 88 00 01 86 A0 13 88 00 01 86 A0 13 88 90 CE
| 字段 | 含义 | 备注 |
|---|---|---|
| 01 | 设备地址 | 0x00 表示广播地址;0x01-0xFF 表示设备地址 |
| 03 | 03 指令 | 读保持寄存器 |
| 18 | 字节数 | 返回状态信息的所有字节数 |
| 00 01 86 A0 13 88 …… | 输出数值 | 依次为 1~4 通道频率和占空比 频率为无符号 32 进制,单位 0.01 Hz,范围:100~20000000,即 1 Hz~200 kHz 占空比为无符号 16 进制,单位 0.01%,范围 0~1000,即 0~100% |
| 90 CE | CRC16 | 前 6 字节数据的 CRC16 校验和 |
示例:[1 号地址设备]
读取 1 通道数据 : 01 03 00 00 00 03 05 CB
读取 1 通道占空比 : 01 03 00 02 00 01 25 CA
读取 3 通道数据 : 01 03 00 06 00 03 E5 CA
设置波特率指令
发送码:00 06 20 00 00 05 43 D8
| 字段 | 含义 | 备注 |
|---|---|---|
| 00 | 设备地址 | 0x00 表示广播地址;0x01-0xFF 表示设备地址 |
| 06 | 06 指令 | 设置波特率,设置设备地址 |
| 20 00 | 指令寄存器 | 0x2000 为设置波特率,0x4000 为设置设备地址 |
| 00 | 校验方式 | 0x00 为无校验,0x01 为偶校验,0x02 为奇校验 |
| 05 | 波特率数值 | 波特率数值对应 0x00: 4800 0x01: 9600 0x02: 19200 0x03: 38400 0x04: 57600 0x05: 115200 0x06: 128000 0x07: 256000 |
| 43 D8 | CRC16 | 前 6 字节数据的 CRC16 校验和 |
返回码:00 06 20 00 00 05 43 D8
| 字段 | 含义 | 备注 |
|---|---|---|
| 00 | 设备地址 | 0x00 表示广播地址;0x01-0xFF 表示设备地址 |
| 06 | 06 指令 | 设置波特率,设置设备地址 |
| 20 00 | 指令寄存器 | 0x2000 为设置波特率,0x4000 为设置设备地址 |
| 00 | 校验方式 | 0x00 为无校验,0x01 为奇校验,0x02 为偶校验 |
| 05 | 波特率 | 波特率数值对应 0x00: 4800 0x01: 9600 0x02: 19200 0x03: 38400 0x04: 57600 0x05: 115200 0x06: 128000 0x07: 256000 |
| 43 D8 | CRC16 | 前 6 字节数据的 CRC16 校验和 |
示例:[1 号地址设备]
设置波特率 4800 :00 06 20 00 00 00 83 DB
设置波特率 9600 :00 06 20 00 00 01 42 1B
设置波特率 115200 :00 06 20 00 00 05 43 D8
设置设备地址指令
发送码:00 06 40 00 00 01 5C 1B
| 字段 | 含义 | 备注 |
|---|---|---|
| 00 | 设备地址 | 0x00 表示广播地址;0x01-0xFF 表示设备地址 |
| 06 | 06 指令 | 设置波特率,设置设备地址 |
| 40 00 | 指令寄存器 | 0x2000 为设置波特率,0x4000 为设置设备地址 |
| 00 01 | 设备地址 | 设置的设备地址,0x0001-0x00FF |
| 5C 1B | CRC16 | 前 6 字节数据的 CRC16 校验和 |
返回码:00 06 40 00 00 01 5C 1B
| 字段 | 含义 | 备注 |
|---|---|---|
| 00 | 设备地址 | 0x00 表示广播地址;0x01-0xFF 表示设备地址 |
| 06 | 06 指令 | 设置波特率,设置设备地址 |
| 40 00 | 指令寄存器 | 0x2000 为设置波特率,0x4000 为设置设备地址 |
| 00 01 | 设备地址 | 设置的设备地址,0x0001-0x00FF |
| 5C 1B | CRC16 | 前 6 字节数据的 CRC16 校验和 |
示例 [1 号地址设备]:
设置设备地址为 0x01 :00 06 40 00 00 01 5C 1B
设置设备地址为 0x02 :00 06 40 00 00 02 1C 1A
设置设备地址为 0x03 :00 06 40 00 00 03 DD DA
读取设备地址指令
发送码:00 03 40 00 00 01 90 1B
| 字段 | 含义 | 备注 |
|---|---|---|
| 00 | 设备地址 | 0x00 表示广播地址;0x01-0xFF 表示设备地址 |
| 03 | 03 指令 | 读取设备地址指令 |
| 40 00 | 指令寄存器 | 0x4000 为读取设备地址,0x8000 为读取软件版本 |
| 00 01 | 字节数 | 固定 0x0001 |
| 90 1B | CRC16 | 前 6 字节数据的 CRC16 校验和 |
返回码:01 03 02 00 01 79 84
| 字段 | 含义 | 备注 |
|---|---|---|
| 01 | 设备地址 | 0x00 表示广播地址;0x01-0xFF 表示设备地址 |
| 03 | 03 指令 | 读取软件版本,读取设备地址指令 |
| 02 | 字节数 | 返回字节数 |
| 00 01 | 设备地址 | 设置的设备地址,0x0001-0x00FF |
| 79 84 | CRC16 | 前 6 字节数据的 CRC16 校验和 |
示例:[2 号地址设备]
发送 : 00 03 40 00 00 01 90 1B
返回 : 02 03 02 00 02 7D 85 //地址 0x02
读取软件版本指令
发送码:00 03 80 00 00 01 AC 1B
| 字段 | 含义 | 备注 |
|---|---|---|
| 00 | 设备地址 | 0x00 表示广播地址;0x01-0xFF 表示设备地址 |
| 03 | 03 指令 | 读取软件版本,读取设备地址指令 |
| 80 00 | 指令寄存器 | 0x4000 为读取设备地址,0x8000 为读取软件版本 |
| 00 01 | 字节数 | 固定 0x0001 |
| AC 1B | CRC16 | 前 6 字节数据的 CRC16 校验和 |
返回码:01 03 02 00 64 B9 AF
| 字段 | 含义 | 备注 |
|---|---|---|
| 01 | 设备地址 | 0x00 表示广播地址;0x01-0xFF 表示设备地址 |
| 03 | 03 指令 | 读取软件版本,读取设备地址指令 |
| 02 | 字节数 | 返回字节数 |
| 00 64 | 软件版本 | 转为十进制然后小数点左移两位即表示软件版本 0x0064 = 100 = V1.00 |
| B9 AF | CRC16 | 前 6 字节数据的 CRC16 校验和 |
示例:[1 号地址设备]
发送:00 03 80 00 00 01 AC 1B
返回:01 03 02 00 64 B9 AF //0x0064 = 100 =V1.00
异常功能码介绍
当接收到的指令出错或者异常设备将会返回异常响应,异常响应格式如下。
返回码:01 85 03 02 91
| 字段 | 含义 | 备注 |
|---|---|---|
| 01 | 设备地址 | 0x00 表示广播地址;0x01-0xFF 表示设备地址 |
| 85 | 异常功能码 | 异常功能码 = 请求功能码 + 0x80 |
| 03 | 字节数 | 异常码 |
| 02 91 | CRC16 | 前 6 字节数据的 CRC16 校验和 |
异常码是一个单字节值,用于指示错误的类型。Modbus 协议定义的几个常用异常码:
| 异常码 | 名称 | 描述 |
|---|---|---|
| 0x01 | 非法功能 | 请求的功能码不支持 |
| 0x02 | 非法数据地址 | 请求的数据地址错误 |
| 0x03 | 非法数据值 | 请求的数据值或操作无法执行 |
| 0x04 | 服务器故障 | 服务器设备故障 |
| 0x05 | 应答 | 已接收到请求并正在处理 |
| 0x06 | 设备繁忙 | 设备当前正忙无法执行请求的操作 |