Gx3748Measure

Purpose

Measure the specified group channel.

Syntax

Gx3748Measure (nHandle, nGroup, nChannel, nAccuracy, pdResult, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Handle for a GX3748 board.
nGroup
SHORT
Group number as follows:
0.      GX3748_GROUP0: J1 input connector pins 2 to 17.
1.      GX3748_GROUP1: J1 input connector pins 23 to 38.
2.    GX3748_GROUP2: J1 input connector pins 44 to 59.
nChannel
SHORT
Sets the channel in the group as an input source to the measurement unit, channel numbers are 0-15:
0.      GX3748_GROUP_CH0: channel 0 in the group.
1.      GX3748_GROUP_CH1: channel 1 in the group.
2.      GX3748_GROUP_CH2: channel 2 in the group.
3.      GX3748_GROUP_CH3: channel 3 in the group.
4.      GX3748_GROUP_CH4: channel 4 in the group.
5.      GX3748_GROUP_CH5: channel 5 in the group.
6.      GX3748_GROUP_CH6: channel 6 in the group.
7.      GX3748_GROUP_CH7: channel 7 in the group.
8.      GX3748_GROUP_CH8: channel 8 in the group.
9.      GX3748_GROUP_CH9: channel 9 in the group.
10.   GX3748_GROUP_CH10: channel 10 in the group.
11.   GX3748_GROUP_CH11: channel 11 in the group.
12.   GX3748_GROUP_CH12: channel 12 in the group.
13.   GX3748_GROUP_CH13: channel 13 in the group.
14.   GX3748_GROUP_CH14: channel 14 in the group.
15.  GX3748_GROUP_CH15: channel 15 in the group.
nAccuracy
SHORT
Accuracy level:
0.      GX3748_MEASUREMENT_ACCURACY_LOW: very fast measurement, about 5uSec per measurement, low accuracy.
1.      GX3748_MEASUREMENT_ACCURACY_MID: fast measurement (about 500uSec per measurement, average accuracy.
2.    GX3748_MEASUREMENT_ACCURACY_HIGH: slow measurement (about 1mSec per measurement, high accuracy.  
pdResult
PDOUBLE
Returned voltage measurement.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

Returns the specified group last measurement. Measurement can be taken at any time using, measurement range is 0V to 50V.

Example

The following example measure the channel 0 in group 0 using software trigger:

 

SHORT nHandle, nStatus;

DOUBLE dResult;

 

Gx3748Measure(nHandle, GX3748_GROUP0, GX3748_GROUP_CH1, GX3748_MEASUREMENT_ACCURACY_HIGH, &dResult, &nStatus);

 

See Also

GxFpgaGetErrorString