Using Modbus with Python: A Practical Guide for Implementation

The Modbus protocol is an industry-standard widely used for communication between electronic devices, particularly in industrial automation systems. Due to its simplicity and flexibility, Modbus has become one of the preferred protocols for controlling and monitoring devices across various sectors. In this article, we will explore how to use Modbus with Python to communicate with devices that support this protocol.

Prerequisites: Before getting started, make sure you have Python installed on your system. Additionally, it is advisable to have a basic understanding of Python and the serial communication libraries.

Python Libraries for Modbus: To begin using Modbus with Python, we’ll need a few supporting libraries. The two main libraries for Modbus implementation in Python are “pymodbus” and “minimalmodbus”. The “pymodbus” library provides a wide range of features and supports various Modbus variants, while “minimalmodbus” is a lighter and simpler library that focuses on basic functionality.

Installing the Libraries: To install “pymodbus”, we can use the following pip command:

pip install pymodbus

For “minimalmodbus”, the installation can be done using the following command:

pip install minimalmodbus

Establishing a Modbus Connection: Once the libraries are installed, we can proceed with establishing a Modbus connection. The first step is to determine the type of Modbus connection we need: Modbus TCP or Modbus RTU.

• Modbus TCP: For devices connected over Ethernet, we use the TCP connection. In Python, we can create a Modbus TCP client using the pymodbus library. Here's an example:

from pymodbus.client.sync import ModbusTcpClient

# Create a Modbus TCP client
client = ModbusTcpClient('192.168.0.1')  # Replace with your device's IP address

# Connect to the Modbus TCP server
client.connect()

# Perform Modbus operations here

# Close the connection
client.close()

• Modbus RTU: For devices connected over serial communication (e.g., RS485), we use the RTU connection. In Python, we can use the minimalmodbus library for Modbus RTU communication. Here's an example:

import minimalmodbus

# Create a Modbus RTU instrument
instrument = minimalmodbus.Instrument('/dev/ttyUSB0', slaveaddress=1)  # Replace with your device's serial port and slave address

# Set the communication parameters (baudrate, parity, etc.)
instrument.serial.baudrate = 9600
instrument.serial.parity = minimalmodbus.serial.PARITY_NONE

# Perform Modbus operations here

# Close the connection
instrument.serial.close()

Performing Modbus Operations: Once the Modbus connection is established, we can perform various Modbus operations such as reading and writing data from/to registers.

To read a holding register value (e.g., register 100) using pymodbus, we can use the following code:

from pymodbus.constants import Endian
from pymodbus.payload import BinaryPayloadDecoder
from pymodbus.payload import BinaryPayloadBuilder

# Read a holding register value
result = client.read_holding_registers(address=100, count=1, unit=1)
if result.isError():
    print("Error reading register!")
else:
    decoder = BinaryPayloadDecoder.fromRegisters(result.registers, byteorder=Endian.Big)
    value = decoder.decode_32bit_float()

    print("Register value:", value)

To write a value to a holding register (e.g., register 200) using minimalmodbus, we can use the following code:

# Write a value to a holding register
instrument.write_register(200, 42)

Conclusion: In this article, we have explored how to use Modbus with Python for communication with devices supporting the Modbus protocol. We covered the installation of the required libraries, establishing Modbus TCP and Modbus RTU connections, and performing basic read and write operations. With Python’s extensive support for Modbus, you can leverage this powerful combination for various industrial automation applications.