NI DMM Calibration Functions

Calibration Functions

• niDMM_SelfCal
• niDMM_GetCalDateAndTime
• niDMM_GetDevTemp
• niDMM_GetLastCalTemp
• niDMM_GetExtCalRecommendedInterval
• niDMM_GetSelfCalSupported

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.