Home
Softono

Homeassistant Solax Modbus

Open source Apache-2.0 Python
490
Stars
201
Forks
44
Issues
20
Watchers
3 months
Last Commit

 About Homeassistant Solax Modbus

SolaX Power Modbus custom_component for Home Assistant (Supports some AlphaESS, Growatt, Sofar, Solinteg, Solis, SRNE, Swatten)

Platforms

Web Self-hosted

Languages

Python

Links

Need Help Installing Homeassistant Solax Modbus?

We provide expert installation service for this software. Our team will install, configure, and secure Homeassistant Solax Modbus on your server. plans start at just $30.

Homeassistant Solax Modbus

View on GitHub

homeassistant-solax-modbus

hacs_badge ko-fi

Octopus.Energy 🐙 referral code. You get £50 credit for joining and I get £50 credit.

Summary

Universal Solar Inverter over Modbus RS485 / TCP custom_component for Home Assistant

Integration 2024.09.1 and newer only supports HA 2024.9.0 and newer

    • Ginlong Solis
      • RHI-nK-48ES-5G Single Phase (lowercase n indicates Inverter size, ie 6kW)
      • RHI-3PnK-HVES-5G Three Phase (lowercase n indicates Inverter size, ie 10kW)
    • Growatt:
      • AC Battery Storage:

        • SPA
      • Hybrid:

        • SPF - WIP
        • SPH
        • TL-XH (MIN,MOD & MID)
      • PV Only:

        • MAC
        • MAX
        • MID
        • TL-X
    • Sofar Solar
      • HYDxxKTL-3P (plugin_sofar)
        • Azzurro 3.3k-12KTL-V3
        • Azzurro ZSS
      • HYDxxxxES (plugin_sofar_old)
    • SolaX Power
      • A1 Hybrid - WIP
      • Gen2 Hybrid
      • Gen3 AC, Hybrid & RetroFit
      • Gen4 Hybrid & RetroFit
        • Qcells Q.VOLT HYB-G3-3P
        • TIGO TSI
      • Gen5 Hybrid
      • J1 Hybrid - WIP
      • X1 Air/Boost/Mini Gen3 & Gen4 (Limited set of entities available)
      • X3 MEGA / FORTH Gen2 (Limited set of entities available)
      • X3 MIC / MIC PRO Gen1 & Gen2 (Limited set of entities available)
      Solinteg - WIP

      SRNE - WIP

      Swatten -WIP

Installation

Read the Docs - Installation

Documentation

For further Documentation please refer to the Read the Docs

FAQ

Read the Docs - General FAQ

Multiple Connections

Modbus is designed to mostly have a single Master. If you try to connect multiple instances to the Inverter ie this Integration and Node-RED the Inverter will either block the second connection or likely to result in data collisions.

If this happens it's recommended to use a multiplexer such as https://github.com/IngmarStein/tcp-multiplexer this has been tested by reading and writing from two instances of HA at once.

This can be started with Docker or Docker Compose. Example Compose:

services:
  modbus-proxy:
    image: ghcr.io/ingmarstein/tcp-multiplexer
    container_name: modbus_proxy
    ports:
      - "5020:5020"
    command: [ "server", "-t", "192.168.123.123:502", "-l", "5020", "-p", "modbus", "-v" ]
    restart: unless-stopped

Server address is the Inverter / data logger. You then direct this integration to the machine running the proxy and port 5020 in this example.