Output Description

DONE

Data_Type Default_Value Range Unit
BOOL - TRUE / FALSE -

Output DONE indicates the state of execution.

It has the value TRUE when the execution is finished and the outputs are valid. When DONE becomes FALSE other outputs are not valid any more.

ERR

Data_Type Default_Value Range Unit
BOOL - TRUE / FALSE -

Output ERR indicates whether an error occurred during Function Block execution.

It is only valid when DONE is TRUE. The kind of occurred error is specified by the error identifier at output ERNO.

ERNO

Data_Type Default_Value Range Unit
WORD - 0 … 65535 -

At output ERNO the identifier of an occurred error is provided. It is only valid when DONE and ERR is TRUE. (see, error messages): Error Messages of the Function Block Libraries

AZIMUTH   LREAL \   (azimuth)

Topocentric azimuth. Eastward from north (0°=360°=north, 90°=east, 180°=south, 270°=west).

Format: degrees.

Range of values: from 0 to 359.9999.

Error Values:

  • North Hemisphere: area between latitudes from 70° to 24°. In this area the accuracy of function SOLAR_NOAA is ±0,02° azimuth.
  • South Hemisphere: area between latitudes from -70° to -24°. In this area the accuracy of function SOLAR_NOAA is ±0,08° azimuth.
  • Equator: area between 24° and -24°. In this area the accuracy of function SOLAR_NOAA is 0,08° azimuth. Note that in this area, around 12:00 h (solar time) maximum error values may be greater because of the high speed of the azimuth axis at 12.00 h (solar time). It must move from 90° to 270° in a few seconds.

ELEVATION_UNCORRECTED   LREAL \   (elevation_uncorrected)

Topocentric elevation angle (0°=sunrise, 90°=zenith).

Format: degrees.

Range of values:  -90.00…90.00. Negative values=darkness.

Elevation error: ±0.015°.

Note

If elevation goes through zero at special locations at sunset / sunrise, also slightly larger errors can occur (mind that energy production is close to zero anyway).

Note

For latitudes greater than 72° north or less than 72° south, accuracy may be lower due in part to the effects of atmospheric refraction.

ELEVATION_CORRECTED   LREAL \   (elevation_corrected)

Topocentric elevation angle (0°=sunrise, 90°=zenith). This value includes atmospheric refraction effects.

Format: degrees.

Range of values:  -90.00…90.00. Negative values=darkness.

Elevation Error: ±0.015°.

Note

If elevation goes through zero at special locations at sunset / sunrise, also slightly larger errors can occur (mind that energy production is close to zero anyway).

P = 1010 mBar.

Temp = 10°C.

Refraction = 0,5667.

Note

Atmospheric refraction is the angular displacement of astronomical objects from their true or geometrical position, because of the bending of rays in the earth’s atmosphere.