Inhaltsverzeichnis

SmartHomeNG SMA Modbus Plugin

This plugin for SmartHomeNG reads data from an SMA inverter via modbus interface and write the values to an item. It is a multi instance plugin and can be used for one or more inverters.

For example, it could be used for an photovoltaic invertert and also for an battery inverter.

Installation

Download the latest release from Github and place it in your plugin folder of the SmartHomeNG installation. Restart SmartHomeNG service. Follow up the next step.

Important: The modbus interface needs to be activated at the inverter. For activation, privileged access is requiered.

Voraussetzungen

Suppported/Tested devices

Konfiguration

The following parameters are requiered to get plugin running:

After the configuration is done, the plugin must be activated, than it should work an receive data from your inverter.

Usage

Items need a new attribute to receive the data. If you use this plugin for more than one inverter, you need to work with the @.

Please refere to your inverter specification SMA modbuslist.

smamodbus@<inverter-instance-name>: <Register adresse SMA>-<Number of contguous SMA register>-<Data type SMA>

Example item: smamodbus@battery: 30005-2-U32

Official MODBUS specification for SMA products: https://www.sma.de/produkte/monitoring-control/modbus-protokoll-schnittstelle.html → Downloads → Background knowledge (Hintergrundwissen)

Example 1

You can read the serial number from the inverter. The instance name of the plugin in this example is „pv“ and the used specification is for a SUNNY TRIPOWER 8.0 „MODBUS-HTML_STP8.0-10.0-3AV-40_GG10_V10“ (Firmware version 1.1.18.R), see the folder „specs“ for further information.

pv.yaml
PV:
    Typelable:
        serialnumber:
            name: serial number
            type: num
            smamodbus@pv: 30005-2-U32

Example 2

This example will receive the battery charge level of the SUNNY ISLAND 4.4M-13 inverter, see the specs MODBUS-HTML_SI44M-80H-13_32009R_V10. The instance name here is battery.

batterie.yaml
ChargeLevel:
    name: Current battery charge level
    type: num
    smamodbus@battery: 30845-2-U32