WagoAppMQTT: Wofür die Bibliothek da ist und wie du sie nutzt

WagoAppMQTT ist eine Applikations-Bibliothek von WAGO für CODESYS 3 / e!COCKPIT, mit der eine WAGO-Steuerung als MQTT-Client arbeitet. Du bindest sie in dein SPS-Projekt ein und kannst damit Prozessdaten an einen MQTT-Broker senden (Publish) und Topics abonnieren (Subscribe).

Die Bibliothek stellt Funktionsbausteine bereit, mit denen deine WAGO-SPS eine Verbindung zu einem MQTT-Broker (z. B. Mosquitto, HiveMQ oder eine Cloud-Plattform) aufbaut. Über diese Bausteine veröffentlichst du Variablenwerte als MQTT-Nachrichten und empfängst umgekehrt Befehle oder Sollwerte. So bekommst du deine Anlage ohne Zusatzhardware ins IoT- bzw. MQTT-Ökosystem.

WagoAppMQTT ist für die programmierbaren WAGO-Controller gedacht, die mit e!COCKPIT/CODESYS 3 programmiert werden – typischerweise die PFC100- und PFC200-Reihe sowie neuere Compact- und Edge-Controller. Klassische 750-Feldbuskoppler ohne eigene CPU können die Bibliothek nicht ausführen. Prüfe im Zweifel im WAGO-Katalog, ob dein Gerät e!COCKPIT-programmierbar ist.

1) Öffne dein Projekt in e!COCKPIT (bzw. CODESYS). 2) Füge über den Bibliotheksverwalter die WagoAppMQTT-Bibliothek hinzu; ist sie nicht vorhanden, lädst du sie über den WAGO-Installer/das WAGO-Portal nach. 3) Lege eine Instanz des Client-Bausteins an und parametrierst Broker-Adresse, Port und ggf. Zugangsdaten. 4) Ruf die Instanz zyklisch auf und ergänzt Publish-/Subscribe-Bausteine für deine Topics.

Kern ist der MQTT-Client-Baustein, der die Verbindung zum Broker verwaltet (Aufbau, Halten, Wiederverbindung, Status). Dazu kommen Bausteine zum Publizieren einzelner Topics und zum Abonnieren. Über Ein- und Ausgänge steuerst du Topic-Name, Nutzdaten (Payload als String/Byte-Array), QoS-Stufe und das Retain-Flag; ein Status-/Fehler-Ausgang zeigt dir, ob die Aktion erfolgreich war.

Unverschlüsseltes MQTT läuft üblicherweise über Port 1883, TLS-gesichertes MQTT über Port 8883. Für TLS musst du in der Steuerung die passenden Zertifikate hinterlegen und den Client entsprechend parametrieren. Nutze in produktiven Anlagen möglichst TLS und Benutzer/Passwort oder Zertifikats-Authentifizierung, statt Daten offen über 1883 zu senden.

Prüfe der Reihe nach: Ist die Broker-IP/der Hostname von der SPS aus erreichbar (Netzwerk, Firewall)? Stimmen Port (1883 vs. 8883) und Zugangsdaten? Passen bei TLS die Zertifikate und die Uhrzeit der Steuerung? Der Status- bzw. Fehler-Ausgang des Client-Bausteins liefert dir einen Code, mit dem du in der WAGO-Doku die genaue Ursache nachschlägst.