niDMM_self_test

NI-DMM C/CVI/VB

niDMM_self_test

ViStatus = niDMM_self_test(ViSession Instrument_Handle, ViInt16 *Self_Test_Result, ViChar Self_-_Test_Message[])

Purpose

Performs a self-test on the DMM to ensure that the DMM is functioning properly. Self-test does not calibrate the DMM.

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.
Output
Name Type Description
Self_Test_Result ViInt16* Contains the value returned from the instrument self-test. Zero indicates success.

On the NI 4070/4072, the error code 1013 indicates that you should check the fuse and replace it, if necessary.

Note Note  Self-test does not check the fuse on the NI 4065 and NI 4071. Hence, even if the fuse is blown on the NI 4065 or NI 4071, self-test does not return error code 1013.
Self_-_Test_Message ViChar[ ] This parameter contains the string returned from the instrument self-test. The array must contain at least 256 elements.

For the NI 4050 and NI 4060, the error codes returned for self-test failures include the following:

  • NIDMM_ERROR_AC_TEST_FAILURE
  • NIDMM_ERROR_DC_TEST_FAILURE
  • NIDMM_ERROR_RESISTANCE_TEST_FAILURE

These error codes indicate that the DMM should be repaired.

For the NI 4070/4071/4072, the error code returned for a self-test failure is NIDMM_ERROR_SELF_TEST_FAILURE. This error code indicates that the DMM should be repaired.

Return Value

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