![Logo_quer_farbig.png]](https://docs.sentinum.de/hs-fs/hubfs/Logo_quer_farbig.png?width=168&height=40&name=Logo_quer_farbig.png){kind=logo}
📄 Sie können das PDF oben ansehen oder
hier herunterladen
.
1. Versionshistorie
| Version | Datum | Änderung |
|---|---|---|
| 1.0.0 | 18.02.2025 | Erstellung |
| 1.0.1 | 24.04.2026 |
Formatierung Versionshistorie |
2. Überblick
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.
| Begriffe | 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 |
3. 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.
4. Uplink Beispiel (nicht für Juno anwendbar)
Gegeben ist das folgende Payload Beispiel für den Helios Drucksensor:
11 11 FE 1A D5 95 06 03 00 23 BE
| Bytes | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 |
|---|---|---|---|---|---|---|---|---|---|---|---|
HEX |
11 |
11 |
FE |
1A |
D5 |
95 |
06 |
03 |
00 |
23 |
BE |
| Beschreibung | Modulschluessel | Modulschluessel | Uplink Counter | Battery Voltage | Battery Voltage | Temperatur | Alarm Flag | Alarm Flag | Mess Status | Druck mbar | Druck mbar |
5. Portbelegung für WIFI SSID Scan Payload, GNSS Scan Payload und regulaere 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 + RSSI-Daten werden zur Ortung übertragen. |
| Regulaere Telemetrie Daten | 1 | Regulaere Payload Daten des Sensors, wie z. B. Temperatur, rel. Luftfeuchtigkeit, Winkel, Batterie Spannung etc. |
Beispiel für den WIFI SSID Scan Payload:
6. Dekodierung der WIFI SSID Scan und GNSS Scan Daten
Für die Dekodierung der WIFI SSID Scan und GNSS Scan Daten können folgende Provider empfohlen werden:
- Semtech LoRa Cloud (Abgekündigt Ende Juli 2025)
- AWS
- Tencent
- Traxmate
- Sentinum
Für on-prem Applikationen können lokale Datenbanken verwendet werden.
7. JUNO LORAWAN TH TRACKER Payload Beschreibung
| Artikelnummer | Funkstandard | Funktionen |
|---|---|---|
| S-JUNO(-iX)-LOEU-TH-TRACK | LoRaWAN® | Temperatur, rel. Luftfeuchtigkeit, Neigungsdetektion (Tilt), Aktivitaetserkennung, Oeffnungs- und Bewegungserkennung |
| Byte Nummer | Alias Name | Beschreibung | Einheit | Bezeichnung im Payload Decoder | Modulschluessel | Datahub .json Schluessel |
|---|---|---|---|---|---|---|
| 1 - 2 | Modulschluessel |
Byte 1: 4 Bit MSB: Modulcode. Bei Mioty ausschliesslich "Sentiface" Telemetrie-Modul, d. h. stets 0x1. 4 Bit LSB: Major Version. FW der gleichen Major-Version aber groesserer Minor-Version bleiben mit aelteren Dekodern kompatibel. Die Anzahl der Bytes kann sich aber aendern! Byte 2: 4 Bit MSB: Minor Version. Neue SW Versionen fuegen ggf. inkrementell neue Telemetrie an das Datenpaket an. 4 Bit LSB: Sub / Product Version. Bei Helios kodieren diese Bits die konkrete Konfiguration angeschlossener Sensorik. |
module_key |
XXX1 | module_key |
|
| 3 | Uplink Zaehler | Uplink Zaehler: Protokoll unabhaengiger Uplinkcounter, der maximal bis 255 reicht. Danach beginnt der Counter wieder bei 0. | uplink_counter |
XXX1 | uplink_counter |
|
| 4 - 5 | Batterie Spannung | Aktuelle Spannung der Batterie in Millivolt. Spannung in Volt: battery_voltage: (dataBytes[3] << 8 | dataBytes[4])/1000.0 |
mV | battery_voltage |
XXX1 | battery_voltage |
| 6 | Interne Temperatur | Temperatur des Sensors: internal_temperature = | bytes[6] - 128. Dieser Wert ist der Temperaturwert des Controllers und ein ungenauer Temperaturwert +/-2°C. |
°C | internal_temperature |
XXX1 | internal_temperature |
| 7 | Alarme |
Die Alarme sind wie folgt kodiert. Vorsicht: Es koennen mehrere Alarme gleichzeitig aktiv sein! DEZ 1, BIN 0000 0001: Grenzwert Temperatur High ueberschritten DEZ 2, BIN 0000 0010: Grenzwert Temperatur Low unterschritten DEZ 4, BIN 0000 0100: Delta Alarm Temperatur DEZ 8, BIN 0000 1000: Grenzwert rel. Luftfeuchtigkeit High ueberschritten DEZ 16, BIN 0001 0000: Grenzwert rel. Luftfeuchtigkeit Low unterschritten DEZ 32, BIN 0010 0000: Delta Alarm rel. Luftfeuchtigkeit |
humidity |
XXX1 | humidity |
|
| 8 - 9 | Temperatur | Genaue Temperatur vom SHT40, wie im Datenblatt beschrieben. decoded.temperature = ((bytes[idx++] << 8) | bytes[idx++]) / 10 - 100; |
°C | temperature |
XXX1 | temperature |
| 10 | Relative Luftfeuchtigkeit | Relative Luftfeuchtigkeit vom SHT40, wie im Datenblatt beschrieben. | %RH | humidity |
XXX1 | humidity |
| 11 | Status Beschleunigungssensor | 0: Beschleunigungssensor ohne Fehler, sonstige: Fehler Beschleunigungssensor | acc_status |
XXX1 | acc_status |
|
| 12 - 15 | Zeitstempel Start einer Bewegung | Gibt den Zeitstempel in Sekunden beim Start der Bewegung zurueck. | s | move_start |
XXX1 | move_start |
| 16 - 19 | Zeitstempel Ende einer Bewegung | Gibt den Zeitstempel in Sekunden beim Ende der Bewegung zurueck. | s | move_end |
XXX1 | move_end |
| 20 | Objekt bewegt sich gerade | 0: Keine Aktivitaet, 1: Objekt in Bewegung. | moving |
XXX1 | moving |
|
| 21 - 22 | Anzahl der gezaehlten Aktivitaeten | Zaehlt die Anzahl der Aktivitaeten. | move_cnt |
XXX1 | move_cnt |
|
| 23 | Winkel | Gibt den Winkel in ° zurueck, Aufloesung 1°. | ° | angle |
XXX1 | angle |
8. JUNO LORAWAN TH TRACKER Payload Beschreibung (ohne TH)
| Artikelnummer | Funkstandard | Funktionen |
|---|---|---|
| S-JUNO(-iX)-LOEU-TRACK | LoRaWAN® | Neigungsdetektion (Tilt), Aktivitaetserkennung, Oeffnungs- und Bewegungserkennung |
| Byte Nummer | Alias Name | Beschreibung | Einheit | Bezeichnung im Payload Decoder | Modulschluessel | Datahub .json Schluessel |
|---|---|---|---|---|---|---|
| 1 - 2 | Modulschluessel |
Byte 1: 4 Bit MSB: Modulcode. Bei Mioty ausschliesslich "Sentiface" Telemetrie-Modul, d. h. stets 0x1. 4 Bit LSB: Major Version. FW der gleichen Major-Version aber groesserer Minor-Version bleiben mit aelteren Dekodern kompatibel. Die Anzahl der Bytes kann sich aber aendern! Byte 2: 4 Bit MSB: Minor Version. Neue SW Versionen fuegen ggf. inkrementell neue Telemetrie an das Datenpaket an. 4 Bit LSB: Sub / Product Version. Bei Helios kodieren diese Bits die konkrete Konfiguration angeschlossener Sensorik. |
module_key |
XXX1 | module_key |
|
| 3 | Uplink Zaehler | Uplink Zaehler: Protokoll unabhaengiger Uplinkcounter, der maximal bis 255 reicht. Danach beginnt der Counter wieder bei 0. | uplink_counter |
XXX1 | uplink_counter |
|
| 4 - 5 | Batterie Spannung | Aktuelle Spannung der Batterie in Millivolt. Spannung in Volt: battery_voltage: (dataBytes[3] << 8 | dataBytes[4])/1000.0 |
mV | battery_voltage |
XXX1 | battery_voltage |
| 6 | Interne Temperatur | Temperatur des Sensors: internal_temperature = | bytes[6] - 128. Dieser Wert ist der Temperaturwert des Controllers und ein ungenauer Temperaturwert +/-2°C. |
°C | internal_temperature |
XXX1 | internal_temperature |
| 7 | Status Beschleunigungssensor | 0: Beschleunigungssensor ohne Fehler, sonstige: Fehler Beschleunigungssensor | acc_status |
XXX1 | acc_status |
|
| 8 - 11 | Zeitstempel Start einer Bewegung | Gibt den Zeitstempel in Sekunden beim Start der Bewegung zurueck. | s | move_start |
XXX1 | move_start |
| 12 - 15 | Zeitstempel Ende einer Bewegung | Gibt den Zeitstempel in Sekunden beim Ende der Bewegung zurueck. | s | move_end |
XXX1 | move_end |
| 16 | Objekt bewegt sich gerade | 0: Keine Aktivitaet, 1: Objekt in Bewegung. | moving |
XXX1 | moving |
|
| 17 - 18 | Anzahl der gezaehlten Aktivitaeten | Zaehlt die Anzahl der Aktivitaeten. | move_cnt |
XXX1 | move_cnt |
|
| 19 | Winkel | Gibt den Winkel in ° zurueck, Aufloesung 1°. | ° | angle |
XXX1 | angle |
