OptStartHeat
OptStartHeat (FB)
FUNCTION_BLOCK OptStartHeat
Short description
Start-up optimization for heating operation with an internal weekly clock (principle: variable preheating time) Goal: Room temperature = setpoint temperature at the start of day operation Typical application: zone control loop with heating valve
Representation

Interfaces
Inputs
xEn
BOOL
FALSE
General enable of the start-up optimization
xEnAdapt
BOOL
TRUE
Enable data storage in the historical memory
xResAdapt
BOOL
TRUE
Reset of the historical memory
rTo
REAL
Current outside temperature
rTi
REAL
Current room temperature
rSetTemp
REAL
Current room setpoint temperature in comfort/day operation
Outputs
xDaytime
BOOL
FALSE
Enable of comfort/day operation (Off = FALSE, On = TRUE)
xProcess
BOOL
FALSE
Enable - preheating process (Off = FALSE, On = TRUE)
bState
BYTE
0
Phase of the preheating process (0=Off/Deactivated, 1 = test time, 2 = dead time, 3 = heating time, 4 = end of heating time)
wError
WORD
0
Error status of the last preheating process
bResult
BYTE
0
Quality of the last preheating process (0 = invalid, 1 = good, 2 = normal, 3 = poor)
xActive
BOOL
FALSE
State of the weekly clock channel (Off = FALSE, On = TRUE)
uiDeadTime
UINT
0
Display of the current dead time duration (min)
uiHeatTime
UINT
0
Display of the current heating time duration (min)
uiNumber
UINT
0
Display of the total number of successful preheating processes
rAverageDiff
REAL
0.0
Average absolute room temperature deviation of the last 10 successful preheating processes
Setpoints / Parameters
uiHGMin
UINT
30
Minimum value - heating gradient (min/K)
uiHGMax
UINT
240
Maximum value - heating gradient (min/K)
uiDTMin
UINT
10
Minimum value - dead time (min)
uiDTMax
UINT
180
Maximum value - dead time (min)
uiHTMin
UINT
15
Minimum value - heating time (min)
uiHTMax
UINT
600
Maximum value - heating time (min)
todMonFrom
TOD
TOD#07:00
Switch-on time - Monday
todMonTo
TOD
TOD#12:00
Switch-off time - Monday
xMonMode
BOOL
TRUE
Mode - switching period - Monday
todTueFrom
TOD
TOD#07:00
Switch-on time - Tuesday
todTueTo
TOD
TOD#12:00
Switch-off time - Tuesday
xTueMode
BOOL
TRUE
Mode - switching period - Tuesday
todWedFrom
TOD
TOD#07:00
Switch-on time - Wednesday
todWedTo
TOD
TOD#12:00
Switch-off time - Wednesday
xWedMode
BOOL
TRUE
Mode - switching period - Wednesday
todThuFrom
TOD
TOD#07:00
Switch-on time - Thursday
todThuTo
TOD
TOD#12:00
Switch-off time - Thursday
xThuMode
BOOL
TRUE
Mode - switching period - Thursday
todFriFrom
TOD
TOD#07:00
Switch-on time - Friday
todFriTo
TOD
TOD#12:00
Switch-off time - Friday
xFriMode
BOOL
TRUE
Mode - switching period - Friday
todSatFrom
TOD
TOD#07:00
Switch-on time - Saturday
todSatTo
TOD
TOD#12:00
Switch-off time - Saturday
xSatMode
BOOL
TRUE
Mode - switching period - Saturday
todSunFrom
TOD
TOD#07:00
Switch-on time - Sunday
todSunTo
TOD
TOD#12:00
Switch-off time - Sunday
xSunMode
BOOL
TRUE
Mode - switching period - Sunday
sNotice
STRING
‘Custom note - click to change.’
Label - time switch
Global variables
gc_Parameters.rTOMin
REAL
-25
Minimum value - outside temperature (°C)
gc_Parameters.rTOMax
REAL
25
Maximum value - outside temperature (°C)
gc_Parameters.rTIMin
REAL
15
Minimum value - room temperature (°C)
gc_Parameters.rTIMax
REAL
30
Maximum value - room temperature (°C)
gc_Parameters.rDiffSetTemp
REAL
0
Deviation from the room setpoint temperature at the end of the preheating process (K)
gc_Parameters.rDTDiffTemp
REAL
0.2
Increase in room temperature to detect the end of the dead time (K)
gc_Parameters.uiPHMaxTime
UINT
720
Maximum duration of the preheating process
gc_Parameters.rLimitResultWell
REAL
0.5
Result display: room temperature deviation - threshold value for a good preheating process
gc_Parameters.rLimitResultNormal
REAL
1
Result display: room temperature deviation - threshold value for a normal preheating process
Functional description
The output xDaytime is activated when the start-up optimization is generally enabled (xEn = TRUE), depending on the historical data, the current outside temperature, the current room temperature, and the current setpoint temperature for day/comfort operation before the planned start of comfort/day operation. This preheating ensures that the room temperature already corresponds to the desired setpoint temperature at the start of day operation. The preheating time required for this is individual recalculated; the actual preheating time is additionally incorporated into the historical data. Preheating processes spanning multiple days are possible. The start-up optimization is used to save energy and increase operating comfort. The components relevant to the start-up optimization are processed every 60 s. The preheating process is divided into four time sections. They are passed through one after the other for each successful preheating process. The preheating process can end before, exactly at, or after the switch-on time (= transition to comfort/day operation).

Test time (bState = 1)
The test time is used for cyclical checking (every 60 s) whether the conditions for enabling preheating are met. It begins if the following conditions are met simultaneously:
The preheating process is not active (xProcess = FALSE)
The weekly clock is not active (xActive = FALSE)
A valid next switch-on time exists
It ends properly if the conditions for enabling preheating are met (= start of dead time). It ends in any case if the next valid switch-on time is the same as the current time.
Dead time (bState = 2)
The dead time serves to precondition the heating.
It begins with the proper end of the test time.
It ends properly if the current room temperature rTi the room temperature at the start of the dead time by the adjustable difference gc_Parameters.rDTDiffTemp continuously exceeds for a duration of at least 120 s (= start of heating time).
It ends in any case if the next valid switch-on time is the same as the current time.
Heating time (bState = 3)
The heating time serves to preheat the zone.
It begins with the proper end of the dead time.
It ends properly if the current room temperature rTI the current room setpoint temperature in comfort/day operation rSetTemp approaches continuously for a duration of at least 120 s to within a difference smaller than the global variable gc_Parameters.rDiffSetTemp is detected.
It ends if the current heating time duration exceeds the adjustable maximum value xActive is detected.
It ends if the current heating time duration exceeds the adjustable maximum value uiHTMax exceeds.
End of heating time (bState = 4)
The end of heating time serves to complete the successful preheating process. The historical data are updated, provided no limit values are violated, if the enable for data storage in the historical memory (xEnAdapt) is active. It begins with the proper end of the heating time.
Enable xEn
This input serves as the general enable for the start-up optimization (xEn = TRUE). In the blocked state (xEn = FALSE), the outputs are defined as follows:
xDaytime
FALSE
xProcess
FALSE
bState
0
wError
0
bResult
0
uiDeadTime
0
uiHeatTime
0
uiNumber
0
rAverageDiff
0
The historical data are retained even in the blocked state. This input can also be used to superimpose sensor faults (fault - room temperature sensor, fault - outside temperature sensor) or for operation of the zone in occupied time extension.
Enable xEnAdapt
This input serves to enable data storage in the historical memory (xEnAdapt = TRUE, prerequisite: xEn = TRUE). After each successful preheating process, the relevant parameters are stored and are therefore available again during the next preheating process. In the blocked state (xEnAdapt = FALSE) no data storage takes place.
Enable xResAdapt
This input serves to initialize the historical memory on every rising signal edge (prerequisite: xEn = TRUE).
Heating gradients
uiHGMax
Dead times
uiDTMax
Number of preheating processes
0
In addition, the buffer memory for the average absolute room temperature deviation of the last 10 successful preheating processes and the data memory for the current data are reset.
Input rTo
This input serves to capture the current outside temperature.
It is additionally time-filtered and limited for the start-up optimization (minimum value = gc_Parameters.rTOMin, maximum value = gc_Parameters.rTOMax ).
Input rTi
This input serves to capture the current room temperature.
It is additionally time-filtered and limited for the start-up optimization (minimum value = gc_Parameters.rTIMin, maximum value = gc_Parameters.rTIMax).
Input rSetTemp
This input serves to capture the current room setpoint temperature for comfort/day operation. With every change of the setpoint temperature, a reset to the default state occurs (see enable xEn - blocked state).
Output xDaytime
This output serves to enable comfort/day operation (Off = FALSE, On = TRUE) by the start-up optimization. It is activated when the transition from test time to dead time occurs. It is deactivated if the next valid switch-on time is reached.
Output xProcess
This output serves to display the active preheating process (Off = FALSE, On = TRUE). It is active if the preheating process is in phases 1 - 4 and / or the output xDaytime is active.
Output bState
This output serves to display the active phase of the preheating process.
0
Off / Deactivated
1
Test time active
2
Dead time active
3
Heating time active
4
End of heating time active
Output wError
This output serves to display warnings / errors during the last preheating process. Each message is assigned a bit (Bit = 0 = no error, Bit = 1 = warning / error active). This output is continuously updated. With every change, the date / current time is additionally recorded. This output is always initialized to 0 (= no error) at the start of the test time. With every occurrence of an error, the preheating process is stopped and the phase 'Off / Deactivated' is initiated. With every occurrence of a warning, the output wError is updated.
1
Exceeding the maximum heating time
Error
4
Heating gradient threshold violation
Warning
5
Dead time threshold violation
Warning
6
Undercutting of the minimum heating time
Warning
Output bResult
This output serves to display the quality of the last successful preheating process.
The output is updated at the switch-on time (= transition to comfort/day operation) if required.
The absolute value from the calculation of rSetTemp - gc_Parameters.rDiffSetTemp - rTi is used for the evaluation.
This output is always initialized to 0 (= no result) at the start of the test time.
Result
Threshold
bResult
Notes
less than
gc_Parameters.rLimitResultWell
1
Good preheating process
less than
gc_Parameters.rLimitResultNormal
2
Normal preheating process
greater than or equal to
gc_Parameters.rLimitResultNormal
3
Poor preheating process
Output xActive
This output serves to display the state of the weekly clock channel (Off = FALSE, On = TRUE). The weekly clock is continuously updated независимо on the state of xEn (= General enable of the start-up optimization) is updated. With every change to the weekly clock settings, a reset to the default state occurs (see enable xEn - blocked state).
Output uiDeadTime
This output serves to display the current dead time duration (min). This output is always initialized to 0 min at the start of the test time.
Output uiHeatTime
This output serves to display the current heating time duration (min). This output is always initialized to 0 min at the start of the test time.
Output uiNumber
This output serves to display the total number of successful preheating processes.
Output rAverageDiff
This output serves to display the average absolute room temperature deviation of the last 10 successful preheating processes. This output is always after the update of output bResult updated. This output is initialized with 0 K on every rising signal edge at input xResAdapt is initialized to 0 K.
1. Preheating process
After the software download or after every rising signal edge at input xResAdapt the historical data are reinitialized. The dead times are then assigned the parameter uiDTMax, the heating gradients with the parameter uiHGMax and the number of successful preheating processes with the value 0.
Parameter uiHGMin
This parameter is used to define the minimum permissible heating gradient (min/K). It is used to check for limit violations. In the event of a limit violation, the historical data are not updated.
Parameter uiHGMax
This parameter is used to define the maximum permissible heating gradient (min/K). It is used to check for limit violations. In the event of a limit violation, the historical data are not updated.
Parameter uiDTMin
This parameter is used to define the minimum permissible dead time (min). It is used to check for limit violations. In the event of a limit violation, the historical data are not updated.
Parameter uiDTMax
This parameter is used to define the maximum permissible dead time (min). It is used to check for limit violations. In the event of a limit violation, the historical data are not updated.
Parameter uiHTMin
This parameter is used to define the minimum permissible heating time (min). It is used to check for limit violations.
Parameter uiHTMax
This parameter is used to define the maximum permissible heating time (min). It is used to check for limit violations. With every occurrence of a limit violation, the preheating process is stopped and the phase 'Off / Deactivated' is initiated.
Parameter todMonFrom - sNotice
These parameters are used to set the weekly clock. The general mode of operation is described in detail in the description of the function block 'Clock7d1Ch'.
Global variable gc_Parameters.rTOMin
This global variable is used to define the minimum permissible outside temperature (°C). It is used to check and correct limit violations.
Global variable gc_Parameters.rTOMax
This global variable is used to define the maximum permissible outside temperature (°C). It is used to check and correct limit violations.
Global variable gc_Parameters.rTIMin
This global variable is used to define the minimum permissible room temperature (°C). It is used to check and correct limit violations.
Global variable gc_Parameters.rTIMax
This global variable is used to define the maximum permissible room temperature (°C). It is used to check and correct limit violations.
Global variable gc_Parameters.rDiffSetTemp
This global variable is used to define the deviation from the room setpoint temperature at the end of the preheating process (K). It specifies how far the room temperature must approach the setpoint temperature in day/comfort operation in order to end the active preheating process.
Global variable gc_Parameters.rDTDiffTemp
This global variable is used to define the increase in room temperature for detecting the end of the dead time (K). It specifies how much the room temperature must increase continuously during the dead time in order to initiate the heating time.
Global variable gc_Parameters.uiPHMaxTime
This global variable is used to define the maximum duration of the preheating process. It is used for internal calculations.
Global variable gc_Parameters.rLimitResultWell
This global variable is used to define the threshold value 'Good preheating process' for the quality display bResult.
Global variable gc_Parameters.rLimitResultNormal
This global variable is used to define the threshold value 'Normal preheating process' for the quality display bResult.
Typical application
This function block can be used as follows:

CODESYS
InOut:
Input
xEn
BOOL
FALSE
Input
xEnAdapt
BOOL
TRUE
Input
xResAdapt
BOOL
FALSE
Input
rTo
REAL
Input
rTi
REAL
Input
rSetTemp
REAL
Output
xDaytime
BOOL
FALSE
Output
xProcess
BOOL
FALSE
Output
bState
BYTE
0
Output
wError
WORD
0
Output
bResult
BYTE
0
Output
xActive
BOOL
FALSE
Output
uiDeadTime
UINT
0
Output
uiHeatTime
UINT
0
Output
uiNumber
UINT
0
Output
rAverageDiff
REAL
0.0
Input Const
uiHGMin
UINT
30
Input Const
uiHGMax
UINT
240
Input Const
uiDTMin
UINT
10
Input Const
uiDTMax
UINT
180
Input Const
uiHTMin
UINT
15
Input Const
uiHTMax
UINT
600
Input Const
todMonFrom
TOD
TIME_OF_DAY#7:0
Input Const
todMonTo
TOD
TIME_OF_DAY#18:0
Input Const
xMonMode
BOOL
TRUE
Input Const
todTueFrom
TOD
TIME_OF_DAY#7:0
Input Const
todTueTo
TOD
TIME_OF_DAY#18:0
Input Const
xTueMode
BOOL
TRUE
Input Const
todWedFrom
TOD
TIME_OF_DAY#7:0
Input Const
todWedTo
TOD
TIME_OF_DAY#18:0
Input Const
xWedMode
BOOL
TRUE
Input Const
todThuFrom
TOD
TIME_OF_DAY#7:0
Input Const
todThuTo
TOD
TIME_OF_DAY#18:0
Input Const
xThuMode
BOOL
TRUE
Input Const
todFriFrom
TOD
TIME_OF_DAY#7:0
Input Const
todFriTo
TOD
TIME_OF_DAY#18:0
Input Const
xFriMode
BOOL
TRUE
Input Const
todSatFrom
TOD
TIME_OF_DAY#7:0
Input Const
todSatTo
TOD
TIME_OF_DAY#18:0
Input Const
xSatMode
BOOL
TRUE
Input Const
todSunFrom
TOD
TIME_OF_DAY#7:0
Input Const
todSunTo
TOD
TIME_OF_DAY#18:0
Input Const
xSunMode
BOOL
TRUE
Input Const
sNotice
STRING
‘Notice’
Last updated

