Admin Production ni-theme
Current Publication

Configure Measurement

IVI Compliance Package

IviDmm Configure Measurement

IviDmm Base Capability Group

This VI configures the common properties of the DMM. These properties include the measurement function, maximum range, and resolution.

instrument handle The instrument handle that you obtain from the IviDmm Initialize or IviDmm Initialize With Options VI.
measurement function (DC Volts) Pass the measurement VI you want the DMM to perform. The driver sets the IviDmm Function property to this value.

Valid Values:

IVIDMM_VAL_DC_VOLTS—DC Volts

IVIDMM_VAL_AC_VOLTS—AC Volts

IVIDMM_VAL_DC_CURRENT—DC Current

IVIDMM_VAL_AC_CURRENT—AC Current

IVIDMM_VAL_2_WIRE_RES—2-Wire Resistance

IVIDMM_VAL_4_WIRE_RES—4-Wire Resistance

IVIDMM_VAL_AC_PLUS_DC_VOLTS—AC plus DC Volts

IVIDMM_VAL_AC_PLUS_DC_CURRENT—AC plus DC Current

IVIDMM_VAL_FREQ—Frequency

IVIDMM_VAL_PERIOD—Period

IVIDMM_VAL_TEMPERATURE—Temperature (C)

Default Value:

IVIDMM_VAL_DC_VOLTS

range (-1.0: Auto) Pass the measurement range you want to use. The driver sets the IviDmm Range property to this value.

Use positive values to represent the absolute value of the maximum expected measurement. The value must be in units appropriate for the Measurement Function. For example, when you set the Measurement Function to IVIDMM_VAL_DC_VOLTS, you must specify the Range in volts. Setting this parameter to 10.0 configures the DMM to measure DC voltages from –10.0 to +10.0 volts.

The driver reserves special negative values for controlling the DMM's auto-ranging capability.

Defined Values:

IVIDMM_VAL_AUTO_RANGE_ON (-1.0)—Auto-range On

IVIDMM_VAL_AUTO_RANGE_OFF (-2.0)—Auto-range Off

IVIDMM_VAL_AUTO_RANGE_ONCE (-3.0)—Auto-range Once

Default Value:

IVIDMM_VAL_AUTO_RANGE_ON (-1.0)

Notes
  1. Setting this parameter to IVIDMM_VAL_AUTO_RANGE_ONCE configures the DMM to auto-range once, turn auto-range off, and then remain at the current maximum range.
  2. Setting this to parameter IVIDMM_VAL_AUTO_RANGE_OFF configures the DMM to stop auto-ranging and keep the range fixed at the current maximum range.
absolute resolution (0.001) Pass your desired measurement resolution in absolute units. The driver sets the IviDmm Resolution property to this value.

The value must be in units appropriate for the Measurement function.

Setting this parameter to lower values increases the measurement accuracy. Setting this parameter to higher values increases the measurement speed.

Default Value: 0.001

Note  This parameter is ignored if the Range parameter is set to IVIDMM_VAL_AUTO_RANGE_ON.
error in (no error) The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

instrument handle out The instrument handle that you obtain from the IviDmm Initialize or IviDmm Initialize With Options VI.
error out The error out cluster passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.