GxSmuMeasure

Applies To

GX3104, GX3116e

Purpose

Measures the specified channel’s current or voltage.

Syntax

GxSmuMeasure (nHandle, nChannel, nMeasurementSignal, pdResult, pnStatus)

Parameters

Name
Type
Description
nHandle
SHORT
Handle to a GX3104 or GX3116e board.
nChannel
SHORT
GX3104: Specifies the channel number (0-3): GX3104_CHANNEL_1 to GX3104_CHANNEL_4
GX3116e: Specifies channel number (0-15) is GX3116_CHANNEL_1 to GX3116_CHANNEL_16
nMeasurementSignal
SHORT
GX3104:
0.      GXSMU_MEASURE_VOLTAGE: measures voltage in votes.
1.      GXSMU_MEASURE_CURRENT: measures current in mA.
GX3116e:
0.      GXSMU_MEASURE_VOLTAGE: measures voltage in votes.
1.      GXSMU_MEASURE_CURRENT: measures current in mA.
2.      GXSMU_MEASURE_TEMPERATURE_FAHRENHEIT: measures the channel’s temperature in Fahrenheit.
3.   GXSMU_MEASURE_TEMPERATURE_CELSIUS: measures the channel’s temperature in Celsius.
pdResult
PDOUBLE
Return the measurement.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

This function takes a measurement of the specified channel’s current or voltage. Voltage will be returned as Volts, Current will be returned as mA,

The parameter pdMeasurement will be set to 0 if an error occurs, or if any other warning occurs.

Example

The following example takes a voltage measurement from channel 1:

 

SHORT nHandle, nStatus;

DOUBLE dResult;

GxSmuMeasure (nHandle, GX3104_CHANNEL_1, GXSMU_MEASURE_VOLTAGE, &dResult, &nStatus);

 

See Also

GxSmuSourceSetCurrent, GxSmuSourceSetCurrentLimit, GxSmuSourceSetCurrentClamps, GxSmuSourceSetCurrentRange, GxSmuSourceSetMode, GxSmuSourceSetOutputState, GxSmuSourceSetRangeMode, GxSmuSourceSetVoltage, GxSmuSourceSetVoltageLimit, GxSmuGetErrorString