GtDio6xChannelSetPmuComparatorsSource

Applies To

GX5296, File

Purpose

Sets the specified channel’s comparators’ source.

Syntax

GtDio6xChannelSetPmuComparatorsSource (nHandle, lChannelListArraySize, palChannelListArrary, nSource, pnStatus)

Parameters

Name

Type

Comments
nHandle
SHORT
Session identifier:

●     Board handle is used when communicating with the hardware. The Board handle session identifier is returned by calling GtDio6xInitialize or GtDio6xSetupInitialization.

●     File handle is used when communicating with a file. The File handle session identifier is  returned by calling GtDio6xFileOpen.
lChannelListArraySize
LONG
Used to specify the number of channels to set. This parameter should not be greater than the size of palChannelListArray. If GTDIO6X_ALL_DOMAIN is passed in, then the palChannelListArray parameter can be set to NULL and the settings will be applied to all channels in the Domain.
palChannelListArrary
PLONG
Array containing channels numbers that will be set by this function, channels numbers are 0-based and refers to any channel in the Domain. Auxiliary channel numbers begin with 1000.
GX5296: Each GX5296 board has 4 auxiliary channels that support all the Pin Electronics API functions.
GX5961: Each GX5961 board has 4 fully programmable auxiliary channels, and 8 TTL I/O channels. First 4 auxiliary channels may use all the Pin Electronics API.
GX5964: Does not have Auxiliary channels.
nSource
SHORT
Used to set the  comparators’ source, source can be:

0.    GTDIO6X_PMU_COMPARATORS_SOURCE_IO_VOLTAGE: I/O voltage is the input signal to the channel low and high comparators.

1.    GTDIO6X_PMU_COMPARATORS_SOURCE_FORCED_CURRENT: PMU forced current is the input signal to the channel low and high comparators.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

Each channel’s PMU (parametric measurement unit) supports two high-speed window comparators. The PMU on-chip window comparator supports a 2-bit “go / no-go” test with a low and high threshold settings. The thresholds are set using the GtDio6xChannelSetPmuComparatorsValues function call.

The PMU comparator window translates the forced voltage or the forced current being sensed into an output voltage that can be compared against an upper and lower limit.

The PMU window comparator low and high outputs can be read back directly providing direct access to the actual comparator status at any time.

Example

The following example sets channels 0 and 2 comparators’ source to I/O voltage, and returns the comparators’ source of channel 0:

 

SHORT  nSource;

LONG alChannelList[2];

 

GtDio6xChannelSetPmuComparatorsSource (nHandle,2, alChannelList, GTDIO6X_PMU_COMPARATORS_SOURCE_IO_VOLTAGE, &nStatus);

GtDio6xChannelGetPmuComparatorsSource (nHandle,0, &nSource, &nStatus);

 

See Also

GtDio6xChannelGetPmuComparatorsSource, GtDio6xChannelSetPmuComparatorsValues, GtDio6xChannelGetPmuComparisonResult,  GtDio6xChannelSetPmuForcedCurrent, GtDio6xChannelSetPmuForcedVoltage, GtDio6xChannelSetPmuForcedCurrentCommutatingVoltage, GtDio6xGetErrorString