Skip to content
English
  • There are no suggestions because the search field is empty.

Nyx NFC and Downlink Description

Looking for the Nyx NFC and Downlink Description?

NYX – NFC & Downlink Description
📄 PDF anzeigen oder hier herunterladen

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)

Uplink Payload Beispiel
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 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 - 100
Dieser 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:

  1. 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.
  2. 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.
  3. Feinstaub (PM2.5 / PM10):
    • Feine Partikel, die durch Rauch, Kochdämpfe oder Staub entstehen.
    • Feinstaub kann Atemwegserkrankungen und andere gesundheitliche Probleme verursachen.
  4. Kohlenmonoxid (CO):
    • Ein giftiges Gas, das durch unvollständige Verbrennung entsteht.
    • Selbst geringe Konzentrationen können gefährlich sein.
  5. 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
Example payload decoder output
Beispiele Dekodierung
LoRaWAN und mioty Logos Nyx device illustration