mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-04 17:26:50 +00:00
32e147b268
See https://github.com/XKNX/xknx/blob/master/xknx/devices/remote_value_sensor.py#L44-L54 for details. As a newbie it took me a while to find this out. So I thought it might be good for others to add it to the documentation.
52 lines
1.4 KiB
Markdown
52 lines
1.4 KiB
Markdown
---
|
|
layout: page
|
|
title: "KNX Sensor"
|
|
description: "Instructions on how to use the KNX Sensor with Home Assistant."
|
|
date: 2016-08-20 22:24
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
logo: knx.png
|
|
ha_category: Sensor
|
|
ha_release: 0.29
|
|
ha_iot_class: "Local Push"
|
|
---
|
|
|
|
The `knx` sensor platform allows you to monitor [KNX](http://www.knx.org) sensors.
|
|
|
|
The `knx` component must be configured correctly, see [KNX Component](/components/knx).
|
|
|
|
## {% linkable_title 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
|
|
address: '2/0/0'
|
|
```
|
|
|
|
|
|
|
|
- **address** (*Required*): KNX group address of the sensor.
|
|
- **name** (*Optional*): A name for this device used within Home Assistant.
|
|
- **type** (*Optional*): "percent", "temperature", "humidity", "illuminance", "brightness", "speed_ms", "current", "power", "electric_current", "electric_potential", "energy", "frequency", "heatflowrate", "phaseanglerad", "phaseangledeg", "powerfactor", "speed", "DPT-7", "DPT-9", "DPT-12", "DPT-13" or "DPT-14".
|
|
|
|
## {% linkable_title Full example %}
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
sensor:
|
|
- platform: knx
|
|
name: Heating.Valve1
|
|
address: '2/0/0'
|
|
type: 'percent'
|
|
- platform: knx
|
|
name: Kitchen.Temperature
|
|
address: '6/2/1'
|
|
type: 'temperature'
|
|
```
|