Skip to content

Home

Jump to bottom
Addie Janssen edited this page Sep 15, 2026 · 4 revisions

Domoticz SolarEdge_ModbusTCP plugin

As the name already suggests: this is a Domoticz plugin to read data over the local network from a SolarEdge inverter using the Modbus protocol protocol.

The plugin reads data of the inverter itself and (when applicable) meters and batteries attached to the SolarEdge inverter.

Requirements

To make this work, the SolarEdge Inverter needs to be connected to the network (either wired or wireless) and Modbus must be enabled on the inverter. Please consult the documentation of your inverter to find out how to enable Modbus.

Installation of the plugin

The plugin can be downloaded as a zip-file from releases.

Unpack the contents of the zip-file into a folder in the plugins folder of your Domoticz installation.

Go to the folder where the plugin files were extracted to and install the dependencies:

pip3 install -r requirements.txt -t .

Then restart Domoticz.

Configuration in Domoticz

Once the plugin is installed, a new hardware Type will be available: SolarEdge ModbusTCP.

To add the SolarEdge inverter, go to Setup -> Hardware and add the inverter:

  • Enter a Name for the inverter. The name will be used when creating devices in Domoticz. Using a long name, may result in long device names.
  • Select SolarEdge ModbusTCP from the Type dropdown list.
  • Enter the IP address or the DNS name of the inverter in the Inverter IP Address field.
  • Enter the Modbus port number (needs to match the port as configured in the actual inverter; default port is: 502) of the inverter in the Inverter Port Number field.
  • Enter the Modbus device address (most inverters use the default: 1) of the inverter in the Inverter Modbus device address field.
  • Select which Hardware components to read from the inverter: Inverter, Inverter+Meters, Inverter+Batteries or Inverter+Meters+Batteries.
  • When this is the first time use of the plugin, select Yes in the Add missing devices to allow the plugin create all the devices in Domoticz. After upgrading, you may select No to prevent the addition of devices that you deleted yourself.
  • Select an Interval (default: 5 seconds); this defines how often the plugin will collect the data from the inverter. Short intervals will result in more accurate values and graphs, but also result in more network traffic and a higher workload for both Domoticz and the inverter.
  • Domoticz stores data with a 5 minute interval. When the Auto Avg/Max math is Enabled, the plugin wil calculate an average or maximun value which will be stored by Domoticz. When this option is Disabled Domoticz will store the last value received from the plugin. For some devices this may not reflect what happened in the last 5 minutes and may look as a random value.
  • The Log level (default: Normal) defines the amount and details of information that will be stored in the Dmoticz log (Setup -> Log). Verbose is helpful showing the data that is retrieved from the inverter. Verbose+ and Verbose++ are intended for debugging purposes.
  • Add the inverter.

This should result in a lot of new devices in the Setup -> Devices menu.

Updating the plugin

Updating the plugin can be done by removing the previous version and do a clean install again. Make sure to stop the Domoticz service before you start or at least stop all hardware that is related to the plugin.

Make sure that the requirements listed in the requirements.txt file are met. If newer versions of the solaredge_modbus library are required, make sure that you remove the older versions to prevent version conflicts.

Help/support

This wiki is used to provide information about the plugin and its features.

I have a question/need help with:

  • Installing Domoticz: the Domoticz forum provides a lot of information on how to install Domoticz on different types of hardware and operating systems.
  • Installing a Python plugin in Domoticz: the Using Python plugins page on the forum is the place to visit.
  • This plugin: there's a specific Domoticz forum post related to this plugin.
  • Request for feature/changes to the plugin: drop a message in the Domoticz forum post. We are monitoring the post for these requests.

Clone this wiki locally