> 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/kommunikationsprotokoll/6.-konfiguration-des-ventils.md).

# 6. Konfiguration des Ventils

## 6.1 Aktuelle Ventilsollposition

{% tabs %}
{% tab title="GET VALVE POSITION" %}
Abfrage der aktuellen Ventilposition des Gerätes.

**Downlink**

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

**Uplink**

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

<details>

<summary>ID_VALVE_POSITION</summary>

|   Eigenschaft  |                             Wert                             |
| :------------: | :----------------------------------------------------------: |
|  Beschreibung  |        Aktuelle Ventilposition inklusive Ventiloffset.       |
|      Größe     |                             8 Bit                            |
|  Wertebereich  |                            0 - 200                           |
|  Standardwert  |                               -                              |
| Interpretation | <p><code>y = x \* 0,5</code></p><p><code>\[y] = %</code></p> |
|   Persistent   |                             Nein                             |
|     Zugriff    |                               r                              |

</details>

***

## 6.2 Soll-Ventilposition

{% tabs %}
{% tab title="GET VALVE SET-POINT POSITION" %}
Abfrage der Soll-Ventilposition im manuellen Positioniermodus.

**Downlink**

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

**Uplink**

<table><thead><tr><th width="154.8182373046875" align="center">Byte</th><th width="122.9091796875" 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>0x19</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_VALVE_POSITION_SET_POINT</code></td></tr></tbody></table>
{% endtab %}

{% tab title="SET VALVE SET-POINT POSITION" %}
Konfiguration der Soll-Ventilposition im manuellen Positioniermodus.

**Beispiel**

```
1A64h = 50,0 % Soll-Ventilposition
```

<table><thead><tr><th width="134" align="center">Byte</th><th width="131.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>0x1A</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_VALVE_POSITION_SET_POINT</code></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

<details>

<summary>ID_VALVE_POSITION_SET_POINT</summary>

|   Eigenschaft  |                                   Wert                                  |
| :------------: | :---------------------------------------------------------------------: |
|  Beschreibung  | Soll-Ventilstellung, die im manuellen Positioniermodus angefahren wird. |
|      Größe     |                                  8 Bit                                  |
|  Wertebereich  |                                 0 - 200                                 |
|  Standardwert  |                                    0                                    |
| Interpretation |                        `y = x * 0,5` — `[y] = %`                        |
|   Persistent   |                                    Ja                                   |
|     Zugriff    |                                   r/w                                   |

</details>

***

## 6.3 Ventiloffset

{% tabs %}
{% tab title="GET VALVE OFFSET" %}
Abfrage des Ventiloffsets.

**Downlink**

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

**Uplink**

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

{% tab title="SET VALVE OFFSET" %}
Konfiguration des Ventiloffsets.

**Beispiel**

```
1C14h = 10,0 % Ventiloffset
```

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

<details>

<summary>ID_VALVE_OFFSET</summary>

|   Eigenschaft  |                             Wert                             |
| :------------: | :----------------------------------------------------------: |
|  Beschreibung  |                  Offset der Ventilposition.                  |
|      Größe     |                             8 Bit                            |
|  Wertebereich  |                            0 - 200                           |
|  Standardwert  |                               0                              |
| Interpretation | <p><code>y = x \* 0,5</code></p><p><code>\[y] = %</code></p> |
|   Persistent   |                              Ja                              |
|     Zugriff    |                              r/w                             |

</details>

***

## 6.4 Maximale Ventilposition

{% tabs %}
{% tab title="GET VALVE MAXIMUM POSITION" %}
Abfrage der maximalen Ventilposition.

**Downlink**

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

**Uplink**

<table><thead><tr><th width="190.3636474609375" align="center">Byte</th><th width="122.0909423828125" 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>0x1D</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_VALVE_POSITION_MAX</code></td></tr></tbody></table>
{% endtab %}

{% tab title="SET VALVE MAXIMUM POSITION" %}
Setzen der maximalen Ventilposition.

**Beispiel**

```
1EA0h = 80,0 % maximale Ventilposition
```

<table><thead><tr><th width="177.8182373046875" align="center">Byte</th><th width="118.4544677734375" 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>0x1E</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_VALVE_POSITION_MAX</code></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

<details>

<summary>ID_VALVE_POSITION_MAX</summary>

|   Eigenschaft  |                             Wert                             |
| :------------: | :----------------------------------------------------------: |
|  Beschreibung  |    Maximale Position, bis zu der das Ventil geöffnet wird.   |
|      Größe     |                             8 Bit                            |
|  Wertebereich  |                            0 - 200                           |
|  Standardwert  |                              200                             |
| Interpretation | <p><code>y = x \* 0,5</code></p><p><code>\[y] = %</code></p> |
|   Persistent   |                              Ja                              |
|     Zugriff    |                              r/w                             |

</details>

***

## 6.5 Ventilposition im Notbetrieb

{% tabs %}
{% tab title="GET VALVE EMERGENCY POSITION" %}
Abfrage der Ventilposition für den Notbetrieb.

**Downlink**

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

**Uplink**

<table><thead><tr><th width="145.727294921875" align="center">Byte</th><th width="124.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>0x1F</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_VALVE_POSITION_EMERGENCY</code></td></tr></tbody></table>
{% endtab %}

{% tab title="SET VALVE EMERGENCY POSITION" %}
Setzen der Ventilposition für den Notbetrieb.

**Beispiel**

```
2028h = 20,0 % Ventilposition im Notbetrieb
```

<table><thead><tr><th width="158.54541015625" align="center">Byte</th><th width="122.0909423828125" 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>0x20</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7:0</td><td align="center"><code>ID_VALVE_POSITION_EMERGENCY</code></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

<details>

<summary>ID_VALVE_POSITION_EMERGENCY</summary>

|   Eigenschaft  |                             Wert                             |
| :------------: | :----------------------------------------------------------: |
|  Beschreibung  |   Ventilposition, die das Gerät im Emergency-Modus anfährt.  |
|      Größe     |                             8 Bit                            |
|  Wertebereich  |                            0 - 200                           |
|  Standardwert  |                              40                              |
| Interpretation | <p><code>y = x \* 0,5</code></p><p><code>\[y] = %</code></p> |
|   Persistent   |                              Ja                              |
|     Zugriff    |                              r/w                             |

</details>

***

## 6.6 Adaptions- und Entkalkungsfahrt

{% tabs %}
{% tab title="PERFORM ADAPTION RUN" %}
Starten einer Adaptionsfahrt.

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

{% tab title="PERFORM DECALCIFICATION" %}
Starten einer Entkalkungsfahrt.

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

***

## 6.7 Konfiguration der Entkalkungsfahrt

{% hint style="info" %} <mark style="color:green;">Vor Firmware Version 1.3.0 wird die Entkalkungsfahrt monatlich durchgeführt</mark>
{% endhint %}

### 6.7.1 Firmware ≥ 1.3.0

{% tabs %}
{% tab title="GET DECALCIFICATION CONFIG" %}
Abfrage des Zeitpunkts der wöchentlichen Entkalkungsfahrt.

**Downlink**

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

**Uplink**

<table><thead><tr><th width="108.54541015625" align="center">Byte</th><th width="179.272705078125" 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>0x32</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">1</td><td align="center">6:4</td><td align="center"><code>ID_DECALCIFICATION_TIME_WEEKDAY</code></td></tr><tr><td align="center">1</td><td align="center">3:1</td><td align="center">Res.</td></tr><tr><td align="center">1</td><td align="center">0</td><td align="center"><code>ID_DECALCIFICATION_TIME_HOUR[4]</code></td></tr><tr><td align="center">2</td><td align="center">7:4</td><td align="center"><code>ID_DECALCIFICATION_TIME_HOUR[3:0]</code></td></tr><tr><td align="center">2</td><td align="center">3:0</td><td align="center"><code>ID_DECALCIFICATION_TIME_MINUTE</code></td></tr></tbody></table>
{% endtab %}

{% tab title="SET DECALCIFICATION CONFIG" %}
Konfiguration des Zeitpunkts der wöchentlichen Entkalkungsfahrt.

**Beispiel**

```
335AC6h = Entkalkungsfahrt jeden Freitag um 12:30
```

<table><thead><tr><th width="155.4544677734375" align="center">Byte</th><th width="184" 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>0x33</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">1</td><td align="center">6:4</td><td align="center"><code>ID_DECALCIFICATION_TIME_WEEKDAY</code></td></tr><tr><td align="center">1</td><td align="center">3:1</td><td align="center"><code>0x01</code></td></tr><tr><td align="center">1</td><td align="center">0</td><td align="center"><code>ID_DECALCIFICATION_TIME_HOUR[4]</code></td></tr><tr><td align="center">2</td><td align="center">7:0</td><td align="center"><code>ID_DECALCIFICATION_TIME_HOUR[3:0]</code></td></tr><tr><td align="center">2</td><td align="center">3:0</td><td align="center"><code>ID_DECALCIFICATION_TIME_MINUTE</code></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

<details>

<summary>ID_DECALCIFICATION_TIME_WEEKDAY</summary>

|   Eigenschaft  |                                                                                                              Wert                                                                                                             |
| :------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|  Beschreibung  |                                                                                         Wochentag der wöchentlichen Entkalkungsfahrt.                                                                                         |
|      Größe     |                                                                                                             3 Bit                                                                                                             |
|  Wertebereich  |                                                                                                             0 - 6                                                                                                             |
|  Standardwert  |                                                                                                               1                                                                                                               |
| Interpretation | <p><code>1</code> → Montag</p><p><code>2</code> → Dienstag</p><p><code>3</code> → Mittwoch</p><p><code>4</code> → Donnerstag</p><p><code>5</code> → Freitag</p><p><code>6</code> → Samstag</p><p><code>0</code> → Sonntag</p> |
|   Persistent   |                                                                                                               Ja                                                                                                              |
|     Zugriff    |                                                                                                              r/w                                                                                                              |

</details>

<details>

<summary>ID_DECALCIFICATION_TIME_HOUR</summary>

|   Eigenschaft  |                          Wert                         |
| :------------: | :---------------------------------------------------: |
|  Beschreibung  |       Stunde der wöchentlichen Entkalkungsfahrt.      |
|      Größe     |                         5 Bit                         |
|  Wertebereich  |                         0 - 23                        |
|  Standardwert  |                           12                          |
| Interpretation | <p><code>y = x</code></p><p><code>\[y] = h</code></p> |
|   Persistent   |                           Ja                          |
|     Zugriff    |                          r/w                          |

</details>

<details>

<summary>ID_DECALCIFICATION_TIME_MINUTE</summary>

|   Eigenschaft  |                             Wert                             |
| :------------: | :----------------------------------------------------------: |
|  Beschreibung  |          Minute der wöchentlichen Entkalkungsfahrt.          |
|      Größe     |                             4 Bit                            |
|  Wertebereich  |                            0 - 11                            |
|  Standardwert  |                               0                              |
| Interpretation | <p><code>y = x \* 5</code></p><p><code>\[y] = min</code></p> |
|   Persistent   |                              Ja                              |
|     Zugriff    |                              r/w                             |

</details>

### 6.7.2 Firmware < 1.3.0

{% tabs %}
{% tab title="GET DECALCIFICATION CONFIG" %}
Abfrage des Zeitpunkts der monatlichen Entkalkungsfahrt.

**Downlink**

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

**Uplink**

<table><thead><tr><th width="87.54541015625" align="center">Byte</th><th width="108.272705078125" 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>0x32</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">1</td><td align="center">6:4</td><td align="center"><code>ID_DECALCIFICATION_TIME_WEEKDAY</code></td></tr><tr><td align="center">1</td><td align="center">3:1</td><td align="center"><code>ID_DECALCIFICATION_TIME_WEEK_OF_MONTH</code></td></tr><tr><td align="center">1</td><td align="center">0</td><td align="center"><code>ID_DECALCIFICATION_TIME_HOUR[4]</code></td></tr><tr><td align="center">2</td><td align="center">7:4</td><td align="center"><code>ID_DECALCIFICATION_TIME_HOUR[3:0]</code></td></tr><tr><td align="center">2</td><td align="center">3:0</td><td align="center"><code>ID_DECALCIFICATION_TIME_MINUTE</code></td></tr></tbody></table>
{% endtab %}

{% tab title="SET DECALCIFICATION CONFIG" %}
Konfiguration des Zeitpunkts der monatlichen Entkalkungsfahrt.

**Beispiel**

```
335AC6h = Entkalkungsfahrt am letzten Freitag des Monats um 12:30
```

<table><thead><tr><th width="98.4544677734375" align="center">Byte</th><th width="83" 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>0x33</code> (Command ID)</td></tr><tr><td align="center">1</td><td align="center">7</td><td align="center">Res.</td></tr><tr><td align="center">1</td><td align="center">6:4</td><td align="center"><code>ID_DECALCIFICATION_TIME_WEEKDAY</code></td></tr><tr><td align="center">1</td><td align="center">3:1</td><td align="center"><code>ID_DECALCIFICATION_TIME_WEEK_OF_MONTH</code></td></tr><tr><td align="center">1</td><td align="center">0</td><td align="center"><code>ID_DECALCIFICATION_TIME_HOUR[4]</code></td></tr><tr><td align="center">2</td><td align="center">7:0</td><td align="center"><code>ID_DECALCIFICATION_TIME_HOUR[3:0]</code></td></tr><tr><td align="center">2</td><td align="center">3:0</td><td align="center"><code>ID_DECALCIFICATION_TIME_MINUTE</code></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

<details>

<summary>ID_DECALCIFICATION_TIME_WEEKDAY</summary>

|   Eigenschaft  |                                                                                                              Wert                                                                                                             |
| :------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|  Beschreibung  |                                                                                          Wochentag der monatlichen Entkalkungsfahrt.                                                                                          |
|      Größe     |                                                                                                             3 Bit                                                                                                             |
|  Wertebereich  |                                                                                                             0 - 6                                                                                                             |
|  Standardwert  |                                                                                                               1                                                                                                               |
| Interpretation | <p><code>1</code> → Montag</p><p><code>2</code> → Dienstag</p><p><code>3</code> → Mittwoch</p><p><code>4</code> → Donnerstag</p><p><code>5</code> → Freitag</p><p><code>6</code> → Samstag</p><p><code>0</code> → Sonntag</p> |
|   Persistent   |                                                                                                               Ja                                                                                                              |
|     Zugriff    |                                                                                                              r/w                                                                                                              |

</details>

<details>

<summary>ID_DECALCIFICATION_TIME_WEEK_OF_MONTH</summary>

|   Eigenschaft  |                                                                                 Wert                                                                                 |
| :------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|  Beschreibung  |                                                              Woche des Monats für die Entkalkungsfahrt.                                                              |
|      Größe     |                                                                                 3 Bit                                                                                |
|  Wertebereich  |                                                                                 1 - 5                                                                                |
|  Standardwert  |                                                                                   1                                                                                  |
| Interpretation | <p><code>1</code> → 1. Woche</p><p><code>2</code> → 2. Woche</p><p><code>3</code> → 3. Woche</p><p><code>4</code> → 4. Woche</p><p><code>5</code> → letzte Woche</p> |
|   Persistent   |                                                                                  Ja                                                                                  |
|     Zugriff    |                                                                                  r/w                                                                                 |

</details>

<details>

<summary>ID_DECALCIFICATION_TIME_HOUR</summary>

|   Eigenschaft  |                          Wert                         |
| :------------: | :---------------------------------------------------: |
|  Beschreibung  |        Stunde der monatlichen Entkalkungsfahrt.       |
|      Größe     |                         5 Bit                         |
|  Wertebereich  |                         0 - 23                        |
|  Standardwert  |                           12                          |
| Interpretation | <p><code>y = x</code></p><p><code>\[y] = h</code></p> |
|   Persistent   |                           Ja                          |
|     Zugriff    |                          r/w                          |

</details>

<details>

<summary>ID_DECALCIFICATION_TIME_MINUTE</summary>

|   Eigenschaft  |                             Wert                             |
| :------------: | :----------------------------------------------------------: |
|  Beschreibung  |           Minute der monatlichen Entkalkungsfahrt.           |
|      Größe     |                             4 Bit                            |
|  Wertebereich  |                            0 - 11                            |
|  Standardwert  |                               0                              |
| Interpretation | <p><code>y = x \* 5</code></p><p><code>\[y] = min</code></p> |
|   Persistent   |                              Ja                              |
|     Zugriff    |                              r/w                             |

</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/kommunikationsprotokoll/6.-konfiguration-des-ventils.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.
