skip to navigation
skip to content

pyModbusTCP 0.1.1

A simple Modbus/TCP library for Python

Package Documentation

A simple Modbus/TCP client library for Python.

Since version 0.1.0, a server is also available for test purpose only (don’t use in project).

pyModbusTCP is pure Python code without any extension or external module dependency.


The module is currently test on Python 2.6, 2.7, 3.2, 3.3 and 3.4.



You can install this package from:

PyPI, the easy way:

sudo pip install pyModbusTCP


git clone
cd pyModbusTCP
sudo python install

Install the current devel-release:

sudo pip install git+

Usage example

See examples/ for full scripts.

include (for all samples)

from pyModbusTCP.client import ModbusClient

module init (TCP always open)

# TCP auto connect on first modbus request
c = ModbusClient(host="localhost", port=502, auto_open=True)

module init (TCP open/close for each request)

# TCP auto connect on modbus request, close after it
c = ModbusClient(host="", auto_open=True, auto_close=True)

module init (with accessor functions)

c = ModbusClient()"localhost")
# managing TCP sessions with call to

Read 2x 16 bits registers at modbus address 0 :

regs = c.read_holding_registers(0, 2)
if regs:
    print("read error")

Write value 44 and 55 to registers at modbus address 10 :

if c.write_multiple_registers(10, [44,55]):
    print("write ok")
    print("write error")


Documentation available online at and on doc/html/index.html.

File Type Py Version Uploaded on Size
pyModbusTCP-0.1.1.tar.gz (md5) Source 2016-05-30 12KB