A Domoticz plugin to collect data from SolarEdge power inverters over ModbusTCP.
The plugin uses the solaredge_modbus
library (https://github.com/nmakel/solaredge_modbus) to communicate with the inverter.
The inverter needs to be connected to the network (either wired or wireless) and Modbus must be enabled on the device. Please consult the documentation of your inverter to find out how to enable Modbus.
Install pip3
:
sudo apt install python3-pip
Install domoticz
:
curl -sSL install.domoticz.com | sudo bash
Make sure that the plugins
folder exists in the domoticz
folder.
Install the plugin:
cd domoticz/plugins
git clone https://github.com/addiejanssen/domoticz-solaredge-modbustcp-plugin.git
Go to the plugin folder and install all required addons:
cd domoticz/plugins/domoticz-solaredge-modbustcp-plugin
sudo pip3 install -r requirements.txt
Once that is done, restart domoticz:
sudo service domoticz.sh restart
Please have a look at the Domoticz documentation before going this route: https://www.domoticz.com/wiki/Docker
This guide is based on the information of the original Domoticz Docker image, which can be found here: https://hub.docker.com/r/domoticz/domoticz
The installation documentation states:
When launching the docker container for the first time, a plugin folder is created in the userdata folder. You need to place your python plugins is folder.
You will need to start Domoticz once to create the data in that userdata folder. Once the folder is initialized, we can install the plugin:
cd <path for config files>/plugins
git clone https://github.com/addiejanssen/domoticz-solaredge-modbustcp-plugin.git
There are multiple ways to install the modules that are required by this plugin. This is the easy going option, but it may not be the best solution for the long run:
Connect to the running container
docker exec -it domoticz
Go to the plugin folder and install all required addons in the plugin folder:
cd userdata/plugins/domoticz-solaredge-modbustcp-plugin
pip3 install -r requirements.txt -t .
Once that is done, restart the domoticz container.
Once the plugin is installed, a new hardware type will be available: SolarEdge ModbusTCP
.
To add the inverter, go to Setup
-> Hardware
and add the inverter:
- Enter a
name
for the inverter. - Select
SolarEdge ModbusTCP
from thetype
dropdown list. - Enter the IP address of the inverter in the
Inverter IP Address
field. - Enter the port number (default: 502) of the inverter in the
Inverter Port Number
field. - Select
Yes
in theAdd missing devices
to create the devices when the inverter is added. SelectNo
after deleting unwanted devices. Leaving the option set toYes
will recreate the deleted devices once Domoticz is restarted. - 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. - Optionally change the
Auto Avg/Max math
; this defaults toEnabled
which means that the Domoticz graphs for most values will be averaged over time. When selectingDisabled
, the calculations will be disabled and the Domoticz graphs will be based on the last retrieved value. - Optionally change the
Log level
; this defaults toNormal
. When selectingExtra
, the plugin will print all the information it received from the inverter in the log. When selectingDebug
, even more information will be logged. Add
the inverter.
This should result in a lot of new devices in the Setup
-> Devices
menu.
Go to the plugin folder and get the new version:
cd domoticz/plugins/domoticz-solaredge-modbustcp-plugin
git pull
Once that is done, restart domoticz:
sudo service domoticz.sh restart
Here's an example of information returned by an inverter (in this case a SE7000 3 phase inverter):
Name | Value | Symbol |
---|---|---|
Model | SE7K | |
Version | 0003.2251 | |
Serial | 7E2AB053 | |
Modbus ID | 1 | |
SunSpec DID | Three Phase Inverter | |
Status | Producing | |
Vendor Status | 0 | |
Current | 3.59 | A |
P1 Current | 1.21 | A |
P2 Current | 1.17 | A |
P3 Current | 1.20 | A |
P1 Voltage | 401.4 | V |
P2 Voltage | 401.2 | V |
P3 Voltage | 402.8 | V |
P1-N Voltage | 230.1 | V |
P2-N Voltage | 232.7 | V |
P3-N Voltage | 230.4 | V |
Power | 784.0 | W |
Frequency | 50.01 | Hz |
Power (Apparent) | 829.1 | VA |
Power (Reactive) | -270.00 | VAr |
Power Factor | -94.46 | % |
Total Energy | 10773388 | Wh |
DC Current | 1.0647 | A |
DC Voltage | 747.5 | V |
DC Power | 795.9 | W |
Temperature | 43.53 | °C |
Hardware page showing a configured inverter.
The devices page shows all Domoticz devices that were created for the inverter.
The Domoticz Temperature page shows the inverters temperature data.
All the other information is visible in the Domoticz Utility page.