> 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/page-3.md).

# PM 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-043ac1841279a8eaa3a9a68a20b13453e4ab3c2c%2FAC6_block.png?alt=media" alt=""><figcaption></figcaption></figure>

The **PM Synchronous Motor Drive (AC6) block**, located in the **OPAL-RT SPS Software/Electrical Machines/Control/AC Drives** library, commonly called the **AC6 motor drive**, represents a classical vector control drive for permanent synchronous motors. This drive features a closed-loop speed control based on the vector control method. The speed control loop outputs the reference electromagnetic torque of the machine. The reference direct and quadrature (dq) components of the stator current corresponding to the commanded torque are derived based on vector control strategy. The 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 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-8683138983909ba6a1b4083dfcdd7a89ce3ee238%2FAC6_model_diagram.png?alt=media" alt=""><figcaption></figcaption></figure>

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

* Speed Controller (AC)
* Vector Controller (PMSM)
* DC Bus
* 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
* 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 allows the use of bigger simulation time steps since it does not generate small time constants (due to the RC snubbers) inherent to the detailed converter. For a vector controller sampling time of 75 µs, good simulation results have been obtained for a simulation time step of 75 µs. The simulation time step can, of course, not be higher than the vector controller time step.

The stator current direct component *id\** is set to zero inside the vector controller block because the rotor flux is supplied by the permanent magnets.

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

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

**3 HP Drive Specifications**

|                          | 3 HP Drive                                              |
| ------------------------ | ------------------------------------------------------- |
| **Drive Input Voltage**  | <p>Amplitude: 220 V<br>Frequency: 60 Hz</p>             |
| **Motor Nominal Values** | <p>Power: 3 hp<br>Speed: 1800 rpm<br>Voltage: 300 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.<br>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 nonalphanumeric characters that are incompatible with some Simulink® applications.</p></td></tr></tbody></table>

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

The **Permanent Magnet Synchronous Machine** tab displays the parameters of the Permanent Magnet 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.

**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 (F). Default is 2000e-6.</td></tr></tbody></table>

**Braking Chopper Section**

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Resistance</strong></td><td>The braking chopper resistance used to avoid bus over-voltage during motor deceleration or when the load torque tends to accelerate the motor (ohms). Default is 8.</td></tr><tr><td><strong>Chopper frequency</strong></td><td>The braking chopper frequency (Hz). Default is 4000.</td></tr><tr><td><strong>Activation voltage</strong></td><td>The dynamic braking is activated when the bus voltage reaches the upper limit of the hysteresis band. The following figure illustrates the braking chopper hysteresis logic. Default is 320.</td></tr><tr><td><strong>Shutdown voltage</strong></td><td>The dynamic braking is shut down when the bus voltage reaches the lower limit of the hysteresis band. Default is 310.<br>The chopper hysteresis logic is shown in the following figure.<br><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-32b69cc9d0cb29cbe503a85e82d4c5c3abfe1ced%2FAC3_shutdownvoltage.png?alt=media" alt=""></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](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 inverter uses the 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>On-state resistance</strong></td><td>The on-state resistance of the inverter devices (ohms). Default is 1e-3.</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 pop-up menu allows you to choose between speed and torque regulation. Default is Speed regulation</td></tr><tr><td><strong>Modulation type</strong></td><td>Select hysteresis or space vector modulation. The default modulation type is Hysteresis.</td></tr><tr><td><strong>Schematic</strong></td><td>When you click this button, a diagram illustrating the speed and vector controllers schematics appears.</td></tr></tbody></table>

#### **Speed Controller Section**

<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 (rpm/s). An excessively large positive value can cause DC bus under-voltage. This parameter is used in speed regulation mode only. Default is 1000.</td></tr><tr><td><strong>Speed ramps — Deceleration</strong></td><td>The maximum change of speed allowed during motor deceleration (rpm/s). An excessively large negative value can cause DC bus overvoltage. This parameter is used in speed regulation mode only. Default is -1000.</td></tr><tr><td><strong>Speed cutoff frequency</strong></td><td>The speed measurement first-order low-pass filter cutoff frequency (Hz). This parameter is used in speed regulation mode only. Default is 100.</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. This parameter is used in speed regulation mode only. Default is 5.</td></tr><tr><td><strong>PI regulator — Integral gain</strong></td><td>The speed controller integral gain. This parameter is used in speed regulation mode only. 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 current controller (N.m). Default is -17.8.</td></tr><tr><td><strong>Torque output limits — Positive</strong></td><td>The maximum positive demanded torque applied to the motor by the current controller (N.m). Default is 17.8.</td></tr></tbody></table>

#### **Vector Controller Section**

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>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>Current controller hysteresis band</strong></td><td><p>The current hysteresis bandwidth. Default is 0.1. 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-65f778df8279ac91a2a691d00e4198b8ba6d87d2%2FAC3_current_controller.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><tr><td><strong>Maximum switching frequency</strong></td><td>The maximum inverter switching frequency (Hz). Default is 20e3. This parameter is not used when using the average-value inverter.</td></tr><tr><td><strong>Show/Hide Autotuning Control</strong></td><td>Click to show or hide the parameters of the Autotuning Control tool.</td></tr></tbody></table>

#### **Autotuning of PI loops Section**

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Desired damping [zeta]</strong></td><td>Specify the damping factor used for the calculation of the Kp and Ki gains of the Speed Controller (AC) block. Default is 0.9.</td></tr><tr><td><strong>Desired response time @ 5% [Trd (sec)]</strong></td><td>Specify the desired settling time of the Speed Controller (AC) block. This is time required for the controller response to reach and stay within a 5 percent range of the target value. Default is 0.1.</td></tr><tr><td><strong>Bandwidth ratio (InnerLoop/SpeedLoop)</strong></td><td>Specify the ratio between the bandwidth and natural frequency of the regulator. Default is 30.</td></tr><tr><td><strong>Calculate PI regulator gains</strong></td><td>Compute the <strong>Proportional gain</strong> and <strong>Integral gain</strong> parameters of the Speed Controller (AC) block. The computation is based on the <strong>Desired damping [zeta]</strong>, <strong>Desired response time @ 5%</strong>, and <strong>Bandwidth ratio (InnerLoop/SpeedLoop)</strong> parameters. The computed values are displayed in the mask of the Drive block. Click <strong>Apply</strong> or <strong>OK</strong> to confirm them.</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).</td></tr><tr><td><strong>A, B, C</strong></td><td>The three phase terminals of the motor drive.</td></tr></tbody></table>

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

## Outputs <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>Wm</strong> or <strong>Te</strong></td><td>The mechanical output: motor speed (Wm) or electromagnetic torque (Te).</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:</p><ul><li>The torque 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 AC6 - PM Synchronous 3HP Motor Drive (ac6\_example) example illustrates an AC6 motor drive simulation with standard load condition.

## 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/page-3.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.
