0287921b38
- Firmware: energy.c/h tracks relay ON-time and uptime via k_uptime_get, load_watts (default 400W) persistent via Zephyr Settings API - Payload extended from 7 to 15 bytes (backwards compatible): relay ON-time (uint24), uptime (uint24), load in watts (uint16) - New 'w' downlink for load configuration - Fix downlink handler: 'i'/'w' commands now checked before combined packet - Server: g2h_rs_energy_tracking table for lifetime power_consumption_wh, reboot detection via uptime vs real elapsed time - Decoder/encoder and docs updated
86 lines
3.3 KiB
Markdown
86 lines
3.3 KiB
Markdown
# LoRaWAN Payload Description - Raumsensor Device
|
|
|
|
## Uplink Payload (Device → Network Server)
|
|
|
|
**Port:** 2
|
|
**Length:** 7 Bytes (ohne Energietracking) oder 15 Bytes (mit Energietracking)
|
|
**Format:** Binary
|
|
|
|
| Byte | Field | Type | Unit | Description |
|
|
|-------|------------------|---------|----------|-------------|
|
|
| 0-1 | Room Temperature | int16 | 0.01°C | SHT4x sensor (big-endian) |
|
|
| 2-3 | Floor Temperature| int16 | 0.01°C | MLX90614 IR sensor (big-endian) * |
|
|
| 4-5 | Humidity | int16 | 0.01% | SHT4x sensor (big-endian) |
|
|
| 6 | Relay State | uint8 | - | 0=OFF, 1=ON |
|
|
| **7-9** | **Relay ON-Time** | **uint24** | **Sekunden** | **Kumulative Einschaltdauer seit Boot** |
|
|
| **10-12** | **Uptime** | **uint24** | **Sekunden** | **Gerätelaufzeit seit Boot** |
|
|
| **13-14** | **Load** | **uint16** | **Watt** | **Konfigurierte Heizlast** |
|
|
|
|
**Hinweis zur Abwärtskompatibilität:** Geräte ohne Energietracking senden 7 Bytes. Der Decoder erkennt die Version anhand von `bytes.length`.
|
|
|
|
**Beispiel (15 Bytes):**
|
|
- `08 34 0A 28 15 E0 01 00 00 F0 00 01 2C 01 90`
|
|
= 21.00°C Raum, 26.00°C Boden, 56.00% Feuchte, Relay ON, 240s ON-Zeit, 300s Uptime, 400W Last
|
|
|
|
## Downlink Payload (Network Server → Device)
|
|
|
|
**Port:** Any
|
|
**Format:** Binary
|
|
|
|
### Kombiniertes Konfigurationspaket
|
|
|
|
**Length:** 3 Bytes
|
|
**Format:** `[heating_enable][room_temp_threshold][floor_temp_threshold]`
|
|
|
|
| Byte | Field | Type | Range | Description |
|
|
|------|--------------------------|-------|-------|-------------|
|
|
| 0 | Heating Enable | uint8 | 0-1 | 0=DISABLED, 1=ENABLED |
|
|
| 1 | Room Temperature Threshold | uint8 | 0-255 | Raumtemperatur-Schwellwert in °C |
|
|
| 2 | Floor Temperature Threshold | uint8 | 0-255 | Bodentemperatur-Schwellwert in °C |
|
|
|
|
**Beispiele:**
|
|
- `01 16 19` = Heizung AN, Raum 22°C, Boden 25°C
|
|
- `00 14 18` = Heizung AUS
|
|
|
|
### Sendeintervall
|
|
|
|
**Length:** 2 Bytes
|
|
**Format:** `'i'[interval_minutes]`
|
|
|
|
| Byte | Field | Type | Range | Description |
|
|
|------|----------|-------|-------|-------------|
|
|
| 0 | Command | ASCII | 0x69 | Befehlskennung 'i' |
|
|
| 1 | Interval | uint8 | 1-255 | Sendeintervall in Minuten |
|
|
|
|
**Beispiele:**
|
|
- `69 05` = 5 Minuten
|
|
- `69 0A` = 10 Minuten
|
|
- `69 3C` = 60 Minuten
|
|
|
|
### Last-Konfiguration
|
|
|
|
**Length:** 3 Bytes
|
|
**Format:** `'w'[watts_high][watts_low]`
|
|
|
|
| Byte | Field | Type | Range | Description |
|
|
|------|-------------|-------|--------|-------------|
|
|
| 0 | Command | ASCII | 0x77 | Befehlskennung 'w' |
|
|
| 1-2 | Load Watts | uint16 | 1-65535 | Heizlast in Watt (big-endian), persistent gespeichert |
|
|
|
|
**Beispiele:**
|
|
- `77 01 90` = 400W (0x0190)
|
|
- `77 03 E8` = 1000W (0x03E8)
|
|
|
|
## Datenkonvertierung
|
|
|
|
- **Temperatur:** `raw = (int16)(temperature * 100)` → `actual = raw / 100.0`
|
|
- **Luftfeuchtigkeit:** `raw = (int16)(humidity * 100)` → `actual = raw / 100.0`
|
|
- **ON-Zeit / Uptime:** uint24 big-endian, Sekunden seit Boot (wird bei Reboot zurückgesetzt)
|
|
- **Last:** uint16 big-endian, Watt
|
|
|
|
## Sonderfälle
|
|
|
|
**\* Bodentemperatursensor:** Wenn der MLX90614 nicht verfügbar ist, wird `-273.15°C` (hex: `95 5D`) übertragen.
|
|
|
|
**Reboot-Erkennung (Portal):** Wenn `relay_on_time` im aktuellen Paket kleiner ist als im vorherigen, wurde das Gerät neu gestartet.
|