Zum Hauptinhalt springen

MQTT (Entwicklersicht)

Ein Publish/Subscribe-Messaging-Protokoll. Alles dreht sich um abonnierte Topics (Empfangen) und veröffentlichte Topics (Senden); die Parameter liegen in den MQTT-Einstellungen des Requests.

Konfiguration in der UI​

Verbindungseinstellungen des MQTT-Requests ausfüllen:

EinstellungBedeutung
Client ID (clientId)Identität dieser Verbindung
AbonnementlisteEin Satz aus Topics + QoS, wird nach dem Verbinden automatisch abonniert
Publish-TopicDas Standard-Topic, an das Nachrichten gesendet werden
Publish QoS / retainQuality of Service und Retain-Flag beim Senden
  • Topic-Wildcards: # matcht mehrere Ebenen, + matcht eine einzelne Ebene (z. B. qr/manual/#).
  • QoS: 0 (höchstens einmal) / 1 (mindestens einmal) / 2 (genau einmal).
  • Host trägt die Broker-Adresse, der Port ist separat (z. B. 127.0.0.1:18884); mqtts:// nutzt TLS.

Kernablauf​

Nutzung​

  1. MQTT-Request anlegen und clientId, Abonnements sowie Publish-Topic gemäß der Tabelle oben konfigurieren.
  2. Verbinden: Die Sitzung abonniert gemäß Ihrer Konfiguration automatisch und merkt sich das Standard-Publish-Topic.
  3. Veröffentlichen: Inhalt an das Publish-Topic senden (Topic/QoS/retain lassen sich pro Nachricht ändern); leere Payloads sind gültig.
  4. Empfangen: Eingehende Nachrichten erscheinen in Echtzeit — sowohl eigene Loopback-Nachrichten, die auf Abonnements treffen, als auch andere Nachrichten, die der Broker an abonnierte Topics pusht.
  5. Während der Sitzung können Sie abonnieren / Abonnement beenden; schließen Sie die Sitzung, wenn Sie fertig sind.

Verifiziertes Verhalten​

Vorab abonniertes qr/manual/# + Veröffentlichen von {"evt":"auto-sub"} an qr/manual/hello → liefert PUBACK (QoS1 acknowledged) und der Loopback-Nachrichtenbody kommt an — ein geschlossener Sende-/Empfangskreislauf.

Stolperfallen​

  • Eigene Veröffentlichung kommt nicht an: Prüfen, dass das Publish-Topic zu einem Ihrer Abonnements passt (z. B. beide unter qr/manual/#).
  • Zur Laufzeit hinzugefügte oder entfernte Abonnements gelten nur für die aktuelle Sitzung — langlebige Abonnements gehören in die Request-Konfiguration.
  • Langfristige Verbindungen belegen Kontingent und werden bei Inaktivität zurückgeholt; nach dem Debuggen schließen.

Verwandt: Abonnement-Wildcards und QoS sind oben erklärt; die Verbindung kommt aus der mqtt-Pre-URL der Umgebung (siehe Kernkonzepte).