GDAS pollen|
This function block provides the pollen load of the GDAS portal for the plant's location: six pollen species with level and range, the highest current value, the overall level, the daily maximum and a recommendation. They are model values of the portal, not a sensor at the plant. Levels and texts. All six species use the same thresholds, there is no species-specific classification: up to 0 is level 0 (none), above 0 to 20 level 1 (low), above 20 to 80 level 2 (moderate), above 80 to 200 level 3 (high), above that level 4 (very high). The overall level and the recommendation refer to all six species. The recommendations are general hints and not a personal medical recommendation; a window automation should not rely on them alone. 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 A23 (Last update) and A24 (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 | Pollen Alder | Pollen concentration in grains per m³. |
| A2 | Pollen Birch | Pollen concentration in grains per m³. |
| A3 | Pollen Grass | Pollen concentration in grains per m³. |
| A4 | Pollen Ragweed | Pollen concentration in grains per m³. |
| A5 | Pollen Mugwort | Pollen concentration in grains per m³. |
| A6 | Pollen Olive | Pollen concentration in grains per m³. |
| A7 | Pollen highest value | Highest single value of the six species. This is the maximum, not a sum. |
| A8 | Pollen overall level | Integer 0 (none) to 4 (very high), based on all six species. A personal allergy profile is not taken into account. |
| A9 | Pollen daily maximum | Highest value of all species and all hours of the day. Also the maximum, not a sum. |
| A10 | Pollen recommendation | Text based on the highest current value: "Niedrig - kein Schutz noetig" (up to 20), "Maessig - Fenster nachts zu" (up to 80), "Hoch - Fenster geschlossen" (up to 200), "Sehr hoch - draussen meiden" (above). |
| A11 | Pollen Alder level | Level of this species, integer 0 to 4. |
| A12 | Pollen Alder range | Text for the level: "0", "0 bis 20", "20 bis 80", "80 bis 200" or "ueber 200". |
| A13 | Pollen Birch level | Level of this species, integer 0 to 4. |
| A14 | Pollen Birch range | Text for the level: "0", "0 bis 20", "20 bis 80", "80 bis 200" or "ueber 200". |
| A15 | Pollen Grass level | Level of this species, integer 0 to 4. |
| A16 | Pollen Grass range | Text for the level: "0", "0 bis 20", "20 bis 80", "80 bis 200" or "ueber 200". |
| A17 | Pollen Ragweed level | Level of this species, integer 0 to 4. |
| A18 | Pollen Ragweed range | Text for the level: "0", "0 bis 20", "20 bis 80", "80 bis 200" or "ueber 200". |
| A19 | Pollen Mugwort level | Level of this species, integer 0 to 4. |
| A20 | Pollen Mugwort range | Text for the level: "0", "0 bis 20", "20 bis 80", "80 bis 200" or "ueber 200". |
| A21 | Pollen Olive level | Level of this species, integer 0 to 4. |
| A22 | Pollen Olive range | Text for the level: "0", "0 bis 20", "20 bis 80", "80 bis 200" or "ueber 200". |
| A23 | 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. |
| A24 | 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. | |