home-assistant.io/source/_components/sensor.luftdaten.markdown
2017-11-04 23:11:05 +01:00

73 lines
2.1 KiB
Markdown

---
layout: page
title: "Luftdaten Sensor"
description: "Instructions how to setup Luftdaten sensor in Home Assistant."
date: 2017-11-01 00:00
sidebar: true
comments: false
sharing: true
footer: true
logo: luftdaten.png
ha_category: Health
ha_release: 0.57
ha_iot_class: "Cloud Polling"
---
The `luftdaten` sensor platform will query the open data API of [luftdaten.info](http://luftdaten.info) to monitor air quality and other weather data from a specific (self build) sensor station.
- To get the ID of a particle sensor you need to select it on the [Feinstaub map](http://deutschland.maps.luftdaten.info/) and find it in the sidebar (Column "Sensor ID").
- To get the ID of a temperature/humidity sensor you need to find it on the map hosted on [Madavi](https://www.madavi.de/sensor/feinstaub-map-dht/).
To enable this sensor, add the following lines to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
sensor:
- platform: luftdaten
sensorid: 3123
monitored_conditions:
- P1
- P2
- platform: luftdaten
sensorid: 155
monitored_conditions:
- temperature
- humidity
```
{% configuration %}
sensorid:
description: The ID of the sensor.
required: true
type: string
name:
description: Name of the sensor to use in the frontend.
required: false
default: Luftdaten Sensor
type: string
resource:
description: The URL of the API endpoint. Usually this has not to be changed.
required: false
default: https://api.luftdaten.info/v1/sensor/
type: string
verify_ssl:
description: Verify SSL connection.
required: false
default: true
type: boolean
monitored_conditions:
description: A list of conditions you want to monitor.
required: true
type: list
keys:
P1:
description: Show the particle sensors (particles 10 microns and below).
P2:
description: Show the particle sensors (particles 2.5 microns and below).
temperature:
description: Display the temperature from a weather sensor.
humidity:
description: Display the humidity from a weather sensor.
{% endconfiguration %}