DioSetupTriggerDEvent

DioSetupTriggerPEvent

DioSetupTriggerTEvent

Applies To

GC5050, GX5050, GX5150, GX5280, GX5290, GX5290e, GX5295, File

Purpose

Sets up the specified Master board trigger register (D, P or T) mask and event values.

Syntax

DioSetupTriggerDEvent (nMasterHandle, wEvent, wMask, pnStatus)

DioSetupTriggerPEvent (nMasterHandle, wEvent, wMask, pnStatus)

DioSetupTriggerTEvent (nMasterHandle, wEvent, wMask, pnStatus)

Parameters

Name	Type	Comments
nMasterHandle	SHORT	Master or File board handle.
wEvent	WORD	Event register values (0 default).
wMask	WORD	Mask register values (0xFFFF default).
pnStatus	PSHORT	Returned status: 0 on success, negative number on failure.

Comments

The DioSetupTriggerMode must be called to enable conditional triggering using external event lines.

The mask register value (wMask) is ANDed with the external event input lines. A result equal to the event register value (wEvent), creates a trigger event. A mask register value of 0 always creates a trigger event.

Example

The following example demonstrates two levels trigger (DT Trigger Mode) and sets the P Events and P Mask registers. An external event input line 1 value of ‘1’ and external event input line 4 value of ‘0’ creates the D Trigger event. An external event input lines 3, 4 and 12 value of ‘1’ creates the T Trigger event. These two trigger events in sequence create a sequencer trigger event.

DioSetupTriggerDEvent (nMasterHandle, 0x0002, 0x0012, &nStatus);

DioSetupTriggerTEvent (nMasterHandle, 0x1018, 0x1018, &nStatus);

DioSetupTriggerMode (nMasterHandle, 3, &nStatus);