From 57ac239258f93b5a6f9c1eac84f48ebc21097da1 Mon Sep 17 00:00:00 2001 From: Marvin Wichmann Date: Thu, 28 Feb 2019 19:18:06 +0100 Subject: [PATCH 1/2] KNX: Update docs - added rate_limit and target_temperature_state_address --- source/_components/climate.knx.markdown | 28 +++++++++++++++++++++---- source/_components/knx.markdown | 5 +++++ 2 files changed, 29 insertions(+), 4 deletions(-) diff --git a/source/_components/climate.knx.markdown b/source/_components/climate.knx.markdown index d121ed48283e..b25d43f21d33 100644 --- a/source/_components/climate.knx.markdown +++ b/source/_components/climate.knx.markdown @@ -27,7 +27,7 @@ climate: temperature_address: '5/1/1' setpoint_shift_address: '5/1/2' setpoint_shift_state_address: '5/1/3' - target_temperature_address: '5/1/4' + target_temperature_state_address: '5/1/4' operation_mode_address: '5/1/5' ``` @@ -41,17 +41,33 @@ climate: temperature_address: '5/1/1' setpoint_shift_address: '5/1/2' setpoint_shift_state_address: '5/1/3' + target_temperature_state_address: '5/1/4' + operation_mode_frost_protection_address: '5/1/5' + operation_mode_night_address: '5/1/6' + operation_mode_comfort_address: '5/1/7' +``` + +If your device doesn't support setpoint_shift calculations (i.e. if you don't provide a `setpoint_shift_address` value) please set the `min_temp` and `max_temp` +attributes of the climate device to avoid issues with increasing the temperature in the frontend. Please do also make sure to add the `target_temperature_address` +to the config in this case.: + +```yaml +# Example configuration.yaml entry +climate: + - platform: knx + name: HASS-Kitchen.Temperature + temperature_address: '5/1/2' target_temperature_address: '5/1/4' + target_temperature_state_address: '5/1/1' operation_mode_frost_protection_address: '5/1/5' operation_mode_night_address: '5/1/6' operation_mode_comfort_address: '5/1/7' + min_temp: 7.0 + max_temp: 32.0 ``` `operation_mode_frost_protection_address` / `operation_mode_night_address` / `operation_mode_comfort_address` are not necessary if `operation_mode_address` is specified. -If your device doesn't support setpoint_shift calculations (i.e. if you don't provide a `setpoint_shift_address` value) please set the `min_temp` and `max_temp` -attributes of the climate device to avoid issues with increasing the temperature in the frontend. - The following values are valid for the `operation_modes` attribute: - Comfort (maps internally to STATE_HEAT within Home Assistant) @@ -72,6 +88,10 @@ temperature_address: required: true type: string target_temperature_address: + description: KNX group address for setting target temperature. + required: false + type: string +target_temperature_state_address: description: KNX group address for reading current target temperature from KNX bus. required: true type: string diff --git a/source/_components/knx.markdown b/source/_components/knx.markdown index 9b5f00382553..0f0f34520ace 100644 --- a/source/_components/knx.markdown +++ b/source/_components/knx.markdown @@ -52,6 +52,11 @@ config_file: description: The path for XKNX configuration file. required: false type: string +rate_limit: + description: Defines the maximum number of telegrams to be sent to the bus per second. + required: false + default: 20 + type: integer range (1-100) {% endconfiguration %} If the auto detection of the KNX/IP device does not work you can specify ip/port of the tunneling device: From 590b4c6a6b47bad559afcedefb5f772998352400 Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Mon, 11 Mar 2019 20:23:10 +0100 Subject: [PATCH 2/2] :pencil2: Tweak --- source/_components/knx.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/knx.markdown b/source/_components/knx.markdown index 0f0f34520ace..037e506688e8 100644 --- a/source/_components/knx.markdown +++ b/source/_components/knx.markdown @@ -53,10 +53,10 @@ config_file: required: false type: string rate_limit: - description: Defines the maximum number of telegrams to be sent to the bus per second. + description: Defines the maximum number of telegrams to be sent to the bus per second (range 1-100). required: false default: 20 - type: integer range (1-100) + type: integer {% endconfiguration %} If the auto detection of the KNX/IP device does not work you can specify ip/port of the tunneling device: