GxAoGetGroupVoltageRange

Purpose

Returns the specified group voltage range.

Applied To

GX1642, GX1648, GX1632e

Syntax

GxAoGetGroupVoltageRange (nHandle, nGroup, pnVoltageRange, pnStatus)

Parameters

Name
Type
Description
nHandle
SHORT
Handle to a board.
nGroup
SHORT
Group number:
0.   GXAO_GROUPA
1.   GXAO_GROUPB
2.   GXAO_GROUPC
3.   GXAO_GROUPD
pnVoltageRange
PSHORT
Return the specified group voltage range.
Gx1642:
0.   GXAO_1642_ZERO_TO_POS10V: 0 to 20V (default)
1.   GXAO_1642_NEG10V_TO_POS10V: -20 to 20V
2.   GXAO_1642_ZERO_TO_POS5V: 0 to 10V
3.   GXAO_1642_NEG5V_TO_POS5V: -10 to -10V
Gx1648:
0.   GXAO_ZERO_TO_POS10V: 0 to 10V (default)
1.   GXAO_NEG10V_TO_POS10V: -10 to 10V
2.   GXAO_ZERO_TO_POS5V: 0 to 5V
3.   GXAO_NEG5V_TO_POS5V: -5 to -5V
Gx1632e:
0.      GXAO_1632_NEG25V_TO_POS25V: -25 to 25V (default)
1.      GXAO_1632_NEG10V_TO_POS10V: -10 to 10V
2.      GXAO_1632_NEG1V_TO_POS1V: -1 to 1V
3.      GXAO_1632_NEG8V_TO_POS25V: -8 to 25V
4.      GXAO_1632_NEG25V_TO_POS8V: -25 to 8V
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The voltage resolutions of all the channels in the specified group will increase/decrease as follow:

Gx1642:

Range
Resolution
0 to 20V
4.88mV
-20 to 20V
9.76 mV
0 to 10V
2.44 mV
-10 to –10V
4.88mV

 

Gx1648:

Range
Resolution
0 to 10V
2.44mV
-10 to 10V
4.88 mV
0 to 5V
1.22 mV
-5 to –5V
2.44mV

 

Gx1632e:

Range
Resolution
-25 to 25V
762 uV
-10 to 10V
305 uV
-1 to 1V
30 uV
-8 to 25V
504 uV
-25 to 8V
504 uV

 

Any call to GxAoSetGroupVoltageRange resets all groups ’channels to zero volts.

Example

The following example returns group A voltage range:

 

SHORT nStatus, nVoltageRange;

 

GxAoGetGroupVoltageRange (nHandle, GXAO_GROUPA, &nVoltageRange, &nStatus);

 

See Also

GxAoSetGroupVoltageRange, GxAoLoadChannelVoltage, GxAoUpdateGroupVoltage, GxAoGetErrorString