python-intelbras-solar-local

This is an async Python client that reads and controls Intelbras solar inverters over the local network, with no cloud and no account. It was built for the ha-intelbras-solar-local Home Assistant integration.

Intelbras IONS inverters are rebranded Sungrow string inverters, and their Wi-Fi datalogger is a Sungrow WiNet-S. The datalogger exposes two interfaces without a login, and this library uses both:

• Modbus TCP on port 502, using the Sungrow SG-RS register map. This is the main data source.
• The datalogger WebSocket on port 8082, which the built-in web UI uses. It provides Wi-Fi and cloud link state, active faults and alarms, and the commercial model.

Features

• ⚡ Power readings: AC, DC, apparent and reactive power, plus power factor.
• 🔋 Energy counters for today, the month, the year and the lifetime total (0.1 kWh resolution).
• ☀️ Voltage, current and power for each MPPT input.
• 🔌 Grid voltage, current and frequency (0.01 Hz).
• 🩺 Health data: work state, internal temperature, bus voltage, insulation resistance and fault code.
• 📡 Datalogger data: Wi-Fi and cloud connectivity, active fault list and alarm count.
• 🛠️ Controls: start or stop the inverter, switch power limitation on or off, set the power limit (%), set the clock.
• No pymodbus dependency. The library ships a tiny asyncio Modbus TCP client, so it never clashes with the version that Home Assistant pins.
• Fully async (aiohttp) and typed (py.typed).

Installation

pip install python-intelbras-solar-local

Quickstart

import asyncio
from intelbras_solar_local import IntelbrasSolarClient


async def main() -> None:
    async with IntelbrasSolarClient("192.168.31.17") as client:
        status = await client.async_get_status()
        print(status.model, status.serial, status.work_state)
        print(f"{status.power_ac} W now, {status.energy_today} kWh today")
        for n, mppt in enumerate(status.mppts, 1):
            print(f"MPPT{n}: {mppt.voltage} V x {mppt.current} A = {mppt.power} W")


asyncio.run(main())

Supported hardware

Other Intelbras IONS models and Sungrow SG-RS inverters behind a WiNet-S should work as well. If yours differs, open an issue with the output of examples/status.py.

API overview

The register map and the WebSocket protocol are documented in the docs.

Development

uv venv && uv pip install -e ".[test]"
pytest
ruff check .

License

MIT © Hudson Brendon. This project is not affiliated with Intelbras or Sungrow.