QUICK REFERENCE
™
NI-DMM Instrument Driver
Initialize and Close
ICON
TYPE
PARAMETER
VALUE TO SET, COMMENTS1
2
niDMM Initialize
(niDMM_init)
Creates a new session to the instrument.
ViRsrc
resourceName
ForTraditional NI-DAQ devices, use DAQ::#,
where #is the device number.
For NI-DAQmx devices, the device name is
assigned by Measurement & Automation
Explorer (MAX). Optionally, for all devices
you can use an IVI logical name.
ViBoolean
ViBoolean
ViSession*
IDQuery
resetDevice
vi
NIDMM_VAL_TRUE
NIDMM_VAL_FALSE
NIDMM_VAL_TRUE
NIDMM_VAL_FALSE
Reference to new session handle
niDMM Initialize with Options
(niDMM_InitWithOptions)
Creates a new session to the instrument and optionally sets the initial state of
session properties.
ViRsrc
resourceName
ForTraditional NI-DAQ devices, use DAQ::#,
where #is the device number.
For NI-DAQmx devices, the device name is
assigned by Measurement & Automation
Explorer (MAX). Optionally, for all devices
you can use an IVI logical name.
ViBoolean
ViBoolean
ViString
IDQuery
resetDevice
Option String
vi
NIDMM_VAL_TRUE
NIDMM_VAL_FALSE
NIDMM_VAL_TRUE
NIDMM_VAL_FALSE
Simulate = 0, RangeCheck = 1
QueryInstrStatus = 1, Cache = 1
ViSession*
Reference to new session handle
1
2
In LabWindows™/CVI™, C, and C++, constant names such as NIDMM_VAL_TRUE and
NIDMM_VAL_AUTO_ZERO_ON refer to the use of #defines in your program. In LabVIEW, these constants
refer to Boolean or ring controls with corresponding entries. For example, NIDMM_VAL_AUTO_ZERO_ON
corresponds to the LabVIEW ring control entry Auto Zero On. Refer to LabVIEW Help (Show Help) for
more details.
Function name for LabWindows/CVI, C, C++, and Visual Basic.
Measurement Options (continued)
ICON
TYPE
PARAMETER
VALUE TO SET, COMMENTS
niDMM Configure Auto Zero
(niDMM_ConfigureAutoZeroMode)
Configures the DMM for Auto Zero.
ViSession
ViInt32
vi
Session handle
Default = Auto
AutoZero
niDMM Configure ADC Calibration
(niDMM_ConfigureADCCalibration)
Allows the NI 4070/4071/4072 to compensate for gain drift since the last external or
self-calibration.
ViSession
ViInt32
vi
Session handle
Default = Auto
ADC Calibration
niDMM Configure Offset Comp Ohms
(niDMM_ConfigureOffsetCompOhms)
Allows the NI 4070/4071/4072 to compensate for voltage offsets in resistance
measurements.
ViSession
ViInt32
vi
Session handle
Offset Compensated Default = Off
Ohms
niDMM Configure AC Bandwidth
(niDMM_ConfigureACBandwidth)
Configures the Min Frequency and Max Frequency properties that the DMM uses
for AC measurements.
ViSession
ViReal64
ViReal64
vi
Session handle
Minimum Frequency Hz
Maximum Frequency Hz
niDMM Configure Frequency Voltage Range
(niDMM_ConfigureFrequencyVoltageRange)
Specifies the expected maximum amplitude of the input signal for frequency and
period measurements on the NI 4070/4071/4072.
ViSession
ViReal64
vi
Session handle
Frequency Voltage Default = AutoRange
Range
niDMM Configure Current Source
(niDMM_ConfigureCurrentSource)
Configures the current source for diode measurements on the NI 4070/4071/4072.
ViSession
ViReal64
vi
Session handle
Current Source
Default = 1.00 mA
niDMM Configure Waveform Coupling
(niDMM_ConfigureWaveformCoupling)
Configures instrument coupling for voltage waveforms on the NI 4070/4071/4072.
ViSession
ViInt32
vi
Session handle
AC or DC
Waveform
Coupling
© National Instruments Corporation
3
NI-DMM Instrument Driver Quick Reference
Capacitance and Inductance
ICON
TYPE
PARAMETER
VALUE TO SET, COMMENTS
niDMM Configure Cable CompType
(niDMM_ConfigureCableCompType)
Sets the Cable CompensationType property for the current capacitance/inductance
mode range on the NI 4072.
ViSession
ViInt32
vi
Session handle
Cable CompType
niDMM Configure Open Cable Comp Values
(niDMM_OpenCableCompValues)
Configures the Open Cable Comp Conductance and Open Cable Comp Susceptance
properties on the NI 4072.
ViSession
ViReal64
ViReal64
vi
Session handle
Conductance
Susceptance
niDMM Configure Short Cable Comp Values
(niDMM_ConfigureShortCableCompValues)
Configures the Short Cable Comp Resistance and Short Cable Comp Reactance
properties on the NI 4072.
ViSession
ViReal64
ViReal64
vi
Session handle
Resistance
Reactance
niDMM Perform Open Cable Comp
(niDMM_PerformOpenCableComp)
Performs the open cable compensation measurements and returns open cable
compensation conductance and susceptance values on the NI 4072.
ViSession
ViInt32
vi
Session handle
MaxTime
Conductance
Susceptance
ViReal64
ViReal64
niDMM Perform Short Cable Comp
(niDMM_PerformShortCableComp)
Performs the short cable compensation measurements and returns short cable
compensation resistance and reactance values on the NI 4072.
ViSession
ViInt32
vi
Session handle
MaxTime
Resistance
Reactance
ViReal64
ViReal64
4
ni.com
NI-DMM Instrument Driver Quick Reference
Triggers
ICON
TYPE
PARAMETER
VALUE TO SET, COMMENTS
niDMM ConfigureTrigger
(niDMM_ConfigureTrigger)
Configures the DMM trigger source and trigger delay.
ViSession
ViInt32
vi
Session handle
Default = Immediate
Default = Auto
Trigger Source
Trigger Delay
ViReal64
niDMM Send SoftwareTrigger
(niDMM_SendSoftwareTrigger)
Sends a command to trigger the DMM.
ViSession
vi
Session handle
niDMM ConfigureTrigger Slope
(niDMM_ConfigureTriggerSlope)
Sets theTrigger Slope property to either rising edge or falling edge polarity.
ViSession
ViInt32
vi
Session handle
Trigger Slope
niDMM Configure SampleTrigger Slope
(niDMM_ConfigureSampleTriggerSlope)
Sets the SampleTrigger Slope property to either rising edge or falling edge polarity.
ViSession
ViInt32
vi
Session handle
Slope
niDMM Configure Meas Complete Dest
(niDMM_ConfigureMeasCompleteDest)
Specifies the destination of the Measurement Complete (MC) signal.
ViSession
ViInt32
vi
Session handle
Default = None
Measurement
Complete
Destination
niDMM Configure Meas Complete Slope
(niDMM_ConfigureMeasCompleteSlope)
Sets the MC signal to either rising edge or falling edge polarity.
ViSession
ViInt32
vi
Session handle
Slope
© National Instruments Corporation
5
NI-DMM Instrument Driver Quick Reference
Actual Values
ICON
TYPE
PARAMETER
VALUE TO SET, COMMENTS
niDMM Get Auto Range Value
(niDMM_GetAutoRangeValue)
Returns the actual range that the DMM is using, even when auto ranging is off.
ViSession
ViReal64*
vi
Session handle
Output
autoRange Value
niDMM Get ApertureTime Info
(niDMM_GetApertureTimeInfo)
Returns the aperture time and aperture time units.
ViSession
ViReal64*
ViInt32*
vi
Session handle
Output
ApertureTime
ApertureTime
Units
Output (seconds or PLC)
niDMM Get Measurement Period
(niDMM_GetMeasurementPeriod)
Returns the measurement period, which is the amount of time it takes to complete
one measurement with the current configuration.
ViSession
ViReal64*
vi
Session handle
Measurement
Period
Output (seconds)
Acquisition
ICON
TYPE
PARAMETER
VALUE TO SET, COMMENTS
niDMM Read
(niDMM_Read)
Acquires a single measurement and returns the measured value.
ViSession
ViInt32
vi
Session handle
Milliseconds
Output
MaximumTime
Measurement
ViReal64*
niDMM Read Multi Point
(niDMM_ReadMultiPoint)
Acquires multiple measurements and returns an array of measured values.
ViSession
ViInt32
vi
Session handle
Milliseconds
Default = 4
Output
MaximumTime
Number to Read
Measurements
Actual Number
ViInt32
ViReal64 [ ]
ViInt32*
Output
6
ni.com
NI-DMM Instrument Driver Quick Reference
Acquisition (continued)
ICON
TYPE
PARAMETER
VALUE TO SET, COMMENTS
niDMM Read Waveform
(niDMM_ReadWaveform)
Acquires a waveform and returns an array representing the digitized waveform on
the NI 4070/4071/4072.
ViSession
ViInt32
vi
Session handle
Milliseconds
Default = 1
Output
MaximumTime
Number to Read
Waveform Data
Actual Number
ViInt32
ViReal64[]*
ViInt32*
Output
niDMM Is Over Range
(niDMM_IsOverRange)
Takes a measurement value and determines if the value is a valid measurement or a
value indicating that an overrange condition occurred.
ViSession
ViReal64
vi
Session handle
Input
Measurement
Over range?
ViBoolean*
Output
Low-Level Acquisition
ICON
TYPE
PARAMETER
VALUE TO SET, COMMENTS
niDMM Initiate
(niDMM_Initiate)
Initiates an acquisition.
ViSession
vi
Session handle
niDMM Fetch
(niDMM_Fetch)
Returns the value from a previously initiated measurement.You must call
niDMM Initiatebefore calling this VI.
ViSession
ViInt32
vi
Session handle
Milliseconds
Output
MaximumTime
Measurement
ViReal64*
niDMM Fetch Multi Point
(niDMM_FetchMultiPoint)
Returns an array of values from a previously initiated multipoint measurement.
ViSession
ViInt32
vi
Session handle
Milliseconds
Default = 4
Output
MaximumTime
Number to Fetch
Measurements
Actual Number
ViInt32
ViReal64[ ]
ViInt32*
Output
© National Instruments Corporation
7
NI-DMM Instrument Driver Quick Reference
Low-Level Acquisition (continued)
ICON
TYPE
PARAMETER
VALUE TO SET, COMMENTS
niDMM Fetch Waveform
(niDMM_FetchWaveform)
Acquires an array of data from a waveform on the NI 4070/4071/4072.
ViSession
ViInt32
vi
Session handle
Milliseconds
Default = 1
Output
MaximumTime
Number to Fetch
Waveform Data
Actual Number
ViInt32
ViReal64[ ]*
ViInt32*
Output
niDMM Read Status
(niDMM_ReadStatus)
Returns measurement backlog and acquisition status on the NI 4060 and
NI 4070/4071/4072.
ViSession
ViInt32*
ViInt16*
vi
Session handle
Output
Backlog
Acquisition State
Output
niDMM Abort
(niDMM_Abort)
Aborts a previously initiated measurement and returns the DMM to the Idle state.
ViSession
vi
Session handle
Utility
ICON
TYPE
PARAMETER
VALUE TO SET, COMMENTS
niDMM Reset
(niDMM_reset)
Resets the instrument to a known state and sends initialization commands to the
instrument.
ViSession
vi
Session handle
niDMM SelfTest
(niDMM_self_test)
Performs a self-test on the DMM to ensure that the DMM is functioning properly.
ViSession
ViInt16*
vi
Session handle
Output
SelfTest Result
ViChar [ ]
SelfTest Message Output
niDMM Revision Query
(niDMM_revision_query)
Returns the revision numbers of the instrument driver and instrument firmware.
ViSession
ViChar [ ]
vi
Session handle
Instrument Driver Output
Revision
ViChar [ ]
Firmware Revision Output
8
ni.com
NI-DMM Instrument Driver Quick Reference
Utility (continued)
ICON
TYPE
PARAMETER
VALUE TO SET, COMMENTS
niDMM Format Measurements Absolute
(niDMM_FormatMeasAbsolute)
Formats the measurement to the proper number of displayed digits.
ViInt32
Function
DC volts, AC volts, and so on
ViReal64
ViReal64
ViReal64
ViChar [ ]
ViChar [ ]
ViChar [ ]
Range
Input
Resolution
Measurement
Mode String
Range String
Data String
Input
Input
Output
Output
Output
niDMM Get Digits Of Precision
(niDMM_GetDigitsOfPrecision)
Returns the digits of precision calculated from the range and resolution information
specified in niDMM Configure Measurement.
ViSession
ViReal64*
vi
Session handle
Digits
Output (3.5/4.5/5.5/6.5)
niDMM Error Message
(niDMM_error_message)
Takes the error cluster returned by the VIs, interprets it, and returns it as a
user-readable string.
ViSession
ViBoolean
vi
Session handle
Message Box
(Only applies to LV)
Default = Do not show dialog
ViStatus*
ViChar [ ]
Error Code
Input/Output
Output
Error Message
Calibration
ICON
TYPE
PARAMETER
VALUE TO SET, COMMENTS
niDMM Self Cal
(niDMM_SelfCal)
Executes the self-calibration routine to maintain measurement accuracy on the
NI 4070/4071/4072.
ViSession
vi
Session handle
niDMM Get Cal Count
(niDMM_GetCalCount)
Returns the calibration count for the specified type of calibration.
ViSession
ViInt32
vi
Session handle
Default = Internal
Output
Area
Count
ViInt32*
© National Instruments Corporation
9
NI-DMM Instrument Driver Quick Reference
Calibration (continued)
ICON
TYPE
PARAMETER
VALUE TO SET, COMMENTS
niDMM Get DevTemp
(niDMM_GetDevTemp)
Returns the current temperature of the NI 4070/4071/4072.
ViSession
ViString
vi
Session handle
Reserved
Temperature
" "
ViReal64*
Output
niDMM Get Last CalTemp
(niDMM_GetLastCalTemp)
Returns the temperature during the last calibration procedure on the
NI 4070/4071/4072.
ViSession
ViInt32
vi
Session handle
Default = Internal
Output
Area
ViReal64*
Temperature
niDMM Get Cal Date andTime
(niDMM_GetCalDateAndTime)
Returns the date and time of the last calibration performed on the
NI 4070/4071/4072.
ViSession
ViInt32
vi
Session handle
Default = Internal
Output
Area
Month
Day
ViInt32*
ViInt32*
ViInt32*
ViInt32*
ViInt32*
Output
Year
Hour
Minute
Output
Output
Output
10
ni.com
NI-DMM Instrument Driver Quick Reference
DMM Programming Flow
© National Instruments Corporation
11
NI-DMM Instrument Driver Quick Reference
National Instruments, NI, ni.com, and LabVIEW are trademarks of National Instruments Corporation. Refer to
the Terms of Use section on ni.com/legalfor more information about National Instruments trademarks.
Other product and company names mentioned herein are trademarks or trade names of their respective
companies. For patents covering National Instruments products, refer to the appropriate location:
Help»Patents in your software, the patents.txtfile on your CD, or ni.com/patents.
© 2000–2004 National Instruments Corporation.
All rights reserved.
371293B-01
Dec04
|