Homey Community Forum

SMA Inverters App


Monitor SMA inverters with Homey

App Store Page: https://apps.athom.com/app/sma.modbus


This Homey app allows you to monitor your SMA inverter through the modbus protocol interface. Modbus is a serial communications protocol often used in connecting industrial electronic devices. The app currently supports reading Current Power AC, Daily Yield, Voltage and Total Yield.

Supported devices

Below is a shortend list of supported inverters including the available connection types for each inverter. View the complete list of supported inverters in the second tab of this Google sheets document. Unfortunately the configuration for reading out the data of each of these converters seems to differ. I have only tested it with an older Sunny Boy 2500TL. Support for other inverters may need to be added seperately and might require some research. If you connect your inverter and you do not see correct values appear in the Homey device, please use the support topic to ask for support for your type of inverter.

Sunny Boy 2500TL Retrofit Webconnect Tested
Sunny Boy 3000TL-21 Retrofit Webconnect Tested
Sunny Boy 3600TL-21 Retrofit Webconnect Tested
Sunny Boy 1.5 / 2.5 Webconnect or WLAN Tested
Sunny Boy 3.0 / 3.6 / 4.0 / 5.0 Webconnect or WLAN Tested
Sunny Tripower 5/6/7/8/9/10/12000TL-20 Webconnect Tested and daily yield data is not available
Sunny Tripower 15/20/25000TL-30 Webconnect Untested
Sunny Tripower Core1 (50KW) Webconnect or Datamanager M Untested
Sunny Tripower 60 + Inverter Manager Ethernet Untested
Sunny Tripower Peak1 + Inverter Manager Ethernet Untested


For Homey to be able to communicate with your SMA 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.

  1. Start Sunny Explorer installer and choose to create a new install (or load a previous one if you used Sunny Explorer before) or start the webinterface for the Sunny Boy 1.5 to Sunny Boy 5.0 models;
  2. Select Speedwire as communication protocol, hit next and wait for Sunny Explorer to discover your inverter. Once found select your inverter (and remember it’s IP address);
  3. In the login screen select the “Installer” user. Enter the password, by default password this is 1111 but this might have been changed by your installer. In this case you will have to retrieve it from your installer;
  4. Once logged in to your inverter wait for a moment for the data to load. Then click on your inverter in the left pane and after that on the settings tab. Click on the external communications menu item and click on edit. Now enable the option ‘Modbus TCP Server’ and if available and not already enabled the option ‘Webconnect’. You can leave the port for the Modbus TCP Server to the default 502. If you change it here make sure you enter it correctly when adding the inverter in Homey. If you have saved your changes you can close Sunny Explorer.
  5. Now go into Homey and add a new device. Select the inverter device from the SMA Inverters app and enter the IP address, Port and Polling Frequency. The polling frequency determines how often Homey reads out the inverter. The default 5 seconds should be good. Now add the device and if all went well your inverter is now being monitored by Homey.


v1.1.0 - 2019-04-17

  • NEW: support for Sunny Boy Storage

v1.0.4 - 2019-02-09

  • FIX: improvements to pairing template for firmware 2.x
  • IMPROVEMENT: remove unnecassary lodash node module

v1.0.3 - 2018-12-14

  • FIX: update compatibility to enable install on Homey firmware v2.x

v1.0.2 - 2018-09-05

FIX: device registered as unavailable where not set to available again

v1.0.1 - 2018-09-02

  • FIX: display daily yield in KWh instead of Wh
  • FIX: display total yield in MWh instead of Wh
  • FIX: fix an issue with “Index out of range” errors
  • IMPROVEMENT: switched node library for ready out modbus
  • IMPROVEMENT: changed title of capability meter_power to Daily Yield

v1.0.0 - 2018-08-27

NEW: initial release

This app is what i’m looking for! But looks like the app is not available on the appstore (found a blindspot).
Is there a another way to get this app?

Either wait until Athom approves the app and I can publish it or do a CLI install from the Github repository.

Thank you I’am very happy with it.

Good to hear @Rob. Im interested to know which type of SMA inverter you are using the app with so I can update the documentation with this information.

I’am using a Sunny Boy 3600TL-21

First of all, t h a n k you for creating this app.I have a Tripower 6000TL 20. Am not able yet to read the data; I think I miss the ability to change the sma settings(no pc for the mentioned software, or didn’t find a Web Interface). Any suggestions on how to configure my sma is more than welcome.

Check out the link below. It contains all the information on how to connect SMA inverters. Perhaps you can use the web portal or the smartphone app. It would be nice if you could report back if you managed it.


Hi @phuturist, I did this… Unfortunately I do not have access to my inverter… I do have Webconnect, to transfer data to Sunny portal.

  • Display: too dangerous, needs to open my Inverter
  • Web connect via Sunny explorer: Only available via PC software
  • SMA Portal: do not have settings to change Modbus

This is a quote from the manual:

8.6 Configuring the Modbus Function
The Modbus interface is deactivated by default and the communication ports 502 set. In order to access SMA invertes with SMA Modbus® or SunSpec® Modbus®, the Modbus interface must be activated. After activating the interface, the communication ports of both IP protocols can be changed.
For information on commissioning and configuration of the Modbus interface, see the Technical Information “SMA Modbus® Interface” or in the Technical Information “SunSpec® Modbus® Interface” at www.SMA-Solar.com.
Data security during activated Modbus interface
If you activate the Modbus interface, there is a risk that unauthorized users may access and manipulate the data or devices in your PV system.
• Take appropriate protective measures such as:
– Set up a firewall.
– Close unnecessary network ports.
– Only enable remote access via VPN tunnel.
– Do not set up port forwarding at the communication port in use.
– In order to deactivate the Modbus interface, reset the inverter to default settings or deactivate the activated parameter again.
the Modbus interface and adjust the communication ports if necessary (see the
• Activate
Technical Information “SMA Modbus® Interface” or “SunSpec® Modbus® Interface” at www.SMA-Solar.com).

Well, the best solution is to borrow a PC/laptop from your neighbour, install Sunny Explorer, enable modbus, deinstall Sunny Explorer and return the PC/laptop … :wink:

LOL asked first “De Zonnefabriek” my supplier to make the change, otherwise will ask my neighbour or someone else…

v1.0.1 - 2018-09-02

  • FIX: display daily yield in KWh instead of Wh
  • FIX: display total yield in MWh instead of Wh
  • FIX: fix an issue with “Index out of range” errors
  • IMPROVEMENT: switched node library for ready out modbus
  • IMPROVEMENT: changed title of capability meter_power to Daily Yield

v1.0.2 - 2018-09-05

FIX: device registered as unavailable where not set to available again

Hi @Phuturist, At first thank you very much for creating this app. At this moment my inverter (SB3600TL-21) only supports bluetooth. Is there a way to use your app with bluetooth or do I need to buy the stuff to make a connection through with ethernet?

This app will only work with the modbus protocol which is only available as TCP (WiFi or Ethernet). If you want to use this app you will have to buy the stuff … :wink:

Werkt prachtig met de SB 4000TL-21 omvormer , mijn dank aan de maker van deze app

Thanx for confirming this works as well with the Sunny Boy 3.0 / 3.6 / 4.0 / 5.0 inverters.

Werkt perfect met de SB3.6-1AV-40 910

This is only blue tooth for me. We are talking about the 4000 BT or not?