| Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung |
| smart_energy_box:zaehler_hinzufuegen_mqtt [17.10.2024 13:02] – tgoetz | smart_energy_box:zaehler_hinzufuegen_mqtt [21.10.2026 11:21] (aktuell) – administrator |
|---|
| ====== 3.2.4 MQTT ====== | ====== 2.3.2.4 MQTT ====== |
| |
| Im Zuge der fortschreitenden Digitalisierung und der Verwendung von Cloud-Diensten gewinnt das sichere Kommunikationsprotokoll **MQTT** (**"Message Queuing Telemetry Transport"**, weitere Infos siehe: [[https://www.paessler.com/de/it-explained/mqtt|Was ist MQTT?]] zunehmend an Bedeutung. | Im Zuge der fortschreitenden Digitalisierung und der Nutzung von Cloud-Diensten gewinnt das sichere Kommunikationsprotokoll **MQTT** (**"Message Queuing Telemetry Transport"**, weitere Infos siehe: [[https://www.paessler.com/de/it-explained/mqtt|Was ist MQTT?]] zunehmend an Bedeutung. |
| |
| Nachfolgend wird die Einbindung von MQTT-Geräten in IP Symcon am Beispiels eines **IoT-Sensors** ("Internet of Things") für Temperatur und Feuchte veranschaulicht. | Nachfolgend wird die Einbindung von MQTT-Geräten in IP Symcon am Beispiels eines **IoT-Sensors** ("Internet of Things") für Temperatur und Feuchte veranschaulicht. |
| ===== A) Smart Energy Box als MQTT-Server ===== | ===== A) Smart Energy Box als MQTT-Server ===== |
| |
| **1.** Über das **„Plus“** im Objektbaum __oder__ durch **Rechtsklick auf den Ordner "Konfigurator Instanzen" -> Objekt hinzufügen -> Instanz** eine neue Instanz hinzufügen. Bei der Instanzkonfiguration das Gerät **„MQTT Server Configurator“** auswählen. Am Einfachsten gibt man hierzu in den Schnellfilter „MQTT“ ein. **Name** vergeben und mit **"OK"** bestätigen. | Wenn die Smart Energy Box die Rolle des MQTT-Brokers (Server) übernehmen soll, ist wie folgt vorzugehen: |
| | |
| | **1.** Über das **„Plus“** im Objektbaum __oder__ durch **Rechtsklick auf den Ordner "Konfigurator Instanzen"((Konfiguratoren stellen in IP-Symcon eine ganz spezielle Art von Instanzen dar, die die Einrichtung von Geräten und Variablen in IP-Symcon erheblich erleichtern.)) -> Objekt hinzufügen -> Instanz** eine neue Instanz hinzufügen. Bei der Instanzkonfiguration das Gerät **„MQTT Server Configurator“** auswählen. Am Einfachsten gibt man hierzu in den Schnellfilter „MQTT“ ein. **Name** vergeben und mit **"OK"** bestätigen. |
| |
| {{ smart_energy_box:seb_abbildung104.png?1000 }} | {{ smart_energy_box:seb_abbildung104.png?1000 }} |
| |
| **2.** Neu erstellte Instanz mit Doppelklick öffnen -> auf "Gateway konfigurieren" klicken -> Einstellungen des MQTT-Servers vornehmen. \\ <wrap tip>Die Einstellungen des MQTT Servers, inkl. Benutzername und Passwort sind nur dann wichtig, wenn ein anderer Client drauf zugreifen möchte.</wrap> | **2.** Neu erstellte **Instanz** mit Doppelklick **öffnen** -> auf **"Gateway konfigurieren"** klicken -> Einstellungen des MQTT-Servers vornehmen: **Benutzername und Passwort** vergeben, damit später eine sichere Verbindung aufgebaut werden kann. Im Regelfall öffnet sich auch direkt schon das Schnittstellenfenster in dem man auswählen kann ob man eine neue, oder bereits existierende Instanz benutzen möchte. |
| |
| **3.** Anschließend ist die Schnittstelle zu konfigurieren. Hierfür auf "Schnittstelle konfigurieren" klicken -> Schnittstelle "Aktiv" schalten -> den richtigen Port, der mit dem Port auf dem entsprechenden IoT Gerät übereinstimmen muss, eintragen. | **3.** Anschließend ist die Schnittstelle zu konfigurieren. Hierfür auf **"Schnittstelle konfigurieren"** klicken -> Schnittstelle **"Aktiv"** schalten -> den richtigen **Port** (Empfehlung: Standard-Port 1883), der mit dem Port auf dem entsprechenden IoT Gerät übereinstimmen muss, eintragen. |
| |
| {{ smart_energy_box:seb_abbildung105.png?800 }} | {{ smart_energy_box:seb_abbildung105.png?800 }} |
| |
| **4.** Für die Einbindung des IoT Sensors müssen in diesem die IP-Adresse der Smart Energy Box und der richtige Port eingetragen werden. <wrap important>Vergessen Sie nicht die neuen Einstellungen auf dem Gerät zu **speichern**.</wrap> | Der MQTT-Server ist jetzt konfiguriert. |
| | |
| | **4.** Als nächstes muss die **Client-Server-Kommunikation** hergestellt werden. Hierfür müssen die **IP-Adresse der Smart Energy Box** und der richtige **Port** auf dem IoT-Sensor über die Konfigurationsschnittstelle eingetragen werden. \\ <wrap important>Vergessen Sie nicht, die neuen Einstellungen auf dem Gerät zu **speichern**.</wrap> |
| |
| {{ smart_energy_box:seb_abbildung106.png?1000 }} | {{ smart_energy_box:seb_abbildung106.png?1000 }} |
| |
| **5.** Wenn diese Einstellungen vorgenommen sind, auf der Smart Energy Box in der „MQTT Server Configurator“-Instanz auf **„Aktualisieren“** klicken. Im Beispiel des IoT-Sensors werden die beiden Werte für Temperatur und Feuchtigkeit angezeigt. | **5.** Nachdem diese Einstellungen vorgenommen wurden, auf der Smart Energy Box in der „MQTT Server Configurator“-Instanz auf **„Aktualisieren“** klicken. Im Beispiel des IoT-Sensors werden die beiden Werte für Temperatur und Feuchtigkeit in der Liste angezeigt. |
| |
| {{ smart_energy_box:seb_abbildung107.png?1000 }} | {{ smart_energy_box:seb_abbildung107.png?1000 }} |
| |
| **6.** Die beiden Variablen können dem Objektbaum mit dem **Button „Alle Erstellen“** hinzugefügt werden. | **6.** Die beiden Variablen können dem Objektbaum mit dem **Button „Alle Erstellen“** hinzugefügt werden. Sollen nur einzelne Variablen angelegt werden, ist der Button "Hinzufügen" zu nutzen. |
| |
| {{ smart_energy_box:seb_abbildung108.png?1000 }} | {{ smart_energy_box:seb_abbildung108.png?1000 }} |
| |
| Der weitere Ablauf (Benennung der Variablen, Aktivierung der Archivierung bzw. des Loggings, Einbindung in die Datenbank-Synchronisierung) ist derselbe wie in den vorherigen Abschnitten bereits beschrieben worden ist. (siehe Abbildung 100) | **7.** Die Variablen / Datenpunkte umbenennen: Aussagekräftige **Klartext-Bezeichnung** inkl. Angabe der (zuvor mit Hilfe des KS-Tools erstellten) **Datenpunktkennzeichnung**. |
| |
| Wenn nun auf die Variable (hier 1 bzw. 2) doppelt geklickt wird kann als Variablentyp Float ausgewählt werden. Im Anschluss kann dann jeweils der Variable das Profil der einer Temperatur in °C bzw. einer Feuchtigkeit in %rF zugewiesen werden. | **8.** Variablen mit Doppelklick öffnen. Passenden **Variablentyp** (z. B. Float) auswählen. In den **Profil- und Aktionseinstellungen** ein passendes **Profil zuweisen**. |
| |
| Ebenfalls ist die Archivierung und damit die Visualisierung auf dem Webfront möglich. | {{ :seb_zusatzfunktionen_daten-manuell-erfassen_006.png?direct&300 }} |
| | |
| | Sofern noch nicht geschehen, im Bereich **"Archiveinstellungen"** das **Logging aktivieren**. Für gemessene Werte (z.B. Leistung) sollte hier „Standard“, und bei Zählwerten, wie z. B. Energie die Option „Zähler“ ausgewählt werden. Durch die Auswahl der Option "Verdichte geloggte Werte" werden die erfassten Variablenwerte nach einem bestimmten Zeitraum durch Verdichtung ausgedünnt, damit weniger Speicher belegt wird. |
| | |
| | Dann mit "OK" bestätigen. Die MQTT-Variablen sind nun in die Smart Energy Box integriert. In einem nächsten Schritt kann die Synchronisierung in die lokale SQL-Datenbank umgesetzt werden. Siehe hierzu Kapitel [[smart_energy_box:datenbank_konfiguration_sync]]. |
| |
| ===== B) Smart Energy Box als MQTT-Client ===== | ===== B) Smart Energy Box als MQTT-Client ===== |
| |
| Falls bereits ein anderer Broker als Server im Netzwerk verwendet wird, kann auf der Smart Energy Box auch ein **„MQTT Client Configurator“** als Konfigurator-Instanz angelegt werden. Als Schnittstelle muss dann die IP-Adresse des jeweiligen Brokers mit dem entsprechenden Port eingetragen werden. (siehe Abbildung 101) Das Anlegen der Variablen erfolgt analog zur Vorgehensweise wie im Server-Fall (siehe Abschnitt A). | Falls bereits ein anderer Broker als MQTT-Server im Netzwerk verwendet wird, kann die Smart Energy Box auch die Rolle des **MQTT-Client** übernehmen. In diesem Fall ist folgendermaßen vorzugehen: |
| |
| <figure> | **1.** Über das **„Plus“** im Objektbaum __oder__ durch **Rechtsklick auf den Ordner "Konfigurator Instanzen" -> Objekt hinzufügen -> Instanz** eine neue Instanz hinzufügen. Bei der Instanzkonfiguration das Gerät **„MQTT Client Configurator“** auswählen. Am Einfachsten gibt man hierzu in den Schnellfilter „MQTT“ ein. **Name** vergeben und mit **"OK"** bestätigen. |
| {{ smart_energy_box:seb_abbildung109.png?500 }} | |
| <caption> | **2.** Die neu erstellte **Instanz** mit Doppelklick **öffnen** -> auf **"Gateway konfigurieren"** klicken -> Benutzername und Passwort setzen, sofern diese vom Server benötigt werden. Die Client-ID wird automatisch erzeugt. Unter "Subskriptionen" können Themen vom MQTT-Server abonniert werden. Im Regelfall öffnet sich auch direkt schon das Schnittstellenfenster in dem man auswählen kann ob man eine neue, oder bereits existierende Instanz benutzen möchte. |
| MQTT Client Configurator | |
| </caption> | |
| </figure> | {{ :seb_zaehler_hinzufuegen_mqtt_001.png?direct&800 }} |
| | |
| | **3.** Auf **"Schnittstelle konfigurieren"** klicken. Bei der Schnittstellenkonfiguration muss die **IP-Adresse des MQTT-Brokers** sowie der entsprechende **Port** eingetragen werden. Schnittstelle auf **"Aktiv"** setzen. |
| | |
| | {{ smart_energy_box:seb_abbildung109.png?800 }} |
| | |
| | **4.** Nachdem diese Einstellungen vorgenommen wurden, auf der Smart Energy Box in der „MQTT Client Configurator“-Instanz auf **„Aktualisieren“** klicken, damit die abonnierten Themen vom Server empfangen werden. |
| | |
| | **5.** Das **Anlegen der Variablen** erfolgt analog zur Vorgehensweise in Abschnitt A ab Schritt 6. |
| |
| <WRAP center round info> | <WRAP center round info> |
| **Info** \\ | **Info** \\ |
| Weiterführende Infos zur Nutzung von MQTT in IP Symcon finden Sie auf folgenden Seiten: | Weiterführende Infos zur Einbindung von MQTT-Geräten in IP Symcon finden Sie auf folgenden Seiten: |
| * [[https://www.symcon.de/de/service/dokumentation/modulreferenz/mqtt/|MQTT]] | * **[[https://www.symcon.de/de/service/dokumentation/modulreferenz/mqtt/|MQTT]]** |
| * [[https://www.symcon.de/de/service/dokumentation/modulreferenz/mqtt/mqtt-server/|MQTT-Server]] | * **[[https://www.symcon.de/de/service/dokumentation/modulreferenz/mqtt/mqtt-server/|MQTT-Server]]** |
| * [[https://www.symcon.de/de/service/dokumentation/modulreferenz/mqtt/mqtt-client/|MQTT-Client]] | * **[[https://www.symcon.de/de/service/dokumentation/modulreferenz/mqtt/mqtt-client/|MQTT-Client]]** |
| </WRAP> | </WRAP> |
| |
| |
| \\ | \\ |