Beschreibung
Logikbaustein, der auf dem X1 einen MQTT-Broker startet. Optional dürfen sich nur Clients mit Benutzername und Passwort anmelden. Die Ausgänge zeigen, ob der Broker läuft und welche Clients verbunden sind. Zusammen mit „MQTT Publish | SMoLabs“ und „MQTT Subscribe | SMoLabs“ kommt der X1 ohne externen Broker aus.
Wichtig: Im Projekt darf kein weiterer Baustein verwendet werden, der auf dem X1 ebenfalls einen Server aufbaut und dadurch den Port blockiert, z. B. der WebServer-Baustein von Splendid Minds. Beide brauchen denselben Port (8081), der MQTT Server startet dann nicht. Solche Bausteine müssen aus dem Projekt entfernt werden.
- Gerät
- Gira X1
- Version
- 1.0.3
- Lizenz
- Ein Schlüssel je X1 (MAC-Adresse), dauerhaft nutzbar
- Thema
- Kommunikation
Anleitung
Einrichtung
- Port eintragen. Vorgabe ist 8081, siehe Hinweis unten.
- Bei Bedarf Benutzername und Passwort eintragen. Leer heißt, dass sich jeder Client anonym anmelden darf.
- Den Eingang Starten (1 = starten, 0 = stoppen) mit dem Datenpunkt „Bereit“ des X1 verbinden.
Hinweis zum Port: Auf dem X1 ist Port 8081 erprobt, der übliche MQTT-Port 1883 ist dort nicht vorgesehen. Die Clients müssen also Port 8081 statt 1883 verwenden. Der Baustein ist nur über IPv4-Adressen erreichbar (z. B. 192.168.1.10), nicht über IPv6.
Hinweis zur Sicherheit: Der Broker ist auf allen Netzwerkschnittstellen des X1 erreichbar. Ohne Benutzername kann sich jedes Gerät im Netz anmelden, Nachrichten lesen und senden. Benutzername und Passwort setzen und den Port nicht per Portweiterleitung ins Internet freigeben.
Eingänge
| Eingang | Wirkung |
|---|---|
| Starten (1 = starten, 0 = stoppen) | 1 startet den Broker, 0 stoppt ihn und trennt alle Clients. Ein erneutes 1 bei laufendem Broker ändert nichts. |
Parameter
| Parameter | Bedeutung |
|---|---|
| Port | TCP-Port des Brokers, Vorgabe 8081 |
| Benutzername (leer = anonym), Passwort | Sonst müssen beide genau stimmen (Groß- und Kleinschreibung zählt). |
| Lizenzschlüssel | Schlüssel für diesen X1, siehe „Lizenz“ |
Ausgänge
| Ausgang | Inhalt |
|---|---|
| Läuft | 1, solange der Broker läuft |
| Anzahl Clients | Anzahl der verbundenen Clients |
| Verbundene Clients | Namen (Client-IDs) der verbundenen Clients, sortiert (Großbuchstaben vor Kleinbuchstaben) und durch Komma getrennt (ausgeblendet) |
| Lizenzstatus | Ergebnis der Lizenzprüfung |
| Debug | Start, Stopp, abgelehnte Anmeldungen und Fehler (ausgeblendet) |
Ausgeblendete Ausgänge lassen sich im GPA (Gira Projekt Assistent) am Baustein einblenden.
Verhalten
- Start und Stopp laufen nacheinander. Auch bei schnellem Umschalten wird der Broker nicht doppelt gestartet.
- Gehaltene Nachrichten (Retain, der Broker merkt sich den letzten Wert eines Topics) liegen nur im Speicher. Nach einem Stopp oder Neustart des X1 sind sie weg und werden erst durch neue Nachrichten wieder gesetzt.
- Unterstützt wird MQTT ohne Verschlüsselung (TLS).
Fehlerverhalten
| Debug | Ursache |
|---|---|
| Fehler: Port … wird bereits verwendet | Ein anderer Dienst oder Baustein belegt den Port. Port ändern oder den anderen Baustein entfernen. |
| Fehler beim Start: … | Sonstiger Fehler beim Öffnen des Ports |
| Anmeldung abgelehnt: Client-ID …, Benutzer ‚…‘ | Benutzername oder Passwort des Clients stimmen nicht |
Lizenz
Der Lizenzschlüssel wird im GPA im Parameter „Lizenzschlüssel“ eingetragen. Der Baustein prüft ihn beim Start auf dem X1, offline und gebunden an die MAC-Adresse des X1. Der Ausgang „Lizenzstatus“ zeigt das Ergebnis, bei einem Schlüssel für ein anderes Gerät auch die MAC-Adresse dieses X1. Ohne gültigen Schlüssel startet der Broker nicht. In der Simulation des GPA am PC läuft er ohne Lizenzprüfung, damit sich Logikblätter testen lassen.
Läuft eine Testlizenz ab, stoppt der Broker zum Ablaufzeitpunkt und trennt alle Clients. Den Schlüssel erhältst du beim Kauf über smolabs.de.
Changelog
Version 1.0.3
- Die Logik-Engine des X1 stürzte ab, sobald der Broker eine Nachricht an einen Abonnenten weitergab. Das ist behoben, Veröffentlichen auf exakte Topics und Wildcards läuft auf dem X1.
- Der Broker startet auf dem X1 (zuvor brach der Start mit einem Fehler in der Mono-Laufzeit ab).
Version 1.0.0
- Erste Version.
Rezensionen
Es gibt noch keine Rezensionen.