modbus-tcp-cython 0.1.0

A Cython Modbus TCP client with heartbeat and multi-connection management.

modbus-tcp-cython

A Cython Modbus TCP client with structured protocol parsing, heartbeat reconnects, and multi-connection management.

Build locally

python -m venv .venv
. .venv/bin/activate
python -m pip install -U pip setuptools wheel Cython
python -m pip install .

Basic usage

from modbus_tcp import ModbusTcpClient

client = ModbusTcpClient("192.168.180.18", 26, timeout=5.0)
client.connect()

try:
    values = client.read_holding_registers(unit_id=3, start_address=2, quantity=1)
    print(values)
finally:
    client.close()

Multi-connection usage

from modbus_tcp import ModbusTcpManager

with ModbusTcpManager() as manager:
    manager.add_client(
        name="line_1",
        host="192.168.180.18",
        port=26,
        unit_id=3,
        heartbeat_address=2,
        heartbeat_interval=5.0,
    )
    manager.start_all()

    print(manager.read_holding_registers("line_1", 2, 1))