# MQTT > Symcon Dokumentation · Deutsch · erzeugt am 2026-09-26 > Index: https://www.symcon.de/de/llms.txt Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/mqtt/ MQTT ist ein offenes Nachrichtenprotokoll für Machine-to-Machine-Kommunikation (M2M). IP-Symcon agiert in diesem Zusammenhang sowohl als Server (Broker) als auch Client. > **Hinweis:** Folgende Geräte werden von IP-Symcon unterstützt: > > [Unterstützte Geräte](mqtt.md) ### Einbindung in IP-Symcon Zur Verwendung von MQTT stehen IP-Symcon sowohl Clients als auch Server (Broker) zur Verfügung. [Einrichtung von MQTT-Server](mqtt.md) [Einrichtung von MQTT-Client](mqtt.md) ## Geräteliste Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/mqtt/geraeteliste/ ### Unterstützte Gateways/Komponenten IP-Symcon unterstützt alle MQTT Client Geräte. ### Unterstützte Funktionen #### Ab IP-Symcon 5.1 * MQTT 3.1/3.1.1 kompatibel * Clients können sich verbinden/trennen * Clients können Nachrichten auf Topics schicken (QoS 0-2) * Clients können Topics (inkl. Filter +/#) abonnieren (Diese werden immer mit QoS 0 gesendet) * Clients können sich mit Benutzername/Kennwort authentifizieren #### Ab IP-Symcon 5.3 * Retain (ab 5.5 auch Persistent) * Session Management (Siehe Timeout und Queue Limit Einstellungen im Server) * Last Will/Testament * Publish eines Clients wird nur in IP-Symcon ausgewertet und nicht an die anderen Clients weitergeleitet #### Ab IP-Symcon 5.5 * Persistentes Retain * MQTT Client * TLS (Server Socket) * Keep Alive (+ Last Will bei Timeout versenden) #### Noch fehlende Funktionen Folgende Funktionen fehlen und sind geplant * QoS 1-2 beim Senden ## MQTT Client Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/mqtt/mqtt-client/ MQTT Clients haben einen MQTT Server abonniert und können Werte von diesem Empfangen und darstellen. ### Video-Tutorial zur Einrichtung [Video](https://www.youtube.com/embed/dVMgHm5LeX0?rel=0&cc_load_policy=1) ### Einbindung in IP-Symcon Um eine einfache und komfortable Einbindung zu ermöglichen, wird empfohlen den [Konfigurator](../concepts.md) für MQTT Client zu nutzen. Dieser kann im Objektbaum über "+"->"Instanz" via Schnellfilter "MQTT Konfigurator" hinzugefügt werden. In der Instanzkonfiguration des dazughörigen MQTT Client (Gateway) können die gewünschten Subskriptions angelegt werden. Eine "#" ist der Standard und es werden alle Daten des MQTT Servers abonniert. In der Instanzkonfiguration des dazugehörigen Client Sockets kann die Hostadresse und der Port definiert sowie die Verbindung aktiv gesetzt werden. Der Port muss identisch mit dem Port des MQTT-Servers sein. Nach der Einrichtung des MQTT-Client Konfigurators ist der nächste Schritt das Hinzufügen und Erstellen von Geräteinstanzen. #### Hinzufügen von Geräten Der Client empfängt die Werte der abonnierten Themen des MQTT Servers. Der Konfigurator kann diese Daten lesen und zeigt alle Themen, welche sich gemeldet haben an. Über "Aktualisieren" wird die Anzeige aller empfangenen Themen und deren zuletzt empfangenen Nutzdaten aktualisiert. Über "Erstellen" kann die ausgewählte Instanz erstellt werden. Der MQTT Client hat eine voreingerichtete ClientID. Der Benutzername und das Passwort müssen mit denen des Servers übereinstimmen. ![Konfiguration](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/mqtt/mqtt-client/38e223e7c4-1790424938/mqtt-client-config.png) > **Hinweis:** Wenn als Subkription die "#" eingetragen wird, werden alle Themen eines MQTT Servers Empfangen. Es können dann über den Konfigurator oder manuell erstellten Devices Nachrichten an den MQTT Server gesendet werden. Dieser leitet diese dann alle anderen Clients weiter. ![Instanz](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/mqtt/mqtt-client/b0e5b781ba-1790424938/mqtt-client-instanceconfig.png) ### Beispiel Skriptbeispiel für das Publishen eines Wertes auf ein Thema. Das Thema ist durch die MQTT Device Instanz definiert. ```php //Publishen von "EinTollerWertZumPublishen" auf die Variable mit der ID 12345 RequestAction(12345, "EinTollerWertZumPublishen"); ``` ## MQTT-Server Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/geraete/mqtt/mqtt-server/ Der MQTT-Server in IP-Symcon agiert als sogenannter MQTT-Broker. Clients können sich bei diesem anmelden und bekommen ihre Daten über diesen. ### Video-Tutorial zur Einrichtung [Video](https://www.youtube.com/embed/5msmo1JSxSo?rel=0&cc_load_policy=1) ### Einbindung in IP-Symcon Um eine einfache und komfortable Einbindung zu ermöglichen, wird empfohlen den [Konfigurator](../concepts.md) für MQTT-Server zu nutzen. Dieser kann im Objektbaum über "+"->"Instanz" via Schnellfilter "MQTT Server" hinzugefügt werden. IP-Symcon agiert als MQTT-Server (Broker) und benötigt dafür eine geöffnete Server Socket Schnittstelle. In der Instanzkonfiguration des dazughörigen Server Sockets kann der Port definiert und die Verbindung aktiv gesetzt werden. Des Weiteren kann in der Instanzkonfiguration des MQTT-Servers ein Benutzername und festgelegt werden. Die MQTT Clients müssen dann auf den eingerichteten Port senden. Nach der Einrichtung des MQTT Konfigurators ist der nächste Schritt das Hinzufügen und Erstellen von Geräteinstanzen. #### Hinzufügen von Geräten Der Server (Broker) empfängt die Werte und Eigenschaften der MQTT Geräte. Der Konfigurator kann diese Daten lesen und zeigt alle Geräte, welche sich gemeldet haben an. Sollte ein Gerät nicht angezeigt werden, muss sichergestellt werden, dass dieses Gerät eine Nachricht an den Server geschickt hat. Über "Aktualisieren" wird die Anzeige aller empfangenen Themen und deren zuletzt empfangenen Nutzdaten aktualisiert. Über "Erstellen" kann die ausgewählte Instanz erstellt werden. ![Konfigurator](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/mqtt/mqtt-server/d1c2e880a7-1790424938/mqtt-configurator.png) Der Konfigurator erstellt den Pfad des Themas mit den passenden Kategorien und die Nutzdatenvariable vom Datentyp "String". Sofern ein anderer Datentyp gewünscht wird, kann dieser in der Instanz umgestellt werden. ![Objektbaum](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/mqtt/mqtt-server/31969eac93-1790424938/mqtt-objects.png) ![Instanz](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/geraete/mqtt/mqtt-server/e110d44f6b-1790424938/mqtt-instanceconfig.png) > **Hinweis:** Geräte, welche selbst nur Empfangen ("Subscriben") und nicht senden ("Publishen") können, können nicht über den Konfigurator erstellt werden, da dieser niemals etwas von den Geräten empfängt. Für diese Geräte muss ein MQTT-Device erstellt, ein Thema eingetragen und Datentyp festgelegt werden. (Siehe auch: [Instanz erstellen](../how-to.md)) ### Beispiel Skriptbeispiel für das Publishen eines Wertes auf ein Thema. Das Thema ist durch die MQTT Device Instanz definiert. ```php //Publishen von "EinTollerWertZumPublishen" auf die Variable mit der ID 12345 RequestAction(12345, "EinTollerWertZumPublishen"); ```