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.

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.

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=151Etsi 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
# 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¶meters=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
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: queuedmax: 10
# trigger_variables are available in triggers (the 'for' below) as well as in actionstrigger_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 stoppedLuo 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
# Savuvahdin dashboard-osio. Sections-näkymässä: lisää osio → ⋮ → Muokkaa YAML:na ja liitä tämä.type: gridcards: - 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 yliHyvä 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ä.