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, batteries, and controls. The work in this repository is also being used in other libraries and integrations.
By default, only features which are officially documented by SolarEdge 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 from SolarEdge or through user discovery and may not be supported by SolarEdge.
- Home Assistant Auto Discovery (Zeroconf) support.
- 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).
- Discovers inverters with 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
Install with HACS: Search for "SolarEdge Modbus Multi" in the default repository,
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.
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.
WillCodeForCats/solaredge-modbus-multi/wiki
- Home Assistant 2025.6.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)
WillCodeForCats/solaredge-modbus-multi/tree/main/doc
There are other integrations and libraries that have included this work directly or indirectly, in some cases through AI agents. If you have used this work directly or indirectly, the author would appreciate it if you would include a prominent credit and link to this repository so that your users are aware of its origin. All of the original research on inverter behavior and undocumented features found here was curated by hand in a pre-AI era. If you use issues previously reported, or a user's diagnostic data as test cases or to generate code, including user feedback, please also extend credit to that user for their contributions as well as this repository, preferably with a direct link to the issue.