Metainformationen zur Seite
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung | ||
plugins:mqtt_gateway:start [2022/09/10 19:32] – Michael Schlenstedt | plugins:mqtt_gateway:start [2023/04/15 08:24] (aktuell) – ↷ Links angepasst, weil Seiten im Wiki verschoben wurden Michael Schlenstedt | ||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
- | ====== MQTT Gateway | + | ====== MQTT Gateway ====== |
- | + | ++++ Version History... | |
- | Version History... | + | |
**Version 0.1.1** | **Version 0.1.1** | ||
Zeile 81: | Zeile 80: | ||
* Fix: Evt. falsche Auswertung der Checkboxen im UI (#5) | * Fix: Evt. falsche Auswertung der Checkboxen im UI (#5) | ||
* Erweitert: JSON Expansion: Vollständig generische Expandierung ohne Einschränkung auf die Hierarchie | * Erweitert: JSON Expansion: Vollständig generische Expandierung ohne Einschränkung auf die Hierarchie | ||
- | * Erweitert: JSON Expansion für HTTP //und// UDP | + | * Erweitert: JSON Expansion für HTTP //und// UDP |
**Version 0.5.1 PRE-RELEASE** | **Version 0.5.1 PRE-RELEASE** | ||
Zeile 100: | Zeile 99: | ||
* Added: Subscription topics are now validated on-the-fly (errors are displayed on the left) | * Added: Subscription topics are now validated on-the-fly (errors are displayed on the left) | ||
- | ****Version 0.8.0 PRE-RELEASE**\\ | + | Version 0.8.0 PRE-RELEASE\\ ** ** |
- | ** | + | |
* FIX: Password was re-created on every update | * FIX: Password was re-created on every update | ||
Zeile 145: | Zeile 143: | ||
* Gateway: Fixed wrong encoding in topic names (e.g. with umlauts) | * Gateway: Fixed wrong encoding in topic names (e.g. with umlauts) | ||
* Plugin developers: | * Plugin developers: | ||
- | * Plugin' | + | * Plugin' |
- | * Your own plugin can inject subscriptions, | + | * Your own plugin can inject subscriptions, |
**Version 0.9.1 PRE-RELEASE** | **Version 0.9.1 PRE-RELEASE** | ||
- | * Generic POST-GET-JSON Receiver - Generic Callback URL for non-MQTT devices: | + | * Generic POST-GET-JSON Receiver - Generic Callback URL for non-MQTT devices: |
* Fixed: JavaScript error | * Fixed: JavaScript error | ||
Zeile 178: | Zeile 176: | ||
**Version 1.1.1 RELEASE** | **Version 1.1.1 RELEASE** | ||
- | * Updated Net:: | + | * Updated Net:: |
**Version 1.1.2 PRE-RELEASE** | **Version 1.1.2 PRE-RELEASE** | ||
Zeile 196: | Zeile 194: | ||
**Version 2.0.0 PRE-RELEASE** | **Version 2.0.0 PRE-RELEASE** | ||
- | * See the What's New document: | + | * See the What's New document: |
* Known Issues: UTF-8 encoding issues may occour with receiver and transformer functionality. Will be fixed until the final release. | * Known Issues: UTF-8 encoding issues may occour with receiver and transformer functionality. Will be fixed until the final release. | ||
Zeile 218: | Zeile 216: | ||
* Copy button to copy VI names / command recognitions to clipboard | * Copy button to copy VI names / command recognitions to clipboard | ||
* UDP port is hidden if UDP transfer is disabled | * UDP port is hidden if UDP transfer is disabled | ||
- | * New UDP Transformer: | + | * New UDP Transformer: |
- | * Enhanced Shelly UDP Transformer: | + | * Enhanced Shelly UDP Transformer: |
* Transformer calls are logged | * Transformer calls are logged | ||
* % character is now replaced by _ (% is not allowed in Loxone) | * % character is now replaced by _ (% is not allowed in Loxone) | ||
Zeile 229: | Zeile 227: | ||
* receive.php: | * receive.php: | ||
+ | **Version 2.1.999 RELEASE** | ||
+ | * Last and final release for LoxBerry below V3.0 | ||
- | \\ | + | ++++ |
+ | ===== Kompatibilität ===== | ||
- | ---- | + | <WRAP center info 90%> |
+ | DE: Das MQTT Gateway Plugin wird ab **LoxBerry 3.0** nicht mehr benötigt, weil die Funktionalität direkt in LoxBerry 3.0 integriert ist. Fixes und Erweiterungen werden in diesem Plugin nicht mehr gepflegt, sondern direkt in LoxBerry. | ||
+ | Wenn du dieses Plugin unter LoxBerry 2.x installierst, | ||
+ | </ | ||
+ | |||
+ | <WRAP center info 90%> | ||
+ | EN: The MQTT Gateway plugin is not required anymore starting with **LoxBerry 3.0**, as the functionality is integrated in LoxBerry 3.0. Fixes and enhancements are not maintained anymore in this plugin but in LoxBerry. | ||
+ | If you install this plugin on LoxBerry 2.x, your settings are automatically migrated when you update to LoxBerry 3.x. | ||
+ | </ | ||
===== Einführung / Video Tutorial ===== | ===== Einführung / Video Tutorial ===== | ||
- | \\ | + | {{youtube> |
+ | {{youtube> | ||
===== Download ===== | ===== Download ===== | ||
Zeile 246: | Zeile 256: | ||
Der direkte Download des Releases befindet sich in der Tabelle oben. | Der direkte Download des Releases befindet sich in der Tabelle oben. | ||
- | Repository: | + | Repository: |
===== Kommunikationsdiagramm ===== | ===== Kommunikationsdiagramm ===== | ||
- | {{plugins: | + | {{plugins: |
(Anklicken zum Vergrößern) | (Anklicken zum Vergrößern) | ||
Zeile 276: | Zeile 286: | ||
===== Schnell-Konfiguration am Beispiel eines Shelly 2 ===== | ===== Schnell-Konfiguration am Beispiel eines Shelly 2 ===== | ||
- | \\ | + | {{youtube> |
===== Settings - MQTT an Loxone Miniserver ===== | ===== Settings - MQTT an Loxone Miniserver ===== | ||
Zeile 283: | Zeile 292: | ||
==== Einstellungen ==== | ==== Einstellungen ==== | ||
- | |Einstellung | + | ^ Einstellung |
- | |Per HTTP Webservice übermitteln\\ \\ ("Set virtual inputs via HTTP webservice" | + | | Per HTTP Webservice übermitteln\\ \\ ("Set virtual inputs via HTTP webservice" |
- | |Per UDP übermitteln\\ \\ ("Send data via UDP" | + | | Per UDP übermitteln\\ \\ ("Send data via UDP" |
- | |Miniserver | + | | Miniserver |
- | |Miniserver-UDP-Port | + | | Miniserver-UDP-Port |
- | |Booleans konvertieren | + | | Booleans konvertieren |
- | |JSON expandieren | + | | JSON expandieren |
- | |**TAB Subscriptions**\\ \\ Abonnierte Topics | + | | **TAB Subscriptions**\\ \\ Abonnierte Topics |
- | |**TAB Conversions**\\ \\ Eigene Wert-Zu-Text Konvertierung | + | | **TAB Conversions**\\ \\ Eigene Wert-Zu-Text Konvertierung |
- | |**TAB Incoming Overview**\\ \\ Anzeige der übermittelten Daten | + | | **TAB Incoming Overview**\\ \\ Anzeige der übermittelten Daten | |
Den Button zum Speichern ganz unten nicht vergessen. Die neue Konfiguration wird beim Speichern automatisch übernommen. | Den Button zum Speichern ganz unten nicht vergessen. Die neue Konfiguration wird beim Speichern automatisch übernommen. | ||
- | \\ | + | Siehe auch: |
- | ==== Siehe auch: MQTT - Schritt für Schritt: MQTT -> Loxone ==== | + | * [[konfiguration:widget_help:widget_mqtt: |
+ | * [[konfiguration: | ||
===== Settings - Miniserver an MQTT ===== | ===== Settings - Miniserver an MQTT ===== | ||
- | |Einstellung | + | ^ Einstellung |
- | |Gateway UDP IN-Port|11884 | + | | Gateway UDP IN-Port | 11884 | Eingangsport am LoxBerry für UDP-Nachrichten, |
Wenn der Miniserver neu startet, empfiehlt es sich, mittels der Loxone-Zeit " | Wenn der Miniserver neu startet, empfiehlt es sich, mittels der Loxone-Zeit " | ||
- | ==== Siehe auch: MQTT - Schritt für Schritt: Loxone -> MQTT ==== | + | Siehe auch: |
+ | |||
+ | * [[konfiguration:widget_help: | ||
+ | * [[konfiguration: | ||
===== Settings - MQTT Broker-Einstellungen ===== | ===== Settings - MQTT Broker-Einstellungen ===== | ||
- | |Einstellung | + | ^ Einstellung |
- | |Lokalen Mosquitto-Broker verwenden\\ \\ ("Use the local Mosquitto MQTT broker" | + | | Lokalen Mosquitto-Broker verwenden\\ \\ ("Use the local Mosquitto MQTT broker" |
- | |MQTT Broker Adresse | + | | MQTT Broker Adresse |
- | |MQTT Broker Benutzername\\ \\ MQTT Broker Passwort | + | | MQTT Broker Benutzername\\ \\ MQTT Broker Passwort |
- | |Mosquitto WebSocket port | + | | Mosquitto WebSocket port | 9001 | MQTT Clients mit Websocket-Support können mit diesem Port verbinden. WebSocket-Clients können im Webbrowser laufen und erhalten die Daten gepushed, statt regelmäßig abfragen zu müssen. |
- | |Broker Pre-Shared Key (TLS-PSK) | + | | Broker Pre-Shared Key (TLS-PSK) |
===== Settings - Weitere Einstellungen (" | ===== Settings - Weitere Einstellungen (" | ||
- | |||
- | {{https:// | ||
==== Performance-Einstellung des Gateways: "Data Transfer Performance" | ==== Performance-Einstellung des Gateways: "Data Transfer Performance" | ||
Zeile 332: | Zeile 339: | ||
Mittels eines integrierten Reglers wird auf die gewünschte // | Mittels eines integrierten Reglers wird auf die gewünschte // | ||
- | Standardwert ist " | + | Standardwert ist " |
- | Die Einstellung " | + | |
- | Mit der Einstellung " | + | |
- | Wenn du willst, kannst du die Wirkung der Regelung beobachten, indem du an der Shell mit '' | + | Wenn du willst, kannst du die Wirkung der Regelung beobachten, indem du an der Shell mit '' |
===== MQTT Subscriptions ===== | ===== MQTT Subscriptions ===== | ||
- | Hier definierst du, welche Daten du abonnieren möchtest. Jede Subscription steht in einer Zeile. Unter welchem Topic die Daten gesendet werden, bestimmt das Absender-Gerät (bzw. das, was du dort einstellst). Siehe dazu den ausführlichen Artikel, wie Subscriptions und Topics funktionieren, | + | Hier definierst du, welche Daten du abonnieren möchtest. Jede Subscription steht in einer Zeile. Unter welchem Topic die Daten gesendet werden, bestimmt das Absender-Gerät (bzw. das, was du dort einstellst). Siehe dazu den ausführlichen Artikel, wie Subscriptions und Topics funktionieren, |
Beispiel: | Beispiel: | ||
- | '' | + | '' |
- | '' | + | |
==== Verteilung der Daten an verschiedene Miniserver ==== | ==== Verteilung der Daten an verschiedene Miniserver ==== | ||
Zeile 361: | Zeile 365: | ||
fhem/# | fhem/# | ||
</ | </ | ||
- | |||
- | |||
* Zeile 1: Alle '' | * Zeile 1: Alle '' | ||
Zeile 383: | Zeile 385: | ||
Jede Zeile enthält eine Regular Expression - wenn das RegEx bei einem eingehenden Datensatz __zutrifft__, | Jede Zeile enthält eine Regular Expression - wenn das RegEx bei einem eingehenden Datensatz __zutrifft__, | ||
- | {{plugins: | + | {{plugins: |
In der Incoming Overview werden gefilterte Datensätze durchgestrichen angezeigt - so kannst du prüfen, ob deine RegEx-Zeilen funktionieren. | In der Incoming Overview werden gefilterte Datensätze durchgestrichen angezeigt - so kannst du prüfen, ob deine RegEx-Zeilen funktionieren. | ||
Zeile 393: | Zeile 395: | ||
Um dir die Einrichtung zu erleichtern, | Um dir die Einrichtung zu erleichtern, | ||
- | {{plugins: | + | {{plugins: |
===== Text-to-Value Conversions ===== | ===== Text-to-Value Conversions ===== | ||
Zeile 401: | Zeile 403: | ||
In jede Zeile eine Konvertierung. | In jede Zeile eine Konvertierung. | ||
- | {{plugins: | + | {{plugins: |
Dieses Beispiel zeigt den Status von Enocean Fenstergriffen. Sendet der Fenstergriff " | Dieses Beispiel zeigt den Status von Enocean Fenstergriffen. Sendet der Fenstergriff " | ||
Zeile 411: | Zeile 413: | ||
Auch andere Plugins können automatisch Conversions anlegen. Die findest du am Ende der Seite, wenn welche vorhanden sind. | Auch andere Plugins können automatisch Conversions anlegen. Die findest du am Ende der Seite, wenn welche vorhanden sind. | ||
- | {{plugins: | + | {{plugins: |
===== Incoming Overview ===== | ===== Incoming Overview ===== | ||
Zeile 421: | Zeile 423: | ||
==== HTTP Virtual Inputs (Übertragung per HTTP) ==== | ==== HTTP Virtual Inputs (Übertragung per HTTP) ==== | ||
- | {{plugins: | + | {{plugins: |
- | + | ||
- | \\ | + | |
Oben kannst du Einträge suchen und nach dem Status filtern. | Oben kannst du Einträge suchen und nach dem Status filtern. | ||
Zeile 430: | Zeile 429: | ||
Die Symbole links zeigen, ob | Die Symbole links zeigen, ob | ||
- | * {{plugins: | + | * {{plugins: |
- | * {{plugins: | + | * {{plugins: |
- | * {{plugins: | + | * {{plugins: |
- | * {{plugins: | + | * {{plugins: |
- | * {{plugins: | + | * {{plugins: |
- | Ein {{plugins: | + | Ein {{plugins: |
- | Das {{plugins: | + | Das {{plugins: |
- | Wenn du bei Einträgen ein {{plugins: | + | Wenn du bei Einträgen ein {{plugins: |
Der VI hat einen Copy-Button. Damit kannst du zügig neue Virtuelle Eingänge am Miniserver einrichten. | Der VI hat einen Copy-Button. Damit kannst du zügig neue Virtuelle Eingänge am Miniserver einrichten. | ||
Zeile 448: | Zeile 447: | ||
Wenn du UDP als Übertragungsart gewählt hast, werden dir die Daten, und die möglichen Befehlserkennungen angezeigt. | Wenn du UDP als Übertragungsart gewählt hast, werden dir die Daten, und die möglichen Befehlserkennungen angezeigt. | ||
- | {{plugins: | + | {{plugins: |
Du kannst mit dem Copy-Button direkt die Befehlserkennung kopieren, um sie am Miniserver in neue Virtuelle UDP-Eingangs-Befehle (Befehlserkennung) zu kopieren. | Du kannst mit dem Copy-Button direkt die Befehlserkennung kopieren, um sie am Miniserver in neue Virtuelle UDP-Eingangs-Befehle (Befehlserkennung) zu kopieren. | ||
Zeile 454: | Zeile 453: | ||
==== Show details and advanced settings ==== | ==== Show details and advanced settings ==== | ||
- | {{plugins: | + | {{plugins: |
Je nach Übertragungsart - HTTP oder UDP - werden dir zusätzliche Informationen und Optionen angezeigt. | Je nach Übertragungsart - HTTP oder UDP - werden dir zusätzliche Informationen und Optionen angezeigt. | ||
Zeile 470: | Zeile 469: | ||
Neu im MQTT Gateway 2.x sind sogenannte Transformers. Damit ist es möglich, vom Miniserver eingehende Daten vor der Übertragung an MQTT zu modizieren. | Neu im MQTT Gateway 2.x sind sogenannte Transformers. Damit ist es möglich, vom Miniserver eingehende Daten vor der Übertragung an MQTT zu modizieren. | ||
- | Die detaillierte Anleitung zu den Transformers findest du hier: [[plugins:mqtt_gateway: | + | Die detaillierte Anleitung zu den Transformers findest du hier: [[konfiguration:widget_help: |
===== Bekannte MQTT-Geräte und Subscription-Topics ===== | ===== Bekannte MQTT-Geräte und Subscription-Topics ===== | ||
Zeile 476: | Zeile 475: | ||
Liebe Plugin-Benutzer! Bitte pflegt diese Tabelle mit euren eingesetzten Geräten, MQTT-Infos und Links! | Liebe Plugin-Benutzer! Bitte pflegt diese Tabelle mit euren eingesetzten Geräten, MQTT-Infos und Links! | ||
- | Die Liste ist jetzt in diesem Unter-Artikel: | + | Die Liste ist jetzt in diesem Unter-Artikel: |
===== Weitere Hinweise ===== | ===== Weitere Hinweise ===== | ||
Zeile 483: | Zeile 482: | ||
* Das Plugin integriert sich in den [[konfiguration: | * Das Plugin integriert sich in den [[konfiguration: | ||
- | {{https:// | + | {{:plugins: |
- | * Neue MQTT-Geräte ausprobieren, | + | * Neue MQTT-Geräte ausprobieren, |
* Ebenfalls zum Testen nutzen kannst du den Quick Publisher des MQTT Gateways. Wenn du im Plugin ganz rechts oben das " | * Ebenfalls zum Testen nutzen kannst du den Quick Publisher des MQTT Gateways. Wenn du im Plugin ganz rechts oben das " | ||
Zeile 496: | Zeile 495: | ||
===== Fragen stellen und Fehler melden ===== | ===== Fragen stellen und Fehler melden ===== | ||
- | [[plugins:mqtt_gateway: | + | [[konfiguration:widget_help: |
- | GitHub: | + | GitHub: [[https:// |
- | Forum: | + | Forum: [[https:// |
==== Fehlerbeschreibungen ==== | ==== Fehlerbeschreibungen ==== | ||
Zeile 512: | Zeile 511: | ||
===== Siehe auch ===== | ===== Siehe auch ===== | ||
- | * [[plugins: | + | * [[konfiguration: |
- | * [[plugins: | + | * [[konfiguration: |
- | * [[plugins: | + | * [[konfiguration: |
- | * [[plugins: | + | * [[konfiguration: |
- | * [[plugins:mqtt_gateway: | + | * [[konfiguration:widget_help: |
- | * [[plugins:mqtt_gateway: | + | * [[konfiguration:widget_help: |
- | * [[plugins: | + | * [[konfiguration: |
- | + | ||
- | * Informationen und Best Practices zu Topics und Subscrictions: | + | |
- | * Miele Home MQTT Gateway: | + | |
- | * Verschiedene MQTT-Interfaces von Devices und Diensten: | + | |
- | * Fronius Hybrid und // | + | |
+ | * Informationen und Best Practices zu Topics und Subscrictions: | ||
+ | * Miele Home MQTT Gateway: | ||
+ | * Verschiedene MQTT-Interfaces von Devices und Diensten: | ||
+ | * Fronius Hybrid und // | ||
---- struct data ---- | ---- struct data ---- | ||
- | pluginuebersicht.author : christiantf | + | pluginuebersicht.author : fenzl |
pluginuebersicht.logo : : | pluginuebersicht.logo : : | ||
- | pluginuebersicht.status : STABLE | + | pluginuebersicht.status : STOPPED |
- | pluginuebersicht.version : 2.1.0 | + | pluginuebersicht.version : 2.1.999 |
pluginuebersicht.min_lb_version : 1.4.3 | pluginuebersicht.min_lb_version : 1.4.3 | ||
- | pluginuebersicht.url_release : https:// | + | pluginuebersicht.url_release : https:// |
pluginuebersicht.url_prerelease : | pluginuebersicht.url_prerelease : | ||
pluginuebersicht.description : Installiert den MQTT-Broker Mosquitto und stellt ein MQTT-Gateway für den Miniserver bereit. | pluginuebersicht.description : Installiert den MQTT-Broker Mosquitto und stellt ein MQTT-Gateway für den Miniserver bereit. |