blockEquipmentAvailability

Equipment availability for heating and cooling applications

Information

If a heat pump is commanded enabled in either heating or cooling mode, it is removed from the staging order of the opposite mode until it has been off for dtOff.

Implementation details

To avoid concurrent stage transitions between heating and cooling modes, "commanded enabled in a given mode" should be interpreted as "required to run in a given mode", and evaluated before the heat pump is actually enabled. Event sequencing during stage transitions introduces a delay between these two events. During this delay, the heat pump should not be considered available for the opposite mode.

Parameters

TypeNameDefaultDescription
Booleanhave_heaWatSet to true for plants that provide HW
Booleanhave_chiWatSet to true for plants that provide CHW
RealdtOff900Off time required before equipment is deemed available again

Connectors

TypeNameDefaultDescription
Buildings.Controls.OBC.CDL.Interfaces.BooleanInputu1EnaHeaEquipment enabled in heating mode
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutputy1HeaEquipment available for heating
Buildings.Controls.OBC.CDL.Interfaces.BooleanInputu1EnaCooEquipment enabled in cooling mode
Buildings.Controls.OBC.CDL.Interfaces.BooleanOutputy1CooEquipment available for cooling
Buildings.Controls.OBC.CDL.Interfaces.BooleanInputu1AvaEquipment available signal

Components

TypeNameDefaultDescription
Utilities.PlaceholderLogicalphCooPlaceholder value if signal is not available
Buildings.Controls.OBC.CDL.Logical.NotoffOrNotHeaReturn true if equipment is off or not in heating mode
Modelica.StateGraph.StateGraphRootstateGraphRoot
Modelica.StateGraph.StepWithSignalonHea
Modelica.StateGraph.InitialStepWithSignalavaModInitial state – Equipment available for all modes
Modelica.StateGraph.TransitionWithSignaltrnToOffTransition to off state
Modelica.StateGraph.StepWithSignalonCoo
Modelica.StateGraph.TransitionWithSignaltrnToCooTransition to cooling mode
Modelica.StateGraph.TransitionWithSignaltrnToHeaTransition to heating mode
Modelica.StateGraph.TransitionWithSignaltrnToOff1Transition to off state
Buildings.Controls.OBC.CDL.Logical.OravaAllHeaReturn true if equipment available for all modes or in heating mode
Buildings.Controls.OBC.CDL.Logical.OravaAllCooReturn true if equipment available for all modes or in cooling mode
Modelica.StateGraph.StepoffStaOff state
Modelica.StateGraph.TransitiontrnToAvaTimTransition back to available state after off time elapsed
Modelica.StateGraph.StepunaStaUnavailable state
Modelica.StateGraph.TransitionWithSignaltrnToUnaTransition to unavailable state
Buildings.Controls.OBC.CDL.Logical.NotunaReturn true if equipment is unavailable
Modelica.StateGraph.TransitionWithSignaltrnToAvaTransition back to available state
Modelica.StateGraph.TransitionWithSignaltrnToUna2Transition to unavailable state
Modelica.StateGraph.TransitionWithSignaltrnToUna3Transition to unavailable state
Utilities.PlaceholderLogicalphHeaPlaceholder value if signal is not available
Buildings.Controls.OBC.CDL.Logical.NotoffOrNotCooReturn true if equipment is off or not in cooling mode

Revisions

  • June 10, 2026, by Antoine Gautier:
    Removed unnecessary Or and And blocks.
    This is for #4624.
  • January 23, 2025, by Antoine Gautier:
    Refactored to use "required to run" conditions.
    This is for #4432.
  • March 29, 2024, by Antoine Gautier:
    First implementation.