Zu Content springen
Deutsch
Kundenportal
Gehe zu www.sentinum.de
  • Es gibt keine Vorschläge, da das Suchfeld leer ist.

Apollon-Q T/R/TR Payload Beschreibung

Sie suchen eine Payload Beschreibung für den Apollon-Q-T/R/TR

Hier finden Sie eine Payload Beschreibung für den Apollon-Q-T/R/TR 👇

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

In diesem Kapitel wird die Struktur der Telemetriedaten beschrieben. Die Anzahl der Bytes in der Payload hängt von der Konfiguration des Sensors ab. Der Aufbau der Daten hängt davon ab, welche Sensoren in Ihrem Produkt vorhanden sind. Im Prinzip hat jede Version einen Header. Dieser hat Informationen über die Version und den Status des Sensors und enthält außerdem einen Master-Messwert. Dieser Messwert kann einfach als der aktuelle Messwert angenommen werden. Nach dem Header folgt ein zusätzlicher Payload-Teil, der weitere Informationen enthält, wie z. B. spezielle Parameter für das Messprinzip oder Einstellungen zur Positions- und Öffnungserkennung. Nicht jeder Sensor hat einen zusätzlichen Payload-Teil.

PAYLOAD BESCHREIBUNG

Begriff Beschreibung
Byte No. Byte-Nummer beginnend bei 1
Alias Verständlicher Name der Variablen
Beschreibung Beschreibung der Variablen
Bezeichnung Bezeichnung im Dataconverter
Einheit Einheit der Variablen
Datahub .json Schlüssel Schlüssel im .json 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-Modul z. B. Sentiface, Senticom, Sentivisor

Major Version (SW/HW Version)

Minor Version (SW/HW Version)

Produkt Version (Sensoren, z.b. TH, THL, ACC, …)

Der Modulschlüssel des SENTIFACE-Moduls kann aus den ersten 2 Bytes jedes Uplinks entnommen werden. Der Modulschlüssel wird für den Downlink benötigt.

Portbelegung für WiFi SSID Scan Payload, GNSS Scan Payload und reguläre Payload

Feature LoRaWAN Port Beschreibung
GNSS Scan Payload 192 Rohdaten (Satelliten-ID, Zeit, etc.) werden zum Geolocation-Backend gesendet.
WiFi SSID Scan Payload 197 Gescannte MAC-Adressen und RSSI-Daten werden zur Ortung übertragen.
Reguläre Telemetrie-Daten 1 Reguläre Payload-Daten des Sensors, wie z. B. Temperatur, relative Luftfeuchtigkeit, Winkel und Batteriespannung.

Example for the WIFI SSID scan payload:

Apollon Q T/R/TR/SW Payload Beschreibung

Byte Nummer Alias Name Einheit Bezeichnung im Decoder Modul-schlüssel Datahub .json Schlüssel
1 – 2 Modulschlüssel module_key XXX1 module_key
Beschreibung:
Byte 1
• 4 Bit MSB: Modulcode. Bei Mioty ausschließlich „Sentiface" Telemetrie-Modul, d.h. stets 0x1.
• 4 Bit LSB: Major Version. FW der gleichen Major-Version, aber größerer Minor-Version, bleibt mit älteren Decodern kompatibel – die Anzahl der Bytes kann sich aber ändern!

Byte 2
• 4 Bit MSB: Minor Version. Neue SW-Versionen fügen ggf. inkrementell neue Telemetrie zum Datenpaket hinzu.
• 4 Bit LSB: Sub / Product Version. Bei Helios kodieren diese Bits die konkrete Konfiguration angeschlossener Sensorik.
3 Uplink Zähler uplink_counter XXX1 uplink_counter
Beschreibung: Protokollunabhängiger Uplink-Counter, der maximal bis 255 zählt und dann wieder bei 0 beginnt.
4 – 5 Batteriespannung mV battery_voltage XXX1 battery_voltage
Beschreibung: Aktuelle Spannung der Batterie in Millivolt.
// Spannung in Volt
battery_voltage = (dataBytes[3] << 8 | dataBytes[4]) / 1000.0;
6 Interne Temperatur °C internal_temperature XXX1 internal_temperature
Beschreibung: Interne Temperatur des Sensors.
// Temperatur in °C
internal_temperature = dataBytes[5] - 128;
7 Alarm Variable alarm XXX1 alarm
Beschreibung: Uplink wurde durch einen Alarm verursacht.
• 0: Alarm nicht ausgelöst • 1: Alarm ausgelöst
Für Sensoren der neuen Generation (Bit-zuordnung):
• 1: Delta-Alarm • 2: Temperaturalarm • 4: Öffnungsalarm • 8: Vandalismusalarm
8 – 9 Mastermesswert mm master_value XXX1 master_value
Beschreibung:
• APOQ-XXXX-T: aktueller Messwert des ToF-Sensors in mm.
• APOQ-XXXX-R: Messwert für den maximalen Radar-Peak in mm.
• APOQ-XXXX-TR: berechneter Messwert aus den Distanzen beider Messprinzipien in mm.
 
Hinweis: Für die weiteren Bytes beachten Sie bitte die Unterscheidung nach der jeweiligen Hardware-Version des Sensors (T, R, TR, SW), da sich die Payload unterscheiden kann.

Apollon Q T Version Payload Beschreibung (ohne Radar)

Byte Nummer Alias Name Einheit Bezeichnung im Payload Decoder Modul-schlü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. Mastervalue, wenn Quelle des Sensors gleich 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

Apollon Q R Version Payload Beschreibung (ohne ToF)

Byte Nummer Alias Name Einheit Bezeichnung im Payload Decoder Modul-schlü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.

 

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

Byte Nummer Alias Name Einheit Bezeichnung im Payload Decoder Modul-schlü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 – 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:
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)
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 – 17Distanz 1mmradar_distance_1XXX1radar_distance_1
Beschreibung:
Distanz mit maximalem Peak in mm.
18 – 19Peak 1dBsmradar_ra_1XXX1radar_ra_1
Beschreibung:
Distanz mit maximalem Peak in dBsm.
20 – 21Distanz 2mmradar_distance_2XXX1radar_distance_2
Beschreibung:
Distanz mit zweithöchstem Peak in mm.
22 – 23Peak 2dBsmradar_ra_2XXX1radar_ra_2
Beschreibung:
Distanz mit zweithöchstem Peak in dBsm.
24 – 25Distanz 3mmradar_distance_3XXX1radar_distance_3
Beschreibung:
Distanz mit dritthöchstem Peak in mm.
26 – 27Peak 3dBsmradar_ra_3XXX1radar_ra_3
Beschreibung:
Distanz mit dritthöchstem Peak in dBsm.

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

Angehängte Bytes Alias Name Einheit Bezeichnung im Payload Decoder Modul-schlü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: 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).

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

Angehängte Bytes Alias Name Einheit Bezeichnung im Payload Decoder Modul-schlü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 mit dem üblichen Durchschnitts-Algorithmus:
• 0: Nur Histogramm-Werte (im 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 genauere Informationen bitte den Hersteller kontaktieren.
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 gemessen wurde. Im Normalbetrieb sollten diese Werte nur gering von den üblichen Distanzwerten abweichen und können starke Verschmutzungen auf der Linse kompensieren.

Beispiele Dekodierung (Febris)

Payload: 11 11 CE 14 8E 07 EE 1D 00 02 03 D6 01 D1 00
Bytes HEX Beschreibung
111Modul-schlüssel
211Modul-schlüssel
3CEUplink Counter
414Battery Voltage
58EBattery Voltage
607Interne Temperatur
7EEInterne Temperatur
81DRel. Luftfeuchte
900Taupunkt
1002Taupunkt
1103Luftdruck
12D6Luftdruck
1301CO₂
14D1CO₂
1500Alarm

 

Technische Änderungen behalten wir uns ohne vorherige Ankündigung vor. Alle Angaben ohne Gewähr.

         

Dokumentationen Links

Die Links für die weiteren Dokumentationen den Apollon-Q T/R/TR finden Sie hier: