blockAssertMinimumRuntime

Assert that heat pumps are not short cycling

Information

This block asserts that each heat pump does not short cycle, based on its enable and heating/cooling mode commands.

If use_runTim=true (default), it asserts that the heat pump has been enabled in the same mode for at least dt_min before its enable command turns false or its mode command changes.

If use_runTim=false, it asserts that the heat pump has been commanded off and its mode command hasn't changed for at least dt_min before its enable command turns true again or its mode command changes.

Parameters

TypeNameDefaultDescription
Booleanhave_chiWatSet to true for reversible HP, false for heating-only HP
Booleanuse_runTimtrueSet to true to assert minimum runtime, false for minimum off time
IntegernUniNumber of units
Realdt_min10*60Minimum runtime or off-time
Stringmessageif use_runTim then "HP minimum runtime is not met." else "HP minimum off-time is not met."Warning message

Connectors

TypeNameDefaultDescription
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput[nUni]u1HP on/off command
Buildings.Controls.OBC.CDL.Interfaces.BooleanInput[nUni]u1HeaHP heating/cooling mode command: true=heating, false=cooling

Components

TypeNameDefaultDescription
Buildings.Controls.OBC.CDL.Logical.TrueFalseHold[nUni]holOnOn/off command held for minimum runtime or off-time
Buildings.Controls.OBC.CDL.Logical.Xor[nUni]xorOnTrue if on/off command differs from held command
Utilities.PlaceholderLogical[nUni]phHeaPlaceholder signal
Buildings.Controls.OBC.CDL.Logical.TrueFalseHold[nUni]holHeaMode command held for minimum runtime or off-time
Buildings.Controls.OBC.CDL.Logical.Xor[nUni]xorHeaTrue if mode command differs from held command
Buildings.Controls.OBC.CDL.Logical.Nor[nUni]norTrue if minimum runtime or off-time is met
Buildings.Controls.OBC.CDL.Utilities.Assert[nUni]assRunTimAssert that minimum runtime or off-time is met

Revisions

  • July 10, 2026, by Antoine Gautier:
    First implementation.