Buildings.Examples.Tutorial.CDL.Controls
Package with the controllers used in the tutorial
Information
Extends from Modelica.Icons.VariantsPackage (Icon for package containing variants).
Package Content
| Name | Description |
|---|---|
 BoilerReturn
|
Control for boiler return |
 EquipmentOnOff
|
Controller for equipment on/off control |
 OpenLoopBoilerReturn
|
Open loop controller for boiler return |
 OpenLoopEquipmentOnOff
|
Open loop controller for equipment on/off control |
 OpenLoopRadiatorSupply
|
Open loop controller for mixing valve in radiator loop |
 OpenLoopSystemOnOff
|
Open loop controller for system on/off |
 RadiatorSupply
|
Controller for mixing valve in radiator loop |
 SystemOnOff
|
Controller for system on/off |
 Validation
|
Buildings.Examples.Tutorial.CDL.Controls.BoilerReturn
Control for boiler return
Information
Controller that takes as an input the boiler return water temperature TRet
and outputs the valve control signal yVal.
The valve control signal is computed using a PI-controller that tracks a constant
set point of TSet.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Real | TSet | 333.15 | Set point for boiler temperature [K] |
| Real | k | 0.1 | Gain of controller |
| Time | Ti | 120 | Time constant of integrator block [s] |
Connectors
| Type | Name | Description |
|---|---|---|
| input RealInput | TRet | Return water temperature to boiler [K] |
| output RealOutput | yVal | Valve control signal [1] |
Modelica definition
block BoilerReturn "Control for boiler return"
parameter Real TSet(
final unit="K",
displayUnit="degC") = 333.15
"Set point for boiler temperature";
parameter Real k=0.1 "Gain of controller";
parameter Modelica.Units.SI.Time Ti=120 "Time constant of integrator block";
Buildings.Controls.OBC.CDL.Interfaces.RealInput TRet(
final unit="K",
displayUnit="degC")
"Return water temperature to boiler";
Buildings.Controls.OBC.CDL.Interfaces.RealOutput yVal(
final unit="1")
"Valve control signal";
Buildings.Controls.OBC.CDL.Reals.Sources.Constant T(
final k=TSet)
"Set point temperature";
Buildings.Controls.OBC.CDL.Reals.PID conPID(
final k=k,
final Ti=Ti,
reverseActing=false) "Controller for valve in boiler loop";
equation
connect(conPID.y, yVal);
connect(conPID.u_s, T.y);
connect(TRet, conPID.u_m);
end BoilerReturn;
Buildings.Examples.Tutorial.CDL.Controls.EquipmentOnOff
Controller for equipment on/off control
Information
Controller that takes as an input the boiler water temperature TBoi
and the system on command onSys, and outputs
the on command for the pumps onPum and the boiler onBoi.
The pump on command is the same as the system on command.
The boiler is switched on if the boiler temperature TBoi falls below
70°C and if onSys=true, and it switches off
if either TBoi exceeds 90°C or if onSys=false.
Connectors
| Type | Name | Description |
|---|---|---|
| input RealInput | TBoi | Boiler temperature [K] |
| input BooleanInput | onSys | System on command |
| output BooleanOutput | onPum | Pump on command |
| output BooleanOutput | onBoi | Boiler on command |
Modelica definition
block EquipmentOnOff "Controller for equipment on/off control"
Buildings.Controls.OBC.CDL.Interfaces.RealInput TBoi(
final unit="K",
displayUnit="degC")
"Boiler temperature";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput onSys
"System on command";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput onPum
"Pump on command";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput onBoi
"Boiler on command";
Buildings.Controls.OBC.CDL.Logical.And and1
"And operator to switch boiler on based on temperature and system on command";
Buildings.Controls.OBC.CDL.Logical.Not not1
"Negation of output signal, because boiler should be off if temperature exceed uHigh";
Buildings.Controls.OBC.CDL.Reals.Hysteresis hys(
uHigh=273.15 + 90,
uLow=273.15 + 70) "Hysteresis for on/off of boiler";
equation
connect(TBoi, hys.u);
connect(hys.y, not1.u);
connect(onSys, onPum);
connect(and1.u1, not1.y);
connect(and1.u2, onSys);
connect(and1.y, onBoi);
end EquipmentOnOff;
Buildings.Examples.Tutorial.CDL.Controls.OpenLoopBoilerReturn
Open loop controller for boiler return
Information
Open loop controller that outputs a constant control signal for the valve of the boiler return.
Connectors
| Type | Name | Description |
|---|---|---|
| input RealInput | TRet | Return water temperature to boiler [K] |
| output RealOutput | yVal | Valve control signal [1] |
Modelica definition
block OpenLoopBoilerReturn "Open loop controller for boiler return"
Buildings.Controls.OBC.CDL.Interfaces.RealInput TRet(
final unit="K",
displayUnit="degC")
"Return water temperature to boiler";
Buildings.Controls.OBC.CDL.Interfaces.RealOutput yVal(
final unit="1")
"Valve control signal";
Buildings.Controls.OBC.CDL.Reals.Sources.Constant con(k=1)
"Constant valve control signal";
equation
connect(con.y, yVal);
end OpenLoopBoilerReturn;
Buildings.Examples.Tutorial.CDL.Controls.OpenLoopEquipmentOnOff
Open loop controller for equipment on/off control
Information
Open loop controller that outputs a constant control signal for the system on command.
Connectors
| Type | Name | Description |
|---|---|---|
| input RealInput | TBoi | Boiler temperature [K] |
| input BooleanInput | onSys | System on command |
| output BooleanOutput | onPum | Pump on command |
| output BooleanOutput | onBoi | Boiler on command |
Modelica definition
block OpenLoopEquipmentOnOff
"Open loop controller for equipment on/off control"
Buildings.Controls.OBC.CDL.Interfaces.RealInput TBoi(
final unit="K",
displayUnit="degC")
"Boiler temperature";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput onSys
"System on command";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput onPum
"Pump on command";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput onBoi
"Boiler on command";
Buildings.Controls.OBC.CDL.Logical.Sources.Constant con(k=true)
"Constant control signal";
equation
connect(con.y, onBoi);
connect(con.y, onPum);
end OpenLoopEquipmentOnOff;
Buildings.Examples.Tutorial.CDL.Controls.OpenLoopRadiatorSupply
Open loop controller for mixing valve in radiator loop
Information
Open loop controller that outputs a constant control signal for the mixing valve of the radiator loop.
Connectors
| Type | Name | Description |
|---|---|---|
| input RealInput | TRoo | Room air temperature [K] |
| input RealInput | TSup | Measured supply water temperature [K] |
| output RealOutput | yVal | Valve control signal [1] |
Modelica definition
block OpenLoopRadiatorSupply
"Open loop controller for mixing valve in radiator loop"
Buildings.Controls.OBC.CDL.Interfaces.RealInput TRoo(
final unit="K",
displayUnit="degC")
"Room air temperature";
Buildings.Controls.OBC.CDL.Interfaces.RealInput TSup(
final unit="K",
displayUnit="degC")
"Measured supply water temperature";
Buildings.Controls.OBC.CDL.Interfaces.RealOutput yVal(
final unit="1")
"Valve control signal";
Buildings.Controls.OBC.CDL.Reals.Sources.Constant con(k=1)
"Constant valve control signal";
equation
connect(con.y, yVal);
end OpenLoopRadiatorSupply;
Buildings.Examples.Tutorial.CDL.Controls.OpenLoopSystemOnOff
Open loop controller for system on/off
Information
Open loop controller that outputs a constant control signal for the system on command.
Connectors
| Type | Name | Description |
|---|---|---|
| input RealInput | TOut | Outdoor air temperature [K] |
| input RealInput | TRoo | Room air temperature [K] |
| output BooleanOutput | onSys | System on command |
Modelica definition
block OpenLoopSystemOnOff
"Open loop controller for system on/off"
Buildings.Controls.OBC.CDL.Interfaces.RealInput TOut(
final unit="K",
displayUnit="degC")
"Outdoor air temperature";
Buildings.Controls.OBC.CDL.Interfaces.RealInput TRoo(
final unit="K",
displayUnit="degC")
"Room air temperature";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput onSys
"System on command";
Buildings.Controls.OBC.CDL.Logical.Sources.Constant con(k=true)
"Constant control signal";
equation
connect(con.y, onSys);
end OpenLoopSystemOnOff;
Buildings.Examples.Tutorial.CDL.Controls.RadiatorSupply
Controller for mixing valve in radiator loop
Information
Controller that takes as an input the room air temperature TRoo and
the supply water temperature TSup,
and outputs the commanded mixing valve position yVal.
Based on the room air temperature TRoo, and the user adjustable parameters
for the minimum supply water temperature TSupMin,
the maximum supply water temperature TSupMax
and the room air temperature TRooMin
at which the supply water temperature is at TSupMax,
the controller computes a set point for the supply water temperature.
This set point is then used with the measured supply water temperature TSup
as an input to a PI-controller that computes the commanded valve position yVal.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Real | TSupMin | 294.15 | Minimum supply water temperature [K] |
| Real | TSupMax | 323.15 | Maximum supply water temperature [K] |
| Real | TRooMin | 292.15 | Room air temperature at which supply water temperature is at TSupMax [K] |
| Real | k | 0.1 | Gain of controller |
| Time | Ti | 120 | Time constant of integrator block [s] |
Connectors
| Type | Name | Description |
|---|---|---|
| input RealInput | TRoo | Room air temperature [K] |
| input RealInput | TSup | Measured supply water temperature [K] |
| output RealOutput | yVal | Valve control signal [1] |
Modelica definition
block RadiatorSupply "Controller for mixing valve in radiator loop"
parameter Real TSupMin(
final unit="K",
displayUnit="degC") = 294.15
"Minimum supply water temperature";
parameter Real TSupMax(
final unit="K",
displayUnit="degC") = 323.15
"Maximum supply water temperature";
parameter Real TRooMin(
final unit="K",
displayUnit="degC") = 292.15
"Room air temperature at which supply water temperature is at TSupMax";
parameter Real k=0.1 "Gain of controller";
parameter Modelica.Units.SI.Time Ti=120 "Time constant of integrator block";
Buildings.Controls.OBC.CDL.Interfaces.RealInput TRoo(
final unit="K",
displayUnit="degC")
"Room air temperature";
Buildings.Controls.OBC.CDL.Interfaces.RealInput TSup(
final unit="K",
displayUnit="degC")
"Measured supply water temperature";
Buildings.Controls.OBC.CDL.Interfaces.RealOutput yVal(
final unit="1")
"Valve control signal";
Buildings.Controls.OBC.CDL.Reals.PID conPIDRad(
final k=k,
final Ti=Ti,
final yMax=1,
final yMin=0,
controllerType=Buildings.Controls.OBC.CDL.Types.SimpleController.PI)
"Controller for valve in radiator loop";
Buildings.Controls.OBC.CDL.Reals.Line TSetSup
"Setpoint for supply water temperature";
Buildings.Controls.OBC.CDL.Reals.Sources.Constant TMinSup(
final k=TSupMin)
"Minimum heating supply temperature";
Buildings.Controls.OBC.CDL.Reals.Sources.Constant TMaxSup(
final k=TSupMax)
"Maximum heating supply temperature";
Buildings.Controls.OBC.CDL.Reals.Sources.Constant TMinRoo(
final k=TRooMin)
"Minimum room air temperature";
equation
connect(TMinSup.y,TSetSup. x2);
connect(TMinSup.y,TSetSup. f2);
connect(TMaxSup.y,TSetSup. f1);
connect(TSetSup.x1,TMinRoo. y);
connect(conPIDRad.u_s,TSetSup. y);
connect(TSetSup.u, TRoo);
connect(TSup, conPIDRad.u_m);
connect(conPIDRad.y, yVal);
end RadiatorSupply;
Buildings.Examples.Tutorial.CDL.Controls.SystemOnOff
Controller for system on/off
Information
Controller that takes as an input the outside air temperature TOut and
the room air temperature TRoo,
and outputs the system on command onSys.
The system on command is true if both conditions are satisfied:
The outside air temperature is below a limit of TOutLow(=16°C, adjustable)
and the room air temperature is below TRooSet-dTRoo/2,
where TRooSet is the room air temperature setpoint (=20.5°C, adjustable)
and dTRoo is the deadband (=1 Kelvin, adjustable).
Otherwise, the system on command is false.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Real | TRooSet | 293.65 | Room air temperature set point [K] |
| Real | dTRoo | 1 | Room air temperature dead band [K] |
| Real | TOutLow | 289.15 | Outdoor temperature below which system is allowed to switch on [K] |
Connectors
| Type | Name | Description |
|---|---|---|
| input RealInput | TOut | Outdoor air temperature [K] |
| input RealInput | TRoo | Room air temperature [K] |
| output BooleanOutput | onSys | System on command |
Modelica definition
block SystemOnOff "Controller for system on/off"
parameter Real TRooSet(
final unit="K",
displayUnit="degC") = 293.65
"Room air temperature set point";
parameter Real dTRoo(
min=0.5,
final unit="K") = 1
"Room air temperature dead band";
parameter Real TOutLow(
final unit="K",
displayUnit="degC") = 289.15
"Outdoor temperature below which system is allowed to switch on";
Buildings.Controls.OBC.CDL.Interfaces.RealInput TOut(
final unit="K",
displayUnit="degC")
"Outdoor air temperature";
Buildings.Controls.OBC.CDL.Interfaces.RealInput TRoo(
final unit="K",
displayUnit="degC")
"Room air temperature";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput onSys
"System on command";
Buildings.Controls.OBC.CDL.Reals.Sources.Constant TSetOut(k=TOutLow + 0.5)
"Set point for outdoor air temperature plus half the dead band";
Buildings.Controls.OBC.CDL.Reals.Sources.Constant TSetRoo(k=TRooSet)
"Set point for room air temperature";
Buildings.Controls.OBC.CDL.Logical.And and1
"And operator to switch boiler on based on temperature and system on command";
Buildings.Controls.OBC.CDL.Reals.Subtract sub "Inputs different";
Buildings.Controls.OBC.CDL.Reals.Hysteresis onTOut(
final uLow=-0.5,
final uHigh=0.5) "On/off control based on outside air temperature";
Buildings.Controls.OBC.CDL.Reals.Subtract sub1 "Inputs different";
Buildings.Controls.OBC.CDL.Reals.Hysteresis onTRoo(
final uLow=-0.5,
final uHigh=0.5) "On/off control based on room air temperature";
equation
connect(and1.y, onSys);
connect(TSetOut.y, sub.u1);
connect(TOut, sub.u2);
connect(sub.y, onTOut.u);
connect(onTOut.y, and1.u1);
connect(TSetRoo.y, sub1.u1);
connect(TRoo, sub1.u2);
connect(sub1.y, onTRoo.u);
connect(onTRoo.y, and1.u2);
end SystemOnOff;