Nyx NFC and Downlink Description
Looking for the Nyx NFC and Downlink Description?
NYX Payload Beschreibung
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 |
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 Nyx anwendbar)
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 | Modul‑schlüssel | Modul‑schlüssel | Uplink Counter | Battery Voltage | Battery Voltage | Temperatur | Alarm Flag | Alarm Flag | Mess Status | Druck mbar | Druck mbar |
Nyx Payload Beschreibung
| Byte Nummer | Alias Name | Einheit | Bezeichnung im Payload 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 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. |
|||||
| 3 | Uplink Zähler | - | uplink_counter |
XXX1 |
uplink_counter |
|
Beschreibung: Protokoll unabhängiger Uplinkcounter, der maximal bis 255 reicht. Danach beginnt der Counter wieder bei 0. |
|||||
| 4 – 5 | Batterie Spannung | mV | battery_voltage |
XXX1 |
battery_voltage |
|
Beschreibung: Aktuelle Spannung der Batterie in Millivolt. (dataBytes[3] << 8 | dataBytes[4]) / 1000.0
|
|||||
| 6 – 7 | Interne Temperatur | °C | internal_temperature |
XXX1 |
internal_temperature |
Beschreibung:((bytes[5] << 8) | bytes[6]) / 10 - 100Dieser Wert ist bei diesem Sensor der Temperaturwert, nach Spezifikation im technischen Datenblatt. |
|||||
| 8 | Relative Luftfeuchte | %RH | humidity |
XXX1 |
humidity |
|
Beschreibung: Relative Luftfeuchtigkeit in %RH. |
|||||
| 9 – 10 | Taupunkt | °C | dew_point |
XXX1 |
dew_poin |
|
Beschreibung: Taupunkt in °C. |
|||||
| 11 | Alarm Variable | - | alarm-level |
XXX1 |
alarm-leve |
|
Beschreibung: Alarm Level, entspricht grün, gelb und roter Anzeige an den LEDs. |
|||||
| 12 – 13 | Lichtintensität Indikator | lux | raw_lux |
XXX1 |
raw_lux |
|
Beschreibung: Lichtintensität in Lux als Indikator, keine direkte Messung des Umgebungslichts. decoded.lux = (1 << (raw_lux >> 12)) * (raw_lux & 0x0FFF) * 0.01
|
|||||
| 14 | Gas Sensor Status | °C | internal_temperature |
XXX4 |
internal_temperature |
|
Beschreibung: Status des Gassensors. |
|||||
| 15 – 16 | Luftdruck | %RH | pressure |
XXX4 |
pressure |
|
Beschreibung: Luftdruckwert. |
|||||
| 17 | Indoor Air Quality Status | - | iaq_status |
XXX4 |
iaq_status |
|
Beschreibung: Indoor Air Quality Status. |
|||||
| 18 – 19 | Indoor Air Quality Index | - | Iaq_index |
XXX4 |
Iaq_index |
|
Beschreibung: Indoor Air Quality Index. |
|||||
IAQ Index
Der IAQ‑Index (Indoor Air Quality Index) ist eine Kennzahl, die die Qualität der Raumluft bewertet und häufig verwendet wird, um den Gesundheitszustand der Luft in Innenräumen zu beschreiben. Er wird typischerweise auf der Grundlage von Messungen verschiedener Luftschadstoffe berechnet.
Ziel des IAQ‑Index
- Gesundheitsschutz: Der IAQ‑Index gibt Hinweise darauf, wie sicher oder gesund die Luft für die Menschen im Raum ist.
- Orientierungshilfe: Er ermöglicht eine einfache und verständliche Interpretation der Luftqualität, oft in Form eines Skalenwerts oder einer farblichen Einstufung.
Wichtige Parameter für den IAQ‑Index
Der IAQ‑Index basiert auf verschiedenen Faktoren und Messungen, darunter:
-
Kohlendioxid (CO₂):
- Hohe Konzentrationen können zu Müdigkeit, Konzentrationsproblemen und Unwohlsein führen.
- Typischer Grenzwert: 400–1000 ppm (parts per million) gelten als akzeptabel.
-
Flüchtige organische Verbindungen (VOC):
- Chemische Stoffe, die aus Farben, Reinigungsmitteln, Möbeln oder Elektronikgeräten freigesetzt werden.
- VOCs können bei hohen Konzentrationen Kopfschmerzen, Reizungen oder langfristige Gesundheitsprobleme verursachen.
-
Feinstaub (PM2.5 / PM10):
- Feine Partikel, die durch Rauch, Kochdämpfe oder Staub entstehen.
- Feinstaub kann Atemwegserkrankungen und andere gesundheitliche Probleme verursachen.
-
Kohlenmonoxid (CO):
- Ein giftiges Gas, das durch unvollständige Verbrennung entsteht.
- Selbst geringe Konzentrationen können gefährlich sein.
-
Relative Luftfeuchtigkeit und Temperatur:
- Diese Werte beeinflussen das Wohlbefinden und das Wachstum von Schimmelpilzen oder Bakterien.
Klassifikation des IAQ‑Index
Viele IAQ‑Systeme verwenden eine numerische oder farbliche Skala, um die Luftqualität darzustellen. Ein Beispiel:
| IAQ‑Wert | Luftqualität | Beschreibung |
|---|---|---|
| 0–50 | Exzellent | Keine Gesundheitsrisiken. |
| 51–100 | Gut | Geringe Risiken für empfindliche Personen. |
| 101–150 | Mäßig | Kann für empfindliche Personen problematisch sein. |
| 151–200 | Ungesund | Beeinträchtigungen für die allgemeine Bevölkerung möglich. |
| 201–300 | Sehr ungesund | Gesundheitliche Probleme bei längerer Exposition. |
| 301+ | Gefährlich | Schwerwiegende Gesundheitsrisiken. |
Beispiele Dekodierung
Payload:
11 11 A2 0D 29 09 38 2B 04 06 00 03 A0
| Bytes | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| HEX | 11 | 11 | A2 | 0D | 29 | 09 | 38 | 2B | 04 | 06 | 00 | 03 | A0 |
| Beschreibung | Modul‑schlüssel | Modul‑schlüssel | Uplink Counter | Battery Voltage | Battery Voltage | Temperatur | Tempera‑tur | Rel. Luftfeuchte | Taupunkt | Taupunkt | Alarm Flag | Lichtinten‑sität | Lichtinten‑sität |
© Sentinum GmbH – Alle Rechte vorbehalten.
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.