KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #cli #codex #claude-code #dsh-plugin #mcp #react #agent #dsh #deepseek-harness

local_luftdaten

★ 55 Open GitHub ↗

Custom component for Home Assistant that integrates your (own) local Luftdaten sensor (air quality/particle sensor) without using the cloud.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![hacs_badge](https://img.shields.io/badge/HACS-Default-orange.svg)](https://github.com/custom-components/hacs)
![Validate with hassfest](https://github.com/lichtteil/local_luftdaten/workflows/Validate%20with%20hassfest/badge.svg)

# Custom Luftdaten component for Home Assistant

## About
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/

## Installation
### HACS
If you use [HACS](https://hacs.xyz/) you can install and update this component easily via the default repository. Go into HACS -> Integrations and search for **luftdaten**.

### Manual
Download and unzip or clone this repository and copy `local_luftdaten/` from `custom_components/` to `~/.homeassistant/custom_components/`.

## Configuration
This integration now uses Home Assistant UI config flow.

1. Go to **Settings -> Devices & Services -> Add Integration**.
2. Search for **Local Luftdaten**.
3. Fill in host, monitored conditions, and optional settings.

### YAML migration
Existing YAML platform config is automatically imported into a config entry at startup.
After import, remove the `sensor: - platform: local_luftdaten` block from `configuration.yaml`.

|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

```yaml
# Legacy format (auto-imported once):
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:

- BME280_humidity
- BME280_pressure
- BME280_temperature
- BMP_pressure
- BMP_temperature
- BMP280_pressure
- BMP280_temperature
- DS18B20_temperature
- HECA_humidity
- HECA_temperature
- HPM_P1
- HPM_P2
- HTU21D_humidity
- HTU21D_temperature
- humidity
- SDS_P1
- SDS_P2
- PMS_P0
- PMS_P1
- PMS_P2
- SCD30_co2_ppm
- SCD30_humidity
- SCD30_temperature
- SHT3X_humidity
- SHT3X_temperature
- SPS30_P0
- SPS30_P1
- SPS30_P2
- SPS30_P4
- SEN5X_P0
- SEN5X_P1
- SEN5X_P2
- SEN5X_P4
- SEN5X_NOX
- SEN5X_VOC
- temperature
- signal

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`.

## Examples

### Rounding and offset

Use [Template Sensors](https://www.home-assistant.io/integrations/template/#sensor) to round the values or to give them an offset.

```yaml
template:
  - sensor:
      - name: Temperature
        unit_of_measurement: '°C'
        state: '{{ (states("sensor.feinstaubsensor_temperature") | float) | round(1) - 2 }}'
```

### Calculate equivalent atmospheric pressure at sea level

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'
```

local_luftdaten

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README