Integration: IoT Sensoren

Über die IoT-Schnittstelle empfängt eTASK Sensordaten von einem MQTT-Broker in Echtzeit. Die Daten werden über die MQTTnet-Bibliothek empfangen und über SignalR an die Browser-Clients im Portal weitergeleitet.

Voraussetzungen

• Administratorrechte im eTASK-Portal
• MQTT-Broker installiert und erreichbar (z. B. Mosquitto oder ein vergleichbarer MQTT-Broker)
• IoT-Sensoren, die Daten an den MQTT-Broker publishen
• Zugangsdaten zum MQTT-Broker (Benutzername, Passwort)

Schritt 1: Sensortypen anlegen

Pfad zum Ausgangspunkt: Systemsteuerung → Technisches Gebäudemanagement → Gebäudesteuerung → Sensortypen

Legen Sie zunächst die benötigten Sensortypen an. Jeder Sensortyp beschreibt die Funktion eines Datenpunkts für den Anwender, wie z. B. Dimmer, Jalousie (hoch/runter) oder Türöffnungssensor.

Feld	Beschreibung
Code (Pflichtfeld)	Eingabe eines frei wählbaren Codes für den Datenpunkt (z. B. „DI" Dimmer, „FS" Fenstersensor).
Bezeichnung (Pflichtfeld)	Eingabe der vollständigen Bezeichnung des Datenpunkts (z. B. „Dimmer").

Schritt 2: Gateways anlegen

Pfad zum Ausgangspunkt: Systemsteuerung → Technisches Gebäudemanagement → Gebäudesteuerung → Gateways

Gateways dienen zur Verbindung des GLT-/IoT-Netzwerks mit dem Office-Netzwerk / LAN zur Verbindung des FM-Portals mit den Datenpunkten.

Feld	Beschreibung
Code	Eingabe eines frei wählbaren Kürzels für das Gateway.
Bezeichnung (Pflichtfeld)	Eingabe der vollständigen Bezeichnung für das Gateway.
IP Adresse (Pflichtfeld)	Eingabe der vollständigen IP-Adresse.
Netz	Auswahl des Netzes für das Gateway.
Benutzerdaten	Wählen Sie hier die Anmeldedaten aus, mit denen Sie sich am Gateway registrieren können.

Schritt 3: Zustände und Aktionen definieren

Pfad zum Ausgangspunkt: Systemsteuerung → Technisches Gebäudemanagement → Gebäudesteuerung → Zustände / Aktionen

Zustände

Definieren Sie die möglichen Zustände, die ein Datenpunkt annehmen kann (z. B. An, Aus, Offen, Geschlossen).

Feld	Beschreibung
Code (Pflichtfeld)	Eingabe eines frei wählbaren Codes für Zustände (z. B. „AUS" Ausgeschaltet).
Bezeichnung (Pflichtfeld)	Eingabe der vollständigen Bezeichnung des Zustands (z. B. „Ausgeschaltet").
Aktion zum Erreichen des Zustands	Auswahl der „Aktion zum Erreichen des Zustands" (z. B. AUS, Ausschalten).

Aktionen

Aktionen definieren, was beim Eintreten eines bestimmten Sensorzustands passieren soll. Jede Aktion versetzt den Zustand eines Datenpunkts von einem Zustand in einen anderen.

Feld	Beschreibung
Code	Eingabe eines frei wählbaren Codes für Aktionen (z. B. „AUS" Ausschalten).
Bezeichnung	Eingabe der vollständigen Bezeichnung der Aktion (z. B. „Ausschalten").

Schritt 4: Sensoren & Aktoren anlegen

Pfad zum Ausgangspunkt: Systemsteuerung → Technisches Gebäudemanagement → Gebäudesteuerung → Sensoren & Aktoren

Legen Sie für jeden physischen Sensor einen Datenpunkt im System an. Die Eingabemaske ist in drei Bereiche gegliedert:

Identifikation

In diesem Infobereich finden Sie Informationen, mit denen der Datensatz identifiziert werden kann. Meist sind dies der Code und die Bezeichnung, zusammen mit weiteren wichtigen Informationen.

Feld	Beschreibung
Bezeichnung (Pflichtfeld)	Eingabe der vollständigen Bezeichnung des Datenpunktes.
Datenpunkt-Typ (Pflichtfeld)	Auswahl des Datenpunktes (aus den zuvor angelegten Sensortypen).

Quelle

Feld	Beschreibung
Gateway	Auswahl des Netzwerkprotokolls des Gateways.
Technische Adresse (Pflichtfeld)	Über die Technische Adresse wird der Datenpunkt angesteuert (z. B. das MQTT-Topic).

Zuordnung

Feld	Beschreibung
Objekt	Auswahl des Objekts.

Technischer Ablauf

Der Datenfluss der IoT-Integration verläuft wie folgt:

1. IoT-Sensor sendet Messwerte an den MQTT-Broker.
2. eTASK-Server empfängt die Daten über die MQTTnet-Bibliothek.
3. SignalR Hub leitet die Daten in Echtzeit an die Browser-Clients weiter.
4. Portal-Oberfläche zeigt die aktuellen Sensorwerte an.

Systemparameter

Für die IoT-Sensoren-Integration werden keine separaten Systemparameter unter „Konfigurationsparameter" konfiguriert. Die MQTT-Verbindungsparameter (Broker-Adresse, Port, Benutzername, Passwort) werden direkt über die Gateway-Konfiguration verwaltet:

Pfad: Systemsteuerung → Technisches Gebäudemanagement → Gebäudesteuerung → Gateways

Die Topic-Zuordnung erfolgt über die Technische Adresse im jeweiligen Sensor-/Aktor-Datensatz.

Zusammenfassung

Konfigurationsschritt	Pfad
Sensortypen	Systemsteuerung → Technisches Gebäudemanagement → Gebäudesteuerung → Sensortypen
Gateways	Systemsteuerung → Technisches Gebäudemanagement → Gebäudesteuerung → Gateways
Zustände	Systemsteuerung → Technisches Gebäudemanagement → Gebäudesteuerung → Zustände
Aktionen	Systemsteuerung → Technisches Gebäudemanagement → Gebäudesteuerung → Aktionen
Sensoren & Aktoren	Systemsteuerung → Technisches Gebäudemanagement → Gebäudesteuerung → Sensoren & Aktoren