> For the complete documentation index, see [llms.txt](https://docs.dnt.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dnt.de/dnt-lw-wth/kommunikationsprotokoll/2.-geratestatus.md).

# 2. Gerätestatus

## 2.1 Status Intervall

{% tabs %}
{% tab title="GET STATUS INTERVAL" %}
Liest das Sendeintervall der zyklischen Statusmeldung `GET STATUS (0x04)` aus.

**Downlink**

| Byte | Bit(s) |        Value        |
| :--: | :----: | :-----------------: |
|   0  |    7   |          IR         |
|   0  |   6:0  | `0x00` (Command ID) |

**Uplink**

<table><thead><tr><th align="center">Byte</th><th width="211.0908203125" align="center">Bit(s)</th><th align="center">Value</th></tr></thead><tbody><tr><td align="center">0</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">0</td><td align="center">6:0</td><td align="center"><code>0x00</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">6:0</td><td align="center"><code>ID_STATUS_REPORT_INTERVAL</code></td></tr></tbody></table>
{% endtab %}

{% tab title="SET STATUS INTERVAL" %}
Konfiguriert das Intervall der zyklischen Statusmeldung `GET STATUS (0x04)`.

**Beispiel**

```
0x01 09 = 5 Min. Statusintervall
```

<table><thead><tr><th align="center">Byte</th><th width="210.1817626953125" align="center">Bit(s)</th><th align="center">Value</th></tr></thead><tbody><tr><td align="center">0</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">0</td><td align="center">6:0</td><td align="center"><code>0x01</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_STATUS_REPORT_INTERVAL</code></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

<details>

<summary>ID_STATUS_REPORT_INTERVAL</summary>

|   Eigenschaft  |                                         Wert                                         |
| :------------: | :----------------------------------------------------------------------------------: |
|  Beschreibung  | Intervall in Sekunden, in dem das Gerät seinen Status mit `GET STATUS (0x04)` sendet |
|      Größe     |                                         8 Bit                                        |
|  Wertebereich  |                                         0–255                                        |
|  Standardwert  |                                          19                                          |
| Interpretation |                             `y = x × 30 + 30`, `[y] = s`                             |
|   Persistent   |                                          Ja                                          |
|     Zugriff    |                                          r/w                                         |

</details>

***

## 2.2 Statusparameter

{% tabs %}
{% tab title="GET STATUS PARAMETER TX ENABLE REGISTER" %}
Liest den Parameter `ID_STATUS_PARAM_TX_EN_REG` aus.

**Downlink**

| Byte | Bit(s) |        Value        |
| :--: | :----: | :-----------------: |
|   0  |    7   |         `IR`        |
|   0  |   6:0  | `0x02` (Command ID) |

**Uplink**

<table><thead><tr><th align="center">Byte</th><th width="214.727294921875" align="center">Bit(s)</th><th align="center">Value</th></tr></thead><tbody><tr><td align="center">0</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">0</td><td align="center">6:0</td><td align="center"><code>0x02</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_STATUS_PARAM_TX_EN_REG</code></td></tr></tbody></table>
{% endtab %}

{% tab title="SET STATUS PARAMETER TX ENABLE REGISTER" %}
Setzt den Parameter `ID_STATUS_PARAM_TX_EN_REG`.

**Beispiel**

```
0x03 1F = Batteriespannung, Raumtemperatur, Luftfeuchte, Solltemperatur und Modus aktiv
```

<table><thead><tr><th align="center">Byte</th><th width="204.727294921875" align="center">Bit(s)</th><th align="center">Value</th></tr></thead><tbody><tr><td align="center">0</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">0</td><td align="center">6:0</td><td align="center"><code>0x03</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_STATUS_PARAM_TX_EN_REG</code></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

<details>

<summary>ID_STATUS_PARAM_TX_EN_REG</summary>

|   Eigenschaft  |                                                                                                                                                                                                           Wert                                                                                                                                                                                                           |
| :------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|  Beschreibung  |                                                                                                                                                                                    Aktiviert Parameter in der zyklischen Statusmeldung                                                                                                                                                                                   |
|      Größe     |                                                                                                                                                                                                           8 Bit                                                                                                                                                                                                          |
|  Wertebereich  |                                                                                                                                                                                                           0–255                                                                                                                                                                                                          |
|  Standardwert  |                                                                                                                                                                                                             7                                                                                                                                                                                                            |
| Interpretation | <p>0 = Parameter wird nicht gesendet, 1 = Parameter wird gesendet</p><p>Bit 0: <code>ID\_BATTERY\_VOLTAGE</code></p><p>Bit 1: <code>ID\_ROOM\_TEMPERATURE</code></p><p>Bit 2: <code>ID\_ROOM\_HUMIDITY</code></p><p>Bit 3: <code>ID\_SET\_POINT\_TEMPERATURE</code></p><p>Bit 4: <code>ID\_ACTIVE\_MODE</code> + <code>ID\_HOLIDAY\_MODE\_PENDING</code> + <code>ID\_WINDOW\_OPEN\_STATUS</code></p><p>Bit 5:7: Res.</p> |
|   Persistent   |                                                                                                                                                                                                            Ja                                                                                                                                                                                                            |
|     Zugriff    |                                                                                                                                                                                                            r/w                                                                                                                                                                                                           |

</details>

***

## 2.3 Statusmeldung

{% tabs %}
{% tab title="GET STATUS" %}
Liest die aktuelle Statusmeldung des Geräts aus.

**Downlink**

| Byte | Bit(s) |        Value        |
| :--: | :----: | :-----------------: |
|   0  |    7   |         `IR`        |
|   0  |   6:0  | `0x04` (Command ID) |

**Uplink**

<table><thead><tr><th align="center">Byte</th><th width="207.45458984375" align="center">Bit(s)</th><th align="center">Value</th></tr></thead><tbody><tr><td align="center">0</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">0</td><td align="center">6:0</td><td align="center"><code>0x04</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_STATUS_PARAM_TX_EN_REG</code></td></tr><tr><td align="center">2</td><td align="center">7:0</td><td align="center"><code>ID_BATTERY_VOLTAGE</code></td></tr><tr><td align="center">3</td><td align="center">7:0</td><td align="center"><code>ID_ROOM_TEMPERATURE[15:8]</code></td></tr><tr><td align="center">4</td><td align="center">7:0</td><td align="center"><code>ID_ROOM_TEMPERATURE[7:0]</code></td></tr><tr><td align="center">5</td><td align="center">7:0</td><td align="center"><code>ID_ROOM_HUMIDITY</code></td></tr><tr><td align="center">6</td><td align="center">7:0</td><td align="center"><code>ID_SET_POINT_TEMPERATURE</code></td></tr><tr><td align="center">7</td><td align="center">7</td><td align="center"><code>ID_TEMPERATURE_TOO_LOW</code></td></tr><tr><td align="center">7</td><td align="center">6:2</td><td align="center"><code>ID_ACTIVE_MODE</code></td></tr><tr><td align="center">7</td><td align="center">1</td><td align="center"><code>ID_HOLIDAY_MODE_PENDING</code></td></tr><tr><td align="center">7</td><td align="center">0</td><td align="center"><code>ID_WINDOW_OPEN_STATUS</code></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

<details>

<summary>ID_STATUS_PARAM_TX_EN_REG</summary>

|   Eigenschaft  |                                                                                                                                                                                                           Wert                                                                                                                                                                                                           |
| :------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|  Beschreibung  |                                                                                                                                                                                    Aktiviert Parameter in der zyklischen Statusmeldung                                                                                                                                                                                   |
|      Größe     |                                                                                                                                                                                                           8 Bit                                                                                                                                                                                                          |
|  Wertebereich  |                                                                                                                                                                                                           0–255                                                                                                                                                                                                          |
|  Standardwert  |                                                                                                                                                                                                             7                                                                                                                                                                                                            |
| Interpretation | <p>0 = Parameter wird nicht gesendet, 1 = Parameter wird gesendet</p><p>Bit 0: <code>ID\_BATTERY\_VOLTAGE</code></p><p>Bit 1: <code>ID\_ROOM\_TEMPERATURE</code></p><p>Bit 2: <code>ID\_ROOM\_HUMIDITY</code></p><p>Bit 3: <code>ID\_SET\_POINT\_TEMPERATURE</code></p><p>Bit 4: <code>ID\_ACTIVE\_MODE</code> + <code>ID\_HOLIDAY\_MODE\_PENDING</code> + <code>ID\_WINDOW\_OPEN\_STATUS</code></p><p>Bit 5:7: Res.</p> |
|   Persistent   |                                                                                                                                                                                                            Ja                                                                                                                                                                                                            |
|     Zugriff    |                                                                                                                                                                                                            r/w                                                                                                                                                                                                           |

</details>

<details>

<summary>ID_BATTERY_VOLTAGE</summary>

|   Eigenschaft  |                 Wert                 |
| :------------: | :----------------------------------: |
|  Beschreibung  | Aktuelle Batteriespannung des Geräts |
|      Größe     |                 8 Bit                |
|  Wertebereich  |                 0–255                |
| Interpretation |    `y = x × 10 + 1500`, `[y] = mV`   |
|   Persistent   |                 Nein                 |
|     Zugriff    |                   r                  |

</details>

<details>

<summary>ID_ROOM_TEMPERATURE</summary>

|   Eigenschaft  |                                      Wert                                      |
| :------------: | :----------------------------------------------------------------------------: |
|  Beschreibung  |                             Aktuelle Raumtemperatur                            |
|      Größe     |                                      8 Bit                                     |
|  Wertebereich  |                                      0–450                                     |
| Interpretation | <p><code>0 - 449 → y = x × 0,1 °C</code></p><p><code>450 → overflow</code></p> |
|   Persistent   |                                      Nein                                      |
|     Zugriff    |                                        r                                       |

</details>

<details>

<summary>ID_ROOM_HUMIDITY</summary>

|   Eigenschaft  |              Wert             |
| :------------: | :---------------------------: |
|  Beschreibung  | Aktuelle relative Luftfeuchte |
|      Größe     |             8 Bit             |
|  Wertebereich  |             0–100             |
| Interpretation |            `y = x`            |
|   Persistent   |              Nein             |
|     Zugriff    |               r               |

</details>

<details>

<summary>ID_SET_POINT_TEMPRATURE</summary>

|   Eigenschaft  |           Wert          |
| :------------: | :---------------------: |
|  Beschreibung  |      Solltemperatur     |
|      Größe     |          8 Bit          |
|  Wertebereich  |          0–100          |
| Interpretation | `y = x * 0.5; [y] = °C` |
|   Persistent   |            Ja           |
|     Zugriff    |           r/w           |

</details>

<details>

<summary>ID_TEMPERATURE_TOO_LOW</summary>

|              Eigenschaft             |                                   Wert                                   |
| :----------------------------------: | :----------------------------------------------------------------------: |
|             Beschreibung             | <p>Die gemessene Raumtemperatur<br>unterschreitet die Solltemperatur für |
| <br>4 Stunden um mindestens 1 °C</p> |                                                                          |
|                 Größe                |                                   1 Bit                                  |
|             Wertebereich             |                                   0 - 1                                  |
|            Interpretation            |         <p>0 = Temperatur OK</p><p>1 = Temperatur zu niedrig</p>         |
|              Persistent              |                                   Nein                                   |
|                Zugriff               |                                     r                                    |

</details>

<details>

<summary>ID_ACTIVE_MODE</summary>

|   Eigenschaft  |                                                                                                                                                         Wert                                                                                                                                                         |
| :------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|  Beschreibung  |                                                                                                                                             Aktuell aktiver Betriebsmodus                                                                                                                                            |
|      Größe     |                                                                                                                                                         4 Bit                                                                                                                                                        |
|  Wertebereich  |                                                                                                                                                         0 - 7                                                                                                                                                        |
| Interpretation | <p><code>0</code> → Manueller Temperatur-Modus </p><p><code>1</code> → Automatik-Modus (Low-Power Zeitraum) </p><p><code>2</code> → Automatikmodus </p><p><code>3</code> → Urlaubs-Modus </p><p><code>4</code> → Emergency Modus </p><p><code>5,6</code> → Ungenutzt </p><p><code>7</code> → Fenster-offen-Modus</p> |
|   Persistent   |                                                                                                                                                         Nein                                                                                                                                                         |
|     Zugriff    |                                                                                                                                                           r                                                                                                                                                          |

</details>

<details>

<summary>ID_HOLIDAY_MODE_PENDING</summary>

<table><thead><tr><th align="center">Eigenschaft</th><th width="343.1875" align="center">Wert</th></tr></thead><tbody><tr><td align="center">Beschreibung</td><td align="center">Zustand, ob der Urlaubsmodus gestartet jedoch noch nicht aktiv ist</td></tr><tr><td align="center">Größe</td><td align="center">1 Bit</td></tr><tr><td align="center">Wertebereich</td><td align="center">0 - 1</td></tr><tr><td align="center">Standardwert</td><td align="center">-</td></tr><tr><td align="center">Interpretation</td><td align="center"><p>0 = Aktivierung ist nicht ausstehend</p><p>1 = Aktivierung ist ausstehend</p></td></tr><tr><td align="center">Persistent</td><td align="center">Nein</td></tr><tr><td align="center">Zugriff</td><td align="center">r</td></tr></tbody></table>

</details>

<details>

<summary>ID_WINDOW_OPEN_STATUS</summary>

<table><thead><tr><th align="center">Eigenschaft</th><th width="343.1875" align="center">Wert</th></tr></thead><tbody><tr><td align="center">Beschreibung</td><td align="center">Zustand der Fenster-Offen Erkennung</td></tr><tr><td align="center">Größe</td><td align="center">1</td></tr><tr><td align="center">Wertebereich</td><td align="center">0 - 1</td></tr><tr><td align="center">Standardwert</td><td align="center">-</td></tr><tr><td align="center">Interpretation</td><td align="center"><p>0 = Fenster ist geschlossen</p><p>1 = Fenster ist geöffnet</p></td></tr><tr><td align="center">Persistent</td><td align="center">Nein</td></tr><tr><td align="center">Zugriff</td><td align="center">r</td></tr></tbody></table>

</details>

***

## 2.4 Weitere Statusabfragen

{% tabs %}
{% tab title="GET BATTERY VOLTAGE" %}
Liest die Batteriespannung des Geräts aus.

**Downlink**

| Byte | Bit(s) |        Value        |
| :--: | :----: | :-----------------: |
|   0  |    7   |         `IR`        |
|   0  |   6:0  | `0x05` (Command ID) |

**Uplink**

|     Byte     | Bit(s) |         Value        |
| :----------: | :----: | :------------------: |
|       0      |    7   |         Res.         |
|       0      |   6:0  |  `0x05` (Command ID) |
|       1      |   7:0  | `ID_BATTERY_VOLTAGE` |
| {% endtab %} |        |                      |

{% tab title="GET ACTIVE MODE" %}
Liest den aktuell aktiven Betriebsmodus aus.

**Downlink**

| Byte | Bit(s) |        Value        |
| :--: | :----: | :-----------------: |
|   0  |    7   |         `IR`        |
|   0  |   6:0  | `0x06` (Command ID) |

**Uplink**

|     Byte     | Bit(s) |        Value        |
| :----------: | :----: | :-----------------: |
|       0      |    7   |         Res.        |
|       0      |   6:0  | `0x06` (Command ID) |
|       1      |   7:0  |   `ID_ACTIVE_MODE`  |
| {% endtab %} |        |                     |

{% tab title="GET ERROR CODE" %}
Liest den Fehlercode aus.

**Downlink**

| Byte | Bit(s) |        Value        |
| :--: | :----: | :-----------------: |
|   0  |    7   |         `IR`        |
|   0  |   6:0  | `0x07` (Command ID) |

**Uplink**

|      Byte     | Bit(s) |        Value        |
| :-----------: | :----: | :-----------------: |
|       0       |    7   |         Res.        |
|       0       |   6:0  | `0x07` (Command ID) |
|       1       |   7:0  |   `ID_ERROR_CODE`   |
|  {% endtab %} |        |                     |
| {% endtabs %} |        |                     |

<details>

<summary>ID_BATTERY_VOLTAGE</summary>

|   Eigenschaft  |                 Wert                 |
| :------------: | :----------------------------------: |
|  Besprecibung  | Aktuelle Batteriespannung des Geräts |
|      Größe     |                 8 Bit                |
|  Wertebereich  |                 0–255                |
| Interpretation |    `y = x * 10 + 1500`, `[y] = mV`   |
|   Persistent   |                 Nein                 |
|     Zugriff    |                   r                  |

</details>

<details>

<summary>ID_ERROR_CODE</summary>

|   Eigenschaft  |                               Wert                              |
| :------------: | :-------------------------------------------------------------: |
|      Größe     |                              8 Bit                              |
|  Wertebereich  |                               0–1                               |
|  Standardwert  |                                0                                |
| Interpretation | <p>0 = Kein Fehler </p><p>1 = Fehlfunktion Temperatursensor</p> |
|   Persistent   |                               Nein                              |
|     Zugriff    |                                r                                |

</details>

<details>

<summary>ID_ACTIVE_MODE</summary>

|   Eigenschaft  |                                                                                                                                                         Wert                                                                                                                                                         |
| :------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|  Beschreibung  |                                                                                                                                             Aktuell aktiver Betriebsmodus                                                                                                                                            |
|      Größe     |                                                                                                                                                         4 Bit                                                                                                                                                        |
|  Wertebereich  |                                                                                                                                                         0 - 7                                                                                                                                                        |
| Interpretation | <p><code>0</code> → Manueller Temperatur-Modus </p><p><code>1</code> → Automatik-Modus (Low-Power Zeitraum) </p><p><code>2</code> → Automatikmodus </p><p><code>3</code> → Urlaubs-Modus </p><p><code>4</code> → Emergency Modus </p><p><code>5,6</code> → Ungenutzt </p><p><code>7</code> → Fenster-offen-Modus</p> |
|   Persistent   |                                                                                                                                                         Nein                                                                                                                                                         |
|     Zugriff    |                                                                                                                                                           r                                                                                                                                                          |

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.dnt.de/dnt-lw-wth/kommunikationsprotokoll/2.-geratestatus.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
