Block

Mask

Description

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

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

In the OP5142-EX1 implementation of the OP5142 support, the OP5142 bitstreams have 32 LoadIn input ports and 32 LoadOut output ports. 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.

Parameters

Controller Name	Bind this block to an OpCtrl OP5142EX1 block by entering the same 'Controller Name' as specified in the OpCtrl OP5142EX1 block The OpCtrl OP5142EX1 block controls initialization of the settings of one specific OP5142 card in the system.
LoadIn port number	Enter the index of the LoadIn port to be controlled by this block, in the range [1:32].
LoadIn port width	Enter the maximum number of data words that will be transferred to the OP5142 at each calculation step, in the range [1:250].
Data type	Select the OpFcnOP5142EX1 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.

Inputs

The block has two inports.

Enable	This input is used to set latency time in data loading. When this input is set to 1, the Data inport is sent to the OP5142 board. For other values, the LoadIn will not send data.
Data	This input represents the data that will be sent to the OP5142 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.

Outputs

The Status output returns the following values:

Value	Description
0	No error.
-1	Block could not be matched with an OpCtrl OP5142EX1 block (check the 'controller Name' value), or OP5142 card initialization problem.
-2	Internal memory initialization problem.

Characteristics and Limitations

Direct Feedthrough	No
Discrete sample time	Inherited
XHP support	Yes
Work offline	No

RT-LAB Documentation

OpFcn OP5142EX1 LoadIn