SMA Sunny Webbox

Plugin to collect data from Sunny Webbox via Modbus.


The purpose of this plugin is to collect data from a SMA Sunny WebBox.


The purpose of this plugin is to collect data from SMA Sunny WebBox loggers via Modbus. The SMA_sunny_webbox_device_discovery.txt file shows the serial number as well as the available inverters/weather stations (devices) that can be read, and their corresponding bus address (called Unit ID). If all Unit IDs are showing as 255, the inverters need to be configured, please contact your Ardexa account manager. The SMA_sunny_webbox_config.txt file collects data from SMA inverters that are connected to the WebBox. The plugin uses the Modbus TCP Specification, and collects from TCP connected inverters only. Inverter data will be collected to the solar table, and will be run every 5 minutes, by default. This plugin relies on the Modbus Ardexa plugin. Please be aware that the GE servers may be accessed on Port 503,instead of the normal Port 502.

Variable                	  	        Units
Serial Number							
Insul Resist					Mohm
Total Energy					Wh	
Operating Hours					h	
Feed-In Hours					h	
DC Current					A	
DC Voltage					V	
DC Power					V	
AC Power					V	
AC Voltage 1					V	
AC Voltage 2					V	
AC Voltage 3					V	
AC Current					A	
AC Current 1					A	
AC Current 2					A	
AC Current 3					A	
Grid Freq					Hz	
Reactive Power					VAr
Apparent Power					VA	
Cos Phi							
Heatsink Temperature			        °C	
Module Temperature				°C	
Ambient Temperature				°C


Arguments are as follows:

  • endpoint. This is either an IP address like

  • bus_addresses. The bus address of the inverter(s)

  • --port. This is an optional parameter used in an Ethernet gateway, and is the TCP port used for the gateway. Default is 502

  • --attempts. This is an optional parameter, and determines how many times to times to attempt to read an inverter value. Default is 1

  • --delay. This is the delay in seconds between inverter send and receive commands, AND if attempts > 1. Fractions like 0.3 can be used. Default is 0.05

Last updated