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
Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.GroupStatus GroupStatus Block that outputs the zone group status
Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.OperationMode OperationMode Block that outputs the operation mode
Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.TrimAndRespond TrimAndRespond Block to inplement trim and respond logic
Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.ZoneStatus ZoneStatus Block that outputs zone temperature status
Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.Validation Validation Collection of validation models

Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.GroupStatus Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.GroupStatus

Block that outputs the zone group status

Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.GroupStatus

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:

The sequence gives following outputs for zone group level calculation:

Parameters

TypeNameDefaultDescription
IntegernumZon5number of zones in the zone group
Advanced
RealuLow-0.1Low limit of the hysteresis for checking temperature difference
RealuHigh0.1High limit of the hysteresis for checking temperature difference

Connectors

TypeNameDescription
input BooleanInputzonOcc[numZon]True when the zone is set to be occupied due to the override
input BooleanInputuOcc[numZon]True when the zone is occupied according to the occupancy schedule
input RealInputtNexOcc[numZon]Time to next occupied period [s]
input RealInputuCooTim[numZon]Cool down time [s]
input RealInputuWarTim[numZon]Warm-up time [s]
input BooleanInputuOccHeaHig[numZon]True when the zone temperature is lower than the occupied heating setpoint
input BooleanInputuHigOccCoo[numZon]True when the zone temperature is higher than the occupied cooling setpoint
input BooleanInputuUnoHeaHig[numZon]True when the zone temperature is lower than the unoccupied heating setpoint
input RealInputTHeaSetOff[numZon]Zone unoccupied heating setpoint [K]
input BooleanInputuEndSetBac[numZon]True when the zone could end the setback mode
input BooleanInputuHigUnoCoo[numZon]True when the zone temperature is higher than its unoccupied cooling setpoint
input RealInputTCooSetOff[numZon]Zone unoccupied cooling setpoint [K]
input BooleanInputuEndSetUp[numZon]True when the zone could end the setup mode
input RealInputTZon[numZon]Zone temperature [K]
input BooleanInputuWin[numZon]True when the window is open, false when the window is close or the zone does not have window status sensor
output BooleanOutputuGroOccTrue when the zone group is in occupied mode
output RealOutputnexOccTime to next occupied period [s]
output RealOutputyCooTimCool down time [s]
output RealOutputyWarTimWarm-up time [s]
output BooleanOutputyOccHeaHigTrue when there is zone with temperature being lower than the occupied heating setpoint
output BooleanOutputyHigOccCooTrue when there is zone with temperature being higher than the occupied cooling setpoint
output IntegerOutputyColZonTotal number of cold zones
output BooleanOutputySetBacRun setback mode
output BooleanOutputyEndSetBacTrue when the group should end setback mode
output IntegerOutputyHotZonTotal number of hot zones
output BooleanOutputySetUpRun setup mode
output BooleanOutputyEndSetUpTrue when the group should end setup mode
output RealOutputTZonMaxMaximum zone temperature in the zone group [K]
output RealOutputTZonMinMinimum zone temperature in the zone group [K]
output IntegerOutputyOpeWinTotal 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 Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.OperationMode

Block that outputs the operation mode

Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.OperationMode

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.

  1. 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.
  2. 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:

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.

Image of warm-up mode definition

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.

Image of cool-down mode definition

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).

Image of setback mode definition

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.

Image of setup mode definition

Unoccupied Mode

Unoccupied mode shall be active if the zone group is not in any other mode.

Parameters

TypeNameDefaultDescription
IntegernumZon Number of zones
RealpreWarCooTim10800Maximum cool-down or warm-up time [s]
RealTZonFreProOn277.15Threshold temperature to activate the freeze protection mode [K]
RealTZonFreProOff280.15Threshold temperature to end the freeze protection mode [K]

Connectors

TypeNameDescription
input BooleanInputuOccZone occupancy status: true=occupied, false=unoccupied
input RealInputtNexOccTime to next occupied period [s]
input RealInputmaxCooDowTimMaximum cool-down time among all the zones [s]
input BooleanInputuHigOccCooTrue when there is zone with the temperature being higher than the occupied cooling setpoint
input RealInputmaxWarUpTimMaximum warm-up time among all the zones [s]
input BooleanInputuOccHeaHigTrue when there is zone with the temperature being lower than the occupied heating setpoint
input IntegerInputuOpeWinTotal number of zones with opening window
input IntegerInputtotColZonTotal number of cold zone
input BooleanInputuSetBacTrue when the average zone temperature falls below the average unoccupied heating setpoint
input BooleanInputuEndSetBacTrue when the setback mode could end
input RealInputTZonMaxMaximum zone temperature [K]
input RealInputTZonMinMinimum zone temperature [K]
input IntegerInputtotHotZonTotal number of hot zone
input BooleanInputuSetUpTrue when the average zone temperature rises above the average unoccupied cooling setpoint
input BooleanInputuEndSetUpTrue when the setup mode could end
output IntegerOutputyOpeModOperation 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 Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.TrimAndRespond

Block to inplement trim and respond logic

Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.TrimAndRespond

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.

In other words, every time step samplePeriod:

Image of set point reset

Parameters

TypeNameDefaultDescription
RealiniSet Initial setpoint
RealminSet Minimum setpoint
RealmaxSet Maximum setpoint
RealdelTim Delay time [s]
RealsamplePeriod Sample period of component [s]
IntegernumIgnReq Number of ignored requests
RealtriAmo Trim amount
RealresAmo Respond amount (must have opposite sign of triAmo)
RealmaxRes Maximum response per time interval (must have same sign as resAmo)

Connectors

TypeNameDescription
input IntegerInputnumOfReqNumber of requests from zones/systems
input BooleanInputuDevStaOn/Off status of the associated device
output RealOutputySetpoint 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 Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.ZoneStatus

Block that outputs zone temperature status

Buildings.Controls.OBC.ASHRAE.G36_PR1.Generic.SetPoints.ZoneStatus

Information

This block outputs single zone status. It includes outputs as following:

Parameters

TypeNameDefaultDescription
RealTHeaSetOcc293.15Occupied heating setpoint [K]
RealTHeaSetUno285.15Unoccupied heating setpoint [K]
RealTCooSetOcc297.15Occupied cooling setpoint [K]
RealTCooSetUno303.15Unoccupied cooling setpoint [K]
RealbouLim1Threshold of temperature difference for indicating the end of setback or setup mode [K]
Booleanhave_winSenfalseCheck if the zone has window status sensor
Advanced
RealuLow-0.1Low limit of the hysteresis for checking temperature difference
RealuHigh0.1High limit of the hysteresis for checking temperature difference

Connectors

TypeNameDescription
input RealInputcooDowTimCool-down time retrieved from optimal cool-down block [s]
input RealInputwarUpTimWarm-up time retrieved from optimal warm-up block [s]
input BooleanInputuWinWindow status: true=open, false=close
input RealInputTZonSingle zone temperature [K]
output RealOutputyCooTimCool-down time [s]
output RealOutputyWarTimWarm-up time [s]
output RealOutputTHeaSetOnOccupied heating setpoint [K]
output BooleanOutputyOccHeaHigTrue when the zone temperature is lower than the occupied heating setpoint
output RealOutputTCooSetOnOccupied cooling setpoint temperature [K]
output BooleanOutputyHigOccCooTrue when the zone temperature is higher than the occupied cooling setpoint
output RealOutputTHeaSetOffUnoccupied heating setpoint [K]
output BooleanOutputyUnoHeaHigTrue when the zone temperature is lower than the unoccupied heating setpoint
output BooleanOutputyEndSetBacTrue when the zone could end setback mode
output RealOutputTCooSetOffUnoccupied cooling setpoint [K]
output BooleanOutputyHigUnoCooTrue when the zone temperature is higher than the unoccupied cooling setpoint
output BooleanOutputyEndSetUpTrue 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;