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


---

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