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:debmatic:start [2023/04/14 10:26] – [Einrichtung Node Red / MQTT Anbindung ===== Für die Anbindung der Homematic CCU an das [[konfiguration:widget_help:widget_mqtt|MQTT Gateway]] des LoxBerry und damit später an die Loxone Config nutzen wir Red Matic. Hier ist nur ein sehr kurzer Flow für Michael Schlenstedtplugins:debmatic:start [2025/05/26 05:54] (aktuell) – Struct-Daten geändert Michael Schlenstedt
Zeile 11: Zeile 11:
 ===== Funktion des Plugins ===== ===== Funktion des Plugins =====
  
-Das Plugin installiert [[https://github.com/alexreinert/debmatic|DebMatic von Alexander Reinert]] auf dem LoxBerry. Damit steht eine vollwertige Homematic CCU3 auf dem LoxBerry bereit, die über Node Red und MQTT direkt mit dem LoxBerry bzw. Miniserver kommuniziert. Sämtliche Homematic Sensoren und Aktoren können ausgelesen und gesteuert werden. Zur Nutzung des Plugins ist ein Homematic Funkadapter notwendig, den es als Modul für den Raspberry Pi in verschiedenen Ausführungen gibt (siehe unten unter Hardware). Die Anbindung der Funkmodule kann anstelle über die GPIO Leiste auch über die USB- oder Ethernet-Platine von Alexander Reinert erfolgen. Damit ist ein Betreiben des Plugins auch in einer VM möglich. Eine separate CCU2/CCU3 ist nicht mehr nötig. Die Sensoren/Aktoren stehen als vollwertige Geräte in Loxone Config zur Verfügung.+Das Plugin installiert [[https://github.com/alexreinert/debmatic|DebMatic von Alexander Reinert]] auf dem LoxBerry. Damit steht eine vollwertige Homematic CCU3 auf dem LoxBerry bereit, die über CCUJack oder Node Red und MQTT direkt mit dem LoxBerry bzw. Miniserver kommuniziert. Sämtliche Homematic Sensoren und Aktoren können ausgelesen und gesteuert werden. Zur Nutzung des Plugins ist ein Homematic Funkadapter notwendig, den es als Modul für den Raspberry Pi in verschiedenen Ausführungen gibt (siehe unten unter Hardware). Die Anbindung der Funkmodule kann anstelle über die GPIO Leiste auch über die USB- oder Ethernet-Platine von Alexander Reinert erfolgen. Damit ist ein Betreiben des Plugins auch in einer VM möglich. Eine separate CCU2/CCU3 ist nicht mehr nötig. Die Sensoren/Aktoren stehen als vollwertige Geräte in Loxone Config zur Verfügung.
  
 ===== Download ===== ===== Download =====
Zeile 26: Zeile 26:
 ===== Unterstützte Hardware ===== ===== Unterstützte Hardware =====
  
-===== Architekturen =====+==== Architekturen ====
  
 Das Plugin läuft auf den folgenden Hardware Architekturen: Das Plugin läuft auf den folgenden Hardware Architekturen:
Zeile 34: Zeile 34:
   * **x64**, z. B. VMs (getestet: Virtual Box und Proxmox, andere sollten ebenfalls laufen)   * **x64**, z. B. VMs (getestet: Virtual Box und Proxmox, andere sollten ebenfalls laufen)
  
-===== Funkmodul HM-MOD-RPI-PCB (Älteres Modul) =====+==== Funkmodul HM-MOD-RPI-PCB (Älteres Modul) ====
  
-{{plugins:debmatic:pasted:20230414-065454.png?500}}+{{plugins:debmatic:pasted:20230414-065454.png?300}}
  
 //Aufgestecktes HM-MOD-RPI-PCB auf einem Raspberry Pi, Quelle: [[https://de.elv.com/elv-homematic-komplettbausatz-funkmodul-fuer-raspberry-pi-hm-mod-rpi-pcb-fuer-smart-home-hausautomation-142141|ELV Webshop]]// //Aufgestecktes HM-MOD-RPI-PCB auf einem Raspberry Pi, Quelle: [[https://de.elv.com/elv-homematic-komplettbausatz-funkmodul-fuer-raspberry-pi-hm-mod-rpi-pcb-fuer-smart-home-hausautomation-142141|ELV Webshop]]//
Zeile 42: Zeile 42:
 Das ältere Funkmodul HM-MOD-RPI-PCB als Aufsteckvariante für die GPIO-Schnittstelle des Raspberry Pi wird von DebMatic voll unterstützt. Das Modul besteht aus zwei Einzel-Platinen, die von [[https://de.elv.com/elv-homematic-komplettbausatz-funkmodul-fuer-raspberry-pi-hm-mod-rpi-pcb-fuer-smart-home-hausautomation-142141|eQ-3 über den Webshop von ELV]] (als Bausatz ab etwa 20€) verkauft werden. Der Zusammenbau gelingt leicht. Das Funkmodul funktioniert auch auf anderen Single Board Computern, deren GPIO-Leiste kompatibel mit der des Raspberry Pi sind: [[https://github.com/alexreinert/debmatic#voraussetzung-f%C3%BCr-hm-mod-rpi-pcb-und-rpi-rf-mod]] Das ältere Funkmodul HM-MOD-RPI-PCB als Aufsteckvariante für die GPIO-Schnittstelle des Raspberry Pi wird von DebMatic voll unterstützt. Das Modul besteht aus zwei Einzel-Platinen, die von [[https://de.elv.com/elv-homematic-komplettbausatz-funkmodul-fuer-raspberry-pi-hm-mod-rpi-pcb-fuer-smart-home-hausautomation-142141|eQ-3 über den Webshop von ELV]] (als Bausatz ab etwa 20€) verkauft werden. Der Zusammenbau gelingt leicht. Das Funkmodul funktioniert auch auf anderen Single Board Computern, deren GPIO-Leiste kompatibel mit der des Raspberry Pi sind: [[https://github.com/alexreinert/debmatic#voraussetzung-f%C3%BCr-hm-mod-rpi-pcb-und-rpi-rf-mod]]
  
-===== Funkmodul RPI-RF-MOD (Neues Modul) =====+==== Funkmodul RPI-RF-MOD (Neues Modul) ====
  
-{{plugins:debmatic:pasted:20230414-070204.png?500}}+{{plugins:debmatic:pasted:20230414-070204.png?300}}
  
 //Aufgestecktes RPI-RF-MOD auf einem Raspberry Pi, Quelle: [[https://de.elv.com/elv-komplettbausatz-funk-modulplatine-fuer-raspberry-pi-3-b-rpi-rf-mod-fuer-homematic-und-homematic-ip-152941?fs=2225752130&c=381|ELV Internetshop]]// //Aufgestecktes RPI-RF-MOD auf einem Raspberry Pi, Quelle: [[https://de.elv.com/elv-komplettbausatz-funk-modulplatine-fuer-raspberry-pi-3-b-rpi-rf-mod-fuer-homematic-und-homematic-ip-152941?fs=2225752130&c=381|ELV Internetshop]]//
Zeile 58: Zeile 58:
 </WRAP> </WRAP>
  
-===== Zusatz-Platine HB-RF-USB-TK von Alexander Reinert =====+==== Zusatz-Platine HB-RF-USB-TK von Alexander Reinert ====
  
-{{plugins:debmatic:pasted:20230414-071535.png?500}}+{{plugins:debmatic:pasted:20230414-071535.png?300}}
  
 //HB-RF-USB-TK Platine, Quelle: [[https://smartkram.de/hardware-shop/produkte/bauteile-zentralen/diy-bausaetze/platine-hb-rf-usb-tk/|Smartkram Webshop]]// //HB-RF-USB-TK Platine, Quelle: [[https://smartkram.de/hardware-shop/produkte/bauteile-zentralen/diy-bausaetze/platine-hb-rf-usb-tk/|Smartkram Webshop]]//
Zeile 70: Zeile 70:
 Die Platine kann auch als Bausatz fertig bestellt werden: [[https://smartkram.de/hardware-shop/produkte/bauteile-zentralen/diy-bausaetze/platine-hb-rf-usb-tk/]] Die Platine kann auch als Bausatz fertig bestellt werden: [[https://smartkram.de/hardware-shop/produkte/bauteile-zentralen/diy-bausaetze/platine-hb-rf-usb-tk/]]
  
-===== Zusatz-Platine HB-RF-USB-2 von Alexander Reinert =====+==== Zusatz-Platine HB-RF-USB-2 von Alexander Reinert ====
  
-{{plugins:debmatic:pasted:20230414-072226.png?500}}+{{plugins:debmatic:pasted:20230414-072226.png?300}}
  
 //HB-RF-USB-2 Platine, Quelle: [[https://smartkram.de/hardware-shop/produkte/bauteile-zentralen/diy-bausaetze/platine-hb-rf-usb-2/|Smartkram Webshop]]// //HB-RF-USB-2 Platine, Quelle: [[https://smartkram.de/hardware-shop/produkte/bauteile-zentralen/diy-bausaetze/platine-hb-rf-usb-2/|Smartkram Webshop]]//
Zeile 82: Zeile 82:
 Die Platine kann auch als Bausatz fertig bestellt werden: [[https://smartkram.de/hardware-shop/produkte/bauteile-zentralen/diy-bausaetze/platine-hb-rf-usb-2/]] Die Platine kann auch als Bausatz fertig bestellt werden: [[https://smartkram.de/hardware-shop/produkte/bauteile-zentralen/diy-bausaetze/platine-hb-rf-usb-2/]]
  
-===== Zusatz-Platine HB-RF-ETH von Alexander Reinert =====+==== Zusatz-Platine HB-RF-ETH von Alexander Reinert ====
  
-{{plugins:debmatic:pasted:20230414-072908.png?500}}+{{plugins:debmatic:pasted:20230414-072908.png?300}}
  
 //HB-RF-ETH Platine, Quelle: [[https://smartkram.de/hardware-shop/produkte/bauteile-zentralen/diy-bausaetze/platine-hb-rf-eth/|Smartkram Webshop]]// //HB-RF-ETH Platine, Quelle: [[https://smartkram.de/hardware-shop/produkte/bauteile-zentralen/diy-bausaetze/platine-hb-rf-eth/|Smartkram Webshop]]//
Zeile 104: Zeile 104:
 {{plugins:loxmatic:1228539122.png?500}} {{plugins:loxmatic:1228539122.png?500}}
  
-Im Plugin können die Ports der Homematic WebUI und von Node Red konfiguriert werden. Ändert diese Werte nur, wenn ihr wisst was ihr tut und wenn dieses bei Konflikten mit anderen Diensten unbedingt notwendig ist. Wenn ihr die Ethernet-Platine von Alexander Reinert nutzt, dann könnt ihr hier die IP-Adresse der Platine eingeben oder auch automatisch danach suchen lassen. Wenn das Plugin das Ethernet-Modul automatisch gefunden und aktiviert hat, ihr es aber z. B. in einer anderen Installation im Haus nutzen wollt, könnt ihr es hier wieder deaktivieren.+Im Plugin können die Ports der Homematic WebUI, von Node Red und von CCU-Jack konfiguriert werden. Ändert diese Werte nur, wenn ihr wisst was ihr tut und wenn dieses bei Konflikten mit anderen Diensten unbedingt notwendig ist. Wenn ihr die Ethernet-Platine von Alexander Reinert nutzt, dann könnt ihr hier die IP-Adresse der Platine eingeben oder auch automatisch danach suchen lassen. Wenn das Plugin das Ethernet-Modul automatisch gefunden und aktiviert hat, ihr es aber z. B. in einer anderen Installation im Haus nutzen wollt, könnt ihr es hier wieder deaktivieren.
  
-{{plugins:debmatic:pasted:20230414-075206.png}}+{{plugins:debmatic:pasted:20240403-124845.png?500}}
  
 ===== Einrichtung Homematic CCU ===== ===== Einrichtung Homematic CCU =====
  
-Die Einrichtung der Homematic CCU wird hier nicht weiter beschrieben. Alles funktioniert wie auf einer Original-CCU von Homematic. Erweiterungen lassen sich auf DebMatic allerdings nicht installieren bzw. dieses muss über ''apt-get'' auf der Kommandozeile geschehen. Wer auf die XML-Api zugreifen möchte, nutzt folgenden Link:+Die Einrichtung der Homematic CCU wird hier nicht weiter beschrieben. Alles funktioniert wie auf einer Original-CCU von Homematic. Erweiterungen lassen sich auf DebMatic allerdings nicht installieren bzw. dieses muss über ''apt-get'' auf der Kommandozeile geschehen. Alle verfügbaren Erweiterungen (wie z. B. CuxD) sind aber bereits vorinstalliert. Näheres auf der [[https://github.com/alexreinert/debmatic|Debmatic Homepage]].
  
-%%''https://<LOXBERRY IP>:8081/addons/xmlapi/info.html''%%+Wer auf die XML-Api zugreifen möchte, nutzt folgenden Link:
  
-Vergebt für eure Geräte und für jeden einzelnen Ein- oder Ausgang entsprechende Namen. Diese Namen erscheinen später in der MQTT Anbindung und damit auch im Miniserver. Das vereinfacht hier die weitere Konfiguration und ihr könnt zudem später (z. B. bei einem Defekt) einen Sensor/Aktor einfach austauschen, ohne dass ihr die weitere Konfiguration in der LoxoneConfig anpassen müsst. +''%%https://<LOXBERRY IP>:8081/addons/xmlapi/info.html%%''
-===== Einrichtung Node Red / MQTT Anbindung =====+
  
-Für die Anbindung der Homematic CCU an das [[konfiguration:widget_help:widget_mqtt|MQTT Gateway]] des LoxBerry und damit später an die Loxone Config nutzen wir Red Matic. Hier ist nur ein sehr kurzer Flow für eine komplette MQTT-Anbindung in beide Richtungen notwendig. Startet die Red Matic WebUI über das Plugin.+<WRAP center round tip 100%>
  
-In Node Red seht ihr auf der linken Seite verschiedene Ein- und Ausgänge und Funktionsbausteine. Zunächst zieht ihr 2 Bausteine **Netzwerk -> MQTT in//** in euren Flow. Mit Doppelklick konfiguriert ihr folgende beiden Topics, an die ihr später entsprechende Befehle senden könnt, die von Homematic dann an die Aktoren weitergegeben werden:+Vergebt für eure Geräte und für jeden einzelnen Ein- oder Ausgang entsprechende Namen. Diese Namen erscheinen später in der MQTT Anbindung (nur über NodeRed) und damit auch im Miniserver. Das vereinfacht hier die weitere Konfiguration und ihr könnt zudem später (z. B. bei einem Defekt) einen Sensor/Aktor einfach austauschen, ohne dass ihr die weitere Konfiguration in der LoxoneConfig anpassen müsst. 
 + 
 +</WRAP> 
 + 
 +===== MQTT Anbindung an Loxone ===== 
 + 
 +Debmatic bietet insgesamt 3 Möglichkeiten an, eure Loxone-Installation an die Homematic anzubinden. Alle 3 Möglichkeiten funktionieren und können uneingeschränkt verwendet werden. Wählt die Variante, die Euch am Besten zusagt. Ich persönlich verwende die Anbindung per CCU-Jack. 
 + 
 +== Anbindung über CCU-Jack und MQTT (Empfohlen!) == 
 + 
 +CCU-Jack wird aktiv weiterentwickelt und verbindet die Homematic-Welt mit MQTT und damit auch über den LoxBerry mit der Loxone-Welt. Eigentlich wurde es entwickelt, um Nicht-Homematic-Geräte wie z. B. einen Shelly über MQTT an Homematic anzubinden. Diese Funktion ist für Loxone eher uninteressant. Es bindet aber auch alle Homematicgeräte an MQTT an und so kann man diese über MQTT und den LoxBerry auslesen und auch steuern. 
 + 
 +Eine Anleitung zur Konfiguration findet sich unten. 
 + 
 +== Anbindung über NodeRed und MQTT == 
 + 
 +Eine Anbindung über NodeRed und MQTT war lange Zeit die beste Möglichkeit, die Homematic-Welt mit Loxone zu verbinden. Leider wird das NodeRed-Modul seit mehreren Jahren nicht mehr aktiv weiterentwickelt. Noch funktioniert es aber einwandfrei und ohne Probleme. Weitere Infos zur Einrichtung unten und auf der NodeRed Homepage: [[https://flows.nodered.org/node/node-red-contrib-ccu|https://flows.nodered.org/node/node-red-contrib-ccu]] 
 + 
 +Das Modul wird automatisch mit Debmatic mit installiert. 
 + 
 +== "Klassische" Anbindung über Skripte auf der Homematic == 
 + 
 +Debmatic installiert eine vollwertige CCU, daher kann auch diese "klassische" Variante nach wie vor verwendet werden. Eine Anleitung dazu findet sich im LoxWiki: [[https://loxwiki.atlassian.net/wiki/spaces/LOX/pages/1529023557/Homematic+in+Loxone+integrieren|https://loxwiki.atlassian.net/wiki/spaces/LOX/pages/1529023557/Homematic+in+Loxone+integrieren]] 
 + 
 +==== Einrichtung von CCU-Jack ==== 
 + 
 +<WRAP center round tip 100%> 
 + 
 +Standard User: ''loxberry'' 
 + 
 +Standard Passwort: ''loxberry'' 
 + 
 +</WRAP> 
 + 
 +Vergebt zunächst ein sicheres Passwort für den Zugriff auf CCU-Jack. Die entsprechenden Konfigurationsmöglichkeiten findet ihr unter //Konfiguration --> Zugriffsberechtigungen// 
 + 
 +{{plugins:debmatic:pasted:20240403-162146.png?600}} 
 + 
 +CCU-Jack bietet zwei Möglichkeiten an, wie Werte von der Homematic eingelesen und auch Werte an die Homematic gesendet werden können: HTTP (REST API) und MQTT. Wir verwenden die MQTT-Schnittstelle im LoxBerry. Wer lieber HTTP verwenden möchte, der findet hier die entsprechende Anleitung dazu: [[https://github.com/mdzio/ccu-jack/wiki/CURL|https://github.com/mdzio/ccu-jack/wiki/CURL]] 
 + 
 +Die Dokumentation zur MQTT Anbindung von CCU-Jack findet ihr hier: [[https://github.com/mdzio/ccu-jack/wiki/MQTT-Server|https://github.com/mdzio/ccu-jack/wiki/MQTT-Server]] 
 + 
 +CCU-Jack bringt dabei seinen eigenen MQTT-Server mit, der direkt an die Homematic CCU angebunden ist. Diesen MQTT Server nutzen wir __nicht__. Wir verwenden den sogenannten [[https://github.com/mdzio/ccu-jack/wiki/MQTT-Bridge|Bridge Mode]], der alle Datenpunkte des internen MQTT-Servers an den LoxBerry MQTT-Server (Mosquitto) durchreicht. Die Kommunikation erfolgt dabei in beiden Richtungen. Daher ist es wichtig, dass der interne MQTT-Server von CCU-Jack nicht auf den Standardports des LoxBerry MQTT-Servers läuft (siehe oben unter Konfiguration. Nutzt hier auf keinen Fall die Ports 1883 und 8883!). Letztendlich haben wir mit dem internen MQTT-Server von CCU-Jack "nichts zu tun". Das Plugin hat den Bridge Mode während der Installation konfiguriert - ihr braucht Euch darum nicht zu kümmern. 
 + 
 +Sämtliche Datenpunkte der Homematic (Geräte und entsprechend konfigurierte Systemvariablen - zur Nutzung von Systemvariablen [[https://github.com/mdzio/ccu-jack/wiki/MQTT-Server|siehe Dokumentation]]) werden automatisch unter dem Topic ''ccu-jack'' an den LoxBerry MQTT Server übermittelt und können dort wie gewohnt weiterverwendet werden. Die Topics folgen dabei dem Schema: 
 + 
 +''ccujack/device/**status**/Seriennr./Kanalnr./Parametername'' 
 + 
 +{{plugins:debmatic:pasted:20240403-175554.png?600}} 
 + 
 +Um Werte an einen Aktor zu senden, verwendet ihr folgendes Topic-Schema: 
 + 
 +''ccujack/device/**set**/Seriennr./Kanalnr./Parametername'' 
 + 
 +Wie ihr einen entsprechenden VIrtuellen Ausgang anlegt, findet ihr in der Dokumentation des MQTT Widgets: [[konfiguration:widget_help:widget_mqtt:mqtt_gateway:mqtt_schritt_fur_schritt_loxone_mqtt]] 
 + 
 +Meine Funksteckdose vom **Typ HM-ES-PMSw1-Pl** zum Beispiel wird so eingeschaltet: 
 + 
 +''%%http://username:passwort@loxberry/admin/plugins/mqttgateway/mqtt.php?topic=ccujack/device/set/OEQ0731234/1/STATE&value=true%%'' 
 + 
 +{{plugins:debmatic:pasted:20240403-215659.png?400}}  {{plugins:debmatic:pasted:20240403-215905.png?400}} 
 + 
 +==== Einrichtung Node Red ==== 
 + 
 +Für die Anbindung der Homematic CCU an das [[konfiguration:widget_help:widget_mqtt|MQTT Gateway]] des LoxBerry und damit später an die Loxone Config nutzen wir RedMatic. Hier ist nur ein sehr kurzer Flow für eine komplette MQTT-Anbindung in beide Richtungen notwendig. Startet die Red Matic WebUI über das Plugin. 
 + 
 +In Node Red seht ihr auf der linken Seite verschiedene Ein- und Ausgänge und Funktionsbausteine. Zunächst zieht ihr 2 Bausteine **//Netzwerk -> MQTT in//** in euren Flow. Mit Doppelklick konfiguriert ihr folgende beiden Topics, an die ihr später entsprechende Befehle senden könnt, die von Homematic dann an die Aktoren weitergegeben werden:
  
 ''hm/set/#'' ''hm/set/#''
Zeile 125: Zeile 190:
 ''hm/paramset/#'' ''hm/paramset/#''
  
-{{plugins:debmatic:pasted:20230414-090657.png?500}}  Über den Bleistift neben Server konfiguriert ihr nun einmalig den MQTT Server. Diesen wählt ihr dann bei den folgenden Ein- und Ausgängen einfach aus - er muss also nur einmal eingerichtet werden. Die Serveradresse ist **//127.0.0.1//** (localhost), unter Sicherheit setzt ihr noch Username und Passwort für den MQTT Server, welche ihr aus dem [[konfiguration:widget_help:widget_mqtt|MQTT Widget]] entnehmt:  {{plugins:debmatic:pasted:20230414-092934.png?500}}  Als nächstes zieht ihr 1 Baustein **//Netzwerk -> MQTT out//** in euren Flow. Dieser wird wie folgt konfiguriert:  {{plugins:debmatic:pasted:20230414-091704.png?500}}  Als letztes zieht ihr noch unter **//ccu -> mqtt//** einen CCU-MQTT-Baustein in die Config. An diesen Baustein verbindet ihr die drei oben erstellten Ein- und Ausgänge. Der MQTT-Baustein wird wie folgt konfiguriert:  Zunächst fügt ihr über den Bleistift bei CCU eine neue CCU hinzu. Als IP Adresse wird hier **//127.0.0.1//** (localhost) eingetragen. Hakt weiter unten die Services an, die ihr über das MQTT Gateway übertragen wollt.  {{plugins:debmatic:pasted:20230414-092225.png?500}}  Anschließend konfiguriert ihr Euch den Node passend: Die Topics lasst ihr voreingestellt, je nachdem welche Daten ihr später in der Loxone Config weiterwenden wollt, setzt ihr unten JSON auf "Extended" (Achtung! **Sehr** viele Daten) oder "Basic" (empfohlen).  {{plugins:debmatic:pasted:20230414-092536.png?500}}  Zum Schluss aktiviert ihr euren neuen Flow über die Schaltfläche rechts oben "**Übernahme (deploy)**":  {{plugins:debmatic:pasted:20230414-093103.png?300}}  ===== Einrichtung in der Loxone Config Software =====  Die Einrichtung in der Loxone Config wird im MQTT Widget näher beschrieben: [[konfiguration:widget_help:widget_mqtt]]  ===== Roadmap =====  ===== Fragen stellen und Fehler melden =====+{{plugins:debmatic:pasted:20230414-090657.png?500}} 
 + 
 +Über den Bleistift neben Server konfiguriert ihr nun einmalig den MQTT Server. Diesen wählt ihr dann bei den folgenden Ein- und Ausgängen einfach aus - er muss also nur einmal eingerichtet werden. Die Serveradresse ist **//127.0.0.1//** (localhost), unter Sicherheit setzt ihr noch Username und Passwort für den MQTT Server, welche ihr aus dem [[konfiguration:widget_help:widget_mqtt|MQTT Widget]] entnehmt: 
 + 
 +{{plugins:debmatic:pasted:20230414-092934.png?500}} 
 + 
 +Als nächstes zieht ihr einen Baustein **//Netzwerk -> MQTT out//** in euren Flow. Dieser wird wie folgt konfiguriert: 
 + 
 +{{plugins:debmatic:pasted:20230414-091704.png?500}} 
 + 
 +Als letztes zieht ihr noch unter **//ccu -> mqtt//** einen CCU-MQTT-Baustein in die Config. An diesen Baustein verbindet ihr die drei oben erstellten Ein- und Ausgänge. Seht ihr die CCU-Bausteine nicht, könnt ihr diese über Menü --> Palette verwalten nachinstallieren. Sucht dazu nach "%%node-red-contrib-ccu".%% 
 + 
 +Zunächst fügt ihr über den Bleistift bei CCU eine neue CCU hinzu. Als IP Adresse wird hier **//127.0.0.1//** (localhost) eingetragen. Hakt weiter unten die Services an, die ihr über das MQTT Gateway übertragen wollt. 
 + 
 +{{plugins:debmatic:pasted:20230414-092225.png?500}} 
 + 
 +Anschließend konfiguriert ihr Euch den Node passend: Die Topics lasst ihr voreingestellt, je nachdem welche Daten ihr später in der Loxone Config weiterwenden wollt, setzt ihr unten JSON auf "Extended" (Achtung! **Sehr** viele Daten) oder "Basic" (empfohlen). 
 + 
 +{{plugins:debmatic:pasted:20230414-092536.png?500}} 
 + 
 +Zum Schluss aktiviert ihr euren neuen Flow über die Schaltfläche rechts oben "**Übernahme (deploy)**": 
 + 
 +{{plugins:debmatic:pasted:20230414-093103.png?300}} 
 + 
 +Sämtliche Datenpunkte der Homematic werden nun automatisch von NodeRed unter dem Topic ''hm'' an den LoxBerry MQTT Server übermittelt und können dort wie gewohnt weiterverwendet werden. Die Topics folgen dabei dem Schema: 
 + 
 +''hm/**status**/Seriennr. oder Name:Kanalnr./Parametername'' 
 + 
 +{{plugins:debmatic:pasted:20240403-223000.png?600}} 
 + 
 +Um Werte an einen Aktor zu senden, verwendet ihr folgendes Topic-Schema: 
 + 
 +''hm/**set**/Seriennr. oder Name:Kanalnr./Parametername'' 
 + 
 +Wie ihr einen entsprechenden Virtuellen Ausgang anlegt, findet ihr in der Dokumentation des MQTT Widgets: [[konfiguration:widget_help:widget_mqtt:mqtt_gateway:mqtt_schritt_fur_schritt_loxone_mqtt]] 
 + 
 +Meine Funksteckdose vom **Typ HM-ES-PMSw1-Pl** zum Beispiel wird so eingeschaltet: 
 + 
 +''%%http://username:passwort@loxberry/admin/plugins/mqttgateway/mqtt.php?topic=hm/set/OEQ0731234:1/STATE&value=true%%'' 
 + 
 +{{:plugins:debmatic:pasted:20240403-215659.png?400}}  {{plugins:debmatic:pasted:20240403-224348.png?400}} 
 + 
 +<WRAP center round tip 100%> 
 + 
 +== Keine Namen im MQTT Broker? == 
 + 
 +Nach der Ersteinrichtung von Sensoren/Aktoren in der CCU hakelt manchmal die Übertragung der selbst vergebenen Namen für Sensoren und Aktoren und die Geräte erscheinen in der Incoming Overview des MQTT Gateway noch mit den kryptischen Standardbezeichnungen oder gar ganz ohne Name. Richtet zunächst alle eure Sensoren fertig in der CCU ein und geht dann wie folgt vor: 
 + 
 +Der Haken "Beim Start bekannte Werte ausgeben" muss im Node Red einmal raus-, dann "Node-Red deploy", und dann wieder reingenommen werden, wieder mit anschließendem "Node-Red deploy". Dann MQTT Cache im MQTT Gateway auf dem LoxBerry löschen (in der Incoming Overview) und die neuen Namen sind da! 
 + 
 +</WRAP> 
 + 
 +===== Einrichtung in der Loxone Config Software ===== 
 + 
 +Die Einrichtung in der Loxone Config wird im MQTT Widget näher beschrieben und an dieser Stelle nicht weiter ausgeführt. Ihr findet in der Widget-Dokumentation detaillierte Anleitungen: 
 + 
 +[[konfiguration:widget_help:widget_mqtt:mqtt_gateway:mqtt_schritt_fur_schritt_loxone_mqtt]] 
 + 
 +[[konfiguration:widget_help:widget_mqtt:mqtt_gateway:mqtt_schritt_fur_schritt_mqtt_loxone]] 
 + 
 +Weiter oben in den Kapiteln findet ihr entsprechende Informationen, wie die Topics aufgebaut werden müssen. 
 + 
 +===== Nutzung der GPIOs mit anderen Anwendungen ===== 
 + 
 +Wenn ihr das Homematic-Modul über einen HB-RF-USB oder HB-RF-ETH Adapter an Euren LoxBerry angeschlossen habt, dann könnt ihr die GPIOs natürlich noch anderweitig nutzen (z. B. mit einem 1-Wire-Aufsteckmodul oder ähnlichem). Standardmäßig blockiert aber DebMatic die GPIOs für sich. Damit Homematic die GPIOs freigibt, loggt Euch per SSH auf Eurem LoxBerry ein ([[haufig_gestellte_fragen_faq:eine_sshverbindung_mit_putty_aufbauen_shellzugriff]]) und führt anschließend folgenden Befehl aus - danach einmal rebooten. 
 + 
 +<code bash> 
 +sudo apt-get purge pivccu-modules-raspberrypi 
 +</code> 
 + 
 +===== Roadmap ===== 
 + 
 +<do>Update von DebMatic über die Pluginoberfläche</do> 
 + 
 +===== Fragen stellen und Fehler melden ===== 
 + 
 +[[https://www.loxforum.com/forum/projektforen/loxberry/plugins/124452-plugin-homematic-auf-dem-loxberry]]
  
  
Zeile 131: Zeile 272:
 pluginuebersicht.author : prof.mobilux pluginuebersicht.author : prof.mobilux
 pluginuebersicht.logo : :plugins:debmatic:icon_64.png pluginuebersicht.logo : :plugins:debmatic:icon_64.png
-pluginuebersicht.status : UNSTABLE +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 : https://github.com/mschlenstedt/LoxBerry-Plugin-Debmatic/archive/refs/tags/LoxBerry-Plugin-Debmatic-V1.0.1.zip 
-pluginuebersicht.url_prerelease : https://github.com/mschlenstedt/LoxBerry-Plugin-Debmatic/archive/refs/tags/LoxBerry-Plugin-Debmatic-V0.1.0.zip+pluginuebersicht.url_prerelease : 
 pluginuebersicht.description : Mit demDebMatic Plugin können mit Hilfe der Aufsteck-Funkmodule von Homematic sämtliche Homematic Sensoren und Aktoren in das Loxonesystem integriert werden. pluginuebersicht.description : Mit demDebMatic Plugin können mit Hilfe der Aufsteck-Funkmodule von Homematic sämtliche Homematic Sensoren und Aktoren in das Loxonesystem integriert werden.
 pluginuebersicht.languages : DE, EN pluginuebersicht.languages : DE, EN