Buildings.Templates.Components.Dampers

Damper models

Information

This package contains models for dampers.

Extends from Modelica.Icons.VariantsPackage (Icon for package containing variants).

Package Content

Name	Description
Modulating	Modulating damper
None	No damper
PressureIndependent	Pressure independent damper
TwoPosition	Two-position damper

Buildings.Templates.Components.Dampers.Modulating

Modulating damper

Buildings.Templates.Components.Dampers.Modulating

Information

This is a model for a modulating damper.

The damper opening is modulated with a fractional opening signal y (real).
y = 0 corresponds to fully closed. y = 1 corresponds to fully open.
The actual damper position y_actual (real) is returned.
y_actual = 0 corresponds to fully closed. y_actual = 1 corresponds to fully open.

Extends from Buildings.Templates.Components.Interfaces.PartialDamper (Interface class for damper).

Parameters

Type	Name	Default	Description
replaceable package Medium		PartialMedium	Medium in the component
Damper	dat		Design and operating parameters
Configuration
Damper	typ	Buildings.Templates.Componen...	Equipment type
Assumptions
Boolean	allowFlowReversal	true	= false to simplify equations, assuming, but not enforcing, no flow reversal
Advanced
MassFlowRate	m_flow_small	1E-4*abs(m_flow_nominal)	Small mass flow rate for regularization of zero flow [kg/s]
Diagnostics
Boolean	show_T	false	= true, if actual temperature at port is computed
Dynamics
Filtered opening
Boolean	use_inputFilter	true	= true, if opening is filtered with a 2nd order CriticalDamping filter
Time	riseTime	120	Rise time of the filter (time to reach 99.6 % of an opening step) [s]
Init	init	Modelica.Blocks.Types.Init.I...	Type of initialization (no init/steady state/initial state/initial output)
Real	y_start	1	Initial position of actuator
Graphics
DamperBlades	typBla	Buildings.Templates.Componen...	Type of blades
Integer	text_rotation	0	Text rotation angle in icon layer
Boolean	text_flip	false	True to flip text horizontally in icon layer

Connectors

Type	Name	Description
FluidPort_a	port_a	Fluid connector a (positive design flow direction is from port_a to port_b)
FluidPort_b	port_b	Fluid connector b (positive design flow direction is from port_a to port_b)
Bus	bus	Control bus

Modelica definition

model Modulating "Modulating damper" extends Buildings.Templates.Components.Interfaces.PartialDamper( final typ=Buildings.Templates.Components.Types.Damper.Modulating, typBla=Buildings.Templates.Components.Types.DamperBlades.Parallel); Buildings.Fluid.Actuators.Dampers.Exponential dam( redeclare final package Medium = Medium, final m_flow_nominal=m_flow_nominal, final dpDamper_nominal=dp_nominal, final dpFixed_nominal=dat.dpFixed_nominal, final use_inputFilter=use_inputFilter, final riseTime=riseTime, final init=init, final y_start=y_start, final allowFlowReversal=allowFlowReversal, final show_T=show_T) "Exponential damper"; equation connect(port_a, dam.port_a); connect(dam.port_b, port_b); connect(dam.y_actual, bus.y_actual); connect(bus.y, dam.y); end Modulating;

Buildings.Templates.Components.Dampers.None

No damper

Buildings.Templates.Components.Dampers.None

Information

This is a direct fluid pass-through model to represent a configuration with no damper.

Extends from Buildings.Templates.Components.Interfaces.PartialDamper (Interface class for damper).

Parameters

Type	Name	Default	Description
replaceable package Medium		PartialMedium	Medium in the component
Damper	dat		Design and operating parameters
Configuration
Damper	typ	Buildings.Templates.Componen...	Equipment type
Assumptions
Boolean	allowFlowReversal	true	= false to simplify equations, assuming, but not enforcing, no flow reversal
Advanced
MassFlowRate	m_flow_small	1E-4*abs(m_flow_nominal)	Small mass flow rate for regularization of zero flow [kg/s]
Diagnostics
Boolean	show_T	false	= true, if actual temperature at port is computed
Dynamics
Filtered opening
Boolean	use_inputFilter	true	= true, if opening is filtered with a 2nd order CriticalDamping filter
Time	riseTime	120	Rise time of the filter (time to reach 99.6 % of an opening step) [s]
Init	init	Modelica.Blocks.Types.Init.I...	Type of initialization (no init/steady state/initial state/initial output)
Real	y_start	1	Initial position of actuator
Graphics
DamperBlades	typBla	Buildings.Templates.Componen...	Type of blades
Integer	text_rotation	0	Text rotation angle in icon layer
Boolean	text_flip	false	True to flip text horizontally in icon layer

Connectors

Type	Name	Description
FluidPort_a	port_a	Fluid connector a (positive design flow direction is from port_a to port_b)
FluidPort_b	port_b	Fluid connector b (positive design flow direction is from port_a to port_b)
Bus	bus	Control bus

Modelica definition

model None "No damper" extends Buildings.Templates.Components.Interfaces.PartialDamper( final typ=Buildings.Templates.Components.Types.Damper.None); equation connect(port_a, port_b); end None;

Buildings.Templates.Components.Dampers.PressureIndependent

Pressure independent damper

Buildings.Templates.Components.Dampers.PressureIndependent

Information

This is a model for a pressure independent damper.

The airflow setpoint is modulated with a fractional airflow signal y (real).
y = 0 corresponds to zero airflow. y = 1 corresponds to the maximum airflow.
The actual damper position y_actual (real) is returned.
y_actual = 0 corresponds to fully closed. y_actual = 1 corresponds to fully open.

Extends from Buildings.Templates.Components.Interfaces.PartialDamper (Interface class for damper).

Parameters

Type	Name	Default	Description
replaceable package Medium		PartialMedium	Medium in the component
Damper	dat		Design and operating parameters
Configuration
Damper	typ	Buildings.Templates.Componen...	Equipment type
Assumptions
Boolean	allowFlowReversal	true	= false to simplify equations, assuming, but not enforcing, no flow reversal
Advanced
MassFlowRate	m_flow_small	1E-4*abs(m_flow_nominal)	Small mass flow rate for regularization of zero flow [kg/s]
Diagnostics
Boolean	show_T	false	= true, if actual temperature at port is computed
Dynamics
Filtered opening
Boolean	use_inputFilter	true	= true, if opening is filtered with a 2nd order CriticalDamping filter
Time	riseTime	120	Rise time of the filter (time to reach 99.6 % of an opening step) [s]
Init	init	Modelica.Blocks.Types.Init.I...	Type of initialization (no init/steady state/initial state/initial output)
Real	y_start	1	Initial position of actuator
Graphics
DamperBlades	typBla	Buildings.Templates.Componen...	Type of blades
Integer	text_rotation	0	Text rotation angle in icon layer
Boolean	text_flip	false	True to flip text horizontally in icon layer

Connectors

Type	Name	Description
FluidPort_a	port_a	Fluid connector a (positive design flow direction is from port_a to port_b)
FluidPort_b	port_b	Fluid connector b (positive design flow direction is from port_a to port_b)
Bus	bus	Control bus

Modelica definition

model PressureIndependent "Pressure independent damper" extends Buildings.Templates.Components.Interfaces.PartialDamper( final typ=Buildings.Templates.Components.Types.Damper.PressureIndependent, final typBla=Buildings.Templates.Components.Types.DamperBlades.VAV); Buildings.Fluid.Actuators.Dampers.PressureIndependent dam( redeclare final package Medium = Medium, final m_flow_nominal=m_flow_nominal, final dpDamper_nominal=dp_nominal, final dpFixed_nominal=dat.dpFixed_nominal, final use_inputFilter=use_inputFilter, final riseTime=riseTime, final init=init, final y_start=y_start, final allowFlowReversal=allowFlowReversal, final show_T=show_T) "Pressure independent damper"; equation connect(dam.port_b, port_b); connect(dam.y_actual, bus.y_actual); connect(port_a, dam.port_a); connect(bus.y, dam.y); end PressureIndependent;

Buildings.Templates.Components.Dampers.TwoPosition

Two-position damper

Buildings.Templates.Components.Dampers.TwoPosition

Information

This is a model for a two-position damper.

The damper is commanded open with a Boolean signal y1.
y1 = 0 corresponds to fully closed. y1 = 1 corresponds to fully open.
The open end switch status y1_actual and closed end switch status y0_actual (Booleans) are returned.
y1_actual = false corresponds to fully closed. y1_actual = true corresponds to fully open. And the opposite for y0_actual.

Extends from Buildings.Templates.Components.Interfaces.PartialDamper (Interface class for damper).

Parameters

Type	Name	Default	Description
replaceable package Medium		PartialMedium	Medium in the component
Damper	dat		Design and operating parameters
Configuration
Damper	typ	Buildings.Templates.Componen...	Equipment type
Assumptions
Boolean	allowFlowReversal	true	= false to simplify equations, assuming, but not enforcing, no flow reversal
Advanced
MassFlowRate	m_flow_small	1E-4*abs(m_flow_nominal)	Small mass flow rate for regularization of zero flow [kg/s]
Diagnostics
Boolean	show_T	false	= true, if actual temperature at port is computed
Dynamics
Filtered opening
Boolean	use_inputFilter	true	= true, if opening is filtered with a 2nd order CriticalDamping filter
Time	riseTime	120	Rise time of the filter (time to reach 99.6 % of an opening step) [s]
Init	init	Modelica.Blocks.Types.Init.I...	Type of initialization (no init/steady state/initial state/initial output)
Real	y_start	1	Initial position of actuator
Graphics
DamperBlades	typBla	Buildings.Templates.Componen...	Type of blades
Integer	text_rotation	0	Text rotation angle in icon layer
Boolean	text_flip	false	True to flip text horizontally in icon layer

Connectors

Type	Name	Description
FluidPort_a	port_a	Fluid connector a (positive design flow direction is from port_a to port_b)
FluidPort_b	port_b	Fluid connector b (positive design flow direction is from port_a to port_b)
Bus	bus	Control bus

Modelica definition

model TwoPosition "Two-position damper" extends Buildings.Templates.Components.Interfaces.PartialDamper( final typ=Buildings.Templates.Components.Types.Damper.TwoPosition, typBla=Buildings.Templates.Components.Types.DamperBlades.Opposed); Buildings.Fluid.Actuators.Dampers.Exponential dam( redeclare final package Medium = Medium, final m_flow_nominal=m_flow_nominal, final dpDamper_nominal=dp_nominal, final dpFixed_nominal=dat.dpFixed_nominal, final use_inputFilter=use_inputFilter, final riseTime=riseTime, final init=init, final y_start=y_start, final allowFlowReversal=allowFlowReversal, final show_T=show_T) "Exponential damper"; Buildings.Controls.OBC.CDL.Conversions.BooleanToReal booToRea( final realTrue=1, final realFalse=0) "Signal conversion"; Buildings.Controls.OBC.CDL.Reals.GreaterThreshold evaOpe(t=0.99, h=0.5E-2) "Return true if open (open end switch contact)"; Buildings.Controls.OBC.CDL.Reals.LessThreshold evaClo(t=0.01, h=0.5E-2) "Return true if closed (closed end switch contact)"; equation connect(port_a, dam.port_a); connect(dam.port_b, port_b); connect(dam.y_actual,evaOpe. u); connect(booToRea.y, dam.y); connect(evaOpe.y, bus.y1_actual); connect(dam.y_actual, evaClo.u); connect(evaClo.y, bus.y0_actual); connect(bus.y1, booToRea.u); end TwoPosition;