# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.augelab.com/german/function-blocks/input-output/communication/mqtt-subscribe.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
