> 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-publish.md).

# MQTT Publish (TLS-Beta)

Dieser Funktionsblock ist so konzipiert, dass er Nachrichten an einen MQTT-Broker veröffentlicht. Er ermöglicht es den Benutzern, Brokerparameter, Thema und Nachrichteninhalte anzugeben, was eine einfache Datenkommunikation ermöglicht.

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

`Enable` Dieser boolesche Eingang aktiviert oder deaktiviert die Veröffentlichungsaktion.

`Data` Dieser generische Eingang ermöglicht es Benutzern, jeden Datentyp zu senden, der an das angegebene MQTT-Thema veröffentlicht werden soll.

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

Dieser Funktionsblock erzeugt keine Ausgänge.

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

`Broker Address` Eingabefeld zur Angabe der MQTT-Broker-Adresse.

`Port` Eingabefeld zur Angabe des Ports, um sich mit dem MQTT-Broker zu verbinden (Standard ist 1883).

`Topic` Eingabefeld zur Definition des MQTT-Themas, an das Nachrichten veröffentlicht werden.

`Username` Eingabefeld für den Benutzernamen des Brokers, falls eine Authentifizierung erforderlich ist.

`Password` Eingabefeld für das Passwort des Brokers, falls eine Authentifizierung erforderlich ist.

`Quality of Service` Dropdown-Menü zur Angabe des QoS-Levels für die Nachrichtenübermittlung (Optionen sind 0, 1 oder 2).

`Keep alive (s):` Eingabefeld für das Intervall des Keep-Alive.

`Retain` Ein Schalter, um zu wählen, ob die veröffentlichte Nachricht vom Broker gespeichert werden soll oder nicht.

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

`Easy Configuration` Benutzer können die MQTT-Broker-Einstellungen und die Messaging-Parameter schnell über die Benutzeroberfläche konfigurieren.

`Dynamic Connection Handling` Der Block stellt automatisch die Verbindung zum MQTT-Broker wieder her, wenn sich die Parameter ändern.

`Error Logging` Informative Protokollnachrichten geben Rückmeldung zum Verbindungsstatus und zum Erfolg der Datenveröffentlichung.

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

1. **Set Broker Address and Port**: Geben Sie die MQTT-Broker-Adresse und die Portnummer ein.
2. **Define Topic and Auth Credentials**: Geben Sie das Thema für die Veröffentlichung an und, falls erforderlich, den Benutzernamen und das Passwort.
3. **Adjust Parameters**: Stellen Sie das Quality of Service (QoS)-Level ein und geben Sie die erforderliche Keep-Alive-Dauer an.
4. **Connect and Enable**: Aktivieren Sie den Block und verbinden Sie ihn mit den Dateneingängen, um mit der Veröffentlichung zu beginnen.
5. **Monitor Logs**: Überprüfen Sie die Protokolle auf den Verbindungsstatus und erfolgreich veröffentlichte Daten.

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

Beim Ausführen sendet dieser Funktionsblock die bereitgestellten Daten an das angegebene MQTT-Thema und protokolliert den Erfolg oder etwaige Fehler, die während des Prozesses aufgetreten sind.

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

<details>

<summary>Using Quality of Service</summary>

Wählen Sie ein höheres QoS-Level (1 oder 2) für zuverlässigere Zustellung wichtiger Nachrichten, insbesondere bei instabilen Netzwerkbedingungen.

</details>

<details>

<summary>Testing Connection</summary>

Bevor Sie Daten veröffentlichen, testen Sie die Verbindung separat und verwenden Sie die Protokolle, um mögliche Verbindungsprobleme zu diagnostizieren.

</details>

<details>

<summary>Retaining Messages</summary>

Verwenden Sie die Funktion `Retain` mit Bedacht, da sie den Broker veranlasst, die zuletzt veröffentlichte Nachricht für dieses Thema zu speichern, was Auswirkungen auf die Subscriber haben kann, die die aktuellsten Daten benötigen.

</details>

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

<details>

<summary>MQTT Connection Issues</summary>

Wenn Sie auf Verbindungsfehler stoßen, überprüfen Sie die Broker-Adresse und die Portnummer. Stellen Sie außerdem sicher, dass Ihr Netzwerk MQTT-Verkehr zulässt.

</details>

<details>

<summary>Failed to Publish Data</summary>

Wenn Daten nicht veröffentlicht werden können, stellen Sie sicher, dass der MQTT-Client verbunden ist. Überprüfen Sie die Protokollnachrichten auf Fehlercodes, die das Problem anzeigen könnten.

</details>