niSwitch_CalibrationDataRead

Specific Function

C Function Prototype

ViStatus niSwitch_CalibrationDataRead (ViSession vi, ViConstString channelName, ViInt32 calibrationField, ViReal64* calibrationData, ViInt32* calibrationDate_Year, ViInt32* calibrationDate_Month, ViInt32* calibrationDate_Day);

Purpose

Retrieves the calibration data, typically in terms of the amplifier offset, stored in the EEPROM.

Some NI switches have an amplifier that may require periodic calibrations. You can perform the necessary calibration and store the data locally on the switch module EEPROM. The calibration date is also stored in the EEPROM.

Parameters

Name	Type	Description
vi	ViSession	A particular NI-SWITCH session established with niSwitch_InitWithTopology, niSwitch_InitWithOptions, or niSwitch_init and used for all subsequent NI-SWITCH calls.
channelName	ViConstString	Name of the channel calibrated. Examples of valid channel names: ch0, com0, ab0, r1, c2, cjtemp Refer to Devices for a complete list of valid channel names. While niSwitch_ReadCalibrationData and niSwitch_WriteCalibrationData take a channel name, some switches only support a single calibration for all input channels. For example, the NI PXI-2501 uses an optional single amplifier for channels ch0 through ch47 to decrease settling time. In these cases, writing a different value to a different channel causes the previous value to be overwritten. Therefore, reading different channels returns the same calibration data.
calibrationField	ViInt32	Tells NI-SWITCH which particular calibration parameter associated with this channel to read. Valid values depend on the switch hardware. Examples of possible values: NISWITCH_VAL_CALIBRATION_CJS_AMP (0) NISWITCH_VAL_CALIBRATION_CHANNEL_AMP (1)
calibrationData	ViReal64	Calibration data from the EEPROM.
calibrationDate_Year	ViInt32	Year the switch was last calibrated with this calibration data. For example, the date August 1, 2003 would be returned as 2003 by this parameter.
calibrationDate_Month	ViInt32	Month the switch was last calibrated with this calibration data. For example, the date August 1, 2003 would be returned as 8 by this parameter.
calibrationDate_Day	ViInt32	Day the switch was last calibrated with this calibration data. For example, the date August 1, 2003 would be returned as 1 by this parameter.