Zum Hauptinhalt springen

UDP Connector

Connector-Details – UDP​

Der UDP Connector ermöglicht es der Plattform, Geräte-Updates über das UDP-Protokoll zu empfangen. Dies wird typischerweise von Geräten genutzt, die über NB-IoT, Cat-M oder ähnliche Funktechnologien kommunizieren, wobei auch direkte kabelgebundene UDP-Verbindungen unterstützt werden.

Eingehende Daten müssen ein HEX-kodierter String sein, der eine eingebettete Kennung zur Bestimmung des Quellgeräts enthält.

Erforderliche Informationen​

Um eine UDP-Verbindung zu konfigurieren, muss Folgendes angegeben werden:

  • Integration name Legt fest, wie die Plattform eingehende UDP-Daten verarbeitet und validiert. Er identifiziert den Gerätetyp, der die Daten sendet, und stellt eine korrekte Zuordnung in der Plattform sicher.

  • Port number Der UDP-Port, auf dem die Plattform auf eingehende Daten wartet.

Wichtig: Alle UDP-Ports sind standardmäßig geschlossen. Ein Support-Ticket muss eingereicht werden, um den gewünschten Port zu öffnen. Es stehen 65.536 UDP-Ports zur Verfügung (0–65535).

Sicherheitsaspekte​

UDP-Daten werden unverschlüsselt übertragen und können abgefangen werden, sobald sie über öffentliche Netzwerke laufen. Auch wenn die Payload HEX-kodiert ist, ist sie standardmäßig nicht sicher.

Verwenden Sie keine reine UDP-Kommunikation für sensible Daten über öffentliche Netzwerke.

Um die Daten zu sichern, unterstützt die Plattform DTLS (Datagram Transport Layer Security). DTLS kann aktiviert werden, wenn die angeschlossenen IoT-Geräte dies ebenfalls unterstützen.

Konfiguration des physischen UDP-Geräts​

Bei der Einrichtung des physischen UDP-Geräts konfigurieren Sie am Gerät Folgendes:

  • Die URL oder statische IP-Adresse der Plattform
  • Die für den Connector geöffnete UDP-Portnummer

Sie können die IP-Adresse der Plattform über einen Domain-Lookup-Dienst überprüfen. Die IP ist statisch und ändert sich nicht. Stellen Sie sicher, dass der am Gerät konfigurierte Port genau mit dem Port des Connectors übereinstimmt.

Bei Verwendung von NB-IoT oder Cat-M achten Sie darauf, die IMSI-Nummer der SIM-Karte zu notieren, damit sie später dem richtigen Gerät in der Plattform zugeordnet werden kann.

Erstellen von UDP-Geräten​

So registrieren Sie ein UDP-verbundenes Gerät:

  1. Erstellen Sie einen Standard-generic node in der Plattform.
  2. Verwenden Sie die entsprechende Integrationskennung, wie unten definiert.
Integration NameKennung
IMBuildingssensorId

Bei Verwendung von NB-IoT oder Cat-M achten Sie darauf, die IMSI-Nummer der SIM-Karte zu den kontextuellen Parametern des Geräts in der Plattform hinzuzufügen.

Wenn keine Daten empfangen werden, ist es wichtig zu wissen, welche SIM-Karte das Gerät verwendet. Damit können Sie im Portal des SIM-Anbieters überprüfen, dass:

  • Die SIM aktiv ist
  • Der Datenverkehr korrekt über den erwarteten APN – Access Point Name geleitet wird

Datenformat & Übersetzung​

Die empfangenen Daten müssen ein HEX-String sein. Ein Übersetzer muss ausgewählt oder erstellt werden, um die Daten zu dekodieren, und der UDP-Gerätekonfiguration zugewiesen werden.