Controlled Current Source (Three-Phase)

Ideal three-phase controlled current source

• 

Libraries:
Simscape / Electrical / Sources

Description

The Controlled Current Source (Three-Phase) block represents an ideal three-phase current source that is powerful enough to maintain the specified current through it regardless of the voltage across it. The output currents are [i_a i_b i_c] = S, where S is a vector containing the numerical values presented at the physical signal port.

The figure shows the equivalent circuit for the expanded implementation of the Controlled Current Source (Three-Phase) block.

To use the Controlled Current Source (Three-Phase) block as an abstracted current controller in an electrical drive, connect the conserving ports for the output current directly to the machine.

To choose the input type of this block, set the Input type parameter to Instantaneous or Sinusoidal magnitude and phase shift. If you select Instantaneous, this block works only in time simulation mode. If you select Sinusoidal magnitude and phase shift, this block works in both time and frequency-time simulation modes. For more information, see Frequency and Time Simulation Mode.

To access the implementation with an expanded, three-phase port, double-click the block and set the Electrical connection parameter to Expanded three-phase ports.

Examples

IPMSM Outer Loop Controller Evaluation

Control the rotor angular velocity in an interior permanent magnet synchronous machine (IPMSM) based electrical-traction drive. For evaluation of the outer loop velocity controller, the inner loop current controller is replaced by a three-phase controlled current source. An ideal torque source provides the load. The Scopes subsystem contains scopes that allow you to see the simulation results. The Control subsystem includes a PI-based outer loop controller. During the three-seconds simulation, the angular velocity demand is -1000, 2000, 3000, 4000, and then 5000 rpm.

• Open Model

Ports

Input

S — Control signal

physical signal

Physical signal input port associated with the control signal.

Dependencies

To enable this port, set the Input type parameter to Instantaneous.

I — Root mean square current

physical signal

Physical signal input port associated with the root mean square (RMS) current.

Dependencies

To enable this port, set the Input type parameter to Sinusoidal magnitude and phase shift.

ph — Phase shift

physical signal

Physical signal input port associated with the phase shift, in radians.

Dependencies

To enable this port, set the Input type parameter to Sinusoidal magnitude and phase shift.

Conserving

n — Neutral phase

electrical

Electrical conserving port associated with the neutral phase.

~ — Three-phase current

electrical

Electrical conserving port associated with the three-phase current.

Dependencies

To enable this port, set the Electrical connection parameter to Composite three-phase ports.

a — a-phase current

electrical

Electrical conserving port associated with the a-phase output current.

Dependencies

To enable this port, set the Electrical connection parameter to Expanded three-phase ports.

b — b-phase current

electrical

Electrical conserving port associated with the b-phase output current.

Dependencies

To enable this port, set the Electrical connection parameter to Expanded three-phase ports.

c — c-phase current

electrical

Electrical conserving port associated with the c-phase output current.

Dependencies

To enable this port, set the Electrical connection parameter to Expanded three-phase ports.

Parameters

Electrical connection — Whether to model composite or expanded three-phase ports

Composite three-phase ports (default) | Expanded three-phase ports

Since R2026a

Whether to model composite or expanded three-phase ports.

Composite three-phase ports represent three individual electrical conserving ports with a single block port. You can use composite three-phase ports to build models that correspond to single-line diagrams of three-phase electrical systems.

Expanded three-phase ports represent the individual phases of a three-phase system using three separate electrical conserving ports.

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

Parameter:	port_option
Values:	"ee.enum.threePhasePort.composite" (default) | "ee.enum.threePhasePort.expanded"

Input type — Type of input

Instantaneous (default) | Sinusoidal magnitude and phase shift

Type of physical signal input. Choose between:

• Instantaneous — The output currents, [i_a i_b i_c], are equal to the values of the input port S.

• Sinusoidal magnitude and phase shift — The output currents are equal to:

  $$\begin{array}{l}{i}_a=\left(\sqrt{2}I\right)\sin \left(2\pi F_{rated}+ph\right)\\ i_b=\left(\sqrt{2}I\right)\sin \left(2\pi F_{rated}+ph-2\frac{\pi }{3}\right)\\ i_c=\left(\sqrt{2}I\right)\sin \left(2\pi F_{rated}+ph+2\frac{\pi }{3}\right)\end{array}$$

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

Parameter:	input_option
Values:	"ee.enum.inputType.instantaneous" (default) | "ee.enum.inputType.singleFreqAC"

Rated electrical frequency — Rated electrical frequency

60 Hz | positive scalar

Rated electrical frequency. The value of this parameter must be equal to the value of the rated electrical frequencies of other sinusoidal sources in your model, if present.

Dependencies

To enable this parameter, set Input type to Sinusoidal magnitude and phase shift.

Parasitic parallel conductance — Parasitic parallel conductance

0 1/Ohm | nonnegative scalar

Since R2026a

Parasitic parallel conductance.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2018b

R2026a: The Modeling option parameter has changed

The Modeling option parameter has been replaced with the Electrical connection parameter. You can now also set this parameter value programmatically by using the set_param function.

If you created a model containing this block in an earlier release, the software now automatically sets the value of the Electrical connection parameter to the previous value of the Modeling option parameter.