Green City Library Help

CBControlHeatLedContinuous

Symbol

CBHeatCont_Connectors_Basic.png

Use

This model controls the operation of a simulated condensing boiler (CB) prioritizing heat demand (temperature spread between actual and reference temperature) of an external heat sink (building, heat storage, heat supply via hydraulic shunt). Using this controller the demanded electrical and heat power output is modulated continuously. It should thus be used with the corresponding condensing boiler models (i.e. gas-fired condensing boilers ). Due to the variable maximum and minimum heat power outputs (cf. model data) of such condensing boiler systems, the controller uses relative heat power output as the control state.

The CBControlHeatLedContinuous covers the following applications:

  • Basic: CBControlHeatLedContinuous for a boiler with an ambient temperature independent volume flow control and no auxiliary heating elements

  • Ambient Flow Regulation: Controls the boilers volume flow based on the ambient temperature

  • Auxiliary Heating: CBControlHeatLedContinuous is enabled to control the boilers internal electrical heating components through parameterization

Parameters and Connectors

Basic

CBHeatCont_Connectors_Basic.png

The boiler controller requires the various temperatures as input parameters to control the boiler:

  • Setpoint temperature in the flow line on the heat sink side ▶TFlowRef

  • Setpoint temperature to which the boiler is to be controlled ▶TRef

  • Current temperature of the component to which ▶TRef is to be controlled ▶TAct

  • Temperature in the flow line on the heat sink side ▶TFlow

  • Temperature in the return line on the heat sink side ▶TReturn

The Boolean connector ▶Enable, which comes from an external controller or input signal and specifies when the boiler should be active, must also be connected. ▶Enable allows the implementation of a complex switch-on control for the boiler in addition to the internal control of the boiler controller and to control the boiler autonomously the connector can be defined with a static true argument. To control the reference temperature independent of the ambient temperature define an own temperature target curve with ▶TFlowRef. The output parameters must then be linked to the respective input parameters of the boiler model.

CBHeatCont_Parameter_CB.png

The CBControlHeatLedDiscrete is parameterized to control the model independent of the ambient temperature (FlowControl is false) and to not have any auxiliary heating system (AuxHeat is false).

CBHeatCont_Parameter_Timing.png

The user is given the possibility to vary internal operation time constants (e.g. minimum switch-on/off time etc.) of the boiler controller. These times are the delay in starting the boiler compared to the circulation pump tDelayCB, the minimum switch-on time tCBminOn and the minimum switch-off time of the CHP tCBminOff. If the corresponding data files of the boiler controller are not available the pre-defined values should be used. For the circulation pump, there is also a time delay for switching off the circulation pump compared to the boiler tDelayCP. More information is available in the Model Background.

CBHeatCont_Parameter_IO.png

When the maximum flow temperature TFlowMax or maximum return temperature TReturnMax is reached, the boiler is switched off by the controller. While the parameters deltaTActRefLow and deltaTActRefUp represent the limit values for switching the boiler on or off.

CBHeatCont_Parameter_Vol.png

The flow temperature of the boiler is controlled by a temperature hysteresis using the max difference between the flow temperature ▶TFlow and the reference flow temperature ▶TFlowRef (in the current flow control mode, FlowControl is false). For the parameterization of deltaTFlowRefMax and deltaTFlowRefMin use the help of the background information.

The maximum volume qvMax depends on the selected circulation pump (ref. GreenCity/Data/ModelData/condensing_boiler/circulation_pump), however the minimum volume flow qvMin can be defined using the boiler system data sheet. Ensure that the minimum volume flow qvMin is set to a value above zero, otherwise the volume flow control is not activated. Note that the minimum volume flow should be set to a level where heat power output is possible with an adequate temperature spread (▶TFlow-▶TReturn). If this value is too high, the volume flow control can cause system state faults. More information is available in the Model Background.

Ambient Flow Regulation

CBHeatCont_Connectors_Flow.png
CBHeatCont_Parameter_CB_Flow.png

Setting the parameter FlowControl to true, the reference flow temperature of the boiler is defined dependent on the ambient temperature over the connector ▶EnvironmentConditions and used to control the reference volume flow of the boiler.

CBHeatCont_Parameter_Flow_Flow.png

The reference flow temperature is defined using the flow temperature characteristics specified in the model data directory FlowFile (GreenCity/Data/ModelData/condensing_boiler/control which is not visible in SimulationX) and the decision for a table FlowTable, which maps the ambient temperature to a target flow temperature. If the prepared flow temperature curves doesn't match the desired curve, use the FlowFile as template for your own target flow temperature curves.

To avoid high dynamic oscillations during the simulation the average ambient temperature is used for flow temperature control. To calculate the average ambient temperature a number of support points SupportPointsAmbientTemperature and a time step size TimeStepAmbientTemperature must be defined in the flow control parameter dialog. The time difference between each data point characterizes the time step TimeStepAmbientTemperature. Note that for the calculation the initial ambient temperature is used as a data point for every support point. If a static reference flow temperature is to be used for the simulation, the FlowControl parameter under Controller Configuration should be set to false.

CBHeatCont_Parameter_Power.png

For the control of the heating power the condensing boiler controller requires the maximum and minimum relative heat power of the boiler QHeatMaxRelative and QHeatMinRelative to define the modulation limits (more details.

Auxiliary Heating

CBHeatCont_Connectors_Aux.png
CBHeatCont_Parameter_CB_Aux.png

At the activation of the auxiliary heating system (AuxHeat is true) the output connector ▶AUXon is visible and must be connected to the boiler.

CBHeatCont_Parameter_Timing_Aux.png

To ensure that the auxiliary heating system is only switched-on when the heat demand of the consumers can not be supplied by the boiler, it only is activated if the actual heating system temperature is below the minimum level, for a pre-defined time period (tBivalence).

CBHeatCont_Parameter_IO_Aux.png

In the tab I/O - Control the switch on and switch off temperature differences (deltaTAuxRefLow and deltaTAuxRefUp) must be defined. The switch-off temperature level of the auxiliary heating system deltaTAuxRefUp should be set below the correspondent temperature level, for the overall system switch-off deltaTActRefUp, to avoid extensive usage of the auxiliary heating system (i.e. the auxiliary heating system should work as a slave system only when needed). More information is available in the Model Background.

Model Background

Pre- and Post-run Time of Components

The logic of the time delay can be seen in the following figure. The CHP (▶CBon) is only switched on after the circulation pump is switched on and the time tDelayCB (3 seconds in the figure) has elapsed. The logic for tDelayCP is analogue. This results in the ▶CBon signal being switched on at 4s after the circulation pump is switched on at time step 1s. The circulation pump is then switched off 4s (tDelayCP) after the unit is switched off.

CBHeatCont_Background_Delay.png

Prevention of Continuous Switching

The following illustration shows how the tBivalence parameter works. In this case, it is assumed that the switch-on limit (deltaTAuxRefLow) for the auxiliary heating is 3 Kelvin and the switch-off limit (deltaTAuxRefUp) is 1 Kelvin. This temperature difference is calculated by ▶TRef-▶TAct. The image shows that the switch-on limit must be reached for at least the duration tBivalence (here 2 seconds) . If the temperature difference decreases within this period (as in the first case at time 3 s), no switch-on signal is issued. The auxiliary heating is only switched on when the temperature difference is reached for a full 2 seconds period (in the image at time 6 s). ▶AUXon is then switched off when the temperature falls below the lower temperature limit at time 10 s.

CBHeatCont_Background_tBivalence.png

Volume Flow And Heating Power Modulation Control

The volume flow of the circulation pump is defined by a linear approach as shown in the following figure. The decisive factor is the temperature difference between ▶TFlow and ▶TFlowRef. At the value deltaTFlowRefMax (in the image 3 K) the maximum volume flow qvMax is assumed to reduce the temperature stroke inside the generator. At the temperature difference deltaTFlowRefMin (in the image -10 K) the minimum volume flow qvMin is used to limit the temperature stroke. Linear interpolation takes place between the extreme values in order to achieve the desired set flow temperature ▶TFlowRef.

CBHeatCont_Background_VolumeFlow.png

If the heating power is modulated, it's behavior is analogue to the volume flow control.

If: (TAct-TRef)>deltaTActRefLow, reference heat power is max. If: (TAct-TRef)<deltaTActRefUp, reference heat power is min. Between the two temperature boundaries the reference heat power output is linearly interpolated.

Switch on/off

The boiler heat led controller uses the maximum flow and return temperature and a temperature hysteresis around the reference temperature of the connected heating system (heat storage, hydraulic shunt, building zone) as a control parameter to switch the system on/off:

If: (TAct-TRef)<deltaTActRefLow, boiler is switched-on. If: (TAct-TRef)>deltaTActRefUp, boiler is switched-off.

If an auxiliary heating system is to be controlled a corresponding temperature hysteresis using the reference temperature of the connected heating system must be defined:

If: (TAct-TRef)<deltaTAuxRefLow, auxiliary heating system is switched-on. If: (TAct-TRef)>deltaTAuxRefUp, auxiliary heating system is switched-off.
26 September 2025