| Autor | |
|---|---|
| Logo |
|
| Status | PRERELEASE |
| Version | 0.4.1 |
| Kompatibilität | LB 0.2.3LB 1.2.5 |
| Download | https://github.com/christianTF/LoxBerry-Plugin-MQTT-Gateway/archive/0.4.1.zip |
| Zweck | Installiert den MQTT-Broker Mosquitto und stellt ein MQTT-Gateway für den Miniserver bereit. |
| Languages | EN |
Inhalt
Download
Der direkte Download befindet sich in der Tabelle oben.
Repository: https://github.com/christianTF/LoxBerry-Plugin-MQTT-Gateway
Begriffserklärung
Ein "Broker" ist ein Dienst, der als Vermittler von Nachrichten dient. Der Broker speichert auch den aktuellen Zustand aller angeschlossenen Geräte. Das Plugin installiert automatisch am LoxBerry den Mosquitto MQTT Broker als Vermittler. Ü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 "Server" ist in der Begrifflichkeit von MQTT jedes Gerät, das Daten einliefert. Beispielsweise sind die Shelly's MQTT-Server, die Daten an den Broker übermitteln.
Ein "Client" ist jede Software, die mit dem Broker verbindet und dort Stati abfragt, Befehle sendet bzw. auf Statusänderungen lauscht. Dieses Plugin ist so ein Client, der zum Broker verbindet und sich Statusaktualisierungen abonniert (subscribed). Ist vom Client ein MQTT-Topic abonniert, werden Daten dieses Topics vom Broker an diesen Client zur Verarbeitung weitergeleitet.
Funktion des Plugins
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 dann als Client an diesem MQTT-Broker, und leitet MQTT-Nachrichten an den Miniserver weiter, sowie empfängt Nachrichten vom Miniserver und leitet diese an den MQTT-Broker. Über das Webinterface 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.
MQTT an Loxone Miniserver
Einstellungen
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Miniserver | Erster Miniserver | Die abonnierten Daten werden an diesen Miniserver gesendet. |
| Miniserver-UDP-Port | 11883 | Ist UDP aktiviert, werden Nachrichten an diesen UDP-Port des Miniservers übermittelt. |
| Per REST Webservice übermitteln | Ressourcenschonender als UDP! Die Nachricht wird direkt per HTTP-REST Webservice an den Miniserver übertragen. Dafür müssen selbst entsprechende Virtuelle Eingänge mit exakt dem hier dokumentierten Namen verwendet werden. Das Plugin verwendet die Nachricht als Bezeichnung für den Eingang, wobei / in _ konvertiert werden: shellies/shelly-12345/relay/1 wird zu Schau ins Logfile, dort werden die Bezeichnungen angezeigt. | |
| Per UDP übermitteln | Nachrichtenformat (für die Befehlserkennung): MQTT: shellies/shelly-12345/relay/1=off (oder =0) Befehlserkennung: | |
| Booleans konvertieren | Ein | In MQTT werden häufig Strings bei der Nachricht verwendet, beispielsweise "off" oder "on". Das Plugin konvertiert als Booleans identifizierte Strings in die Werte 0 oder 1. Strings, die erkannt werden, siehe LoxBerry::System::is_enabled bzw. LoxBerry::System::is_disabled |
| JSON expandieren | Werden JSON-Daten übertragen, wird das erste Level der JSON-Struktur (also keine Arrays oder Objekte!) expandiert und an den http-Namen angehängt. Topic/abcde={"action":"on","linkquality":39} wird zu | |
TAB Subscriptions Abonnierte Topics | Die Angabe erfolgt mit einer Zeile pro Topic. Die Topics müssen vom MQTT-Device dokumentiert sein. Eine # definiert dabei einen "Joker" (wie man sonst den * verwendet), z.B. shellies/# abonniert alle Meldungen innerhalb des Topics shellies/. Siehe unten die Kurzübersicht bekannter MQTT-Geräte und Topics. | |
TAB Conversions Eigene Wert-Zu-Text Konvertierung | Da der Miniserver keine Texte weiterverarbeiten kann, können eingehende Nachrichten von einem String zu einem Wert konvertiert werden. Beispiel:
Sendet ein Device Beispielsweise in einem Status-Baustein kann der Wert weiter verarbeitet werden. |
Den Button zum Speichern ganz unten nicht vergessen. Die neue Konfiguration wird beim Speichern automatisch übernommen.
Siehe auch: MQTT - Schritt für Schritt: MQTT -> Loxone
Miniserver an MQTT
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Gateway UDP IN-Port | 11884 | Eingangsport am LoxBerry für UDP-Nachrichten, die an MQTT-Geräte weitergeleitet werden. Folgende Befehle werden unterstützt:
Beispiel 1: |
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.
Siehe auch: MQTT - Schritt für Schritt: Loxone -> MQTT
MQTT Broker-Einstellungen
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Lokalen Mosquitto-Broker verwenden | Ja | Ist dies aktiviert, prüft das Plugin beim Reboot, ob Mosquitto läuft, und startet diesen gegebenenfalls. Aktiv: Lokale Mosquitto-Inszanz wird vom Plugin verwaltet (inkl. Änderung von Benutzername und Passwort) |
| MQTT Broker Adresse | localhost | Hier kann der Hostname angegeben werden, mit dem das Gateway verbinden soll. Wird beim Hostnamen kein Port angegeben, wird der Standardport 1883 verwendet. Eine Portangabe erfolgt per hostname:port |
| MQTT Broker Benutzername | loxberry | Der automatisch installierte Mosquitto-Broker wird mit dem Benutzer loxberry und einem generierten Passwort installiert. Diese Informationen kannst du bei der Einrichtung von Devices von hier kopieren. Wenn du Benutzername und Kennwort nachträglich änderst, musst du das auch bei allen bereits konfigurierten Geräten machen! Leerer Benutzer und leeres Kennwort deaktivieren die Authentifizierung am lokalen Broker. Bei externen Brokern wird hier deren Benutzername und Kennwort eingegeben. |
| MQTT Broker Passwort | <generiert> |
Bekannte MQTT-Geräte und Subscription-Topics
Liebe Plugin-Benutzer! Bitte pflegt diese Tabelle mit euren eingesetzten Geräten, MQTT-Infos und Links! Bitte direkt hier eintragen.
| Anbieter | MQTT-Topic Subscription | Bemerkungen | MQTT-Doku-Link |
|---|---|---|---|
| ALLTERCO ROBOTICS Shelly | shellies/# | Derzeit Bug in der Shelly-Implementierung beim Power-Monitoring (Link) | Link |
| Bluetooth-based passive presence detection | monitor/# (konfigurierbar) | UDP Befehlserkennung für die Confidence: MQTT: monitor/first_floor/12:34:56:78:9a:bc=\i"confidence"\i:"\v | Link |
| Kodi MQTT Addon | kodi/# (konfigurierbar) | Unterstützt auch das Senden von On-Screen-Messages und Play-Befehlen | Link |
| FHEM | (konfigurierbar) | Senden des Status und von Befehlen | Link |
| WinThing | winthing/system/online | Java-Applikation. Unterstützt Befehle wie shutdown, reboot, hibernate, sowie Ausführung beliebiger Commands. | Link |
| Sonoff Tasmota | tele/sonoff/# (zyklischer Status) stat/sonoff/# (Status beim Schalten) (Gerätebezeichnung sonoff konfigurierbar) | Custom Firmware für Sonoff Wifi Geräte Status via stat/sonoff/POWER liefert ON oder OFF als Wert, dies muss im Conversions Tab mit ON=1 und OFF=0 definiert werden | Link |
Weitere Hinweise
- Die Deinstallation des MQTT-Gateway Plugins deinstalliert den Mosquitto-Broker nicht. Die Authentifizierungseinstellungen bleiben ebenfalls erhalten. MQTT kann somit - auch ohne Gateway - weiter verwendet werden. Uninstall von Mosquitto mit
apt-get purge mosquitto mosquitto-clients
Roadmap
- Fehlerkorrekturen
- Mosquitto: Standardmäßig mit Authentifizierung einrichten
- Gateway: Eigenes Topic zur Steuerung des MS
- Gateway: Connection-Status publishen
- Gateway: Last Will And Testament
- Healthstatus aller Verbindungen
- Notifications bei Verbindungsfehlern
Fragen stellen und Fehler melden
GitHub: https://github.com/christianTF/LoxBerry-Plugin-MQTT-Gateway/issues
Forum: https://www.loxforum.com/forum/projektforen/loxberry/plugins/176025-loxberry-mqtt
Fehlerbeschreibungen
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.
Known Issues
- LoxBerry-Problem, Nicht kritisch, in LoxBerry 1.2.6 behoben: https://github.com/mschlenstedt/Loxberry/issues/811
Siehe auch
- Einrichtung am MQTT-Device
- MQTT Gateway - Alle FHEM-Readings weitergeben
- MQTT Gateway - HTTP- und UDP-Interface
- MQTT - Schritt für Schritt: Loxone -> MQTT
- MQTT - Schritt für Schritt: MQTT -> Loxone
- Was ist MQTT? Warum MQTT?
- 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