Skip to content

WillCodeForCats/solaredge-modbus-multi

Repository files navigation

SolarEdge Modbus Multi

hacs_badge

This integration provides Modbus/TCP local polling to one or more SolarEdge inverters for Home Assistant. Each inverter can support three meters and three batteries over Modbus/TCP. It works with single inverters, multiple inverters, meters, and batteries. It has significant improvements over similar integrations, and solaredge_modbus_multi is actively maintained.

By default, only features which are officially documented on the SolarEdge website are enabled: inverters, synergy inverters, and meters. All of the battery (read only) and control features (read/write battery and limit controls) can be enabled by configuring the hub after you add it to your Home Assistant. Support for batteries and controls is from documentation not publicly available on the SolarEdge website or through user discovery and may not be supported by SolarEdge.

Features

  • Inverter support for 1 to 32 SolarEdge inverters.
  • Meter support for 1 to 3 meters per inverter.
  • Battery support for 1 to 3 batteries per inverter.
  • Supports site limit and storage controls.
  • Automatically detects meters and batteries.
  • Supports Three Phase Inverters with Synergy Technology.
  • Polling frequency configuration option (1 to 86400 seconds).
  • Auto-discovers inverters via Fast Scan (IDs 1–32), Complete Scan (IDs 1–247), or manual device ID list.
  • Connects locally using Modbus/TCP - no cloud dependencies.
  • Informational sensor for device and its attributes
  • Supports status and error reporting sensors.
  • User friendly: Config Flow, Options, Repair Issues, and Reconfiguration.

Read about more features on the wiki: WillCodeForCats/solaredge-modbus-multi/wiki

Installation

Install with HACS: Search for "SolarEdge Modbus Multi" in the default repository,

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

OR

Download the latest release and copy the solaredge_modbus_multi folder into to your Home Assistant config/custom_components folder.

After rebooting Home Assistant, this integration can be configured through the integration setup UI. It also supports options, repair issues, and reconfiguration through the user interface.

Configuration

WillCodeForCats/solaredge-modbus-multi/wiki/Configuration

Inverter site limit and battery storage controls are disabled by default: not all inverters support controls. You will need to enable Power Control Options after adding your inverter hub in the integration.

Documentation

WillCodeForCats/solaredge-modbus-multi/wiki

Minimum Required Versions

  • Home Assistant 2025.2.0 (HA=>2025.9.0 requires release v3.1.7 or newer)
  • pymodbus 3.8.3 (pymodbus>=3.10.0 requires release v3.1.6 or newer)

Specifications

WillCodeForCats/solaredge-modbus-multi/tree/main/doc

Project Sponsors

About

The Complete Local (Modbus/TCP) SolarEdge Integration for Home Assistant

Topics

Resources

License

Stars

306 stars

Watchers

19 watching

Forks

Sponsor this project

 

Contributors

Languages