Inhaltsverzeichnis
| Plugin-Daten | |
|---|---|
| Autor | Michael Schlenstedt |
| Logo |  |
| Status | STABLE |
| Version | 1.0.1 |
| Min. LB Version | 3.0.0 |
| Pre-Release Download | https://github.com/mschlenstedt/LoxBerry-Plugin-SMA2Loxone/archive/refs/tags/LoxBerry-Plugin-SMA2Loxone-1.0.1.zip |
| Beschreibung | Mit diesem Plugin können Geräte des Herstellers SMA (Umrichter Energiezähler) ausgelesen und dem Miniserver bereitgestellt werden. |
| Sprachen | EN, DE |
| Diskussion | https://www.loxforum.com/forum/projektforen/loxberry/plugins/435651-neues-plugin-sma-2-loxone |
SMA 2 Loxone
Debian 12 / Bookworm nötig!
Dieses Plugin läuft nur mit Python 3.11. Es ist somit ein LoxBerry V3.0 auf Dietpi Basis und Debian Bookworm notwendig.
Funktion des Plugins
Mit dem Plugin können Geräte des Herstellers SMA (Wechselrichter, Energy Meter, Sunny Home Manager 2) ausgelesen und die Werte an den Miniserver gesendet werden. Es ist eine Alternative zur Auslesung per Modbus/TCP und (soll) mehr Daten als die Modbus-Schnittstelle zur Verfügung stellen (z. B. Daten der einzelnen Strings).
Unterstützte Geräte:
- Geräte mit Webconnect-Webinterface
- Geräte basierend auf ennexOS (z. B. die Tripower X Serie)
- SMA Energy Meter (EMETER-10, EMETER-20) und Sunny Home Manager 2.0 (hm-20/shm2)
- Alle SMA Geräte über Speedwire - ohne Verschlüsselung (bei einigen Geräten mit reduziertem Umfang an Werten)
Bei Problemen...
Das Plugin nutzt die Library von Sven (Little Yoda): pysma-plus. Vielen Dank an dieser Stelle! Solltet ihr Probleme haben eure Geräte einzubinden, hilft eventuell ein Blick in die FAQ auf dem Github Projekt
Download
Download über den Link oben in der Tabelle. Der Sourcecode ist auf GitHub verfügbar: https://github.com/mschlenstedt/LoxBerry-Plugin-SMA2Loxone
Installation
Keine Besonderheiten, das Plugin wird ganz normal über die Pluginschnittstelle installiert.
Konfigurationsoptionen
Geräte
Alle Geräte, die über das Plugin ausgelesen werden sollen, müssen zunächst angelegt und konfiguriert werden. Dazu wählt man den Gerätetyp aus und klickt auf Hinzufügen. Folgende Typen / Methoden stehen zur Verfügung:
- ennexos
- shm2
- speedwireem (Energymeter)
- speedwireinv (Inverter)
- webconnect
Geräte wurden bisher getestet (Stand: 07/2024):
| Bereich | Gerät | Methode / Typ |
|---|---|---|
| Wechselrichter | Tripower X (STP XX-50) (12,15,25) | ennexos |
| Wechselrichter | Tripower (STP XX) (8,10) | speedwireinv |
| Hybrid-Wechselrichter | Sunny Tripower Smart Energy (10.0) | webconnect |
| Hybrid-Wechselrichter | Sunny Boy Storage (SBS3.7-10, SBS5.0-10) | webconnect |
| Hybrid-Wechselrichter | Sunny Boy Smart Energy 5.0 | ennexos |
| Batterie-Wechselrichter | Sunny Island 8.0H (SI 8.0H-12) | webconnect |
| Energy Meter | Energy Meter 2 (EMTER 20) | speedwireem |
| Energy Meter | Sunny Home Manager 2 (SHM2) | speedwireem |
Je nach Gerätetyp müssen unterschiedliche Daten zum Gerät eingegeben werden:
MQTT
In diesem Reiter kann sowohl das MQTT Topic als auch der Abfragezyklus (Delay) der Daten angepasst werden.
Upgrade
Das Plugin nutzt Library von https://github.com/littleyoda/pysma Diese Library kann hier upgedatet werden, falls irgendwelche Fehler auftreten sollten.
Einrichtung in der Loxone Config Software
Das Plugin sendet alle ausgelesenen Messwerte per MQTT an den MQTT Broker bzw. das MQTT Gateway. Im Gateway muss das Topic des Plugins abonniert werden (standardmäßig lautet das Topic "sma2loxone/#") - das wird aber automatisch vom Plugin gemacht. Bitte lest in der Dokumentation des MQTT Widget nach, wie genau die Werte in der Loxone Config verwendet werden: MQTT - Schritt für Schritt: MQTT -> Loxone
Ich behandele das Thema "Anlegen eines Virtuellen Eingangs" hier nur in Kürze:
- Virtuellen Eingang anlegen
- Bezeichnung aus der Incoming Overview des Gateway kopieren und im Virtuellen Eingang exakt so einfügen.
- Als Digitaleingang verwenden: NEIN
- Validierung korrekt setzen
Roadmap
Aktuell keine weiteren Funktionen geplant