Skip to content

A Home Assistant integration for SolarEdge inverters using Modbus/TCP. Supports single inverters, multiple inverters, meters, batteries, and many other improvements.

License

Notifications You must be signed in to change notification settings

rzulian/solaredge-modbus-multi

 
 

Repository files navigation

hacs_badge

solaredge-modbus-multi

A Home Assistant integration for SolarEdge inverters using Modbus/TCP. It supports single inverters, multiple inverters, meters, batteries, and many other improvements over other integrations that didn't work well with a multi-device setup.

It is designed to communicate locally using Modbus/TCP where you have a single Leader (Master) inverter connected with one or more Follower (Slave) inverters chained using the RS485 bus. Inverters can have up to three meters and two 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.
  • Polling frequency configuration option (1 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.

Requires Home Assistant 2022.2.0 and newer.

Installation

Copy the solaredge_modbus_multi folder into to your Home Assistant config/custom_components folder,

OR

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

After rebooting Home Assistant, this integration can be configured through the integration setup UI. If the integartion does not appear in Home Assistant after restarting, you may need to do one or more of the following:

  • Reload the Home Assistant page
  • Restart your browser
  • Clear your browser cache

Configuration

WillCodeForCats/solaredge-modbus-multi/wiki/Configuration

Documentation

WillCodeForCats/solaredge-modbus-multi/wiki

Recommended Update Procedure from v1.x.x

  1. Delete integration from Settings -> Devices & Services.
  2. Update to 2.x.x release.
  3. Add the integration under Settings -> Devices & Services.

Fixing #21 causes HA to recreate entities. Updating in place will cause existing entities will be seen as duplicates and HA will suffix them with _2. If this happens you can either update everything to use the new names, or follow the update procedure to avoid renaming. This assumes the default entity names; custom names will have to be handled manually in any case.

Upgrading from v1.1.x to v1.2.x

Follow instructions at: How To Upgrade from v1.1.x to v1.2.x

Help Wanted

  • Battery support is untested: see issue #22

Specifications

About

A Home Assistant integration for SolarEdge inverters using Modbus/TCP. Supports single inverters, multiple inverters, meters, batteries, and many other improvements.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%