> 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/pe-add-on-opal-rt/system-definition-configuration/configure-the-circuit-model.md).

# Configure the Circuit Model

## Overview

In the **System Explorer** window configuration tree, expand the **Power Electronics Add-On** custom device and select a **Circuit** section to display this page to add an electrical model to the VeriStand System Definition. When the VeriStand project is deployed, the circuit model is simulated on the FPGA through the **eHS Solver**.

## Parameters

<figure><img src="https://1300141755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCyfrFRdgX5VC5iwM13Zm%2Fuploads%2FqDvYUzdBRPDJk7wqp04z%2Fimage.png?alt=media&amp;token=dcb4914a-b7a6-4b63-85c7-f8626dd6dbe3" alt="" width="563"><figcaption></figcaption></figure>

### Circuit

<table><thead><tr><th width="220">Parameter / Button</th><th>Description</th></tr></thead><tbody><tr><td><strong>Name</strong></td><td>Specifies the name of the circuit model.</td></tr><tr><td><strong>Description</strong></td><td>Specifies a description for the circuit model.</td></tr><tr><td><strong>Target Name</strong></td><td>Specified the <em>Name</em> of the FPGA target onto which the circuit model will be deployed and simulate.</td></tr><tr><td><strong>Circuit File Path</strong></td><td>Specifies the path to the circuit model file (.ehs3) on disk. When a file path is added, the circuit file is parsed and VeriStand channels are created corresponding to the <a href="https://www.opal-rt.com/docs/pe-add-on-opal-rt/system-definition-configuration/configure-the-circuit-model/sources.md"><strong>Source</strong></a>, <a href="https://www.opal-rt.com/docs/pe-add-on-opal-rt/system-definition-configuration/configure-the-circuit-model/gates.md"><strong>Gate</strong></a>, and <a href="https://www.opal-rt.com/docs/pe-add-on-opal-rt/system-definition-configuration/configure-the-circuit-model/measurements.md"><strong>Measurement</strong></a> components defined in the circuit model. Component configuration settings are set to their default states. Other components such as <a href="https://www.opal-rt.com/docs/pe-add-on-opal-rt/system-definition-configuration/configure-the-circuit-model/pwm-generators.md"><strong>PWM Generators</strong></a>, <a href="https://www.opal-rt.com/docs/pe-add-on-opal-rt/system-definition-configuration/configure-the-circuit-model/waveforms.md"><strong>Waveforms</strong></a>, etc may also be added to the system definition tree based on features available in the firmware.</td></tr><tr><td><strong>Create New Circuit</strong></td><td>Prompts the selection of a file path to create a new circuit model on disk. The circuit model is also opened in the Schematic Editor for editing.</td></tr><tr><td><strong>Edit</strong></td><td>Opens in the circuit model at the specified <em>Circuit File Path</em> in the Schematic Editor for editing.</td></tr><tr><td><strong>Reload</strong></td><td>Parses the currently specified circuit model and updates the VeriStand channels. Components whose names have not changed retain their previously configured settings, while new or modified components are reset to the default state. Components that are no longer part of the model are removed.</td></tr><tr><td><strong>Clear</strong></td><td>Removes the currently loaded circuit model. When a circuit model is cleared, the corresponding <strong>Source</strong>, <strong>Gate</strong>, and <strong>Measurement</strong> sections (and any other sections below the Circuit page) are deleted from the Configuration Tree and all related mapping configuration settings are removed.</td></tr><tr><td><strong>Last Updated</strong></td><td>Specifies the date and time when the currently specified circuit model was updated last</td></tr></tbody></table>

### Additional information

<table><thead><tr><th width="220">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Applied Timestep (s)</strong></td><td>Specifies the execution timestep of the circuit model.</td></tr><tr><td><strong>Minimum Timestep (s)</strong></td><td>Displays the smallest timestep at which the eHS Solver can simulate the circuit model.</td></tr><tr><td><strong>Maximum Timestep (s)</strong></td><td>Displays the largest timestep at which the eHS Solver can simulate the circuit model.</td></tr></tbody></table>

The **JMAG‑ANSYS File Converter**, accessible from the ribbon or by right‑clicking the circuit section, opens a dialog window. From there, browse to a .rtt (JMAG) or .txt (ANSYS) file and convert it into a .pmsmsh file to import the machine configuration into the Schematic Editor.

## Circuit Section Channels

<table><thead><tr><th width="150" valign="top">Channel Name</th><th width="145" valign="top">Type - Default Value</th><th>Description</th></tr></thead><tbody><tr><td valign="top"><strong>Parameter Set</strong></td><td valign="top">Input<br>Default Value: 0</td><td><p>Specifies the index of the parameter set to be simulated. Modify the value of this channel at run-time to switch between parameter sets.</p><p>This channel is only available when <strong>Parameter Sets</strong> are configured in the circuit model.</p></td></tr><tr><td valign="top"><strong>Reset</strong></td><td valign="top">Input<br>Default Value: 0</td><td><p>This channel resets in the circuit simulation.</p><p>Set this channel to one of the following values:</p><ul><li><strong>0</strong> - Circuit model will execute as configured</li><li><strong>1</strong> - Circuit model will be set into a Reset mode until the <strong>Reset</strong> channel is set back to 0.</li></ul><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Circuits in Reset mode do not react to inputs, and their outputs should not be considered as valid. Please refer to the <strong>Reset Model Behavior</strong> section for more information.</p></div><p>This channel is only available when <em>Reset Pin</em> in the <em>Solver Setting</em> of the circuit is enabled.</p></td></tr></tbody></table>


---

# 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/pe-add-on-opal-rt/system-definition-configuration/configure-the-circuit-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.
