> For the complete documentation index, see [llms.txt](https://www.opal-rt.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/machines/blocks/machines-control/ac-drives/self-controlled-synchronous-motor-drive.md).

# Self-Controlled Synchronous Motor Drive

## Description <a href="#description" id="description"></a>

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-1def2e13c5f2ba217e6e512f05698d1bd38f24ba%2FAC5_block.png?alt=media" alt=""><figcaption></figcaption></figure>

The **Self-Controlled Synchronous Motor Drive (AC5)** block, located in the **OPAL-RT SPS Software/Electrical Machines/Control/AC Drives** library, commonly called the **AC5 motor drive**, represents a classical vector control drive for wound-field synchronous motors. This drive features unity power factor operation and closed-loop speed control, based on the vector control method. The unity power factor operation is achieved through a voltage controlled, three-phase active rectifier. The speed control loop outputs the reference electromagnetic torque and stator flux of the machine. The reference direct and quadrature (dq) components of the stator current corresponding to the commanded stator flux and torque are derived based on the vector control strategy. These reference dq components of the stator current are then used to obtain the required gate signals for the inverter through a hysteresis-band current controller. The field voltage required by the machine is obtained from the stator flux control loop.

The main advantage of this drive compared to scalar-controlled drives is its fast dynamic response. The inherent coupling effect (between the torque and flux) in the machine is managed through decoupling (stator flux orientation) control, which allows the torque and flux to be controlled independently. However, due to its computation complexity, the implementation of this drive requires fast computing processors or DSPs.

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-e8b6cd2e9381c0d7be07bdbb9b1a22a5ed1a8492%2FAC5_model_diagram.png?alt=media" alt=""><figcaption></figcaption></figure>

The Self-Controlled Synchronous Motor Drive block uses these blocks from the Electric Drives / Fundamental Drive Blocks library:

* Speed Controller (AC)
* Vector Controller (WFSM)
* Active Rectifier
* Inverter (Three-Phase)

The model is discrete. Good simulation results have been obtained with a 2 *µ*s time step. To simulate a digital controller device, the control system has two different sampling times:

* Speed controller sampling time
* Active rectifier controller and vector controller sampling time

The speed controller sampling time has to be a multiple of the vector controller sampling time. The latter sampling time has to be a multiple of the simulation time step. The average-value inverter and rectifier allow the use of bigger simulation time steps since they do not generate small time constants (due to the RC snubbers) inherent to the detailed converters. For a vector controller and active rectifier controller sampling time of 50 µs, good simulation results have been obtained for a simulation time step of 50 µs. This time step can, of course, not be higher than the smallest controller sampling time.

The torque sign convention of the synchronous machine is different from the one of the asynchronous and PM synchronous machines. That is, the synchronous machine is in the motor operation mode when the electric torque is negative and in the generator operation mode when the electric torque is positive.

### Model Specifications <a href="#model-specifications" id="model-specifications"></a>

When the **Output bus mode** parameter is set to **Single output bus**, the block groups the Motor, Conv, and Ctrl outputs into a single bus output.

The library contains a 200 hp drive parameter set. The specifications of the 200 hp drive are shown in the following table.

**14 HP and 200 HP Drive Specifications**

|                          | 14 HP Drive                                              | 200 HP Drive                                              |
| ------------------------ | -------------------------------------------------------- | --------------------------------------------------------- |
| **Drive Input Voltage**  | <p>Amplitude: 460 V<br>Frequency: 60 Hz</p>              | <p>Amplitude: 575 V<br>Frequency: 60 Hz</p>               |
| **Motor Nominal Values** | <p>Power: 14 hp<br>Speed: 1800 rpm<br>Voltage: 460 V</p> | <p>Power: 200 hp<br>Speed: 1785 rpm<br>Voltage: 575 V</p> |

## Parameters <a href="#parameters" id="parameters"></a>

### General <a href="#general" id="general"></a>

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Output bus mode</strong></td><td>Select how the output variables are organized.<br>If you select <strong>Multiple output buses</strong> (default), the block has three separate output buses for motor, converter, and controller variables. If you select <strong>Single output bus</strong>, all variables output on a single bus.</td></tr><tr><td><strong>Model detail level</strong></td><td>Select between the detailed and the average-value inverter. Default is Detailed.</td></tr><tr><td><strong>Mechanical input</strong></td><td><p>Select between the load torque, the motor speed and the mechanical rotational port as mechanical input. Default is Torque Tm.</p><p>If you select and apply a <strong>load torque</strong>, the output is the motor speed according to the following differential equation that describes the mechanical system dynamics:</p><p><span class="math">T_e=J\frac{d}{dt}\omega_r+F\omega_r+T_m \\[4pt]</span></p><p>This mechanical system is included in the motor model.</p><p>If you select the <strong>motor speed</strong> as mechanical input, then you get the electromagnetic torque as output, allowing you to represent externally the mechanical system dynamics. The internal mechanical system is not used with this mechanical input selection and the inertia and viscous friction parameters are not displayed.</p><p>For the <strong>mechanical rotational port</strong>, the connection port S counts for the mechanical input and output. It allows a direct connection to the Simscape environment. The mechanical system of the motor is also included in the drive and is based on the same differential equation.</p><p>See <a href="https://www.opal-rt.com/docs/smart-power-simulation-software-sps/library-specific-guides/motor-drives/mechanical-coupling-of-two-motor-drives.md">Mechanical Coupling of Two Motor Drives.</a></p></td></tr><tr><td><strong>Use signal names as labels</strong></td><td><p>When you select this check box, the <strong>Motor</strong>, <strong>Conv</strong>, and <strong>Ctrl</strong> measurement outputs use the signal names to identify the bus labels. Select this option for applications that require bus signal labels to have only alphanumeric characters.</p><p>When this check box is cleared (default), the measurement output uses the signal definition to identify the bus labels. The labels contain non-alphanumeric characters that are incompatible with some Simulink® applications.</p></td></tr></tbody></table>

### Synchronous Machine Tab <a href="#synchronous-machine-tab" id="synchronous-machine-tab"></a>

The **Synchronous Machine** tab displays the parameters of the Synchronous Machine block of the Fundamental Blocks (powerlib) library.

### Converters and DC Bus Tab <a href="#converters-and-dc-bus-tab" id="converters-and-dc-bus-tab"></a>

#### **Rectifier Section**

The **Rectifier** section of the **Converters and DC Bus** tab displays the parameters of the Universal Bridge block of the Fundamental Blocks (powerlib) library. For more information on the Universal Bridge parameters, refer to the [Universal Bridge](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/power-converters/switches/universal-bridge.md) block page.

The average-value rectifier uses the three following parameters.

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Source frequency</strong></td><td>The frequency of the three-phase voltage source (Hz). Default is 60.</td></tr><tr><td><strong>Source voltage</strong></td><td>The RMS line-to-line voltage of the three-phase voltage source (V). Default is 460.</td></tr><tr><td><strong>On-state resistance</strong></td><td>The on-state resistance of the rectifier devices (ohms). Default is 1e-3.</td></tr></tbody></table>

#### **DC Bus Section**

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Capacitance</strong></td><td>The DC bus capacitance value (F). Default is <code>7500e-6</code>.</td></tr></tbody></table>

#### **Input Choke Section**

Input chokes reduce line current harmonics.

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Resistance</strong></td><td>The input choke resistance value (ohms). Default is 0.05.</td></tr><tr><td><strong>Inductance</strong></td><td>The input choke inductance value (H). Default is 1e-3.</td></tr></tbody></table>

#### **Inverter Section**

The **Inverter** section of the **Converters and DC Bus** tab displays the parameters of the Universal Bridge block of the Fundamental Blocks (powerlib) library. For more information on the Universal Bridge parameters, refer to the Universal Bridge block page.

The average-value inverter uses the two following parameters:

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>On-state resistance</strong></td><td>The on-state resistance of the inverter devices (ohms). Default is 1e-3.</td></tr><tr><td><strong>Forward voltages [Device Vf, Diode Vdf]</strong></td><td>Forward voltages, in volts (V), of the forced-commutated devices and of the antiparallel diodes. These values are needed for startup and for square wave mode.</td></tr></tbody></table>

### Controller Tab <a href="#controller-tab" id="controller-tab"></a>

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Regulation type</strong></td><td>This drop-down menu allows you to choose between speed and torque regulation. Default is Speed regulation.</td></tr><tr><td><strong>Schematic</strong></td><td>When you click this button, a diagram illustrating the speed, rectifier, and vector controllers schematics appears.</td></tr></tbody></table>

#### **Speed Controller Subtab**

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Speed ramps — Acceleration</strong></td><td>The maximum change of speed allowed during motor acceleration. An excessively large positive value can cause DC bus under-voltage (rpm/s). Default is 100.</td></tr><tr><td><strong>Speed ramps — Deceleration</strong></td><td>The maximum change of speed allowed during motor deceleration. An excessively large negative value can cause DC bus over-voltage (rpm/s). Default is -100.</td></tr><tr><td><strong>Speed cutoff frequency</strong></td><td>The speed measurement first-order low-pass filter cutoff frequency (Hz). Default is 5.</td></tr><tr><td><strong>Speed controller sampling time</strong></td><td>The speed controller sampling time (s). The sampling time must be a multiple of the simulation time step. Default is 7*20e-6.</td></tr><tr><td><strong>PI regulator — Proportional gain</strong></td><td>The speed controller proportional gain. Default is 75.</td></tr><tr><td><strong>PI regulator — Integral gain</strong></td><td>The speed controller integral gain. Default is 100.</td></tr><tr><td><strong>Torque output limits — Negative</strong></td><td>The maximum negative demanded torque applied to the motor by the vector controller (N.m). Default is -1200.</td></tr><tr><td><strong>Torque output limits — Positive</strong></td><td>The maximum positive demanded torque applied to the motor by the vector controller (N.m). Default is 1200.</td></tr></tbody></table>

#### **DC Bus Controller Subtab**

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>PI regulator — Proportional gain</strong></td><td>The DC bus voltage controller proportional gain. Default is 10.</td></tr><tr><td><strong>PI regulator — Integral gain</strong></td><td>The DC bus voltage controller integral gain. Default is 100.</td></tr><tr><td><strong>Line current d component limits — Minimum (negative)</strong></td><td>The maximum current flowing from the DC bus capacitor towards the AC line (A). Default is -800.</td></tr><tr><td><strong>Line current d component limits — Maximum (positive)</strong></td><td>The maximum current flowing from the AC line towards the DC bus capacitor (A). Default is 800.</td></tr><tr><td><strong>Voltage measurement cutoff frequency</strong></td><td>The bus voltage measurement low-pass filter cutoff frequency (Hz). Default is 100.</td></tr><tr><td><strong>Active rectifier sampling time</strong></td><td>The DC bus voltage controller sampling time (s). The sampling time must be a multiple of the simulation time step. Default is 20e-6.</td></tr><tr><td><strong>Current hysteresis bandwidth</strong></td><td><p>The current hysteresis bandwidth. Default is <code>10</code>. This value is the total bandwidth distributed symmetrically around the current set point (A). The following figure illustrates a case where the current set point is Is* and the current hysteresis bandwidth is set to dx.</p><p>This parameter is not used when using the average-value inverter.</p><p><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-ac1a24a7ea6b2eba627e9983767e1d55a444ae9e%2FAC5_current_hyst_bandwidth.png?alt=media" alt="" data-size="original"></p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This bandwidth can be exceeded because a fixed-step simulation is used. A rate transition block is needed to transfer data between different sampling rates. This block causes a delay in the gate signals, so the current may exceed the hysteresis band.</p></div></td></tr></tbody></table>

#### **Vector Controller Subtab**

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Controller sampling time</strong></td><td>The vector controller sampling time (s). The sampling time must be a multiple of the simulation time step. Default is 20e-6.</td></tr><tr><td><strong>Machine nominal flux</strong></td><td>The motor stator nominal flux (Wb). Default is 0.98.</td></tr><tr><td><strong>Current hysteresis bandwidth</strong></td><td>The current hysteresis bandwidth (for details, see the <strong>DC Bus Controller</strong> subtab). Default is 10.</td></tr></tbody></table>

#### **Vector Controller Subtab — Flux Controller Section**

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>PI regulator — Proportional gain</strong></td><td>The flux controller proportional gain. Default is 1000.</td></tr><tr><td><strong>PI regulator — Integral gain</strong></td><td>The flux controller integral gain. Default is 1000.</td></tr><tr><td><strong>Voltage limits — Minimum</strong></td><td>The minimum voltage applied to the motor excitation field (V). Default is -300.</td></tr><tr><td><strong>Voltage limits — Maximum</strong></td><td>The maximum voltage applied to the motor excitation field (V). Default is 300.</td></tr><tr><td><strong>Flux estimation lowpass cutoff frequency</strong></td><td>The flux estimation first-order filter cutoff frequency (Hz). Default is 2.</td></tr></tbody></table>

#### **Vector Controller Subtab — Magnetization Controller Section**

When you start the self-controlled synchronous motor, the magnetic flux of the motor must be first established before the motor is allowed to produce an electric torque. Since the motor field time constant is high, a field voltage much higher than nominal is applied in order to accelerate the building of the magnetic flux in the synchronous motor. After the period during which the high voltage is applied, the field voltage is lowered down to its nominal value during a second short period that adds to the latter period giving the total magnetization period. This procedure gives a smooth startup of the self-controlled synchronous motor.

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Field magnetization voltage</strong></td><td>The field magnetization voltage applied in order to establish the stator flux (V). Default is 600.</td></tr><tr><td><strong>High voltage field magnetization time</strong></td><td>The field magnetization high voltage application time (s). Default is 0.2.</td></tr><tr><td><strong>Field nominal voltage</strong></td><td>The field nominal voltage (V). Default is 30.</td></tr><tr><td><strong>Total field magnetization time</strong></td><td>The total time before the drive is ready to produce a torque (s). Default is 1.</td></tr></tbody></table>

## Inputs <a href="#block-inputs-and-outputs" id="block-inputs-and-outputs"></a>

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>SP</strong></td><td>The speed or torque set point. The speed set point can be a step function, but the speed change rate will follow the acceleration / deceleration ramps. If the load torque and the speed have opposite signs, the accelerating torque will be the sum of the electromagnetic and load torques.</td></tr><tr><td><strong>Tm</strong> or <strong>Wm</strong></td><td>The mechanical input: load torque (Tm) or motor speed (Wm). For the mechanical rotational port (S), this input is deleted.</td></tr><tr><td><strong>A, B, C</strong></td><td>The three phase terminals of the motor drive.</td></tr></tbody></table>

## Outputs <a href="#block-inputs-and-outputs" id="block-inputs-and-outputs"></a>

When the **Output bus mode** parameter is set to **Multiple output buses**, the block has the following three output buses:

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Wm</strong>, <strong>Te</strong> or <strong>S</strong></td><td>The mechanical output: motor speed (Wm), electromagnetic torque (Te) or mechanical rotational port (S).</td></tr><tr><td><strong>Motor*</strong></td><td>if <strong>Output bus mode</strong> parameter is set to <strong>Multiple output buses</strong><br>The motor measurement vector. This vector allows you to observe the motor’s variables using the Bus Selector block.</td></tr><tr><td><strong>Conv*</strong></td><td><p>if <strong>Output bus mode</strong> parameter is set to <strong>Multiple output buses</strong><br>The three-phase converters measurement vector. This vector contains:</p><ul><li>The DC bus voltage</li><li>The rectifier output current</li><li>The inverter input current</li></ul><p>Note that all current and voltage values of the bridges can be visualized with the Multimeter block.</p></td></tr><tr><td><strong>Ctrl*</strong></td><td><p>if <strong>Output bus mode</strong> parameter is set to <strong>Multiple output buses</strong><br>The controller measurement vector. This vector contains the values for the active rectifier and for the inverter.</p><p>For the active rectifier:</p><ul><li>The active component of the current reference.</li><li>The voltage error (difference between the DC bus voltage reference and actual DC bus voltage)</li><li>The DC bus voltage reference</li></ul><p>For the inverter:</p><ul><li>The torque reference</li><li>The flux reference</li><li>The speed error (difference between the speed reference ramp and actual speed)</li><li>The speed reference ramp or torque reference</li></ul></td></tr></tbody></table>

**\*** When the **Output bus mode** parameter is set to **Single output bus**, the block groups the Motor, Conv, and Ctrl outputs into a single bus output.

## Examples <a href="#examples" id="examples"></a>

The [AC5 - Self-Controlled Synchronous 200 HP Motor Drive ](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/motor-drives/ac-drives/ac5-self-controlled-synchronous-200-hp-motor-drive.md)(ac5\_example) example illustrates an AC5 motor drive simulation with standard load condition for the detailed and average-value models.

## References <a href="#references" id="references"></a>

\[1] Bose, B. K. **Modern Power Electronics and AC Drives**. Upper Saddle River, NJ: Prentice-Hall, 2002.

\[2] Krause, P. C. **Analysis of Electric Machinery**. New York: McGraw-Hill, 1986.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/machines/blocks/machines-control/ac-drives/self-controlled-synchronous-motor-drive.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
