Metainformationen zur Seite
Dies ist eine alte Version des Dokuments!
| Plugin-Daten | |
|---|---|
| Autor | Michael Schlenstedt |
| Logo |  |
| Status | ALPHA |
| Version | 0.1.1 |
| Min. LB Version | 3.0.0 |
| Pre-Release Download | https://github.com/mschlenstedt/LoxBerry-Plugin-SMA2Loxone/archive/refs/tags/LoxBerry-Plugin-SMA2Loxone-0.1.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 [[https://www.sma.de/|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-Interface
- 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 (mit reduziertem Umfang an Werten)
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:
| Bereich | Gerät | Methode / Typ |
|---|---|---|
| Wechselrichter | Tripower X (STP XX-50) (12,15,25) | ennexos |
| Hybrid-Wechselrichter | Sunny Tripower Smart Energy (10.0) | webconnect |
| Hybrid-Wechselrichter | Sunny Boy Storage (SBS3.7-10, SBS5.0-10) | webconnect |
| Energy Meter | Energy Meter 2 (EMTER 20) | speedwireem |
| Energy Meter | Sunny Home Manager 2 (SHM2) | shm2 |
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