![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}
1. Versionshistorie
| Version | Datum | Änderung |
|---|---|---|
| 1.0.0 | 18.02.2025 | Erstellung |
| 1.0.1 | 24.04.2026 |
Formatierung Versionshistorie |
2. Übersicht
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 enthält Informationen über die Version und den Status des Sensors sowie 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.
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 | Modulschlüssel | Modulschlüssel | Uplink Counter | Battery Voltage | Battery Voltage | Temperatur | Alarm Flag | Alarm Flag | Mess Status | Druck mbar | Druck mbar |
4. JUNO TH TILT Payload Beschreibung
| Byte Nummer | Alias Name | Beschreibung | Einheit | Bezeichnung im Payload Decoder | Modulschlüssel | Datahub .json Schlüssel |
|---|---|---|---|---|---|---|
| 1 – 2 | Modulschlüssel |
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 bleiben mit älteren Dekodern 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 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 Zähler | Protokoll-unabhängiger Uplink-Counter, 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] - 128Dieser 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 codiert. Achtung: Mehrere Alarme können gleichzeitig aktiv sein! DEZ 1, BIN 0000 0001: Temperatur Hoch – Grenzwert überschritten DEZ 2, BIN 0000 0010: Temperatur Niedrig – Grenzwert unterschritten DEZ 4, BIN 0000 0100: Delta Alarm Temperatur DEZ 8, BIN 0000 1000: Rel. Luftfeuchtigkeit Hoch – Grenzwert überschritten DEZ 16, BIN 0001 0000: Rel. Luftfeuchtigkeit Niedrig – Grenzwert unterschritten DEZ 32, BIN 0010 0000: Delta Alarm rel. Luftfeuchtigkeit |
alarms |
XXX1 | alarms |
|
| 8 – 9 | Temperatur |
Genaue Temperatur des SHT40, wie im Datenblatt beschrieben.decoded.temperature = ((bytes[idx++] << 8) | bytes[idx++]) / 10 - 100
|
°C | temperature |
XXX1 | temperature |
| 10 | Relative Luftfeuchtigkeit | Relative Luftfeuchtigkeit des SHT40, wie im Datenblatt beschrieben. | %RH | humidity |
XXX1 | humidity |
| 11 | Status Beschleunigungssensor |
0: Beschleunigungssensor ohne FehlerSonstige: Fehler Beschleunigungssensor |
acc_status |
XXX1 | acc_status |
|
| 12 | Orientierung des Sensors |
Zeigt die Orientierung des Sensors an:0: Vertikal – liegt auf der Seite1: Face Up2: Face Down3: Error
|
orientation |
XXX1 | orientation |
|
| 13 | Winkel | Gibt den Winkel in ° zurück, Auflösung 1°. | ° | angle |
XXX1 | angle |
| 14 | Offen | Gibt an, ob die Klappe geöffnet oder geschlossen ist. | is_open |
XXX1 | is_open |
|
| 15 | Öffnungszähler relativ | Gibt an, wie viele Öffnungen seit dem letzten Uplink durchgeführt wurden. | open_cnt_rel |
XXX1 | open_cnt_rel |
|
| 16 | Öffnungszähler Lifetime | Gibt an, wie viele Öffnungen im gesamten Betrieb durchgeführt wurden. | open_cnt_total |
XXX1 | open_cnt_total |
