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.

OP5142EX1 Digital In

Block

Mask

Description

The OP5142EX1 Digital In block is used to return 0/1 data values obtained from the digital input channels of OP525x carrier connected to OP5142 board through a Wanda target or an OP5353 mezzanine connected to OP5142 board through a OP5600 I/O box.

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

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

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

  • Slot number (in the range 1 to 4) is the slot of the backplane connected to the OP5142 in which the OP5251 is installed; in case of OP5600 I/O box, this parameter designs the group where OP5353 is located.
  • the Section A or B is a subset of 32 lines of the OP525x carrier. For example, with the 32 In/32Out OP5251 carriers, section A refers to the 32 input lines and section B to the 32 output lines,
  • the Sub-Section, 1 to 4, is a subset of 8 channels connected to one DataOut port: subset 1 represents the 8 first channels of one section of the OP525x, subset 2 represents the 8 next channels, etc.

The user must refer to the configuration file (opened with any text editor) for selecting the DataOut port number for the desired Digital Input channels. The OP5142EX1 Digital 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 Digital Input channels controlled by one OP5142EX1 Digital In is limited by the size of the subset of channels in one sub-section. This number can vary between 1 and 32 and is usually set to 8.

Parameters

Controller NameBind 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.
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 digital input channels related to the selected DataOut port, as obtained from the parsing of the configuration file.
Maximum number of DIn channels controlled by this blockThis non-editable parameter displays the number of channels in one sub-section listed in the configuration file.
Number of DIn 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 DIn channels' parameter. The data transfer mechanism between RT-LAB and the OP5142 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 DIn 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 functionnality 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.

Vals: This output returns the 0/1 values of the subset of channels selected.

Status: This output returns the following values:

ValueDescription
0No error.
-1

Block could not be matched with an OpCtrl OP5142EX1 block (check the 'controller Name' value), or OP5142 card initialization problem.

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

Data reception error: the block received fewer data from the OP5142 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 OP5142 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 OP525x 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
Follow OPAL-RT: LinkedIn | Facebook | YouTube | X/Twitter