niScope Cal Adjust Range

NI-SCOPE LabVIEW

niScope Cal Adjust Range

Use this VI only when following the external calibration procedure for your device. (Start»Programs»National Instruments»NI-SCOPE»Documentation»Calibration). Use the VI parameters to indicate the voltage and channel.

  • NI 5102

    For the NI 5102, externally calibrates the vertical range for the specified channel and vertical range setting. Call niScope Cal Adjust Offset prior to calling this VI, using the same channel name and range inputs, to perform a preliminary offset calibration using a default vertical range.

  • SMC-Based Devices

    For SMC-based digitizers, calibrates the range (that is, gain) accuracy of the entire device using the specified channel. The VI must be called twice in the same session with two different stimulus values. The stimulus values should be several volts apart, but within ±4 V; the recommended values are +4.0 V and 0.0 V. The two calls should use the same channel—it is not necessary to repeat the procedure on the remaining channel. This VI adjusts the gain and range calibration constants so that the digitizer reads exactly the correct difference between the two stimulus voltages. This calibrates the onboard voltage reference against the external voltage reference. Calibrating with a voltage difference instead of a single reading eliminates any error due to offset.

    The new calibration constants for the digitizer take effect immediately for the duration of the external calibration session. The constants are written to the EEPROM if you call niScope Cal End with no errors and with action set to Store Calibration.

  • NI 5911

    For the NI 5911, externally calibrates the AC gain for the specified channel.

civrn instrument handle is the instrument handle that you obtain from niScope Cal Start. The handle identifies a particular instrument's session.
channel name is the channel to calibrate. For more information, refer to Channel String Syntax.
range (V) is the vertical range to calibrate
stimulus is the external stimulus applied to the digitizer
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 if an error occurred; the default is FALSE
code is the error code; the default is 0
source is, in most cases, the name of the VI or function that produced the error; the default is an empty string
instrument handle out has the same value as the instrument handle.
error out contains error information; if the error in cluster indicated an error, the error out cluster contains the same information; otherwise, error out describes the error status of this VI
status is set to TRUE if an error occurred
code is the error code
source is, in most cases, the name of the VI or function that produced the error