DioPmuGetComparatorsSource

Applies To

GX5295

Purpose

Returns the channel’s comparators’ source.

Syntax

DioPmuGetComparatorsSource (nHandle, nChannel, pnSourcel, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Master board or Board handle.
nChannel
SHORT
If Board Handle was passed:
Channel number in the DIO board, each board has 32 I/O channels. I/O channels number range is 0-31.
Each DIO board has 4 Auxiliary channels. Auxiliary channels number range is 0-3.
If Master Board Handle was passed:
Channel number in the DIO domain, each DIO board adds 32 I/O channels. I/O channels number range is 0-991 (1 master and 30 slaves).
Each DIO board adds 4 Auxiliary channels, Auxiliary channels number range is 0-123 (1 master and 30 slaves)
pnSourcel
PSHORT
Returned the specified channel comparators’ source, source can be:
0  DIO_PMU_COMPARATORS_SOURCE_IO_VOLTAGE: I/O voltage is the input signal to the channel low and high comparators.
1  DIO_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 DioPmuSetupComparatorsValues 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 returns channel 0 comparators’ source:

 

SHORT nSource;

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

 

See Also

DioPmuGetComparisonResult, DioPmuSetupComparatorsValues, DioPmuSetupComparatorsSource, DioPmuSetupForcedCurrent, DioPmuSetupForcedVoltage, DioGetErrorString