Package Modelica.​Electrical.​Analog.​Interfaces
Connectors and partial models for Analog electrical components

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. Furthermore, 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 Contents

NameDescription
AbsoluteSensorBase class to measure the absolute value of a pin variable
ConditionalHeatPortPartial model to include a conditional HeatPort in order to describe the power loss via a thermal network
CurrentSourceInterface for current sources
IdealSemiconductorIdeal semiconductor
IdealSwitchIdeal electrical switch
IdealSwitchWithArcIdeal switch with simple arc model
NegativePinNegative pin of an electrical component
OnePortComponent with two electrical pins p and n and current i from p to n
PinPin of an electrical component
PositivePinPositive pin of an electrical component
RelativeSensorBase class to measure a relative variable between two pins
TwoPinComponent with two electrical pins
TwoPortComponent with two electrical ports, including current
VoltageSourceInterface for voltage sources

Connector Modelica.​Electrical.​Analog.​Interfaces.​Pin
Pin of an electrical component

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.

Fields

TypeNameDescription
ElectricPotentialvPotential at the pin
flow CurrentiCurrent flowing into the pin

Connector Modelica.​Electrical.​Analog.​Interfaces.​PositivePin
Positive pin of an electrical component

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.

Fields

TypeNameDescription
ElectricPotentialvPotential at the pin
flow CurrentiCurrent flowing into the pin

Connector Modelica.​Electrical.​Analog.​Interfaces.​NegativePin
Negative pin of an electrical component

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.

Fields

TypeNameDescription
ElectricPotentialvPotential at the pin
flow CurrentiCurrent flowing into the pin

Partial Model Modelica.​Electrical.​Analog.​Interfaces.​TwoPin
Component with two electrical pins

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

TypeNameDescription
PositivePinpPositive electrical pin
NegativePinnNegative electrical pin

Partial Model Modelica.​Electrical.​Analog.​Interfaces.​OnePort
Component with two electrical pins p and n and current i from p to n

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

TypeNameDescription
PositivePinpPositive electrical pin
NegativePinnNegative electrical pin

Partial Model Modelica.​Electrical.​Analog.​Interfaces.​TwoPort
Component with two electrical ports, including current

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

TypeNameDescription
PositivePinp1Positive electrical pin of port 1
NegativePinn1Negative electrical pin of port 1
PositivePinp2Positive electrical pin of port 2
NegativePinn2Negative electrical pin of port 2

Partial Model Modelica.​Electrical.​Analog.​Interfaces.​ConditionalHeatPort
Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network

Information

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

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

TypeNameDefaultDescription
BooleanuseHeatPortfalse=true, if heatPort is enabled
TemperatureT293.15Fixed device temperature if useHeatPort = false

Connectors

TypeNameDescription
HeatPort_aheatPortConditional heat port

Partial Model Modelica.​Electrical.​Analog.​Interfaces.​AbsoluteSensor
Base class to measure the absolute value of a pin variable

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

TypeNameDescription
PositivePinpPositive electrical pin
output RealOutputyMeasured quantity as Real output signal

Partial Model Modelica.​Electrical.​Analog.​Interfaces.​RelativeSensor
Base class to measure a relative variable between two pins

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

TypeNameDescription
PositivePinpPositive electrical pin
NegativePinnNegative electrical pin
output RealOutputyMeasured quantity as Real output signal

Partial Model Modelica.​Electrical.​Analog.​Interfaces.​VoltageSource
Interface for voltage sources

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 replaceable possibilities.

Extends from Modelica.​Electrical.​Analog.​Interfaces.​OnePort (Component with two electrical pins p and n and current i from p to n).

Parameters

TypeNameDefaultDescription
Voltageoffset0Voltage offset
TimestartTime0Time offset

Connectors

TypeNameDescription
PositivePinpPositive electrical pin
NegativePinnNegative electrical pin

Partial Model Modelica.​Electrical.​Analog.​Interfaces.​CurrentSource
Interface for current sources

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 replaceable possibilities.

Extends from Modelica.​Electrical.​Analog.​Interfaces.​OnePort (Component with two electrical pins p and n and current i from p to n).

Parameters

TypeNameDefaultDescription
Currentoffset0Current offset
TimestartTime0Time offset

Connectors

TypeNameDescription
PositivePinpPositive electrical pin
NegativePinnNegative electrical pin

Partial Model Modelica.​Electrical.​Analog.​Interfaces.​IdealSemiconductor
Ideal semiconductor

Information

This is an ideal semiconductor which is

open (off), if it is reversed biased (voltage drop less than 0)
closed (on), if it is conducting (current > 0).

This is the behaviour if all parameters are exactly zero.

Note, there are circuits, where this ideal description with zero resistance and zero conductance is not possible. In order to prevent singularities during switching, the opened semiconductor has a small conductance Gon and the closed semiconductor has a low resistance Roff which is default.

The parameter Vknee which is the forward threshold voltage, allows to displace the knee point
along the Gon-characteristic until v = Vknee.

Please note: In case of useHeatPort=true the temperature dependence of the electrical behavior is not modelled.

Extends from Modelica.​Electrical.​Analog.​Interfaces.​OnePort (Component with two electrical pins p and n and current i from p to n) and Modelica.​Electrical.​Analog.​Interfaces.​ConditionalHeatPort (Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network).

Parameters

TypeNameDefaultDescription
ResistanceRon1e-5Forward state-on differential resistance (closed resistance)
ConductanceGoff1e-5Backward state-off conductance (opened conductance)
VoltageVknee0Forward threshold voltage
BooleanuseHeatPortfalse=true, if heatPort is enabled
TemperatureT293.15Fixed device temperature if useHeatPort = false

Connectors

TypeNameDescription
PositivePinpPositive electrical pin
NegativePinnNegative electrical pin
HeatPort_aheatPortConditional heat port

Partial Model Modelica.​Electrical.​Analog.​Interfaces.​IdealSwitch
Ideal electrical switch

Information

The ideal switch has a positive pin p and a negative pin n. The switching behaviour is controlled by the boolean signal off. If off is true, pin p is not connected with negative pin n. Otherwise, pin p is connected with negative pin n.

In order to prevent singularities during switching, the opened switch has a (very low) conductance Goff and the closed switch has a (very low) resistance Ron. The limiting case is also allowed, i.e., the resistance Ron of the closed switch could be exactly zero and the conductance Goff of the open switch could be also exactly zero. Note, there are circuits, where a description with zero Ron or zero Goff is not possible.

Please note: In case of useHeatPort=true the temperature dependence of the electrical behavior is not modelled. The parameters are not temperature dependent.

Extends from Modelica.​Electrical.​Analog.​Interfaces.​OnePort (Component with two electrical pins p and n and current i from p to n) and Modelica.​Electrical.​Analog.​Interfaces.​ConditionalHeatPort (Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network).

Parameters

TypeNameDefaultDescription
ResistanceRon1e-5Closed switch resistance
ConductanceGoff1e-5Opened switch conductance
BooleanuseHeatPortfalse=true, if heatPort is enabled
final TemperatureT293.15Fixed device temperature if useHeatPort = false

Connectors

TypeNameDescription
PositivePinpPositive electrical pin
NegativePinnNegative electrical pin
HeatPort_aheatPortConditional heat port

Partial Model Modelica.​Electrical.​Analog.​Interfaces.​IdealSwitchWithArc
Ideal switch with simple arc model

Information

This model is an extension to the IdealSwitch.

The basic model interrupts the current through the switch in an infinitesimal time span. If an inductive circuit is connected, the voltage across the switch is limited only by numerics. In order to give a better idea for the voltage across the switch, a simple arc model is added:

When the Boolean variable off signals to open the switch, a voltage across the opened switch is impressed. This voltage starts with V0 (simulating the voltage drop of the arc roots), then rising with slope dVdt (simulating the rising voltage of an extending arc) until a maximum voltage Vmax is reached.

     | voltage
Vmax |      +-----
     |     /
     |    /
V0   |   +
     |   |
     +---+-------- time

This arc voltage tends to lower the current following through the switch; it depends on the connected circuit, when the arc is quenched. Once the arc is quenched, i.e., the current flowing through the switch gets zero, the equation for the off-state is activated i=Goff*v.

When the Boolean variable off signals to close the switch again, the switch is closed immediately, i.e., the equation for the on-state is activated v=Ron*i.

Please note: In an AC circuit, at least the arc quenches when the next natural zero-crossing of the current occurs. In a DC circuit, the arc will not quench if the arc voltage is not sufficient that a zero-crossing of the current occurs.

Please note: In case of useHeatPort=true the temperature dependence of the electrical behavior is not modelled. The parameters are not temperature dependent.

Extends from Modelica.​Electrical.​Analog.​Interfaces.​OnePort (Component with two electrical pins p and n and current i from p to n) and Modelica.​Electrical.​Analog.​Interfaces.​ConditionalHeatPort (Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network).

Parameters

TypeNameDefaultDescription
ResistanceRon1e-5Closed switch resistance
ConductanceGoff1e-5Opened switch conductance
VoltageV0 Initial arc voltage
VoltageSlopedVdt Arc voltage slope
VoltageVmax Max. arc voltage
BooleanuseHeatPortfalse=true, if heatPort is enabled
final TemperatureT293.15Fixed device temperature if useHeatPort = false

Connectors

TypeNameDescription
PositivePinpPositive electrical pin
NegativePinnNegative electrical pin
HeatPort_aheatPortConditional heat port