> 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/pe-add-on-simulink/model-and-simulation/add-and-configure-a-circuit-model-to-the-system-definition/machine-section.md).

# Machine Section

## Overview

The OPAL-RT Electric Machines allow for simulating the electric motors, mechanical models, and associated sensors and can be coupled with the eHS for customized drive circuits. For our currently supported configurations, please see [**Default Hardware Configurations**](https://www.opal-rt.com/docs/pe-add-on-simulink/hardware-configurations-reference/default-hardware-configurations.md)**.**

Detailed mathematical models of different types of electrical motors can be simulated, such as:

<figure><img src="https://2999842053-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe9Kk9pJCHht2LLBSxPap%2Fuploads%2F5nL1FSxSTglMUWjCWM2a%2F3268ea74-caef-427a-9892-272b053c793a.png?alt=media&amp;token=a965b164-f570-4869-a685-f1a0738d2d21" alt="" width="480"><figcaption></figcaption></figure>

### Permanent Magnet Synchronous Machine (PMSM)

The automotive and transportation industries comprise the core markets for PMSMs. This machine type is known for its power density (power per unit of size/weight), and its higher speed capacity. OPAL-RT’s solutions provide resolver and encoder I/O interfaces and communications protocols to exchange time-accurate information and position sensor responses—crucial for the successful testing and simulation of this motor type.

The following PMSM models have been developed:

* **Dual PMSM BLDC**, which can simulate the following PMSM motor types:
  * PMSM Constant Ld/Lq
  * PMSM Variable Ld/Lq
  * BLDC Constant Ld/Lq
* **Dual PMSM SH**, which can simulate a PMSM Spatial Harmonics (SH) model that relies on finite element analysis

See [**Permanent Magnet Synchronous Machine Models Comparison**](broken://pages/4f4b84bf93421a920cb8d5389848b6a0a0f89a0d) for a comparison of the two models.

### Squirrel-Cage Induction Machine (IM)

Induction motors are widely used as industrial drives because they are self-starting, reliable and economical. They’re also increasingly used with variable-frequency drives (VFDs) in variable-speed service, as well as in wind turbines, for example. OPAL-RT’s solutions support various machine configurations, machine parameters that can be modified at runtime, enabling flexible test possibilities—making our simulation tools indispensable for induction machine control testing.

The following IM models have been developed:

* **Quad IM SM**, which can simulate a Squirrel-Cage Induction Machine (SCIM)

### Brushless DC Motor (BLDC)

A brushless DC motor or BLDC, is synchronous motors powered by direct current (DC) but which you control by feeding alternating current (AC) to drive each phase. The absence of brushes gives BLDC motors the ability to rotate at high-speed and increased efficiency, as well as being low maintenance and durable.

* **BLDC**s have the advantage of being low maintenance, high efficiency, and durability.
* **Dual PMSM BLDC** can simulate a BLDC with Constant Ls motor type

### Round Rotor Synchronous Machine (RRSM)

The Round Rotor Synchronous Machine (sometimes referred to as Electrically Excited Synchronous Machine) is used in similar applications as the PMSM where the defining difference is that instead of permanent magnets the rotor is excited from an external power supply and slip ring. RRSMs are becoming more popular in transportation applications as the reduced cost (due to no permanent magnets) and increased efficiency ranges make them attractive. The disadvantages of RRSMs are the maintenance costs of the slip ring and the additional inverter requirements.

{% hint style="info" %}
For information on the support of other machine types, please contact [**OPAL-RT Technical Support**](https://www.opal-rt.com/contact-technical-support/).
{% endhint %}

### PMSM models comparison

<table><thead><tr><th width="169"></th><th>Variable DQ (VDQ) — Constant Ld/Lq &#x26; Variable Ld/Lq</th><th>Spatial Harmonics (SH) — V1 &#x26; V2</th></tr></thead><tbody><tr><td><strong>Description</strong></td><td>A two‑phase equivalent circuit model using a d–q rotating reference frame with constant Ld, Lq, and magnet flux.</td><td>3-phase detailed model with 3D table for flux, torque and inductance.</td></tr><tr><td><strong>Advantages</strong></td><td><ul><li>Fast execution: ~ 100 ns</li><li>Low FPGA resource usage</li><li>Variable Ld – Lq</li><li>Good for most operating condition</li></ul></td><td><ul><li>Simulation of spatial/current harmonics</li><li>FEA based models</li><li>Mechanical model on FPGA</li></ul></td></tr><tr><td><strong>Disadvantages</strong></td><td>No simulation of current harmonics.</td><td><ul><li>Slower execution: ~ 500 ns</li><li>High FPGA resource usage</li></ul></td></tr><tr><td><strong>Minimum time step</strong></td><td>100 ns</td><td>500 ns</td></tr><tr><td><strong>Electrical machine parameters</strong></td><td><strong>Constant Ld/Lq</strong>: Constant Ld, Lq and magnet flux.<br><strong>Variable Ld/Lq</strong>: 2D tables for Ld, Lq and magnet flux Id and Iq are dependent.</td><td>3D tables for phase inductance, magnet flux and torque tables Id Iq and θ are dependent.</td></tr><tr><td><strong>Mechanical model</strong></td><td>Basic inertia and friction mechanical model attached to the rotor. Users can define their own model on CPU or through customizing the FPGA.</td><td>Basic inertia and friction mechanical model attached to the rotor. Mechanical model available on FPGA.</td></tr><tr><td><strong>Compatibility with JMAG</strong></td><td>No</td><td>JMAG v10.5+</td></tr><tr><td><strong>Compatibility with ANSYS</strong></td><td>No</td><td>ANSYS Maxwell 2016.1+</td></tr><tr><td><strong>Inductance / torque / flux table size</strong></td><td><strong>Constant Ld/Lq</strong>: NA<br><strong>Variable Ld/Lq</strong>: 128x128 for 2 machines</td><td><p><strong>V1:</strong></p><ul><li>32x16x16 samples for 2 machines</li><li>32x32x16 samples for 1 machine</li></ul><p><strong>V2:</strong></p><ul><li>32x32x32 samples for 2 machines</li><li>64x32x32 samples for 1 machine</li></ul></td></tr></tbody></table>

## Available machine models

The types of machine models available in the Machine section of the Configuration tree is dependent upon the selected [**Hardware Configuration**](https://www.opal-rt.com/docs/pe-add-on-simulink/hardware-configurations-reference/default-hardware-configurations.md). See the table below for a list of hardware configurations and their corresponding machine models:

<table><thead><tr><th>Machine Model</th><th width="410">Hardware Configuration</th></tr></thead><tbody><tr><td><strong>6-Phase PMSM BLDC</strong></td><td>eHSx32_6_Ph_PMSM_VDQ_IO_32DO_7868R</td></tr><tr><td><strong>Dual PMSM SH</strong></td><td>eHSx32_Dual_PMSM_SH_IO_7868R</td></tr><tr><td><strong>Dual PMSM BLDC</strong></td><td>eHSx32_Dual_PMSM_VDQ_IO_32DO_7868R</td></tr><tr><td><strong>Dual PMSM BLDC</strong></td><td>eHSx64_Dual_PMSM_VDQ_IO_7868R</td></tr><tr><td><strong>Quad IM SM</strong></td><td>eHSx64_Quad_IM_SM_IO_7868R</td></tr><tr><td><strong>Quad IM with Saturation</strong></td><td>eHSx64_Quad_IM_Saturation_IO_7868R</td></tr><tr><td><strong>6-Phase PMSM BLDC (x2)</strong></td><td>eHSx64_Dual_6_Ph_PMSM_VDQ_IO_7891</td></tr><tr><td><strong>Dual PMSM BLDC, Quad IM SM</strong></td><td>eHSx64_Dual_PMSM_VDQ_Quad_IM_SM_IO_7891</td></tr><tr><td><strong>Dual PMSM SH (x2)</strong></td><td>eHSx64_Quad_PMSM_SH_IO_7891</td></tr><tr><td><strong>Dual PMSM BLDC (x2)</strong></td><td>eHSx64_Quad_PMSM_VDQ_IO_7891</td></tr></tbody></table>


---

# 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/pe-add-on-simulink/model-and-simulation/add-and-configure-a-circuit-model-to-the-system-definition/machine-section.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.
