Overview GDAS UV index



This function block provides the UV values of the GDAS portal for the plant's location: the current UV index, the UV level, the daily maximum with its hour, the UV index under a clear sky and a protection recommendation. They are model values of the portal, not a sensor at the plant, and a UV index is not a measured irradiation in W/m².

Levels and texts. The UV level follows the UV index: up to 2 is level 0 (low), above 2 to 5 level 1 (moderate), above 5 to 7 level 2 (high), above 7 to 10 level 3 (very high), above that level 4 (extreme). The protection recommendation has its own limits (below 3, below 6, below 8, above), they do not coincide with the level, for example at a UV index of 2.5. Both values are taken from the portal independently and are not recalculated in the block.

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 A7 (Last update) and A8 (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 UV now Current UV index, resolution 0.1.
A2 UV level Integer 0 (low) to 4 (extreme).
A3 UV daily maximum Highest hourly value forecast for today.
A4 Hour of the UV maximum Hour of the first maximum in local time, 0 to 23. If the index is 0 all day, the hour is 0.
A5 UV under a clear sky Model value under a cloudless sky, not a separate sensor.
A6 UV protection recommendation Text: "Niedrig - kein Schutz noetig", "Maessig - Schutz empfohlen", "Hoch - Schutz noetig" or "Sehr hoch - Mittagssonne meiden".
A7 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.
A8 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.