MQTT Gateway

Autor	Christian Fenzl
Logo
Status	RELEASE
Version	2.1.0 RELEASE
Min. LB Version	LB 1.4.3
Download	2.1.0 Release: https://github.com/christianTF/LoxBerry-Plugin-MQTT-Gateway/archive/refs/tags/2.1.0.zip Pre-Release: -
Zweck	Installiert den MQTT-Broker Mosquitto und stellt ein MQTT-Gateway für den Miniserver bereit.
Languages	EN
Diskussion	https://www.loxforum.com/forum/projektforen/loxberry/plugins/294881-mqtt-gateway-2-x

Version History…

Version 0.1.1

• DEVELOPER PREVIEW - Nur einsetzen mit MQTT und Linux-Kenntnissen - Fehler ausschließlich per Issue bei GitHub
• Stellt ein MQTT→Loxone Gateway bereit

Version 0.1.2

• DEVELOPER PREVIEW - Nur einsetzen mit MQTT und Linux-Kenntnissen - Fehler ausschließlich per Issue bei GitHub
• Implementiert ein UDP-Interface für Loxone→MQTT

Version 0.1.3

• DEVELOPER PREVIEW - Nur einsetzen mit MQTT und Linux-Kenntnissen - Fehler ausschließlich per Issue bei GitHub
• Eigene UI-Sektion für MQTT Broker
• Authentifizierung für MQTT Broker
• Lokaler Mosquitto abschaltbar
• Retry für den Mosquitto Service, wenn er beim Systemstart nicht automatisch gestartet wurde
• MQTT Gateway wird direkt nach der Installation gestartet
• Parameter-Update-Routine zum Hinzufügen von neuen Default-Parametern während der Installation

Version 0.1.4

• DEVELOPER PREVIEW - Nur einsetzen mit MQTT und Linux-Kenntnissen - Fehler ausschließlich per Issue bei GitHub
• UI: Expand JSON Option hinzugefügt
• Gateway: JSON wird bei HTTP expandiert (nur erster Level) und beim HTTP-Namen angehängt - EXPERIMENTELL
• Gateway: Alle übermittelten Topics werden im Speicher behalten (max. 24 Stunden)
• UI: Funktion zum Abfragen der gespeicherten Gateway-Topics (wird aber noch nicht dargestellt)

Version 0.1.5

• DEVELOPER PREVIEW - Nur einsetzen mit MQTT und Linux-Kenntnissen - Fehler ausschließlich per Issue bei GitHub
• UI: Größerer Umbau des UI (Settings, Subscriptions, Conversions, Incoming Overview, Logfiles) als Navbar
• UI: Subscriptions jetzt als eigene Seite (leichter anzupassen, man muss nicht immer auf- und abscrollen für Apply)
• UI: Conversions: Angabe von Strings, die zu Werten konvertiert werden sollen (Loxone kann mit Strings nichts anfangen)
• UI: Incoming Overview: Anzeige der an den Miniserver übermittelten Werte
• UI: Logs: Inline-Anzeige der Logfile-Übersicht
• Gateway: Benutzerdefinierte Conversion (eingehende Nachrichten können in Werte konvertiert werden)
• Gateway: Logfile: Parsing der Conversion wird geloggt, inklusive "komischer" Werte und Duplikate
• Gateway: Logfile wird beim Beenden des Gateways sauber abgeschlossen

Version 0.2.0 PRE-RELEASE

• Erster Pre-Release
• Allgemein: Neues Logo (MQTT-Logo statt Mosquitto-Logo)
• Gateway: Besseres Fehlerhandling beim Restart des Gateways
• UI: Filter bei den übermittelten Nachrichten (erleichtert die Suche)
• Donation: Erster Versuch, per Spende einen eigenen Test-Miniserver zusammen zu bekommen

Version 0.3 PRE-RELEASE

• Lokale Mosquitto-Authentifizierung als Standard (Benutzer: loxberry, Passwort: wird generiert)
• Broker-Anmeldedaten werden nur dann geladen, wenn der SecurePIN angegeben wird
• Ermöglicht direkt, die lokalen Mosquitto-Anmeldedaten zu ändern oder zu deaktivieren
• Änderung der Anmeldedaten eines nicht lokalen Brokers ändert nur die Anmeldung des Gateways
• Änderung der Konfiguration übernimmt diese sofort für das MQTT Gateway und/oder Mosquitto

Version 0.3.1 PRE-RELEASE

• Fix: Bei anonymer Verwendung von Mosquitto startet der Mosquitto-Dienst nach Reboot nicht mehr
• Aktivierung von Plugin AutoUpdate (ab dieser Version können Versions-Notifications oder automatisches Update aktiviert werden)

Version 0.4.1 PRE-RELEASE

• Fix: Nach Konfigurationsänderungen und "Apply" wurden diese nicht übernommen
• Neu: Per UDP eingehende Nachrichten werden vollständig weitergegeben (so können beispielsweise auch json Nachrichten gesendet werden)
• Neu: Das Gateway published seinen Connection-Status selbst unter dem Topic <hostname>/mqttgateway/status
• Neu: Das Gateway published im Minutentakt den aktuellen Epoch-Timestamp.
• Neu: Das Gateway subscribed sich selbst automatisch - so kann der Timestamp als Prüfung verwendet werden, ob das Gateway noch funktioniert
• Neu: Unterstützt Last Will and Testament (d.h. Broker setzt den Status auf Disconnected, wenn das Gateway stirbt)
• Neu: UDP-Nachrichten können mit publish oder retain gesendet werden
• Neu: UDP-Nachricht "reconnect" forciert das Neu-Verbinden und Übertragen an den Miniserver
• Neu: Default-UDP-In-Port am Gateway: 11884 (bisher 11883)

Version 0.5.0 PRE-RELEASE

• 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 für HTTP und UDP

Version 0.5.1 PRE-RELEASE

• Fix: JSON expansion not working

Version 0.6.0 PRE-RELEASE

• FIX: Anonymous connection was still possible with password auth (after installation, please save once to fix)
• Enhanced: Incoming Overview: Now is a live visualisation of the topic messages (updated once a second, without browser refresh)
• Enhanced: Incoming Overview: Enable advanced infos to show the original topics, and to delete messages on the broker
• Info for delete event: The data in the overview may not disappear, as the last transmission with "last sent to Miniserver" is still valid

Version 0.7.1 RELEASE

• FIX: Json expansion for UDP only worked when HTTP was enabled
• Added: Overview now shows ready-to-use command recognition for UDP inputs
• Added: Subscription topics are now validated on-the-fly (errors are displayed on the left)

Version 0.8.0 PRE-RELEASE

• FIX: Password was re-created on every update
• New: mosquitto.log on the Logfiles tab
• New: TLS-PSK for encrypted connections, listening on port 8883
• New: In the Incoming Overview, with Advanced Table Info enabled, you can disable caching for selected data, and enable Reset-After-Send
  • Disable Cache: Every incoming value from MQTT will be sent again, also if it has not changed.
  • Reset-After-Send: This is especially useful to generate impulses/triggers, if your device e.g. on a keypress does not send "pressed" and "released" events, but only one "pressed" impulse. Reset-After-Send will send a 0 after each incoming event.
  • UI: Enabling and disabling the checkbox responses with some seconds delay - the checkbox toggles back and after some seconds, shows the currently set value.
• Requires LoxBerry V1.4.0+

Version 0.8.1 RELEASE

• Incoming values are trimmed (removed leading and terminating blanks) to work with the Text-To-Value Conversion.

Version 0.8.2 PRE-RELEASE

• Updated Perl Net::MQTT::Simple lib to 1.23
• Corrects a connection issue of the lib to Mosquitto with version higher V1.5.8

Version 0.8.3 RELEASE

• Performance improvements for the Incoming Overview
  • Close HTTP collapsible if UDP is opened, and vice-versa
  • Only render opened collapsible
  • Optimized updating HTML table
  • Update interval of the Overview is calculated dependent to the number of elements
  • "Advanced Table View" checkboxes now are viewed in classic design instead of jQuery Mobile style

Version 0.9.0.1 PRE-RELEASE

• Incoming Overview: Button to purge Mosquitto's retain database (local Mosquitto installation only)
• Incoming Overview: Button to retransmit all data to Miniserver without cache (for testing of Miniserver configuration)
• Incoming Overview: Incoming data are shown also if no Miniserver is configured
• Restart button also restarts Mosquitto (local Mosquitto installation only). With external broker, still only the Gateway is restarted
• Mosquitto:
  • MQTT Websocket protocol. Websocket is available on port 9001. Use the same credentials. Websocket TLS currently not supported. (after update, Mosquitto may need to be restarted)
  • Changed Mosquitto database auto-save interval to 1 day (before: 30 min) to reduce sd writes. Shutdown/Restart still triggers saving of the db on sd card.
• New installations (not update) changed default configuration:
  • HTTP Transmission : enabled
  • UDP Transmission: disabled
  • Expand JSON data: enabled
• Gateway: Fixed wrong encoding in topic names (e.g. with umlauts)
• Plugin developers:
  • Plugin's UDP interface now also supports json as data format (compared to the simple udp interface, this also supports blanks in topic names) → MQTT Gateway - HTTP- und UDP-Interface
  • Your own plugin can inject subscriptions, conversions to the MQTT Gateway plugin during installation and runtime →  MQTT Gateway for plugin developers. Your injections are applied from the Gateway on-the-fly without restart.

Version 0.9.1 PRE-RELEASE

• Generic POST-GET-JSON Receiver - Generic Callback URL for non-MQTT devices: MQTT-Gateway - Generischer POST / GET / JSON Empfänger
• Fixed: JavaScript error

Version 0.9.2 PRE-RELEASE

• Fixed an error with Mosquitto during update of the plugin. Mosquitto did not update properly during the installation process.

Version 1.0 RELEASE

• Uninstall will uninstall Mosquitto

Version 1.0.1 RELEASE

• Enhanced: Implemented a delay of 10ms on "reset-after-send" topics between sending the value and sending the 0 (Miniserver network processing was too slow in some situations). The delay is adjustable in the mqtt.json config file (Main.resetaftersendms)
• Enhanced: Boolean Conversion does not translate an empty string to 0 anymore. Empty now stays empty.
• Enhanced: Deleting a value in the webif (X button) now also deletes the line in the webif.
• Enhanced: Removed logfile entries about Incoming Overview state requests for more clearness in the log
• Fixed: Corrected encoding (utf8) inconsistencies via the different interfaces (mqtt, udp, http, webif), e.g. with German umlauts.

Version 1.1 PRE-RELEASE

• New: Publish test messages from the UI: Open the right-side help flyout and open "Quick Publisher"
• New: Send different subscription data to different/multiple Miniservers
• Enhanced: Daemon creates a logfile on startup
• Fixed: Overview: Delete button was hidden in some resolutions

Version 1.1.1 RELEASE

• Updated Net::MQTT::Simple library to 1.24, with LoxBerry/Mosquitto rapid publich patch (see https://github.com/Juerd/Net-MQTT-Simple/issues/11)

Version 1.1.2 PRE-RELEASE

• Allows to skip forwarding of selected data to the Miniserver from UI (to save Miniserver resources)
• Fixes topic matching for redirection of data to other Miniservers (pipe in the subscriptions)

Version 1.1.3 PRE-RELEASE

• Introducing healthcheck for LoxBerry Healthcheck (LB2.2+)
• Fixed another issue with topic matching for redirection of data to other Miniservers

Version 1.1.4 RELEASE

• Update for Net::MQTT::Simple library (adjusted send delay for Raspberry Pi 4 to 17ms)

Version 2.0.0 PRE-RELEASE

• See the What's New document: MQTT Gateway 2.0 What's New
• Known Issues: UTF-8 encoding issues may occour with receiver and transformer functionality. Will be fixed until the final release.

Version 2.0.1 PRE-RELEASE

• Fixed utf-8 issue in Generic POST/GET receiver
• Fixed utf-8 issues in UDP Transformers

Version 2.0.2 PRE-RELEASE

• Fixed an issue of added blank at the end of a incoming udp message, with publish/retain

Version 2.0.3 PRE-RELEASE

• Fixes: Topics older than 24 hours in UDP Incoming Overview leave "undefined" entries in list
• Fixes: Mqttgateway stops after some seconds on LoxBerry 1.x (LB2.0 feature used in Transformers throws exception on LB1.x)
• UDP View: Added filter buttons for filtered and non-filtered entries

Version 2.0.4 RELEASE

• Copy button to copy VI names / command recognitions to clipboard
• UDP port is hidden if UDP transfer is disabled
• New UDP Transformer: sort (https://www.loxwiki.eu/x/kYRWBQ)
• Enhanced Shelly UDP Transformer: tunable white (https://www.loxwiki.eu/x/_QBABQ)
• Transformer calls are logged
• % character is now replaced by _ (% is not allowed in Loxone)
• Project MQTT to LoxBerry-Core: MQTT connection settings are now stored in LoxBerry's general.json

Version 2.1.0 RELEASE

• Fixes issue "ERROR: Error on JSON expansion: Inappropriate ioctl for device" with newer json library
• receive.php: Also use json from post variables

Der direkte Download des Releases befindet sich in der Tabelle oben.

Repository: https://github.com/christianTF/LoxBerry-Plugin-MQTT-Gateway

(Anklicken zum Vergrößern)

Sieh dir links im Navigationsbaum weiterführende Artikel zu MQTT an, um die Funktionsweise besser zu verstehen.

Der "MQTT Broker" ist ein Dienst, der als Vermittler von Nachrichten dient. Das MQTT Gateway installiert automatisch den Broker Mosquitto. Der Broker speichert den aktuellen Zustand aller angeschlossenen Geräte. Über die Konfiguration kann auch ein Broker auf einem anderen Server angegeben werden. Das Plugin unterstützt Authentifizierung, jedoch keine Verschlüsselung zum Broker.

Ein "Topic" im MQTT-Jargon ist eine eindeutige Adresse, mit der ein Gerät oder eine Schaltaktion erreicht wird. Ein Topic sieht ein bisschen aus wie eine Pfadangabe, z.B. shellies/shelly-5345672/relay/1 (ohne / am Beginn) und adressiert eindeutig das Gerät, das auf dieses Topic hört.

Mit einer "Subscription" wird ein Topic (oder ein Topic-Baum) abonniert, d.h. mit Subscriptions definierst du, welche Daten du empfangen möchtest. Eine Subscription shellies/# (# steht für einen Joker) abonniert alle Daten, die unterhalb von shellies/ eingehen. Diese Daten werden vom Plugin an den Miniserver weitergeleitet. Mit den Subscriptions kannst du gezielt steuern, welche Daten du tatsächlich zum Miniserver weiterleiten möchtest.

Das Plugin installiert zuerst automatisch den Mosquitto MQTT Broker (Hostname "localhost"). Erfahrene Benutzer können auch eine Verbindung zu einem anderen Broker einrichten. Das Plugin unterstützt kein TLS zum MQTT-Broker.

Das Plugin fungiert verbindet mit diesem MQTT-Broker, und leitet MQTT-Nachrichten an den Miniserver weiter. Außerdem kannst du vom Miniserver aus Nachrichten an das MQTT Gateway Plugin senden, die ins MQTT-Netzwerk, und somit an deine Geräte, weitergeleitet werden. Somit kannst du mit dem Plugin sowohl Stati deiner Geräte empfangen, als auch Schaltbefehle an diese senden.

Über das Webinterface in den Subscriptions können Topics abonniert werden. Die abonnierten Topics werden wahlweise per UDP, oder per HTTP Webservice an den eingestellten Miniserver übermittelt. 

Das Senden von Nachrichten vom Miniserver an MQTT geht am besten per UDP.

Den Button zum Speichern ganz unten nicht vergessen. Die neue Konfiguration wird beim Speichern automatisch übernommen. 

Wenn der Miniserver neu startet, empfiehlt es sich, mittels der Loxone-Zeit "Startimpuls" ein reconnect per UDP-Nachricht an das Gateway zu übermitteln. Beispiel im "Siehe auch"-Link.

image2021-2-16_8-32-28.png?version=1&modificationDate=1613460748000&api=v2

Die Einstellung regelt, wie viel CPU-Zeit das Gateway zur Abarbeitung der Nachrichten (in beide Richtungen) beanspruchen darf. 

Mittels eines integrierten Reglers wird auf die gewünschte CPU-Belastung ausgeregelt. Diese Logik passt sich automatisch an die Systemgeschwindigkeit, und an die Anzahl und den Durchsatz der zu übertragenden Daten an. Die Regelung läuft kontinuierlich, etwaige Lastspitzen werden ausgeglichen. Eine Änderung der Performance-Einstellung dauert einige Minuten, bis sie spürbar wird. 

Standardwert ist "Fast (Default)", was im Vergleich zu den Version 1.x in etwa einer zehnfachen Beschleunigung entspricht (auf einem Raspberry Pi 1 / Zero ca. dreifach).
Die Einstellung "Moderate" ist etwa dreimal so schnell wie früher, "Energy Saver" wird (je nach Hardware) vermutlich langsamer sein als früher, und ist für Taster-Übertragungen eher nicht geeignet.
Mit der Einstellung "Very fast" ist praktisch keine Verzögerung mehr spürbar, wohingegen mit "NO LIMITS!" je nach Hardware der LoxBerry fast voll ausgelastet ist und alles andere träge wird. 

Wenn du willst, kannst du die Wirkung der Regelung beobachten, indem du an der Shell mit top die CPU-Auslastung des ''%%mqttgateway.pl%%'' Prozesses verfolgst. Die Regelanpassung passiert im Minutentakt.

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, unter MQTT Gateway - Subscriptions und Topics.

Beispiel:

shellies/#
nuki/#

Wenn du mehrere Miniserver hast (z.B. Gateway-Konzentrator-Betrieb, oder mehrere Wohneinheiten mit unabhängigen Miniservern), möchtest du vielleicht unterschiedliche Daten an unterschiedliche Miniserver senden.

Wenn du eine Subscription ganz normal eingibst (z.B. shellies/#) , werden deren Daten immer an den Standard-Miniserver gesendet, den du auf der ersten Seite angeben hast.

Mit einer Pipe hinter der Subscription und der oder den Miniserver-Nummern (aus dem Miniserver-Widget) kannst du das Datenziel ändern:

shellies/#|2
shellies/shellyem3-DC4F227649B8/#|3
nuki/#|1,2,3
fhem/#

• Zeile 1: Alle shellies/-Daten werden an den Miniserver 2 gesendet (außer shellies/shellyem3-DC4F227649B8/)
• Zeile 2: shellies/shellyem3-DC4F227649B8/-Daten gehen an Miniserver 3
• Zeile 3: Daten von nuki/ werden sowohl an MS1, MS2 als auch MS3 gesendet.
• Zeile 4: Keine Pipe, daher gehen die Daten von fhem/# an den Standard-Miniserver

Dazu noch folgende Hinweise:

• Die Priorisierung der Reihung erfolgt entsprechend der Selektivität des Topics, d.h. shellies/shellyem3-DC4F227649B8/# ist spezifischer als shellies/#, deswegen "gewinnt" in unserem Beispiel bei Daten von shellyem3-DC4F227649B8 der selektivere Eintrag (Daten gehen an MS3, die restlichen shellies/# Daten an MS2). Die Reihenfolge im Textfeld hat keinen Einfluss darauf!
• Die Topic-Joker + und # werden vollständig unterstützt.
• Du kannst eine Plugin-Subscription auch an einen anderen Miniserver senden lassen, indem du die gleiche Subscription oben im Textfeld mit einer Pipe definierst. Hat das Plugin beispielsweise nuki/# registriert, kannst du mit einer Zeile nuki/#|2 die Daten an einen anderen Miniserver senden lassen.
• Alle Einstellungen auf der Settings-Seite und in der Incoming Overview (z.B. HTTP oder UDP, Boolean Conversion, Reset-After-Send,…) treffen für alle Miniserver zu. Das Datencaching von LoxBerry wird pro Miniserver angewandt.
• Fehler bei der Übertragung zu einem Miniserver führen in der Regel zu einer Warnung oder Fehlermeldung im Log, nicht aber zum Abbruch/Absturz des Programms.

Eine Subscription kann eine Menge Daten übertragen, die du möglicherweise gar nicht auf dem Miniserver brauchst. Anhand von Filtern kannst du bestimmte Daten wegfiltern. Diese Filter-Möglichkeit funktioniert auch innerhalb extrahierter JSON-Daten.

Jede Zeile enthält eine Regular Expression - wenn das RegEx bei einem eingehenden Datensatz zutrifft, wird dieser Datensatz gefiltert und nicht an den Miniserver weitergeleitet.

In der Incoming Overview werden gefilterte Datensätze durchgestrichen angezeigt - so kannst du prüfen, ob deine RegEx-Zeilen funktionieren.

Während der Eingabe ins Feld wird geprüft, ob deine Regular Expression auch wirklich valide ist.

Um dir die Einrichtung zu erleichtern, können andere Plugins direkt im MQTT Gateway Subscriptions definieren. Wenn Plugin-Subscriptions vorhanden sind, findest du diese auf der Subscriptions-Seite ganz unten. Du brauchst dann diese Subscriptions nicht nochmals oben einzugeben.

Viele Geräte senden Text für ihren Status, z.B. "up" und "down", oder "open" oder "closed". Loxone ist nicht sehr geschickt, was den Umgang und Weiterverarbeitung von Texten angeht. Um diese Texte in Zahlen umzuwandeln (mit denen der Miniserver mehr anfangen kann), kannst du hier Text-to-Value Conversions, also Konvertierungen durchführen.

In jede Zeile eine Konvertierung.

Dieses Beispiel zeigt den Status von Enocean Fenstergriffen. Sendet der Fenstergriff "open", wird 3 an den Miniserver weitergesendet, ist gekippt ("tilted"), wird 2 weitergeleitet. Mit den Zahlen kann man Logiken abbilden, oder diese mit einem Status-Baustein wieder als Text darstellen lassen.

Diese Konvertierungen gelten für sämtliche Daten, die eingehen (unabhängig vom Topic). Es kann also nur eine Konvertierung pro Text geben. Duplikate werden ausgefiltert und im Log als Warnung angezeigt. 

Auch andere Plugins können automatisch Conversions anlegen. Die findest du am Ende der Seite, wenn welche vorhanden sind.

In der "Incoming Overview" werden alle von MQTT eingehenden Daten der letzten 24 Stunden angezeigt. 

Je nach in Settings gewählten Übertragungsmethode zum Miniserver - HTTP oder UDP - werden zwei unterschiedliche Listen dargestellt. Die Anzeige der Daten aktualisiert sich automatisch. Wenn du Text markierst, wird die Aktualisierung pausiert.

Oben kannst du Einträge suchen und nach dem Status filtern.

Die Symbole links zeigen, ob

•  die letzte Übertragung erfolgreich war, oder 
•  der VI am Miniserver nicht existiert,
•  der Datensatz seit dem letzten Start noch nicht übertragen wurde (z.B. durch den Cache),
•  der Datensatz gefiltert wurde (Subscription Filter oder "Do-Not-Forward" Flag) , oder ob vielleicht
•  das Gateway keine Berechtigungen auf den VI am Miniserver hat. 

Ein  Symbol bedeutet, dass dieser Virtuelle Eingang bei der letzten Übertragung am Miniserver nicht existiert hat (noch nicht angelegt, oder vertippt?)

Das  Symbol bedeutet, dass dieser Wert bisher nicht neu an den Miniserver übertragen wurde. Das liegt in der Regel am Cache, dass gleiche Werte nicht mehrfach übertragen werden.

Wenn du bei Einträgen ein  Symbol bekommst, prüfe in der Loxone Config, ob der LoxBerry-Benutzer an deinem Miniserver die nötigen Berechtigungen für diesen VI oder insgesamt an deinem Miniserver hat.

Der VI hat einen Copy-Button. Damit kannst du zügig neue Virtuelle Eingänge am Miniserver einrichten.

Wenn du UDP als Übertragungsart gewählt hast, werden dir die Daten, und die möglichen Befehlserkennungen angezeigt.

Du kannst mit dem Copy-Button direkt die Befehlserkennung kopieren, um sie am Miniserver in neue Virtuelle UDP-Eingangs-Befehle (Befehlserkennung) zu kopieren.

Je nach Übertragungsart - HTTP oder UDP - werden dir zusätzliche Informationen und Optionen angezeigt.

• Topic: Zeigt die originale Topic-Bezeichnung an, auch bei JSON-extrahierten Daten.
• Disable Cache: Dieser Wert übergeht das Caching von LoxBerry, und sendet den Wert immer, auch wenn er gleich bleibt.
• Reset after send: Nachdem der Wert gesendet wurde, wird automatisch eine 0 nachgesendet. Das eignet sich für Geräte (z.B. Taster), die lediglich einen Wert (Impuls) senden und dann auf diesem Wert "stehen bleiben". Ein weiterer Impuls würde verursachen, dass wieder der gleiche Wert gesendet würde, und der Miniserver erkennt keine Änderung.  
• Do not forward: Mit aktivierter Checkbox wird dieser Datensatz nicht an den Miniserver weitergeleitet. Das schont Ressourcen am Miniserver. Die Daten von diesen Topics werden in der Incoming Overview durchgestrichen dargestellt. 
• Lösch-Symbol: Damit wird der Wert am Broker und in der Incoming Overview gelöscht.  

Bei HTTP-Übertragung wird dir rechts angezeigt, wann der Datensatz zuletzt zu welchem Miniserver übertragen wurde. Wenn du in den Subscriptions die Übertragung an mehrere Miniserver nutzt, wird das hier für jeden Miniserver angezeigt. Das ist insbesondere interessant in Bezug auf das Caching des Plugins: Bei "Last Arrived" wird angezeigt, wann der Datensatz per MQTT eingegangen ist. In der Details-Ansicht wird angezeigt, wann der letzte Übertragungsversuch an den Miniserver war. Liegen die Zeiten auseinander, hat der Cache die Übertragung eines gleichen Wertes "eingespart".

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: MQTT Gateway - UDP Transformers

Liebe Plugin-Benutzer! Bitte pflegt diese Tabelle mit euren eingesetzten Geräten, MQTT-Infos und Links! 

Die Liste ist jetzt in diesem Unter-Artikel: MQTT-Gateway - Bekannte MQTT-Geräte und Subscription-Topics

• Die Deinstallation des MQTT-Gateway Plugins deinstalliert den Mosquitto-Broker. Bei der Deinstallation werden die zuletzt verwendeten Mosquitto-Zugangsdaten als Benachrichtigung in die Plugin-Verwaltung gesendet.
• Das Plugin integriert sich in den LoxBerry Selbsttest / LoxBerry Healthcheck. Geprüft wird, ob das MQTT Gateway Service läuft, ob es Meldungen bei der Öffnung der Netzverbindungen gab, und ob die Broker-Verbindung korrekt funktioniert.

• Neue MQTT-Geräte ausprobieren, etwa weil Befehle weniger gut dokumentiert sind oder man die idealen Werte erst durch ausprobieren finden muss, ist über die Loxone Config schwierig (auf Miniserver laden, Neustart, Warten…) Da bietet es sich an, die Steuerung via MQTT erst einmal mit einer separaten Client Software auszuprobieren, bevor dann die fertigen Befehle in die Loxone Config übernommen werden. Einen Überblick über passende Software bzw. Apps dafür bietet https://www.hivemq.com/blog/seven-best-mqtt-client-tools/  
• Ebenfalls zum Testen nutzen kannst du den Quick Publisher des MQTT Gateways. Wenn du im Plugin ganz rechts oben das "i" klickst, oder auf die "Transformers & Logs" Seite gehst, findest du dort den "Quick Publisher". Damit kannst du rasch Werte an MQTT-Topics senden zum Ausprobieren. 

• Fehlerkorrekturen
• Gateway: Eigenes Topic zur Steuerung des MS
• Integration in LoxBerry-Core

MQTT Gateway - Troubleshooting Guide

GitHub: https://github.com/christianTF/LoxBerry-Plugin-MQTT-Gateway/issues

Forum: https://www.loxforum.com/forum/projektforen/loxberry/plugins/176025-loxberry-mqtt

Für jeglichen Kontakt bzw. Probleme immer mitliefern:

• das Logfile
• die MQTT-Spezifikation des angebundenen Devices (z.B. direkter Link zur MQTT-Dokumentation des Geräts) 
• Screenshots bzw. Beschreibung der durchgeführten Einstellungen usw.

• MQTT-Gateway - Bekannte MQTT-Geräte und Subscription-Topics
• MQTT - Schritt für Schritt: MQTT -> Loxone
• MQTT - Schritt für Schritt: Loxone -> MQTT
• MQTT Gateway - HTTP- und UDP-Interface
• MQTT Gateway - UDP Transformers
• MQTT Gateway - FAQ
• MQTT Gateway for plugin developers

• Informationen und Best Practices zu Topics und Subscrictions: https://www.hivemq.com/blog/mqtt-essentials-part-5-mqtt-topics-best-practices/
• Miele Home MQTT Gateway: https://www.loxforum.com/forum/projektforen/loxberry/plugins/176967-miele-mqtt-loxberry-mqtt
• Verschiedene MQTT-Interfaces von Devices und Diensten: https://github.com/hobbyquaker/awesome-mqtt#interfaces
• Fronius Hybrid und go-eCharger Bridge:  https://github.com/akleber/mqtt-connectors