> 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/communication-protocol-ios/signal-generator/configure-signal-generator.md).

# Configure Signal Generator

When working with communication protocols, it is recommended to begin by configuring the protocol through the **I/O Interfaces** section in <code class="expression">space.vars.Software</code> before proceeding with other steps.

## Configure the Signal Generator I/O interface

{% stepper %}
{% step %}

### Add a new I/O interface

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 **Signal Generator** and select **Add**. Keep the default name or enter a custom one. If multiple **Signal Generator** 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-25718f7fe607169e4325eefa818da5cb413ee7b9%2Fdr-hyp-sg-add.jpg?alt=media" alt="" width="50%"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Configure the general settings

Click the newly added **Signal Generator** in the **I/O Interface Configuration** window and configure the general settings.

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

<table><thead><tr><th width="170">Parameter</th><th>Value (Description)</th></tr></thead><tbody><tr><td><strong>Record driver data</strong></td><td>Select this option to record all inputs/outputs of the signal generator driver.</td></tr><tr><td><strong>Group by type</strong></td><td>Select this option to group recorded data by signal type.</td></tr></tbody></table>

{% hint style="info" %}
The I/O interface must be configured, and valid connections must be defined before the I/O interface can be initialized at simulation start.
{% endhint %}
{% endstep %}

{% step %}

### Manage signals

#### Sawtooth Waves

Click **Sawtooth Waves(x)** and use:

* **+** icon to add channels
* **–** icon to remove channels
* **Arrow** icons to reorder channels

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-53e4a01a87a78db8eab60a3253f16d1021357729%2Fdr-hyp-sg-sawtootwaves.png?alt=media" alt="" width="455"><figcaption></figcaption></figure>

<table><thead><tr><th width="170">Parameter</th><th>Value (Description)</th></tr></thead><tbody><tr><td><strong>Signal Name</strong></td><td>Name of the signal.</td></tr><tr><td><strong>Amplitude</strong></td><td>Amplitude of the signal.</td></tr><tr><td><strong>Frequency (Hz)</strong></td><td>Frequency of the signal in Hertz.</td></tr><tr><td><strong>Offset</strong></td><td></td></tr></tbody></table>

#### Sine Waves

Click **Sine Waves(x)** and use:

* **+** icon to add channels
* **–** icon to remove channels
* **Arrow** icons to reorder channels

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-06646d3cd3a336e78521ff691223586a1adf4e3c%2Fdr-hyp-sg-sinewaves.png?alt=media" alt="" width="455"><figcaption></figcaption></figure>

<table><thead><tr><th width="170">Parameter</th><th>Value (Description)</th></tr></thead><tbody><tr><td><strong>Signal Name</strong></td><td>Name of the signal.</td></tr><tr><td><strong>Amplitude</strong></td><td>Amplitude of the signal.</td></tr><tr><td><strong>Frequency (Hz)</strong></td><td>Frequency of the signal in Hertz.</td></tr><tr><td><strong>Phase (rad.)</strong></td><td>Phase of the signal in radians.</td></tr><tr><td><strong>Offset</strong></td><td></td></tr></tbody></table>

#### Square Waves

Click **Square Waves(x)** and use:

* **+** icon to add channels
* **–** icon to remove channels
* **Arrow** icons to reorder channels

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-5f472d6798c173cf0fe16f9aec678289ba77cff4%2Fdr-hyp-sg-squarewaves.png?alt=media" alt="" width="455"><figcaption></figcaption></figure>

<table><thead><tr><th width="170">Parameter</th><th>Value (Description)</th></tr></thead><tbody><tr><td><strong>Signal Name</strong></td><td>Name of the signal.</td></tr><tr><td><strong>Amplitude</strong></td><td>Amplitude of the signal.</td></tr><tr><td><strong>Frequency (Hz)</strong></td><td>Frequency of the signal in Hertz.</td></tr><tr><td><strong>Offset</strong></td><td></td></tr><tr><td><strong>Duty cycle (%)</strong></td><td>It determines the amount of time the square signal is active.</td></tr></tbody></table>

#### Triangular Waves

Click **Square Waves(x)** and use:

* **+** icon to add channels
* **–** icon to remove channels
* **Arrow** icons to reorder channels

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-851f774c7bd08992b0b4f3d0bf7e443bfb0af213%2Fdr-hyp-sg-triangularwaves.png?alt=media" alt="" width="455"><figcaption></figcaption></figure>

<table><thead><tr><th width="170">Parameter</th><th>Value (Description)</th></tr></thead><tbody><tr><td><strong>Signal Name</strong></td><td>Name of the signal.</td></tr><tr><td><strong>Amplitude</strong></td><td>Amplitude of the signal.</td></tr><tr><td><strong>Frequency (Hz)</strong></td><td>Frequency of the signal in Hertz.</td></tr><tr><td><strong>Offset</strong></td><td></td></tr></tbody></table>
{% endstep %}

{% step %}

### Configure Oprec files

Click **Oprec File(x)** and use:

* **+** icon to add channels
* **–** icon to remove channels
* **Arrow** icons to reorder channels

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

<table><thead><tr><th width="170">Parameter</th><th>Value (Description)</th></tr></thead><tbody><tr><td><strong>Path File</strong></td><td><strong>Absolute path</strong> to your .oprec file. It must be in the same directory as your model.ecf file.</td></tr><tr><td><strong>Repeat mode</strong></td><td>Allows the values defined in the .oprec file to be replayed continuously while the simulation is running.</td></tr></tbody></table>

{% hint style="info" %}
Large recording files can reduce simulation performance and slow down simulation execution.
{% endhint %}
{% endstep %}

{% step %}

### Configure the csv files

Click **CSV File(x)** and use:

* **+** icon to add channels
* **–** icon to remove channels
* **Arrow** icons to reorder channels

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

<table><thead><tr><th width="170">Parameter</th><th>Value (Description)</th></tr></thead><tbody><tr><td><strong>Path File</strong></td><td><p><strong>Absolute path</strong> to your .csv file. It must be in the same directory as your model.ecf file.<br>The only supported separator is the semicolon (;), which is used to separate both header entries and data values.<br>As with most CSV files, the first line corresponds to the header. It contains the simulation timestamp (X-axis) followed by the signal names.<br></p><p>Each subsequent line represents a simulation time step. The first value must be the simulation timestamp, expressed in seconds, followed by the signal values in the same order as defined in the header.</p></td></tr><tr><td><strong>Repeat mode</strong></td><td>Allows the values defined in the .csvc file to be replayed continuously while the simulation is running.</td></tr></tbody></table>

In the example below, the dataset contains two input signals (s1 and s2) and a simulation timestamp. The time values range from 0 to 0.03 s, with a 0.01 s time step.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-01c576bf3a0eae1358c677818144b1adf08afbd8%2Fdr-hyp-sg-csvfiles-example.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

{% endstep %}

{% step %}

### Configure Time Signal

{% endstep %}

{% step %}
Click **Time Signals(x)** and use:
{% endstep %}

{% step %}

* **+** icon to add channels
* **–** icon to remove channels
* **Arrow** icons to reorder channels
  {% endstep %}

{% step %} <img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-8f3932f3c19fbee897ac6417d99796bfcf19b5af%2Fdr-hyp-sg-timesignal.png?alt=media" alt="" data-size="original">
{% endstep %}

{% step %}

### Save the configuration

Click **Ok** or **Apply** to save the configuration.
{% endstep %}
{% endstepper %}

<table><thead><tr><th width="170">Parameter</th><th>Value (Description)</th></tr></thead><tbody><tr><td><strong>Signal Name</strong></td><td>Name of the signal.</td></tr><tr><td><strong>Format</strong></td><td><p>Format of the signal. Only Epoch time is supported.</p><p>Epoch date and time from which system time is measured. Number of seconds elapsed since 00.00.00 January 1st, 1970.<br>On a Linux machine, it can be obtained using the following command: date +%s</p></td></tr></tbody></table>

## Monitor the results in ScopeView

Since **ScopeView** monitors the simulation regardless of where the simulation actually is, the starting value might differ depending on when you click on play in acquisition.


---

# 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/communication-protocol-ios/signal-generator/configure-signal-generator.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.
