三菱MC协议网关
前言
注意点
- 1 个线圈 = 1 位
- 1 个寄存器地址 = 2 个字节；
- [ 寄存器起始地址 = 0001 ] 相当于 [ 访问地址 = 0 ]，存在 1 位地址偏移；
- 4 字节数据的编码格式 = BA_DC； (大端模式 = DC_BA，小端模式 = AB_CD)
- 支持自动重连
协议类
| Modbus协议 | 对应的类 | 备注 |
|---|---|---|
| Tcp | ModbusTcp, ModbusTcpServer | 网口 |
| Rtu | ModbusRtuOverTcp | 需要串口转网口 |
| Ascii | ModbusAsciiOverTcp | 需要串口转网口 |
数据区
| 区号 | 名称 | 读写 | 地址范围 | 对应方法 |
|---|---|---|---|---|
| 0区 | 输出线圈 | 可读可写布尔量 | 00001-09999 | readCoil / writeCoil |
| 1区 | 输入线圈 | 只读布尔量 | 10001-19999 | readDiscreteInput |
| 3区 | 输入寄存器 | 只读寄存器 | 30001-39999 | readInputRegister |
| 4区 | 保持寄存器 | 可读可写寄存器 | 40001-49999 | readHoldRegister / writeHoldRegister |
地址解析
根据 Modbus 通信协议，Modbus 数据的地址使用 0xxxx、1xxxx、3xxxx 和 4xxxx 的形式。
| 案例地址 | 数据区 | 地址前缀 | 剩余地址 | 对应方法地址 | 使用示例 |
|---|---|---|---|---|---|
| 00001 | 输出线圈 | 0 | 0001 | 0 | readCoil(0, 1) |
| 10003 | 输入线圈 | 1 | 0003 | 2 | readDiscreteInput(2, 1) |
| 30020 | 输入寄存器 | 3 | 0020 | 19 | readInputRegister(19, 1) |
| 40100 | 保持寄存器 | 4 | 0100 | 99 | readHoldRegister(99, 1) |
功能码
| 序号 | 功能码 | 功能说明 | 对应方法 |
|---|---|---|---|
| 1 | 01H | 读取输出线圈 | readCoil |
| 2 | 02H | 读取输入线圈 | readDiscreteInput |
| 3 | 03H | 读取保持寄存器 | readHoldRegister |
| 4 | 04H | 读取输入寄存器 | readInputRegister |
| 5 | 05H | 写入单线圈 | writeCoil |
| 6 | 06H | 写入单寄存器 | writeHoldRegister |
| 7 | 0FH | 写入多线圈 | writeCoil |
| 8 | 10H | 写入多寄存器 | writeHoldRegister |
保持寄存器快捷访问
| 序号 | 方法 | 寄存器数量 | 字节大小 | 位大小 | 含义 | 寄存器 |
|---|---|---|---|---|---|---|
| 1 | readBoolean | 1 | 1/8 | 1 | 读取boolean | 保持寄存器 |
| 2 | readInt16 | 1 | 2 | 16 | 读取Int16 | 保持寄存器 |
| 3 | readUInt16 | 1 | 2 | 16 | 读取UInt16 | 保持寄存器 |
| 4 | readInt32 | 2 | 4 | 32 | 读取Int32 | 保持寄存器 |
| 5 | readUInt32 | 2 | 4 | 32 | 读取UInt32 | 保持寄存器 |
| 6 | readFloat32 | 2 | 4 | 32 | 读取Float32 | 保持寄存器 |
| 7 | readFloat64 | 4 | 8 | 64 | 读取Float64 | 保持寄存器 |
| 8 | readString | n | 2n | 16n | 读取字符串 | 保持寄存器 |
| 9 | writeInt16 | 1 | 2 | 16 | 写入Int16 | 保持寄存器 |
| 10 | writeUInt16 | 1 | 2 | 16 | 写入UInt16 | 保持寄存器 |
| 11 | writeInt32 | 2 | 4 | 32 | 写入Int32 | 保持寄存器 |
| 12 | writeUInt32 | 2 | 4 | 32 | 写入UInt32 | 保持寄存器 |
| 13 | writeFloat32 | 2 | 4 | 32 | 写入Float32 | 保持寄存器 |
| 14 | writeFloat64 | 4 | 8 | 64 | 写入Float32 | 保持寄存器 |
| 15 | writeString | n | 2n | 16n | 写入字符串 | 保持寄存器 |