Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints
Package with sequences that output control setpoints
Information
This package contains generic setpoint sequences for either AHU or terminal units control.
Package Content
| Name | Description |
|---|---|
 GroupStatus
|
Block that outputs the zone group status |
 OperationMode
|
Block that outputs the operation mode |
 TrimAndRespond
|
Block to inplement trim and respond logic |
 ZoneStatus
|
Block that outputs zone temperature status |
 Validation
|
Collection of validation models |
Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.GroupStatus
Block that outputs the zone group status
Information
This sequence sums up the zone level status calculation to find the outputs that are needed to define the zone group operation mode.
It requires following inputs from zone lelvel calculation:
-
zonOcc: if the zone-level local override switch indicates the zone is occupied, -
uOcc: if the zone is occupied according to its occupancy schedule, -
tNexOcc: time to next occupied period, -
uCooTim: required cooldown time, -
uWarTim: required warm-up time, -
uOccHeaHig: if the zone temperature is lower than the occupied heating setpoint, -
uHigOccCoo: if the zone temperature is higher than the occupied cooling setpoint, -
uUnoHeaHig: if the zone temperature is lower than the unoccupied heating setpoint, -
THeaSetOff: zone unoccupied heating setpoint, -
uEndSetBac: if the zone could end the setback mode, -
uHigUnoCoo: if the zone temperature is higher than its unoccupied cooling setpoint, -
TCooSetOff: zone unoccupied cooling setpoint, -
uEndSetUp: if the zone could end the setup mode, -
TZon: zone temperature, -
uWin: True when the window is open, false when the window is close or the zone does not have window status sensor.
The sequence gives following outputs for zone group level calculation:
-
uGroOcc: the zone group should be in occupied mode when there is any zone becoming occupied according its schedule or due to the local override, -
nexOcc: the shortest time to the next occupied period among all the zones in the group, -
yCooTim: longest cooldown time, -
yWarTim: longest warm-up time, -
yOccHeaHig: if there is zone with temperature being lower than the occupied heating setpoint, so the group could be in the warm-up mode, -
yHigOccCoo: if there is zone with temperature being higher than the occupied cooling setpoint, so the group could be in the cooldown mode, -
yColZon: total number of zones that the temperature is lower than the unoccupied heating setpoint, -
ySetBac: check if the group could be into setback mode due to that the average zone temperature is lower than the average unoccupied heating setpoint, -
yEndSetBac: check if the group should end setback mode due to that all the zone temperature are above their unoccupied heating setpoint by a limited value, -
yHotZon: total number of zones that the temperature is higher than the unoccupied cooling setpoint, -
ySetUp: check if the group could be into setup mode due to that the average zone temperature is higher than the average unoccupied cooling setpoint, -
yEndSetUp: check if the group should end setup mode due to that all the zone temperature are below their unoccupied cooling setpoint by a limited value, -
TZonMax: maximum zone temperature in the zone group, -
TZonMin: minimum zone temperature in the zone group, -
yOpeWin: total number of opening windows.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Integer | numZon | 5 | number of zones in the zone group |
| Advanced | |||
| Real | uLow | -0.1 | Low limit of the hysteresis for checking temperature difference |
| Real | uHigh | 0.1 | High limit of the hysteresis for checking temperature difference |
Connectors
| Type | Name | Description |
|---|---|---|
| input BooleanInput | zonOcc[numZon] | True when the zone is set to be occupied due to the override |
| input BooleanInput | uOcc[numZon] | True when the zone is occupied according to the occupancy schedule |
| input RealInput | tNexOcc[numZon] | Time to next occupied period [s] |
| input RealInput | uCooTim[numZon] | Cool down time [s] |
| input RealInput | uWarTim[numZon] | Warm-up time [s] |
| input BooleanInput | uOccHeaHig[numZon] | True when the zone temperature is lower than the occupied heating setpoint |
| input BooleanInput | uHigOccCoo[numZon] | True when the zone temperature is higher than the occupied cooling setpoint |
| input BooleanInput | uUnoHeaHig[numZon] | True when the zone temperature is lower than the unoccupied heating setpoint |
| input RealInput | THeaSetOff[numZon] | Zone unoccupied heating setpoint [K] |
| input BooleanInput | uEndSetBac[numZon] | True when the zone could end the setback mode |
| input BooleanInput | uHigUnoCoo[numZon] | True when the zone temperature is higher than its unoccupied cooling setpoint |
| input RealInput | TCooSetOff[numZon] | Zone unoccupied cooling setpoint [K] |
| input BooleanInput | uEndSetUp[numZon] | True when the zone could end the setup mode |
| input RealInput | TZon[numZon] | Zone temperature [K] |
| input BooleanInput | uWin[numZon] | True when the window is open, false when the window is close or the zone does not have window status sensor |
| output BooleanOutput | uGroOcc | True when the zone group is in occupied mode |
| output RealOutput | nexOcc | Time to next occupied period [s] |
| output RealOutput | yCooTim | Cool down time [s] |
| output RealOutput | yWarTim | Warm-up time [s] |
| output BooleanOutput | yOccHeaHig | True when there is zone with temperature being lower than the occupied heating setpoint |
| output BooleanOutput | yHigOccCoo | True when there is zone with temperature being higher than the occupied cooling setpoint |
| output IntegerOutput | yColZon | Total number of cold zones |
| output BooleanOutput | ySetBac | Run setback mode |
| output BooleanOutput | yEndSetBac | True when the group should end setback mode |
| output IntegerOutput | yHotZon | Total number of hot zones |
| output BooleanOutput | ySetUp | Run setup mode |
| output BooleanOutput | yEndSetUp | True when the group should end setup mode |
| output RealOutput | TZonMax | Maximum zone temperature in the zone group [K] |
| output RealOutput | TZonMin | Minimum zone temperature in the zone group [K] |
| output IntegerOutput | yOpeWin | Total number of open windows |
Modelica definition
block GroupStatus "Block that outputs the zone group status"
parameter Integer numZon(
final min=1)=5 "number of zones in the zone group";
parameter Real uLow=-0.1
"Low limit of the hysteresis for checking temperature difference";
parameter Real uHigh=0.1
"High limit of the hysteresis for checking temperature difference";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput zonOcc[numZon]
"True when the zone is set to be occupied due to the override";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput uOcc[numZon]
"True when the zone is occupied according to the occupancy schedule";
Buildings.Controls.OBC.CDL.Interfaces.RealInput tNexOcc[numZon](
final unit=fill("s", numZon),
final quantity=fill("Time", numZon)) "Time to next occupied period";
Buildings.Controls.OBC.CDL.Interfaces.RealInput uCooTim[numZon](
final unit=fill("s", numZon),
final quantity=fill("Time", numZon)) "Cool down time";
Buildings.Controls.OBC.CDL.Interfaces.RealInput uWarTim[numZon](
final unit=fill("s", numZon),
final quantity=fill("Time", numZon)) "Warm-up time";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput uOccHeaHig[numZon]
"True when the zone temperature is lower than the occupied heating setpoint";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput uHigOccCoo[numZon]
"True when the zone temperature is higher than the occupied cooling setpoint";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput uUnoHeaHig[numZon]
"True when the zone temperature is lower than the unoccupied heating setpoint";
Buildings.Controls.OBC.CDL.Interfaces.RealInput THeaSetOff[numZon](
final unit=fill("K", numZon),
displayUnit=fill("degC", numZon),
final quantity=fill("ThermodynamicTemperature", numZon))
"Zone unoccupied heating setpoint";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput uEndSetBac[numZon]
"True when the zone could end the setback mode";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput uHigUnoCoo[numZon]
"True when the zone temperature is higher than its unoccupied cooling setpoint";
Buildings.Controls.OBC.CDL.Interfaces.RealInput TCooSetOff[numZon](
final unit=fill("K", numZon),
displayUnit=fill("degC", numZon),
final quantity=fill("ThermodynamicTemperature", numZon))
"Zone unoccupied cooling setpoint";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput uEndSetUp[numZon]
"True when the zone could end the setup mode";
Buildings.Controls.OBC.CDL.Interfaces.RealInput TZon[numZon](
final unit=fill("K", numZon),
displayUnit=fill("degC", numZon),
final quantity=fill("ThermodynamicTemperature", numZon)) "Zone temperature";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput uWin[numZon]
"True when the window is open, false when the window is close or the zone does not have window status sensor";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput uGroOcc
"True when the zone group is in occupied mode";
Buildings.Controls.OBC.CDL.Interfaces.RealOutput nexOcc(
final quantity="Time",
final unit="s") "Time to next occupied period";
Buildings.Controls.OBC.CDL.Interfaces.RealOutput yCooTim(
final unit="s",
final quantity="Time") "Cool down time";
Buildings.Controls.OBC.CDL.Interfaces.RealOutput yWarTim(
final unit="s",
final quantity="Time") "Warm-up time";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput yOccHeaHig
"True when there is zone with temperature being lower than the occupied heating setpoint";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput yHigOccCoo
"True when there is zone with temperature being higher than the occupied cooling setpoint";
Buildings.Controls.OBC.CDL.Interfaces.IntegerOutput yColZon
"Total number of cold zones";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput ySetBac
"Run setback mode";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput yEndSetBac
"True when the group should end setback mode";
Buildings.Controls.OBC.CDL.Interfaces.IntegerOutput yHotZon
"Total number of hot zones";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput ySetUp
"Run setup mode";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput yEndSetUp
"True when the group should end setup mode";
Buildings.Controls.OBC.CDL.Interfaces.RealOutput TZonMax(
final unit="K",
displayUnit="degC",
final quantity="ThermodynamicTemperature")
"Maximum zone temperature in the zone group";
Buildings.Controls.OBC.CDL.Interfaces.RealOutput TZonMin(
final unit="K",
displayUnit="degC",
final quantity="ThermodynamicTemperature")
"Minimum zone temperature in the zone group";
Buildings.Controls.OBC.CDL.Interfaces.IntegerOutput yOpeWin
"Total number of open windows";
protected
Buildings.Controls.OBC.CDL.Continuous.MultiMax cooDowTim(
final nin=numZon)
"Longest cooldown time";
Buildings.Controls.OBC.CDL.Continuous.MultiMax warUpTim(
final nin=numZon)
"Longest warm up time";
Buildings.Controls.OBC.CDL.Logical.MultiOr mulOr(
final nu=numZon)
"Check if there is any zone that the zone temperature is lower than its occupied heating setpoint";
Buildings.Controls.OBC.CDL.Logical.MultiOr mulOr1(
final nu=numZon)
"Check if there is any zone that the zone temperature is higher than its occupied cooling setpoint";
Buildings.Controls.OBC.CDL.Continuous.MultiMax maxTem(
final nin=numZon) "Maximum zone temperature in the zone group";
Buildings.Controls.OBC.CDL.Continuous.MultiMin minTem(
final nin=numZon) "Minimum zone temperature in the zone group";
Buildings.Controls.OBC.CDL.Conversions.BooleanToInteger booToInt[numZon]
"Convert boolean to integer";
Buildings.Controls.OBC.CDL.Integers.MultiSum totColZon(
final nin=numZon) "Total number of cold zone";
Buildings.Controls.OBC.CDL.Logical.MultiAnd endSetBac(
final nu=numZon)
"Check if all zones have ended the setback mode";
Buildings.Controls.OBC.CDL.Conversions.BooleanToInteger booToInt1[numZon]
"Convert boolean to integer";
Buildings.Controls.OBC.CDL.Integers.MultiSum totHotZon(
final nin=numZon) "Total number of hot zones";
Buildings.Controls.OBC.CDL.Logical.MultiAnd endSetUp(
final nu=numZon)
"Check if all zones have ended the setup mode";
Buildings.Controls.OBC.CDL.Continuous.MultiSum sumUnoHea(
final nin=numZon)
"Sum of all zones unoccupied heating setpoint";
Buildings.Controls.OBC.CDL.Continuous.Feedback difUnoHea
"Difference between unoccupied heating setpoint and zone temperature";
Buildings.Controls.OBC.CDL.Continuous.Division div1 "Average difference";
Buildings.Controls.OBC.CDL.Integers.Sources.Constant totZon(
final k=numZon) "Total number of zones";
Buildings.Controls.OBC.CDL.Conversions.IntegerToReal intToRea "Convert integer to real";
Buildings.Controls.OBC.CDL.Continuous.MultiSum sumUnoCoo(
final nin=numZon)
"Sum of all zones unoccupied cooling setpoint";
Buildings.Controls.OBC.CDL.Continuous.MultiSum sumTem(
final nin=numZon) "Sum of all zones temperature";
Buildings.Controls.OBC.CDL.Continuous.Feedback difUnoCoo
"Difference between unoccupied cooling setpoint and zone temperature";
Buildings.Controls.OBC.CDL.Continuous.Division div2 "Average difference";
Buildings.Controls.OBC.CDL.Continuous.Hysteresis hys(
final uLow=uLow,
final uHigh=uHigh)
"Hysteresis that outputs if the group should run in setback mode";
Buildings.Controls.OBC.CDL.Continuous.Hysteresis hys1(
final uLow=uLow,
final uHigh=uHigh)
"Hysteresis that outputs if the group should run in setup mode";
Buildings.Controls.OBC.CDL.Continuous.MultiMin minToNexOcc(
final nin=numZon)
"Minimum time to next occupied period";
Buildings.Controls.OBC.CDL.Logical.MultiOr schOcc(
final nu=numZon)
"Check if the group should be in occupied mode according to the schedule";
Buildings.Controls.OBC.CDL.Logical.MultiOr oveRidOcc(
final nu=numZon)
"Check if the group should be in occupied mode according to the zone override";
Buildings.Controls.OBC.CDL.Logical.Or groOcc
"Check if the group should be in occupied mode according to the schedule or the zone override";
Buildings.Controls.OBC.CDL.Conversions.BooleanToInteger booToInt2[numZon]
"Convert boolean to integer";
Buildings.Controls.OBC.CDL.Integers.MultiSum totOpeWin(
final nin=numZon)
"Total number of opening windows";
Buildings.Controls.OBC.CDL.Conversions.BooleanToReal booToRea(
final realTrue=0,
final realFalse=1)
"When any zone becomes occpuied, output zero";
Buildings.Controls.OBC.CDL.Continuous.Product pro
"When it is occupied, output zero";
equation
connect(maxTem.y, TZonMax);
connect(minTem.y, TZonMin);
connect(cooDowTim.y, yCooTim);
connect(warUpTim.y, yWarTim);
connect(mulOr.y, yOccHeaHig);
connect(mulOr1.y, yHigOccCoo);
connect(uCooTim, cooDowTim.u);
connect(uOccHeaHig, mulOr.u);
connect(TZon,maxTem. u);
connect(TZon,minTem. u);
connect(uHigOccCoo, mulOr1.u);
connect(uWarTim, warUpTim.u);
connect(uUnoHeaHig, booToInt.u);
connect(totColZon.y, yColZon);
connect(endSetBac.y, yEndSetBac);
connect(uHigUnoCoo, booToInt1.u);
connect(totHotZon.y, yHotZon);
connect(endSetUp.y, yEndSetUp);
connect(uEndSetUp, endSetUp.u);
connect(uEndSetBac, endSetBac.u);
connect(booToInt.y, totColZon.u);
connect(booToInt1.y, totHotZon.u);
connect(totZon.y, intToRea.u);
connect(sumTem.y, difUnoHea.u2);
connect(sumTem.y, difUnoCoo.u1);
connect(sumUnoCoo.y, difUnoCoo.u2);
connect(sumUnoHea.y, difUnoHea.u1);
connect(intToRea.y, div1.u2);
connect(intToRea.y, div2.u2);
connect(difUnoHea.y, div1.u1);
connect(difUnoCoo.y, div2.u1);
connect(div1.y, hys.u);
connect(hys.y, ySetBac);
connect(div2.y, hys1.u);
connect(hys1.y, ySetUp);
connect(TCooSetOff, sumUnoCoo.u);
connect(TZon, sumTem.u);
connect(THeaSetOff, sumUnoHea.u);
connect(groOcc.y, uGroOcc);
connect(oveRidOcc.y, groOcc.u1);
connect(schOcc.y, groOcc.u2);
connect(uOcc, schOcc.u);
connect(zonOcc, oveRidOcc.u);
connect(tNexOcc, minToNexOcc.u);
connect(uWin, booToInt2.u);
connect(totOpeWin.y, yOpeWin);
connect(booToInt2.y, totOpeWin.u);
connect(schOcc.y, booToRea.u);
connect(minToNexOcc.y, pro.u2);
connect(booToRea.y, pro.u1);
connect(pro.y, nexOcc);
end GroupStatus;
Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.OperationMode
Block that outputs the operation mode
Information
This block outputs VAV system operating mode. It is implemented according to ASHRAE guideline G36, section 5.4.3, section 5.4.4, section 5.4.5 and section 5.4.6.
Note that, from the user's point of view, schedules can be a set for individual zones, or they can be set for an entire zone group, depending on how the user interface is implemented. From the point of view of the BAS, individual zone schedules are superimposed to create a zone-group schedule, which then drives system behavior.
- All zones in each zone group shall be in the same zone-group operating mode. If one zone in a zone group is placed in any zone-group operating mode other than unoccupied mode (due to override, sequence logic, or scheduled occupancy), all zones in that group shall enter that mode.
- A zone group may be in only one mode at a given time.
Each zone group shall have the operating modes shown below.
Occupied Mode
A zone group is in the occupied mode when
occupancy input uOcc is true. This input shall be retrieved from
other sequences that specifies occupancy variation and time remaining to the
next occupied period tNexOcc. A zone group could be in the occupied
mode when any of the following is true:
- The time of day is between the zone group's scheduled occupied start and stop times.
- The schedules have been overriden by the occupant override system.
- Any zone local override timer is nonzero.
Warm-up Mode
Warm-up mode shall start based on the zone with the longest calculated warm-up
time maxWarUpTim requirement, but no earlier than 3 hours
(preWarCooTim) before the start of the scheduled occupied period,
and shall end at the scheduled occupied start time. Zones where the window switch
indicates that a window is open shall be ignored. Note that for each zone,
the optimal warm-up time shall be obtained from an Optimal Start sequences,
computed in a separate block. The figure below shows the sequence.
Cooldown Mode
Cooldown mode shall start based on the zone with the longest calculated
cooldown time maxCooDowTim requirement, but no earlier than 3 hours
(preWarCooTim) before the start of the scheduled occupied period,
and shall end at the scheduled occupied start time. Zones where the window switch
indicates that a window is open shall be ignored. Note that for each zone,
the optimal cooldown time shall be obtained from an Optimal Start sequences,
computed in a separate block.
Setback Mode
During unoccupied mode, if any 5 zones (or all zones, if fewer than 5)
in the zone group fall below their unoccupied heating setpoints, or if the average
zone temperature of the zone group falls below the average unoccupied heating setpoint
(uSetBac becomes true), the zone group shall enter setback mode until
all spaces in the zone group are 1 °C (2 °F) above their
unoccupied setpoints (uEndSetBac becomes true).
Freeze Protection Setback Mode
During unoccupied Mode, if any single zone falls below 4 °C (40 °F), the zone group shall enter setback mode until all zones are above 7 °C (45 °F), and a Level 3 alarm shall be set.
Setup Mode
During unoccupied mode, if any 5 zones (or all zones, if fewer than 5)
in the zone group rise above their unoccupied cooling setpoints, or if the average
zone temperature of the zone group rises above the average unoccupied cooling setpoint
(uSetUp becomes true), the zone group shall enter setup mode until
all spaces in the zone group are 1 °C (2 °F) below their
unoccupied setpoints. Zones where the window switch indicates that a window is
open shall be ignored.
Unoccupied Mode
Unoccupied mode shall be active if the zone group is not in any other mode.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Integer | numZon | Number of zones | |
| Real | preWarCooTim | 10800 | Maximum cool-down or warm-up time [s] |
| Real | TZonFreProOn | 277.15 | Threshold temperature to activate the freeze protection mode [K] |
| Real | TZonFreProOff | 280.15 | Threshold temperature to end the freeze protection mode [K] |
Connectors
| Type | Name | Description |
|---|---|---|
| input BooleanInput | uOcc | Zone occupancy status: true=occupied, false=unoccupied |
| input RealInput | tNexOcc | Time to next occupied period [s] |
| input RealInput | maxCooDowTim | Maximum cool-down time among all the zones [s] |
| input BooleanInput | uHigOccCoo | True when there is zone with the temperature being higher than the occupied cooling setpoint |
| input RealInput | maxWarUpTim | Maximum warm-up time among all the zones [s] |
| input BooleanInput | uOccHeaHig | True when there is zone with the temperature being lower than the occupied heating setpoint |
| input IntegerInput | uOpeWin | Total number of zones with opening window |
| input IntegerInput | totColZon | Total number of cold zone |
| input BooleanInput | uSetBac | True when the average zone temperature falls below the average unoccupied heating setpoint |
| input BooleanInput | uEndSetBac | True when the setback mode could end |
| input RealInput | TZonMax | Maximum zone temperature [K] |
| input RealInput | TZonMin | Minimum zone temperature [K] |
| input IntegerInput | totHotZon | Total number of hot zone |
| input BooleanInput | uSetUp | True when the average zone temperature rises above the average unoccupied cooling setpoint |
| input BooleanInput | uEndSetUp | True when the setup mode could end |
| output IntegerOutput | yOpeMod | Operation mode |
Modelica definition
block OperationMode "Block that outputs the operation mode"
parameter Integer numZon(min=1) "Number of zones";
parameter Real preWarCooTim(
final unit="s",
final quantity="Time") = 10800
"Maximum cool-down or warm-up time";
parameter Real TZonFreProOn(
final unit="K",
displayUnit="degC",
final quantity="ThermodynamicTemperature")=277.15
"Threshold temperature to activate the freeze protection mode";
parameter Real TZonFreProOff(
final unit="K",
displayUnit="degC",
final quantity="ThermodynamicTemperature")=280.15
"Threshold temperature to end the freeze protection mode";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput uOcc
"Zone occupancy status: true=occupied, false=unoccupied";
Buildings.Controls.OBC.CDL.Interfaces.RealInput tNexOcc(
final unit="s",
final quantity="Time")
"Time to next occupied period";
Buildings.Controls.OBC.CDL.Interfaces.RealInput maxCooDowTim(
final unit="s",
final quantity="Time") "Maximum cool-down time among all the zones";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput uHigOccCoo
"True when there is zone with the temperature being higher than the occupied cooling setpoint";
Buildings.Controls.OBC.CDL.Interfaces.RealInput maxWarUpTim(
final unit="s",
final quantity="Time") "Maximum warm-up time among all the zones";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput uOccHeaHig
"True when there is zone with the temperature being lower than the occupied heating setpoint";
Buildings.Controls.OBC.CDL.Interfaces.IntegerInput uOpeWin
"Total number of zones with opening window";
Buildings.Controls.OBC.CDL.Interfaces.IntegerInput totColZon
"Total number of cold zone";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput uSetBac
"True when the average zone temperature falls below the average unoccupied heating setpoint";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput uEndSetBac
"True when the setback mode could end";
Buildings.Controls.OBC.CDL.Interfaces.RealInput TZonMax(
final unit="K",
displayUnit="degC",
final quantity="ThermodynamicTemperature")
"Maximum zone temperature";
Buildings.Controls.OBC.CDL.Interfaces.RealInput TZonMin(
final unit="K",
displayUnit="degC",
final quantity="ThermodynamicTemperature")
"Minimum zone temperature";
Buildings.Controls.OBC.CDL.Interfaces.IntegerInput totHotZon
"Total number of hot zone";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput uSetUp
"True when the average zone temperature rises above the average unoccupied cooling setpoint";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput uEndSetUp
"True when the setup mode could end";
Buildings.Controls.OBC.CDL.Interfaces.IntegerOutput yOpeMod
"Operation mode";
protected
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant occModInd(
final k=Buildings.Controls.OBC.ASHRAE.G36_PR1.Types.OperationModes.occupied)
"Occupied mode ";
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant unoPerInd(
final k=0)
"Index to indicate unoccupied period";
Buildings.Controls.OBC.CDL.Logical.Switch corCooDowTim "Corrected cool down period";
Buildings.Controls.OBC.CDL.Logical.Switch corWarUpTim "Corrected warm-up period";
Buildings.Controls.OBC.CDL.Integers.GreaterThreshold intGreThr(
final t=4) "Check if the number of cold zones is not less than than 5";
Buildings.Controls.OBC.CDL.Logical.Latch lat
"If all zone temperature are higher than unoccupied heating setpoint by a given limit, then the setback mode should be off";
Buildings.Controls.OBC.CDL.Logical.Latch lat1
"If all zone temperature are higher than threshold temperature of ending freeze protection, then freeze protection setback mode should be off";
Buildings.Controls.OBC.CDL.Logical.Latch lat2
"If all zone temperature are lower than unoccupied cooling setpoint by a given limit, then the setup mode should be off";
Buildings.Controls.OBC.CDL.Continuous.Hysteresis hys2(
final pre_y_start=true,
final uHigh=0,
final uLow=-60)
"Hysteresis that outputs if the maximum cool-down time is more than the allowed cool-down time";
Buildings.Controls.OBC.CDL.Continuous.Hysteresis hys3(
final pre_y_start=true,
final uHigh=0,
final uLow=-60)
"Hysteresis that outputs if the maximum warm-up time is more than allowed warm-up time";
Buildings.Controls.OBC.CDL.Continuous.Add add5(
final k1=-1)
"Calculate differential between time-to-next-occupancy and the cool-down time";
Buildings.Controls.OBC.CDL.Continuous.Hysteresis hys4(
final pre_y_start=false,
final uHigh=0,
final uLow=-60)
"Hysteresis to check if the cooldown mode could be activated";
Buildings.Controls.OBC.CDL.Continuous.Hysteresis hys5(
final pre_y_start=false,
final uHigh=0,
final uLow=-60)
"Hysteresis to activate the warm-up model";
Buildings.Controls.OBC.CDL.Continuous.Add add6(
final k1=-1)
"Calculate differential between time-to-next-occupancy and the warm-up time";
Buildings.Controls.OBC.CDL.Continuous.Hysteresis hys9(
final pre_y_start=false,
final uLow=-0.1,
final uHigh=0.1)
"Hysteresis that outputs if any zone temperature is lower than freeze protection threshold temperature";
Buildings.Controls.OBC.CDL.Continuous.Hysteresis hys10(
final pre_y_start=false,
final uLow=-0.1,
final uHigh=0.1)
"Hysteresis that outputs if all zone temperature are higher than threshold temperature of ending freeze protection";
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant maxWarCooTime(
final k=preWarCooTim)
"Allowed maximum warm-up or cool-down time";
Buildings.Controls.OBC.CDL.Integers.GreaterThreshold intGreThr2(
final t=4) "Check if the number of hot zones is not less than than 5";
Buildings.Controls.OBC.CDL.Integers.Add addInt "Sum of two integer inputs";
Buildings.Controls.OBC.CDL.Integers.Add addInt1 "Sum of two integer inputs";
Buildings.Controls.OBC.CDL.Integers.Add addInt2 "Sum of two integer inputs";
Buildings.Controls.OBC.CDL.Integers.Add addInt3 "Sum of two integer inputs";
Buildings.Controls.OBC.CDL.Integers.Add addInt4 "Sum of two integer inputs";
Buildings.Controls.OBC.CDL.Integers.Add addInt5 "Sum of two integer inputs";
Buildings.Controls.OBC.CDL.Conversions.RealToInteger occMod
"Convert Real number to Integer number";
Buildings.Controls.OBC.CDL.Conversions.RealToInteger setBacMod
"Convert Real number to Integer number";
Buildings.Controls.OBC.CDL.Conversions.RealToInteger freProSetBacMod
"Convert Real number to Integer number";
Buildings.Controls.OBC.CDL.Conversions.RealToInteger setUpMod
"Convert Real number to Integer number";
Buildings.Controls.OBC.CDL.Logical.Edge edg
"Get the moment when the warm up time starts ";
Buildings.Controls.OBC.CDL.Logical.TrueFalseHold truFalHol(
final trueHoldDuration=preWarCooTim)
"Hold the start time true signal";
Buildings.Controls.OBC.CDL.Logical.Edge edg1
"Get the moment when cool down time starts";
Buildings.Controls.OBC.CDL.Logical.TrueFalseHold truFalHol1(
final trueHoldDuration=preWarCooTim)
"Hold the start time true signal";
Buildings.Controls.OBC.CDL.Conversions.BooleanToReal booToRea1(
final realTrue=Buildings.Controls.OBC.ASHRAE.G36_PR1.Types.OperationModes.warmUp)
"Convert Boolean to Integer number";
Buildings.Controls.OBC.CDL.Conversions.BooleanToReal booToRea(
final realTrue=Buildings.Controls.OBC.ASHRAE.G36_PR1.Types.OperationModes.coolDown)
"Convert Boolean to Integer number";
Buildings.Controls.OBC.CDL.Conversions.BooleanToInteger booToInt3(
final integerTrue=Buildings.Controls.OBC.ASHRAE.G36_PR1.Types.OperationModes.unoccupied)
"Convert Boolean to Integer ";
Buildings.Controls.OBC.CDL.Conversions.BooleanToReal booToRea6(
final realTrue=Buildings.Controls.OBC.ASHRAE.G36_PR1.Types.OperationModes.setUp)
"Convert Boolean to Real ";
Buildings.Controls.OBC.CDL.Conversions.BooleanToReal booToRea4(
final realTrue=Buildings.Controls.OBC.ASHRAE.G36_PR1.Types.OperationModes.freezeProtection)
"Convert Boolean to Real ";
Buildings.Controls.OBC.CDL.Conversions.BooleanToReal booToRea3(
final realTrue=Buildings.Controls.OBC.ASHRAE.G36_PR1.Types.OperationModes.setBack)
"Convert Boolean to Real ";
Buildings.Controls.OBC.CDL.Utilities.Assert assMes(
final message="Level 3 alarm: freeze protection setback")
"Generate alarm message";
Buildings.Controls.OBC.CDL.Logical.Not not2 "Logical not";
Buildings.Controls.OBC.CDL.Logical.And and1 "Warm-up period";
Buildings.Controls.OBC.CDL.Logical.And and2
"Get the start of the cool-down time";
Buildings.Controls.OBC.CDL.Logical.Or or1
"Check if the number of cold zone is more than 5 or all zones are cold";
Buildings.Controls.OBC.CDL.Logical.Or3 or3
"Check if it is in occupied, cooldown, or warm-up mode";
Buildings.Controls.OBC.CDL.Logical.Or or4
"Check if the number of hot zone is more than 5 or all zones are hot";
Buildings.Controls.OBC.CDL.Logical.Or3 or5
"Check if it is in Setback, Setback_freezeProtection, or Setup mode";
Buildings.Controls.OBC.CDL.Logical.Or or6
"Check if it is in any of the 6 modes except unoccupied mode";
Buildings.Controls.OBC.CDL.Logical.Switch swi
"Switch between occupied mode index and unoccupied period index";
Buildings.Controls.OBC.CDL.Logical.Switch swi3
"If the Cool-down, warm-up, or Occupied mode is on, then setback mode should not be activated.";
Buildings.Controls.OBC.CDL.Logical.Switch swi4
"If the Cool-down, warm-up, or Occupied mode is on, then freeze protection setback mode should not be activated.";
Buildings.Controls.OBC.CDL.Logical.Switch swi5
"If the Cool-down, warm-up, or Occupied mode is on, then setup mode should not be activated.";
Buildings.Controls.OBC.CDL.Logical.Not not5 "Logical not";
Buildings.Controls.OBC.CDL.Integers.GreaterThreshold notOcc(
final t=1)
"Check if the operation mode is other than occupied mode";
Buildings.Controls.OBC.CDL.Logical.And and3
"True if window open during modes other than occupied mode";
Buildings.Controls.OBC.CDL.Logical.Not not1 "Logical not";
Buildings.Controls.OBC.CDL.Utilities.Assert winOpe(
final message="Level 4 alarm: window open during modes other than occupied mode")
"Generate alarm message when window open during modes other than occupied mode";
Buildings.Controls.OBC.CDL.Logical.Switch swi1
"If occupied mode is on, then cool down mode should not be activated";
Buildings.Controls.OBC.CDL.Conversions.RealToInteger setBacMod1
"Convert Real number to Integer number";
Buildings.Controls.OBC.CDL.Logical.Switch swi2
"If occupied mode is on, then warm-up mode should not be activated.";
Buildings.Controls.OBC.CDL.Conversions.RealToInteger setBacMod2
"Convert Real number to Integer number";
Buildings.Controls.OBC.CDL.Logical.And and4 "Cool-down period";
Buildings.Controls.OBC.CDL.Logical.And and5
"Get the start of the warm-up time";
Buildings.Controls.OBC.CDL.Integers.Sources.Constant totZon(
final k=numZon) "Total number of zones";
Buildings.Controls.OBC.CDL.Integers.Equal allCol
"Check if all zones are cold zone";
Buildings.Controls.OBC.CDL.Integers.Equal allHot
"Check if all zones are hot zone";
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant actFreProTem(
final k=TZonFreProOn)
"Threshold temperature to activate the freeze protection mode";
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant endFreProTem(
final k=TZonFreProOff)
"Threshold temperature to end the freeze protection mode";
Buildings.Controls.OBC.CDL.Continuous.Add add2(
final k1=-1)
"Calculate differential between minimum zone temperature and freeze protection threshold temperature";
Buildings.Controls.OBC.CDL.Continuous.Add add1(
final k2=-1)
"Calculate differential between maximum zone temperature and threshold temperature of ending freeze protection";
Buildings.Controls.OBC.CDL.Logical.Or or2
"Enough cold zone or the low average zone temperature";
Buildings.Controls.OBC.CDL.Logical.Or or7
"Enough hot zone or the high average zone temperature";
Buildings.Controls.OBC.CDL.Continuous.Add add3(
final k1=-1)
"Calculate the difference between maximum cool down time and the allowed maximum cool down time";
Buildings.Controls.OBC.CDL.Continuous.Add add4(
final k2=-1)
"Calculate the differential between maximum warm-up time and the allowed maximum warm-up time";
Buildings.Controls.OBC.CDL.Logical.Edge endSetBac
"End setback mode when the input becomes true";
Buildings.Controls.OBC.CDL.Logical.Edge endSetUp
"End setup mode when the input becomes true";
Buildings.Controls.OBC.CDL.Integers.GreaterThreshold intGreThr1(
final t=1) "Check if there is any zone with opening window";
Buildings.Controls.OBC.CDL.Integers.Add addInt6
"Total cold zone and zones with opening window";
Buildings.Controls.OBC.CDL.Integers.Add addInt7
"Total hot zone and zones with opening window";
equation
connect(swi.y, occMod.u);
connect(occModInd.y, swi.u1);
connect(unoPerInd.y, swi.u3);
connect(intGreThr.y, or1.u1);
connect(lat.y, booToRea3.u);
connect(unoPerInd.y, swi3.u1);
connect(or3.y, swi3.u2);
connect(lat1.y, booToRea4.u);
connect(or3.y, swi4.u2);
connect(unoPerInd.y, swi4.u1);
connect(lat2.y, booToRea6.u);
connect(or3.y, swi5.u2);
connect(unoPerInd.y, swi5.u1);
connect(swi3.y, setBacMod.u);
connect(swi4.y, freProSetBacMod.u);
connect(swi5.y, setUpMod.u);
connect(or5.y, or6.u1);
connect(or6.y, not2.u);
connect(not2.y,booToInt3. u);
connect(and1.y,booToRea1. u);
connect(and1.y, or3.u1);
connect(uOcc, swi.u2);
connect(uOcc, or3.u3);
connect(hys2.y, corCooDowTim.u2);
connect(hys3.y, corWarUpTim.u2);
connect(add5.y, hys4.u);
connect(tNexOcc, add5.u1);
connect(corCooDowTim.y, add5.u2);
connect(tNexOcc, add6.u1);
connect(corWarUpTim.y, add6.u2);
connect(add6.y, hys5.u);
connect(hys9.y, lat1.u);
connect(hys10.y, lat1.clr);
connect(maxWarCooTime.y, corCooDowTim.u3);
connect(maxWarCooTime.y, corWarUpTim.u3);
connect(booToRea3.y, swi3.u3);
connect(booToRea4.y, swi4.u3);
connect(booToRea6.y, swi5.u3);
connect(lat1.y, not5.u);
connect(not5.y, assMes.u);
connect(maxCooDowTim, corCooDowTim.u1);
connect(maxWarUpTim, corWarUpTim.u1);
connect(totColZon, intGreThr.u);
connect(totHotZon, intGreThr2.u);
connect(intGreThr2.y, or4.u1);
connect(setBacMod.y, addInt2.u1);
connect(freProSetBacMod.y, addInt2.u2);
connect(setUpMod.y, addInt3.u2);
connect(addInt2.y, addInt3.u1);
connect(addInt3.y, addInt4.u1);
connect(booToInt3.y, addInt4.u2);
connect(addInt5.y, yOpeMod);
connect(notOcc.y, and3.u2);
connect(and3.y, not1.u);
connect(addInt5.y, notOcc.u);
connect(not1.y, winOpe.u);
connect(booToRea.y, swi1.u3);
connect(uOcc, swi1.u2);
connect(swi1.y, setBacMod1.u);
connect(setBacMod1.y, addInt.u1);
connect(addInt.y, addInt1.u2);
connect(occMod.y, addInt1.u1);
connect(addInt1.y, addInt5.u1);
connect(addInt4.y, addInt5.u2);
connect(booToRea1.y, swi2.u3);
connect(unoPerInd.y, swi1.u1);
connect(unoPerInd.y, swi2.u1);
connect(swi2.y, setBacMod2.u);
connect(setBacMod2.y, addInt.u2);
connect(and4.y, booToRea.u);
connect(and4.y, or3.u2);
connect(hys4.y, and2.u1);
connect(uOccHeaHig, and5.u2);
connect(hys5.y, and5.u1);
connect(truFalHol1.u, edg.y);
connect(and5.y, edg.u);
connect(and2.y, edg1.u);
connect(edg1.y, truFalHol.u);
connect(lat2.y, or5.u1);
connect(lat1.y, or5.u2);
connect(lat.y, or5.u3);
connect(or3.y, or6.u2);
connect(allCol.y, or1.u2);
connect(allHot.y, or4.u2);
connect(totZon.y, allCol.u2);
connect(totZon.y, allHot.u2);
connect(add2.y, hys9.u);
connect(add1.y, hys10.u);
connect(actFreProTem.y, add2.u2);
connect(TZonMax, add2.u1);
connect(TZonMin, add1.u1);
connect(endFreProTem.y, add1.u2);
connect(or1.y, or2.u1);
connect(or2.y, lat.u);
connect(uSetBac, or2.u2);
connect(or4.y, or7.u1);
connect(or7.y, lat2.u);
connect(uSetUp, or7.u2);
connect(uOcc, swi2.u2);
connect(truFalHol.y, and4.u2);
connect(hys4.y, and4.u1);
connect(truFalHol1.y, and1.u2);
connect(hys5.y, and1.u1);
connect(uHigOccCoo, and2.u2);
connect(maxWarCooTime.y, add3.u2);
connect(maxWarCooTime.y, add4.u1);
connect(maxWarUpTim, add4.u2);
connect(maxCooDowTim, add3.u1);
connect(add3.y, hys2.u);
connect(add4.y, hys3.u);
connect(uEndSetBac, endSetBac.u);
connect(endSetBac.y, lat.clr);
connect(uEndSetUp, endSetUp.u);
connect(endSetUp.y, lat2.clr);
connect(uOpeWin, intGreThr1.u);
connect(intGreThr1.y, and3.u1);
connect(totColZon, addInt6.u2);
connect(uOpeWin, addInt6.u1);
connect(addInt6.y, allCol.u1);
connect(totHotZon, addInt7.u2);
connect(uOpeWin, addInt7.u1);
connect(addInt7.y, allHot.u1);
end OperationMode;
Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.TrimAndRespond
Block to inplement trim and respond logic
Information
This block implements the trim and respond logic according to ASHRAE guideline G36, PART 5.A.15 (trim and respond setpoint reset logic).
The trim and respond logic shall reset setpoint within the range minSet to
maxSet.
When the associated device is off (uDevSta=false), the setpoint
shall be iniSet.
The reset logic shall be active while the associated device is proven
on (uDevSta=true), starting delTim after initial
device start command.
When active, every time step samplePeriod, trim the setpoint by
triAmo.
If there are more than numIgnReq requests, respond by changing
the setpoint by resAmo*(numOfReq-numIgnReq), i.e., the number of
requests minus the number of ignored requests, but no more than maxRes.
samplePeriod:
- Change setpoint by
triAmo; - If
numOfReq > numIgnReq, also change setpoint byresAmo*(numOfReq -numIgnReq)but no more thanmaxRes.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Real | iniSet | Initial setpoint | |
| Real | minSet | Minimum setpoint | |
| Real | maxSet | Maximum setpoint | |
| Real | delTim | Delay time [s] | |
| Real | samplePeriod | Sample period of component [s] | |
| Integer | numIgnReq | Number of ignored requests | |
| Real | triAmo | Trim amount | |
| Real | resAmo | Respond amount (must have opposite sign of triAmo) | |
| Real | maxRes | Maximum response per time interval (must have same sign as resAmo) |
Connectors
| Type | Name | Description |
|---|---|---|
| input IntegerInput | numOfReq | Number of requests from zones/systems |
| input BooleanInput | uDevSta | On/Off status of the associated device |
| output RealOutput | y | Setpoint that have been reset |
Modelica definition
block TrimAndRespond "Block to inplement trim and respond logic"
parameter Real iniSet "Initial setpoint";
parameter Real minSet "Minimum setpoint";
parameter Real maxSet "Maximum setpoint";
parameter Real delTim(
final unit="s",
final quantity="Time",
final min=100*1E-15) "Delay time";
parameter Real samplePeriod(
final unit="s",
final quantity="Time",
final min=1E-3)
"Sample period of component";
parameter Integer numIgnReq "Number of ignored requests";
parameter Real triAmo "Trim amount";
parameter Real resAmo "Respond amount (must have opposite sign of triAmo)";
parameter Real maxRes "Maximum response per time interval (must have same sign as resAmo)";
Buildings.Controls.OBC.CDL.Interfaces.IntegerInput numOfReq
"Number of requests from zones/systems";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput uDevSta
"On/Off status of the associated device";
Buildings.Controls.OBC.CDL.Interfaces.RealOutput y
"Setpoint that have been reset";
Buildings.Controls.OBC.CDL.Logical.TrueDelay tim(
final delayTime=delTim + samplePeriod,
final delayOnInit=true)
"Send an on signal after some delay time";
Buildings.Controls.OBC.CDL.Continuous.GreaterThreshold greThr
"Check if the real requests is more than ignored requests setting";
Buildings.Controls.OBC.CDL.Logical.Switch netRes "Net setpoint reset value";
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant resAmoCon(
final k=resAmo)
"Respond amount constant";
Buildings.Controls.OBC.CDL.Continuous.Product pro
"Products of net requests and respond amount value";
Buildings.Controls.OBC.CDL.Continuous.Product pro1 "Product of trim and respond amount";
Buildings.Controls.OBC.CDL.Continuous.Product pro2 "Product of respond and maximum amount";
Buildings.Controls.OBC.CDL.Discrete.UnitDelay uniDel(
final samplePeriod=samplePeriod,
final y_start=iniSet)
"Output the input signal with a unit delay";
Buildings.Controls.OBC.CDL.Logical.Switch swi
"Switch between initial setpoint and reseted setpoint";
Buildings.Controls.OBC.CDL.Logical.Switch swi1
"Before instant (device ON + delTim + samplePeriod), the setpoint should not be trimmed";
Buildings.Controls.OBC.CDL.Logical.Switch swi2
"Reinitialize setpoint to initial setting when device become OFF";
Buildings.Controls.OBC.CDL.Logical.Switch swi3 "Logical switch";
Buildings.Controls.OBC.CDL.Discrete.Sampler sampler(
final samplePeriod=samplePeriod)
"Sample number of requests";
Buildings.Controls.OBC.CDL.Continuous.LessThreshold lesThr1
"Check if trim and response amount have same sign";
Buildings.Controls.OBC.CDL.Continuous.GreaterThreshold greThr2
"Check if trim and response amount have opposite sign";
Buildings.Controls.OBC.CDL.Continuous.GreaterThreshold greThr1
"Check if response amount have positive sign";
Buildings.Controls.OBC.CDL.Continuous.Gain gai(
final k=-1) "Convert results back to negative";
protected
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant iniSetCon(k=iniSet)
"Initial setpoint";
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant numIgnReqCon(k=numIgnReq)
"Number of ignored requests";
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant triAmoCon(k=triAmo)
"Trim amount constant";
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant maxResCon(k=maxRes)
"Maximum response per time interval";
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant maxSetCon(k=maxSet)
"Maximum setpoint constant";
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant zerTri(k=0)
"Zero reset amount during time range from (device ON) to (device ON + delTim + timSet)";
Buildings.Controls.OBC.CDL.Conversions.IntegerToReal intToRea
"Convert integer input to real output";
Buildings.Controls.OBC.CDL.Continuous.Add difReqIgnReq(k1=-1)
"Difference between ignored request number and the real request number";
Buildings.Controls.OBC.CDL.Continuous.Add add1
"Increase setpoint by amount of value defined from reset logic";
Buildings.Controls.OBC.CDL.Continuous.Add add2 "Net reset value";
Buildings.Controls.OBC.CDL.Continuous.Min minInp
"Total response should not be more than maximum response";
Buildings.Controls.OBC.CDL.Continuous.Min min1
"Reset setpoint should not be higher than the maximum setpoint";
Buildings.Controls.OBC.CDL.Logical.And and2
"After (device ON + delTim + timSta), when request number becomes more than ignored requests number";
Buildings.Controls.OBC.CDL.Logical.Not not1 "Logical Not";
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant minSetCon(k=minSet)
"Minimum setpoint constant";
Buildings.Controls.OBC.CDL.Continuous.Max maxInp
"Reset setpoint should not be lower than the minimum setpoint";
Buildings.Controls.OBC.CDL.Utilities.Assert assMes(
final message="Trim amount 'triAmo' and respond amount 'resAmo' must have opposite signs.")
"Generate alarm message";
Buildings.Controls.OBC.CDL.Utilities.Assert assMes2(
final message="Respond amount 'resAmo' and maximum respond amount 'maxRes' must have same sign.")
"Generate alarm message";
Buildings.Controls.OBC.CDL.Continuous.Abs abs "Absolute value of real input";
Buildings.Controls.OBC.CDL.Continuous.Abs abs1 "Absolute value of real input";
equation
connect(numIgnReqCon.y, difReqIgnReq.u1);
connect(difReqIgnReq.y, greThr.u);
connect(pro.y, minInp.u1);
connect(triAmoCon.y, add2.u1);
connect(add2.y, netRes.u1);
connect(iniSetCon.y, swi.u3);
connect(swi.y, y);
connect(maxSetCon.y, min1.u2);
connect(add1.y, min1.u1);
connect(uniDel.y, add1.u1);
connect(sampler.y, difReqIgnReq.u2);
connect(triAmoCon.y, swi1.u1);
connect(zerTri.y, swi1.u3);
connect(greThr.y, and2.u2);
connect(and2.y, netRes.u2);
connect(iniSetCon.y, swi2.u1);
connect(swi2.y, swi.u1);
connect(swi2.y, uniDel.u);
connect(uDevSta, not1.u);
connect(not1.y, swi2.u2);
connect(min1.y, maxInp.u1);
connect(minSetCon.y, maxInp.u2);
connect(numOfReq, intToRea.u);
connect(intToRea.y, sampler.u);
connect(difReqIgnReq.y, pro.u1);
connect(uDevSta, tim.u);
connect(tim.y, swi.u2);
connect(tim.y, swi1.u2);
connect(and2.u1, tim.y);
connect(maxInp.y, swi2.u3);
connect(triAmoCon.y, pro1.u1);
connect(resAmoCon.y, pro1.u2);
connect(pro1.y, lesThr1.u);
connect(lesThr1.y, assMes.u);
connect(resAmoCon.y, pro2.u1);
connect(maxResCon.y, pro2.u2);
connect(pro2.y, greThr2.u);
connect(greThr2.y, assMes2.u);
connect(resAmoCon.y, abs.u);
connect(abs.y, pro.u2);
connect(maxResCon.y, abs1.u);
connect(abs1.y, minInp.u2);
connect(minInp.y, swi3.u1);
connect(resAmoCon.y, greThr1.u);
connect(greThr1.y, swi3.u2);
connect(netRes.y, add1.u2);
connect(swi1.y, netRes.u3);
connect(minInp.y, gai.u);
connect(gai.y, swi3.u3);
connect(swi3.y, add2.u2);
end TrimAndRespond;
Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.ZoneStatus
Block that outputs zone temperature status
Information
This block outputs single zone status. It includes outputs as following:
-
the times for cooling-down (
yCooTim) and warm-up (yWarTim) the zone, -
THeaSetOn: the zone occupied heating setpoint, -
yOccHeaHig: if the zone temperature is lower than the occupied heating setpoint, -
TCooSetOn: the zone occupied cooling setpoint, -
yHigOccCoo: if the zone temperature is higher than the occupied cooling setpoint, -
THeaSetOff: the zone unoccupied heating setpoint, -
yUnoHeaHig: if the zone temperature is lower than the unoccupied heating setpoint, -
yEndSetBac: if the zone temperature is higher than the unoccupied heating setpoint with the given limitbouLim, then the zone should be out of the setback mode, -
TCooSetOff: the zone unoccupied cooling setpoint, -
yHigUnoCoo: if the zone temperature is higher than the unoccupied cooling setpoint, -
yEndSetUp: if the zone temperature is lower than the unoccupied cooling setpoint with the given limitbouLim, then the zone should be out of the setup mode.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Real | THeaSetOcc | 293.15 | Occupied heating setpoint [K] |
| Real | THeaSetUno | 285.15 | Unoccupied heating setpoint [K] |
| Real | TCooSetOcc | 297.15 | Occupied cooling setpoint [K] |
| Real | TCooSetUno | 303.15 | Unoccupied cooling setpoint [K] |
| Real | bouLim | 1 | Threshold of temperature difference for indicating the end of setback or setup mode [K] |
| Boolean | have_winSen | false | Check if the zone has window status sensor |
| Advanced | |||
| Real | uLow | -0.1 | Low limit of the hysteresis for checking temperature difference |
| Real | uHigh | 0.1 | High limit of the hysteresis for checking temperature difference |
Connectors
| Type | Name | Description |
|---|---|---|
| input RealInput | cooDowTim | Cool-down time retrieved from optimal cool-down block [s] |
| input RealInput | warUpTim | Warm-up time retrieved from optimal warm-up block [s] |
| input BooleanInput | uWin | Window status: true=open, false=close |
| input RealInput | TZon | Single zone temperature [K] |
| output RealOutput | yCooTim | Cool-down time [s] |
| output RealOutput | yWarTim | Warm-up time [s] |
| output RealOutput | THeaSetOn | Occupied heating setpoint [K] |
| output BooleanOutput | yOccHeaHig | True when the zone temperature is lower than the occupied heating setpoint |
| output RealOutput | TCooSetOn | Occupied cooling setpoint temperature [K] |
| output BooleanOutput | yHigOccCoo | True when the zone temperature is higher than the occupied cooling setpoint |
| output RealOutput | THeaSetOff | Unoccupied heating setpoint [K] |
| output BooleanOutput | yUnoHeaHig | True when the zone temperature is lower than the unoccupied heating setpoint |
| output BooleanOutput | yEndSetBac | True when the zone could end setback mode |
| output RealOutput | TCooSetOff | Unoccupied cooling setpoint [K] |
| output BooleanOutput | yHigUnoCoo | True when the zone temperature is higher than the unoccupied cooling setpoint |
| output BooleanOutput | yEndSetUp | True when the zone could end setup mode |
Modelica definition
block ZoneStatus "Block that outputs zone temperature status"
parameter Real THeaSetOcc(
final unit="K",
displayUnit="degC",
final quantity="ThermodynamicTemperature")=293.15
"Occupied heating setpoint";
parameter Real THeaSetUno(
final unit="K",
displayUnit="degC",
final quantity="ThermodynamicTemperature")=285.15
"Unoccupied heating setpoint";
parameter Real TCooSetOcc(
final unit="K",
displayUnit="degC",
final quantity="ThermodynamicTemperature")=297.15
"Occupied cooling setpoint";
parameter Real TCooSetUno(
final unit="K",
displayUnit="degC",
final quantity="ThermodynamicTemperature")=303.15
"Unoccupied cooling setpoint";
parameter Real bouLim(
final unit="K",
displayUnit="K",
final quantity="TemperatureDifference",
final min=0.5) = 1
"Threshold of temperature difference for indicating the end of setback or setup mode";
parameter Boolean have_winSen=false
"Check if the zone has window status sensor";
parameter Real uLow=-0.1
"Low limit of the hysteresis for checking temperature difference";
parameter Real uHigh=0.1
"High limit of the hysteresis for checking temperature difference";
Buildings.Controls.OBC.CDL.Interfaces.RealInput cooDowTim(
final unit="s",
final quantity="Time")
"Cool-down time retrieved from optimal cool-down block";
Buildings.Controls.OBC.CDL.Interfaces.RealInput warUpTim(
final unit="s",
final quantity="Time")
"Warm-up time retrieved from optimal warm-up block";
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput uWin if have_winSen
"Window status: true=open, false=close";
Buildings.Controls.OBC.CDL.Interfaces.RealInput TZon(
final unit="K",
displayUnit="degC",
final quantity="ThermodynamicTemperature") "Single zone temperature";
Buildings.Controls.OBC.CDL.Interfaces.RealOutput yCooTim(
final unit="s",
final quantity="Time") "Cool-down time";
Buildings.Controls.OBC.CDL.Interfaces.RealOutput yWarTim(
final unit="s",
final quantity="Time") "Warm-up time";
Buildings.Controls.OBC.CDL.Interfaces.RealOutput THeaSetOn(
final unit="K",
displayUnit="degC",
final quantity="ThermodynamicTemperature") "Occupied heating setpoint";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput yOccHeaHig
"True when the zone temperature is lower than the occupied heating setpoint";
Buildings.Controls.OBC.CDL.Interfaces.RealOutput TCooSetOn(
final unit="K",
displayUnit="degC",
final quantity="ThermodynamicTemperature")
"Occupied cooling setpoint temperature";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput yHigOccCoo
"True when the zone temperature is higher than the occupied cooling setpoint";
Buildings.Controls.OBC.CDL.Interfaces.RealOutput THeaSetOff(
final unit="K",
displayUnit="degC",
final quantity="ThermodynamicTemperature") "Unoccupied heating setpoint";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput yUnoHeaHig
"True when the zone temperature is lower than the unoccupied heating setpoint";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput yEndSetBac
"True when the zone could end setback mode";
Buildings.Controls.OBC.CDL.Interfaces.RealOutput TCooSetOff(
final unit="K",
displayUnit="degC",
final quantity="ThermodynamicTemperature") "Unoccupied cooling setpoint";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput yHigUnoCoo
"True when the zone temperature is higher than the unoccupied cooling setpoint";
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput yEndSetUp
"True when the zone could end setup mode";
protected
Buildings.Controls.OBC.CDL.Continuous.Product pro
"Decide if the cool down time of one zone should be ignored: if window is open,
then output zero, otherwise, output cool-down time from optimal cool-down block";
Buildings.Controls.OBC.CDL.Continuous.Product pro1
"Decide if the warm-up time of one zone should be ignored: if window is open,
then output zero, otherwise, output warm-up time from optimal warm-up block";
Buildings.Controls.OBC.CDL.Continuous.Add add(
final k2=-1)
"Calculate difference between zone temperature and the occupied heating setpoint";
Buildings.Controls.OBC.CDL.Continuous.Hysteresis hys(
final uLow=uLow,
final uHigh=uHigh)
"Hysteresis that outputs if the system should run in warm-up mode";
Buildings.Controls.OBC.CDL.Continuous.Add add1(
final k1=-1)
"Calculate difference between zone temperature and the occupied cooling setpoint";
Buildings.Controls.OBC.CDL.Continuous.Hysteresis hys1(
final uLow=uLow,
final uHigh=uHigh)
"Hysteresis that outputs if the system should run in cool-down mode";
Buildings.Controls.OBC.CDL.Continuous.Add add2(
final k2=-1)
"Calculate zone temperature difference to unoccupied heating setpoint";
Buildings.Controls.OBC.CDL.Continuous.Hysteresis hys2(
final uLow=uLow,
final uHigh=uHigh)
"Hysteresis that outputs if the zone temperature is lower than unoccupied heating setpoint";
Buildings.Controls.OBC.CDL.Continuous.Add add5(
final k1=-1)
"Calculate zone temperature difference to unoccupied cooling setpoint";
Buildings.Controls.OBC.CDL.Continuous.Hysteresis hys5(
final uLow=uLow,
final uHigh=uHigh)
"Hysteresis that outputs if the zone temperature is higher than unoccupied cooling setpoint";
Buildings.Controls.OBC.CDL.Logical.Not not1 "Logical not";
Buildings.Controls.OBC.CDL.Conversions.BooleanToReal booToRea "Convert Boolean to Real number";
Buildings.Controls.OBC.CDL.Logical.Sources.Constant con(
final k=false) if not have_winSen
"Constant false";
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant occHeaSet(
final k=THeaSetOcc)
"Occupied heating setpoint";
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant unoHeaSet(
final k=THeaSetUno)
"Unoccupied heating setpoint";
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant occCooSet(
final k=TCooSetOcc)
"Occupied cooling setpoint";
Buildings.Controls.OBC.CDL.Continuous.Sources.Constant unoCooSet(
final k=TCooSetUno)
"Unoccupied cooling setpoint";
Buildings.Controls.OBC.CDL.Continuous.Add add3(
final k2=-1)
"Calculate zone temperature difference to unoccupied heating setpoint";
Buildings.Controls.OBC.CDL.Continuous.Hysteresis hys3(
final uLow=0,
final uHigh=bouLim)
"Hysteresis that outputs if the zone temperature is higher than its unoccupied heating setpoint by a given limit";
Buildings.Controls.OBC.CDL.Continuous.Add add4(
final k1=-1)
"Calculate zone temperature difference to unoccupied cooling setpoint";
Buildings.Controls.OBC.CDL.Continuous.Hysteresis hys4(
final uLow=0,
final uHigh=bouLim)
"Hysteresis that outputs if the zone temperature is lower than its unoccupied cooling setpoint by a given limit";
Buildings.Controls.OBC.CDL.Logical.And and2
"When window is open, it should output false";
Buildings.Controls.OBC.CDL.Logical.And and1
"When window is open, it should output false";
Buildings.Controls.OBC.CDL.Logical.And and3
"When window is open, it should output false";
Buildings.Controls.OBC.CDL.Logical.Or or2
"When window is open, it should output true";
Buildings.Controls.OBC.CDL.Logical.And and5
"When window is open, it should output false";
Buildings.Controls.OBC.CDL.Logical.Or or1
"When window is open, it should output true";
equation
connect(cooDowTim, pro.u1);
connect(warUpTim, pro1.u1);
connect(booToRea.y, pro.u2);
connect(booToRea.y, pro1.u2);
connect(add.y, hys.u);
connect(add1.y, hys1.u);
connect(uWin, not1.u);
connect(add2.y, hys2.u);
connect(add5.y, hys5.u);
connect(not1.y, booToRea.u);
connect(pro.y, yCooTim);
connect(pro1.y, yWarTim);
connect(con.y, not1.u);
connect(TZon, add1.u2);
connect(TZon, add.u2);
connect(unoCooSet.y, TCooSetOff);
connect(unoHeaSet.y, THeaSetOff);
connect(occHeaSet.y, THeaSetOn);
connect(occCooSet.y, TCooSetOn);
connect(unoHeaSet.y, add2.u1);
connect(unoCooSet.y, add5.u1);
connect(unoHeaSet.y, add3.u2);
connect(add3.y, hys3.u);
connect(unoCooSet.y, add4.u2);
connect(add4.y, hys4.u);
connect(occHeaSet.y, add.u1);
connect(occCooSet.y, add1.u1);
connect(TZon, add2.u2);
connect(TZon, add3.u1);
connect(TZon, add5.u2);
connect(TZon, add4.u1);
connect(and2.y, yOccHeaHig);
connect(hys.y, and2.u1);
connect(hys1.y, and1.u1);
connect(hys2.y, and3.u1);
connect(hys3.y, or2.u1);
connect(hys5.y, and5.u1);
connect(hys4.y, or1.u1);
connect(not1.y, and2.u2);
connect(not1.y, and1.u2);
connect(and1.y, yHigOccCoo);
connect(and3.y, yUnoHeaHig);
connect(or2.y, yEndSetBac);
connect(and5.y, yHigUnoCoo);
connect(or1.y, yEndSetUp);
connect(uWin, or2.u2);
connect(uWin, or1.u2);
connect(con.y, or2.u2);
connect(con.y, or1.u2);
connect(not1.y, and3.u2);
connect(not1.y, and5.u2);
end ZoneStatus;