Siirry sisältöön
Automate the North

Ilmanvaihto pysähtyy, kun ulkona on savua

Home Assistant -savuvahti vertaa omaa hiukkasanturia virallisiin ilmanlaatumittauksiin ja sammuttaa ilmanvaihdon, kun ulkoilma on savuista.

Julkaistu
Taso
Keskitaso
Laitteet
Plantower PMS5003 -hiukkasanturi, ESP32-S3 ja ESPHome, ilmanvaihtokone fan-entiteettinä

Tyynenä talvi-iltana puulämmityksen savu jää leijumaan talojen väliin, ja lämmöntalteenotolla varustettu ilmanvaihtokone imee sen mielellään sisään. Tämä toteutus seuraa ulkoilman hiukkasanturia, sammuttaa ilmanvaihdon savun ajaksi ja käynnistää sen uudelleen, kun ilma on puhdistunut.

Kiinteä raja ei toimi kovin hyvin. Joinain päivinä koko alueen hiukkaspitoisuudet ovat koholla, ja kiinteä raja pitäisi ilmanvaihdon pois päältä tuntikausia. Siksi savuvahti vertaa omaa anturia lähimmän ilmanlaatuaseman viralliseen mittaukseen. Savua on silloin, kun oma ilma on selvästi huonompaa kuin ympäröivän alueen.

Home Assistant -dashboardin savuvahtiosio: tilarivi, savuvahti ja ilmanvaihto, savuraja, alueen tausta ja säädöt.
Savuvahdin osio: tila, savuraja, alueen tausta ja säädöt.

Mitä se tekee

  • Vertaa alueen taustaan. Savua on, kun oma PM2.5 ylittää suurimman näistä: 10 µg/m³, kolme kertaa virallinen lukema tai virallinen lukema plus 10 µg/m³. Yläraja estää rajaa nousemasta liian korkealle, jos mittausasemallakin on savua.
  • Reagoi aina sakeaan savuun. Ehdottoman rajan (PM2.5:lle 50 µg/m³, PM10:lle 1,2 kertaa se) yli on aina savua taustasta riippumatta.
  • Siirtyy kiinteisiin rajoihin. Jos virallinen lukema puuttuu tai on yli kolme tuntia vanha, savuvahti käyttää rajoja 10 µg/m³ päälle ja 8 µg/m³ pois.
  • Ei räpsy rajalla. Se sammuu vähän matalammalla kuin syttyy.
  • Odottaa ennen käynnistystä. Ilmanvaihto käynnistyy vasta, kun ilma on pysynyt puhtaana 10 minuuttia. Jos savua tulee taas, odotus alkaa alusta.
  • Väistyy, kun otat ohjat. Jos käynnistät ilmanvaihdon itse, savuvahti antaa sen käydä seuraavaan savuhälytykseen asti.
  • Säädetään dashboardilta. Kerroin, marginaali ja rajat ovat numeroita, joita voi muuttaa ilman YAMLia.

Mitä tarvitset

  • Ulkoilman hiukkasanturin, joka mittaa PM2.5:n ja PM10:n yksikössä µg/m³. Minulla se on ulkona oleva Plantower PMS5003, joka on kytketty ESPHomea ajavaan ESP32-S3:een.
  • Ilmanvaihtokoneen, joka näkyy Home Assistantissa fan-entiteettinä. Minulla se on Vallox, mutta mikä tahansa kone, jonka Home Assistant osaa kytkeä päälle ja pois, käy.
  • Lähimmän Ilmatieteen laitoksen ilmanlaatuaseman tunnuksen. Suomen ulkopuolella mikä tahansa virallinen PM2.5-lähde käy toisenlaisella REST-sensorilla.
PMS5003-hiukkasanturi pienen sääsuojatun kotelon kyljessä ulkoikkunan laudalla.
PMS5003-hiukkasanturi ulkona pienessä kotelossa ikkunalaudalla.

Vallox-koneet. Home Assistantin oma Vallox-integraatio keskustelee koneen kanssa suoraan lähiverkossa saman HTTP-rajapinnan kautta, jota koneen oma selainohjaus käyttää. Pilvipalvelua tai Modbus-sovitinta ei tarvita, riittää että annat koneen IP-osoitteen. Integraatio luo fan-entiteetin, jossa on profiilit Home, Away, Boost, Fireplace, Extra ja Auto, sekä sensorit lämpötiloille, kosteudelle, puhaltimien nopeuksille, lämmöntalteenoton hyötysuhteelle ja suodattimen jäljellä olevalle ajalle. Minulla se on Vallox 110 MV.

Vaihe 1: etsi ilmanlaatuasema

Ilmatieteen laitos julkaisee ilmanlaatuasemiensa PM2.5-tuntikeskiarvot avoimena datana ilman API-avainta. Avaa asemalista selaimessa:

https://opendata.fmi.fi/wfs?service=WFS&version=2.0.0&request=getFeature&storedquery_id=fmi::ef::stations&networkid=151

Etsi sivulta oma paikkakuntasi. Kohdan <gml:identifier ... fmisid> numero on aseman tunnus. Kaikki asemat eivät mittaa PM2.5:tä, joten kokeile: laita tunnus alla olevan paketin osoitteeseen ja avaa se. Jos vastauksessa on PM25_PT1H_avg-arvoja, asema toimii.

Vaihe 2: sensorit ja asetukset

Paketti luo virallisen taustalukeman, sensorin nykyiselle savurajalle, itse savusensorin, savuvahdin kytkimen ja neljä asetusta. Tallenna se nimellä config/packages/smoke_guard.yaml ja vaihda YOUR_STATION_ID, sensor.outdoor_pm2_5 ja sensor.outdoor_pm10 omiksesi.

Näytä paketti
packages/smoke_guard.yaml
# Smoke guard: decides when outdoor air is smoky, compared with official regional readings.
# Save as config/packages/smoke_guard.yaml (packages must be enabled in configuration.yaml).
#
# Replace before use:
# YOUR_STATION_ID FMI air quality station (fmisid) near you
# sensor.outdoor_pm2_5 your own outdoor PM2.5 sensor (µg/m³)
# sensor.outdoor_pm10 your own outdoor PM10 sensor (µg/m³)
# Official hourly PM averages from the Finnish Meteorological Institute (open data, no API key).
# Values are published about an hour after the measurement hour.
rest:
- resource_template: >-
https://opendata.fmi.fi/wfs?service=WFS&version=2.0.0&request=getFeature&storedquery_id=urban::observations::airquality::hourly::simple&fmisid=YOUR_STATION_ID&parameters=PM25_PT1H_avg,PM10_PT1H_avg&starttime={{ (utcnow() - timedelta(hours=4)).strftime('%Y-%m-%dT%H:00:00Z') }}
scan_interval: 900
timeout: 30
sensor:
- name: FMI background PM2.5
unique_id: fmi_background_pm2_5
unit_of_measurement: μg/m³
device_class: pm25
state_class: measurement
value_template: >
{% set m = value_json['wfs:FeatureCollection']['wfs:member'] | default([]) %}
{% set m = m if m is list else [m] %}
{% set v = m | map(attribute='BsWfs:BsWfsElement')
| selectattr('BsWfs:ParameterName', 'eq', 'PM25_PT1H_avg')
| rejectattr('BsWfs:ParameterValue', 'eq', 'NaN') | list %}
{{ (v | last)['BsWfs:ParameterValue'] | float if v | count > 0 else none }}
- name: FMI background measured
unique_id: fmi_background_measured
device_class: timestamp
value_template: >
{% set m = value_json['wfs:FeatureCollection']['wfs:member'] | default([]) %}
{% set m = m if m is list else [m] %}
{% set v = m | map(attribute='BsWfs:BsWfsElement')
| selectattr('BsWfs:ParameterName', 'eq', 'PM25_PT1H_avg')
| rejectattr('BsWfs:ParameterValue', 'eq', 'NaN') | list %}
{{ (v | last)['BsWfs:Time'] if v | count > 0 else none }}
input_boolean:
smoke_guard_enabled:
name: Smoke guard
icon: mdi:smoke-detector-variant
# Set by the automation while it has switched the ventilation off
smoke_guard_stopped:
name: Smoke guard stopped the ventilation
icon: mdi:fan-off
# Tuning, adjustable from the dashboard. Home Assistant remembers the values across restarts.
input_number:
smoke_guard_factor:
name: Smoke guard factor
min: 1.5
max: 6
step: 0.1
mode: box
smoke_guard_margin:
name: Smoke guard margin
min: 0
max: 50
step: 1
mode: box
unit_of_measurement: μg/m³
smoke_guard_limit_max:
name: Smoke guard highest limit
min: 15
max: 100
step: 1
mode: box
unit_of_measurement: μg/m³
smoke_guard_absolute:
name: Smoke guard absolute limit
min: 20
max: 200
step: 5
mode: box
unit_of_measurement: μg/m³
template:
- sensor:
# The PM2.5 level that counts as smoke right now
- name: Smoke guard limit
unique_id: smoke_guard_limit
unit_of_measurement: μg/m³
device_class: pm25
state_class: measurement
state: >
{% set f = states('sensor.fmi_background_pm2_5') | float(none) %}
{% set t = states('sensor.fmi_background_measured') %}
{% set age_h = ((now() - as_datetime(t)).total_seconds() / 3600)
if t not in ['unknown', 'unavailable', 'none', ''] else 99 %}
{% set k = states('input_number.smoke_guard_factor') | float(3) %}
{% set m = states('input_number.smoke_guard_margin') | float(10) %}
{% set cap = states('input_number.smoke_guard_limit_max') | float(35) %}
{% if f is none or age_h > 3 %}10
{% else %}{{ [[10, k * f, f + m] | max, cap] | min | round(1) }}
{% endif %}
- binary_sensor:
# On when the own sensor reads clearly above the regional background. Switches off a little
# lower than it switches on, so a reading hovering at the limit doesn't flap.
- name: Smoke guard smoke
unique_id: smoke_guard_smoke
device_class: smoke
state: >
{% set was_on = this.state == 'on' if this is defined else false %}
{% set l = states('sensor.outdoor_pm2_5') | float(none) %}
{% set l10 = states('sensor.outdoor_pm10') | float(none) %}
{% set absolute = states('input_number.smoke_guard_absolute') | float(50) %}
{% set f = states('sensor.fmi_background_pm2_5') | float(none) %}
{% set t = states('sensor.fmi_background_measured') %}
{% set age_h = ((now() - as_datetime(t)).total_seconds() / 3600)
if t not in ['unknown', 'unavailable', 'none', ''] else 99 %}
{% set k = states('input_number.smoke_guard_factor') | float(3) %}
{% set m = states('input_number.smoke_guard_margin') | float(10) %}
{% set cap = states('input_number.smoke_guard_limit_max') | float(35) %}
{% if l is none %}
{{ was_on }}
{% elif l >= absolute or (l10 is not none and l10 >= absolute * 1.2) %}
true
{% elif f is none or age_h > 3 %}
{# No fresh official reading: fall back to fixed limits #}
{{ l > 8 if was_on else l >= 10 }}
{% else %}
{% set limit_on = [[10, k * f, f + m] | max, cap] | min %}
{% set limit_off = [[8, (k - 0.5) * f, f + m * 0.6] | max, limit_on - 2] | min %}
{{ l > limit_off if was_on else l >= limit_on }}
{% endif %}

Lataa uudelleen kohdasta Kehitystyökalut → YAML: template-entiteetit, input boolean- ja input number -apuentiteetit sekä RESTful-entiteetit. Uudet numeroapuentiteetit alkavat pienimmästä arvostaan, joten aseta nämä kerran vaiheen 4 dashboardilta:

Asetus Oma arvoni Mitä se tarkoittaa
Kerroin 3 Savua, kun oma PM2.5 on kolminkertainen taustaan
Marginaali 10 µg/m³ …tai tausta plus tämä
Korkein raja 35 µg/m³ Raja ei nouse tätä korkeammalle
Ehdoton raja 50 µg/m³ Tämän yli on aina savua

Vaihe 3: blueprint

Blueprint ohjaa ilmanvaihtoa. Tallenna se nimellä config/blueprints/automation/automate_the_north/smoke_guard.yaml ja lataa automaatiot uudelleen.

Tuo blueprint Home Assistantiin(avautuu uuteen välilehteen)Katso GitHubissa(avautuu uuteen välilehteen)

Näytä blueprint
blueprints/automation/automate_the_north/smoke_guard.yaml
blueprint:
name: Smoke guard for ventilation
author: Automate the North
description: >
Switches the ventilation off when a smoke sensor turns on, and back on once the air has
stayed clean for a while.
**How it works**
- When the smoke sensor turns on, the ventilation switches off and a flag remembers that
this automation did it.
- When the sensor has been off for the stabilisation time, the ventilation switches back on.
If smoke returns before that, the wait starts over.
- If you switch the ventilation on yourself while it's stopped, the guard steps aside
until the next smoke alarm.
- After a Home Assistant restart, a five-minute check finishes a wait that was cut short.
- When the guard toggle is off, this automation never touches the ventilation.
source_url: https://github.com/automate-the-north/home-assistant/blob/main/blueprints/automation/automate_the_north/smoke_guard.yaml
domain: automation
input:
smoke:
name: Smoke sensor
description: A binary sensor that is on when the outdoor air is smoky.
selector:
entity:
filter:
- domain: binary_sensor
ventilation:
name: Ventilation
description: The ventilation unit as a fan entity.
selector:
entity:
filter:
- domain: fan
enabled:
name: Guard toggle
description: An input_boolean that turns the smoke guard on or off.
selector:
entity:
filter:
- domain: input_boolean
stopped:
name: Stopped flag
description: An input_boolean this automation turns on while it has the ventilation switched off.
selector:
entity:
filter:
- domain: input_boolean
stable_minutes:
name: Stabilisation time
description: How long the air must stay clean before the ventilation switches back on.
default: 10
selector:
number:
min: 1
max: 120
unit_of_measurement: min
on_stop:
name: Extra actions when stopped
description: Optional, for example a notification.
default: []
selector:
action: {}
on_start:
name: Extra actions when restarted
description: Optional, for example a notification.
default: []
selector:
action: {}
mode: queued
max: 10
# trigger_variables are available in triggers (the 'for' below) as well as in actions
trigger_variables:
smoke: !input smoke
stopped: !input stopped
stable: !input stable_minutes
triggers:
- trigger: state
id: smoke
entity_id: !input smoke
to: 'on'
# Guard switched on while smoke is already present
- trigger: state
id: smoke
entity_id: !input enabled
to: 'on'
- trigger: state
id: clean
entity_id: !input smoke
to: 'off'
for:
minutes: '{{ stable | int(10) }}'
- trigger: state
id: manual
entity_id: !input ventilation
to: 'on'
# Finishes a wait that a restart cut short
- trigger: time_pattern
id: watchdog
minutes: /5
conditions:
- condition: state
entity_id: !input enabled
state: 'on'
actions:
- choose:
- conditions:
- condition: trigger
id: smoke
- condition: state
entity_id: !input smoke
state: 'on'
- condition: state
entity_id: !input stopped
state: 'off'
sequence:
- action: fan.turn_off
target:
entity_id: !input ventilation
- action: input_boolean.turn_on
target:
entity_id: !input stopped
- choose: []
default: !input on_stop
- conditions:
- condition: trigger
id: [clean, watchdog]
- condition: state
entity_id: !input stopped
state: 'on'
- condition: template
value_template: >-
{{ is_state(smoke, 'off')
and (now() - states[smoke].last_changed).total_seconds() >= stable | int(10) * 60 }}
sequence:
- action: input_boolean.turn_off
target:
entity_id: !input stopped
- action: fan.turn_on
target:
entity_id: !input ventilation
- choose: []
default: !input on_start
# Switched on by hand (not by this automation) while stopped: step aside
- conditions:
- condition: trigger
id: manual
- condition: state
entity_id: !input stopped
state: 'on'
- condition: template
value_template: '{{ trigger.to_state.context.parent_id is none }}'
sequence:
- action: input_boolean.turn_off
target:
entity_id: !input stopped

Luo automaatio blueprintista Smoke guard for ventilation ja valitse:

  • Smoke sensor: binary_sensor.smoke_guard_smoke
  • Ventilation: ilmanvaihtokoneesi fan-entiteetti
  • Guard toggle: input_boolean.smoke_guard_enabled
  • Stopped flag: input_boolean.smoke_guard_stopped

Valinnaisiin lisätoimintoihin sopii esimerkiksi puhelinilmoitus, kun ilmanvaihto pysähtyy ja käynnistyy.

Vaihe 4: dashboard

Tilarivi kertoo selkokielellä, mitä on meneillään, esimerkiksi “Ilma on puhdasta” nykyisen rajan kanssa tai “Ilmanvaihto pysäytetty” ja lukema, joka sen aiheutti. Säädöt-kortissa ovat neljä asetusta.

Näytä dashboardin YAML
Dashboard-osio
# Savuvahdin dashboard-osio. Sections-näkymässä: lisää osio → ⋮ → Muokkaa YAML:na ja liitä tämä.
type: grid
cards:
- type: heading
heading: Savuvahti
heading_style: title
icon: mdi:smoke-detector-variant
badges:
- type: entity
entity: sensor.outdoor_pm2_5
show_icon: true
icon: mdi:blur
show_state: true
- type: markdown
text_only: true
grid_options:
columns: full
content: |-
{%- macro n(v) -%}{{ (v | string) | replace('.', ',') }}{%- endmacro -%}
{%- set l = states('sensor.outdoor_pm2_5') | float(none) -%}
{%- set lim = states('sensor.smoke_guard_limit') | float(none) -%}
{%- set f = states('sensor.fmi_background_pm2_5') | float(none) -%}
{%- if is_state('input_boolean.smoke_guard_enabled', 'off') -%}
## Savuvahti pois
Ilmanvaihto toimii normaalisti eikä sammu savun takia.
{%- elif is_state('input_boolean.smoke_guard_stopped', 'on') and is_state('binary_sensor.smoke_guard_smoke', 'on') -%}
## Ilmanvaihto pysäytetty
Ulkona on savua: PM2.5 {{ n(l) }} µg/m³, raja {{ n(lim) }} µg/m³.
{%- elif is_state('input_boolean.smoke_guard_stopped', 'on') -%}
## Ilma puhdistuu
Ilmanvaihto käynnistyy, kun ilma on pysynyt puhtaana hetken.
{%- else -%}
## Ilma on puhdasta
PM2.5 {{ n(l) }} µg/m³. Savuraja {{ n(lim) }} µg/m³{% if f is not none %}, alueen tausta {{ n(f) }} µg/m³{% endif %}.
{%- endif -%}
- type: tile
entity: input_boolean.smoke_guard_enabled
name: Savuvahti
icon: mdi:smoke-detector-variant
vertical: false
grid_options:
columns: 6
tap_action:
action: toggle
icon_tap_action:
action: toggle
- type: tile
entity: fan.ventilation
name: Ilmanvaihto
vertical: false
grid_options:
columns: 6
- type: tile
entity: sensor.smoke_guard_limit
name: Savuraja
icon: mdi:gauge
vertical: false
grid_options:
columns: 6
- type: tile
entity: sensor.fmi_background_pm2_5
name: Alueen tausta
icon: mdi:map-marker-radius
vertical: false
grid_options:
columns: 6
- type: entities
title: Säädöt
state_color: false
grid_options:
columns: full
entities:
- entity: input_number.smoke_guard_factor
name: Kertaa tausta
- entity: input_number.smoke_guard_margin
name: Tai tausta plus
- entity: input_number.smoke_guard_limit_max
name: Korkein raja
- entity: input_number.smoke_guard_absolute
name: Aina savua yli

Hyvä tietää

  • Viralliset lukemat tulevat noin tunnin viiveellä. Ilmatieteen laitos julkaisee kunkin tuntikeskiarvon noin tuntia myöhemmin. Savuvahti reagoi omaan anturiin heti; tausta vain asettaa rajan.
  • Edulliset hiukkasanturit näyttävät kosteassa ilmassa liikaa. PMS5003:n kaltaiset optiset anturit yliarvioivat helposti kostealla säällä. Siksi raja on taustan monikerta eikä pieni erotus.
  • Jos tulee vääriä hälytyksiä, nosta kerrointa tai marginaalia ennen kuin muutat logiikkaa. Jos savu jää huomaamatta, laske niitä.

Kaikki tiedostot GitHubissa

Palaute

Löysitkö virheen, jäikö jokin epäselväksi tai onko sinulla idea projektiksi? Kirjoita siitä tähän.

Nimetön: vain viesti ja tämän sivun osoite lähetetään. Älä kirjoita nimeäsi tai yhteystietojasi, sillä viestiin ei voi vastata.