Knowledge Base

Welcome to OPAL-RT’s Knowledge Base

OPAL-RT offers a repository of support information for optimal use of its technology.

Please note that OPAL-RT knowledge base is not fully optimized for mobile platforms.

For optimal experience, use a desktop computer.

Reference Number: AA-02041 // Views: 27 // Created: 2021-10-05 08:14:51 // Last Updated: 2021-10-05 08:39:34
HowTo
How to create a GenUnit out of Single Components in Dymola

Dymola is a software tool that allows you to create FMUs for GenUnits used afterwards with ePHASORSIM.


Requirements:

  • NOTE: No additional installation on your opallinus3 target is required

 

Opening and loading of libraries
 As a first step load the Single Component library of Opal-RT called OpalRT_Dev.mo

After succesfully importing the library you may see this in the Package Browser


Next to it Opal-RT proved as well already configured GenUnits in a library called package.mo
The premade GenUnits serve as good examples on how to configure your GenUnit.

Create your package:


Right click on your new package and create your model, in this example a single machine GENSAE is created


 
Adding single components of a GenUnit
 Now you can drag and drop out of the Opal-RT single component library your blocks.
If you can see names on the components your library imports have been successful.



Required Single Components
Every GenUnit requires one incoming pin in green and one outgoing pin in red.
Add Power Pin to the GenUnit following the naming convention and connect it to the Power Pin of the current injector component. 
This pin is the point of connection between FMU and the rest of the network
.


The incoming pin must be named TRIP and the outgoing pin must be named bus0


NOTE: These Pins can be later accessed with the Pins Excel Sheet.


Additional Information
 Every Genunit has two representations in Dymola
  1. Representation as graphic
  2. Representation as cod
You can switch between both views in the menuband

The Code is is ordered as follows:
  1. class:
    parameter Real varablename= value;
  2. Followed by the blocks of the OpalRT library
  3. Followed by the connections between the blocks
  4. And will be closed as shown here:

 

Creating parameters
Double click on the block in the schematic.
Now the Parameter section of the blocks must be filled with the parameters written in the FMUGlossary.csv
The first picture below is showing a screenshot of Dymola, with defined parameters for GENSAE and the second picture below is showing the corresponding entry in the FMUGlossary.csv
This excel sheet can be found here: C:\OPAL-RT\RT-LAB\20XX.X\FMUCreator\resources\FMUGlossary