Overview of Modbus¶
MODBUS is an application layer messaging protocol, positioned at level 7 of the OSI model, that provides client/server communication between devices connected on different types of buses or networks. It is typically used for communication with I/O systems, including Programmable Logic Controllers (PLCs).
Modbus communication links¶
Modbus supports the following 3 communication-link layers:
| Link type | Description |
|---|---|
| TCP | TCP/IP using standard port 502. |
| RTU | RTU is normally run over serial communication links, i.e. RS-232, RS-422, or RS-485. RTU uses an additional CRC for packet checking. The protocol directly transmits each byte as 8 data bits, so uses “binary” rather than ASCII encoding. When using serial links start and end of message frames is detected by timing rather than by specific characters. RTU can also be run over TCP, though this is less common than the standard Modbus TCP without RTU. |
| Serial ASCII | Serial protocol, which is normally run over serial communication links, i.e. RS-232, RS-422, or RS-485. Serial ASCII uses an additional LRC for packet checking. The protocol encodes each byte as 2 ASCII characters. The start and end of message frames is detected by specific characters (“:” to start a message and CR/LF to end a message). This protocol is less efficient than RTU, but may be more reliable in some environments. ASCII can also be run over TCP, though this is much less common than the standard Modbus TCP. |
This modbus package supports all of the above Modbus communication-link layers.
Modbus data types¶
Modbus provides access to the following 4 types of data:
| Primary tables | Object type | Access | Comments |
|---|---|---|---|
| Discrete Inputs | Single bit | Read-Only | This type of data can be provided by an I/O system. |
| Coils | Single bit | Read-Write | This type of data can be alterable by an application program. |
| Input Registers | 16-bit word | Read-Only | This type of data can be provided by an I/O system. |
| Holding Registers | 16-bit word | Read-Write | This type of data can be alterable by an application program. |
Modbus communications¶
Modbus communication consists of a request message sent from the Modbus client to the Modbus server. The server replies with a response message. Modbus request messages contain:
- An 8-bit Modbus function code that describes the type of data transfer to be performed.
- A 16-bit Modbus address that describes the location in the server to read or write data from.
- For write operations, the data to be transferred.
Modbus function codes¶
modbus supports the following 9 Modbus function codes:
| Access | Function description | Function code |
|---|---|---|
| Bit access | Read Coils | 1 |
| Bit access | Read Discrete Inputs | 2 |
| Bit access | Write Single Coil | 5 |
| Bit access | Write Multiple Coils | 15 |
| 16-bit word access | Read Input Registers | 4 |
| 16-bit word access | Read Holding Registers | 3 |
| 16-bit word access | Write Single Register | 6 |
| 16-bit word access | Write Multiple Registers | 16 |
| 16-bit word access | Read/Write Multiple Registers | 23 |
Modbus addresses¶
Modbus addresses are specified by a 16-bit integer address. The location of inputs and outputs within the 16-bit address space is not defined by the Modbus protocol, it is vendor-specific. The following table lists some of the commonly used Modbus addresses for Koyo DL05/06/240/250/260/430/440/450 PLCs.
Discrete inputs and coils¶
| PLC Memory Type | Modbus start address Decimal (octal) | Function codes |
|---|---|---|
| Inputs (X) | 2048 (04000) | 2 |
| Special Relays (SP) | 3072 (06000) | 2 |
| Outputs (Y) | 2048 (04000) | 1, 5, 15 |
| Control Relays (C) | 3072 (06000) | 1, 5, 15 |
| Timer Contacts (T) | 6144 (014000) | 1, 5, 15 |
| Counter Contacts (CT) | 6400 (014400) | 1, 5, 15 |
| Stage Status Bits (S) | 6144 (012000) | 1, 5, 15 |
Input registers and holding registers (V memory)¶
| PLC Memory Type | Modbus start address Decimal (octal) | Function codes |
|---|---|---|
| Timer Current Values (TA) | 0 (00) | 4 |
| Counter Current Values (CTA) | 512 (01000) | 4 |
| Global Inputs (VGX) | 16384 (040000) | 4 |
| Global Outputs (VGY) | 16512 (040200) | 3, 6, 16 |
| Inputs (VX) | 16640 (040400) | 4 |
| Outputs (VY) | 16704 (040500) | 3, 6, 16 |
| Control Relays (VC) | 16768 (040600) | 3, 6, 16 |
| Stage Status Bits (VS) | 16896 (041000) | 3, 6, 16 |
| Timer Contacts (VT) | 16960 (041100) | 3, 6, 16 |
| Counter Contacts (VCT) | 16992 (041140) | 3, 6, 16 |
| Special Relays (VSP) | 17024 (041200) | 4 |
Other PLC manufacturers will use different Modbus addresses.
Note that 16-bit Modbus addresses are commonly specified with an offset of 400001 (or 300001). This offset is not used by the modbus driver, it uses only the 16-bit address, not the offset.
Modbus data length limitations¶
Modbus read operations are limited to transferring 125 16-bit words or 2000 bits. Modbus write operations are limited to transferring 123 16-bit words or 1968 bits.
More information on Modbus¶
For more information about the Modbus protocol, the official Modbus
specification can be found on the
Web
or in the modbus documentation directory.
Modbus_Application_Protocol_V1_1b.pdf.
The official specification for Modbus over TCP/IP can be found on the
Web
or in the modbus documentation directory.
Modbus_Messaging_Implementation_Guide_V1_0b.pdf.
The official specification for Modbus over serial can be found `on the
Web <http://www.modbus.org/docs/Modbus_over_serial_line_V1_02.pdf`__ or
in the modbus documentation directory.
Modbus_over_serial_line_V1_02.pdf.