Skip to content

Commit 2be4e2d

Browse files
Julius2342balloob
authored andcommitted
Improvement of KNX climate component (home-assistant#3903)
* Documentation for home-assistant/core#10388 * added note that the knx plattform is not supported on Windows. Reason: HAss on windows uses asyncio.ProactorEventLoop() which has poor UDP support. See related issue: home-assistant/core#6820 * ✏️ Fixed note markup
1 parent af29799 commit 2be4e2d

File tree

2 files changed

+26
-13
lines changed

2 files changed

+26
-13
lines changed

source/_components/climate.knx.markdown

+22-13
Original file line numberDiff line numberDiff line change
@@ -25,10 +25,11 @@ To use your KNX thermostats in your installation, add the following lines to you
2525
climate:
2626
- platform: knx
2727
name: HASS-Kitchen.Temperature
28-
temperature_address: '6/2/1'
29-
setpoint_address: '5/1/2'
30-
target_temperature_address: '5/1/1'
31-
operation_mode_address: '5/1/3'
28+
temperature_address: '5/1/1'
29+
setpoint_shift_address: '5/1/2'
30+
setpoint_shift_state_address: '5/1/3'
31+
target_temperature_address: '5/1/4'
32+
operation_mode_address: '5/1/5'
3233
```
3334
3435
Alternatively, if your device has dedicated binary group addresses for frost/night/comfort mode:
@@ -38,20 +39,30 @@ Alternatively, if your device has dedicated binary group addresses for frost/nig
3839
climate:
3940
- platform: knx
4041
name: HASS-Kitchen.Temperature
41-
temperature_address: '6/2/1'
42-
setpoint_address: '5/1/2'
43-
target_temperature_address: '5/1/1'
44-
operation_mode_frost_protection_address: '5/1/3'
45-
operation_mode_night_address: '5/1/4'
46-
operation_mode_comfort_address: '5/1/5'
42+
temperature_address: '5/1/1'
43+
setpoint_shift_address: '5/1/2'
44+
setpoint_shift_state_address: '5/1/3'
45+
target_temperature_address: '5/1/4'
46+
operation_mode_frost_protection_address: '5/1/5'
47+
operation_mode_night_address: '5/1/6'
48+
operation_mode_comfort_address: '5/1/7'
4749
```
4850
4951
Configuration variables:
5052
5153
- **name** (*Optional*): A name for this device used within Home Assistant.
5254
- **temperature_address**: KNX group address for reading current room temperature from KNX bus.
5355
- **target_temperature_address**: KNX group address for reading current target temperature from KNX bus.
54-
- **setpoint_address**: KNX group address for basis setpoint
56+
57+
The `knx` component sets the desired target temperature by modifying the setpoint_shift. The module provides the following configuration options:
58+
59+
* **setpoint_shift_address**: (*Optional*) KNX address for setpoint_shift
60+
* **setpoint_shift_state_address**: (*Optional*) Explicit KNX address for reading setpoint_shift.
61+
* **setpoint_shift_step**: (*Optional*) Defines for step size in Kelvin for each step of setpoint_shift. Default is 0.5 K.
62+
* **setpoint_shift_min**: (*Optional*) Minimum value of setpoint shift. Default is "-6".
63+
* **setpoint_shift_max**: (*Optional*) Maximum value of setpoint shift. Default is "6".
64+
65+
The operation modes may be controlled with the following directives:
5566

5667
- **operation_mode_address** (*Optional*): KNX address for operation mode (Frost protection/night/comfort).
5768
- **operation_mode_state_address** (*Optional*): Explicit KNX address for reading operation mode
@@ -63,5 +74,3 @@ Configuration variables:
6374
- **operation_mode_comfort_address** (*Optional*): KNX address for switching on/off comfort mode.
6475

6576
`operation_mode_frost_protection_address` / `operation_mode_night_address` / `operation_mode_comfort_address` are not necessary if `operation_mode_address` was specified.
66-
67-

source/_components/knx.markdown

+4
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,10 @@ The [KNX](http://www.knx.org) integration for Home Assistant allows you to conne
1818

1919
The component requires a local KNX/IP interface like the [Weinzierl 730](http://www.weinzierl.de/index.php/en/all-knx/knx-devices-en/knx-ip-interface-730-en). Through this, it will send and receive commands to and from other devices to the KNX bus.
2020

21+
<p class='note warning'>
22+
Please note, the `knx` platform does not support Windows and needs at least python version 3.5.
23+
</p>
24+
2125
There is currently support for the following device types within Home Assistant:
2226

2327
- [Binary Sensor](/components/binary_sensor.knx)

0 commit comments

Comments
 (0)