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.

OpFcn ML605EX1 LoadOut

Block

Mask

Description

The block OpFcnML605EX1 LoadOut is used to read registers of Xilinx ML605 development board. The access to FPGA register is used to retrieve specific data from FPGA. It takes more time than DataOut Recv and should be used ponctually.

One OpFcnML605EX1 LoadOut block controls data reception from one of the LoadOut ports of the bitstream programmed in the ML605 board. The ML605-EX1 bitstream must be produced with Opal-RT RT-XSG product, version 2.0 or higher.

In the ML605-EX1 implementation of the ML605 support, the ML605 bitstreams have 32 LoadOut output ports. Each port has a maximum width of 250 32-bit data words. These data ports are used to exchange data between the RT-LAB model and the FPGA chip of the ML605 via the PCIe bus of the target computer.

Parameters

Controller NameBind this block to an OpCtrl ML605EX1 block by entering the same 'Controller Name' as specified in the OpCtrl ML605EX1 block The OpCtrl ML605EX1 block controls initialization of the settings of one specific ML605 board in the system.
LoadOut port numberEnter the number of the LoadOut port to be controlled by this block, in the range [1:32].
Data outport widthEnter the maximum number of data words that will be received from the ML605 at each calculation step, in the range [1:250].
Data outport typeSelect the data outport 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 outport to 'uint32' type is provided for optimum performances
Sample Time (s)This parameter allows the user to specify the block sample time in seconds. The default value is 0, which specifies a continuous sample time (note that the sample time is borrowed from the separated subsystem) while -1 specifies an inherited sample time. The OpFcnML605EX1 LoadOut block and its associated OpCtrl ML605EX1 block must execute at the same sample time.

Inputs

The block has one inport.

EnableThis input is used to trigger data reading from ML605 FPGA board. When this input is set to 1, 'Data' outport will be updated with data from ML605 FPGA registers.

Outputs

The block has two outports.

Data: The data values returned by this outport are read from ML605 FPGA registers when "Enable" is set. No scaling or formatting of the data is performed, except for typecasting from 'uint32' to 'double' if the 'Data outport type' parameter is set to 'double'.

Status: The Status output returns the following values:

ValueDescription
0No error.
-1

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

-2Data reception timeout. This error can be caused by model synchronization errors.

Characteristics and Limitations

This block has no special characteristics.

Direct FeedthroughNo
Discrete sample timeYes
XHP supportYes
Work offlineNo

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