Sensortypen

Auf dieser Seite sehen Sie alle registrierten Sensortypen einschließlich deren JavaScript-Decoder. Sie können neue Sensortypen anlegen oder Ihre bestehenden Sensortypen bearbeiten bzw. löschen. Zudem können Sie die Liste der Sensoren nach verschiedenen Kriterien filtern. Solange die Filter nicht zurückgesetzt werden, bleiben diese erhalten.

Auflistung aller registrierten Sensortypen

Die Buttons haben folgende Funktionen (von links nach rechts):

• JavaScript-Code des Decoders anzeigen.
• Sensortyp-Beschreibung bearbeiten.
• Sensortyp löschen.

Über das Java-Script-Decoder Feld können Sie auch die Metriken ansehen und bearbeiten. Bei Sensortypen, die von Oberaccounts erstellt wurden, können Sie nur Metriken anschauen, jedoch nicht bearbeiten.

Neuer Sensortyp

Bei Betätigung des Buttons Sensortyp hinzufügen öffnet sich folgendes Formular. Sie können LoRa- und virtuelle Sensoren hinzufügen. Virtuelle Sensortypen können verschiedene Metrik-Typen von unterschiedlichen Sensoren enthalten.

Sensortyp erstellen

LoRa-Sensor

Schritt 1: Erstellen

• Account: Der zugewiesene Account.
• Typ: Hier wurde LoRa ausgewählt.
• Name: Der Name des Sensortypen.
• Beschreibung: Die Beschreibung des Sensortypen.
• Hersteller: Der Hersteller des Sensortypen.
• Model: Das Sensormodell.
• Herstellerlink: Link zur Herstellerwebseite.
• JSON-Payload Wrapper-Feld (nur mit Typ MQTT): Der Wrapper mit dem der Payload verarbeitet wird. Bei einem leeren Feld wird der Wrapper verwendet, der beim Quellsystem hinterlegt wurde.

Schritt 2: Anhänge

• Produktbild: Ein Bild des Sensortyps.
• Datenblatt: Das Datenblatt des Sensorstyps.

Schritt 3: Decoder

Hier können Sie den JavaScript-Decoder, mit dem die Sensornachrichten decodiert werden, eingeben.

Schritt 4: Metriken

Hier werden die passenden Metrik-Typen (Einheit und Datenformat) den im Decoder erzeugten Objekten zugewiesen.

Virtueller Sensor

Schritt 1: Erstellen

• Account: Der zugewiesene Account.
• Typ: Hier wurde Virtual ausgewählt.
• Name: Der Name des Sensortypen.
• Beschreibung: Die Beschreibung des Sensortypen.

Schritt 2: Anhänge

• Produktbild: Ein Bild des Sensorstyps.
• Datenblatt: Das Datenblatt des Sensorstyps.

Schritt 3: Metriken Hier werden die Metrik-Typen (Einheit und Datenformat) dem Sensortypen zugewiesen.

Decoder

Hier können Sie sich den Quellcode des Decoders anschauen oder diesen bearbeiten. Zwingend notwendig ist die Funktion decode, welche die Parameter data (Payload in HEX) und fport (Frame-Port als INT) übergeben bekommt.

Beispiel: Eingetragener JavaScript-Decoder

An den Decoder übergebene Werte

• Nachricht: Die Nachricht des Sensors als hexadezimalen String ohne Präfix oder Trennzeichen.
• Frameport: Der Frameport, an welchen der Sensor die Nachricht übergeben hat, als Integer.
• Gesamte Nachricht: Die gesamte Sensornachricht vom LNS (mit RSSI, SNR, etc) als JSON-Objekt (Beispiel).
• Sensorinformationen: Einige Informationen des Sensors aus ATLAS als JSON-Objekt. Dazu gehören Interne ID, DevEUI, Name, Beschreibung und eigene Felder (Beispiel).

Beispiel: Gesamte Nachricht

{
  "messageId": "d38e785d-3432-4d78-b381-4d06d23eb2ef",
  "externalDeviceId": "7682956728954645",
  "messageType": "UPLINK",
  "rawMessage": "{'applicationID':1','applicationName':'ATLAS_Test_Application_00000000','deviceName':'Test','devEUI':'7682956728954645','rxInfo':[{'gatewayID':'1212121212121212','name':'00000000','rssi':-98,'loRaSNR':10,'location':{'latitude':'0.0','longitude':'0.0','altitude':'100'}}],'txInfo':{'frequency':868500000,'dr':2},'adr':true,'fCnt':176924,'fPort':5,'data':'AQErAiYEASQFAQYCNQcOJw=='}",
  "createdAt": "2021-05-10T09:34:12.666Z",
  "rssi": -98,
  "loraSnr": 10,
  "dataRate": 2,
  "frameCounter": 176924,
  "externalGatewayIds":["1212121212121212"]
}

Beispiel: Sensorinformationen

{
  "id": 1,
  "externalDeviceId": "7682956728954645",
  "name": "Test",
  "description": "Test Sensor",
  "customFields":{
    "Key2": "Value2",
    "Key1": "Value1",
  }
}

Decoder testen

Sie haben die Möglichkeit, den jeweiligen Decoder zu testen, indem Sie einen Hex- oder Base64-String eingeben. Sie können auch einen Sensor des gleichen Sensortyps auswählen, dessen Sensorinformationen ebenfalls übergeben werden.

Testwert (als Hex) angegeben, dekodierter Wert zurückgegeben