mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-01 07:46:49 +00:00
533bb3866f
* HTTPS-everywhere (update links in our website) * HTTPS-everywhere (round 2) * HTTPS-everywhere (round 3)
122 lines
5.0 KiB
Markdown
122 lines
5.0 KiB
Markdown
---
|
|
title: "KNX Sensor"
|
|
description: "Instructions on how to use a KNX Sensor with Home Assistant."
|
|
logo: knx.png
|
|
ha_category:
|
|
- Sensor
|
|
ha_release: 0.29
|
|
ha_iot_class: Local Push
|
|
---
|
|
|
|
<div class='note'>
|
|
|
|
The `knx` integration must be configured correctly to use this integration, see [KNX Integration](/integrations/knx).
|
|
|
|
</div>
|
|
|
|
The `knx` sensor platform allows you to monitor [KNX](https://www.knx.org/) sensors.
|
|
|
|
Sensors are read-only. To write to the knx-bus configure an exposure [KNX Integration - Expose](/integrations/knx/#exposing-sensor-values-or-time-to-knx-bus).
|
|
|
|
|
|
## Configuration
|
|
|
|
To use your KNX sensor in your installation, add the following lines to your `configuration.yaml` file:
|
|
|
|
```yaml
|
|
# 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 | 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
|
|
|
|
```yaml
|
|
# 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'
|
|
```
|