====== SMA 2 Loxone ======

++++ Version History... |

[[https://github.com/mschlenstedt/LoxBerry-Plugin-SMA2Loxone/releases]]

++++

----

<WRAP center round important 100%>

== 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.

</WRAP>

===== 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-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)

<WRAP center round tip 100%>

== Bei Problemen... ==

Das Plugin nutzt die Library von [[https://github.com/littleyoda/pysma|Sven (Little Yoda): pysma-plus]]. **Vielen Dank an dieser Stelle!** Solltet ihr Probleme haben eure Geräte einzubinden, hilft eventuell ein Blick in [[https://github.com/littleyoda/pysma/blob/master/doc/faq_DE.md|die FAQ auf dem Github Projekt]]

</WRAP>

===== 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  |

{{plugins:sma2loxone:pasted:20240628-143031.png?500}}

Je nach Gerätetyp müssen unterschiedliche Daten zum Gerät eingegeben werden:

{{plugins:sma2loxone:pasted:20240628-142908.png?500}}

=== MQTT ===

In diesem Reiter kann sowohl das MQTT Topic als auch der Abfragezyklus (Delay) der Daten angepasst werden.

{{plugins:sma2loxone:pasted:20240628-141853.png?500}}

=== Upgrade ===

%%Das Plugin nutzt Library von %%[[https://github.com/littleyoda/pysma|https://github.com/littleyoda/pysma]] Diese Library kann hier upgedatet werden, falls irgendwelche Fehler auftreten sollten.

{{plugins:sma2loxone:pasted:20240628-143110.png?500}}

===== Einrichtung in der Loxone Config Software =====

Das Plugin sendet alle ausgelesenen Messwerte per MQTT an den MQTT Broker bzw. das [[konfiguration:widget_help:widget_mqtt:|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 [[konfiguration:widget_help:widget_mqtt:|MQTT Widget]] nach, wie genau die Werte in der Loxone Config verwendet werden: [[konfiguration:widget_help:widget_mqtt:mqtt_gateway:mqtt_schritt_fur_schritt_mqtt_loxone|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

===== Fragen stellen und Fehler melden =====

[[https://www.loxforum.com/forum/projektforen/loxberry/plugins/435651-neues-plugin-sma-2-loxone]]