Metadata-Version: 2.4
Name: aiovictron
Version: 0.2.0
Summary: Async Python client for Victron Modbus TCP (Cerbo GX)
Author: Darryl Cauldwell
License-Expression: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Home Automation
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pymodbus>=3.6.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Dynamic: license-file

# aiovictron

Async Python client for Victron Modbus TCP (Cerbo GX).

## Installation

```bash
pip install aiovictron
```

## Usage

```python
from aiovictron import VictronClient

async with VictronClient("192.168.1.153") as client:
    devices = await client.validate_connection()
    data = await client.get_data()

    if data.system:
        print(f"Battery SOC: {data.system.battery_soc}%")
        print(f"PV Power: {data.system.pv_power}W")

    if data.solar_charger:
        print(f"Charger state: {data.solar_charger.charger_state}")

    if data.vebus:
        print(f"AC output: {data.vebus.ac_output_power}W")
```

## Supported Devices

| Unit ID | Device | Registers |
|---------|--------|-----------|
| 100 | System | 8 |
| 223 | MPPT Solar Charger | 8 |
| 227 | VE.Bus Inverter | 14 |

## License

MIT
