ForecastOutsideTemp

ForecastOutsideTemp (FB)

FUNCTION_BLOCK ForecastOutsideTemp

Kurzbeschreibung

Vorhersage der Außentemperatur ( Vorhersagezeitraum und Funktion einstellbar ) Voraussetzung: FB ‘WeatherForecast’ aus der Weather Forecast Library Randbedingung: Die Wettervorhersagedaten müssen mindestens alle 12 Stunden aktualisiert werden Index _FC: Wetter-Vorhersagedaten extern

Index _Int: Wetter-Vorhersagedaten intern | Typische Anwendung: Berechnung der Außentemperatur einer Heiz-/Kühlkurve

Darstellung

Schnittstellen

Eingänge

Name	Datentyp	Wertebereich	Initialwert	Funktion
xEn	BOOL		FALSE	Freigabe - Wettervorhersage ( FALSE = Aus, TRUE = Ein )
*rOutsideTemp_In’	REAL		-10.0	Ersatzwert für die Aussentemperatur
xOutsideTempError_In	BOOL		FALSE	Fehlerzustand - Ersatzwert für die Aussentemperatur ( FALSE = kein Fehler, TRUE = Fehler )
rFixedValue	REAL		0.0	Festwert für die Aussentemperatur
xError_FC	BOOL		FALSE	Fehlerzustand - Wetter-Vorhersagedaten ( FALSE = kein Fehler, TRUE = Fehler )
xDone_FC	BOOL		FALSE	Signal nach dem erfolgreichen Abschluss der Übertragung der Wetter-Vorhersagedaten ( ansteigende Flanke )
arData_FC	ARRAY[*] OF WEATHER_FORECAST.WeatherData			Array mit den Wetter-Vorhersagedaten ( Ausgang ‘aForecast’ vom FB ‘WeatherForecast’ )

Ausgänge

Name	Datentyp	Wertebereich	Initialwert	Funktion
*eMode’	eForecastOutsideTempMode		eForecastOutsideTempMode.Invalid_Mode	Betriebsart ( 0 = keine, 1 = Vorhersage, 2 = Außentemperatur, 3 = Festwert )
*eFBPeriod_Int’	eForecastOutsideTempPeriod		eForecastOutsideTempPeriod.Invaild_Period	Rückmeldung - Vorhersagebereich - Interne Wetter-Vorhersagedaten ( 0 = keine, 1 = 3 Stunden, 2 = 6 Stunden, 3 = 9 Stunden, 4 = 12 Stunden, 5 = 24 Stunden, 6 = 36 Stunden, 7 = 48 Stunden, 8 = 72 Stunden, 9 = 96 Stunden )
*eFBFunction_Int’	eForecastOutsideTempFunction		eForecastOutsideTempFunction.Ivalid_Function	Rückmeldung - Funktion - Interne Wetter-Vorhersagedaten ( 0 = keine, 1 = Minimalwert 2 = Maximalwert, 3 = Durchschnittswert )
*rOutsideTemp_Out’	REAL			Berechnete Aussentemperatur
xError	BOOL		FALSE	Fehlerzustand ( FALSE = kein Fehler, TRUE = Fehler )

Sollwerte / Parameter

Name	Datentyp	Wertebereich	Initialwert	Funktion
**eFBPeriod_Int’*	eForecastOutsideTempPeriod		eForecastOutsideTempPeriod.Time_24_Hours	Vorhersagebereich - Interne Wetter-Vorhersagedaten ( 0 = keine, 1 = 3 Stunden, 2 = 6 Stunden, 3 = 9 Stunden, 4 = 12 Stunden, 5 = 24 Stunden, 6 = 36 Stunden, 7 = 48 Stunden, 8 = 72 Stunden, 9 = 96 Stunden )
**eFBFunction_Int’*	eForecastOutsideTempFunction		eForecastOutsideTempFunction.Average	Funktion - Interne Wetter-Vorhersagedaten ( 0 = keine, 1 = Minimalwert 2 = Maximalwert, 3 = Durchschnittswert )

Funktionsbeschreibung

Der Ausgang *rOutsideTemp_Out* wird in Abhängigkeit vom Zustand am Eingang ‘xEn’ berechnet / festgelegt: xEn = FALSE: Der Ausgang *rOutsideTemp_Out* nimmt den Zustand des Ersatzwerts ( *rOutsideTemp_Out* = ‘rOutsideTemp_In’ ) an, falls der Ersatzwert fehlerfrei ( ‘xOutsideTempError_In’ = FALSE ) ist. Der Ausgang *rOutsideTemp_Out* nimmt den Zustand des Festwerts ( *rOutsideTemp_Out* = ‘rFixedValue’ ) an, falls der Ersatzwert fehlerhaft ( ‘xOutsideTempError_In’ = TRUE ) ist. Der Ausgang *eMode’ wird entsprechend aktualisiert. Der Ausgang ‘xError’ nimmt den Zustand FALSE an. Der Ausgang *eFBPeriod_Int’ nimmt den Zustand eForecastOutsideTempFunction.Ivalid_Function an. Der Ausgang *eFBFunction_Int’ nimmt den Zustand eForecastOutsideTempFunction.Ivalid_Function an xEn = TRUE: Der Ausgang rOutsideTemp_Out wird aufgrund der Parameter ‘ePeriod_Int’ ( ePriodInt <> eForecastOutsideTempPeriod.Invalid_Period ) und ‘eFunction_Int’ ( eFunctionInt <> eForecastOutsideTempFunction.Invalid_Function ) festgelegt, falls der Eingang ‘xError_FC’ den Wert FALSE und die interne Fehlervariable ebenfalls den Wert FALSE annehmen. Die Ausgänge *eFBPeriod_Int’ bzw. *eFBFunction_Int’ übernehmen die aktuellen Einstellwerte der Parameter *ePeriod_Int’ bzw. *eFBFunction_Int’. Der Ausgang rOutsideTemp_Out nimmt den Zustand des Ersatzwerts ( rOutsideTemp_Out = ‘rOutsideTemp_In’ ) an, falls der Ersatzwert fehlerfrei ( ‘xOutsideTempError_In’ = FALSE ) ist. Der Ausgang *eFBPeriod_Int’ nimmt den Zustand eForecastOutsideTempFunction.Ivalid_Function an. Der Ausgang *eFBFunction_Int’ nimmt den Zustand eForecastOutsideTempFunction.Ivalid_Function an Der Ausgang rOutsideTemp_Out nimmt den Zustand des Festwerts ( rOutsideTemp_Out = ‘rFixedValue’ ) an, falls der Ersatzwert fehlerhaft ( ‘xOutsideTempError_In’ = TRUE ) ist. Der Ausgang *eFBPeriod_Int’ nimmt den Zustand eForecastOutsideTempFunction.Ivalid_Function an. Der Ausgang *eFBFunction_Int’ nimmt den Zustand eForecastOutsideTempFunction.Ivalid_Function an Der Ausgang *eMode’ wird entsprechend aktualisiert. Der Ausgang ‘xError’ wird entsprechend aktualisiert.

Aktualisierung des Ausgangs rOutsideTemp_Out

Der Ausgang rOutsideTemp_Out wird ( Voraussetung: xEn = TRUE ) aktualisiert, falls mindestens eines der folgenden Kriterien zutrifft: Kriterium 1: Aktualisierung der Wetter-Vorhersagedaten ( ansteigende Flanke am Eingang ‘xDone_FC’ ) Kriterium 2: Änderung des Startindexes Kriterium 3: Änderung des Vorhersagebereichs ( Parameter *ePeriod_Int’ ) Kriterium 4: Änderung der Funktion ( Parameter *eFunction_Int’ ) Kriterium 5: Ansteigende Flanke am Eingang ‘xEn’ Der Startindex ändert sich, falls der aktuelle Zeitstempel ( = Systemzeit ) den Zeitstempel des nächsten Elements der Wetter-Vorhersagedaten erreicht. Der Ausgang rOutsideTemp_Out wird daher mindestens alle 3 Stunden aktualisiert. Der Ausgang rOutsideTemp_Out wird stets zeitrichtig berechnet, d.h. es werden alle Elemente der Wetter-Vorhersagedaten zur Berechnung heran gezogen, die sich zwischen dem Zeitpunkt der Aktualisierung und dem Zeitpunkt der Aktualisierung + Vorhersagebereich befinden. Im Falle eines internen Datenfehlers ( fehlende Daten, fehlerhafte Daten ) wird der Ausgang rOutsideTemp_Out mit einer intern festgelegten Konstante ( aktuell: -1000.0 ) beschrieben und der Zustand der internen Fehlervariable auf TRUE gesetzt.

Typische Anwendung

Dieser Funktionsbaustein kann wie folgt angewendet werden:

CODESYS

InOut:

Scope	Name	Type	Initial
Input	xEn	BOOL	TRUE
Input	rOutsideTemp_In	REAL
Input	xOutsideTempError_In	BOOL	FALSE
Input	rFixedValue	REAL	0.0
Input	xError_FC	BOOL	FALSE
Input	xDone_FC	BOOL	FALSE
Input	arData_FC	POINTER TO WEATHER_FORECAST.WeatherData
Output	eMode	eForecastOutsideTempMode	eForecastOutsideTempMode.Invalid_Mode
Output	eFBPeriod_Int	eForecastOutsideTempPeriod	eForecastOutsideTempPeriod.Invaild_Period
Output	eFBFunction_Int	eForecastOutsideTempFunction	eForecastOutsideTempFunction.Ivalid_Function
Output	rOutsideTemp_Out	REAL
Output	xError	BOOL	FALSE
Input Const	eFunction_Int	eForecastOutsideTempFunction	eForecastOutsideTempFunction.Average
Input Const	ePeriod_Int	eForecastOutsideTempPeriod	eForecastOutsideTempPeriod.Time_24_Hours

Methods:

mApplyFunction_Int

mCalculateOutsideTempOut_Int

mCalculateStartIndex_Int

mResetData_Int

mUpdateData_Int

Structure:

• mApplyFunction_Int (Method)

• mCalculateOutsideTempOut_Int (Method)

• mCalculateStartIndex_Int (Method)

• mResetData_Int (Method)

  • Rücksetzung aller internen Wetter-Vorhersagedaten auf ungültige Werte ***

• mUpdateData_Int (Method)