GxAoMeasure

Purpose

Sets the specified channel’s group voltage.

Syntax

GxAoMeasure (nHandle, nGroup, nChannel, nAccuracy, dVoltage, pnStatus)

Parameters

Name
Type
Description
nHandle
SHORT
Handle to a GX1632e board.
nGroup
SHORT
Group number:
0.   GXAO_GROUPA
1.   GXAO_GROUPB
2.   GXAO_GROUPC
3.   GXAO_GROUPD
nChannel
SHORT
Channel number 0-7.
nAccuracy
SHORT
0.      GXAO_1632_MEASUREMENT_ACCURACY_LOW
1.      GXAO_1632_MEASUREMENT_ACCURACY_MID
2.      GXAO_1632_MEASUREMENT_ACCURACY_HIGH
3.    GXAO_1632_MEASUREMENT_ACCURACY_MAX
pdVoltage
DOUBLE
Measured voltage, in Volts.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

When measurement accuracy is low, fewer measurements are taken and integrated to get the final measurement result.  As accuracy is increased, more measurements are integrating requiring more time.  By taking more measurements, we can compensate for system noise.

Example

The following example sets the voltage for group A channel 7 and then measures the actual voltage with a high degree of accuracy:

 

DOUBLE dVoltage;

SHORT nStatus;

 

GxAoGetChannelVoltage (nHandle, GXAO_GROUPA, 7, 2.34, &nStatus);

GxAoMeasure (nHandle, GXAO_GROUPA, 7, GXAO_1632_MEASUREMENT_ACCURACY_HIGH, &dVoltage, &nStatus);

 

See Also

GxAoSetChannelVoltage, GxAoSetGroupVoltageRange, GxAoGetErrorString