MQTT Subscribe (TLS-Beta)

Dieser Funktionsblock verbindet sich mit einem MQTT-Broker und hört auf Nachrichten zu einem gewählten Topic über eine TLS‑(sichere) Verbindung. Er empfängt eingehende Text‑Payloads und signalisiert, wenn neue Daten angekommen sind, sodass Sie diese in Ihrem Szenario weiterverarbeiten oder weiterleiten können.

📥 Eingänge

Enable Dieser boolesche Eingang steuert, ob das Abonnement aktiv ist. Auf TRUE setzen, um Nachrichten zu empfangen; FALSE deaktiviert die Verarbeitung.

📤 Ausgänge

Data Text‑Payload der zuletzt empfangenen Nachricht.

New Data Boolesches Flag, das für eine einzelne Auswertung TRUE wird, wenn eine neue Nachricht empfangen wurde.

🕹️ Steuerungen

Server / Broker Geben Sie die Adresse oder den Hostnamen des MQTT‑Brokers ein.

Port Setzen Sie den Broker‑Port (häufiger TLS‑Port ist 8883).

Topic Geben Sie das Topic an, auf das abonniert werden soll. Eingehende Nachrichten zu diesem Topic erscheinen am Ausgang Data.

Client ID Optionale Kennung für diesen Client beim Broker.

Username Optionaler Benutzername für die Broker‑Authentifizierung.

Password Optionales Passwort für die Broker‑Authentifizierung.

Use TLS Umschalter zum Aktivieren des sicheren (TLS) Verbindungsmodus.

CA Certificate Option, ein CA‑Bundle zur TLS‑Zertifikatsprüfung bereitzustellen oder darauf zu verweisen (der Block unterstützt System‑CA‑Verifizierung).

Connect Bedienelement, um die Verbindung mit den aktuellen Einstellungen zu initiieren oder neu herzustellen.

Auto Reconnect Umschalter, um bei Verbindungsverlust automatisch neu zu verbinden.

Hinweis: Falls die Block‑UI kompakt ist, können einige erweiterte Optionen gruppiert oder in einem "Advanced"‑Bereich liegen.

🎯 Funktionen

• Sicheres MQTT‑Abonnement mit TLS‑Unterstützung für verschlüsselte Kommunikation.

• Live‑Kennzeichnung neuer Nachrichten über den Ausgang New Data, damit nachgelagerte Verarbeitung nur bei Bedarf ausgelöst wird.

• Flexible Topic‑Auswahl zur Anmeldung bei jedem gültigen MQTT‑Topic.

• Verbindungsparameter und grundlegende Authentifizierungsoptionen für die meisten Broker‑Konfigurationen.

• Ruhiges Neuverbinden (graceful reconnect), sodass temporäre Netzstörungen keine manuelle Eingriffe erfordern.

📝 Nutzungshinweise

1. Konfigurieren Sie Ihre Broker‑Details mit Server / Broker, Port und ggf. den Authentifizierungsfeldern.

2. Tragen Sie das Topic ein, das Sie überwachen möchten, im Feld Topic.

3. Aktivieren Sie den Block, indem Sie TRUE an den Eingang Enable senden oder die Connect/Enable‑Steuerung in der Block‑UI verwenden.

4. Lesen Sie eingehende Text‑Payloads vom Ausgang Data. Verwenden Sie New Data, um nachgelagerte Blöcke nur bei neuen Nachrichten auszulösen.

5. Wenn Sie Verbindungsparameter ändern, verwenden Sie Connect (oder toggeln Sie Enable), um die Änderungen anzuwenden.

📊 Bewertung

Wenn der Block aktiv ist, hält er ein Abonnement auf das konfigurierte Topic aufrecht. Bei jedem Lauf gibt er die zuletzt empfangene Payload auf Data aus und setzt New Data nur dann auf TRUE, wenn seit der letzten Auswertung eine neue Nachricht angekommen ist.

💡 Tipps und Tricks

• Verwenden Sie Parse Data Dictionary oder Data to JSON nach MQTT Subscribe (TLS-Beta), um eingehende JSON‑Texte in strukturierte Werte zu konvertieren.

• Zum Protokollieren eingehender Nachrichten verbinden Sie Data mit CSV Export oder Data to JSON und anschließend mit einem Export‑Block.

• Kombinieren Sie mit Debug Input, um Nachrichten während der Einrichtung anzuzeigen oder zu prüfen.

• Nutzen Sie Logic Input oder Rising Edge, um Aktionen nur auszulösen, wenn New Data TRUE wird.

• In verteilten Szenarien koppeln Sie diesen Block mit Data Write Global / Data Read Global, um die letzte Nachricht in verschiedenen Zweigen des Szenarios zu teilen.

• Enthält die Nachricht Bildreferenzen oder kodierte Bilddaten, dekodieren Sie das Bild und senden es an Show Image, um eine Vorschau zu sehen.

• Zum Senden von Antworten oder Bestätigungen verwenden Sie den entsprechenden MQTT Publish (TLS-Beta)‑Block.

🛠️ Fehlersuche

• Verbindungsfehler: Überprüfen Sie Server / Broker, Port und die Netzwerkverbindung. Stellen Sie sicher, dass TLS‑Port und Firewall‑Regeln korrekt sind.

• Authentifizierungsfehler: Prüfen Sie Username und Password und bestätigen Sie die Broker‑ACLs.

• Keine Nachrichten: Überprüfen Sie den genauen Topic‑String (Wildcards und Hierarchie sind relevant) und ob ein anderer Client tatsächlich veröffentlicht. Nutzen Sie einen einfachen Test‑Client zur Überprüfung.

• Unerwartetes Nachrichtenformat: Verwenden Sie Parse Data Dictionary oder String Operations, um Payloads zu analysieren und zu normalisieren.

• TLS‑Probleme: Wenn die Zertifikatsprüfung fehlschlägt, stellen Sie sicher, dass das CA‑Bundle verfügbar ist oder nutzen Sie die System‑CA‑Option. Nur zur Fehlersuche können Sie eine unverschlüsselte Verbindung (falls vom Broker erlaubt) testen, um die Ursache einzugrenzen.