> 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/first-steps/choose-the-ehs-firmware/introduction-to-standard-ehs-firmware/op4810-io/ehsx64-gen5-pmsm-ioconfig2.md).

# Machine Drive IOConfig2

## Firmware specifications

<figure><img src="https://3212678799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABuoXNYgvaoO7wIe3bfO%2Fuploads%2Fgit-blob-81235918071e5fd24b172be26fa5097de1ccdcb1%2FOP4810_ehs128_gen5_PMSM_ioconf2.png?alt=media" alt="" width="480"><figcaption></figcaption></figure>

* Compatible with Schematic Editor workflow
* Compatible with XG and XG2 platforms
* Solver eHS x128 Gen5
* 2x PMSM VdQ / BLDC with
  * 1x Resolver and 1x encoder reserved per machine
  * double excitation PMSM resolver
* SFP inter-FPGA link
* FPGA Scope
* Power Measurement (RT-LAB S-Function workflow only)

## FPGA ports mapping table

<details>

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

|    | 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 2A - 0 to 7    |
| 6  |                             | TSDO 5 - eHS 32 to 39        | Digital In 2A - 8 to 15   |
| 7  |                             | TSDO 6 - eHS 40 to 47        | Analog In 2D - 0 to 7     |
| 8  | PWM 2A - 0 to 7             | TSDO 7 - eHS 48 to 55        | Analog In 1D - 0 to 7     |
| 9  | PWM 2A - 8 to 15            | TSDO 8 - eHS 56 to 63        | PMSM VDQ 1/2              |
| 10 |                             | TSDO 9 - eHS 64 to 71        | QEI 0                     |
| 11 |                             | Digital Out 1B - SDO 0 to 7  | QEI 1                     |
| 12 | Config AOMR                 | Digital Out 1B - SDO 8 to 15 | RMS and Power calculation |
| 13 | eHS PWM 1 - eHS 0 to 7      |                              | eHS Period Averaged       |
| 14 | eHS PWM 2 - eHS 8 to 15     |                              | eHS Period DownSample     |
| 15 | eHS PWM 3 - eHS 16 to 23    | Digital Out 2B - SDO 0 to 7  | TimeOn Averaged           |
| 16 | eHS PWM 4 - eHS 24 to 31    | Digital Out 2B - SDO 8 to 15 | TimeOn DownSample         |
| 17 | Config AIR                  |                              |                           |
| 18 | Config PMSM VDQ 1/2         |                              |                           |
| 19 |                             | AOMR/Analog Out 1A 0 to 7    |                           |
| 20 |                             | Analog Out 1A 8 to 15        |                           |
| 21 | Config QEI 0                | Analog Out 1A 16 to 24       |                           |
| 22 | Config QEI 1                | Analog Out 2A 16 to 24       |                           |
| 23 | Config SFP                  | eHS PWM 1 - 0 to 7           |                           |
| 24 | Config LUT                  | eHS PWM 2 - 8 to 15          |                           |
| 25 | Config RMS                  | eHS PWM 3 - 16 to 23         |                           |
| 26 | Config QEO                  | eHS PWM 4 - 24 to 31         |                           |
| 27 |                             | eHS SWG                      |                           |
| 28 |                             | PMSM VDQ 1/2                 |                           |
| 29 |                             |                              |                           |
| 30 |                             | SFP                          |                           |
| 31 |                             | AOMR/Analog Out 2A 0 to 7    |                           |
| 32 |                             | Analog Out 2A 8 to 15        |                           |
| 33 |                             | QEO                          |                           |
| 34 |                             | TSDO 10 - eHS 72 to 79       |                           |
| 35 |                             | TSDO 11 - eHS 80 to 87       |                           |
| 36 |                             | TSDO 12 - eHS 88 to 95       |                           |
| 37 |                             | TSDO 13 - eHS 96 to 103      |                           |
| 38 |                             | TSDO 14 - eHS 104 to 111     |                           |
| 39 |                             | TSDO 15 - eHS 112 to 119     |                           |
| 40 |                             | TSDO 16 - eHS 120 to 127     |                           |
| 41 |                             | TSDO 17 - eHS 128 to 135     |                           |
| 42 |                             | TSDO 18 - eHS 136 to 143     |                           |
| 43 |                             | LUT                          |                           |

</details>

## Supported I/O modules

### IOConfig2

| I/O section | Slot 1                                                                                                                               | Slot 2                                                                                                                               |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Module**  | <p><a href="https://www.opal-rt.com/docs/op48hxx/input-output-modules/op48h20-description">OP48H20</a><br>Fast I/O type H Module</p> | <p><a href="https://www.opal-rt.com/docs/op48hxx/input-output-modules/op48h20-description">OP48H20</a><br>Fast I/O type H Module</p> |
| **P1**      | 16 DI                                                                                                                                | 16 DI                                                                                                                                |
| **P2**      | 16 DO                                                                                                                                | 16 DO                                                                                                                                |
| **P3**      | <p>16 AO 1 MPS,<br>or 8 AO 2 MPS</p>                                                                                                 | <p>16 AO 1 MPS,<br>or 8 AO 2 MPS</p>                                                                                                 |
| **P4**      | <p>8 AI</p><p>8 AO 1 MPS,<br>or 4 AO 2 MPS</p>                                                                                       | <p>8 AI</p><p>8 AO 1 MPS,<br>or 4 AO 2 MPS</p>                                                                                       |

The configuration includes **6 TX and 6 RX RS‑422 digital I/O channels** accessible via **DB9 connectors**. These are mapped to **Slot 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** | OP5145\_1-EX-0001-3\_11\_2\_12-eHSx64\_Gen5\_MachineDrive\_IOConfig2-1B-05 |
| **Board Type**                 | OP48xx                                                                     |

### Slot 1A & 1B and Slot 2A & 2B - Digital inputs/outputs

Refer to [OP48H20 pin assignment](https://www.opal-rt.com/docs/op48hxx/input-output-modules/op48h20-description/db37f-pin-assignment) for hardware connections.

Each **OP48H20** includes a **16‑channel digital input** and **16‑channel digital output** modules.

#### **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 **Slot 1B** or **RS422 Slot 3**. Open the **eHS Build Report** to determine the slot used.

#### Mezzanine Option block configuration

To configure a subsection for digital output on one OP48H10 - Fast I/O type H 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 set the subsection direction to **Output**. When set to Output, the **Voltage** parameter becomes available for that subsection and can be set to **3.3 V** or **5 V**. To configure a subsection for digital input, set the subsection direction to **Input**.

**Mezzanine Option block for slot 1**

| Parameter          | Value          |
| ------------------ | -------------- |
| **Mezzanine type** | OP48H20 - Fast |
| **Chassis slot**   | Slot 1         |

**Mezzanine Option block for slot 2**

| Parameter          | Value          |
| ------------------ | -------------- |
| **Mezzanine type** | OP48H20 - Fast |
| **Chassis slot**   | Slot 2         |

#### 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 |
| -------------------------------------------------------------------------------- | :-----: | :-----: |
| <p><strong>Slot 1 Section A</strong><br><strong>DataOut port number</strong></p> |    3    |    4    |
| <p><strong>Slot 2 Section A</strong><br><strong>DataOut port number</strong></p> |    5    |    6    |

#### 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 |
| ------------------------------------------------------------------------------- | :-----: | :-----: |
| <p><strong>Slot 1 Section B</strong><br><strong>DataIn port number</strong></p> |    11   |    12   |
| <p><strong>Slot 2 Section B</strong><br><strong>DataIn port number</strong></p> |    15   |    16   |

### Slot 1C and Slot 2C - Analog outputs

Refer to [OP48H20 pin assignment](https://www.opal-rt.com/docs/op48hxx/input-output-modules/op48h20-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 | CH16-24 |
| ------------------------------------------------------------------------------- | ------- | ------- | ------- |
| <p><strong>Slot 1 Section C</strong><br><strong>DataIn Port Number</strong></p> | 19      | 20      | 21      |
| <p><strong>Slot 2 Section C</strong><br><strong>DataIn Port Number</strong></p> | 22      | 31      | 32      |

### Slot 1D and Slot 2D - Analog inputs

Refer to [OP48H20 pin assignment](https://www.opal-rt.com/docs/op48hxx/input-output-modules/op48h20-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 |
| -------------------------------------------------------------------------------- | ------- |
| <p><strong>Slot 1 Section D</strong><br><strong>DataOut Port Number</strong></p> | 8       |
| <p><strong>Slot 2 Section D</strong><br><strong>DataOut Port Number</strong></p> | 7       |

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

Refer to [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               | Value |
| ----------------------- | :---: |
| **DataOut Port Number** |   10  |

#### 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 **Slot 1A** or **RS422 I/O Slot 3**. 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** |   33  |

### SFP module

#### Schematic Editor SFP configuration

Electric circuit **sources blocks** can be mapped to the module's **SFP CH04** **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 (CH04)**, 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 CH04** **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 (CH04)**, 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** | 30       |

### Power measurement

To get RMS and power calculation from the eHS electric circuit, the [**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**  | 23    |
| **DataOut Port Number** | 30    |

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

### OPAL-RT Board configuration

| Parameter                            | Value                                                                          |
| ------------------------------------ | ------------------------------------------------------------------------------ |
| **Chassis type**                     | OP48xx                                                                         |
| **Bitstream configuration location** | Standard repositories                                                          |
| **Bitstream configuration file**     | OP5145\_1-EX-0001-3\_11\_2\_12-eHSx64\_Gen5\_MachineDrive\_IOConfig2-1B-05.pdi |

### Slot 1A & 1B and Slot 2A & 2B - Digital inputs/outputs

Refer to [OP48H20 pin assignment](https://www.opal-rt.com/docs/op48hxx/input-output-modules/op48h20-description/db37f-pin-assignment) for hardware connections.

Each **OP48H20** includes a **16‑channel digital input** and **16‑channel digital output** modules.

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 **Slot 1B** or **RS422 Slot 3**. 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.

### Slot 1C and Slot 2C- Analog outputs

Refer to [OP48H20 pin assignment](https://www.opal-rt.com/docs/op48hxx/input-output-modules/op48h20-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 %}

### Slot 1D and Slot 2D- Analog inputs

Refer to [OP48H20 pin assignment](https://www.opal-rt.com/docs/op48hxx/input-output-modules/op48h20-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.

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

Refer to [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

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 **Slot 1B** or **RS422 Slot 3**. 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 CH04** **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 (CH04)**, 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 CH04** **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 (CH04)**, 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/first-steps/choose-the-ehs-firmware/introduction-to-standard-ehs-firmware/op4810-io/ehsx64-gen5-pmsm-ioconfig2.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.
