niSwitch_CalibrationDataWrite

NI-SWITCH Functions

niSwitch_CalibrationDataWrite

Specific Function

C Function Prototype

ViStatus niSwitch_CalibrationDataWrite (ViSession vi, ViConstString channelName, ViInt32 calibrationField, ViReal64 calibrationData);

Purpose

Writes the calibration data, typically in terms of the amplifier offset, 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 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 write. 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 to store in the EEPROM.