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 OP7160EX1 DataOut Recv
Block
Mask
Description
The block OpFcnOP7160EX1 DataOut Recv is used to receive raw data from an Opal-RT OP7160 card.
One OpFcnOP7160EX1 DataOut Recv block controls data reception from one of the DataOut ports of the bitstream programmed in the OP7160 card. The OP7160-EX1 bitstream must be produced with Opal-RT RT-XSG product, version 2.1 or higher.
In the OP7160-EX1 implementation of the OP7160 support, the OP7160 bitstreams have 32 DataIn input ports and 32 DataOut 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 OP7160 via the PCIe bus of the target computer.
Parameters
Controller Name | Bind this block to an OpCtrl OP7160EX1 block by entering the same 'Controller Name' as specified in the OpCtrl OP7160EX1 block The OpCtrl OP7160EX1 block controls initialization of the settings of one specific OP7160 card in the system. |
---|---|
DataOut port number | Enter the number of the DataOut port to be controlled by this block, in the range [1:32]. |
Data outport width | Enter the maximum number of data words that will be received from the OP7160 at each calculation step, in the range [1:250]. |
Data outport type | Select 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 OpFcnOP7160EX1 DataOut Recv block and its associated OpCtrl OP7160EX1 block must execute at the same sample time. |
Inputs
This block has no inputs.
Outputs
The block has two outports.
Data | The data values returned by this outport are received from the OP7160 at each calculation step. No scaling or formatting of the data is performed, except for typecast from 'uint32' to 'double' if the 'Data outport type' parameter is set to 'double'. |
---|---|
Status | The Status output returns the following values: |
Value | Description |
---|---|
0 | No error. |
-1 | Block could not be matched with an OpCtrl OP7160EX1 block (check the 'controller Name' value), or OP7160 card initialization problem. |
-2 | Data reception timeout. This error can be caused by model synchronization errors. |
-3 | Data reception error: the block received fewer data from the OP7160 card than the value specified in the 'Data outport width' parameter. Missing data were replaced by 0. |
-4 | Data reception error: the block received more data from the OP7160 card than the value specified in the 'Data outport width' parameter. Extra data were discarded. |
Characteristics and Limitations
This block has no special characteristics.
Direct Feedthrough | No |
---|---|
Discrete sample time | Yes |
XHP support | Yes |
Work offline | No |
OPAL-RT TECHNOLOGIES, Inc. | 1751, rue Richardson, bureau 1060 | Montréal, Québec Canada H3K 1G6 | opal-rt.com | +1 514-935-2323
Follow OPAL-RT: LinkedIn | Facebook | YouTube | X/Twitter