Update documentation of KNX for dependency bump (#14567)

This commit is contained in:
Marvin Wichmann 2020-09-29 16:45:20 +02:00 committed by GitHub
parent 586e55a3ce
commit 530be6bc8c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -84,6 +84,21 @@ rate_limit:
required: false required: false
default: 20 default: 20
type: integer type: integer
individual_address:
description: The KNX individual address that shall be used for routing or if a tunnelling server doesn't assign an IA at connection.
required: false
type: string
default: "15.15.250"
multicast_group:
description: The multicast group to use for automatic interface discovery and routing communication.
required: false
type: string
default: "224.0.23.12"
multicast_port:
description: The port for multicast communication.
required: false
type: integer
default: 3671
{% endconfiguration %} {% endconfiguration %}
If the auto detection of the KNX/IP device does not work you can specify IP and port of the tunneling device: If the auto detection of the KNX/IP device does not work you can specify IP and port of the tunneling device:
@ -270,31 +285,50 @@ reset_after:
description: Reset back to OFF state after specified milliseconds. description: Reset back to OFF state after specified milliseconds.
required: false required: false
type: integer type: integer
context_timeout:
description: The time in seconds between multiple identical telegram payloads would count towards the internal counter that is used for automations. Ex. You have automations in place that trigger your lights on button press and another set of lights if you click that button twice. This setting defines the time that a second button press would count toward, so if you set this 3.0 you can take up to 3 seconds in order to trigger the second button press. Maximum value is 10.0.
required: false
type: float
default: 1.0
{% endconfiguration %} {% endconfiguration %}
### Automation actions ### Support for automations
You can also attach actions to binary sensors (e.g., to switch on a light when a switch was pressed). In this example, one light is switched on when the button was pressed once and two others when the button was pressed a second time. You can use a built in event in order to trigger an automation (e.g. to switch on a light when a switch was pressed).
Let's pretend you have a binary sensor with the name `Livingroom.Switch` and you want to switch one light on when the button was pressed once and two other lights when the button was pressed twice.
```yaml ```yaml
# Example configuration.yaml entry # Example automation.yaml entry
knx: automation:
binary_sensor: - trigger:
- name: Livingroom.3Switch3 platform: numeric_state
state_address: '5/0/26' entity_id: binary_sensor.Livingroom_Switch
automation: attribute: counter
- counter: 1 above: 0
hook: 'on' below: 2
action: condition:
- entity_id: light.hue_color_lamp_1 - condition: state
service: homeassistant.turn_on entity_id: binary_sensor.cover_abstell
- counter: 2 state: 'on'
hook: 'on' action:
action: - entity_id: light.hue_color_lamp_1
- entity_id: light.hue_bloom_1 service: light.turn_on
service: homeassistant.turn_on - trigger:
- entity_id: light.hue_bloom_2 platform: numeric_state
service: homeassistant.turn_on entity_id: binary_sensor.Livingroom_Switch
attribute: counter
above: 1
below: 3
condition:
- condition: state
entity_id: binary_sensor.cover_abstell
state: 'on'
action:
- entity_id: light.hue_bloom_1
service: homeassistant.turn_on
- entity_id: light.hue_bloom_2
service: homeassistant.turn_on
``` ```
{% configuration %} {% configuration %}
@ -1058,6 +1092,7 @@ knx:
address_brightness_south: "7/0/1" address_brightness_south: "7/0/1"
address_brightness_west: "7/0/2" address_brightness_west: "7/0/2"
address_brightness_east: "7/0/3" address_brightness_east: "7/0/3"
address_brightness_north: "7/0/11"
address_wind_speed: "7/0/4" address_wind_speed: "7/0/4"
address_rain_alarm: "7/0/5" address_rain_alarm: "7/0/5"
address_frost_alarm: "7/0/6" address_frost_alarm: "7/0/6"
@ -1091,6 +1126,10 @@ address_brightness_east:
description: KNX group address for reading current brightness to east coordinate from KNX bus. *DPT 9.004* description: KNX group address for reading current brightness to east coordinate from KNX bus. *DPT 9.004*
required: false required: false
type: string type: string
address_brightness_north:
description: KNX group address for reading current brightness to north coordinate from KNX bus. *DPT 9.004*
required: false
type: string
address_wind_speed: address_wind_speed:
description: KNX group address for reading current wind speed from KNX bus. *DPT 9.005* description: KNX group address for reading current wind speed from KNX bus. *DPT 9.005*
required: false required: false