> 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/courseware/electric-courseware/electric-motor-drives/permanent-magnet-synchronous-motor-pmsm-drive/panels-overview.md).

# Panels Overview

## Understand the Panel <a href="#understanding-the-panel" id="understanding-the-panel"></a>

The **PMSM Drive** model file, located in the folder **OP1120 - Electric Motors Drives Courseware,** is **MD\_PMSM-version.zip**

When starting the demo, the panel in figure 10 appears first with the default settings.

<figure><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2F10VhpxyyGPqMWHCzlRdv%2F14e8058a-af0c-498f-8f22-a616195c0eb1.png?alt=media&amp;token=5f96987e-15ef-4de2-843d-738210212bf7" alt=""><figcaption><p><strong>Figure 10</strong>: Start-Up Panel of the PMSM Drive Laboratory</p></figcaption></figure>

The panel is to be operated as follows:

* In the upper left corner, under **DC Machine** (DCM) the student can set the field and armature voltages of the DC machine and can change the value of the resistive load.
* In the middle left corner, under **Command**, the student can select the type of control and transformation to be applied to the PMSM.
* Under each command tab, there are **control parameters** and/or **control buttons** that are summarized in tables 2 and 3.
* Once a control or a transformation is selected and applied, the student can observe the related waveforms under **Oscilloscopes**.\
  More details about the displayed waveforms are discussed later.

### Control Parameters of the PMSM Drive

Table 2 summarized the control parameters, while table 3 is dedicated to the control buttons.

| Control Parameters           | Tab             | Default Value | Interval of Variation |
| ---------------------------- | --------------- | ------------- | --------------------- |
| **DCM Field Voltage (V)**    | DC Machine      | 0             | \[0; 460]             |
| **DCM Armature Voltage (V)** | DC Machine      | 0             | \[0; 460]             |
| **DCM Load Resistance (Ω)**  | DC Machine      | 20            | \[5; 35]              |
| **Hysteresis Band**          | Current Control | 0.03          | \[0.01; 0.2]          |
| **Reference Current (A)**    | Current Control | 0             | \[-18.2; 18.2]        |
| **Reference speed (rpm)**    | Speed Control   | 0             | \[-1800; 1800]        |

### Control Buttons&#x20;

<table data-search="false"><thead><tr><th width="168.199951171875">FUNCTION</th><th width="89.79998779296875">Icon</th><th>Description</th></tr></thead><tbody><tr><td><strong>TRIGGER</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FEP0InqMwAwWO7yL9CpSY%2Fimage.png?alt=media&amp;token=c37be4df-f48c-401b-8f8f-7fdbcedaf272" alt="" data-size="original"></td><td><p><em>This button is accessible only in the Transformations Oscilloscopes.</em> </p><p><em>This button is accessible only in the Transformations Oscilloscopes.</em></p></td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FfiPgZV13g9SiPAPUWbIu%2Fimage.png?alt=media&amp;token=b46f0997-7d7e-4b29-b255-0ad3231e5296" alt="" data-size="original"></td><td><p>The waveforms are triggered with respect to a reference signal. </p><p><em>This button is accessible only in the Transformations Oscilloscopes.</em></p></td></tr><tr><td><strong>Reset</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2Fw2zBHPNdTJODJXrPeV0V%2Fimage.png?alt=media&amp;token=ddcd6b65-5ee7-4033-ac23-b186a6c60d01" alt="" data-size="original"></td><td><p>The reset push button is disabled. </p><p><em>This button is accessible and enabled in all scenarios</em></p></td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2F7SGLSBIJvybOhLnC3N3E%2Fimage.png?alt=media&amp;token=5dddfd3a-f77b-4c7e-9ea1-3ff34dc9946f" alt=""></td><td><p>The reset push button is activated and simulates replacement of fuses after a fault. </p><p><em>This button is accessible and enabled in all scenarios</em></p></td></tr><tr><td><strong>K1</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FeOo3cxnjUlPIXnCb06Um%2Fimage.png?alt=media&amp;token=fcba394d-4cab-47ad-a07c-7e9bc3910a26" alt="" data-size="original"></td><td><p>PMSM armature is not connected to the three-phase resistance. </p><p><em>This button is accessible in all scenarios.</em></p></td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2F3v56J1CMcYRBb4aNX8ly%2Fimage.png?alt=media&amp;token=bd15c459-58e6-4a71-b80f-56deac6fdeca" alt=""></td><td>PMSM armature is connected to the three-phase resistance. <em>This button is accessible in all scenarios.</em></td></tr><tr><td><strong>K2</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FEYcbPbmrBu07tpJFJL8i%2Fimage.png?alt=media&amp;token=74c521ba-bda9-444e-83aa-14678ed26dae" alt="" data-size="original"></td><td><p>PMSM armature is not connected to the three-phase two-level inverter. </p><p><em>This button is accessible in all scenarios</em></p></td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2F4of7H4AFj6ui6JX5Jrli%2Fimage.png?alt=media&amp;token=c10fc49f-d6a7-4b27-93a3-afee18b284c4" alt=""></td><td><p>PMSM armature is connected to the three-phase two-level inverter. </p><p><em>This button is accessible in all scenarios</em></p></td></tr><tr><td><strong>Speed Control</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FmkOkb9hwxCzFmTrGLBoL%2Fimage.png?alt=media&amp;token=759a9365-c167-4891-bd3d-8b506a661be0" alt="" data-size="original"></td><td><p>Speed control is disabled. </p><p><em>This button is accessible in Speed Control only.</em></p></td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FC8AMnPP3a059f1VXGJ9P%2Fimage.png?alt=media&amp;token=593d6999-b243-4032-a79c-7d8fedc0f7dc" alt=""></td><td><p>Speed control is enabled. </p><p><em>This button is accessible in Speed Control only.</em></p></td></tr></tbody></table>

### LED Fuse Status Indicators

<table data-search="false"><thead><tr><th width="88.39996337890625">Fuses</th><th>LED indicators</th></tr></thead><tbody><tr><td><p><strong>Fia</strong></p><p><strong>Fia</strong></p></td><td><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2F35XOXR2dPJbnTuuOJKu8%2Fimage.png?alt=media&amp;token=ddf7cbf8-f679-4ce0-8da0-bf5de2ed6163" alt="" data-size="original">The DC machine's armature fuse is blown.</p><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FRY8ltbQmFssx0XgzKJK5%2Fimage.png?alt=media&amp;token=49a3c5c8-4758-4cfb-a410-a58ce9f9c37a" alt="">The DC machine's armature fuse is intact.</p></td></tr><tr><td><p><strong>Fif</strong></p><p><strong>Fif</strong></p></td><td><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FnfyxfnQ6a6LJ7GQlW0u6%2Fimage.png?alt=media&amp;token=fe3e8b9e-7905-4c75-8f68-17a462e284a4" alt="" data-size="original">The DC machine's field fuse is blown.</p><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FgupZXOUxoGLbvfzi7AB4%2Fimage.png?alt=media&amp;token=fae84483-90e2-420e-a42b-1f47e248a372" alt="">The DC machine's field fuse is intact.</p></td></tr><tr><td><p><strong>Fi1</strong></p><p><strong>Fi1</strong></p></td><td><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FKeepqrZRFPK6sSg7zeZR%2Fimage.png?alt=media&amp;token=7d80469d-5bef-4fc2-9ddb-a8f183f945bb" alt="" data-size="original">The induction machine's stator phase 1 fuse is blown.</p><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FSx7vueaXb9llf55u6GQy%2Fimage.png?alt=media&amp;token=45a14639-e3cb-454a-a777-6fe57fcd97e4" alt="">The induction machine's stator phase 1 fuse is intact.</p></td></tr><tr><td><p><strong>Fi2</strong></p><p><strong>Fi2</strong></p></td><td><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2F74egbjDDMjRbrCDxLir7%2Fimage.png?alt=media&amp;token=4510c1ea-95ca-4e92-9fad-e6e2b4f11593" alt="" data-size="original">The induction machine's stator phase 2 fuse is blown.</p><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2Fq2qLSZ0cDjrg75hDF8ek%2Fimage.png?alt=media&amp;token=5ffde44a-62da-4923-b0fb-7594638adf92" alt="">The induction machine's stator phase 2 fuse is intact.</p></td></tr><tr><td><p><strong>Fi3</strong></p><p><strong>Fi3</strong></p></td><td><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FlmmaWoJQ8Z0iECDbGD2z%2Fimage.png?alt=media&amp;token=eb6f005d-d2d8-4c83-b400-3b1a94794dc0" alt="" data-size="original">The induction machine's stator phase 3 fuse is blown.</p><p><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FiQFU1KWbmUSDYMh3WRMy%2Fimage.png?alt=media&amp;token=bf0d85e9-2e46-4250-907a-773faa11fcf0" alt="">The induction machine's stator phase 3 fuse is intact.</p></td></tr><tr><td><strong>Transformation</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FXkKpJ3x0p7xwHPHdqH5G%2Fimage.png?alt=media&amp;token=043ea79a-8eb3-44e9-9ffa-a8f7af8aa390" alt="" data-size="line">Allow selecting Concordia or Clarke transformation. This button is only accessible under the “Transformation” tab.</td></tr><tr><td><strong>Self/Vector Control</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2F1Zyg11QjPQcDej2i79RP%2Fimage.png?alt=media&amp;token=ebae6c8e-bd46-4445-9915-1d7cee51f69d" alt="" data-size="line">Allow selecting self-current control of vector current control. This button is only accessible under the “Current Control” tab.</td></tr><tr><td><strong>Control</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2Fdx6d1dwzzlOO4Af0xEVB%2Fimage.png?alt=media&amp;token=e97c78e1-3e3b-475d-b2c2-d1b4660dd501" alt="" data-size="line">Allow selecting hysteresis or PI current controller. This button is only accessible under the “Current Control” tab.</td></tr></tbody></table>

### Content of Scopes and Displayed Waveforms

On scope localization (for **Current Control**), the indices used will be like those of matrix elements.\
Hence, the scope located in the upper left corner (first row, first column) is denoted Scope<sub>11</sub>, while the scope in the upper right corner (first row, second column) is Scope<sub>12</sub>.\
By the same token, the scope in the lower left corner is Scope<sub>21</sub> while the scope in the lower right corner is Scope<sub>22</sub>.\
Table 4 summarizes the content of scopes for the “Current Control Oscilloscopes”.

<table data-search="false"><thead><tr><th width="219.5999755859375">Oscilloscopes Current Control</th><th width="94.5999755859375">Scope</th><th>Content of Scopes &#x26; Displayed Waveforms</th></tr></thead><tbody><tr><td><strong>Self Current Control: Hysteresis</strong></td><td><strong>Scope</strong><sub><strong>11</strong></sub></td><td>Reference and measured currents at phases A, B and C.</td></tr><tr><td></td><td><strong>Scope</strong><sub><strong>21</strong></sub></td><td>Reference and measured currents at phase A.</td></tr><tr><td></td><td><strong>Scope</strong><sub><strong>12</strong></sub></td><td>Reference and measured currents at axes d and q.</td></tr><tr><td></td><td><strong>Scope</strong><sub><strong>22</strong></sub></td><td>Measured torque and speeds of the PMSM.</td></tr><tr><td><strong>Self Current Control: PI</strong></td><td><strong>Scope</strong><sub><strong>11</strong></sub></td><td>Reference and measured currents at phases A, B and C.</td></tr><tr><td></td><td><strong>Scope</strong><sub><strong>21</strong></sub></td><td>Line-to-neutral reference voltages for phases A, B and C.</td></tr><tr><td></td><td><strong>Scope</strong><sub><strong>12</strong></sub></td><td>Reference and measured currents at axes d and q.</td></tr><tr><td></td><td><strong>Scope</strong><sub><strong>22</strong></sub></td><td>Measured torque and speed of the PMSM.</td></tr><tr><td><strong>Vector Current Control</strong></td><td><strong>Scope</strong><sub><strong>11</strong></sub></td><td>Reference and measured currents at phases A, B and C.</td></tr><tr><td></td><td><strong>Scope</strong><sub><strong>21</strong></sub></td><td>Line-to-neutral reference voltages for phases A, B and C.</td></tr><tr><td></td><td><strong>Scope</strong><sub><strong>12</strong></sub></td><td>Reference and measured currents at axes d and q.</td></tr><tr><td></td><td><strong>Scope</strong><sub><strong>22</strong></sub></td><td>Measured torque and speed of the PMSM.</td></tr></tbody></table>

### Content of Scopes and Displayed Waveforms of the PMSM Drive

Regarding the scopes under “**Speed Control**” tab, a column arrangement is considered, as presented in [**figure 11**](#table-6-content-of-scopes-and-displayed-waveforms-of-transformations-tab) below.\
Going from top to down, the first scope of the **first column** is referred to as Scope<sub>1</sub> and the second one Scope<sub>2</sub>, the three scopes of the **second column** are referred to as Scope<sub>3</sub>, Scope<sub>4</sub>, and Scope<sub>5</sub>.\
Table 5 summarizes the content of scopes for the “Speed Control” tab.

| Oscilloscopes     | Scope             | Content of Scopes & Displayed Waveforms                   |
| ----------------- | ----------------- | --------------------------------------------------------- |
| **Speed Control** | Scope<sub>1</sub> | Reference and measured currents at phases A, B and C.     |
|                   | Scope<sub>2</sub> | Line-to-neutral reference voltages for phases A, B and C. |
|                   | Scope<sub>3</sub> | Reference and measured currents at axes d and q.          |
|                   | Scope<sub>4</sub> | Reference and measured torques of the PMSM.               |
|                   | Scope<sub>5</sub> | Reference and measured speeds of the PMSM.                |

### Content of scopes and displayed waveforms of Transformations tab

For the scopes under “**Transformations**” tab (see [**figure 10** ](#understanding-the-panel)above), the top two scopes are referred to as Scope<sub>1</sub> and Scope<sub>2</sub> from left to right, while the bottom scope is referred to as Scope<sub>3</sub>. Table 6 summarizes the content of scopes for the “Transformations” tab.

| Oscilloscopes     | Scope             | Content of Scopes & Displayed Waveforms                          |
| ----------------- | ----------------- | ---------------------------------------------------------------- |
| **Speed Control** | Scope<sub>1</sub> | Currents at phases A, B and C.                                   |
|                   | Scope<sub>2</sub> | Currents in d-q axes and in α-β axes.                            |
|                   | Scope<sub>3</sub> | Active powers in (a, b, c), (d, q), and (α, β) reference frames. |

<figure><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2Fa5wayLBH3R4reKo1HLlA%2Fbd6f3e07-5b2a-4728-9ee5-47cd0df45029.png?alt=media&amp;token=11e13184-b6fd-45eb-8b7b-5f0a9698531d" alt=""><figcaption><p><strong>Figure 11</strong>: Column Arrangement of Scopes under Speed Control Panel</p></figcaption></figure>

### Parameters and nameplate ratings

Finally, the nominal ratings of PMSM, DCM, three-phase two-level inverter, and the test bench mechanical parameters are presented in tables 7 to 10.

#### PMSM parameters and nameplate ratings

<table data-header-hidden data-search="false"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Apparent Nominal Power</strong></td><td>10200 VA</td></tr><tr><td><strong>Nominal Line-to-line Voltage</strong></td><td>460 V</td></tr><tr><td><strong>Nominal Current</strong></td><td>12.80 A</td></tr><tr><td><strong>Nominal Speed</strong></td><td>1746 rpm</td></tr><tr><td><strong>Nominal Torque</strong></td><td>55 N m</td></tr><tr><td><strong>Number of Pole Pairs</strong></td><td>2</td></tr><tr><td><strong>Base Speed</strong></td><td>1800 rpm</td></tr><tr><td><strong>D-axis Inductance</strong></td><td>0.1132 H</td></tr><tr><td><strong>Q-axis Inductance</strong></td><td>0.0562 H</td></tr><tr><td><strong>Stator Resistance</strong></td><td>1.62 Ω</td></tr><tr><td><strong>Magnet Flux</strong></td><td>1.014 Wb</td></tr></tbody></table>

#### DC machine nameplate ratings

| **Nominal Power**            | 16 HP    |
| ---------------------------- | -------- |
| **Armature Nominal Voltage** | 460 V    |
| **Field Nominal Voltage**    | 460 V    |
| **Field Nominal Current**    | 1.11 A   |
| **Nominal Speed**            | 1746 rpm |

#### Three-phase Two-level Inverter Nameplate Ratings

| DC Input            | Value   |
| ------------------- | ------- |
| **Voltage DC**      | 800 V   |
| **Maximum Current** | 13.75 A |
| **AC Output**       | 3-phase |
| **Voltage LL RMS**  | 460 V   |
| **Maximum Current** | 19.5 A  |
| **Power**           | 11 kW   |

#### Testbench mechanical parameter

| **Total Inertia**  | 0.30 kg.m<sup>2</sup> |
| ------------------ | --------------------- |
| **Total Friction** | 0.0125 N.m            |


---

# 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/courseware/electric-courseware/electric-motor-drives/permanent-magnet-synchronous-motor-pmsm-drive/panels-overview.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.
