> 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-simulink/hardware-configurations-reference/hardware-configuration-manager.md).

# Hardware Configuration Manager

The Hardware Configuration Manager (HCM) is a tool used to edit, build, and distribute **Hardware Configurations**. It can be accessed from the main page of the CMDE Add-On via the **Launch HCM** toolbar button shown below.

<figure><img src="https://2999842053-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe9Kk9pJCHht2LLBSxPap%2Fuploads%2FKgARluk97f6pqkEjluzN%2Fimage.png?alt=media&amp;token=6e0a8827-b9fe-46f2-8550-c2a3136b2c9c" alt=""><figcaption></figcaption></figure>

## Parameters and buttons

<figure><img src="https://2999842053-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe9Kk9pJCHht2LLBSxPap%2Fuploads%2FfxqcVA8nWhbt0RLcPVm5%2Fimage.png?alt=media&amp;token=060f5162-a53c-4c2d-aef3-f3c47529bddd" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="201.55560302734375">Parameter / Button</th><th>Description</th></tr></thead><tbody><tr><td><strong>Installed Hardware Configurations Table</strong></td><td>Lists the hardware configurations currently installed to the host machine and available for use by the user. By clicking on the hardware configuration, the description of the selected configuration is made available below the table.</td></tr><tr><td><strong>Import...</strong></td><td>Imports a hardware configuration file (.opbitx) and installs it to the host computer.</td></tr><tr><td><strong>Export...</strong></td><td>Exports the selected hardware configuration file to a .opbitx file.</td></tr><tr><td><strong>Delete</strong></td><td>Deletes the selected hardware configuration. This operation is permanent.</td></tr><tr><td><strong>>></strong></td><td>Adds the bitfiles of an installed hardware configuration to the Selected Bitfiles table, allowing the user to build a new Custom Hardware Configuration from an existing one.</td></tr><tr><td><strong>&#x3C;&#x3C;</strong></td><td>Removes the bitfiles of the last selected hardware configuration from the Selected Bitfiles table.</td></tr><tr><td><strong>Selected Bitfiles Table</strong></td><td>Lists the bitfiles that have been selected to build a new hardware configuration and the targets they will be assigned to. The target names are automatically assigned and cannot be modified.</td></tr><tr><td><strong>New Hardware Configuration Name</strong></td><td>The name of the new Custom Hardware Configuration that will be created when clicking on the <strong>Create New Hardware Configuration</strong> button. This will be the name visible to the user in the Installed Hardware Configurations table and drop-down on the Main Page of the Power Electronics Add-On.</td></tr><tr><td><strong>New Hardware Configuration Description</strong></td><td>The description of the new Custom Hardware Configuration that will be created when clicking on the <strong>Create New Hardware Configuration</strong> button. This description will be visible to the user in the Installed Hardware Configurations table and on the Main Page of the Power Electronics Add-On.</td></tr><tr><td><strong>Create New Hardware Configuration</strong></td><td>Creates a new Custom Hardware Configuration using the selected bitfiles, the <strong>New Hardware Configuration Name</strong>, and the <strong>New Hardware Configuration Description</strong>. Clicking this button will generate a new entry in the <strong>Installed Hardware Configurations Table</strong> and will populate a new entry in the Configurations drop-down on the Main Page of the Power Electronics Add-On.</td></tr></tbody></table>

## Duplicate an existing hardware configuration

For example, consider a case where a user would like to simulate four independent PMSM motors on two different PXIe-7868Rs. To achieve this, we can create a new hardware configuration by duplicating an existing one containing a Dual PMSM machine model on one PXIe-7868R, e.g. the **eHSx32\_Dual\_PMSM\_VDQ\_IO\_32DO\_7868R**. This will allow the simulation of double the resources on two separate PXIe-7868R FPGA targets.

<figure><img src="https://2999842053-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe9Kk9pJCHht2LLBSxPap%2Fuploads%2FaqcVSWaMLcMPtaon4wuP%2Fimage.png?alt=media&amp;token=748ee105-a6ba-4f94-900e-1a86857567a4" alt=""><figcaption></figcaption></figure>

In the HCM interface,

* Select the **eHSx32\_Dual\_PMSM\_VDQ\_IO\_32DO\_7868R** configuration from the Installed Configurations list.
* Click the **>>** button twice to populate the Selected Bitfiles list with the duplicate configuration. Note that this process also auto-assigns the FPGA Identifier.
* Enter a **New Hardware Configuration Name** and **Description** into the provided text boxes, and then click **Create New Hardware Configuration**.

The newly created Hardware Configuration will now be available for selection on the Power Electronics Add-On Main Page drop-down.

<figure><img src="https://2999842053-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe9Kk9pJCHht2LLBSxPap%2Fuploads%2Fjcvssv3bJ2YAtbfkKlr7%2FHCM.gif?alt=media&amp;token=e39a97f0-502b-4628-9fda-567fde632d95" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
To optimize the performance of a custom, multi-FPGA hardware configuration, consider contacting OPAL-RT Support for assistance configuring the Processor Assignments in the VeriStand project.
{% endhint %}

## Distribute an hardware configuration

Custom hardware configurations can be exported and reimported for distribution to other systems with VeriStand and the Power Electronics Add-On installed.

{% hint style="info" %}
**Supported Hardware Configurations** do not need to be distributed manually, as they are installed with the Power Electronics Add-On by default.
{% endhint %}

In the HCM interface,

* In the **Installed Hardware Configurations Table**, select the **Custom Hardware Configuration** you wish to distribute
* Click the **Export** button and specify where to save the hardware configuration. It will be exported as a file with the extension *.opbitx*.
* Transfer the *.opbitx* file to the second PC
* Open the **Hardware Configuration Manager** from the second PC
* Click **Import** and select the *.opbitx* file

{% hint style="info" %}
**Custom hardware configurations** support backwards compatibility.

Internally, the Hardware Configuration Manager identifies the base hardware configurations used to generate the custom hardware configuration, and regenerates it using the latest versions of those base hardware configurations in order to make it compatible with the Power Electronics Add-On version installed.
{% endhint %}


---

# 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-simulink/hardware-configurations-reference/hardware-configuration-manager.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.
