> 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/readme/release-notes-2026.md).

# Release Notes 2026

## Version: 2026.3

### New features

* Added Python API commands to draw graphics in an HYPERSIM model
* Added 4 new WECC blocks in the WECC Generic Renewable Energy : WTGT\_A, WTGA\_A,WTGP\_A, WTGQ\_A
* **ePHASORSIM Modelica Library**: Added single-machine wrappers for: GENROU, GENROE, GENSAL, GENSAE, GENCLS.
* **ePHASORSIM Modelica Library**: Added single-controller wrappers: 37 excitation systems, 20 turbine governors, 9 power system stabilizers as single-controller FMU wrappers.
* **CAN**: Added support for the non-ISO FD feature

### Improvements

* Improved the Smart Inverter Library GFM components by adding support of initialization
* Improved Python API Commands:
  * addDevice by adding an orientation option
  * setProperty to function even with HYPERSIM not running
  * exportToFile command to allow for the same parameters as available in the UI
* Improved importUCM API
* Improved UI scaling and transition when moving windows between multiple monitors with different configurations
* Improved UCM generation by reporting writes to calculated parameters before compilation
* Improved installer License Agreement
* Improved model logging by adding color logging
* **Dashboard**: Minimum window size updated to 640 × 480 pixels. The recommended minimum size for an optimal user experience remains 960 × 720 pixels.
* **Third-Party Model Import**: Improved import time of unsupported components leading to hours of time saved on large models.
* **ePHASORSIM**: Improved the HYPERSIM integration example IEEE 9-Bus Phasor System with EMT Feeder
* **ePHASORSIM**: Improved the co-simulation documentation available at Co-simulation of Phasor and EMT systems in HYPERSIM
* **ePHASORSIM**: Improved ePHASORSIM Interface block creation time by \~40% for large models (10k buses)
* **ePHASORSIM**: Improved islanding error message which now correctly identifies unenergized islands instead of a generic failure.
* **Modelica**: Fixed a crash for unenergized islands where previously, a model with an isolated island (no slack bus, no machine) would crash silently during the solve phase. Now, the validation step detects and reports unenergized islands before solving, providing a clear error message identifying the affected buses.
* **Modelica**: Improved Constant Impedance Load performance by decreasing computation time by \~40%.
* **Modelica**: Improved error handling on empty Pins sheet in an Excel Template which now raises a clear error message.
* **OPAL-RT Board**: Improved various aspects of the OP4810-IO, OP4815-IO and OP4300-IO FPGA programming utility:
  * Added support for uppercase file extensions
  * Improved error message to mention next steps in case the programming fails
  * Improved exit message

### Bug fixes

* Fixed UCM previously inability to update when the source path was equal to the reference
* Fixed UCM Builder to include sections 8.4, 8.5, 8.6, 9.7, 9.8 and 9.9 in the UI
* Fixed the possibility to enter an invalid time frame value in the DataLogger configuration
* Fixed device context menus not working appropriately if their subcircuit was opened from “Locate” events, such as the one in the Netlist view \*Fixed a bug where clearing sensors on a target I/O interface input incorrectly deleted the existing connection
* Fixed inconsistent results between simulations with different timesteps \*
* Fixed an issue where it was no longer possible to change the time length of displayed data within ScopeView
* Fixed an example datalogger python API script still written in Python 2 format
* Fixed a missing exception when ScopeView getSignal Python API fails to find the required signal
* Fixed a rare “OutOfBoundsException” happening when requesting the machine\_id of a target in the target manager
* Fixed an issue caused by invalid transmission line parameters (2 lines with the same geometrical data) by adding validation safeguards in HYPERSIM
* Fixed a timeout when CIGRE block initialization takes more than 2 seconds. Now internal timeout is adjusted based on the Start/Stop timeout.
* **Dashboard**: Fixed an issue with the Graph Widget not appearing when inside a Tabs Widget when alternating tabs.
* **Third-Party Model Import**: Fixed numerical oscillations when imported UCM parameters are modified during simulation.
* **Third-Party Model Import PSCAD**: Fixed crashes when importing receiver radiolink without emitters (eg. case mismatch Vpv/VPv)
* **Third-Party Model Import PSCAD**: Fixed to connect to 0ph bus which are not tried anymore
* **Third-Party Model Import PowerFactory**: Fixed load-flow mismatches due to Shunt tap position parameter misconfiguration.
* **Modelica**: Fixed a crash for unenergized islands where previously, a model with an isolated island (no slack bus, no machine) would crash silently during the solve phase. Now, the validation step detects and reports unenergized islands before solving, providing a clear error message identifying the affected buses.
* **MODBUS Slave**: Fixed the byte ordering of 32-bit values to match the one chosen in the configuration
* **OPAL-RT Board**: Fixed the filter used when choosing a bitstream file for the OP4810-IO and OP4815-IO platforms
* **OPAL-RT Board**: Fixed IP address validation when configuring OP4810-IO and OP4815-IO platforms
* **OPAL-RT Board**: Upgraded example projects for OP4810-IO and OP4815-IO platforms to use bitstreams generated with RT-XSG 3.12.5

### Breaking changes

* Removed IEC61850 SAS Example Model
* **PowerFactory**: A warning is displayed when importing models from PowerFactory versions prior to 21. Import still works but new features target PF21+.

### Known issues

N/A

***

## Version: 2026.2

### New features

* Added new API endpoints to support adding multiple devices or connections in a single call:
  * HyWorksApi Commands: HyWorksApiCommands batchAddDevices(devices, interrupt\_on\_error=False)
  * HyWorksApi Commands: HyWorksApiCommands batchConnectDevices(connections, interrupt\_on\_error=False)
* Added new API function HyWorksApi Commands: HyWorksApiCommands getDevicePins(deviceName) to retrieve the pins of a CIGRE block.
* New blocks Smart Inverter: WECC Generic Renewable Energy, REEC\_A, REPC\_A, REGC\_B, REEC\_C, Generic PV Plant,WECC Grid-Forming Inverter, REGFM\_A1, REGFM\_B1
* New Example: Generic WECC IBR: Grid-Following PV Plant
* **ePHASORSIM**: Added the ability to modify the underlying netlist and assets (FMUs) of an existing ePHASORSIM block
* **OPAL\_RT Board**: Added Versal Selected Edition (SE) support

### Improvements

* Improved Examples: FPGA-Based Active Power Filter
* Improved datalogger performance when recording a new frame
* Improved Sequencer
* Improved options when adding a device to include, orientation and layout customization
* Improved connecting devices APIs to prevent connecting devices from different subcircuits and pages
* Clarified error messages with the CIGRE block when a crash in the simulation occurs
* **ePHASORSIM**: Improved error message while running a ePHASORSIM block with a restricted license.
* **ePHASORSIM**: Improved error notifications: UI toast messages now include a clickable link to the relevant context‑based log files
* **OPAL-RT Board**: Updated default bitstream of OP5143 card to prevent MuSE timeout issues
* **OPAL-RT Board**: Improved OP48H30 example model

### Bug fixes

* Fixed subcircuit “SimLocked” column not always being correctly applied on subcircuit parameter
* Fixed incompatibility issue when starting 2 different HYPERSIM versions on host which should be compatible according to Target protocol versions
* Fixed user experience when using the Target I/O Interface to transform a control pin into a bundle
* Fixed incorrect time step displayed in the console log header when the time step is change via the Python API Commands
* Fixed PLL, 3-ph and PLL, 1-ph blocks when adding an initial angle different from 0
* HYPERSIM no longer crash when C values of Shunt & Series R, L, C Elements are out of normal range
* Fixed some component parameter forms to better react to Windows UI Scaling
* Fixed a crash occurring when configuring the Shunt Inductor (L) component with the maximum number of saturation points
* Fixed error when creating CIGRE blocks from DLLs containing parameters with spaces in their names
* Fixed the fact that we could have 2 versions displayed as active in the ‘Targets’ window
* Fixed automatic IO connections performed by eHS or the Target I/O Interface blocks being manually editable
* Fixed the inability to select time as X axis when importing a CSV file in ScopeView
* Fixed CIGRE block masks not being properly updated when reloading a CIGRE unit after DLL modifications CIGRE block can be added even when string parameter is not supported yet. string values are handled as read-only parameters with default values
* Fixed an issue where a one-step offset occurred when a CSV file was used in the Signal Generator as input to a CIGRE model
* Fixed an issue where the License button did not open the Windows Explorer file selection dialog
* Fixed false positive in the target diagnostic regarding hyServMain.cfg
* Updated log4jcore library to 2.25.3 to avoid vulnerability
* The "Restart services" button in the Targets window is now disabled during active installations to prevent service interruption
* ScopeView time scale is now automatically set based on the OPREC recording duration, restoring the previous workflow
* Fixed inability to modify the time length of displayed data within ScopeView
* Fixed Model Diagnostic and Windows target manager diagnostic not giving output, and failing if the model path had a space
* **Dashboard**: Fixed multiple graph widget issues for improved stability and usability.
  * Fixed "Initializing Acquisitor" status appearing on graph widgets with no signals connected.
  * Fixed an issue where the graph widget border was rendered below the background color instead of above.
  * Fixed an issue where the graph tooltip disappeared when the cursor moved over a graph receiving new data.
  * Fixed the graph widget sidebar and parameter changes not working after a validation error was shown.
* **Dashboard**: Fixed the slider widget responsiveness issue where rapid slider movements caused command accumulation and increasing delay. A command queue with a skip mechanism now ensures intermediate values are discarded.
* **Dashboard**: Fixed copy-paste not preserving all properties of a Text widget.
* **Dashboard**: Fixed the Numeric Control widget appearance when buttons are hidden.
* **Application Server**: Fixed a crash occurring when an invalid version path from the Windows registry was saved to the database. The Application Server now logs the error and continues to start normally.
* **ePHASORSIM**: Fixed ePHASORSIM\_CO\_SIMULATION demo to include the PHASOR2EMT UCM at model root.
* **ePHASORSIM**: Fixed the UCM .def path in examples ePHASORSIM-HYPERSIM CO-SIMULATION UNDEFINED to point to the correct location next to the model file.
* **OPAL-RT Board**: Fixed configuration loss issue when changing the chassis type and the bitstream was taken from a standard repository
* **OPAL-RT Board**: Fixed Virtual mode

### Breaking changes

* Removed Python 3.7 compatibility
* **Application Server**: Removed the 30-minute idle timeout that automatically shut down the Application Server.

### Known issues

N/A

***

## Version: 2026.1

### New features

* Added a “Locate” option in the Project Import-Export to quickly find components that use a given file.
* Added a new example model based on an enhanced version of the standard IEEE 57-bus system:
  * Example - HVAC 138kV 57Bus IEEE
  * Benchmarks - IEEE 57-Bus Power System
* Support of MATLAB 2025a.
* **Dashboard**: Added Undo/redo functionality is now available across all tables and boards.
* **ePHASORSIM**: Added the tab-oriented layout
* **ePHASORSIM**: Added export of the Load Flow results (.xlsx) via a new button in the Load Flow tab
* **ePHASORSIM**: Added export of the Admittance Matrix Report (.xlsx) via a new button in the Common tab
* **ePHASORSIM Power System**: Added support for Dynamic Load, Controllable current source, and Voltage source at PV buses for Excel input
* **ePHASORSIM Power System**: Added time constants support for Dynamic load
* **ePHASORSIM Power System**: Added a validation at the PiLine initialization to prevent zero series impedance causing the admittance matrix to be singular

### Improvement

* Compatibility with EMTPWorks 4.5 is now supported.
* **Dashboard**: Graph widget performance has been significantly enhanced, reducing latency for smoother simulation control.
  * More graph widgets can be instantiated per panel.
  * Graphs now continue to render while being moved.
  * The graph status is more precise when not rendering.
  * Note that it is no longer possible to hide a curve by clicking on the legend.
* **Dashboard**: Panel stability has been improved for a more reliable experience.
  * Auto-recovery has been added.
  * Panels have better responsiveness during edition while acquiring on graph widgets.
* **Dashboard**: The Numeric Control widget can now receive Binary and Hexadecimal formats as input.
* **Dashboard**: API PyThon the installation script install\_opalone\_api.py now supports all Python versions >= 3.9.13.
* **Dashboard**: API PyThon panel import/export examples now support vector datapointston
* **Third-Party Model Import**: Improved the logging of missing components

### Bug fixes

* Fixed an issue causing the netlist generation step to take an excessively long time on certain models when HYPERSIM was not minimized.
* Fixed an occasional crash that could occur when dragging a component with the mouse while simultaneously using the arrow keys to move it.
* Fixed visual glitches affecting popup windows when using high-resolution displays.
* Fixed a netlist generation error that occurred after rotating a subcircuit port.
* Fixed a graphical issue where text elements displayed black artifacts when selecting them with a selection box.
* Fixed a signal selection issue in the bundle connection view when creating a second connection on the initially proposed signal.
* Fixed an OperationTaskCleanup internal error popup that could appear when deleting large numbers of certain components.
* Fixed an issue with the Project Import-Export where the UCM reference folder was not displayed when the referenced folder did not exist.
* Fixed an issue with the Project Import-Export where the hypCigre file of a CIGRE component was not included during packaging.
* Fixed an internal error popup that occurred when flipping schematic components containing a bundle pin with an internal pin sharing the same name (e.g., Power, 3ph).
* Fixed icon issues and clarified text in the Orientation panel of the Home ribbon in the schematic editor.
* Fixed an error when loading some txt files in scopeview.
* **Dashboard**: Fixed an issue that removed the background image when exporting and importing a panel.
* **Dashboard**: Fixed a 404 error in the Image Loop Control and Display after deleting an attached file.
* **Dashboard**: Fixed an issue with datapoint removal while rendering.
* **Dashboard**: The Numeric Control widget can now receive Binary and Hexadecimal formats as input.
* **Third-Party Model Import**: Fixed an issue when re-using the same canvas after a third-party model import
* **ePHASORSIM**: Fixed the Timeout for sync client parameter (Advanced tab) which was only applied at block creation
* **ePHASORSIM Co-simulation**: Fixed overruns caused by incorrect synchronization sequence
* **CAN**: Fixed a card initialization issue.
* **DNP3 master & slave**: Fixed an initialization issue on Windows
* **MODBUS slave**: Fixed an issue with the gap read/write feature
* **OPAL-RT Board**: Fixed an incorrect “Unsupported chassis type” error message
* **OPAL-RT Board**: Prevented OP4300 and Versal systems from being reprogrammed while a simulation is running
* **OPAL-RT Board**: Fixed an OP4300 and Versal EEPROM issue with the second initialization command

### Known issues

N/A


---

# 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/readme/release-notes-2026.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.
