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).
Name | Description |
---|---|
AbsoluteSensor | Base class to measure the absolute value of a pin variable |
ConditionalHeatPort | Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network |
CurrentSource | Interface for current sources |
IdealSemiconductor | Ideal semiconductor |
IdealSwitch | Ideal electrical switch |
IdealSwitchWithArc | Ideal switch with simple arc model |
NegativePin | Negative pin of an electrical component |
OnePort | Component with two electrical pins p and n and current i from p to n |
Pin | Pin of an electrical component |
PositivePin | Positive pin of an electrical component |
RelativeSensor | Base class to measure a relative variable between two pins |
TwoPin | Component with two electrical pins |
TwoPort | Component with two electrical ports, including current |
VoltageSource | Interface for voltage sources |
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.
Type | Name | Description |
---|---|---|
ElectricPotential | v | Potential at the pin |
flow Current | i | Current flowing into the pin |
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.
Type | Name | Description |
---|---|---|
ElectricPotential | v | Potential at the pin |
flow Current | i | Current flowing into the pin |
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.
Type | Name | Description |
---|---|---|
ElectricPotential | v | Potential at the pin |
flow Current | i | Current flowing into the pin |
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.
Type | Name | Description |
---|---|---|
PositivePin | p | Positive electrical pin |
NegativePin | n | Negative electrical pin |
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.
Type | Name | Description |
---|---|---|
PositivePin | p | Positive electrical pin |
NegativePin | n | Negative electrical pin |
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.
Type | Name | Description |
---|---|---|
PositivePin | p1 | Positive electrical pin of port 1 |
NegativePin | n1 | Negative electrical pin of port 1 |
PositivePin | p2 | Positive electrical pin of port 2 |
NegativePin | n2 | Negative electrical pin of port 2 |
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.
Type | Name | Default | Description |
---|---|---|---|
Boolean | useHeatPort | false | =true, if heatPort is enabled |
Temperature | T | 293.15 | Fixed device temperature if useHeatPort = false |
Type | Name | Description |
---|---|---|
HeatPort_a | heatPort | Conditional heat port |
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).
Type | Name | Description |
---|---|---|
PositivePin | p | Positive electrical pin |
output RealOutput | y | Measured quantity as Real output signal |
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).
Type | Name | Description |
---|---|---|
PositivePin | p | Positive electrical pin |
NegativePin | n | Negative electrical pin |
output RealOutput | y | Measured quantity as Real output signal |
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).
Type | Name | Default | Description |
---|---|---|---|
Voltage | offset | 0 | Voltage offset |
Time | startTime | 0 | Time offset |
Type | Name | Description |
---|---|---|
PositivePin | p | Positive electrical pin |
NegativePin | n | Negative electrical pin |
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).
Type | Name | Default | Description |
---|---|---|---|
Current | offset | 0 | Current offset |
Time | startTime | 0 | Time offset |
Type | Name | Description |
---|---|---|
PositivePin | p | Positive electrical pin |
NegativePin | n | Negative electrical pin |
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).
Type | Name | Default | Description |
---|---|---|---|
Resistance | Ron | 1e-5 | Forward state-on differential resistance (closed resistance) |
Conductance | Goff | 1e-5 | Backward state-off conductance (opened conductance) |
Voltage | Vknee | 0 | Forward threshold voltage |
Boolean | useHeatPort | false | =true, if heatPort is enabled |
Temperature | T | 293.15 | Fixed device temperature if useHeatPort = false |
Type | Name | Description |
---|---|---|
PositivePin | p | Positive electrical pin |
NegativePin | n | Negative electrical pin |
HeatPort_a | heatPort | Conditional heat port |
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).
Type | Name | Default | Description |
---|---|---|---|
Resistance | Ron | 1e-5 | Closed switch resistance |
Conductance | Goff | 1e-5 | Opened switch conductance |
Boolean | useHeatPort | false | =true, if heatPort is enabled |
final Temperature | T | 293.15 | Fixed device temperature if useHeatPort = false |
Type | Name | Description |
---|---|---|
PositivePin | p | Positive electrical pin |
NegativePin | n | Negative electrical pin |
HeatPort_a | heatPort | Conditional heat port |
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).
Type | Name | Default | Description |
---|---|---|---|
Resistance | Ron | 1e-5 | Closed switch resistance |
Conductance | Goff | 1e-5 | Opened switch conductance |
Voltage | V0 | Initial arc voltage | |
VoltageSlope | dVdt | Arc voltage slope | |
Voltage | Vmax | Max. arc voltage | |
Boolean | useHeatPort | false | =true, if heatPort is enabled |
final Temperature | T | 293.15 | Fixed device temperature if useHeatPort = false |
Type | Name | Description |
---|---|---|
PositivePin | p | Positive electrical pin |
NegativePin | n | Negative electrical pin |
HeatPort_a | heatPort | Conditional heat port |