> 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.md).

# OPAL-RT Board Workflow

HYPERSIM allows the model to interact directly with external hardware or a DUT through the simulator’s I/O modules. This capability makes it possible to test and validate system behavior under realistic conditions, providing a seamless link between the virtual simulation and physical hardware.

{% stepper %}
{% step %}

### Configure the OPAL-RT Board

1. In the **HYPERSIM** tab, click **I/O Interface** in the **Sensors & I/Os** section to open the **I/O Interface Configuration** window.

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

2. Right‑click **OPAL‑RT Board** and select **Add**. Keep the default name or enter a custom one. If multiple **OPAL‑RT Boards** are added, each one must have a unique name.

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

3. Click the newly added **OPAL‑RT Board** in the **I/O Interface Configuration** window to begin configuration.
4. Locate the **OPAL-RT Board Configuration** section in your **System Description Document** and follow the instructions to configure the board accordingly. For details about **OPAL-RT Board Configuration**, see the [OPAL-RT Board Configuration](broken://pages/7CSRTFv32XkJcL5smai3) documentation.
5. Click **Bitstream configuration file** and browse for your bitstream configuration file (`.opal` or `.opbin`), located on the USB drive or CD under: **Test\_models > HYPERSIM**. Before selecting an `.opal` file, ensure that the associated `.bin` file is in the same folder. **Do not rename bitstream files**, as their naming convention is critical for correct operation. Once the bitstream is selected, HYPERSIM will automatically list all available I/O channels and their locations in the unit. All channels are enabled by default. Unused channels output zero during simulation.
6. Select the channels you want to enable, configure settings, and save. For details, see the [Analog & Resolver Configuration](https://www.opal-rt.com/docs/hypersim/configure-ios/analog-digital-and-sfp-ios/opal-rt-board-workflow/analog-and-resolver-configuration.md), the [Digital & Encoder Configuration](https://www.opal-rt.com/docs/hypersim/configure-ios/analog-digital-and-sfp-ios/opal-rt-board-workflow/digital-and-encoder-configuration.md), and [Raw FPGA Data & SFP Configuration](https://www.opal-rt.com/docs/hypersim/configure-ios/analog-digital-and-sfp-ios/opal-rt-board-workflow/raw-fpga-data-and-sfp-configuration.md) documentation.
   {% 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. If the list is empty, the **OPAL‑RT Board** has not been configured in the **I/O Interface**.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-9a9270f58ddc4bb94c21230244b2a02f06783782%2Fimage%20(16).png?alt=media" alt=""><figcaption></figcaption></figure>

3. In the **I/O Selector** window, double‑click the desired I/O channel to connect the sensor. Use the **text field** to quickly filter and locate available connectable points, or use the **dropdown menus** to filter by driver and/or by I/O direction. Only one signal is allowed per I/O connection. If multiple signals are assigned to the same I/O, HYPERSIM will detect the conflict during simulation initialization, raise an error, and prevent the simulation from starting.

If a more explicit and visual representation of I/O connections is preferred, I/O blocks from the [Target Inputs and Outputs](broken://pages/7F50Ym2bMjwzhmhPZ5uX) library can be added directly to the schematic and connected to components. After placing the I/O block, open its **Sensors Form** to complete the I/O connection. In this workflow, the component connects to the I/O block, which is then linked to the **OPAL‑RT Board I/O Interface**. This approach produces the same functional result as a direct sensor‑to‑I/O connection, but makes the I/O mapping more visible and easier to interpret when viewing the schematic alone.
{% endstep %}

{% step %}

### Review the I/O connections

Once a sensor is connected to an I/O channel, the connection type is displayed. For example,\
**OPAL‑RT Board / Slot 1A – Analog Output / Channels 0–7 / 0** indicates that the sensor is connected to the OPAL‑RT Board I/O Interface, to an Analog Output module installed in slot **1A**, using **channel 0** within the **Channels 0–7** subsection.

The **I/O Factor** column is used to scale analog signals to match the voltage range supported by the I/O modules. For output signals, the simulation value is divided by the I/O Factor. For input signals, the value received from the I/O module is multiplied by the I/O Factor.
{% 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 <a href="#id-8runningthesimulation" id="id-8runningthesimulation"></a>

​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.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.
