> 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-etrv-c/kommunikationsprotokoll/2.-geratestatus.md).

# 2. Gerätestatus

## 2.1 Status-Intervall

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

**Beispiel**

```
0109h = 5 Min. Statusintervall
```

<table><thead><tr><th align="center">Byte</th><th width="205.636474609375" 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 %}

{% 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="203.8182373046875" 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">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 |            <p><code>y = x \* 30 + 30</code></p><p><code>\[y] = s</code></p>           |
|   Persistent   |                                           Ja                                          |
|     Zugriff    |                                          r/w                                          |

</details>

***

## 2.2 Status-Parameter-TX-Enable-Register

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

**Beispiel:**

```
03F0h = Batteriespannung, Raumtemperatur, Solltemperatur und Ventilposition aktiv
```

<table><thead><tr><th align="center">Byte</th><th width="208.3636474609375" 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 %}

{% 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="203.8182373046875" 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 %}
{% endtabs %}

<details>

<summary>ID_STATUS_PARAM_TX_EN_REG</summary>

<table><thead><tr><th width="221.58160400390625" align="center">Eigenschaft</th><th width="454.0963134765625" align="center">Wert</th></tr></thead><tbody><tr><td align="center">Beschreibung</td><td align="center">Konfiguration, welche Parameter in der zyklischen Statusmeldung <code>GET STATUS (0x04)</code> gesendet werden.</td></tr><tr><td align="center">Größe</td><td align="center">8 Bit</td></tr><tr><td align="center">Wertebereich</td><td align="center">0–255</td></tr><tr><td align="center">Standardwert</td><td align="center">228</td></tr><tr><td align="center">Interpretation</td><td align="center"><p><code>1</code> = Parameter wird gesendet, <code>0</code> = Parameter wird nicht gesendet</p><p>Bit 7: <code>ID_BATTERY_VOLTAGE</code><br>Bit 6: <code>ID_CONTROLLER_INPUT_ROOM_TEMPERATURE</code><br>Bit 5: <code>ID_CONTROLLER_INPUT_SET_POINT_TEMPERATURE</code><br>Bit 4: <code>ID_VALVE_POSITION</code></p><p>Bit 3: <code>ID_CONTROLLER_INPUT_P_GAIN &#x26; ID_CONROLLER_I_GAIN</code></p><p>Bit 2: <code>ID_ACTIVE_MODE</code>, <code>ID_HOLIDAY_MODE_PENDING</code>, <code>ID_WINDOW_OPEN_STATUS</code></p><p>Bit 1-0: Res.</p></td></tr><tr><td align="center">Persistent</td><td align="center">Ja</td></tr><tr><td align="center">Zugriff</td><td align="center">r/w</td></tr></tbody></table>

</details>

***

## 2.3 Status

{% tabs %}
{% tab title="GET STATUS" %}
Liest die aktuelle Statusmeldung des Geräts aus. Wird zyklisch vom Gerät im definierten Intervall gesendet (s. [#set-status-interval](#set-status-interval "mention")).

**Downlink**

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

**Uplink**

<table><thead><tr><th width="121.6363525390625" align="center">Byte</th><th width="187.0001220703125" 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"><code>Res.</code></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_CONTROLLER_INPUT_ROOM_TEMPERATURE [H]</code></td></tr><tr><td align="center">4</td><td align="center">7:0</td><td align="center"><code>ID_CONTROLLER_INPUT_ROOM_TEMPERATURE [L]</code></td></tr><tr><td align="center">5</td><td align="center">7:0</td><td align="center"><code>ID_CONTROLLER_INPUT_SET_POINT_TEMPERATURE</code></td></tr><tr><td align="center">6</td><td align="center">7:0</td><td align="center"><code>ID_VALVE_POSITION</code></td></tr><tr><td align="center">7</td><td align="center">7:0</td><td align="center"><code>ID_CONTROLLER_INPUT_P_GAIN[15:8]</code></td></tr><tr><td align="center">8</td><td align="center">7:0</td><td align="center"><code>ID_CONTROLLER_INPUT_P_GAIN[7:0]</code></td></tr><tr><td align="center">9</td><td align="center">7:0</td><td align="center"><code>ID_CONTROLLER_INPUT_I_GAIN</code></td></tr><tr><td align="center">10</td><td align="center">7:5</td><td align="center"><code>ID_ACTIVE_MODE</code></td></tr><tr><td align="center">10</td><td align="center">4</td><td align="center"><code>ID_HOLIDAY_MODE_PENDING</code></td></tr><tr><td align="center">10</td><td align="center">3</td><td align="center"><code>ID_WINDOW_OPEN_STATUS</code></td></tr><tr><td align="center">10</td><td align="center">2:0</td><td align="center">Res.</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

<details>

<summary>ID_STATUS_PARAM_TX_EN_REG</summary>

<table><thead><tr><th width="221.58160400390625" align="center">Eigenschaft</th><th width="454.0963134765625" align="center">Wert</th></tr></thead><tbody><tr><td align="center">Beschreibung</td><td align="center">Konfiguration, welche Parameter in der zyklischen Statusmeldung <code>GET STATUS (0x04)</code> gesendet werden.</td></tr><tr><td align="center">Größe</td><td align="center">8 Bit</td></tr><tr><td align="center">Wertebereich</td><td align="center">0–255</td></tr><tr><td align="center">Standardwert</td><td align="center">228</td></tr><tr><td align="center">Interpretation</td><td align="center"><p><code>1</code> = Parameter wird gesendet, <code>0</code> = Parameter wird nicht gesendet</p><p>Bit 7: <code>ID_BATTERY_VOLTAGE</code><br>Bit 6: <code>ID_CONTROLLER_INPUT_ROOM_TEMPERATURE</code><br>Bit 5: <code>ID_CONTROLLER_INPUT_SET_POINT_TEMPERATURE</code><br>Bit 4: <code>ID_VALVE_POSITION</code></p><p>Bit 3: <code>ID_CONTROLLER_INPUT_P_GAIN &#x26; ID_CONROLLER_I_GAIN</code></p><p>Bit 2: <code>ID_ACTIVE_MODE</code>, <code>ID_HOLIDAY_MODE_PENDING</code>, <code>ID_WINDOW_OPEN_STATUS</code></p><p>Bit 1-0: Res.</p></td></tr><tr><td align="center">Persistent</td><td align="center">Ja</td></tr><tr><td align="center">Zugriff</td><td align="center">r/w</td></tr></tbody></table>

</details>

<details>

<summary>ID_BATTERY_VOLTAGE</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">Aktuelle Batteriespannung des Gerätes.</td></tr><tr><td align="center">Größe</td><td align="center">8 Bit</td></tr><tr><td align="center">Wertebereich</td><td align="center">0 - 255</td></tr><tr><td align="center">Standardwert</td><td align="center">-</td></tr><tr><td align="center">Interpretation</td><td align="center"><p><code>y = x * 10 + 1500</code></p><p><code>[y] = mV</code></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_CONTROLLER_INPUT_ROOM_TEMPERATURE</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">Aktuelle Raumtemperatur, die von der Regelung verwendet wird.</td></tr><tr><td align="center">Größe</td><td align="center">16 Bit</td></tr><tr><td align="center">Wertebereich</td><td align="center">0 - 451</td></tr><tr><td align="center">Standardwert</td><td align="center">-</td></tr><tr><td align="center">Interpretation</td><td align="center"><p><code>x = 0</code> → underflow<br><code>x = 1 - 450</code><br><code>y = x * 0,1</code></p><p><code>[y] = °C</code><br><code>x = 451</code> → overflow</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_CONTROLLER_INPUT_SET_POINT_TEMPERATURE</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">Aktuelle Solltemperatur, die von der Regelung verwendet wird.</td></tr><tr><td align="center">Größe</td><td align="center">8 Bit</td></tr><tr><td align="center">Wertebereich</td><td align="center">10 - 60</td></tr><tr><td align="center">Standardwert</td><td align="center">10</td></tr><tr><td align="center">Interpretation</td><td align="center"><p><code>y = x * 0,5</code></p><p><code>[y] = °C</code></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_VALVE_POSITION</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">Aktuelle Ventilposition inklusive Ventiloffset.</td></tr><tr><td align="center">Größe</td><td align="center">8 Bit</td></tr><tr><td align="center">Wertebereich</td><td align="center">0 - 200</td></tr><tr><td align="center">Standardwert</td><td align="center">-</td></tr><tr><td align="center">Interpretation</td><td align="center"><p><code>y = x * 0,5</code></p><p><code>[y] = %</code></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_CONTROLLER_INPUT_P_GAIN</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">Vom Regler verwendete P-Verstärkung</td></tr><tr><td align="center">Größe</td><td align="center">16 Bit</td></tr><tr><td align="center">Wertebereich</td><td align="center">720 - 4100</td></tr><tr><td align="center">Standardwert</td><td align="center">-</td></tr><tr><td align="center">Interpretation</td><td align="center"><code>y = x</code></td></tr><tr><td align="center">Persistent</td><td align="center">Ja</td></tr><tr><td align="center">Zugriff</td><td align="center">r</td></tr></tbody></table>

</details>

<details>

<summary>ID_CONTROLLER_INPUT_I_GAIN</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">Vom Regler verwendete I-Verstärkung</td></tr><tr><td align="center">Größe</td><td align="center">8 Bit</td></tr><tr><td align="center">Wertebereich</td><td align="center">17 - 167</td></tr><tr><td align="center">Standardwert</td><td align="center">-</td></tr><tr><td align="center">Interpretation</td><td align="center"><code>y = x / 1000000</code></td></tr><tr><td align="center">Persistent</td><td align="center">Ja</td></tr><tr><td align="center">Zugriff</td><td align="center">r</td></tr></tbody></table>

</details>

<details>

<summary>ID_ACTIVE_MODE</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">Aktuell aktiver Betriebsmodus</td></tr><tr><td align="center">Größe</td><td align="center">3 Bit</td></tr><tr><td align="center">Wertebereich</td><td align="center">0 - 7</td></tr><tr><td align="center">Standardwert</td><td align="center">0</td></tr><tr><td align="center">Interpretation</td><td align="center">0 = Manueller Temperaturmodus <br>1 = Manueller Positioniermodus <br>2 = Automatikmodus <br>3 = Emergency Modus <br>4 = Frostschutzmodus <br>5 = Boost Modus <br>6 = Fenster-Offen-Modus <br>7 = Urlaubsmodus</td></tr><tr><td align="center">Persistent</td><td align="center">Ja</td></tr><tr><td align="center">Zugriff</td><td align="center">r</td></tr></tbody></table>

</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">0 = Aktivierung ist nicht ausstehend<br>1 = Aktivierung ist ausstehend</td></tr><tr><td align="center">Persistent</td><td align="center">Ja</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">0 = Fenster ist geschlossen <br>1 = Fenster ist geöffnet</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_BATTERY_COVER_LOCK_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">Stellung des Batteriefachschlosses</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">0 = Batteriefach nicht abgeschlossen <br>1 = Batteriefach abgeschlossen</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 Batteryspannung

{% tabs %}
{% tab title="GET BATTERY VOLTAGE" %}
Liest die Batteriespannung des Gerätes 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 %} |        |                      |
| {% endtabs %} |        |                      |

<details>

<summary>ID_BATTERY_VOLTAGE</summary>

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

</details>

***

## 2.4 Error Code

{% tabs %}
{% tab title="GET ERROR CODE" %}
Liest den Fehlercode des Gerätes aus. Der Fehlercode wird bei Fehlern auch automatisch gesendet.

**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_ERROR_CODE</summary>

|   Eigenschaft  |                                                    Wert                                                   |
| :------------: | :-------------------------------------------------------------------------------------------------------: |
|      Größe     |                                                   8 Bit                                                   |
|  Wertebereich  |                                                    0–5                                                    |
|  Standardwert  |                                                     0                                                     |
| Interpretation | s. [8.10 Fehlercodes](/dnt-lw-etrv-c/funktion-and-gerateubersicht/8.-gerateverhalten/8.10-fehlercodes.md) |
|   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-etrv-c/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.
