Overview GDAS air quality



This function block provides the outdoor air quality of the GDAS portal for the plant's location: the European air quality index (AQI) with level, range, daily maximum and recommendation, as well as fine dust, nitrogen dioxide and ozone. It is the modelled outdoor air at the location, not an indoor air sensor. CO₂, room humidity and room temperature are not included.

Levels and texts. The European AQI applies, not the US AQI: up to 20 is level 0 (good), above 20 to 40 level 1 (moderate), above 40 to 60 level 2 (moderate-poor), above 60 to 80 level 3 (poor), above 80 to 100 level 4 (very poor), above that level 5 (extreme). The range text is "0 bis 20", "21 bis 40", "41 bis 60", "61 bis 80", "81 bis 100" or "ueber 100". The recommendations are "Gut - ideal draussen", "Maessig - unbedenklich", "Maessig-Schlecht - Anstrengung reduzieren", "Schlecht - Fenster schliessen", "Sehr schlecht - Lueftung aktivieren" and "Extrem - drinnen bleiben". "Lueftung aktivieren" is not a release for automatic outdoor air supply when the outdoor air is bad. A ventilation or window control needs a check of the plant, the filters and the protection functions.

Setup. The block needs the MQTT GDAS block in the same project and on the same controller, with the plant ID entered. Nothing else has to be set up: the block registers itself with the portal, and nothing has to be assigned in the portal or in the address list. "Generate addresses" gives every output its own address. There may be only one block of this type per project.

Which values the portal sends. The portal only sends values whose output has an address. If you do not need a value, detach the address from the output. The outputs A11 (Last update) and A12 (Source data complete) should stay linked: without them there is no check of whether the data is up to date.

Present and current. DV (Data present) is 1 as soon as a value exists, including the stored value after a restart. It is 0 only as long as no value has ever arrived. The value outputs then show 0 - that is not a measurement, so check DV before evaluating. DA (Data current) is 0 after every start, even with stored values. It becomes 1 as soon as the portal delivers a new timestamp and falls back to 0 if no new one arrives within the timeout. The values stay as the last known state and are never set to 0. All values change only when the portal sends a new value. It checks hourly and sends only on change.

Storage. The values received last survive a restart of the controller until the portal delivers new ones. They are saved once per hour and before a project is transferred; after a power failure at most the last hour is missing until the portal sends again.

Missing and invalid values. If the portal does not send a value, the output keeps its last state. Values outside the permitted range or texts with invalid characters are discarded; the last state is kept in that case too, and the portal is told the reason.

Texts. The text outputs hold the complete text, up to 200 characters. On the KNX bus texts can only be transmitted up to 14 characters: send the level there instead. The texts are ASCII without umlauts ("Maessig", "Fenster schliessen").

No control. The values trigger nothing. Window, ventilation or shading movements need their own logic with enables and protection priorities.

Inputs

This block has no inputs. The values come from the portal.

Outputs

A1 European AQI Integer, current index.
A2 Air quality level Integer 0 (good) to 5 (extreme).
A3 AQI range Text for the level, for example "41 bis 60".
A4 AQI daily maximum Highest hourly forecast value of the day, not an average.
A5 Hour of the AQI maximum Hour of the first larger maximum, 0 to 23.
A6 Air quality recommendation Text for the level, see above.
A7 Fine dust PM2.5 In µg/m³, rounded to 0.1.
A8 Fine dust PM10 In µg/m³, rounded to 0.1.
A9 Nitrogen dioxide NO₂ In µg/m³, rounded to 0.1.
A10 Ozone O₃ In µg/m³, rounded to 0.1.
A11 Last update Timestamp of the portal's last check cycle (seconds since 1970, UTC). Every cycle delivers a larger value, even without new measurements. This is how the block recognises that the portal is still delivering. An equal or smaller value does not count as new.
A12 Source data complete 1: all source data was available in the last check cycle. 0: parts were missing, the values may be incomplete.
DV Data present 1 as soon as a value exists (stored or received). Kept by the block and not reported to the portal.
DA Data current 1 while a new timestamp has arrived since the start and the timeout has not expired. Kept by the block and not reported to the portal.

Parameters

Timeout data outdated Minutes without a new timestamp from the portal after which "Data current" falls to 0. Default 150 min (two and a half check cycles). 0 = the data is never reported as outdated.