neopool-modbus 0.2.0

Async Python client for Sugar Valley NeoPool / VistaPool / Hidrolife Modbus pool controllers

neopool-modbus

Async Python client for Sugar Valley NeoPool pool controllers (sold under brands VistaPool, Hidrolife, Aquascenic, Oxilife, Hayward, Brilix, Bayrol) connected via Modbus TCP.

This library is the communication layer extracted from the Home Assistant neopool integration and is suitable for any Python project — Home Assistant, scripts, dashboards, or custom automation.

Status

🚧 Alpha — under active development. Public API may change before 1.0.0.

Installation

pip install neopool-modbus

Requires Python 3.13+ and pymodbus>=3.10.0.

Quick start

import asyncio

from neopool_modbus import NeoPoolModbusClient


async def main() -> None:
    client = NeoPoolModbusClient(host="192.168.1.42", port=502, slave_id=1)
    await client.connect()
    try:
        data = await client.read_all()
        print(data["measure_temperature"], data["measure_ph"])
    finally:
        await client.close()


asyncio.run(main())

Features

• Async I/O on top of pymodbus.AsyncModbusTcpClient
• Batched register reads (single round-trip per register block)
• Write-and-verify mechanism for configuration registers
• Capability detection (hydrolysis, pH, Redox, chlorine, conductivity)
• Strict type hints (py.typed), 100 % test coverage

License

Apache 2.0 — see LICENSE.