niDMM Initialize External Cal

niDMM VIs

niDMM Initialize External Cal

The following operations are performed if the Calibration Password is valid:

- Creates a new session for external calibration to the device you specify for the Instrument Descriptor parameter.

- Resets the device and prepares the EEPROM for new calibration coefficients.

- Returns a ViSession handle that you use to identify the instrument in all calibration adjustments and post-adjustment verification steps.

Note  The NI 4050 and NI 4060 are not supported.

Refer to the NI 4065 6½ Digit DMM Calibration Procedure, the NI 4070/4072 6½ Digit FlexDMM Calibration Procedure, or the NI 4071 7½–Digit FlexDMM Calibration Procedure before using this VI. This VI creates a new session the first time you call it for a device.

If you call this VI on the same resource, an error is returned. You should use niDMM Close External Cal to close a session obtained using this VI.

Details

niDMM Initialize External Cal

cio.gif

Instrument Descriptor contains the resource name of the device to initialize.

The resource name is assigned in Measurement & Automation Explorer (MAX). Refer to Related Documentation for the NI Digital Multimeters Getting Started Guide for more information about configuring and testing the DMM in MAX. Valid Syntax:

  • NI-DAQmx name
  • DAQ::NI-DAQmx name[::INSTR]
  • DAQ::Traditional NI-DAQ device number[::INSTR]
  • IVI logical name
Caution  All IVI names for the Instrument Descriptor, such as logical names or virtual names, are case-sensitive. If you use logical names, driver session names, or virtual names in your program, you must make sure that the name you use matches the name in the IVI Configuration Store file exactly, without any variations in the case of the characters in the name.
cstr.gif

Calibration Password specifies the password required to enable external calibration functionality. The maximum password string length is eight characters, excluding the termination character. "NI" is the factory-default password.

ccclst.gif

error in (no error) describes error conditions that occur before this VI runs. If an error occurred before this VI runs, the VI passes the error in value to error out. This VI runs normally only if no error occurs before this VI runs. If an error occurs while this VI runs, it continues and sets its own error status in error out. Use niDMM Error Message to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.

cbool.gif

status is TRUE (X) if an error occurred before this VI ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI ran. The default is FALSE.

ci32.gif

code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.

cstr.gif

source describes the origin of the error or warning and is, in most cases, the name of the VI that produced the error or warning. The default is an empty string.

iio.gif

instrument handle out returns a handle that you use to identify the instrument in all subsequent instrument driver VI calls.

icclst.gif

error out contains error information. If error in indicates that an error occurred before this VI ran, error out contains the same error information. Otherwise, it describes the error status that this VI produces. Right-click the error out indicator on the front panel and select Explain Error from the shortcut menu for more information about the error.

ibool.gif

status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.

ii32.gif

code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.

istr.gif

source describes the origin of the error or warning and is, in most cases, the name of the VI that produced the error or warning. The default is an empty string.

Details

After opening a calibration session, the device cannot take valid measurements using this session until the device has been properly adjusted. Once the adjustment phase is complete, you can use this session to verify the new calibration constants. After verification, you have the option of saving the new calibration constants or reverting to the previous calibration constants by specifying the Action parameter in niDMM Close External Cal.

If you encounter a fatal error such as a power failure or system crash while performing an external calibration, you can call niDMM Restore Last External Cal Constants to return the device to a usable state.