home-assistant.io/source/_integrations/sensor.knx.markdown

title, description, ha_category, ha_release, ha_iot_class, ha_domain

title	description	ha_category	ha_release	ha_iot_class	ha_domain
KNX Sensor	Instructions on how to use a KNX Sensor with Home Assistant.	Sensor	0.29	Local Push	knx

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 %} state_address: description: KNX group address of the sensor. required: true type: string name: description: A name for this device used within Home Assistant. required: false type: string sync_state: description: Actively read the value from the bus. If False no GroupValueRead telegrams will be sent to the bus. required: false type: boolean default: True type: description: 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. required: true type: string {% endconfiguration %}

KNX DPT	type	size in byte	range	unit
5.001	percent	1	0 ... 100	%
5.003	angle	1	0 ... 360	°
5.004	percentU8	1	0 ... 255	%
5.010	pulse	1	0 ... 255
5.010	1byte_unsigned	1	0 ... 255
6.001	percentV8	1	-128 ... 127	%
6.010	counter_pulses	1	-128 ... 127	counter pulses
7.001	2byte_unsigned	2	0 ... 65535	pulses
7.002	time_period_msec	2	0 ... 65535	ms
7.003	time_period_10msec	2	0 ... 65535	ms
7.004	time_period_100msec	2	0 ... 65535	ms
7.005	time_period_sec	2	0 ... 65535	s
7.006	time_period_min	2	0 ... 65535	min
7.007	time_period_hrs	2	0 ... 65535	h
7.011	length_mm	2	0 ... 65535	mm
7.012	current	2	0 ... 65535	mA
7.013	brightness	2	0 ... 65535	lx
7.600	color_temperature	2	0 ... 65535	K
8.001	2byte_signed	2	-32768 ... 32767	pulses
8.002	delta_time_ms	2	-32768 ... 32767	ms
8.005	delta_time_sec	2	-32768 ... 32767	s
8.006	delta_time_min	2	-32768 ... 32767	min
8.007	delta_time_hrs	2	-32768 ... 32767	h
8.010	percentV16	2	-32768 ... 32767	%
8.011	rotation_angle	2	-32768 ... 32767	°
9.*	enthalpy	2	-671088.64 ... 670760.96	H
9.001	temperature	2	-273 ... 670760	°C
9.002	temperature_difference_2byte	2	-670760 ... 670760	K
9.003	temperature_a	2	-670760 ... 670760	K/h
9.004	illuminance	2	0 ... 670760	lx
9.005	wind_speed_ms	2	0 ... 670760	m/s
9.006	pressure_2byte	2	0 ... 670760	Pa
9.007	humidity	2	0 ... 670760	%
9.008	ppm	2	-671088.64 ... 670760.96	ppm
9.010	time_1	2	-670760 ... 670760	s
9.011	time_2	2	-670760 ... 670760	ms
9.020	voltage	2	-671088.64 ... 670760.96	mV
9.022	power_density	2	-671088.64 ... 670760.96	W/m²
9.023	kelvin_per_percent	2	-671088.64 ... 670760.96	K/%
9.024	power_2byte	2	-671088.64 ... 670760.96	kW
9.025	volume_flow	2	-671088.64 ... 670760.96	l/h
9.026	rain_amount	2	-671088.64 ... 670760.96	l/m²
9.027	temperature_f	2	-459.6 ... 670760	°F
9.028	wind_speed_kmh	2	0 ... 670760	km/h
12.***	4byte_unsigned	4	0 ... 4294967295
13.***	4byte_signed	4	-2147483648 ... 2147483647
13.002	flow_rate_m3h	4	-2147483648 ... 2147483647	m³/h
13.010	active_energy	4	-2147483648 ... 2147483647	Wh
13.011	apparant_energy	4	-2147483648 ... 2147483647	VAh
13.012	reactive_energy	4	-2147483648 ... 2147483647	VARh
13.013	active_energy_kwh	4	-2147483648 ... 2147483647	kWh
13.014	apparant_energy_kvah	4	-2147483648 ... 2147483647	kVAh
13.015	reactive_energy_kvarh	4	-2147483648 ... 2147483647	kVARh
13.100	long_delta_timesec	4	-2147483648 ... 2147483647	s
14.000	acceleration	4		m/s²
14.***	4byte_float	4
14.001	acceleration_angular	4		rad/s²
14.002	activation_energy	4		J/mol
14.003	activity	4		s⁻¹
14.004	mol	4		mol
14.005	amplitude	4
14.006	angle_rad	4		rad
14.007	angle_deg	4		°
14.008	angular_momentum	4		J s
14.009	angular_velocity	4		rad/s
14.010	area	4		m²
14.011	capacitance	4		F
14.012	charge_density_surface	4		C/m²
14.013	charge_density_volume	4		C/m³
14.014	compressibility	4		m²/N
14.015	conductance	4		S
14.016	electrical_conductivity	4		S/m
14.017	density	4		kg/m³
14.018	electric_charge	4		C
14.019	electric_current	4		A
14.020	electric_current_density	4		A/m²
14.021	electric_dipole_moment	4		C m
14.022	electric_displacement	4		C/m²
14.023	electric_field_strength	4		V/m
14.024	electric_flux	4		c
14.025	electric_flux_density	4		C/m²
14.026	electric_polarization	4		C/m²
14.027	electric_potential	4		V
14.028	electric_potential_difference	4		V
14.029	electromagnetic_moment	4		A m²
14.030	electromotive_force	4		V
14.031	energy	4		J
14.032	force	4		N
14.033	frequency	4		Hz
14.034	angular_frequency	4		rad/s
14.035	heatcapacity	4		J/K
14.036	heatflowrate	4		W
14.037	heat_quantity	4		J
14.038	impedance	4		Ω
14.039	length	4		m
14.040	light_quantity	4		lm s
14.041	luminance	4		cd/m²
14.042	luminous_flux	4		lm
14.043	luminous_intensity	4		cd
14.044	magnetic_field_strength	4		A/m
14.045	magnetic_flux	4		Wb
14.046	magnetic_flux_density	4		T
14.047	magnetic_moment	4		A m²
14.048	magnetic_polarization	4		T
14.049	magnetization	4		A/m
14.050	magnetomotive_force	4		A
14.051	mass	4		kg
14.052	mass_flux	4		kg/s
14.053	momentum	4		N/s
14.054	phaseanglerad	4		rad
14.055	phaseangledeg	4		°
14.056	power	4		W
14.057	powerfactor	4		cosΦ
14.058	pressure	4		Pa
14.059	reactance	4		Ω
14.060	resistance	4		Ω
14.061	resistivity	4		Ω m
14.062	self_inductance	4		H
14.063	solid_angle	4		sr
14.064	sound_intensity	4		W/m²
14.065	speed	4		m/s
14.066	stress	4		Pa
14.067	surface_tension	4		N/m
14.068	common_temperature	4		°C
14.069	absolute_temperature	4		K
14.070	temperature_difference	4		K
14.071	thermal_capacity	4		J/K
14.072	thermal_conductivity	4		W/mK
14.073	thermoelectric_power	4		V/K
14.074	time_seconds	4		s
14.075	torque	4		N m
14.076	volume	4		m³
14.077	volume_flux	4		m³/s
14.078	weight	4		N
14.079	work	4		J
16.000	string	14
17.001	scene_number	1	1 ... 64

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'