NI DMM Calibration Functions - ni/grpc-device GitHub Wiki

Calibration Functions

niDMM_SelfCal

ViStatus = niDMM_SelfCal(ViSession Instrument_Handle)

Purpose

For the NI 4080/4081/4082 and the NI 4070/4071/4072, executes the self-calibration routine to maintain measurement accuracy.

Note This function calls niDMM_reset, and any configurations previous to the call will be lost. All attributes will be set to their default values after the call returns.

Parameters

Input
Name Type Description
Instrument_Handle ViSession Identifies a particular instrument session. You obtain the Instrument_Handle parameter from niDMM_init or niDMM_InitWithOptions. The default is None.

Return Value

Name Type Description
Status ViStatus Reports the Status of this operation. To obtain a text description of the status code, call niDMM_GetErrorMessage. To obtain additional information concerning the error condition, use niDMM_GetError.

niDMM_GetCalDateAndTime

ViStatus = niDMM_GetCalDateAndTime(ViSession Instrument_Handle, ViInt32 Cal_Type, ViInt32 *Month, ViInt32 *Day, ViInt32 *Year, ViInt32 *Hour, ViInt32 *Minute)

Purpose

Returns the date and time of the last calibration performed.

Note The NI 4050 and NI 4060 are not supported

Parameters

Input
Name Type Description
Instrument_Handle ViSession Identifies a particular instrument session. You obtain the Instrument_Handle parameter from niDMM_init or niDMM_InitWithOptions. The default is None.
Cal_Type ViInt32 Specifies the type of calibration performed (external or self-calibration). See table below.
Action taken Calibration performed
NIDMM_VAL_INTERNAL_AREA (default) Note The NI 4065 does not support self-calibration 0
NIDMM_VAL_EXTERNAL_AREA 1
Output
Name Type Description
Month ViInt32* Indicates the Month of the last calibration.
Day ViInt32* Indicates the Day of the last calibration.
Year ViInt32* Indicates the Year of the last calibration.
Hour ViInt32* Indicates the Hour of the last calibration.
Minute ViInt32* Indicates the Minute of the last calibration.

Return Value

Name Type Description
Status ViStatus Reports the Status of this operation. To obtain a text description of the status code, call niDMM_GetErrorMessage. To obtain additional information concerning the error condition, use niDMM_GetError.

niDMM_GetDevTemp

ViStatus = niDMM_GetDevTemp(ViSession Instrument_Handle, ViString Options, ViReal64 *Temperature)

Purpose

Returns the current Temperature of the device.

Note The NI 4050 and NI 4060 are not supported

Parameters

Input
Name Type Description
Instrument_Handle ViSession Identifies a particular instrument session. You obtain the Instrument_Handle parameter from niDMM_init or niDMM_InitWithOptions. The default is None.
Options ViString Reserved.
Output
Name Type Description
Temperature ViReal64* Returns the current Temperature of the device.

Return Value

Name Type Description
Status ViStatus Reports the Status of this operation. To obtain a text description of the status code, call niDMM_GetErrorMessage. To obtain additional information concerning the error condition, use niDMM_GetError.

niDMM_GetLastCalTemp

ViStatus = niDMM_GetLastCalTemp(ViSession Instrument_Handle, ViInt32 Cal_Type, ViReal64 *Temperature)

Purpose

Returns the Temperature during the last calibration procedure.

Note The NI 4050 and NI 4060 are not supported

Parameters

Input
Name Type Description
Instrument_Handle ViSession Identifies a particular instrument session. You obtain the Instrument_Handle parameter from niDMM_init or niDMM_InitWithOptions. The default is None.
Cal_Type ViInt32 Specifies the type of calibration performed (external or self-calibration). See table below.
Action taken Calibration type
NIDMM_VAL_INTERNAL_AREA (default) Note The NI 4065 does not support self-calibration 0
NIDMM_VAL_EXTERNAL_AREA 1
Output
Name Type Description
Temperature ViReal64* Returns the Temperature during the last calibration.

Return Value

Name Type Description
Status ViStatus Reports the Status of this operation. To obtain a text description of the status code, call niDMM_GetErrorMessage. To obtain additional information concerning the error condition, use niDMM_GetError.

niDMM_GetExtCalRecommendedInterval

ViStatus = niDMM_GetExtCalRecommendedInterval(ViSession Instrument_Handle, ViInt32 *Months)

Purpose

Returns the recommended interval between external recalibration in Months.

Note The NI 4050 and NI 4060 are not supported

Parameters

Input
Name Type Description
Instrument_Handle ViSession Identifies a particular instrument session. You obtain the Instrument_Handle parameter from niDMM_init or niDMM_InitWithOptions. The default is None.
Output
Name Type Description
Months ViInt32* Returns the recommended number of Months between external calibrations.

Return Value

Name Type Description
Status ViStatus Reports the Status of this operation. To obtain a text description of the status code, call niDMM_GetErrorMessage. To obtain additional information concerning the error condition, use niDMM_GetError.

niDMM_GetSelfCalSupported

ViStatus = niDMM_GetSelfCalSupported(ViSession Instrument_Handle, ViBoolean *Self_Cal_Supported)

Purpose

Returns a Boolean value that expresses whether or not the DMM that you are using can perform self-calibration.

Parameters

Input
Name Type Description
Instrument_Handle ViSession Identifies a particular instrument session. You obtain the Instrument_Handle parameter from niDMM_init or niDMM_InitWithOptions. The default is None.
Output
Name Type Description
Self_Cal_Supported ViBoolean* Returns whether Self Cal is supported for the device specified by the given session.
VI_TRUE 1 The DMM that you are using can perform self-calibration.
VI_FALSE 0 The DMM that you are using cannot perform self-calibration.

Return Value

Name Type Description
Status ViStatus Reports the Status of this operation. To obtain a text description of the status code, call niDMM_GetErrorMessage. To obtain additional information concerning the error condition, use niDMM_GetError.
⚠️ **GitHub.com Fallback** ⚠️