GtDio6xMeasureConnectChannel

Applies To

GX5296

Purpose

Measures the specified channel's signal.

Syntax

GtDio6xMeasure (nHandle, nChannel, nSignal, 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.

nChannel
SHORT
Used to specify the channel to Get. This parameter is 0-based and refers to any channel in the Domain. Auxiliary channel numbers begin with 1000. Each GX5296 board has 4 auxiliary channels that support all the Pin Electronics API functions.
nSignal
SHORT
Signal to measure:

1.    GTDIO6X_CH_TEMP: measures the specified channel junction temperature, units are specified by the dOp1 parameter.

2.    GTDIO6X_CH_IO_VOLTAGE: measures the specified channel I/O voltage.

4.   GTDIO6X_CH_PMU_CURRENT: measures the specified channel PMU current in mA.
5. GTDIO6X_CH_PMU_VOLTAGE: measures the specified channel’s PMU voltage.
pnStatus
PSHORT
Returned status: 0 on success, negative value on failure.

Comments

The function pre-set the channel's signal internal logic connection enabling zero delay when calling GtDio6xMeasureArray() API. Otherwise calling GtDio6xMeasureArray() API without pre-set the channel's signal internal logic connection, will result in a delay of about ~175uSec before measurements are taken.

Example

The following example pre-set channel 0 signal internal logic connection:

 

DOUBLE dResult;

SHORT nStatus;

 

GtDio6xMeasureConnectChannel (nHandle, 0, GTDIO6X_CH_IO_VOLTAGE, &nStatus);

 

See Also

GtDio6xGetErrorString, GtDio6xPowerSetSource