> For the complete documentation index, see [llms.txt](https://docs.mclimate.eu/mclimate-lorawan-devices/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/vicki-lorawan-device-communication-protocol/open-window-detection.md).

# Open window detection

{% hint style="info" %}
The open window detection function works by looking for a sudden drop in temperature.

The detection algorithm takes readings every 1 minute, if the temperature dropped more than the threshold value, the valve is closed.

Therefore, it's not 100% reliable and can be affected by outdoor temperature, position of the device on the radiator, position of the radiator in the room and more factors.
{% endhint %}

{% hint style="warning" %}
If you are in "02 – Online automatic control mode with external temperature reading" mode the Vicki will use an external temperature reading. This will affect it Open window detection capabilities. It will still use its internal readings to determine whether or not the window has been opened, not the external temperature measurement.
{% endhint %}

## Open window commands with delta t 0.1 accuracy

{% hint style="warning" %}
These commands are only available for f.w. >= 4.2

For f.w. < 4.2, please use the command with accuracy 1.0 (described further below)
{% endhint %}

To detect an open window, the difference between the currently and previously measured temperatures must be equal or greater than a specified temperature difference. A new temperature value is obtained every minute.

{% tabs %}
{% tab title="SET" %}

<table data-header-hidden><thead><tr><th width="136.33333333333331">Byte index</th><th width="94">Bit index</th><th>Hex value - Meaning</th></tr></thead><tbody><tr><td><strong>Byte index</strong></td><td><strong>Bit index</strong></td><td><strong>Hex value - Meaning</strong></td></tr><tr><td>0</td><td>-</td><td>45 – The command will set Vicki open window detection parameters.</td></tr><tr><td>1</td><td>7:1</td><td>Reserved.</td></tr><tr><td>1</td><td>0</td><td><p>1 – Enable the open window detection functionality. </p><p>0 – Disable <strong>(Default).</strong></p></td></tr><tr><td>2</td><td>-</td><td>XX – Duration for the valve to stay closed after open window detection. Resolution – 5 minutes. Default duration is 10 minutes.</td></tr><tr><td>3</td><td>-</td><td>XX – Temperature difference to detect open window (in Celsius degrees), pre-multiplied by 10. <strong>Default is 1.0 Celsius.</strong><br><strong>Minimum value is 0.2 Celsius</strong></td></tr></tbody></table>

**Example command:** `0x4501060D`

`0x45` - Command code

`0x01` - Enable open window detection

`0x06` -> 06 x 5 \[resolution] = 30 minutes

`0x0D` -> 13 / 10 = 1.3 degrees

The command will Enable the open window detection and set the valve to be closed for 30 minutes if a delta of 1.3°C is reached.
{% endtab %}

{% tab title="GET" %}

<table data-header-hidden><thead><tr><th width="97">Byte index</th><th width="134">Sent request</th><th>Received response</th></tr></thead><tbody><tr><td><strong>Byte index</strong></td><td><strong>Sent request</strong></td><td><strong>Received response</strong></td></tr><tr><td>0</td><td>46 – Command code.</td><td>46 – The command code.</td></tr><tr><td>1</td><td></td><td>Bits [7:1] - Reserved</td></tr><tr><td>1</td><td></td><td><p>Bit 8: Open window detection enable/disable bit</p><ul><li>1: Open window functionality is enabled;</li><li>0: Open window functionality is disabled.</li></ul></td></tr><tr><td>2</td><td></td><td>XX – duration for the valve to be at the desired position, after open window detection. Resolution – 5 minutes. Default value is 2, meaning 10 minutes.</td></tr><tr><td>3</td><td></td><td>XX - Temperature delta with resolution 0.1 Celsius degrees. Value is premultiplied by 10.</td></tr></tbody></table>

**Example command:** `0x46`

**Example response:** `0x4601020F` - Enable the open-window detection, duration is `0x02` = 02\*5 = 10 minutes, delta is `0x0F` = 15/10 = 1.5 degrees Celsius
{% endtab %}
{% endtabs %}

## Open window commands with delta t 1.0 accuracy

To detect open window, the difference between the currently and previously measured temperatures must be equal or greater than specified temperature difference. New temperature value is obtained every minute.

{% tabs %}
{% tab title="SET" %}
{% hint style="warning" %}
In firmware versions >= 3.5, Vicki is fully closing the valve, regardless of the motorPosition defined in bytes 3 and 4 below.
{% endhint %}

<table data-header-hidden><thead><tr><th width="136.33333333333331">Byte index</th><th width="94">Bit index</th><th>Hex value - Meaning</th></tr></thead><tbody><tr><td><strong>Byte index</strong></td><td><strong>Bit index</strong></td><td><strong>Hex value - Meaning</strong></td></tr><tr><td>0</td><td>-</td><td>06 – The command will set Vicki open window detection parameters.</td></tr><tr><td>1</td><td>7:1</td><td>Reserved.</td></tr><tr><td>1</td><td>0</td><td>1 – Enable the open window detection functionality.<br>0 – Disable <strong>(Default)</strong>.</td></tr><tr><td>2</td><td>-</td><td><p>XX – Duration for the valve to stay closed after open window detection. Resolution – 5 minutes.</p><p><strong>Default: 10min.</strong></p></td></tr><tr><td>3</td><td>-</td><td>XX – motor position to be set when open window detected, bits 7:0.</td></tr><tr><td>4</td><td>7:4</td><td>X – motor position to be set when open window detected, bits 11:8.</td></tr><tr><td></td><td></td><td><strong>Default: 258 steps.</strong></td></tr><tr><td>4</td><td>3:0</td><td><p>X – temperature difference to detect open window  (in Celsius degrees).</p><p><strong>Default: 1 Celsius.</strong></p></td></tr></tbody></table>

**Example command 1:** `0x0601041C23`

`0x06` - Command code

`0x01` - Enable open window detection

`0x04` -> 04 x 5\[resolution] = 20 minutes

`0x1C` -> `00011100`

`0x23` -> `00100011`

`0011` -> 03 = 3 degrees

`001000011100` -> 540 = 540 steps

The command will Enable the open window detection and set the motor position to 450 steps for 20 minutes if a delta of 3°C is reached.

**Example command 2:** `0x0600041C23` – Disable open window detection.
{% endtab %}

{% tab title="GET" %}

<table data-header-hidden><thead><tr><th width="97">Byte index</th><th width="77">Bit index</th><th width="134">Sent request</th><th>Received response</th></tr></thead><tbody><tr><td><strong>Byte index</strong></td><td><strong>Bit index</strong></td><td><strong>Sent request</strong></td><td><strong>Received response</strong></td></tr><tr><td>0</td><td>-</td><td>13 – Command code.</td><td>13 – The command code.</td></tr><tr><td>1</td><td>7:1</td><td></td><td>Reserved;</td></tr><tr><td>1</td><td>0</td><td></td><td><p>Open window detection enable/disable bit:</p><ul><li>1: Open window functionality is enabled;</li><li>0: Open window functionality is disabled.</li></ul></td></tr><tr><td>2</td><td>-</td><td></td><td>XX – duration for the valve to be at the desired position, after open window detection. Resolution – 5 minutes.</td></tr><tr><td>3</td><td>-</td><td></td><td>XX – motor position to set when open window detected, bits 7:0.</td></tr><tr><td>4</td><td>7:4</td><td></td><td>X – motor position to set when open window detected, bits 11:8.</td></tr><tr><td>4</td><td>3:0</td><td></td><td>X – temperature difference to detect open window detection (In Celsius degrees).</td></tr></tbody></table>

**Example command 1:** `0x13`

**Example response 1:** `0x130102F412` – Open window detection functionality is enabled. When open window is detected, the motor will stay for 10 minutes on the specified position. Desired motor position is 500 steps. Open window will be detected when the temperature difference between the previously and currently measured temperatures become 2°C or greater.

**Example command 2:** `0x13`

**Example response 2:** `0x130002F412` – Open window detection functionality is disabled.
{% endtab %}
{% endtabs %}


---

# 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.mclimate.eu/mclimate-lorawan-devices/devices/mclimate-vicki-lorawan/vicki-lorawan-device-communication-protocol/open-window-detection.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.