GDAS weather|
This function block provides the current weather values of the GDAS portal for the plant's location: temperature, humidity, air pressure, wind, precipitation and a weather description. They are model values at the configured location, not a weather station. If you need the readings of your own weather station, use the Block weather station block. Meaning of the values. The precipitation rate is the amount of precipitation of the current interval, extrapolated to one hour (0.3 mm in 15 minutes give 1.2 mm/h), not the measurement of a device. The daily precipitation is the sum forecast for the whole of today, not the amount measured since midnight. The air pressure is preferably reduced to sea level; if that value is missing, the surface pressure is used, without any indication. The wind direction is the direction the wind comes from, clockwise from north (90 east, 180 south, 270 west). The weather description is one of these texts: Klar, Heiter, Teils bewoelkt, Bewoelkt, Nebel, Nieselregen, Regen, Eisregen, Schneefall, Regenschauer, Schneeschauer, Gewitter, Unbekannt. The block does not deliver a multi-day forecast, wind gusts or solar irradiation. 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 A9 (Last update) and A10 (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 about every 15 minutes 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 | Temperature | In °C. |
| A2 | Relative humidity | In %, 0 to 100. |
| A3 | Air pressure | In hPa, preferably reduced to sea level. |
| A4 | Wind speed | In km/h. |
| A5 | Wind direction | In degrees, 0 = north. The direction the wind comes from. |
| A6 | Precipitation rate | In mm/h, see above. Do not confuse with the daily precipitation. |
| A7 | Forecast daily precipitation | In mm. Forecast sum for the whole of today, not a measured counter. |
| A8 | Weather description | Text, see above. A description, not a recommendation for action. |
| A9 | 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. |
| A10 | 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 40 min (two and a half check cycles). 0 = the data is never reported as outdated. | |