> 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/hypersim/configure-ios/analog-digital-and-sfp-ios/opal-rt-board-workflow/multi-fpga-model-ios.md).

# Multi-FPGA Model I/Os

When a model includes electrical I/O distributed across multiple FPGAs (e.g. one simulator with one expansion unit), the configuration process is similar to the standard **OPAL-RT Board Workflow**. The key difference is that **each additional unit** must have its own **OPAL-RT Board** configuration in <code class="expression">space.vars.Software</code>. This workflow is mandatory when using one or more I/O expansion units connected via **MuSE**, and supported when connected via **PCIe**.

{% stepper %}
{% step %}

### Configure the OPAL-RT Board for the simulator

1. In the **HYPERSIM** tab, click **I/O Interface** in the **Sensors & I/Os** section to open the **I/O Interface Configuration** window. Right‑click **OPAL‑RT Board** and select **Add**. Click the newly added **OPAL‑RT Board** in the **I/O Interface Configuration** window to begin configuration.
2. Locate the **OPAL-RT Board Configuration section** in your **System Description Document** and follow the instructions to configure the interface accordingly.
3. Click **Bitstream configuration file** and browse for your bitstream configuration file (`.opal` or `.opbin`).
4. Select the channels you want to enable, configure settings, and save.
   {% endstep %}

{% step %}

### Configure the OPAL-RT Board for additional units (MuSE)

In a MuSE setup, the simulator acts as the **central** unit and the expansion units as **remotes.** The simulator must be configured with a **central** bitstream, identified by ‘**EX**’ in the name after the FPGA board (e.g., `TE0741_4-`**`EX`**`-0001-3_3_2_804-16Aio_32sDio-27-03`).

When you select a **central** bitstream in the simulator’s **OPAL-RT Board** configuration, a new folder called **Remote Boards Configuration** appears. Click this folder to add, remove, or rename remote units, and use the arrows to adjust their order.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-aa8afe9cd9ec034b0c18ebb31d597a5ec7c90267%2FDR-hyp-muse.png?alt=media" alt=""><figcaption></figcaption></figure>

Click a unit to configure its **OPAL-RT Board**. Remote units must be configured with a **remote** bitstream, identified by ‘**MX**’ in the name after the FPGA board (e.g., `TE0741_4-`**`MX`**`-0001-3_3_2_804-16Aio_32sDio-03-28`). Select the channels you want to enable, configure settings, and save. Repeat for each additional remote unit.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-7d796d629ff0fa46813ef49269c61ce53018fcbe%2FDR-hyp-muse-remote.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Configure the OPAL-RT Board for additional units (PCIe)

In a PCIe setup, each additional unit requires its own distinct **OPAL-RT Board** configuration. For each unit, rright‑click **OPAL‑RT Board** and select **Add**. By default, the **I/O interface name** is **OPAL-RT Board**, but you must rename it because all interfaces require unique names. You may also choose to rename the simulator’s OPAL-RT Board interface if needed.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-23dad764459d6adcd397993e9d3fb4c48c1b0e03%2FDR-hyp-expansion-pcie.png?alt=media" alt=""><figcaption></figcaption></figure>

Select the new interface to start configuration.

In the **simulator**’s OPAL-RT Board configuration, the **Use external synchronization source** box is **unchecked**. In this mode, the FPGA provides the clock to the CPU and outputs a synchronization pulse through the unit’s TX connector.\
For **expansion units**, the **Use external synchronization source** box must be **checked**, meaning the FPGA expects a synchronization pulse.

Finally, select the channels to enable, adjust settings, and save. Repeat for each additional unit.
{% endstep %}

{% step %}

### Connect Sensors to OPAL-RT Board

1. Either right‑click a component and select **Open Sensors Form** to configure its sensors and I/O connections, or click **Sensor Summary** in the **Sensors & I/Os** section of the **HYPERSIM** tab to configure I/O connections for multiple components with previously activated sensors at once.
2. Click the **Edit** **I/O connection** icon for the desired sensor to open the **I/O Selector** window.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-6aacd6b15010752f63da975c4e405364db23990b%2FDR-hyp-opalboard-multi-fpga.png?alt=media" alt=""><figcaption></figcaption></figure>

3. In the **I/O Selector** window, all I/O channels associated with the simulator and any expansion units configured through the OPAL‑RT Board I/O Interface are listed and available for connection. To assign a channel to the sensor, simply locate the desired I/O in the list and double‑click it.
   {% endstep %}

{% step %}

### Prepare the Hardware setup

Refer to the **Connect Analog & Digital I/Os** section of your simulator and/or expansion unit documentation for detailed instructions on connecting external hardware or a DUT through its I/O modules.
{% endstep %}

{% step %}

### Start the simulation

​In the **HYPERSIM** tab, click **Start**. Once the simulation is running, the **Start** button becomes grayed out, and the **Stop** button becomes active, allowing you to halt execution if required.
{% endstep %}
{% endstepper %}


---

# 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/hypersim/configure-ios/analog-digital-and-sfp-ios/opal-rt-board-workflow/multi-fpga-model-ios.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.
