> 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/ehs/first-steps/integrate-ehs-into-rt-lab-and-hypersim-models/prepare-an-rt-lab-model/export-and-use-a-protected-ehs-block.md).

# Export & Use a Protected eHS Block

The feature builds a **standalone Protected Block** from an eHS Schematic Editor circuit. The resulting block:

* Contains all configuration information needed to run the simulation
* **Hides** the circuit topology, component parameters, and all sensitive design information
* Behaves identically to the original eHS block at runtime
* **Does not require** the OPAL-RT Schematic Editor to be installed on the end-user's machine
* Enables sharing models while protecting sensitive intellectual property

This is ideal for distributing models to customers, partners, or other teams who need to run the simulation but shouldn't have access to the circuit design.

## Export to protected model

Right-click the **eHS\_SE\_SFunction\_Drivers** block and select **eHS > Advanced Features > Export to protected model**.

The protected block is created in the current model. The model can then be shared with other users, who can run the simulation without requiring access to the original Schematic Editor circuit.

Upon export, the circuit is loaded for **all defined Simulator Setups** in the Schematic Editor. All resulting configuration files are saved inside the Protected Block at that moment. Additional details remain accessible through the **Build Report**.

## Use an eHS protected block <a href="#method-2-via-matlab-script-automation-oriented" id="method-2-via-matlab-script-automation-oriented"></a>

The eHS Protected block includes an embedded user interface with the following features:

* **Setup selection**\
  A Protected block can contain multiple **Simulator Setups** (hardware and firmware configurations). Users can select the setup to use for the simulation. The creator of the Protected block is responsible for providing meaningful descriptions for each setup.
* **Build Report tab**\
  Displays the **eHS Build Report** for the selected setup, including I/O mappings, firmware information, solver configuration, and other generated details. Since the original Schematic Editor circuit is not accessible, the **eHS Build Report** is the primary source of information for understanding the model configuration and available I/O.

<figure><img src="https://3212678799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FABuoXNYgvaoO7wIe3bfO%2Fuploads%2Fgit-blob-4d2834e4a4daf1badddf2d3c5101ea78ecd051d7%2Fehs-protected-block.png?alt=media" alt=""><figcaption></figcaption></figure>

## Limitations <a href="#limitations" id="limitations"></a>

| Characteristic                          | Details                                                                                                                                                                                                             |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Version compatibility**               | An eHS Protected block can only be used with the same eFPGASIM/eHS major and minor version used to generate it. The patch version of the runtime environment must be equal to or newer than the generation version. |
| **Regeneration required after upgrade** | Upgrading eFPGASIM/eHS requires re-exporting the Protected block.                                                                                                                                                   |
| **No circuit access**                   | The original circuit and its parameters cannot be viewed or modified.                                                                                                                                               |
| **Fixed configuration**                 | The Protected block uses the configuration captured at export time. Any circuit or setup change requires re-exporting.                                                                                              |


---

# 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/ehs/first-steps/integrate-ehs-into-rt-lab-and-hypersim-models/prepare-an-rt-lab-model/export-and-use-a-protected-ehs-block.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.
