KNX Sensor


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

The knx sensor platform allows you to monitor KNX sensors.

Sensors are read-only. To write to the knx-bus configure an exposure KNX Integration - Expose.

Configuration

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

# Example configuration.yaml entry
sensor:
  - platform: knx
    name: Heating.Valve1
    state_address: '2/0/0'

Configuration Variables

state_address

(string)(Required)

KNX group address of the sensor.

name

(string)(Optional)

A name for this device used within Home Assistant.

sync_state

(boolean)(Optional)

Actively read the value from the bus. If False no GroupValueRead telegrams will be sent to the bus.

Default value:

true

type

(string)(Required)

A type from the following table must be defined. The DPT of the group address should match the expected KNX DPT to be parsed correctly.

KNX DPT type size in byte unit
5.001 percent 1 %
5.003 angle 1 °
5.004 percentU8 1 %
5.010 pulse 1
5.010 DPT-5 1
5.010 1byte_unsigned 1
6.001 percentV8 1 %
6.010 counter_pulses 1 counter pulses
7.*** DPT-7 2
7.001 2byte_unsigned 2 pulses
7.012 current 2 mA
7.013 brightness 2 lx
7.600 color_temperature 2 K
8.*** DPT-8 2
8.001 2byte_signed 2 pulses
8.002 delta_time_ms 2 ms
8.005 delta_time_sec 2 s
8.006 delta_time_min 2 min
8.007 delta_time_hrs 2 h
8.010 percentV16 2 %
8.011 rotation_angle 2 °
9.* enthalpy 2 H
9.*** DPT-9 2
9.001 temperature 2 °C
9.004 illuminance 2 lx
9.005 speed_ms 2 m/s
9.006 pressure_2byte 2 Pa
9.007 humidity 2 %
9.008 ppm 2 ppm
9.020 voltage 2 mV
12.*** DPT-12 4
12.*** 4byte_unsigned 4
13.*** DPT-13 4
13.*** 4byte_signed 4
14.*** DPT-14 4
14.*** 4byte_float 4
14.019 electric_current 4 A
14.027 electric_potential 4 V
14.031 energy 4 J
14.033 frequency 4 Hz
14.036 heatflowrate 4 W
14.042 luminous_flux 4 lm
14.054 phaseanglerad 4 rad
14.055 phaseangledeg 4 °
14.056 power 4 W
14.057 powerfactor 4
14.058 pressure 4 Pa
14.065 speed 4 m/s
16.000 string 14
17.001 scene_number 1

Full example

# Example configuration.yaml entry
sensor:
  - platform: knx
    name: Heating.Valve1
    state_address: '2/0/0'
    type: 'percent'
  - platform: knx
    name: Kitchen.Temperature
    state_address: '6/2/1'
    sync_state: False
    type: 'temperature'