Zum Inhalt

Websocket

WebSocket-Protokoll ist ein Netzwerkprotokoll, mit dem eine bidirektionale Verbindung zwischen einer Webanwendung und einem WebSocket-Server bzw. einem Webserver hergestellt werden kann.

Während bei HTTP für jede Nachricht eine Anfrage durch den Client (hier das Endgerät) erforderlich ist, muss bei einem Websocket nur das initiale Öffnen des Kanals von einer Client-Anfrage ausgelöst werden. Sobald der Übertragungskanal geöffnet ist, können Nachrichten ausgetauscht werden, ohne dass der Server jedes Mal warten muss, bis eine Anfrage des Clients kommt.

Hier sehen Sie, welche Websocket-Übertragungskanäle vorhanden sind, auf welchem Ihrer (Sub-)Accounts diese laufen und die Daten welcher Sensoren über diese übertragen werden.

Übersicht der Übertragungskanäle

Übertragungskanal hinzufügen

Das Hinzufügen eines neuen Übertragungskanals per Websocket ist möglich, indem Sie auf den Button Websocket Integration hinzufügen klicken. Füllen Sie dann das sich öffnende Formular vollständig aus und klicken anschließend auf Speichern.

Hinweis zu Benutzername und Passwort eines neuen Websocket

Benutzername und Passwort müssen als Basic Auth in den Header des Verbindungsaufbaus gesetzt werden.

Geben Sie anschließend noch einen Benutzernamen und ein Passwort an. Diese werden benötigt um später eine Verbindung mit diesem Websocket aufzubauen.

Sensor hinzufügen

Über das Funk-Icon auf der Websocket-Startseite (siehe oben) können dem Übertragungskanal Sensoren hinzugefügt oder entfernt werden.

Übersicht der Sensoren

Übertragungskanal bearbeiten

Über das Edit-Icon auf der Websocket-Startseite (siehe oben) können der Name, Benutzername und das Passwort des Übertragungskanals geändert werden.

Für die Bearbeitung eines Kanals sind der Benutzernamen und das Passwort erforderlich, welches bei der Erstellung des Kanals angegeben wurden.

Erst wenn diese korrekt eingetragen sind, lassen sich Ihre Änderungen speichern.

Übertragungskanal bearbeiten

Dateiformat

Von ATLAS werden Daten im JSON-Format mit folgender Struktur versandt (Demodaten eines Elsys ERS):

{

    "externalDeviceId":"aa1100ff00000000",
    "dataframe":"0100f1022e04043b0500060196070c1e",
    "timestamp":"2019-07-18 10:14:13.372",
    "type":"lora",
    "externalGwId":["00800000a0001f1a"],
    "decoded":{
        "temperature":241,
        "humidity":46,
        "light":1083,
        "motion":0,
        "co2":406,
        "vdd":3102
    }
}
  • externalDeviceId : Entspricht der DevEUI des LoRa-Sensors.
  • dataframe : Die Rohdaten in hexadezimaler Schreibweise.
  • externalGwId : Ein Array mit den IDs der Gateways, welche die Nachricht empfangen haben.
  • type : Zeigt an, dass es sich um Daten von LoRa handelt.
  • timestamp : Gibt an, wann die Nachricht vom Gateway empfangen wurde. Die Zeit ist immer in UTC angegeben (siehe FAQ für mehr Infos zu UTC).
  • decoded : Optional. Nur vorhanden, wenn für den Sensor auch ein Decoder hinterlegt ist. Die Felder darin kommen direkt aus dem Output des Decoders.