GxAoSetGroupVoltageRange

Purpose

Sets the specified group voltage range.

Applied To

GX1642, GX1648, GX1632e

Syntax

GxAoSetGroupVoltageRange (nHandle, nGroup, nVoltageRange, pnStatus)

Parameters

Name
Type
Description
nHandle
SHORT
Handle to a GX1632e, GX1642 or GX1648 board.
nGroup
SHORT
Group number:
0.    GXAO_GROUPA
1.    GXAO_GROUPB
2.    GXAO_GROUPC
3.    GXAO_GROUPD
nVoltageRange
SHORT
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 sets a GX1648’s Group A voltage range to –5 to +5V:

 

SHORT nStatus;

 

GxAoSetGroupVoltageRange (nHandle, GXAO_GROUPA, GXAO_NEG5V_TO_POS5V, &nStatus);

 

See Also

GxAoGetGroupVoltageRange, GxAoLoadChannelVoltage, GxAoUpdateGroupVoltage, GxAoGetErrorString