GxDmmSetCalibrationMeasurements

Purpose

Sets the measured values for a calibration group (range function combination)

Syntax

GxDmmSetCalibrationMeasurements (nHandle, dwCalGroup, dRefPositiveMeasurement, dRefNegativeMeasurement, dRefGroundMeasurement, dDmmPositiveMeasurement, dDmmNegativeMeasurement, dDmmGroundMeasurement, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Handle for a GX2065 board.
dwCalGroup
DWORD
Chooses the range/function combination to calibrate
  1. GXDMM_CAL_HiRes100mVDC: Volts DC at 100mV Range
  2. GXDMM_CAL_HiRes1VDC: Volts DC at 1V Range
  3. GXDMM_CAL_HiRes10VDC: Volts DC at 10V Range
  4. GXDMM_CAL_HiRes100VDC: Volts DC at 100V Range
  5. GXDMM_CAL_HiRes300VDC: Volts DC at 300V Range
  6. GXDMM_CAL_HiRes20mADC: Current DC at 20mA Range
  7. GXDMM_CAL_HiRes100mADC: Current DC at 100mA Range
  8. GXDMM_CAL_HiRes1ADC: Current DC at 1A Range
  9. GXDMM_CAL_HiRes2ADC: Current DC at 2A Range
  10. GXDMM_CAL_HiRes100_Ohms2W: 2Wire Resistance at 100 Ohm Range
  11. GXDMM_CAL_HiRes1k_Ohms2W: 2Wire Resistance at 1K Ohm Range
  12. GXDMM_CAL_HiRes10k_Ohms2W: 2 Wire Resistance at 10K Ohm Range
  13. GXDMM_CAL_HiRes100k_Ohms2W: 2Wire Resistance at 100K Ohm Range
  14. GXDMM_CAL_HiRes1M_Ohms2W: 2Wire Resistance at 1M Ohm Range
  15. GXDMM_CAL_HiRes10M_Ohms2W: 2Wire Resistance at 10M Ohm Range
  16. GXDMM_CAL_HiRes100M_Ohms2W: 2Wire Resistance at 100M Ohm Range
  17. GXDMM_CAL_HiRes100_Ohms4W: 4Wire Resistance at 100 Ohm Range
  18. GXDMM_CAL_HiRes1k_Ohms4W: 4Wire Resistance at 1K Ohm Range
  19. GXDMM_CAL_HiRes10k_Ohms4W: 4Wire Resistance at 10K Ohm Range
  20. GXDMM_CAL_HiRes100k_Ohms4W: 4Wire Resistance at 100K Ohm Range
  21. GXDMM_CAL_HiRes1M_Ohms4W: 4Wire Resistance at 1M Ohm Range
  22. GXDMM_CAL_HiRes10M_Ohms4W: 4Wire Resistance at 10M Ohm Range
  23. GXDMM_CAL_HiRes100M_Ohms4W: 4Wire Resistance at 100M Ohm Range
  24. GXDMM_CAL_HiRes100mVSHiDC: Not Used
  25. GXDMM_CAL_HiRes1VSHiDC: Not Used
  26. GXDMM_CAL_HiRes10VSHiDC: Not Used
  27. GXDMM_CAL_HiResVCalOpen: 2Wire and 4Wire Open Circuit for 10M Ohm and 100MOhm Ranges
  28. GXDMM_CAL_HiRes_R_Ref:
  29. GXDMM_CAL_Daq100mVDC: Volts AC, DC Coupled 100mV Range
  30. GXDMM_CAL_Daq1VDC: Volts AC, DC Coupled 1V Range
  31. GXDMM_CAL_Daq10VDC: Volts AC, DC Coupled 10V Range
  32. GXDMM_CAL_Daq100VDC: Volts AC, DC Coupled 100V Range
  33. GXDMM_CAL_Daq300VDC: Volts AC, DC Coupled 300V Range
  34. GXDMM_CAL_Daq20mADC: Current AC, DC Coupled 20mA Range
  35. GXDMM_CAL_Daq100mADC: Current AC, DC Coupled 100mA Range
  36. GXDMM_CAL_Daq1ADC: Current AC, DC Coupled 1A Range
  37. GXDMM_CAL_Daq2ADC: Current AC, DC Coupled 2A Range
  38. GXDMM_CAL_Daq100mVAC: Volts AC, AC Coupled 100mV Range
  39. GXDMM_CAL_Daq1VAC: Volts AC, AC Coupled 1V Range
  40. GXDMM_CAL_Daq10VAC: Volts AC, AC Coupled 10V Range
  41. GXDMM_CAL_Daq100VAC: Volts AC, AC Coupled 100V Range
  42. GXDMM_CAL_Daq300VAC: Volts AC, AC Coupled 300V Range
  43. GXDMM_CAL_Daq20mAAC: Current AC, AC Coupled 20mA Range
  44. GXDMM_CAL_Daq100mAAC: Current AC, AC Coupled 100mA Range
  45. GXDMM_CAL_Daq1AAC: Current AC, AC Coupled 1A Range
  46. GXDMM_CAL_Daq2AAC: Current AC, AC Coupled 2A Range
dRefPositiveMeasurement
DOUBLE
The positive reference DMM measurement
dRefNegativeMeasurement
DOUBLE
The negative reference DMM measurement
dRefGroundMeasurement
DOUBLE
The ground reference DMM measurement
dPositiveMeasurement
DOUBLE
The positive GX2065 DMM measurement
dNegativeMeasurement
DOUBLE
The negative GX2065 DMM measurement
dGroundMeasurement
DOUBLE
The ground GX2065 DMM measurement
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The GX2065 can be calibrated in system, in field, by the end user.

Call this function to store measured values for each combination of range and function. The firmware will internally calculate the resultant gains and offset. Call GxDmmWriteEEPROM to write the measured values to the onboard EEPROM.

The Reference measurements, dRefPositiveMeasurement, dRefNegativeMesaurement, and dRefGroundMeasurement, are used to input the values being generated by the Calibrator. Normally these values should be exactly the same as the Calibrator setting. For example, when calibrating VDC 10 Volt Range, dPositiveMeasurement would be +10.0, dNegativeMeasurement would be -10.0, and dGroundMeasurement would be 0.

When using a discrete source and reference DMM instead of a Calibrator, dPositiveMeasurement, dNegativeMeasurement, and dGroundMeasurement would store measured values from the reference DMM.

Note that this function only affects the User calibration. If the User calibration is done incorrectly and the results have been finalized (by calling GxDmmWriteCalEEPROM), the contents can be restored by calling GxDmmRestoreFactoryCalibration.

Example

The following example calibrates the Volts DC function for the 10 Volt Range and stores it in the User Calibration:

 

SHORT nHandle, nStatus;

DOUBLE dPositiveMeasurement, dNegativeMeasurement, dGroundMeasurement;

SetCalibration(VDC, 10.0, “Volts”); //Calibrator API, Set Calibrator to VDC +10.0 Volts

GxDmmMeasure(nHandle, &dPositiveMeasurement, &nStatus);

SetCalibration(VDC, -10.0, “Volts”); //Calibrator API, Set Calibrator to VDC -10.0 Volts

GxDmmMeasure(nHandle, &dNegativeMeasurement, &nStatus);

SetCalibration(VDC, 0.0, “Volts”); //Calibrator API, Set Calibrator to VDC 0.0 Volts

GxDmmMeasure(nHandle, &dGroundMeasurement, &nStatus);

GxDmmSetCalibrationMeasurements (nHandle, GXDMM_CAL_HiRes10VDC, 10.0, -10.0, 0.0, dPositiveMeasurement, dNegativeMeasurement, dGroundMeasurement, &nStatus);

 

See Also

GxDmmSetCalibrationSet, GxDmmGetCalibrationSet, GxDmmRestoreFactoryCalibration, GxDmmWriteCalibrationEEPROM, GxDmmGetErrorString