niDMM Configure Powerline Frequency

niDMM VIs

niDMM Configure Powerline Frequency

Specifies the powerline frequency.

NI-DMM sets the Powerline Frequency property to this value. The NI 4060 and NI 4050 use this value to select an aperture time to reject powerline noise by selecting the appropriate internal sample clock and filter. The NI 4065 and NI 4070/4071/4072 use this value to select a timebase for setting the Aperture Time property in powerline cycles (PLCs).

After configuring Powerline Frequency, set the Aperture Time Units property to PLCs. When setting the Aperture Time property, select the number of PLCs for the Powerline Frequency. For example, if Powerline Frequency = 50 Hz (or 20ms) and aperture time in PLCs = 5, then aperture time in Seconds = 20ms * 5 PLCs = 100 ms. Similarly, if Powerline Frequency = 60 Hz (or 16.667 ms) and aperture time in PLCs = 6, then aperture time in Seconds = 16.667 ms * 6 PLCs = 100 ms.

Note  When using a resolution of 6.5 digits on the NI 4065 and NI 4070/4071/4072, 50 Hz and 60 Hz noise will be rejected automatically. This is due to the selection of default aperture times on the devices, which appropriately filter out noise.

niDMM Configure Powerline Frequency

cio.gif

instrument handle identifies a particular instrument session.

You obtain the instrument handle parameter from niDMM Initialize or niDMM Initialize With Options. The default is None.

cenum.gif

Powerline Frequency specifies the powerline frequency in hertz.

NI-DMM sets the Powerline Frequency property to this value.

50 HERTZ 50 Hz
60 HERTZ 60 Hz
Note  You should set this control to the frequency of the AC power line (for 400 Hz power line use the 50 Hz setting).
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.