> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/german/funktionsblocke/blocks-reference/input-output/communication/mqtt-subscribe.md).

# MQTT Subscribe

Dieser Funktionsblock ist so konzipiert, dass er sich auf ein bestimmtes MQTT-Thema anmeldet und Nachrichten empfängt. Er ermöglicht es Ihnen, die MQTT-Kommunikation nahtlos in Ihre Anwendung zu integrieren.

## 📥 Eingänge <a href="#inputs" id="inputs"></a>

`Enable` Dieser boolesche Eingang aktiviert oder deaktiviert das MQTT-Abonnement.

## 📤 Ausgänge <a href="#outputs" id="outputs"></a>

`Data` Diese Ausgabe liefert die letzte Nachricht, die auf dem abonnierten MQTT-Thema empfangen wurde.

`New Data` Eine boolesche Ausgabe, die angibt, ob neue Daten seit der letzten Auswertung empfangen wurden.

## 🕹️ Steuerungen <a href="#controls" id="controls"></a>

`MQTT Topic Input` Ein Feld, in dem der Benutzer das Thema angeben kann, auf das sich dieser Block anmelden möchte.

`Reconnect` Ein Schalter oder Button, der es dem Benutzer ermöglicht, sich mit aktualisierten Einstellungen erneut mit dem MQTT-Broker zu verbinden.

## 🎨 Funktionen <a href="#features" id="features"></a>

`Real-Time Messaging` Der Block hört kontinuierlich auf Nachrichten auf dem angegebenen MQTT-Thema und aktualisiert die Ausgaben in Echtzeit.

`Dynamic Subscription Management` Der Block kann Änderungen an den Abonnementparametern verarbeiten, was dynamische Anpassungen ohne erneute Verbindung ermöglicht.

`Connection Status Logging` Informationen über den Verbindungsstatus und empfangene Nachrichten werden protokolliert, was bei der Fehlersuche und Überwachung hilft.

## 📝 Nutzungshinweise <a href="#usage" id="usage"></a>

1. **Enter MQTT Topic**: Geben Sie das MQTT-Thema im Feld `MQTT Topic Input` an.
2. **Enable Subscription**: Verbinden Sie ein boolesches Signal mit dem Eingangsbereich `Enable`, um das Abonnieren zu ermöglichen oder zu verweigern.
3. **Receive Messages**: Die neuesten Nachrichten werden über die Ausgabe `Data` bereitgestellt, und die Ausgabe `New Data` zeigt an, ob neue Nachrichten seit der letzten Auswertung empfangen wurden.
4. **Cleanup**: Wenn Sie fertig sind, trennt sich der Block automatisch vom MQTT-Broker, wenn er entfernt oder deaktiviert wird.

## 📊 Bewertung <a href="#evaluation" id="evaluation"></a>

Bei jedem Bewertungszyklus überprüft dieser Funktionsblock, ob Daten empfangen wurden, und gibt die neueste Nachricht zusammen mit einem Flag zurück, das angibt, ob sie neu ist.

## 💡 Tipps und Tricks <a href="#tips-and-tricks" id="tips-and-tricks"></a>

<details>

<summary>Testen der Verbindung</summary>

Stellen Sie sicher, dass Ihr MQTT-Broker von Ihrem Netzwerk aus zugänglich ist, bevor Sie sich anmelden. Wenn Sie Probleme haben, überprüfen Sie die Einstellungen Ihres Brokers.

</details>

<details>

<summary>Empfangen von JSON-Daten</summary>

Wenn Sie JSON-formatierte Nachrichten empfangen, sollten Sie in Betracht ziehen, danach einen Block `Data Type Converter` zu verwenden, um den eingehenden String in verwendbare Datenstrukturen zu verarbeiten.

</details>

<details>

<summary>Debuggen von Nachrichten</summary>

Verwenden Sie Protokollausgaben, um die empfangenen Daten und den Verbindungsstatus zu überwachen. Dies kann helfen, Probleme mit der Verbindung oder dem Abonnement auszuschließen.

</details>

## 🛠️ Fehlersuche <a href="#troubleshooting" id="troubleshooting"></a>

<details>

<summary>Verbindungsfehler</summary>

Wenn Sie einen Verbindungsfehler erhalten, überprüfen Sie die Broker-URI, die Anmeldeinformationen und dass der Broker läuft. Überprüfen Sie auch Ihre Internetverbindung und Firewall-Einstellungen.

</details>

<details>

<summary>Keine neuen Daten empfangen</summary>

Stellen Sie sicher, dass es Veröffentlichungen zu dem Thema gibt, auf das Sie abonniert sind. Überprüfen Sie andere Geräte oder Anwendungen, um sicherzustellen, dass sie Nachrichten senden.

</details>
