> 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/op4815-io/ehsx128-gen5-fd-line-imwithsat-ioconfig1.md).

# Power Systems 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-23d4e4ba6ec49e0ff6954484b0879aaaeb8baccf%2FOP4815_eHS128_gen5_PMSM_ioconf1.png?alt=media" alt="" width="480"><figcaption></figcaption></figure>

* Compatible with Schematic Editor workflow
* Compatible with XG and XG2 platforms
* Solver eHS x128 Gen5
* 4x Induction Machine SCIM/DFIM **with saturation** with
  * 1x Resolver and 1x encoder reserved per machine
  * double excitation PMSM resolver
* Frequency Depemdant Line and Constant Parameter Line
* 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  | Fd Line                                     | TSDO 2 - eHS 8 to 15                        | Digital In 1 - 0 to 7                |
| 4  | PWM 1 - 0 to 7                              | TSDO 3 - eHS 16 to 23                       | Digital In 1 - 8 to 15               |
| 5  | PWM 1 - 8 to 15                             | TSDO 4 - eHS 24 to 31                       | Digital In 1 - 16 to 23              |
| 6  | PWM 1 - 16 to 23                            | TSDO 5 - eHS 32 to 39                       | Digital In 1 - 24 to 31              |
| 7  | PWM 1 - 24 to 31                            | TSDO 6 - eHS 40 to 47                       | Digital In 2 - 0 to 7                |
| 8  | PWM 2 - 0 to 7                              | TSDO 7 - eHS 48 to 55                       | Digital In 2 - 8 to 15               |
| 9  | PWM 2 - 8 to 15                             | TSDO 8 - eHS 56 to 63                       | Digital In 2 - 16 to 23              |
| 10 | PWM 2 - 16 to 23                            | TSDO 9 - eHS 64 to 71                       | Digital In 2 - 24 to 31              |
| 11 | PWM 2 - 24 to 31                            | Digital Out 1 - SDO 0 to 7                  | Analog In 1 - 0 to 7                 |
| 12 | Config AOMR                                 | Digital Out 1 - SDO 8 to 15                 | Analog In 1 - 8 to 15                |
| 13 | eHS PWM 1 - eHS 0 to 7                      | Digital Out 1 - SDO 16 to 23                | Quad Generic Machine with Saturation |
| 14 | eHS PWM 2 - eHS 8 to 15                     | Digital Out 1 - SDO 24 to 31                | Quadrature Encoder 0                 |
| 15 | eHS PWM 3 - eHS 16 to 23                    | Digital Out 2 - SDO 0 to 7                  | Quadrature Encoder 1                 |
| 16 | eHS PWM 4 - eHS 24 to 31                    | Digital Out 2 - SDO 8 to 15                 | Quadrature Encoder 2                 |
| 17 | Config AIR                                  | Digital Out 2 - SDO 16 to 23                | Quadrature Encoder 3                 |
| 18 | Config Quad Generic Machine with Saturation | Digital Out 2 - SDO 24 to 31                | Analog In 2 - 0 to 7                 |
| 19 |                                             | AOMR/Analog Out 1 - 0 to 7                  | Analog In 2 - 8 to 15                |
| 20 |                                             | Analog Out 1 - 8 to 15                      | eHS Period Averaged                  |
| 21 |                                             | Analog Out 2 - 0 to 7                       | eHS Period DownSample                |
| 22 | Config SFP                                  | Analog Out 2 - 8 to 15                      | TimeOn Averaged                      |
| 23 | Config Lookup Table                         | eHS PWM 1 - 0 to 7                          | TimeOn DownSample                    |
| 24 | RMS and Power Calculation                   | eHS PWM 2 - 8 to 15                         | RMS and Power Calculation            |
| 25 | Config Quadrature Encoder                   | eHS PWM 3 - 16 to 23                        |                                      |
| 26 | Config AOMR                                 | eHS PWM 4 - 24 to 31                        |                                      |
| 27 |                                             | eHS SWG                                     |                                      |
| 28 | QEI0 config                                 |                                             |                                      |
| 29 | QEI1 config                                 |                                             |                                      |
| 30 | QEI2 config                                 | Config Quad Generic Machine with Saturation |                                      |
| 31 | QEI3 config                                 | AOMR 2 - 0 to 7                             |                                      |
| 32 |                                             | Quadrature Encoder                          |                                      |
| 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

### IOConfig1

| I/O section | Slot 1                                                                                                                               | Slot 2                                                                                                                               |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Module**  | <p><a href="https://www.opal-rt.com/docs/op48hxx/input-output-modules/op48h10-description">OP48H10</a><br>Fast I/O type H Module</p> | <p><a href="https://www.opal-rt.com/docs/op48hxx/input-output-modules/op48h10-description">OP48H10</a><br>Fast I/O type H Module</p> |
| **P1**      | 16 DIO                                                                                                                               | 32 DIO                                                                                                                               |
| **P2**      | 16 DIO                                                                                                                               | 32 DIO                                                                                                                               |
| **P3**      | 16 AO                                                                                                                                | 16 AO                                                                                                                                |
| **P4**      | 16 AI                                                                                                                                | 16 AI - N/A in eHS                                                                                                                   |

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\_2-EX-0001-3\_12\_5\_19-eHSx128\_PowerSystems\_FDLine\_IOConfig1-2A-08 |
| **Board Type**                 | OP48xx                                                                        |

### Slot 1 and Slot 2 - Digital inputs/outputs

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

Each **OP48H10** includes a **32‑channel digital I/O** module divided into four **8‑channel subsections**, each of which can be independently configured as either a digital input or a digital output.

#### **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 2B** 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** | OP48H10 - Fast |
| **Chassis slot**   | Slot 1         |

**Mezzanine Option block for slot 2**

| Parameter          | Value          |
| ------------------ | -------------- |
| **Mezzanine type** | OP48H10 - 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 | CH16-23 | CH24-31 |
| -------------------------------------------------------------------------------- | :-----: | :-----: | :-----: | :-----: |
| <p><strong>Slot 1 Section A</strong><br><strong>DataOut port number</strong></p> |    3    |    4    |    5    |    6    |
| <p><strong>Slot 2 Section A</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>Slot 1 Section A</strong><br><strong>DataIn port number</strong></p> |    11   |    12   |    13   |    14   |
| <p><strong>Slot 2 Section A</strong><br><strong>DataIn port number</strong></p> |    15   |    16   |    17   |    18   |

### Slot 1 and Slot 2- Analog outputs

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

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

Refer to [OP48H10 pin assignment](https://www.opal-rt.com/docs/op48hxx/input-output-modules/op48h10-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 |
| -------------------------------------------------------------------------------- | ------- | ------- |
| <p><strong>Slot 1 Section C</strong><br><strong>DataOut Port Number</strong></p> | 11      | 12      |
| <p><strong>Slot 2 Section C</strong><br><strong>DataOut Port Number</strong></p> | 18      | 19      |

### 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** |   17  |

#### 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 2B** 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** |   30  |

### 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 CH04output** 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 CH04 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 CH04 |
| ---------------------- | -------- |
| **DataIn Port Number** | 42       |

### 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 |
| ------------------------ | ----- |
| **Load In Port Number**  | 24    |
| **Data Out Port Number** | 24    |

## 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\_2-EX-0001-3\_12\_5\_19-eHSx128\_PowerSystems\_FDLine\_IOConfig1-2A-08.pdi |

### Slot 1 and Slot 2 - Digital inputs/outputs

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

Each **OP48H10** includes a **32‑channel digital I/O** module divided into four **8‑channel subsections**, each of which can be independently configured as either a digital input or a 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 **Slot 2B** 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 1 and Slot 2 - Analog outputs

Refer to [OP48H10 pin assignment](https://www.opal-rt.com/docs/op48hxx/input-output-modules/op48h10-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 1C and Slot 2C - Analog inputs

Refer to [OP48H10 pin assignment](https://www.opal-rt.com/docs/op48hxx/input-output-modules/op48h10-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 2B** 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/3.7/first-steps/choose-the-ehs-firmware/introduction-to-standard-ehs-firmware/op4815-io/ehsx128-gen5-fd-line-imwithsat-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.
