home-assistant.io/source/_components/binary_sensor.knx.markdown
Franck Nijhof 1833c32a2c Cleans up front matter (#9835)
* Sets front matter defaults

* Removes default front matter from section templates/pages

* Removes default front matter from addon pages

* Removes default front matter from integration pages

* Removes default front matter from posts

* Removes default front matter from docs pages

* Removes default front matter from other pages

* Fixes blog category pages
2019-07-11 14:35:08 -07:00

2.6 KiB

title description logo ha_category ha_release ha_iot_class
KNX Binary Sensor Instructions on how to setup the KNX binary sensors within Home Assistant. knx.png
Binary Sensor
0.24 Local Polling

The knx sensor platform allows you to monitor KNX binary sensors.

Configuration

The knx integration must be configured correctly, see KNX Integration.

# Example configuration.yaml entry
binary_sensor:
  - platform: knx
    address: '6/0/2'

{% configuration %} address: description: KNX group address of the binary sensor. required: true type: string name: description: A name for this device used within Home Assistant. required: false type: string device_class: description: Sets the class of the device, changing the device state and icon that is displayed on the frontend. required: false type: string significant_bit: description: Specify which significant bit of the KNX value should be used. required: false type: integer default: 1 reset_after: description: Reset back to OFF state after specified milliseconds. required: false type: integer {% endconfiguration %}

Automation actions

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.

# Example configuration.yaml entry
binary_sensor:
  - platform: knx
    name: Livingroom.3Switch3
    address: '5/0/26'
    automation:
      - counter: 1
        hook: 'on'
        action:
          - entity_id: light.hue_color_lamp_1
            service: homeassistant.turn_on
      - counter: 2
        hook: 'on'
        action:
          - entity_id: light.hue_bloom_1
            service: homeassistant.turn_on
          - entity_id: light.hue_bloom_2
            service: homeassistant.turn_on

{% configuration %} name: description: A name for this device used within Home Assistant. required: false type: string counter: description: Set to 2 if your only want the action to be executed if the button was pressed twice. To 3 for three times button pressed. required: false type: integer default: 1 hook: description: Indicates if the automation should be executed on what state of the binary sensor. Values are "on" or "off". required: false type: string default: "on" action: description: Specify a list of actions analog to the automation rules. required: false type: list {% endconfiguration %}