SmartHomeNG SMA Modbus Plugin

Das Plugin liest die Daten mithilfe von PyModbus vom Wechselrichter, parst diese und schreibt den Wert in das Item zurück. Das Plugin kann mehrere Instanzen bedienen, was bedeutet, dass mehrer Wechselrichter eingebunden werden können. Als Beispiel kann der Wechselrichter für die Photovoltaik-Anlage (oder auch mehrere) sowie der Wechselrichter der Batterie ausgelesen werden.

Installation

Das Plugin von Github herunterladen und in den Plugin-Ordner der SmartHomeNG Installation kopieren.

Wichtig: Die Modbus-Schnittstelle muss im Wechselrichter aktiviert werden. Zur Aktivierung der Schnittstelle ist der Installateur-Zugang für den Wechselrichter notwendig.

Voraussetzungen

  • pymodbus >= 2.3.0
  • aktive Modus-Schnittstelle
  • Modbus Unit ID muss bekannt sein

Unterstütze/Getestet Geräte

  • SUNNY ISLAND 4.4M-13
  • SUNNY TRIPOWER 8.0

Konfiguration

Folgende Informationen müssen gesetzt werden (ist aber im Plugin beschrieben):

  • IP oder Hostnamen
  • Port vom Modbus-Interfache, Standard 502
  • Unit ID, Standard 3
  • Timeout, Standard 10
  • Abfrageintervall, Standard 60
  • Instanzname, falls das Plugin für mehrer Inverter in einer Installation genutzt werden.

Nach erfolgreicher Konfiguration, das Plugin aktivieren.

Benutzung

Die Angabe im Item erfolgt mit dem Trennzeichen - (Minus) und muss wie folgt aussehen: <Registeradresse SMA>-<Anzahl zusammenhängender SMA Register>-<Datentyp SMA>

Beispiel: 30005-2-U32

Die Platzhalter entsprechen der Beschreibung in der offiziellen MODBUS Spezfifikation von SMA. Spezifikation unter https://www.sma.de/produkte/monitoring-control/modbus-protokoll-schnittstelle.html → Downloads → Hintergrundwissen

Beispiel SUNNY TRIPOWER 8.0

pv.yaml
PV:
    Typenschild:
        Seriennummer:
            name: Seriennummer
            type: num
            smamodbus@pv: 30005-2-U32
        Geraeteklasse:
            name: Geräteklasse
            type: num
            smamodbus@pv: 30051-2-U32
        Gereatetype:
            name: Gerätetyp
            type: num
            smamodbus@pv: 30053-2-U32
    Leistung:
        name: Leistung in Watt
        smamodbus@pv: 30775-2-S32
        
        NennleistungOk:
            name: Nennleistung im Zustand Ok
            type: num
            smamodbus@pv: 30203-2-U32
    
    Zustand:
        name: Zustand
        type: num
        smamodbus@pv: 30201-2-U32
    
    Gesamtertrag:
        name: Gesamtertrag
        smamodbus@pv: 30513-4-U64
    Tagesertrag:
        name: Tagesertrag in W
        smamodbus@pv: 30539-2-U32

Beispiel SUNNY ISLAND 4.4M-13

batterie.yaml
Batterie:
    Typenschild:
        Seriennummer:
            name: Seriennummer
            type: num
            smamodbus@batterie: 30057-2-U32
            
    Ladezustand:
        name: Aktueller Batterieladezustand
        type: num
        smamodbus@batterie: 30845-2-U32
        
    ZaehlerstandVerbrauch:
        name: Zählerstand Verbrauchszähler
        type: num
        smamodbus@batterie: 30571-2-U32