> 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/ehs/3.7/first-steps/choose-the-ehs-firmware/introduction-to-standard-ehs-firmware/op4512-and-op46xx/ehsx128-pmsm-im-ioconfig1.md).

# Legacy Machines PMSM IM IOConfig1

## Firmware specifications

<figure><img src="https://521571437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fo99Izmvvw5eHT4ldzI4g%2Fuploads%2Fgit-blob-33ae93e3d38983864ff177cdbf63f775e49081e9%2FOP4510V2_firmware?alt=media" alt="" width="563"><figcaption></figcaption></figure>

* Compatible with Schematic Editor workflow and Simulink SPS workflow.
* Compatible with XG and XG2 platforms
* Solver eHS x128 Gen4
* 2x PMSM VdQ / BLDC and 4x Generic Machine SCIM/DFIM/RRSM/SPSM
  * 1x Resolver and 1x encoder reserved per machine
  * Double Excitation PMSM Resolvers
* SFP inter-FPGA link
* FPGA Scope
* Thermal losses
* Power Measurement (RT-LAB S-Function workflow only)

### FPGA ports mapping table

<details>

<summary>I/O mapping details table</summary>

| Port Number | LoadIn                                | DataIn                        | DataOut                        |
| ----------- | ------------------------------------- | ----------------------------- | ------------------------------ |
| 1           | Config eHS                            | Inputs eHS                    | eHS Averaged                   |
| 2           | Scenario / Rst eHS = Status           | TSDO 1 - eHS 0 to 7           | eHS DownSample                 |
| 3           |                                       | TSDO 2 - eHS 8 to 15          | Digital In 1A - 0 to 7         |
| 4           | PWM 1A - 0 to 7                       | TSDO 3 - eHS 16 to 23         | Digital In 1A - 8 to 15        |
| 5           | PWM 1A - 8 to 15                      | TSDO 4 - eHS 24 to 31         | Digital In 1A - 16 to 23       |
| 6           | PWM 1A - 16 to 23                     | TSDO 5 - eHS 32 to 39         | Digital In 1A - 24 to 31       |
| 7           | PWM 1A - 24 to 31                     | TSDO 6 - eHS 40 to 47         | Digital In 1B - 0 to 7         |
| 8           | PWM 1B - 0 to 7                       | TSDO 7 - eHS 48 to 55         | Digital In 1B - 8 to 15        |
| 9           | PWM 1B - 8 to 15                      | TSDO 8 - eHS 56 to 63         | Digital In 1B - 16 to 23       |
| 10          | PWM 1B - 16 to 23                     | TSDO 9 - eHS 64 to 71         | Digital In 1B - 24 to 31       |
| 11          | PWM 1B - 24 to 31                     | Digital Out 1A - SDO 0 to 7   | Analog In 2A - 0 to 7          |
| 12          | Config AOMR                           | Digital Out 1A - SDO 8 to 15  | Analog In 2A - 8 to 15         |
| 13          | eHS PWM 1 - eHS 0 to 7                | Digital Out 1A - SDO 16 to 23 | PMSM VDQ 1/2                   |
| 14          | eHS PWM 2 - eHS 8 to 15               | Digital Out 1A - SDO 24 to 31 | Encoder Input on RS422         |
| 15          | eHS PWM 3 - eHS 16 to 23              | Digital Out 1B - SDO 0 to 7   | Quad Generic Machine           |
| 16          | eHS PWM 4 - eHS 24 to 31              | Digital Out 1B - SDO 8 to 15  | Encoder Input on Digital In 1A |
| 17          | Config eHS AIR                        | Digital Out 1B - SDO 16 to 23 | Thermal Losses                 |
| 18          | Config PMSM VDQ1/2                    | Digital Out 1B - SDO 24 to 31 | RMS and Power calculation      |
| 19          | Config Encoder Input on RS422         | AOMR/ Analog Out 1B - 0 to 7  |                                |
| 20          | Config Quad Generic Machine           | Analog Out 1B - 8 to 15       |                                |
| 21          | Config Encoder Input on Digital In 1A |                               |                                |
| 22          | Config Thermal Losses                 |                               |                                |
| 23          | Config Encoder Output on RS422        | eHS PWM 1 - 0 to 7            |                                |
| 24          | SFP                                   | eHS PWM 2 - 8 to 15           |                                |
| 25          | Lookup Table Config                   | eHS PWM 3 - 16 to 23          |                                |
| 26          | RMS and Power calculation             | eHS PWM 4 - 24 to 31          |                                |
| 27          |                                       | eHS SWG                       |                                |
| 28          |                                       | PMSM VDQ 1/2                  |                                |
| 29          |                                       | Quad Generic Machine          |                                |
| 30          |                                       | Thermal Losses                |                                |
| 31          |                                       | Encoder Output on RS422       |                                |
| 32          |                                       | LEDs                          |                                |
| 33          |                                       | TSDO 10 - eHS 72 to 79        |                                |
| 34          |                                       | TSDO 11 - eHS 80 to 87        |                                |
| 35          |                                       | TSDO 12 - eHS 88 to 95        |                                |
| 36          |                                       | TSDO 13 - eHS 96 to 103       |                                |
| 37          |                                       | TSDO 14 - eHS 104 to 111      |                                |
| 38          |                                       | TSDO 15 - eHS 112 to 119      |                                |
| 39          |                                       | TSDO 16 - eHS 120 to 127      |                                |
| 40          |                                       | TSDO 17 - eHS 128 to 135      |                                |
| 41          |                                       | TSDO 18 - eHS 136 to 143      |                                |
| 42          |                                       | SFP                           |                                |
| 43          |                                       | Lookup Table Config           |                                |

</details>

## Supported I/O modules

### IOConfig 1

| I/O Group 1A                                                                                                                                       | I/O Group 1B                                                                                                                                       | I/O Group 2A                                                                                                                 | I/O Group 2B                                                                                                                                                                                             |
| -------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><a href="https://www.opal-rt.com/docs/op53xx/digital-bidirectional-modules/op5369-description">OP5369</a><br>32 Digital Input/Output module</p> | <p><a href="https://www.opal-rt.com/docs/op53xx/digital-bidirectional-modules/op5369-description">OP5369</a><br>32 Digital Input/Output module</p> | <p><a href="https://www.opal-rt.com/docs/op53xx/analog-input-modules/op5340-description">OP5340-1</a><br>16 Analog Input</p> | <p><a href="https://www.opal-rt.com/docs/op53xx/analog-output-modules/op5330-description">OP5330-3</a><br>16 Analog Output at 1MSPS, or<br>8 Analog Output at 2MSPS</p>                                  |
|                                                                                                                                                    |                                                                                                                                                    | or [OP5340-2](https://www.opal-rt.com/docs/op53xx/analog-input-modules/op5340-description) (via polymorphism)                | or [OP5330-1](https://www.opal-rt.com/docs/op53xx/analog-output-modules/op5330-description), [OP5330-2](https://www.opal-rt.com/docs/op53xx/analog-output-modules/op5330-description) (via polymorphism) |

The configuration includes **6 TX and 6 RX RS‑422 digital I/O channels** accessible via **DB9 connectors**. These are mapped to **I/O** **Group 3**, managed by the [OP5969‑1 RS‑422 I/O module](https://www.opal-rt.com/docs/pcie-cards-and-connector-kits/connector-kits/op5969-1-rs-422-i-o-module).

## I/O module mapping and configuration (RT-LAB)

This section applies when using the **recommended S‑Function workflow** in **RT‑LAB**.

For I/O module mapping and configuration when using the **OPAL‑RT Board workflow**, refer to **I/O module mapping and configuration (HYPERSIM)**. The information provided there is also applicable when working with RT‑LAB.

### OpCtrl block configuration

Reference: [**OpCtrl**](https://www.opal-rt.com/docs/rt-lab/simulink-blocks-reference/rt-lab-i-o-library/opctrl) block in RT-LAB

| Parameter                      | Value                                                                       |
| ------------------------------ | --------------------------------------------------------------------------- |
| **Primary Bitstream FileName** | TE0741\_4-EX-0001-3\_10\_0\_41-eHSx128\_Gen4\_Machines\_IOConfig2-3C-18.bin |
| **Board Type**                 | TE0741                                                                      |

### Groups 1A and 1B - Digital inputs/outputs

Refer to [OP5369 pin assignment](https://www.opal-rt.com/docs/op53xx/digital-bidirectional-modules/op5369-description/db37f-pin-assignment) for hardware connections.

The **OP5369 32‑channel digital I/O module** is divided into **8‑channel subsections**, each of which can be **independently configured** as either **digital input** or **digital output**.

#### Mezzanine Option block configuration

To configure thresholds on the OP5369 32-channel digital I/O module, utilize the [**Mezzanine Option**](https://www.opal-rt.com/docs/rt-lab/simulink-blocks-reference/rt-lab-i-o-library/mezzanine-option) block and set the desired threshold values for each 8-channel group.

**Mezzanine Option block for Group 1A**

| Parameter          | Value           |
| ------------------ | --------------- |
| **Mezzanine type** | OP5369 - 32 DIO |
| **Chassis slot**   | Slot 1 Module A |

**Mezzanine Option block for Group 1B**

| Parameter          | Value           |
| ------------------ | --------------- |
| **Mezzanine type** | OP5369 - 32 DIO |
| **Chassis slot**   | Slot 1 Module B |

#### Schematic Editor digital inputs/outputs configuration

Electric circuit **switch blocks** are directly mapped to the module’s **digital inputs** in Schematic Editor by selecting the block and assigning the desired module channel(s) as gate signal source(s).

Electric circuit **machine blocks** can have their **encoder outputs** mapped to the module's **digital outputs** in the Schematic Editor. However, the user does not select specific module channels; instead, encoder must be enabled for the machine, after which the encoder signals are automatically mapped to either **I/O Group 1A** or **RS422 I/O Group 3B**. Open the **eHS Build Report** to determine the I/O group used.

#### Digital Input blocks configuration

When using [**Digital In**](https://www.opal-rt.com/docs/rt-lab/simulink-blocks-reference/rt-lab-i-o-library/digital-in), [**PWM In**](https://www.opal-rt.com/docs/rt-lab/simulink-blocks-reference/rt-lab-i-o-library/pwm-in), or [**Event Detector**](https://www.opal-rt.com/docs/rt-lab/simulink-blocks-reference/rt-lab-i-o-library/event-detector) blocks in the RT-LAB model, ensure you assign the correct **DataOut port number** to the channel group.

| Parameter                                                                | CH00-07 | CH08-15 | CH16-23 | CH24-31 |
| ------------------------------------------------------------------------ | :-----: | :-----: | :-----: | :-----: |
| <p><strong>Group 1A</strong><br><strong>DataOut port number</strong></p> |    3    |    4    |    5    |    6    |
| <p><strong>Group 1B</strong><br><strong>DataOut port number</strong></p> |    7    |    8    |    9    |    10   |

#### Digital Output block configuration

When using [**Digital Out**](https://www.opal-rt.com/docs/rt-lab/simulink-blocks-reference/rt-lab-i-o-library/digital-out), [**PWM Out**](https://www.opal-rt.com/docs/rt-lab/simulink-blocks-reference/rt-lab-i-o-library/pwm-out), or [**Event Generator**](https://www.opal-rt.com/docs/rt-lab/simulink-blocks-reference/rt-lab-i-o-library/event-generator) blocks in the RT-LAB model, ensure you assign the correct **DataIn** **port number** to the channel group.

| Parameter                                                               | CH00-07 | CH08-15 | CH16-23 | CH24-31 |
| ----------------------------------------------------------------------- | :-----: | :-----: | :-----: | :-----: |
| <p><strong>Group 1A</strong><br><strong>DataIn port number</strong></p> |    11   |    12   |    13   |    14   |
| <p><strong>Group 1B</strong><br><strong>DataIn port number</strong></p> |    15   |    16   |    17   |    18   |

#### Encoder In block configuration

When using an [**Encoder In**](https://www.opal-rt.com/docs/rt-lab/simulink-blocks-reference/rt-lab-i-o-library/encoder-in) block in the RT-LAB model, ensure you assign the correct **DataOut port number**.

| Parameter               | Group 1A |
| ----------------------- | :------: |
| **DataOut Port Number** |    16    |

### Group 2A - Analog inputs

Refer to [OP5340 pin assignment](https://www.opal-rt.com/docs/op53xx/analog-input-modules/op5340-description/db37f-pin-assignment) for hardware connections.

#### Schematic Editor analog inputs configuration

Electric circuit **sources blocks** are directly mapped to the module's **analog inputs** in the Schematic Editor by selecting the block and assigning the desired module channel as the source.

Electric circuit **machine blocks** can also have their **resolver excitation source** mapped to the module's **analog inputs** in the Schematic Editor by enabling the resolver for the machine block and assigning the desired module channel as the excitation source.

#### Analog In block configuration

When using [**Analog In**](https://www.opal-rt.com/docs/rt-lab/simulink-blocks-reference/rt-lab-i-o-library/analog-in) blocks in the RT-LAB model, ensure you assign the correct **DataOut port number** to the channel group.​

| Parameter               | CH00-07 | CH08-15 |
| ----------------------- | ------- | ------- |
| **DataOut Port Number** | 11      | 12      |

### Group 2B - Analog outputs

Refer to [OP5330 pin assignment](https://www.opal-rt.com/docs/op53xx/analog-output-modules/op5330-description/db37f-pin-assignment) for hardware connections.

#### Schematic Editor analog outputs configuration

Electric circuit **measurement blocks** are directly mapped to the module's **analog outputs** in the Schematic Editor by selecting the block and assigning the desired module channel as the destination.

#### Analog Out block configuration

When using [**Analog Out**](https://www.opal-rt.com/docs/rt-lab/simulink-blocks-reference/rt-lab-i-o-library/analog-out) blocks in the RT-LAB model, ensure you assign the correct **DataIn port number** to the channel group.

{% hint style="danger" %}
Mapping a single electric circuit measurement block to an analog output in Schematic Editor reserves all 16 channels for eHS, disabling Analog Out blocks in the RT‑LAB model.
{% endhint %}

| Parameter                                                               | CH00-07 | CH08-15 |
| ----------------------------------------------------------------------- | ------- | ------- |
| <p><strong>Group 2B</strong><br><strong>DataIn Port Number</strong></p> | 19      | 20      |

### Groups 3A and 3B - RS‑422 Digital inputs/outputs

[**OP5969‑1**](https://www.opal-rt.com/docs/pcie-cards-and-connector-kits/connector-kits/op5969-1-rs-422-i-o-module) - **RS‑422 Digital inputs and outputs**

#### Section A - RS422 Digital Inputs

When using an [**Encoder In**](https://www.opal-rt.com/docs/rt-lab/simulink-blocks-reference/rt-lab-i-o-library/encoder-in) block in the RT-LAB model, ensure you assign the correct **DataOut port number**.

#### Encoder In block configuration

| Parameter               | RS422 |
| ----------------------- | :---: |
| **DataOut Port Number** |   14  |

#### Section B - RS422 Digital outputs

Electric circuit **machine blocks** can have their **encoder outputs** mapped to the module's **RS422 outputs** in the Schematic Editor. However, the user does not select specific module channels; instead, encoder must be enabled for the machine, after which the encoder signals are automatically mapped to either **I/O Group 1A** or **RS422 I/O Group 3B**. Open the **eHS Build Report** to determine the I/O group used.

#### Encoder Out block configuration

When using an [**Encoder Out**](https://www.opal-rt.com/docs/rt-lab/simulink-blocks-reference/rt-lab-i-o-library/encoder-out) block in the RT-LAB model, ensure you assign the correct **DataIn port number**.

{% hint style="danger" %}
Mapping a machine block encoder to a digital output in Schematic Editor reserves all RS422 digital output channels for eHS, disabling Encoder Out blocks in the RT‑LAB model.
{% endhint %}

| Parameter              | Value |
| ---------------------- | :---: |
| **DataIn Port Number** |   31  |

### SFP module

#### Schematic Editor SFP configuration

Electric circuit **sources blocks** can be mapped to the module's **SFP CH00** **input** in the Schematic Editor by selecting the block and assigning the desired **SFP input signal** as the source. All SFP input signals are carried through a **single SFP channel (CH00)**, which provides **32 input signals**. All other SFP channels are disabled in this firmware.

Electric circuit **measurement blocks** can be mapped to the module's **SFP CH00** **output** in the Schematic Editor by selecting the block and assigning the desired **SFP output signal** as the destination. All SFP output signals are carried through a **single SFP channel (CH00)**, which provides **32 output signals**. All other SFP channels are disabled in this firmware.

#### DataIn Send block configuration

Signals from the RT‑LAB model can be sent to the SFP CH00 output a [**DataIn Send**](https://www.opal-rt.com/docs/rt-lab/simulink-blocks-reference/rt-lab-i-o-library/datain-send) block. Ensure you assign the correct **DataIn port number**.

{% hint style="danger" %}
Mapping a single electric circuit measurement block to an SFP output signal in Schematic Editor reserves all SFP output signals for eHS, disabling SFP output in the RT‑LAB model.
{% endhint %}

| Parameter              | SFP CH00 |
| ---------------------- | -------- |
| **DataIn Port Number** | 42       |

### Power measurement

To get RMS and power calculation from the eHS electrical circuit, a [**Power Measurement Controller**](https://www.opal-rt.com/docs/rt-lab/simulink-blocks-reference/efpgasim-library/power-measurement-controller) block must be used in the RT-LAB model.

#### Power Measurement Controller block configuration

| Parameter               | Value |
| ----------------------- | ----- |
| **LoadIn Port Number**  | 26    |
| **DataOut Port Number** | 18    |

### Thermal losses

To assign switching losses and conducting losses for 2-levels bridge within the eHS electric circuit, the [**Thermal Losses CPU**](https://www.opal-rt.com/docs/rt-lab/simulink-blocks-reference/efpgasim-library/opal-rt-schematic-editor-workflow/thermal-losses-cpu) block must be used in the RT-LAB model.

#### Thermal Losses CPU block configuration

| Parameter               | Value |
| ----------------------- | ----- |
| **DataIn Port Number**  | 30    |
| **DataOut Port Number** | 17    |
| **LoadIn Port Number**  | 22    |

## I/O module mapping and configuration (HYPERSIM)

### OPAL-RT Board configuration

| Parameter                            | Value                                                                        |
| ------------------------------------ | ---------------------------------------------------------------------------- |
| **Chassis type**                     | OP4xxx (Kintex-7)                                                            |
| **Bitstream configuration location** | Standard repositories                                                        |
| **Bitstream configuration file**     | TE0741\_4-EX-0001-3\_10\_0\_41-eHSx128\_Gen4\_Machines\_IOConfig2-3C-18.opal |

### Groups 1A and 1B - Digital inputs/outputs

Refer to [OP5369 pin assignment](https://www.opal-rt.com/docs/op53xx/digital-bidirectional-modules/op5369-description/db37f-pin-assignment) for hardware connections.

The **OP5369 32‑channel digital I/O module** is divided into **8‑channel subsections**, each of which can be **independently configured** as either **digital input** or **digital output**.

Electric circuit **switch blocks** are directly mapped to the module’s **digital inputs** in Schematic Editor by selecting the block and assigning the desired module channel(s) as gate signal source(s).

Electric circuit **machine blocks** can have their **encoder outputs** mapped to the module's **digital outputs** in the Schematic Editor. However, the user does not select specific module channels; instead, encoder must be enabled for the machine, after which the encoder signals are automatically mapped to either **I/O Group 1A** or **RS422 I/O Group 3B**. Open the **eHS Build Report** to determine the I/O group used.

Mapping **HYPERSIM model signals** to the module's **digital inputs/outputs** follows the standard OPAL‑RT board workflow.

### Group 2A - Analog inputs

Refer to [OP5342 pin assignment](https://www.opal-rt.com/docs/op53xx/analog-input-modules/op5342-description/db37f-pin-assignment) for hardware connections.

Electric circuit **sources blocks** are directly mapped to the module's **analog inputs** in the Schematic Editor by selecting the block and assigning the desired module channel as the source.

Electric circuit **machine blocks** can also have their **resolver excitation source** mapped to the module's **analog inputs** in the Schematic Editor by enabling the resolver for the machine block and assigning the desired module channel as the excitation source.

Mapping **HYPERSIM model signals** to the module's **analog inputs** follows the standard OPAL‑RT board workflow.

### Group 2B - Analog outputs

Refer to [OP5330 pin assignment](https://www.opal-rt.com/docs/op53xx/analog-output-modules/op5330-description/db37f-pin-assignment) for hardware connections.

Electric circuit **measurement blocks** are directly mapped to the module's **analog outputs** in the Schematic Editor by selecting the block and assigning the desired module channel as the destination.

Mapping **HYPERSIM model signals** to the module's **analog outputs** follows the standard OPAL‑RT board workflow.

{% hint style="danger" %}
Mapping a single electric circuit measurement block to an analog output in Schematic Editor reserves all 16 channels for eHS, disabling analog output mapping in the HYPERSIM model.
{% endhint %}

### Groups 3A and 3B - RS‑422 Digital inputs/outputs

#### Section A - RS422 Digital Inputs

Mapping **HYPERSIM model signals** to the module's **RS422** **digital inputs** follows the standard OPAL‑RT board workflow.

#### Section B - RS422 Digital outputs

Electric circuit **machine blocks** can have their **encoder outputs** mapped to the module's **RS422 outputs** in the Schematic Editor. However, the user does not select specific module channels; instead, encoder must be enabled for the machine, after which the encoder signals are automatically mapped to either **I/O Group 1A** or **RS422 I/O Group 3B**. Open the **eHS Build Report** to determine the I/O group used.

Mapping **HYPERSIM model signals** to the module's **RS422** **digital outputs** follows the standard OPAL‑RT board workflow.

{% hint style="danger" %}
Mapping a machine block encoder to an analog output in Schematic Editor reserves all RS422 digital output channels for eHS, disabling encoder output mapping in the HYPERSIM model.
{% endhint %}

### SFP module

Electric circuit **sources blocks** can be mapped to the module's **SFP CH00** **input** in the Schematic Editor by selecting the block and assigning the desired **SFP input signal** as the source. All SFP input signals are carried through a **single SFP channel (CH00)**, which provides **32 input signals**. All other SFP channels are disabled in this firmware.

Electric circuit **measurement blocks** can be mapped to the module's **SFP CH00** **output** in the Schematic Editor by selecting the block and assigning the desired **SFP output signal** as the destination. All SFP output signals are carried through a **single SFP channel (CH00)**, which provides **32 output signals**. All other SFP channels are disabled in this firmware.

Mapping **HYPERSIM model signals** to the **SFP module** follows the standard OPAL‑RT board workflow.

{% hint style="danger" %}
Mapping a single electric circuit measurement block to an SFP output signal in Schematic Editor reserves all SFP output signals for eHS, disabling SFP output mapping in the HYPERSIM model.
{% endhint %}


---

# 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/ehs/3.7/first-steps/choose-the-ehs-firmware/introduction-to-standard-ehs-firmware/op4512-and-op46xx/ehsx128-pmsm-im-ioconfig1.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.
