Metainformationen zur Seite

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
plugins:sma2loxone:start [2024/06/28 12:32] – Michael Schlenstedtplugins:sma2loxone:start [2025/03/12 07:08] (aktuell) – Struct-Daten geändert Michael Schlenstedt
Zeile 8: Zeile 8:
  
 ---- ----
 +
 +<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 ===== ===== Funktion des Plugins =====
  
-→ Beschreibung welche Funktionen etc. das Plugin bietet+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 =====
  
-→ Zusätzliche Hinweise zum Download oder URL zu den Quelltexten+Download über den Link oben in der Tabelle. Der Sourcecode ist auf GitHub verfügbar: [[https://github.com/mschlenstedt/LoxBerry-Plugin-SMA2Loxone]]
  
 ===== Installation ===== ===== Installation =====
  
-→ Zusätzliche Hinweise zur Installation, Voraussetzungen, etc.+Keine Besonderheiten, das Plugin wird ganz normal über die Pluginschnittstelle installiert.
  
 ===== Konfigurationsoptionen ===== ===== Konfigurationsoptionen =====
  
-→ Beschreibung der Pluginkonfiguration+=== 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 ===== ===== Einrichtung in der Loxone Config Software =====
  
-→ Beschreibung wie die Einrichtung in de rLoxone Config erfolgt+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 ===== ===== Roadmap =====
  
-→ Was ist noch geplant?+Aktuell keine weiteren Funktionen geplant
  
 ===== Fragen stellen und Fehler melden ===== ===== Fragen stellen und Fehler melden =====
  
-→ Wo kann ich Fragen stellen und Fehler melden?+[[https://www.loxforum.com/forum/projektforen/loxberry/plugins/435651-neues-plugin-sma-2-loxone]]
  
  
Zeile 41: Zeile 109:
 pluginuebersicht.author : prof.mobilux pluginuebersicht.author : prof.mobilux
 pluginuebersicht.logo : :plugins:sma2loxone:icon_64.png pluginuebersicht.logo : :plugins:sma2loxone:icon_64.png
-pluginuebersicht.status : ALPHA +pluginuebersicht.status : STABLE 
-pluginuebersicht.version : 0.1.0+pluginuebersicht.version : 1.0.1
 pluginuebersicht.min_lb_version : 3.0.0 pluginuebersicht.min_lb_version : 3.0.0
 pluginuebersicht.url_release :  pluginuebersicht.url_release : 
-pluginuebersicht.url_prerelease : https://github.com/mschlenstedt/LoxBerry-Plugin-SMA2Loxone/archive/refs/tags/LoxBerry-Plugin-SMA2Loxone-0.1.0.zip+pluginuebersicht.url_prerelease : https://github.com/mschlenstedt/LoxBerry-Plugin-SMA2Loxone/archive/refs/tags/LoxBerry-Plugin-SMA2Loxone-1.0.1.zip
 pluginuebersicht.description : Mit diesem Plugin können Geräte des Herstellers SMA (Umrichter Energiezähler) ausgelesen und dem Miniserver bereitgestellt werden. pluginuebersicht.description : Mit diesem Plugin können Geräte des Herstellers SMA (Umrichter Energiezähler) ausgelesen und dem Miniserver bereitgestellt werden.
 pluginuebersicht.languages : EN, DE pluginuebersicht.languages : EN, DE
-pluginuebersicht.discussion : +pluginuebersicht.discussion : https://www.loxforum.com/forum/projektforen/loxberry/plugins/435651-neues-plugin-sma-2-loxone
 ---- ----