LabVIEW Sound and Vibration API Reference

SVL Calibrate Microphone (DAQmx) VI

  • Updated2024-06-18
  • 8 minute(s) read

SVL Calibrate Microphone (DAQmx) VI

Owning Palette: Calibration (DAQmx) VIs

Requires: Sound and Vibration Toolkit

Performs an end-to-end calibration on the selected channel by measuring the actual sensitivity of the sensor connected to the channel and returns the measured sensor sensitivity.

The measured microphone sensitivity is returned as calibrated sensor sensitivity and is stored in calibrated channel info as sensor sensitivity. The SVL Calibrate Microphone (DAQmx) VI uses the NI-DAQmx driver.

duration [s] specifies how many seconds of data are acquired to calibrate the selected channel. The default is 1.0 s. The actual duration of the calibration process could be longer than this value, especially if you select self calibrate device.
sampling frequency [Hz] specifies the sampling frequency for data acquisition in hertz. The default is 50,000.00 Hz.
DAQmx physical channel specifies the name of the physical channel on which to perform an end-to-end calibration. The DAQmx physical channel constant lists all physical channels for devices and modules installed in the system.
calibration settings specifies settings used during calibration.
calibration value [dB SPL] specifies the reference signal level generated by the calibrator. The default is 94.00 dB SPL.
calibration frequency [Hz] specifies the frequency of the reference signal in hertz. The default is 1,000.00 Hz.
channel configuration specifies the input limits and terminal configuration to use on the specified DAQmx physical channel.
maximum value (V) specifies the maximum scaled data the device measures for the selected channel. The default is 1.00 V.
minimum value (V) specifies the minimum scaled data the device measures for the selected channel. The default is –1.00 V.
terminal configuration specifies the input terminal configuration of the selected channel.

0Default—The default device terminal configuration. Refer to the device documentation for information about the default terminal configuration.
1RSE—The referenced single-ended (RSE) configuration measures the signal with respect to a ground directly connected to the measurement system ground.
2NRSE—The nonreferenced single-ended (NRSE) configuration measures the signal with respect to a single ground, but the potential may differ from the measurement system ground.
3Differential—The differential configuration has neither of its inputs tied to a fixed reference, such as earth or building ground.
4Pseudodifferential—The pseudodifferential configuration references the positive and negative inputs for the channel to measurement system ground through different impedances. The pseudodifferential terminal configuration measures the difference between the positive and negative inputs.
enable IEPE excitation (F) specifies whether the onboard current excitation is enabled to power integrated electronic piezoelectric (IEPE) sensors. The default is FALSE, meaning that the onboard excitation is disabled.
channel info specifies information about the measurement system used before the signal reaches the DAQ device.
sensor sensitivity [mV/EU] specifies the sensitivity of the sensor in mV/EU. The default is 1000.00.
engineering units specifies the engineering units. The default is Pa. If you are using a microphone, select Pa. If you are using an accelerometer, select g, m/s^2, or in/s^2. If the units you need are not listed, select custom and enter the unit to use in custom label.

0custom...

1V

2A

3Pa

4N

5g

6m/s^2

7m/s

8m

9mm/s

10mm

11micron/s

12micron

13in/s^2

14in/s

15in

16mil/s

17mil

18rad/s^2

19rad/s

20rad

21deg/s^2

22deg/s

23deg

24RPM

25cycle/s^2

26Hz

27cycle

28strain

dB reference [EU] specifies the reference value to use when you compute the results in decibels and when you scale a signal to engineering units. dB reference [EU] uses the unit that you specify in engineering units. The default is 1. When engineering units is V, use a dB reference [EU] of 1. When engineering units is m, use a dB reference [EU] of 0.7746. When engineering units is Pa, use a dB reference [EU] of 20E–6.
custom label specifies the string used for units when engineering units is set to custom. If engineering units is not set to custom, this parameter is ignored. The default is EU.
weighting filter specifies if any weighting filter has been applied to the signal. This control does not apply any weighting to the signal. weighting filter must always return linear for calibration measurements. The default is linear. Use weighting filter only if the acquired signal has been weighted by an external device before it is acquired by a DAQ device. If a weighting filter was applied to the signal before reaching the DAQ device, using weighting filter prevents subsequent VIs from applying any additional weighting to the weighted signal.
pregain [dB] specifies the pregain applied by an external amplifier expressed in decibels. A value of 0 dB specifies no pregain. The default is 0.00 dB. Use pregain [dB] only if an external device amplifies the signal before a DAQ device acquires the signal. If you apply any gain with the DAQ device itself, the driver software takes this into account and you do not need to enter the information.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
self calibrate device (F) specifies whether a device level calibration is performed before the system calibration. The default is FALSE.
time to settle [s] specifies the amount of time to wait, in seconds, to allow the measurement hardware to settle. Specify a value for this parameter if you change input coupling or integrated electronic piezoelectric (IEPE) excitation. The default is 0.0 s.
power spectrum returns the power spectrum versus frequency for the acquired calibration signal.
spectrum info returns information about the spectrum that you can pass to another VI.
Note  You must wire spectrum info when performing extended measurements. Do not modify the spectrum info values. If you want to view the information, you can right-click the spectrum info wire and select Custom Probe»Spectrum Info from the shortcut menu.
calibrated sensor sensitivity [mV/Pa] returns the measured sensor sensitivity in mV/Pa. The VI also returns this value as sensor sensitivity [mV/EU] in calibrated channel info.
calibrated channel info returns the calibrated sensor sensitivity. All other information is identical to channel info.
sensor sensitivity [mV/EU] returns the sensitivity of the sensor expressed in mV/EU. The default is 1,000.00 mV/EU.
engineering units returns the engineering units. If you are using a microphone, select Pa. If you are using an accelerometer, select g, m/s^2, or in/s^2. If the units you need are not listed, select custom and enter the unit to use in custom label.

0custom...

1V

2A

3Pa

4N

5g

6m/s^2

7m/s

8m

9mm/s

10mm

11micron/s

12micron

13in/s^2

14in/s

15in

16mil/s

17mil

18rad/s^2

19rad/s

20rad

21deg/s^2

22deg/s

23deg

24RPM

25cycle/s^2

26Hz

27cycle

28strain

dB reference [EU] returns the reference value used when results are computed in decibels. dB reference [EU] is expressed in the selected engineering units. The typical decibels reference for sound pressure level is 20E–6 Pa. When engineering units is set to Pa, the dB reference [EU] is automatically set to 20E–6 Pa.
custom label returns the string used for units when engineering units is set to custom.
weighting filter returns any weighting filter applied to the signal.

0Linear
1A-weighting
2B-weighting
3C-weighting
4ITU-R 468-4
5Dolby
6CCITT
7C-message
8Wb: vertical whole-body
9Wc: horizontal whole-body
10Wd: horizontal whole-body
11We: rotational whole-body
12Wf: low-frequency whole-body
13Wh: hand-arm
14Wj: vertical head
15Wk: vertical whole-body
16Wm: whole-body in buildings
17AES17 20 kHz lowpass
18AES17 40 kHz lowpass
19AES17 20 kHz highpass
20AES17 40 kHz highpass
21Other
pregain [dB] returns the pregain applied by an external amplifier expressed in decibels. The default is 0.00 dB.
amplitude [V rms] returns the measured amplitude of the calibration signal in volts root-mean-square (V rms). This is the measured amplitude of the signal at the calibration frequency only.
frequency [Hz] returns the measured frequency of the calibration signal in hertz.
error out contains error information. This output provides standard error out functionality.

Log in to get a better experience