Documentation Home Page RT-LAB Home Page
Pour la documentation en FRANÇAIS, utilisez l'outil de traduction de votre navigateur Chrome, Edge ou Safari. Voir un exemple.

Common LoadIn




The block LoadIn is used to transfer raw data from an RT-LAB model to an Opal-RT card.

One LoadIn block controls data transfer to one of the LoadIn port of the bitstream programmed in the card. The bitstream must be produced with Opal-RT RT-XSG product, version 1.3 or higher.

In the RT-XSG implementation, the bitstreams can have at least 32 LoadIn input ports and 32 LoadOut output ports. On VC707 and TE0741 FPGA based platforms, the bitstreams can have up to 64 LoadIn input ports and 64 LoadOut output ports if the RT-XSG revision used to generate the bitstream is 3.3.4 or above. Each port has a maximum width of 250 32-bit data words. The LoadIn ports can be used to set a particular configuration on the FPGA chip; these ports allow to set the parameters of different peripheral from the RT-LAB model.


ControllerNameBind this block to an OpCtrl block by entering the same 'Controller Name' as specified in the OpCtrl block The OpCtrl block controls initialization of the settings of one specific card in the system.
LoadIn port numberEnter the index of the LoadIn port to be controlled by this block, in the range [1:64] for VC707 and TE0741 FPGAs or [1:32] for all others.
LoadIn port widthEnter the maximum number of data words that will be transferred to the card at each calculation step, in the range [1:250].
Data typeSelect the LoadIn data inport type : 'uint32' or 'double'. When 'double' is selected, the underlying driver performs data typecast between 'double' and 'uint32', so data values are limited to the range [0:2^32-1]. The possibility to set the inport to 'uint32' type is provided for optimum performances.


The block has two inports.

EnableThis input is used to set latency time in data loading. When this input is set to 1, the 'Data' inport is sent to the board. For other values, the LoadIn will not send data.
DataThis input represents the data that will be sent to the board if the 'Enable' port is set to '1'. No scaling or formatting of the data is performed, except for typecasting from 'double' to 'uint32' if the 'Data inport type' parameter is set to 'double'.

Note: It is not recommendable to use the LoadIn block to send data at each step. This practice could decrease simulation performances. The LoadIn block is more appropriate for a single sending.


The Status output returns the following values:

0No error.

Block could not be matched with an OpCtrl block (check the 'controller Name' value), or card initialization problem.

-2Internal memory initialization problem.

Characteristics and Limitations

Direct FeedthroughNo
Discrete sample timeInherited
XHP supportYes
Work offlineNo

OPAL-RT TECHNOLOGIES, Inc. | 1751, rue Richardson, bureau 1060 | Montréal, Québec Canada H3K 1G6 | | +1 514-935-2323