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

# Release Notes 2021

## Version: 2021.3

### New features

* Added the possibility of having negative initial flux in 2-Winding 1-Phase Saturable Transformer
* Added the following Python API | Commands:
  * recheckPorts
  * setDeviceFillColor
  * setDeviceLineColor
  * setSignalLineColor
  * setSignalLineWidth
  * setProperty
  * option name in the addDevice command
* Added output integrator (1/sTe) to have non-windup limits on AC8B exciter library model
* Added support for OP4510 in FPGA-Based PMSM Drive Transportation example model
* Added the possibility in the Task Manager view to copy lines of the "prodID" column to the "set procID" column
* Added diode in PV Array model to remove operating temperature limitation
* Added capability to bulk edit the execution time estimate of multiple tasks in Task Manager
* Added Warning message when clicking on Clear sensor
* **OPAL-RT Board**: Added support for OP5330 analog out cards with configurable sampling rates
* **OPAL-RT Board**: Added support for the OP5143 Artix-7 board enabling I/O expansion through fiber optics on the OP5033XG platform
* **OPAL-RT Board**: Added debugging feature to log register accesses during simulation load
* **Communication Network Simulation**: Added a new I/O interface to facilitate configuration of EXata CPS on OPAL-RTLinux 3 (x64-based platform)

### Improvements

* Improved the Signal Monitoring component by allowing it to be displayed as an LED
* Improved value accuracy displayed by the Signal Monitoring block:
* Improved error message when the target license expires
* **I/O interface**: Improved view for OPAL-RT Board and C37.118 master I/O interfaces

### Bug fixes

* Fixed phase A voltage mismatch when switching between balanced and unbalanced modes in voltage source
* Fixed I/O factor column not showing when selecting "I/O" view in sensor summary
* Fixed issue when setting to 0 the lower limit of the PID integral integrator of AC8B exciter model during a voltage reference decrement test
* Fixed unapplied limitation on number of taps (50) in transformers
* Fixed DNP3 Slave configuration in DNP3\_MASTER\_SLAVE example model
* Fixed issue with Python API setCommandParameter when the parameter is of type String
* Fixed wrong user feedback indicating clearing of previous load flow information when clicking on Set Initial Conditions
* Fixed crash when putting wrong number in I/O connection column of sensor menu
* Fixed pu option not available in forms of Switches and Breakers components
* Fixed display issue where some menus show a white page when using remote desktop connection
* **I/O interface**: Fixed driver setup and cleanup commands not properly being registered when using multiple models during the same HYPERSIM session
* **OPAL-RT Board**: Fixed isolation losses on OPAL-RTLinux 3 (x64-based platform)

### Breaking changes

* Removed internal ground in the PV Array model

### Known issues

N/A

***

## Version: 2021.2

### New features

* Added support for sequence data for transformers, lines, and switched shunts in PSS®E import
* Added support for substation grouping with automatic component rotation in PSS®E import
* Added capability to save and load sensor configuration in .csv format for faster bulk editing
* Added new battery chemistry types Li-Ion LFP, Li-Ion NMC, Li-Ion NCR/NCA, Li-Ion LTO
* Added reset pin to allow resetting State of Charge at its initial value from an external signal in the battery model
* Added option to customize discharge parameters in the battery model
* Added protection library model:
  * 49M - Thermal Overload Protection for Motors
* Added example model:
  * GHOST Microgrid with protection
* Added the following Python API commands:
  * activateObservables
  * flipHorizontallyDevice
  * flipVerticallyDevice
  * getDeviceBundlePins
  * getDeviceBundleChildPins
  * rotateLeftDevice
  * rotateRightDevice
  * setDevicesNameVisibility
* Added Signal Routing library models allowing sending/receiving signals through all levels of subcircuits or pages without the need for drawn wires
  * Radiolink emitter bundle
  * Radiolink receiver bundle
* Added support for Windows targets in accelerated simulation (RTA) mode
* Added support for multi-user on Windows platform
* Added Help button in example models, linking to their documentation
* Added warning pop-up upon loading a new sensor file that overrides the current configuration
* **I/O interface**: Added capability to virtualize usage of several I/O interfaces to facilitate model development by allowing simulation with I/Os without access to real hardware
  * C37.118 Slave/Master, DNP3 Slave/Master, IEC60870-5-104 Slave, IEC 61850 GOOSE/SV, Modbus Slave/Master, OPAL-RT Board, OPC-UA Server, Synchronization (Oregano), TCP-UDP, Triphase
* **DNP3 Master**: Added support for double bit binary inputs
* **DNP3 Master**: Added support for Windows
* **DNP3 Slave**: Added Deadband feature on analog inputs
* **DNP3 Slave**: Added support for multiple slaves in one interface
* **IEC 60870-5-104 Slave**: Added support for simulation in Windows
* **OPAL-RT Board**: Added support for OP5369 digital bidirectional and configurable threshold card

### Improvements

* Improved suggested UCM files when exporting a project as .zip
* Improved the HYPERSIM ribbon layout

### Bug fixes

* Fixed issue where some routing intermediate components (Cjump) would show in the netlist view
* Fixed issue with synchronous machine stability during initialization when the d-axis only saturation is enabled
* Fixed example models:
  * ixed sensors not found error of distance\_21\_pott protection example
  * Fixed C37118SlaveTool window opening multiple times when running C37.118 example in localhost
* **I/O interface**: Fixed possible crashes when simulation runs after a driver failed to initialize
* **I/O interface**:Fixed NIC name validations in all TCP/IP I/O interfaces
* **I/O interface**: Fixed IP validation of servers in all TCP/IP I/O interfaces
* **DNP3 Master**: Fixed how initial values were applied
* **DNP3 Slave**: Fixed how initial values were applied
* **IEC 61850**: Fixed use on non-English Windows PCs
* **Modbus Master**: Fixed cycle rate
* **Modbus Master**: Fixed crash at reset
* **OPAL-RT Board**: Fixed incapacity to set analog out card range for FPGA-based simulation bitstreams
* **OPAL-RT Board**: Fixed EncoderIN usage
* **OPAL-RT Board**: Fixed issues with bitstream configuration selection for OP5600 Spartan-3
* **OPAL-RT Board**: Fixed detection issues for VC707 and OP4520 MuSE remote expansion simulators
* **OPAL-RT Board**: Fixed board ID detection for VC707 MuSE central simulators
* **Synchronization**: Fixed handling of VLAN for Oregano cards

### Known issues

N/A

***

## Version: 2021.1

### New features

* Added exciter library model:
  * REXSYS
* Added governor library model:
  * WESGOV
* Added example models :
  * Static Synchronous Series Compensator (SSSC)
  * Unified Power Flow Control (UPFC)
  * Kundur 4-Machine Power System
  * IEC 61850 Substation Automation System (SAS)
* Added support for Python version 3.7
* Added the following Python API commands:
  * getAllDevicesNames
  * renameSignal
  * addPinsToDevice
  * createSubCircuit
  * ScopeView\.setDataSourceParameter
* Added subcircuit support in the following Python API commands:
  * addDevice
  * includeDevice
  * removeDevice
  * renameDevice
  * connectDevices
* Added Signal Routing library models allowing sending/receiving signals through all levels of subcircuits or pages without the need for drawn wires
  * Radiolink emitter
  * Radiolink receiver
* Added Multi-Breaker and CmdLine commands in TestView
* Added error message to prevent users from opening more than one instance of HYPERSIM
* Added option to "solve control inputs before solving power" advanced option in simulation settings. It remains unchecked for existing examples but is activated by default with newly created models.
* Added support for EXST1 and ST1A in PSS®E import
* Added carrier frequency input and dead time parameter in PWM average generators for 2-Level Converter and Full-Bridge Converter
* **DNP3**: Added support for double bit binary input
* **DNP3**: Added support for integrity polling (new read mode)
* **DNP3**: Added support to run the driver on Windows
* **OPAL-RT Board**: Added support for OP5369 digital card
* **Synchronization**: Added automatic discovery of the network interface name

### Improvements

* Improved I/O assignment and sensor management workflow
* **I/O interface**: Improved network configuration through harmonization of parameters across relevant interfaces (C37.118, DNP3, IEC 60870-5-104, Modbus) and implementation of automatic IP aliasing generation
* **Communication Network Simulation**: Improved user workflow (DRV-3736)

### Bug fixes

* Fixed issue where some signals in a bundle would be renamed during EDD import, potentially leading to wrong signal connections on the same observable
* Fixed issue where some signal names could conflict during EDD import, potentially leading to import interruption by a popup
* Fixed the output behavior of H(s) component at the beginning of the simulation when a non-zero constant is connected to the "init" input or a zero constant is applied at input "u"
* Fixed DC Circuit Breaker form default values to avoid solver divergence in some cases
* Fixed Task Manager's SaveConfig option wrongly opening OpenConfig menu
* Fixed issues with scripts generated using a template in the Sequence Manager where paths include space characters
* Fixed issues with EDD import when models containing UCMs have their .def file located next to the .edd file
* Fixed Control Exciter library models:
  * AC2A: Fixed the initialization of VA0 and the non-windup integrator producing the VE signal
  * EXAC3: Fixed Efd output at the initialization of the feedback loop signal when EFDN > Efd0
  * EXST1: Fixed various issues with In1, Vt and Vc1 pins and the lower limit of the exciter
* Fixed Autotransformer displayed base winding voltages in rmsLL
* Fixed Voltage Source base voltage value in EDD export
* Fixed several components that were not reported under the correct category in the Netlist
* **UI**: Fixed issue where some connections wouldn't show on the design when connecting multiple pins to the same bundle
* **UI**: Fixed default signal names being cleared when doing Paste Special with "keep old names"
* **UI**: Fixed new default names occasionally assigned to devices on Paste Special even if "keep names" specified
* **C37.118 Slave**: Fixed driver behavior when multiple points connected to the same sensor
* **IEC 60870-5-104**: Fixed display issue in point lists of the configuration menu
* **IEC 61850**: Fixed model loading and resetting issues coming from an incompatibility between IEC 61850 and Modbus RTU (Master and Slave)
* **Modbus Slave/Master**: Fixed initialization failures due to synchronization issues

### Breaking changes

* Removed protection example model:
  * Distance 21 POTT.

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