KNX

The KNX integration for Home Assistant allows you to connect to a KNX/IP devices.

The integration requires a local KNX/IP interface like the Weinzierl 730. Through this, it will send and receive commands to and from other devices to the KNX bus.

Please note, the `knx` platform does not support Windows.

There is currently support for the following device types within Home Assistant:

Configuration

To use your KNX in your installation, add the following lines to your configuration.yaml file:

knx:

Optional, recommended for large KNX installations (>100 devices) and/or if you want to use the XKNX abstraction also for other scripted tools outside of Home Assistant:

knx:
  config_file: '/path/to/xknx.yaml'

Configuration Variables

config_file

(string)(Optional)

The path for XKNX configuration file.

rate_limit

(integer)(Optional)

Defines the maximum number of telegrams to be sent to the bus per second (range 1-100).

Default value:

If the auto detection of the KNX/IP device does not work you can specify ip/port of the tunneling device:

knx:
  tunneling:
    host: '192.168.2.23'
    port: 3671
    local_ip: '192.168.2.109'

Configuration Variables

host

(string)(Required)

Host of the KNX/IP tunneling device.

port

(integer)(Optional)

Port of the KNX/IP tunneling device.

local_ip

(string)(Optional)

IP of the local interface.

Explicit connection to a KNX/IP routing device:

knx:
  routing:
     local_ip: '192.168.2.109'

Configuration Variables

local_ip

(string)(Required)

The local IP address of interface (which should be used for multicasting).

knx:
  fire_event: true
  fire_event_filter: ["1/0/*", "6/2,3,4-6/*"]

Configuration Variables

fire_event

(boolean)(Inclusive)

If set to True, platform will write all received KNX messages to event bus

Default value:

false

fire_event_filter

(list | string)(Inclusive)

If fire_event is set fire_event_filter has to be specified. fire_event_filter defines a list of patterns for filtering KNX addresses. Only telegrams which match this pattern are sent to the Home Assistant event bus.

state_updater

(boolean)(Optional)

The integration will collect the current state of each configured device from the KNX bus to display it correctly within Home Assistant. Set this option to False to prevent this behavior.

Default value:

true

Services

In order to directly interact with the KNX bus, you can use the following service:

Domain: knx
Service: send
Service Data: {"address": "1/0/15", "payload": 0}

Configuration Variables

address

(string)

KNX group address

payload

(integer | list)

Payload, either an integer or an array of integers

Exposing sensor values or time to KNX bus

KNX integration is able to expose time or sensor values to KNX bus. The integration will broadcast any change of the exposed value to the KNX bus and answer read requests to the specified group address:

# Example configuration.yaml entry
knx:
  expose:
    - type: 'temperature'
      entity_id: 'sensor.owm_temperature'
      address: '0/0/2'
    - type: 'string'
      address: '0/6/4'
      entity_id: "sensor.owm_weather"
    - type: 'binary'
      entity_id: 'binary_sensor.kitchen_window'
      address: '0/6/5'
    - type: 'time'
      address: '0/0/1'
    - type: 'datetime'
      address: '0/0/23'

Configuration Variables

type

(string)(Required)

Type of the exposed value. Either ‘binary’, ‘time’, ‘date’, ‘datetime’ or any supported type of KNX Sensor (e.g., “temperature” or “humidity”).

entity_id

(string)

Entity id to be exposed. Not needed for types time, date and datetime.

address

(string)(Required)

KNX group address.