ricott / sma.modbus

Homey app for monitoring SMA inverters through modbus protocol
https://apps.athom.com/app/sma.modbus
GNU General Public License v3.0
5 stars 5 forks source link

SMA solar

This Homey app allows you to monitor your SMA solar devices using the modbus and speedwire protocol.

Supported devices

As of version 2 of the app the following device types are supported

Inverters

In the support topic is a shortened list of supported inverters. Version 2 of the app tries to figure out which capabilities each inverter has, using a mapping logic and will only show capabilities in Homey that the inverter supports. For instance, some inverters don't support daily yield, then this capability won't be displayed in Homey for that inverter.

The most basic capability set that all inverters should support are; grid power, grid voltage and total yield. If you only get these values on a "modern" inverter please comment in the support thread, most likely the mapping is incorrect.

Sunny Boy Storage

Shows operational status, battery, charge, discharge, power drawn, grid feed in and battery capacity of Sunny Boy Storage products using the modbus protocol.

Energy Meter

The Energy Meter device type supports both the Energy Meter and the Home Manager 2.0 products. Both products generate the same multicast datagrams required to access the built-in meter information. This device type will be recognized in Homey as a smart meter and visualized properly on the energy tab.

It can be used to load balance against the main fuse. There are three settings for the device, main fuze (A), threshold (%) and available current offset(A). Each phase (L1, L2, and L3) can trigger a phase utilization alert if a phase is loaded more than the threshold. There are two conditions to check for an individual phase's utilization or all phases. A global tag is published with currently 'Available current' in Amp.

Energy Summary

The Energy Summary is a virtual device that gathers information from inverter and energy meter devices registered in your Homey. It will only display information from inverters and energy meter devices from this app. It shows three values; PV Power, Grid Power, and Consumption.

PVOutput

Report your inverter(s) status to PVOutput.org. You need to have done the setup at PVOutput's site to setup a system and generate an API key before adding this device to your Homey.

Support topic

For support please use the official support topic on the forum here.

Enable modbus in your inverter/storage product

For Homey to be able to communicate with your inverter over the modbus protocol this needs to be enabled on the inverter. You can enable modbus communication using the SMA Sunny Explorer software or the webinterface on specific models (like the Sunny Boy 1.5 to Sunny Boy 5.0). For all other models download and install the SMA Sunny Explorer software, the installable is located under PC Software in the previous link. During installation it may ask you to install the .NET framework 3.5 as well. Now follow these steps.