This custom component for Home Assistant integrates your (own) local Luftdaten sensor (air quality/particle sensor) without using the cloud. If you want to know more about the sensor and how to build one check this website: https://luftdaten.info/en/home-en/
If you use HACS you can install and update this component easily via the default repository. Go into HACS -> Integrations and search for luftdaten.
Download and unzip or clone this repository and copy custom_components/local_luftdaten/
to your configuration directory of Home Assistant, e.g. ~/.homeassistant/custom_components/
.
In the end your file structure should look like that:
~/.homeassistant/custom_components/local_luftdaten/__init__.py
~/.homeassistant/custom_components/local_luftdaten/const.py
~/.homeassistant/custom_components/local_luftdaten/manifest.json
~/.homeassistant/custom_components/local_luftdaten/sensor.py
Create a new sensor entry in your configuration.yaml
and adjust the host name or the ip address.
Parameter | Type | Necessity | Description |
---|---|---|---|
host |
string | required | IP address of the sensor |
scan_interval |
number | default: 180 | Frequency (in seconds) between updates |
name |
string | required | Name of the sensor |
monitored_conditions |
list | required | List of the monitored sensors |
sensor:
- platform: local_luftdaten
host: 192.168.0.123
scan_interval: 180
name: Feinstaubsensor
monitored_conditions:
- SDS_P1
- SDS_P2
- temperature
- humidity
At the moment following sensor data can be read:
- SDS_P1
- SDS_P2
- temperature
- humidity
- signal
- BME280_temperature
- BME280_humidity
- BME280_pressure
- BMP_pressure
- BMP_temperature
- BMP280_pressure
- BMP280_temperature
- HTU21D_temperature
- HTU21D_humidity
- SPS30_P0
- SPS30_P2
- SPS30_P4
- SPS30_P1
- PMS_P0
- PMS_P1
- PMS_P2
- HECA_temperature
- HECA_humidity
- HPM_P1
- HPM_P2
- SHT3X_temperature
- SHT3X_humidity
- DS18B20_temperature
Sensor type signal
gives the wifi signal strength of the sensor device.
Please open an issue if you want to see other attributes and provide me with a sample of your sensor data by calling http://192.168.x.y/data.json
.
Use Template Sensors to round the values or to give them an offset.
sensor:
- platform: template
sensors:
temperature:
value_template: '{{ (states("sensor.feinstaubsensor_temperature") | float) | round(1) - 2}}'
friendly_name: 'Temperature'
unit_of_measurement: '°C'
To adjusted the atmospheric pressure to the equivalent sea level pressure you need to use the barometric formula which depends on the altitude and the current temperature.
In this example we use an altitude of 300m and receive the temperature from our sensor sensor.feinstaubsensor_temperature
.
atmospheric_pressure:
value_template: >-
{% set temperature_gradient = 0.0065 %}
{% set exponent = 0.03416 / temperature_gradient %}
{% set altitude_meters = 300 %}
{% set temperature_celsius = states('sensor.feinstaubsensor_temperature') | float %}
{% set temperautre_at_sealevel_kelvin = temperature_celsius + (temperature_celsius * temperature_gradient) + 273.15 %}
{% set air_pressure_hpa = (states('sensor.feinstaubsensor_pressure') | float / 100) | round(1) %}
{{ (air_pressure_hpa / (1 - ((temperature_gradient * altitude_meters) / temperautre_at_sealevel_kelvin)) ** exponent) | round(1) }}
friendly_name: 'Atmospheric pressure'
unit_of_measurement: 'hPa'