User manual

2.3.2 Acqrs_calibrateEx
Purpose
Performs a (partial) auto-calibration of the instrument.
Parameters
Input
Name Type Description
instrumentID ViSession Instrument identifier
calType ViInt32 = 0 calibrate the entire instrument
= 1 calibrate only the current channel configuration
= 2 calibrate external clock timing. Requires operation
in External Clock (Continuous).
= 3 calibrate only at the current frequency
(12-bit-FAMILY, only)
= 4 fast calibration for current settings only
modifier ViInt32 For calType = 0,1, or 2: Currently unused, set to “0”
For calType = 3 or 4, 0 = calibrate for all channels
n = calibrate for channel "n"
flags ViInt32 Currently unused, set to “0”
Return Value
Name Type Description
status ViStatus Refer to Table 2-1 for error codes.
Discussion
Calling this function with calType = 0 is equivalent to calling Acqrs_calibrate.
Calibrating with calType = 1 reduces the calibration time in digitizers with many possible channel
combinations, e.g. the DC271. However, the user must keep track of which channel combinations were
calibrated, and request another such partial calibration when changing the channel configuration with the
function AcqrsD1_configChannelCombination.
Calibrating with calType = 2 can only be done if the external input frequency is appropriately high. See the
discussion in the Programmer's Guide section 3.16.2, External Clock (Continuous). If the calibration
cannot be done an error code will be returned. It is not applicable for AP240 Signal Analyzer Platforms.
Calibrating with calType = 3 is for 12-bit digitizers only and is needed to support the HRes SR
functionality. For best results it, or the longer full calibration, should be called after a change of sampling
rate.
Calibrating with calType = 4 is for DC135, DC140, DC211A, DC241A, DC271A, DC271AR and 10-bit-
FAMILY models. A new calibration should be done if the AcqrsD1_ configChannelCombination
parameters or any of the following AcqrsD1_configVertical parameters are changed: fullScale, coupling
(impedance), bandwidth, channel. This calibration will be much faster than the calType = 0 case for models
with more than one impedance setting. It will use the new values that have been asked for.
Programmer’s Reference Manual Page 15 of 210