Help-Desk

Sensoren und Produktreihen

Helios-P Drucksensor

Helios-P Drucksensor NFC und Downlink Beschreibung

Sie suchen nach der Helios-P NFC und Downlink Beschreibung zur Konfiguration des Sensors?

Wie funktioniert die Konfiguration der Sentinum Sensoren via Downlink und NFC (Provisionierung)?

Generische NFC und Downlinkbeschreibung mit Zugang zu den Tabellen

💡 Diese Dokumentation ist für alle Sensoren der Sentinum Serie, die über die Funktionen NFC und Downlink verfügen, anwendbar. Sie dient als generische Dokumentation. Die einzelnen Beschreibungen zu den Feldern finden Sie in den jeweiligen Links.

Downlinks

Grundlagen zu Downlinks mit Sentinum Sensoren

📢 Alle Downlinks des Sentiface und Senticom Moduls werden auf Port 4, alle Befehle des Supervisormoduls, wie z.B. Resets werden auf Port 5 eingeplant.

Wie auch die Payload, sind die Downlink Kommandos in Module gegliedert. Der Sensor fungiert lediglich als Container, der die Befehle verwaltet und umsetzt. Mit Hilfe der Downlinks kann der Sensor auf die spezifische Anwendung konfiguriert werden. Neben den Konfigurationen können auch ausführende Downlinks, wie z.B. ein Reset vorgenommen werden. Alle Befehle sind durch minimale und maximale Werte abgesichert, damit keine falschen Einstellungen vorgenommen werden können. Der Aufbau ist hierarchisch gegliedert und besteht aus folgenden Elementen:

• Modul

• Gruppe

• Property

• Befehl

Ein Modul besitzt mehrere Gruppen, die wiederum aus mehreren Properties aufgebaut sind. Die folgende Tabelle zeigt, wie die Struktur generell aufgebaut ist:

Module und Gruppen des Sensors

📢 Alle Downlinks des Sentiface und Senticom Moduls werden auf Port 4, alle Befehle des Supervisormoduls, wie z.B. Resets werden auf Port 5 gescheduled.

💡 Innerhalb verschiedener Subversionen garantiert Sentinum eine Rückwärtskompatibilität. D.h. ein Sentifacemodul mit dem Schlüssel 0x1121 akzeptiert auch Downlinkkommandos mit dem Schlüssel 0x1111.

Aufbau des Modulschlüssels

💡 Der Modulschlüssel des SENTIFACE Moduls, kann aus den ersten 2 Bytes jedes Uplink entnommen werden.

Beispiel Uplink: 11 11 06 1B E1 92 02 00 00 06 86

💡 1111 bildet den Modulschlüssel.

Der hier erklärte Modulschlüssel bezieht sich nur auf das SENTIFACE Modul. Für SENTICOM als Modulschlüssel soll immer 0x2111 eingesetzt werden.

Struktur eines Downlink Befehls

📢 Eine Ausnahme stellt der Reset-Befehl dar. Dieser ist auf Seite 9 dargestellt.

📢 Im ersten Datenpaket (Uplink) ist meistens eine Alarmvariable gesetzt, da der Wert mit einem internen Referenzwert abgeglichen wird.

Reset Befehl via Downlink

Der Reset Befehl muss in 2 Schritten bzw. in 2 Downlinks auf Port 5 ausgeführt werden: Zuerst muss der Reset mit dem Befehl [TOKEN] 31 11 01 01 scharf gestellt werden und kann danach mit [TOKEN] 31 11 00 ausgelöst werden.

Command HEX	Beschreibung
[TOKEN] 31 11 01 01	Reset Scharf stellen
[TOKEN] 31 11 00	Reset des Sensors

NFC

Grundlagen

Der Sensor lässt sich neben Downlinks auch mit einer Smartphone App über NFC konfigurieren. Die unterschiedlichen Konfigurationen des Sensors werden als .JSON übergeben. Die App bietet eine initiale Konfigurationsmöglichkeit schon bei der Aktivierung des Sensors. Neben den Einstellungen des Sensors ermöglicht die App auch die Konfiguration von Netzwerk Parametern, wie APPEUI und APPKEY. Analog zum Downlink ist der Aufbau hierarchisch gegliedert.

Für die NFC Konfiguration sind sowohl die Module (Modulnamen), als auch Alias Namen für die einzelnen Properties wichtig. Die folgende Tabelle beschreibt die verfügbaren Module.

Aufbau eines .json Objekts

Jedes Sensor Profil wird als JSON Objekt übergeben. Jedes Objekt beginnt mit { und endet mit }. In einem Objekt, können weitere Objekte integriert werden. Generell enthalten Objekte eine geordnete Liste von Eigenschaften, die durch Kommata getrennt sind. Eine Eigenschaft ist ein Schlüssel-Werte-Paar, das aus einem eindeutigen Schlüssel (Zeichenkette) und einem Wert (beliebiges Element) besteht. Der Schlüssel und der Wert sind durch einen Doppelpunkt (:) getrennt. Sehen wir uns folgendes Beispiel an, das formatiert wurde:

Untitled (100)

Wie im vorherigen JSON-Beispiel folgt das Objekt einer bestimmten Struktur. Das erste Schlüssel-Werte-Paar. Ist der Sensor deaktiviert (power = off), so können sie den Sensor mit seinen Grundeinstellungen aktivieren, indem Sie ein beispielsweise leeres JSON laden und den Sensor mit der App aktivieren. Auch das setzen von Einstellungen ist bei der Aktivierung möglich.

💡 “power”:”OFF” oder “power”:”ON” ist ein Zustand des Sensors. Der Sensor antwortet mit off oder on auf einen Befehl. “off” oder “on” stellt also keinen Befehl dar.

Um den Sensor neu zu starten (vgl. Neustart bei einem PC) muss der “REBOOT” Befehl in das “power” Feld geschreiben werden:

{"power":"REBOOT"}

Nach einigen Sekunden schreibt der Sensor in das “power”-Feld den Wert “ON” und zeigt damit den Abschluss des Boot Vorgangs an.

Funktionsweise des Sensors überprüfen

Mit Hilfe des “REBOOT” Befehls kann die Funktionsfähigkeit des Sensors überprüft werden. Überschreibt der Sensor. Überschreibt der Sensor das Feld nach spätestens 15 Sekunden nicht und bleibt im {"power":"REBOOT"} Zustand, so ist ein Fehler aufgetreten. Das deutet meistens auf leere Batterien oder einen Hardwaredefekt hin.

Aktivierung, Deaktivierung und App

Die Aktivierung erfolgt über eine NFC App. Dazu wird ein Smartphone benötigt. Die App kann in den jeweiligen App Stores heruntergeladen werden. Suchen Sie dazu einfach nach “Sentinum LinQs” und laden Sie die App herunter.

Untitled (22)

💡 Lokalisiere jetzt den NFC Tag am Sensor. Je nach Smartphone Typ kann der Reader am Smartphone oben, in der Mitte oder weiter unten sein.

Untitled (14)

💡 Die Lage des NFC Tags auf dem Sensor findet Ihr in der jeweiligen Bedienungsanleitung oder im Quickstart Guide.

📢 Werden Schlüssel wie z.B. app_eui und app_key geändert und danach ein REBOOT ausgeführt, so werden die ursprünglichen Schlüssel gesetzt.

📢 Der power Schlüssel ist keiner Modulgruppe zugeordnet.

Eine Anleitung zur NFC App findet Ihr hier:

TBD

Weitere Informationen zur NFC APP

💡 Es existieren read only (r), write only (w) und read&wirte (rw) Schlüssel und Werte. So können beispielsweise Schlüssel geschützt werden.

💡 Wird ein Profil falsch angelegt und übermittelt, so bleiben die vorherigen Einstellungen bestehen. Dies kann z.B. passieren, falls das JSON als falsches Format angelegt wurde.

💡 Beim Zusammenstellen des Profils kann auf mehrere Modulgruppen auf einmal oder nur auf einzelne Modulgruppen zugegriffen werden. Analog verhält es sich mit den Properties.

💡 In der neusten Version der App lassen sich Profile anlegen und speichern. Weiterhin wird es eine Funktion zum Auslesen der Sensoren geben. Zudem lassen sich Daten wie z.B. der Standort an einen definierten Endpunkt senden.

Speicherung der Werte via Downlink und NFC

💡 Werte die in das NFC geschrieben werden, sind auch bei Reset oder Batteriewechsel gespeichert und werden vom Sensor abgerufen.

💡 Werte die per Downlink gesetzt werden können mit einem zusätzlichen Downlink Befehl in den NFC Tag übertragen werden.

Sensorspezifische NFC und Downlinkkonfigurationen

CSQ und Empfang

Value	RSSI dBm	Condition
2	-109	Marginal
3	-107	Marginal
4	-105	Marginal
5	-103	Marginal
6	-101	Marginal
7	-99	Marginal
8	-97	Marginal
9	-95	Marginal
10	-93	OK
11	-91	OK
12	-89	OK
13	-87	OK
14	-85	OK
15	-83	Good
16	-81	Good
17	-79	Good
18	-77	Good
19	-75	Good
20	-73	Excellent
21	-71	Excellent
22	-69	Excellent
23	-67	Excellent
24	-65	Excellent
25	-63	Excellent
26	-61	Excellent
27	-59	Excellent
28	-57	Excellent
29	-55	Excellent
30	-53	Excellent