Home

solaredge-modbus-multi

A Home Assistant integration for SolarEdge inverters. Connects locally using Modbus/TCP to single or multiple inverters, including meters.

This integration is ideal for multiple inverter installations where you have a single Leader (Master) inverter connected to the network, with one or more Follower (Slave) inverters connected using the RS485 bus. This integration also supports up to three meters and two batteries per inverter with auto-detection for meters and batteries.

Features

• Inverter support for 1 to 32 SolarEdge inverters.
• Meter support for 1 to 3 meters per inverter.
• Battery support for 1 or 2 batteries per inverter.
• Automatically detects meters and batteries.
• Supports Three Phase Inverters with Synergy Technology.
• Polling frequency configuration option (10 to 86400 seconds).
• Configurable starting inverter device ID.
• Connects using Modbus/TCP - no cloud dependencies.
• Informational sensor for device and its attributes
• Supports status and error reporting sensors.
• User friendly configuration through Config Flow.

Other Things

• Set measurement state class where applicable
• Use Home Assistant core constants for sensor units
• Use a recent version of pymodbus
• Open/close the modbus/tcp connection every poll cycle instead of holding it open.
• Meter event descriptions: list of one or more active meter events as an attribute, or an empty list if no events are active.
• Entity category support (PR Entity category support #8)
• Catch cycle errors better - don't pass exceptions up to Home Assistant (PR Use more try-except #9)
• Add validation for sensors based on Sunspec model. (PR Add validation for sensors based on Sunspec model #11)
• Sensors that are unsupported or invalid will now be treated as "unavailable" in Home Assistant. (PR Add validation for sensors based on Sunspec model #11)
• Treat sensors with units VA, var, VAh, and varh as advanced sensor types. Make them disabled by default to avoid sensor clutter, but advanced users can enable them if desired. (PR Advanced sensor types #10)
• Breaking change: Changed VAR to var and VARh to varh to match SI units for volt amp reactive. However, unless someone was using an alternative meter the SolarEdge branded meter used in testing did not use these values (they were always 0)
• Device classes were added to more sensors, and depreciated constants were removed per Home Assistant release 2021.12.0