Returns the connected function and the function settings.
GxCalGetFunction (nHandle, pnFunction, pdValue1, pdValue2, pnStatus)
Name |
Type |
Description |
nHandle |
SHORT |
Handle to a GX1034 board. |
pnFunction |
PSHORT |
Returned connected function number (see comments for details):GXCAL_FUNCTION_NOT_CONNECTED: No function connected.GXCAL_FUNCTION_4WIRE: 4-wires resistors is connected.GXCAL_FUNCTION_2WIRE: 2-wires resistors is connected.GXCAL_FUNCTION_POSITIVE_VDC: Positive DC voltage is connected.GXCAL_FUNCTION_NEGATIVE_VDC: Negative DC voltage is connected.GXCAL_FUNCTION_AC: AC voltage is connected.GXCAL_FUNCTION_TTL_CLOCK: TTL clock is connected.GXCAL_FUNCTION_CURRENT_SOURCE: Current source is connectedGXCAL_FUNCTION_MEASURE_VDC: Output voltage measuremnt is is connected.GXCAL_FUNCTION_MEASURE_RESISTANCE: Cutput voltage measuremnt and Current sourcea re connected. |
pdValue1 |
PDOUBLE |
See Comments |
pdValue2 |
PDOUBLE |
See comments |
pnStatus |
PSHORT |
Returned status: 0 on success, negative number on failure. |
Returned function is as follow:
Connected function: 4-wires resistors (GXCAL_FUNCTION_4WIRE):
pdValue1: returns the actual value of the connected 4-wires ressitore, supported values are: 1, 10, 100
There are three 4-wire resistors on-board of 1W, 10W, 100W. Actual measured values are stored in the on-board EEPORM and can be retrieve by calling the GxCalGetFunctionMeasuredValue function.
pdValue2: Not Used.
Connected function: 2-wires resistors (GXCAL_FUNCTION_2WIRE):
pdValue1: returns the actual value of the connected 2-wires ressitore, supported values are: 1, 10, 100, 1000, 10000, 100000, 1000000, 10000000.
There are eight 2-wire resistors on-board of 1W, 10W, 100W, 1KW, 10KW, 100KW, 1MW, 10MW. Actual measured values are stored in the on-board EEPORM and can be retrieved by calling the GxCalGetFunctionMeasuredValue function.
pdValue2: Not Used.
Connected function: Positive DC voltage (GXCAL_FUNCTION_POSITIVE_VDC):
pdValue1: returns the actual value of the connected poitive VDC, supported values are: 9.0V, 0.9V, 0.09V, 0.009V.
There are four positive DC voltages on-board of 9.0V, 0.9V, 0.09V, 0.009V, actual measured values are stored in the on-board EEPORM and can be retrieved by calling the GxCalGetFunctionMeasuredValue function.
pdValue2: Not Used.
Connected function: Negative DC voltage (GXCAL_FUNCTION_NEGATIVE_VDC):
pdValue1 returns the actual value of the connected negative VDC, supported values are: -9.0V, -0.9V, -0.09V, -0.009V.
There are four negative DC voltages on-board of -9.0V, -0.9V, -0.09V, -0.009V, actual measured values are stored in the on-board EEPORM and can be retrieved by calling the GxCalGetFunctionMeasuredValuefunction.
pdValue2: Not Used.
Connected function: AC voltage (GXCAL_FUNCTION_AC):
pdValue1 returns the actual value of the connected VAC, VAC (nominal) voltage supported values are: 3..5VAC, 0.35VAC, 0.035VAC, 0.0035VAC.
There are four AC voltages on-board of 3..5VAC, 0.35VAC, 0.035VAC and 0.0035VAC, actual measured values are stored in the on-board EEPORM and can be retrieved by calling the GxCalGetFunctionMeasuredValue function.
pdValue2 returns the actual value of the connected VAC frequncy, supported values are: 100, 1000, 10000, 100000, 50, 60, 400.
The supported AC frequncies are 100Hz, 1KHz, 10KHz, 100KHz, 50Hz, 60Hz and 400Hz, actual measured values are stored in the on-board EEPORM and can be retrieved by calling the GxCalGetFunctionMeasuredValuefunction.
Connected function: TTL clock (GXCAL_FUNCTION_TTL_CLOCK):
pdValue1: returns the TTL clock divider value, supported values are integers 1 through 10000000.
The TTL clock frequancy is set by deviding an on-board 10MHz time base with integer values between 1 and 10e6 with a Duty Cycle of 50%.
pdValue2: Not Used.
Connected function: Current Source (GXCAL_FUNCTION_CURRENT_SOURCE):
pdValue1: returns the the ouput current settings, range is 0.0A through 0.0199A.
pdValue2: Not Used.
Connect to the ouptut the bord’s current source.
Note: Make sure that there ar noe components in the connected cuircuit that can be damaged by the 20mA (Max) current settings.
Connected function: Output voltage measuremnt (GXCAL_FUNCTION_MEASURE_VDC):
Conrnect the bord’s internal ADC to the ouput connectore. Voltage measduremtns can than be done by calling GxCalMeasure.
pdValue1: Not Used.
pdValue2: Not Used.
Connected function: Resistance measurement (GXCAL_FUNCTION_MEASURE_RESISTANC):
pdValue1: returns the the ouput current settings, range is 0.0A through 0.0199A.
pdValue2: Not Used.
Connect the outptut the bord’s current source and the internal ADC to the ouput connector. The use can then measure the output resistance by calling GxCalMeasure function. Calling the function with different output current settings (lower or higher values) can increase the accuracy and staability of the ressistance meaasurments.
Note: Make sure that there ar noe components in the connected cuircuit that can be damaged by the 20mA (Max) current settings.
The following example returns the function and function settings:
SHORT nHandle, nFunction, nStatus;
DOUBLE dValue, dValue1;
GxCalGetFunction (nHandle, &nFunction, &dValue, &dValue1, &nStatus);