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.

OpAsyncRecv

Library

rtlab/Communication/Asynchronous

Block

The OpAsyncRecv block allows a user to receive data from the asynchronous process started by the associated controller.

OpAsyncRecv block

Mask

OpAsyncRecv mask

Description

The OpAsyncRecv block is used to receive data from the application started by the associated controller. This block simply reads data from the shared memory. After that, the data are available in the model. If a new value is not available, the OpAsync_Recv gives the latest value placed into the shared memory. Refer to the section RT-LAB Asynchronous process of chapter RT-LAB Connectivity of the User Guide for more details.

Parameters

Controller ID

Specifies the controller ID that the OpAsync_Recv block will use.

Receive ID

Specifies the ID of this OpAsync_Recv block. This ID is used as an identifier by the asynchronous program.

Display parameters list

Masks or Unmasks the parameters described below.

Float parameter 1 .. 5

Any value entered in this field is available in the asynchronous application by calling the OpalGetAsyncRecvParameters function. These five values are placed in the FloatParam array in the Opal_RecvAsyncParam structure.

EX:
Opal_RecvAsyncParam Param;
int RecvID=1;
OpalGetAsyncRecvParameters(&Param,sizeof(Opal_RecvAsyncParam), RecvID);
printf("The first floating point parameter is %f\n",Param.FloatParam[0]);

String parameter 1 .. 5

Any characters entered in this field are available in the asynchronous application by calling the OpalGetAsyncRecvParameters function. This five string are placed in the StringParam array in the Opal_RecvAsyncParam structure.

EX: Opal_RecvAsyncParam Param;
int RecvID=1;
OpalGetAsyncRecvParameters(&Param,sizeof(Opal_RecvAsyncParam), RecvID);
printf("The first string parameter is %s\n",Param.StringParam[0]);

Inputs

Timeout

A possible timeout value to be used by the asynchronous program via a call to function OpalGetAsyncRecvIconTimeout.

Outputs

Error

Outputs error values which can be set by the user's asynchronous program via the OpalSetAsyncSendIconError function.

Status

The user's asynchronous program uses this output to indicate the status of the reception (OpalSetAsyncRecvIconStatus).

Data

The data line contains the values placed into the shared memory by the asynchronous program. It is possible to use a demux block to separate multiple received values.

Characteristics and Limitations

Direct Feedthrough

N/A

Discrete sample time

No

XHP support

Yes (Partial XHP only)

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