Block

Mask

Description

The OP5110-5120 Event Generator controls digital output pins of an Opal-RT OP5110 or OP5120 board (formerly named OPHSDIO board). The block makes it possible to generate events (low-to-high or high-to-low transitions) at precise times during any calculation step of the RT-LABmodel where the block is inserted.

OnOP5110 and OP5120 cards, DIO lines are grouped in ports of 8 DIO lines. For example the OPHSDIO64 card, features 7 ports of 8 lines. The OP5110-5120 Event Generator block can monitor any number of these lines simultaneously, each line being connected to its own digital signal. Each line is allowed to generate events at different times.

The OP5110-5120 Event Generator block accepts as inputs the desired transition times and the associated pin states (high or low). The event generation feature of the OP5110 or OP5120 card can produce as many as 511 transitions per port during one calculation step. The maximum number of transitions actually produced during one calculation step is limited by the actual size of the input vectors of the OP5110-5120 Event Generator block in the model as defined by the user.

The figure below shows an example of block inputs and the corresponding output signal waveform. The States and Times vectors have a size of three elements.

At each time step, the output pin is set successively to the specified pin states, at the specified transition times. All possible values for States and Time vector values are described in the Inputs section below.

Synchronization with the model calculation step:
In order to ensure proper synchronization with the model clock, the OP5110-5120Event Generator block must be used in conjunction with an OP5110-5120OpSync block. The OP5110-5120 OpSync block is a hardware synchronization block. It ensures the stability of the calculation time-step and serves as a time reference for other OP5110-5120blocks (such as OP5110-5120 Event Detector, OP5110-5120 Event Generator). For more information, please refer to the documentation of the OP5110-5120 OpSync block.

Parameters

Target environment	Select between RT-LAB and xPC Target.
Bus Type	Select the bus type of the target node in this list.
Card Type	Select the card model in this list.
PCI slot (-1:autosearch)	This option is only available for xPC Target environment. If only one OP5110 board is present in the xPC target PC, enter -1 to automatically locate the board. If two or more boards of this type are in the target PC, enter the bus number and the PCI slot number of the board associated with this driver block.Use the format [BusNumber, SlotNumber]. To determine the bus number and thePCI slot number, in the MATLAB command window, type: getxpcpci all
Board Index	Enter the board index of the card [see board index limitations in the characteristics section below]
Port	This popup allows the user to specify which I/O port of the OP5110 or OP5120 board is used. A different OP5110-5120 Event Generator block must be used for each I/O port.
Output line numbers	Enter the list of output line numbers that will be monitored by this block. The line numbers, in the range 0 to 7, can be entered in any order and must appear only once in the list.
Polarity	This popup enables the user to invert the polarity of the output signal. By selecting 'Low', setting the pin state to 1 will actually make the signal drop from 1 to 0. If some lines have a different polarity than others, two different OP5110-5120 Event Generator blocks must be used, one of them will specify the line numbers having High polarity, and the other one will specify the line numbers having Low polarity.
Time unit	Selecting the Time input values will be specified as ratios of the time of the event over the duration of the step, or in seconds.

Inputs

The block is controlled using two inports: the States requested (high or low) and Times at which these events are to happen, as presented in the functional description section. An event requested during a given calculation step will happen during the following calculation step.

The tables below summarize all possible values for the States and Times inputs.

States: Type of transition to produce during the next calculation step.

Possible Values	Description
-1	No transition requested
1	Signal will rise from low level to high level
0	Signal will drop from high level to low level

Note: requesting a signal rise while the signal is already up will not produce any transition at the output. The same applies if the signal is already down and a drop is requested.

Times: Time of the transition relative to the beginning of the step. This value can be defined as a ratio of the time location of the event (dt) over the overall duration of the step, or in seconds (which is the direct value of dt).

Possible Values (ratio)	Description
0 <= x <= 1	Time at which an event is to occur over duration of a calculation step (step size)
Possible Values (seconds)	Description
0 <= x <= step size	Number of second between the beginning of the next step and the event

Outputs

This block has no outputs.

Characteristics and Limitations

Board Index limitations

On the OP5120 boards (PC-104 format), the board index is user-selectable in the range [0-15] via a connector on the board. However, boardsOPHSDIO64 labeled v0.01 do not implement this feature, and the board index of these boards is set to the default value 15.

On the PCI boards (OP511x family), the board index is user-selectable in the range [12-15], via the jumpers JP8 on the board:

Connector Pin Assignment

OP5110-5120 boards usually ship with custom-made cables adapted to the signal conditioning required by the system they are to be connected to. Please refer to the documentation of your system for your specific connector pin assignment. If you need to prepare your own custom cable, please contact support@opalrt-com.

Direct Feedthrough	No
Discrete sample time	No
XHP support	Yes
Work offline	No