> 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/get-started/run-your-integration-project/import-review-and-prepare-the-model.md).

# Import, Review & Prepare the Model

{% stepper %}
{% step %}

### Download your integration project

Download the HYPERSIM project `.zip` file(s) from the **Test\_models > HYPERSIM** folder on the **CD** or **USB drive** included with your system package.
{% endstep %}

{% step %}

### Import the project in HYPERSIM

1. Open HYPERSIM. Click on the **HYPERSIM** tab. In the ribbon that appears, locate the **Import/Export** category. Click **Project** and select **Import**.

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

2. Navigate to the previously downloaded HYPERSIM project \*.zip file, and select it. You will then be prompted to choose a folder to unzip the project.

{% hint style="info" %}
If a pop‑up warns that the IP address is not defined in the Target Manager and asks to add it automatically, click **No**. If no pop‑up appears, proceed normally.

<img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-0d07101e34aa5c0599c3257f0c5b171d44a7e4f6%2Fimage%20(1189).png?alt=media" alt="" data-size="original">
{% endhint %}
{% endstep %}

{% step %}

### Analyze the model for I/O setup and monitoring

The test model is an excellent resource for understanding how to set up loopback connections. In the model, I/Os are explicitly labeled, making it easier to determine which connections are needed. Here is a simple example:

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

{% step %}

### Connect the DB37 loopback cables

Use the model’s I/O information to make the following loopback connections:

* **AO → AI** (Analog Output to Analog Input)
* **DO → DI** (Digital Output to Digital Input)

Steps:

1. Insert the end of the DB37 loopback cable with the PCB board into the DB37 connector of the desired **Output module** in the simulator.
2. Connect the other end of the DB37 loopback cable to the DB37 connector to the desired **Input** **module** in the simulator to loop back the output signal.
3. Review the documentation of your **Output modules**. For Output I/O modules that require external power, each bank of 16 signals must have its own supply. Power each DB37 loopback cable through its **Vuser** and **Vrtn** pins.
   1. Set the DIP switch on the board to **EXT** (as shown above).
   2. Do **not** set the switch to **INT.12V** unless specifically indicated in the System Description Document.
   3. Connect an external power supply to the **2-pin screw terminal** (refer to the I/O module’s documentation for voltage limits).
      {% endstep %}

{% step %}

### Assign the simulator to the model

1. In the **HYPERSIM** tab, click **Settings**.

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

2. In the **Simulation Settings/General** window, select your simulator in the **Target** field and set the **Simulation mode** to **Real-time**.

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

3. Click **Apply**, then **Close**.
   {% 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/get-started/run-your-integration-project/import-review-and-prepare-the-model.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.
