Apollon-Q T/R/TR Payload Beschreibung

📄 Sie können das PDF oben ansehen oder hier herunterladen .

Inhaltsverzeichnis

Payload Beschreibung
Beispiel für eine WiFi-SSID-Scan-Payload
Apollon Q T/R/TR/SW Payload Beschreibung
Apollon Q T Version Payload Beschreibung (ohne Radar)
Apollon Q R Version Payload Beschreibung (ohne ToF)
Apollon Q TR / SW Version Payload Beschreibung (mit Radar und ToF)
Apollon Q angehängte Bytes (ACC / HALL)
Apollon Q Bytes (Histogramm-Debugdaten)
Beispiele Dekodierung

1. Payload Beschreibung

In diesem Kapitel wird die Struktur der Telemetriedaten beschrieben. Die Anzahl der Bytes innerhalb der Payload hängt von der jeweiligen Sensorkonfiguration ab. Der Aufbau der Daten richtet sich danach, welche Sensoren und Funktionen im Produkt vorhanden sind.

Jede Payload beginnt mit einem Header. Dieser enthält Informationen zur Hardware- und Softwareversion, den aktuellen Gerätestatus sowie einen Master-Messwert. Der Master-Messwert kann in der Regel als aktueller Hauptmesswert des Sensors interpretiert werden.

Nach dem Header folgen abhängig von der Sensorkonfiguration weitere Payload-Bereiche. Diese enthalten zusätzliche Informationen zu den Messprinzipien, Positionsdaten oder Funktionen zur Öffnungs- und Ereigniserkennung. Nicht jede Produktvariante enthält sämtliche zusätzlichen Payload-Bereiche.

Payload-Feldbeschreibung

Begriff	Beschreibung
Byte No.	Byte-Nummer beginnend bei 1
Alias	Verständlicher Name der Variablen
Beschreibung	Beschreibung der Variablen
Bezeichnung	Bezeichnung im Dataconverter bzw. Payload-Decoder
Einheit	Einheit der Variablen
Datahub .json Schlüssel	Schlüssel im JSON-Objekt bei Nutzung des Datahubs

Struktur des Modulschlüssels

Byte 1		Byte 2
Bit 7–4	Bit 3–0	Bit 7–4	Bit 3–0
Basis-ID des Moduls (z. B. Sentiface, Senticom, Sentivisor)	Major Version (SW-/HW-Version)	Minor Version (SW-/HW-Version)	Produktversion (z. B. TH, THL, ACC, Radar)

Der Modulschlüssel des Apollon-Q Moduls kann aus den ersten beiden Bytes jedes Uplinks entnommen werden. Der Modulschlüssel wird unter anderem zur Interpretation der Payload sowie für Downlink-Kommandos benötigt.

Der Modulschlüssel des SENTIFACE-Moduls kann aus den ersten beiden Bytes jedes Uplinks entnommen werden. Der Modulschlüssel wird für die korrekte Interpretation der Payload sowie für Downlink-Kommandos benötigt.

Portbelegung für WiFi-SSID-Scan, GNSS-Scan und Standard-Payload

Feature	LoRaWAN Port	Beschreibung
GNSS Scan Payload	192	Rohdaten wie Satelliten-ID, Zeitinformationen und weitere GNSS-Messwerte werden an das Geolocation-Backend übertragen.
WiFi SSID Scan Payload	197	Erkannte MAC-Adressen und RSSI-Werte werden zur Positionsbestimmung übertragen.
Reguläre Telemetrie-Daten	1	Standard-Payload mit Sensordaten wie Distanzwerten, Temperatur, Batteriestatus, Öffnungserkennung oder Positionsinformationen.

2. Beispiel für eine WiFi-SSID-Scan-Payload

Abbildung 1. Beispiel einer WiFi-SSID-Scan-Payload.

3. Apollon Q T/R/TR/SW Payload Beschreibung

Byte Nummer	Alias Name	Einheit	Bezeichnung im Decoder	Modulschlüssel	Datahub .json Schlüssel
1 – 2	Modulschlüssel	–	`module_key`	`XXX1`	`module_key`
Beschreibung: Byte 1: • Modulcode (Bits 7–4) • Major Version (Bits 3–0) Byte 2: • Minor Version (Bits 7–4) • Produktversion (Bits 3–0)
3	Uplink Zähler	–	`uplink_counter`	`XXX1`	`uplink_counter`
Beschreibung: Protokollunabhängiger Uplink-Counter (0–255).
4 – 5	Batteriespannung	mV	`battery_voltage`	`XXX1`	`battery_voltage`
Beschreibung: Aktuelle Batteriespannung in Millivolt.
6	Interne Temperatur	°C	`internal_temperature`	`XXX1`	`internal_temperature`
Beschreibung: Interne Sensortemperatur.
7	Alarm	–	`alarm`	`XXX1`	`alarm`
Beschreibung: Zeigt an, ob ein Alarm ausgelöst wurde.
8 – 9	Mastermesswert	mm	`master_value`	`XXX1`	`master_value`
Beschreibung: Hauptmesswert des Sensors.

Hinweis:
Für die weiteren Bytes beachten Sie bitte die jeweilige Hardware-Version des Sensors (T, R, TR oder SW), da sich die Payload-Struktur unterscheiden kann.

4. Apollon Q T Version Payload Beschreibung (ohne Radar)

Byte Nummer	Alias Name	Einheit	Bezeichnung im Payload Decoder	Modulschlüssel	Datahub .json Schlüssel
10	Status ToF Sensor	–	`tof_status`	`XXX1`	`tof_status`
Beschreibung: Status des Sensors bezogen auf den letzten Messwert. • 0: Valid range • 2 / 4: Out of bounds • 5: Hardware fail • 7: Wrapped target • 8: Algorithm fail • 14: Invalid range • 99: More than one valid target detected
11–12	Distanz	mm	`tof_distance`	`XXX1`	`tof_distance`
Beschreibung: Aktuell gemessene Distanz des ToF-Sensors in mm. (vgl. Master Value, wenn die Messwertquelle identisch ist.)
13	Modus ToF (Index)	–	`tof_index`	`XXX1`	`tof_index`
Beschreibung: Modus, in dem der Sensor den letzten Wert aufgenommen hat. • 0: Short (bis 1,3 m) • 1: Medium (bis 3 m) • 2: Long (bis 4 m)

5. Apollon Q R Version Payload Beschreibung (ohne ToF)

Byte Nummer	Alias Name	Einheit	Bezeichnung im Payload Decoder	Modulschlüssel	Datahub .json Schlüssel
10	Status Radar	–	`radar_status`	`XXX1`	`radar_status`
Beschreibung: • 0: Error • 1: Erfolg
11	Anzahl der Peaks	–	`radar_no_peaks`	`XXX1`	`radar_no_peaks`
Beschreibung: Anzahl der erfassten Peaks.
12–13	Distanz 1	mm	`radar_distance_1`	`XXX1`	`radar_distance_1`
Beschreibung: Distanz mit maximalem Peak in mm.
14–15	Peak 1	dBsm	`radar_ra_1`	`XXX1`	`radar_ra_1`
Beschreibung: Distanz mit maximalem Peak in dBsm.
16–17	Distanz 2	mm	`radar_distance_2`	`XXX1`	`radar_distance_2`
Beschreibung: Distanz mit zweithöchstem Peak in mm.
18–19	Peak 2	dBsm	`radar_ra_2`	`XXX1`	`radar_ra_2`
Beschreibung: Distanz mit zweithöchstem Peak in dBsm.
20–21	Distanz 3	mm	`radar_distance_3`	`XXX1`	`radar_distance_3`
Beschreibung: Distanz mit dritthöchstem Peak in mm.
22–23	Peak 3	dBsm	`radar_ra_3`	`XXX1`	`radar_ra_3`
Beschreibung: Distanz mit dritthöchstem Peak in dBsm.

6. Apollon Q TR / SW Version Payload Beschreibung (mit Radar und ToF)

Byte Nummer	Alias Name	Einheit	Bezeichnung im Payload Decoder	Modulschlüssel	Datahub .json Schlüssel
10	Status ToF Sensor	–	`tof_status`	`XXX1`	`tof_status`
Beschreibung: • 0 – Valid range • 2 / 4 – Out of bounds • 5 – Hardware fail • 7 – Wrapped target • 8 – Algorithm fail • 14 – Invalid range • 99 – Mehr als ein gültiges Ziel erfasst
11 – 12	Distanz (vgl. Master Value)	mm	`tof_distance`	`XXX1`	`tof_distance`
Beschreibung: Aktuelle gemessene Distanz des ToF-Sensors in mm.
13	Modus ToF (Index)	–	`tof_index`	`XXX1`	`tof_index`
Beschreibung: • 0 – Short (bis 1,3 m) • 1 – Medium (bis 3 m) • 2 – Long (bis 4 m)
14	Status Radar	–	`radar_status`	`XXX1`	`radar_status`
Beschreibung: • 0 – Error • 1 – Erfolg
15	Anzahl der Peaks	–	`radar_no_peaks`	`XXX1`	`radar_no_peaks`
Beschreibung: Anzahl der erfassten Peaks.
16 – 17	Distanz 1	mm	`radar_distance_1`	`XXX1`	`radar_distance_1`
Beschreibung: Distanz mit maximalem Peak in mm.
18 – 19	Peak 1	dBsm	`radar_ra_1`	`XXX1`	`radar_ra_1`
Beschreibung: Distanz mit maximalem Peak in dBsm.
20 – 21	Distanz 2	mm	`radar_distance_2`	`XXX1`	`radar_distance_2`
Beschreibung: Distanz mit zweithöchstem Peak in mm.
22 – 23	Peak 2	dBsm	`radar_ra_2`	`XXX1`	`radar_ra_2`
Beschreibung: Distanz mit zweithöchstem Peak in dBsm.
24 – 25	Distanz 3	mm	`radar_distance_3`	`XXX1`	`radar_distance_3`
Beschreibung: Distanz mit dritthöchstem Peak in mm.
26 – 27	Peak 3	dBsm	`radar_ra_3`	`XXX1`	`radar_ra_3`
Beschreibung: Distanz mit dritthöchstem Peak in dBsm.

7. Apollon Q – angehängte Bytes (ACC / HALL)

Angehängte Bytes	Alias Name	Einheit	Bezeichnung im Payload Decoder	Modulschlüssel	Datahub .json Schlüssel
1	Sensor Status (ACC)	–	`acc_status`	`XXX1`	`acc_status`
Beschreibung: Gibt den Status des Beschleunigungssensors zurück: • 0: OK • Sonstige Werte: Fehler
1	Orientierung (ACC)	–	`acc_orientation`	`XXX1`	`acc_orientation`
Beschreibung: Zeigt die Orientierung des Sensors an: • 0: Vertikal (liegt auf der Seite) • 1: Face Up (Linse zur Decke) • 2: Face Down (Linse zum Boden) • 3: Error
1	Klappenöffnung (ACC)	–	`acc_open`	`XXX1`	`acc_open`
Beschreibung: Zeigt an, ob der Deckel nach einem definierten Zeitintervall noch geöffnet ist.
1	Öffnungen Lifetime Counter (ACC)	–	`acc_open_cnt`	`XXX1`	`acc_open_cnt`
Beschreibung: Gesamtanzahl der Öffnungen über den gesamten Lebenszyklus.
1	Vandalismus Alarm (ACC)	–	`acc_impact`	`XXX1`	`acc_impact`
Beschreibung: Gibt an, ob ein Vandalismus-Event aktiv ist: • 0: Kein Vandalismusevent • 1: Vandalismusevent
1	Klappenöffnung (HALL)	–	`hall_open`	`XXX1`	`hall_open`
Beschreibung: Zeigt an, ob eine Klappe (mit angebrachtem Sensor) geöffnet ist: • 1: Geöffnet • 0: Geschlossen
1	Öffnungen Lifetime (HALL)	–	`hall_open_cnt`	`XXX1`	`hall_open_cnt`
Beschreibung: Gesamtanzahl der Öffnungen über den gesamten Lebenszyklus (Hall-Sensor).

8. Apollon Q – angehängte Bytes (Histogramm-Debugdaten, ToF Version = 2)

Angehängte Bytes	Alias Name	Einheit	Bezeichnung im Payload Decoder	Modulschlüssel	Datahub .json Schlüssel
1 Byte angehängt	Histogramm Typ/Version	–	`histo_type`	`XXX1`	`histo_type`
Beschreibung: Gibt an, ob nur Werte mit der Histogramm-Funktion übertragen werden oder zusätzlich Werte des Durchschnitts-Algorithmus. • 0: Nur Histogramm-Werte (`master_value` oder `tof_distance`) • 1: Histogramm-Werte und Werte des Durchschnitts-Algorithmus
1 Byte angehängt	Histogramm Status	–	`tof_hist_stat`	`XXX1`	`tof_hist_stat`
Beschreibung: Für detailliertere Informationen wenden Sie sich bitte an den Hersteller. Gilt für Varianten mit Histogramm Typ/Version = 0 (an der Payloadlänge +5 Bytes erkennbar).
2 Bytes angehängt	Histogramm Distanz	mm	`tof_hist_dist`	`XXX1`	`tof_hist_dist`
Beschreibung: Distanz in mm, die mit dem Histogramm-Feature-Algorithmus berechnet wurde. Im Normalbetrieb sollten diese Werte nur gering von den üblichen Distanzwerten abweichen und können starke Verschmutzungen auf der Linse kompensieren.

9. Beispiele Dekodierung (Febris)

Payload:
11 11 CE 14 8E 07 EE 1D 00 02 03 D6 01 D1 00

Bytes	HEX	Beschreibung
1	`11`	Modulschlüssel
2	`11`	Modulschlüssel
3	`CE`	Uplink Counter
4	`14`	Battery Voltage
5	`8E`	Battery Voltage
6	`07`	Interne Temperatur
7	`EE`	Interne Temperatur
8	`1D`	Relative Luftfeuchte
9	`00`	Taupunkt
10	`02`	Taupunkt
11	`03`	Luftdruck
12	`D6`	Luftdruck
13	`01`	CO₂
14	`D1`	CO₂
15	`00`	Alarm

Alle Inhalte dieses Dokuments, einschließlich Text, Tabellen und Bildern, sind urheberrechtlich geschützt und Eigentum der Sentinum GmbH.

Alle Bilder unterliegen dem Urheberrecht der Sentinum GmbH, sofern nicht anders angegeben.

Vervielfältigung, Verbreitung oder Nutzung — auch auszugsweise — ist ohne ausdrückliche schriftliche Genehmigung nicht gestattet.

Änderungen der Spezifikationen vorbehalten. Alle Angaben erfolgen ohne Gewähr.