jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-21 16:27:19 +00:00
Code Issues Packages Projects Releases Wiki Activity

Remove deprecated YAML configuration from Luftdaten (#20690)

Browse Source
This commit is contained in:
Franck Nijhof 2021-12-14 19:57:53 +01:00 committed by GitHub
parent e6af10c666
commit aa6e88088a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 1 additions and 80 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

81
source/_integrations/luftdaten.markdown
View File

@ -17,88 +17,9 @@ ha_platforms:
The `luftdaten` integration will query the open data API of [luftdaten.info](https://luftdaten.info/) to monitor air quality and other weather data from a specific (self build) sensor station.
## Setup
## Prerequisites
- To get the ID of a particle sensor you need to select it on the [Feinstaub map](https://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/).
{% include integrations/config_flow.md %}
## Manual Configuration
To enable this sensor, add the following lines to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
luftdaten:
```
{% configuration %}
sensor_id:
description: The ID of the sensor.
required: true
type: string
show_on_map:
description: Option to show the position of the sensor on the map.
required: false
default: false
type: boolean
scan_interval:
description: the frequency (in seconds) between data updates.
required: false
type: integer
default: 600
sensors:
description: The sensor-related configuration options.
required: false
type: map
keys:
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 the sensor.
humidity:
description: Display the humidity from the sensor.
pressure:
description: Display the pressure from the sensor.
{% endconfiguration %}
<div class='note warning'>
If you set `show_on_map` to `true` then the location attributes are named `latitude` and `longitude`. The default name of the location attributes is `lat` and `long` to avoid showing them on the map.
</div>
Not all sensors provide all conditions. Also, it's possible that the sensor values are not available all the time. To check what a sensor is publishing use `curl`:
```bash
curl https://data.sensor.community/airrohr/v1/sensor/[sensorid]/
```
## Full example
This example would use the sensor with the ID 155, show it on the `map` and would monitor `temperature` and `humidity`.
```yaml
# Example configuration.yaml entry
luftdaten:
sensor_id: 155
show_on_map: true
sensors:
monitored_conditions:
- temperature
- humidity
```
## Sensor
The `luftdaten` sensor platform will query the open data API of [luftdaten.info](https://luftdaten.info/) to monitor air quality and other weather data from a specific (self build) sensor station.
You must have the `luftdaten` integration (from above) configured to use this platform. After configuring that component, sensors will automatically appear.