For SMC-based devices, calibrates the sample rate of the digitizer. The VI adjusts the frequency of the voltage controlled crystal oscillator (VCXO) that serves as the digitizer's onboard sample rate timebase. The stimulusFreq parameter must be set to 10,000,000 (10 MHz). Before calling this VI, connect an accurate, stable 10 MHz reference to channel 0. (The channel used is not configurable.) The VI adjusts frequency calibration constants until the digitizer measures the 10 MHz reference signal as exactly 10 MHz. The new calibration constants take effect immediately for the duration of the external calibration session. The constants are written to EEPROM if you call niScope Cal End with no errors and with action set to Store Calibration.
Note
Use this VI only when following the NI 5122/5124 Calibration Procedure (Start»Programs»National Instruments»NI-SCOPE»Documentation»Calibration).
instrument handle identifies a particular instrument session.
stimulus frequency (Hz) is the frequency of the external reference clock connected to channel 0; set to 10,000,000 (10 MHz).
error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
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.
source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
instrument handle out has the same value as the instrument handle.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.