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 Encoder Out




The ML605EX1 Encoder Out block is used to produce Quadrature Encoder output signals (A, B, and the index signal Z) on the digital output lines of an OP525x carrier connected to an ML605 card.

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

Each ML605 bitstream using digital output channels in Encoder Out mode comes with a configuration file which lists the DataIn port numbers and their corresponding OP525x 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 selection of the OP525x channels:

  • the Slot number (in the range 1 to 4) is the slot of the backplane connected to the ML605 in which the OP525x is installed,
  • the Section A or B is a subset of 32 lines of the OP525x carrier. For example, with the 32 In/32Out OP5251 carrier, 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 data values connected to the port: subset 1 returns values for the 8 first channels of one section of the OP5251, subset 2 returns values for the 8 next channels, etc.

The user must refer to the configuration file for selecting the port number for the desired digital output channels. The ML605EX1 Encoder Out block then parses the configuration file and displays the Slot, Section and Sub-section values corresponding to the port number in the 'Slot infos' parameter.

Note: in early versions of RT-XSG 1.3, the Encoder Out signals mapping may differ from the above description. When more than two encoder signals (i.e. 6 digital output channels) are used, the third signal and the following signals are routed contiguously to these first signals. In these cases, the DataIn ports do not exactly match the OP525x sub-sections described in the preceding paragraph. Those bitstreams come with documentation that details the pin-out of those encoder signals on the OP525x and their matching with the DataIn port numbers.

The maximum number of digital output channels controlled by one ML605EX1 Encoder Out is limited by the size of the subset of channels in one sub-section, which is fixed to 2 in the current implementation.


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.
DataIn port numberEnter the number of the DataIn port to be controlled by this block, in the range [1:32].
Slot infoThis non-editable parameter displays the physical location of the digital output channels related to the selected DataIn port, as obtained from the parsing of the configuration file.
Maximum number of Encoder signals controlled by this blockThis non-editable parameter displays the number of channels in one sub-section listed in the configuration file.
Number of Encoder signalsEnter the number of signals for which encoder frequency values will be transmitted at each calclulation step. Each encoder signal is a set of A, B and Z signals. The value of the number of signals must be less than or equal to the value of the 'Maximum number of Encoder signals' 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 apply to the N first channels of the sub-section times 3, where N is the value of the 'Number of channels' parameter, and 3 stands for the A, B and Z signals.
Frequency unitSelect between 'Hz' or 'rpm' unit for the frequency values supplied via the input of the block. Note that the current implementation is limited to a maximum frequency of 10000 rpm, or 166.66 Hz.
ModeSelect between single-ended or differential mode for the output signal. This parameter is not supported yet. Default value is single-ended.
Resolution (# of cycles per revolution)Enter the integer number of cycles of the A and B signals per revolution. This parameter is not supported yet. Default value is 512.
Clockwise rotationThis parameter determines whether the encoder signals are produced with signal A leading signal B, or the reverse, in clockwise rotation. This parameter is not supported yet. Default value is A leads B.


The block has one inport, named Hz or rpm, depending on the value of the 'Frequency unit' parameter.

The size of the inport is determined by the 'Number of Encoder signals' parameter. One frequency value must be supplied for each set of A,B,Z encoder signals.

The direction of the signal depends on the sign of the frequncy value. The frequency range is thus [-10000;+10000] rpm, i.e. [0;10000] rpm in positive or negative direction. Out of range values get saturated to these values.


The Status output returns the following values:

0No error.

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

-2Internal memory initialization problem.

Characteristics and Limitations

Direct FeedthroughNo
Discrete sample timeInherited
XHP supportYes
Work offlineNo

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