VTI Instruments EX1629 - Vtex1629_Set_Lxi_Limit_Event_Enabled

VTI Instruments Corp.
266 EX1629 Command Set
vtex1629_set_lxi_limit_event_enabled
FUNCTION PROTOTYPE
ViStatus vtex1629_set_lxi_limit_event_enabled (ViSession vi, ViInt32 lxi, ViUInt32 enabled0,
ViUInt32 enabled1, ViUInt32 enabled2);
FUNCTION PARAMETERS
vi = contains a session handle to the instrument. This handle is obtained by the function and remains valid until the
session is closed.
lxi = the number of the LXI Trigger Bus line to configure. Valid input values: 0 to 7.
enabled1 = the limit mask for the channels 0 through 15, where the lower 16 bits are minimums for these channels,
while the upper 16 bits are maximums.
enabled2 = the limit mask for the channels 16 through 31, where the lower 16 bits are minimums for these channels,
while the upper 16 bits are maximums.
enabled3 = the limit mask for the channels 32 through 47, where the lower 16 bits are minimums for these channels,
while the upper 16 bits are maximums.
DATA ITEM RESET VALUE
Enabled0 = 0 Enabled1 = 0
Enabled2 = 0
DESCRIPTION
This function enables measurement channels for Limit Events on the specified LXI Trigger Bus line. Each of the
eight LXI Trigger Bus lines can have a minimum and/or maximum limit defined for any and all of the 48 bridge
measurement channels. When an over-limit condition occurs, the trigger line is driven high. Because the limit
comparison is performed after filtering, the group delay of the chosen filter also delays trigger assertion. When all
filters are disabled and at a sample rate of 1 kSa/s, the typical delay is 14 ms.
NOTE In order to set any bits in the three enabledX masks to 1, the line indicated by the lxi parameter
must be configured via vtex1629_set_lxibus_configuration with the inOut parameter equal to
VTEX1629_LXI_INPUT or an error message will be returned. This is because the triggers are
driven by the acquisition engine, rather than the main logic board. Additionally, tnhe
transmitionScope should be set to VTEX1629_LXI_INTERNAL_EXTERNAL so that the triggers
reach the rear panel.
Implemented in firmware version 1.4.0.
EXAMPLE
ViStatus status;
status = vtex1629_set_lxi_limit_event_enabled(vi, 0, 0x10001, 0, 0);
status = vtex1629_set_lxi_limit_event_enabled(vi, 1, 0, 0x10001, 0);