Modelica.Electrical.Analog.Interfaces

Information

This package contains connectors and interfaces (partial models) for analog electrical components. The partial models contain typical combinations of pins, and internal variables which are often used. Furthermode, the thermal heat port is in this package which can be included by inheritance.

Extends from Modelica.Icons.InterfacesPackage (Icon for packages containing interfaces).

Package Content

Name	Description
Pin	Pin of an electrical component
PositivePin	Positive pin of an electric component
NegativePin	Negative pin of an electric component
TwoPin	Component with two electrical pins
OnePort	Component with two electrical pins p and n and current i from p to n
TwoPort	Component with two electrical ports, including current
ConditionalHeatPort	Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network
AbsoluteSensor	Base class to measure the absolute value of a pin variable
RelativeSensor	Base class to measure a relative variable between two pins
VoltageSource	Interface for voltage sources
CurrentSource	Interface for current sources

Modelica.Electrical.Analog.Interfaces.Pin

Information

Pin is the basic electric connector. It includes the voltage which consists between the pin and the ground node. The ground node is the node of (any) ground device (Modelica.Electrical.Basic.Ground). Furthermore, the pin includes the current, which is considered to be positive if it is flowing at the pin into the device.

Contents

Type	Name	Description
Voltage	v	Potential at the pin [V]
flow Current	i	Current flowing into the pin [A]

Modelica definition

connector Pin "Pin of an electrical component"
  Modelica.SIunits.Voltage v "Potential at the pin";
  flow Modelica.SIunits.Current i "Current flowing into the pin";
end Pin;

Modelica.Electrical.Analog.Interfaces.PositivePin

Information

Connectors PositivePin and NegativePin are nearly identical. The only difference is that the icons are different in order to identify more easily the pins of a component. Usually, connector PositivePin is used for the positive and connector NegativePin for the negative pin of an electrical component.

Contents

Type	Name	Description
Voltage	v	Potential at the pin [V]
flow Current	i	Current flowing into the pin [A]

Modelica definition

connector PositivePin "Positive pin of an electric component"
  Modelica.SIunits.Voltage v "Potential at the pin";
  flow Modelica.SIunits.Current i "Current flowing into the pin";
end PositivePin;

Modelica.Electrical.Analog.Interfaces.NegativePin

Information

Connectors PositivePin and NegativePin are nearly identical. The only difference is that the icons are different in order to identify more easily the pins of a component. Usually, connector PositivePin is used for the positive and connector NegativePin for the negative pin of an electrical component.

Contents

Type	Name	Description
Voltage	v	Potential at the pin [V]
flow Current	i	Current flowing into the pin [A]

Modelica definition

connector NegativePin "Negative pin of an electric component"
  Modelica.SIunits.Voltage v "Potential at the pin";
  flow Modelica.SIunits.Current i "Current flowing into the pin";
end NegativePin;

Modelica.Electrical.Analog.Interfaces.TwoPin

Information

TwoPin is a partial model with two pins and one internal variable for the voltage over the two pins. Internal currents are not defined. It is intended to be used in cases where the model which inherits TwoPin is composed by combining other components graphically, not by equations.

Connectors

Type	Name	Description
PositivePin	p	Positive pin Positive pin (potential p.v > n.v for positive voltage drop v)
NegativePin	n	Negative pin

Modelica definition

partial model TwoPin "Component with two electrical pins"
  SI.Voltage v "Voltage drop between the two pins (= p.v - n.v)";
  PositivePin p 
    "Positive pin Positive pin (potential p.v > n.v for positive voltage drop v)";
  NegativePin n "Negative pin";
equation 
  v = p.v - n.v;
end TwoPin;

Modelica.Electrical.Analog.Interfaces.OnePort

Information

Superclass of elements which have two electrical pins: the positive pin connector p, and the negative pin connector n. It is assumed that the current flowing into pin p is identical to the current flowing out of pin n. This current is provided explicitly as current i.

Connectors

Type	Name	Description
PositivePin	p	Positive pin (potential p.v > n.v for positive voltage drop v)
NegativePin	n	Negative pin

Modelica definition

partial model OnePort 
  "Component with two electrical pins p and n and current i from p to n"

  SI.Voltage v "Voltage drop between the two pins (= p.v - n.v)";
  SI.Current i "Current flowing from pin p to pin n";
  PositivePin p 
    "Positive pin (potential p.v > n.v for positive voltage drop v)";
  NegativePin n "Negative pin";
equation 
  v = p.v - n.v;
  0 = p.i + n.i;
  i = p.i;
end OnePort;

Modelica.Electrical.Analog.Interfaces.TwoPort

Information

TwoPort is a partial model that consists of two ports. Like OnePort each port has two pins. It is assumed that the current flowing into the positive pin is identical to the current flowing out of pin n. This currents of each port are provided explicitly as currents i1 and i2, the voltages respectively as v1 and v2.

Connectors

Type	Name	Description
PositivePin	p1	Positive pin of the left port (potential p1.v > n1.v for positive voltage drop v1)
NegativePin	n1	Negative pin of the left port
PositivePin	p2	Positive pin of the right port (potential p2.v > n2.v for positive voltage drop v2)
NegativePin	n2	Negative pin of the right port

Modelica definition

partial model TwoPort 
  "Component with two electrical ports, including current"
  SI.Voltage v1 "Voltage drop over the left port";
  SI.Voltage v2 "Voltage drop over the right port";
  SI.Current i1 "Current flowing from pos. to neg. pin of the left port";
  SI.Current i2 "Current flowing from pos. to neg. pin of the right port";
  PositivePin p1 
    "Positive pin of the left port (potential p1.v > n1.v for positive voltage drop v1)";
  NegativePin n1 "Negative pin of the left port";
  PositivePin p2 
    "Positive pin of the right port (potential p2.v > n2.v for positive voltage drop v2)";
  NegativePin n2 "Negative pin of the right port";
equation 
  v1 = p1.v - n1.v;
  v2 = p2.v - n2.v;
  0 = p1.i + n1.i;
  0 = p2.i + n2.i;
  i1 = p1.i;
  i2 = p2.i;
end TwoPort;

Modelica.Electrical.Analog.Interfaces.ConditionalHeatPort

Information

This partial model provides a conditional heating port for the connection to a thermal network.

• If useHeatPort is set to false (default), no heat port is available, and the thermal loss power flows internally to the ground. In this case, the parameter T specifies the fixed device temperature (the default for T = 20^oC).
• If useHeatPort is set to true, a heat port is available.

If this model is used, the loss power has to be provided by an equation in the model which inherits from ConditionalHeatingPort model (lossPower = ...). As device temperature T_heatPort can be used to describe the influence of the device temperature on the model behaviour.

Parameters

Type	Name	Default	Description
Boolean	useHeatPort	false	=true, if HeatPort is enabled
Temperature	T	293.15	Fixed device temperature if useHeatPort = false [K]

Connectors

Type	Name	Description
HeatPort_a	heatPort

Modelica definition

partial model ConditionalHeatPort 
  "Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network"

  parameter Boolean useHeatPort = false "=true, if HeatPort is enabled";
  parameter Modelica.SIunits.Temperature T=293.15 
    "Fixed device temperature if useHeatPort = false";
  Modelica.Thermal.HeatTransfer.Interfaces.HeatPort_a heatPort(T(start=T)=T_heatPort, Q_flow=-LossPower) if useHeatPort;
  Modelica.SIunits.Power LossPower "Loss power leaving component via HeatPort";
  Modelica.SIunits.Temperature T_heatPort "Temperature of HeatPort";
equation 
  if not useHeatPort then
     T_heatPort = T;
  end if;

end ConditionalHeatPort;

Modelica.Electrical.Analog.Interfaces.AbsoluteSensor

Information

The AbsoluteSensor is a partial model for converting values that can be calculated from one pin connector into a real valued signal. The special calculation has to be described in the model which inherits the AbsoluteSensor. It is often used in sensor devices. To be a true sensor the modeller has to take care that the sensor model does not influence the electrical behavior to be measured.

Extends from Modelica.Icons.RotationalSensor (Icon representing a round measurement device).

Connectors

Type	Name	Description
PositivePin	p	Pin to be measured
output RealOutput	y	Measured quantity as Real output signal

Modelica definition

partial model AbsoluteSensor 
  "Base class to measure the absolute value of a pin variable"
  extends Modelica.Icons.RotationalSensor;

  Interfaces.PositivePin p "Pin to be measured";
  Modelica.Blocks.Interfaces.RealOutput y 
    "Measured quantity as Real output signal";

end AbsoluteSensor;

Modelica.Electrical.Analog.Interfaces.RelativeSensor

Information

The RelaticeSensor is a partial model for converting values that can be calculated from two pin connectors into a real valued signal. The special calculation has to be described in the model which inherits the RelativeSensor. It is often used in sensor devices. To be a true sensor the modeller has to take care that the sensor model does not influence the electrical behavior to be measured.

Extends from Modelica.Icons.RotationalSensor (Icon representing a round measurement device).

Connectors

Type	Name	Description
PositivePin	p	Positive pin
NegativePin	n	Negative pin
output RealOutput	y	Measured quantity as Real output signal

Modelica definition

partial model RelativeSensor 
  "Base class to measure a relative variable between two pins"
  extends Modelica.Icons.RotationalSensor;

  Interfaces.PositivePin p "Positive pin";
  Interfaces.NegativePin n "Negative pin";
  Modelica.Blocks.Interfaces.RealOutput y 
    "Measured quantity as Real output signal";
end RelativeSensor;

Modelica.Electrical.Analog.Interfaces.VoltageSource

Information

The VoltageSource partial model prepares voltage sources by providing the pins, and the offset and startTime parameters, which are the same at all voltage sources. The source behavior is taken from Modelica.Blocks signal sources by inheritance and usage of the replacable possibilities.

Extends from OnePort (Component with two electrical pins p and n and current i from p to n).

Parameters

Type	Name	Default	Description
Voltage	offset	0	Voltage offset [V]
Time	startTime	0	Time offset [s]
SignalSource	signalSource	redeclare Modelica.Blocks.In...

Connectors

Type	Name	Description
PositivePin	p	Positive pin (potential p.v > n.v for positive voltage drop v)
NegativePin	n	Negative pin

Modelica definition

partial model VoltageSource "Interface for voltage sources"
  extends OnePort;

  parameter SI.Voltage offset=0 "Voltage offset";
  parameter SI.Time startTime=0 "Time offset";
  replaceable Modelica.Blocks.Interfaces.SignalSource signalSource(
      final offset = offset, final startTime=startTime);
equation 
  v = signalSource.y;
end VoltageSource;

Modelica.Electrical.Analog.Interfaces.CurrentSource

Information

The CurrentSource partial model prepares current sources by providing the pins, and the offset and startTime parameters, which are the same at all current sources. The source behavior is taken from Modelica.Blocks signal sources by inheritance and usage of the replacable possibilities.

Extends from OnePort (Component with two electrical pins p and n and current i from p to n).

Parameters

Type	Name	Default	Description
Current	offset	0	Current offset [A]
Time	startTime	0	Time offset [s]
SignalSource	signalSource	redeclare Modelica.Blocks.In...

Connectors

Type	Name	Description
PositivePin	p	Positive pin (potential p.v > n.v for positive voltage drop v)
NegativePin	n	Negative pin

Modelica definition

partial model CurrentSource "Interface for current sources"
  extends OnePort;
  parameter SI.Current offset=0 "Current offset";
  parameter SI.Time startTime=0 "Time offset";
  replaceable Modelica.Blocks.Interfaces.SignalSource signalSource(
      final offset = offset, final startTime=startTime);
equation 
  i = signalSource.y;
end CurrentSource;