IoT Export
Verbindungs Template
Simple EnOcean MQTT Client
18 min
einleitung das export modul "simple enocean mqtt client" stellt die verbindung zu einem mqtt broker her und veröffentlicht nachrichten unter verschiedenen topics es können mehrere export instanzen angelegt werden, jedoch immer nur eine instanz pro broker url nachrichten werden grundsätzlich als string übertragen und sind im regelfall als json objekte formatiert konfiguration im bereich iot export der web konfiguration oder der bsc remote können die export verbindung angelegt, sowie die parameter konfiguriert werden es werden tcp/ssl sowie web socket (http/https) verbindungen unterstützt die authentifizierung ist per nutzername und passwort oder client zertifikat möglich die entsprechenden zertifikate oder zugangsdaten können während der konfiguration hinterlegt werden es besteht die möglichkeit die basis topics zum veröffentlichen von nachrichten anzupassen parameter true falsefalse unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type true falsefalse unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type datenmodell basis daten von nachrichten alle nachrichten werden als json objekte übertragen grundlegende informationen für die zuordnung von nachrichten sind in allen objekten vorhanden basis felder true falsefalse unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type sensoren / aktoren neben den basis feldern sind die folgende felder im geräte objekt verfügbar true falsefalse unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type beispiel daten fsb 14 { 	"nodeid" "acdbda5906ee", 	"timestamp" 1689865668, 	"name" "fsb 14", 	"eurid" "2a3df3d", 	"refid" "enocean eltako fsb14", 	"channels" { 	 "jalousieslat" "unknown", 	 "jalousie" 65 0, 	 "priority" "off", 	 "jalousiestate" "unknown" 	} } fsr 14 { 	"nodeid" "acdbda5906ee", 	"timestamp" 1689865842, 	"name" "fsr14", 	"eurid" "c23df34", 	"refid" "enocean eltako fsr14", 	"channels" { 	 "switch" "on", 	 "priority" "off" 	} } gateway status neben den basis feldern sind die folgende felder im gateway status objekt verfügbar true falsefalse unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type beispiel daten gateway status objekt { 	"nodeid" "acdbda5906ee", 	"timestamp" 1689864643, 	"version" "3 5 1", 	"online" true } mqtt topics die genutzte topic struktur unterteilt sich in daten und kommando topics daten topics über die daten topics versendet das gateway seine und die status meldungen der verbundenen geräte sensoren / aktoren als basis dient das in der konfiguration unter "enocean topic prefix" hinterlegte topic dieser pfad wird um die eurid des gerätes erweitert und dort die geräte nachricht veröffentlicht beispiel topic enocean/513659d gateway als basis dient das in der konfiguration unter "gateway topic prefix" hinterlegte topic dieser pfad wird um die hardware id des gerätes erweitert und dort die status nachricht veröffentlicht beispiel topic gateway/acdbda4512e0 kommando topics über die kommando topics ist eine einfach möglichkeit der steuerung des gateways umgesetzt aktoren als basis dient das in der konfiguration unter "enocean topic prefix" hinterlegte topic und ermöglicht es aktoren zu schalten dieser pfad wird um die eurid des gerätes sowie die kanal id erweitert als nutzdaten wird der neue wert als string erwartet beispiel topic enocean/513659d/switch beispiel nutzdaten on off gateway als basis dient das in der konfiguration unter "gateway topic prefix" hinterlegte topic dieser pfad wird um die hardware id des gerätes sowie das auszuführende kommando erweitert als nutzdaten wird ein json objekt mit den entsprechenden parametern erwartet verfübare kommandos true falsefalse unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type beispiel topic gateway/acdbda4512e0/pairing gateway/acdbda4512e0/delete beispiel nutzdaten on=90 off 513659d