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.

ML605EX1 Analog In

Block

Mask

Description

The ML605EX1 Analog In block is used to return analog input acquisition data obtained from the analog input channels of an OP5340 module installed on an OP5220 carrier connected to an ML605 board.

The data values are transferred from the ML605 bitstream to the RT-LAB model through one DataOut port of the bitstream, via the PCIe bus of the target computer.

Each ML605 bitstream using Analog Input channels comes with a configuration file which lists the Data port number and the corresponding OP5340 modules location in the system. The configuration file name is the same as the bitstream file name entered in the OpCtrl ML605EX1 block, with the extension .conf instead of .bin.

This configuration file uses three parameters to describe the location of the OP5340 channels:

  • the Slot number (in the range 1 to 4) is the slot of the backplane connected to the ML605 in which the OP5220 is installed,
  • Section A or B is the location of the OP5340 module on the OP5220 carrier,
  • the Sub-Section,1 or 2, is the subset of data values connected to the DataOut port: subset 1 returns values for the 8 first channels of the OP5340, and subset 2 returns values for the 8 last channels.

The user must refer to the configuration file (opened with any text editor) for selecting the DataOut port number for the desired Analog Input channels. The ML605EX1 Analog In block then parses the configuration file and displays the Slot, Section and Sub-section values corresponding to the DataOut port number in the 'Slot info' parameter.

The maximum number of Analog Input channels controlled by one ML605EX1 Analog In is limited by the size of the subset of channels in one sub-section, usually 8.

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 card in the system.
DataOut port numberEnter the number of the DataOut port to be controlled by this block, in the range [1:32].
Slot infoThis non-editable parameter displays the physical location of the analog input channels related to the selected DataOut port, as obtained from the parsing of the configuration file.
Maximum number of AIn channels controlled by this blockThis non-editable parameter displays the number of channels in one sub-section listed in the configuration file.
Number of AIn channelsEnter the number of channels for which data values will be returned at each calculation step. This number must be less than or equal to the value of the 'Maximum number of AIn channels' parameter. The data transfer mechanism between RT-LAB and the ML605 does not allow the selection of individual channels in the sub-section of channels. The data returned by the block will thus correspond to the N first channels of the sub-section, where N is the value of the 'Number of AIn channels' parameter.
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. A functionality block and its associated controller block must execute at the same sample time.

Inputs

This block has no inputs.

Outputs

This block has two outputs.

Volts: This output returns the acquisition data, in Volts, of the subset of channels selected. The voltage range supported by the channels of the OP5340 module is [-16; +16] volts.

Status: This 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 card initialization problem.

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

Data reception error : the block received less data from the ML605 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 ML605 card than the value specified in the 'Data outport width' parameter. Extra data were discarded.

Characteristics and Limitations

Connector Pin Assignments

The user should refer to the documentation of the OP5220 carrier for connector pin assignments.

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