> 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-2023.md).

# Release Notes 2023

## Version: 2023.3

### New features

* Added support for the Graph Widgets in Dashboards, showing signal values over time within an acquisition period. See OPAL-RT Dashboards
* Added How To Example Model:
  * Examples PSSE Import IEEE 118-Bus System
  * Examples | Dashboards
* Added Renewable Energy Example Model:
  * Examples | DIFG-based Wind Turbine with Average and Switching Function Converters
* Added support for String parameters in subcircuits, thereby changing how to assign expressions in subcircuits
* Added the node count information in the netlist UI
* Added CSV recording file format option for the Data Logger
* **TCP/UDP**: Added support for VLAN (802.1q) management
* **TCP/UDP**: Added option to change message order for custom data frames

### Improvements

* Improved Sequence Manager workflow through added highlighting and Python keyword suggestions
* Improved installation size of multiple HYPERSIM by centralizing all tools under a unique common folder
* Improved How To Example Model:
  * Examples PSCAD Import IEEE 39-Bus System
* Improved Renewable Energy Example Models:
  * Examples Photovoltaic Generation System
  * Examples Type 4 Wind Farm
* Improved popup size for FPGA-Based Circuit notifications

### Bug fixes

* Fixed issue when a deselected sensor with an I/O connection is still saved when saving sensors
* Fixed Sensor Summary automatically records and changes signal group of a sensor if multiple signal groups are used
* Fixed error popup blocking simulation startup when changing compiler options of the target from the target manager
* Fixed incorrect line type display in the Schematics when importing certain PSCAD models
* Fixed instabilities with the Python API resulting in failed imports for large PSCAD models
* Fixed certain Python API functions returning errors as boolean instead of raising exceptions when exceptions are enabled
* Fixed incorrect tooltip delays in the I/O Interface view
* Fixed license request form using a wrong URL for license requests
* Fixed RT-Monitor displaying incorrect performance values in Windows simulations
* Fixed ScopeView not correctly opening .oprec files by double-clicking from Windows Explorer if the path contained spaces
* Fixed ScopeView template using a wrong HyperWorks data source hostname if ScopeView was not started from the Ribbon
* Fixed Export Project listing twice the sensor file if the default and current sensor files are the same
* Fixed setting of values in TestView when the simulation is running
* Fixed value of expressions displayed in subsystem
* Fixed start simulation on RedHat when FPGA Scope is enabled
* Fixed fetch signal group in FPGA Scope
* **OPAL-RT Board**: Fixed greyed-out directions in DIO for OP5369
* **OPAL-RT Board**: Fixed simulation not resetting due to incorrect chassis ID

### Known issues

N/A

***

## Version: 2023.2

### New features

* Added support for MATLAB R2023a
* Added support for multiple Dashboards when having several HYPERSIM instances or models opened at the same time. See OPAL-RT Dashboards
* Added How To Example Model:
  * Examples PSCAD Import IEEE 39-Bus System
* Added the following Python API commands:
  * the simulation mode option in the setTarget command
* Added PSSe Import Option
* Added Group Machines With Controls option by default
* Added a notification in case of a simulation crash (limitation: feature not available on Red Hat 32-bit OS)
* Added Python 3.9 and 3.10 compatibility for DataLogger API modules
* Added Processor Performance information to the .simout
* Added ScopeView template in the FPGA scope example model
* **OPAL-RT Board**: Added a pop-up to warn users that OP4200 support as MuSE remote target will no longer be supported as of HYPERSIM 2024.2
* **I/O interface synchronization**: Added possibility to apply an offset to the received timestamp before returning it to the model

### Improvements

* Improved Impedance Measurement workflow
* Improved logging in the console with timing
* Improved message when requesting a license without network connection
* Improved missing license key not found error message
* Improved error message when 2 control output pins feed the same signal
* Improved validation of the topology
* Improved time to build the topology
* **C37.118 Slave**: Improved C37.118 example model with automatic synchronization interface detection

### Bug fixes

* Fixed Target I/O Interface component not renaming pins containing certain forbidden characters on the schematic
* Fixed issue with Target I/O Interface component when a data point is lost
* Fixed simulation still running on the target in case of an engine crash on the host (limitation: fix not available on Red Hat 32-bit OS)
* Fixed sh: /sbin/lspci: No such file or directory error in the target diagnostic for OPAL-RTLinux OS
* Fixed eHS target license missing error
* Fixed HYPERSIM average simulation time value in .simout file
* **C37.118 Slave**: Fixed issue with the process not being migrated to the correct CPU core
* **C37.118 Slave**: Fixed loss of connection issue with long simulations
* **OPAL-RT Board**: Fixed switching to a 64 port loadin/loadout bitstream not showing the correct configuration menu until the I/O Interface menu is restarted
* **OPAL-RT Board**: Fixed flashupdate unable to load dynamic libraries
* **OPAL-RT Board**: Fixed standard repository not finding default bistreams
* **OPC-UA Server**: Fixed issue with the TCP server not attaching to the configured interface
* **OPC-UA Server**: Fixed publish paths and allowed multiple datapoint names in different subfolders
* **TCP-UDP**: Fixed issue with float and double-bit precision data types

### Breaking changes

* Removed HyperView Monitor tab
* Removed HyperView Line tab and moved it to corresponding Lines component masks
* Removed HyperView SyncMac tab and moved it to corresponding Synchronous machine with fault component mask
* Removed Sequence Manager for this version due to instabilities. It will be back in the next version

### Known issues

N/A

***

## Version: 2023.1

### New features

* Added support for MATLAB R2022b
* Added support of Windows 11
* Added support for the pre-release version of OPAL-RT Dashboards
* Added Impedance Measurement tool
* Added Network Lines and Cables Models:
  * PI Section, 1-ph
  * PI Section, 2-ph
* Added Network Loads Models:
  * PQ Load, 1-ph grounded
  * PQ Load, 1-ph series
* Added a method to set expressions containing commas via the Python API setComponentParameter
* Added the following Python API commands:
  * setPinPhaseNumber
  * setProperty: additional parameter to save preferences
* Added timing information in the .simout log in debug mode
* Added warning in Target Manager and when starting the simulation using legacy RedHat and CentOS targets​
* Added the possibility of sorting components by numbers in the netlist
* Added Software Compatibility Matrix in the documentation
* Added error message when the user creates a new design with prohibited characters
* **C37.118 Slave**: Added the possibility to apply an offset on the timestamp received
* **C37.118 Slave**: Added an error message when the Ethernet interface does not exist
* **IEC 61850**: Added support for attributes with CO functional constraint
* **IEC 61850**: Added message to alert users that IEC 61850 Legacy interface will be removed in 2024.1
* **IEC 61850**: Added capability to timestamp MMS data with information from Oregano synchronization board
* **Modbus**: Added support of INT32, UINT32 and INT16 for both master and slave
* **OPAL-RT Board**: Added support for the following PWMOUT features
  * Allow disabling channel
  * Dynamic phase shift and dead time
  * Extended frequency range
* **OPAL-RT Board**: Added capability to maintain common configuration elements when switching between bitstream configurations when Bitstream Configuration location is in the standard repositories
* **I/O interface synchronization**: Added the possibility to apply an offset on the timestamp received from the Oregano board
* **TCP-UDP**: Added IP aliasing capability

### Improvements

* Improved Renewable Energy example model with native components instead of UCM for controls:
  * Type 4 Wind Farm Example Model
* Improved FPGA Scope workflow by adding a target network configuration in the Target Manager, see FPGA Scope for more information
* Improved User Manual accessibility by adding a dropdown to choose what documentation to open between HYPERSIM, Dashboards, and Schematic Editor
* Improved error message when starting the simulation and the hy.core process is down
* Improved license request process
* **I/O interface**: Improved NIC field to make it case-insensitive
* **IEC 61850**: Improved MMS server configuration workflow by creating only the attributes defined in the SCL file
* **IEC 61850**: Improved parser to respect the structure data attributes order as defined in the SCL file
* **OPAL-RT Board**: Improved displayed messages to avoid remote bitstream reprogramming failure
* **I/O interface synchronization**: Improved error message when checking for board/platform compatibility

### Bug fixes

* Fixed UCM dropdown menu not disappearing when clicking on Import UCM
* Fixed code generation error when generated files path are too long
* Fixed memory leak when repeating analysis on a model which increased the RAM consumption of HyWorks
* Fixed auto-transceiver validation when several components within the same task are connected to its output
* Fixed PQ Load component category in the netlist view
* Fixed HyWorks Not Responding issue when inserting a wrong expression in the form
* Fixed engine crash when modifying a 3-ph parameter in the netlist
* Fixed equation consistency in Upward Ramp mask
* Fixed empty diagnostic page when installing HYPERSIM
* Fixed the following Python API commands:
  * setSignalLineColor
  * setSignalLineWidth
* Fixed Target I/O Interface component flipping after Analysis or Task Mapping if it has been flipped before
* Fixed "Cannot Copy 'URP' is Null" when copy-pasting an integer value in the netlist
* Fixed mapping between Target I/O Interface and 3-level NPC converter (SwD) components
* Fixed Content Editor not setting value as an expression when no mathematical formula is involved
* Fixed HYPERSIM crash when writing a wrong expression for a parameter
* **DNP3**: Fixed “duplicate” option behavior
* **IEC 60870-5-104 slave**: Fixed issue when more than 100 slaves are defined
* **IEC 61850**: Fixed SV LE connections not being made when the network interface name has been edited
* **IEC 61850**: Fixed Sampled Values ID used in the packets sent by the simulator
* **OPAL-RT Board**: Fixed bitstream standard repositories not being refreshed automatically when changing the chassis type
* **OPAL-RT Board**: Fixed issue in FPGA scope when the signal chosen as trigger is not selected
* **OPAL-RT Board**: Fixed process cleaning in FPGA scope when the simulation is reset
* **OPAL-RT Board**: Fixed Data Logger connection issue with the FPGA scope
* **Signal Generator**: Fixed Square waves drift in time based on time step
* **I/O interface synchronization**: Fixed Oregano example model fails when loading on Red Hat
* **TCP-UDP**: Fixed communication issue between HYPERSIM and LabView in Windows
* **Communication Network Simulation**: Fixed freeze when seeing a wrong network interface in EXata CPS
* **Communication Network Simulation**: Fixed mislabeled configurator

### Breaking changes

* Removed RMI technology used by HyCore and other services. HYPERSIM 2023.1 will not be able to communicate with targets using version 2021.2 or older. If the latest installed version is 2021.2 or older, installing 2023.1 or a more recent version will require to first install any version between 2021.3 and 2022.2 as an intermediate version
* Removed Python 2 API. Please consult the Python API | Setup page for migration information
* **Signal Generator**: Removed default CSV file and OPREC file when adding a signal generator

### 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-2023.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.
