-
-
Notifications
You must be signed in to change notification settings - Fork 26
Home
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.
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.
- 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.
- Automatically detects meters and batteries.
- Supports site limit and storage controls.
- 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.
- Complete device and entity category support in Home Assistant.
- Supports the Energy Dashboard and Long Term Statistics.
- Robust error handling and polling cycle handling.
- Dynamic loading/reloading and configurable options through Home Assistant UI.
- Opens a connection every poll cycle instead of holding it open (with option to hold open).
- Meter events: shows one or more active meter events as an attribute, or an empty list if no events.
- Sensors that are unsupported or invalid are treated as "unavailable".
- Avoids stale sensor data by changing state to "unavailable" if an update fails.
- Sensors with units VA, var, VAh, and varh are considered advanced types, disabled by default to avoid sensor clutter.
- Validates sensors based on SunSpec model.
- Uses a current version of pymodbus.