homeassistant-solax-modbus

homeassistant-solax-modbus

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

Requires Home Assistant 2025.1.0 or newer (minimum version is declared in hacs.json).

• Supports Modbus over RS485 & TCP. Please check the Docs for Compatible RS485 Adaptors

• 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

  Viessmann HINV6.0-B1

Installation

Read the Docs - Installation

Documentation

For further Documentation please refer to the Read the Docs

FAQ

Read the Docs - General FAQ

• Read the Docs - Sofar FAQ
• Read the Docs - SolaX 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.