modbus-event-connect 0.1.8
A library designed for seamless interaction with Modbus devices using an event-driven approach, supporting TCP, unabto and other protocols.
License: MIT
Requires Python: >=3.12
Keywords: modbus, unabto, micronabto, micro_nabto, modbustcp, modbus_tcp, event, remote, connect, library

# Modbus Event Connect

Welcome to **Modbus Event Connect** – a user-friendly, event-driven Python library designed to simplify the configuration of Modbus devices and interact with them in an event-driven way. Whether you're connecting via TCP or Unabto, Modbus Event Connect has got you covered.

## Features

- **Event-Driven Architecture**: React to changes and events in real-time.
- **Easy Configuration**: Intuitive setup for Modbus devices.
- **Flexible Connectivity**: Supports connection through TCP or Unabto.
- **User-Friendly**: Handles the interaction; you just define the Modbus register items.

## Getting Started

1. **Installation**: Install the library using pip.
    ```bash
    pip install modbus-event-connect
    ```
2. **Basic Usage**: Define your DataPointKeys to a Modbus device with minimal code.
    ```python
    from collections.abc import Callable
    from src.modbus_event_connect import *

    class MyDatapointKey(ModbusDatapointKey):
        MAJOR_VERSION = "major_version"
        
    class MySetpointKey(ModbusSetpointKey):
        MY_SETPOINT = "my_setpoint"

    class MyModbusDevice(ModbusDeviceBase):
        def __init__(self, device_info: ModbusDeviceInfo):
            super().__init__(device_info)

            self._attr_manufacturer="<manufacturer>"
            self._attr_model_name="<model_name>"
            self._attr_datapoints = [
                ModbusDatapoint(key=MyDatapointKey.MAJOR_VERSION, read_address=1, divider=1, signed=True),
            ]
            self._attr_setpoints = [
                ModbusSetpoint(key=MySetpointKey.MY_SETPOINT, read_address=1, write_address=1 ,divider=1, min=1, max=10, signed=True),
            ]

    class MyModbusDeviceAdapter(ModbusDeviceAdapter):

        def _translate_to_model(self, device_info: ModbusDeviceInfo) -> Callable[[ModbusDeviceInfo], ModbusDevice]|None: 
            return MyModbusDevice

    class MyModbusTCPEventConnect(ModbusTCPEventConnect):
        _attr_adapter = MyModbusDeviceAdapter()
    ```

## Documentation
### Client Capabilities

The Modbus Event Connect offers a range of methods to facilitate seamless interaction with Modbus devices. Key features include:

- **Subscribe**: Easily subscribe to data points and receive updates.
- **Unsubscribe**: Manage your subscriptions effortlessly.
- **Comprehensive Methods**: A variety of methods to handle different Modbus operations.

Let the Event Connect handle the communication, allowing you to focus on responding to changes and managing your Modbus devices efficiently.

## Disclaimer

Modbus Event Connect is provided "as is", without warranty of any kind. The authors and contributors are not responsible for any damage or data loss that may occur from using this library. Users are solely responsible for ensuring the proper and safe operation of their Modbus devices.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.