niFgen_CalAdjustMainPathPreAmpOffset

NI-FGEN C Function

niFgen_CalAdjustMainPathPreAmpOffset

ViStatus niFgen_CalAdjustMainPathPreAmpOffset (ViSession vi, ViConstString channelName, ViInt32 configuration, ViInt32[] gainDACValues, ViInt32[] offsetDACValues, ViReal64[] measuredOutputs);

Purpose

Calculates calibration constants pertaining to the preamplifier offset of the main analog path. During external calibration, you can put the device in different configurations; program different gain, offset, and main DAC values; and take measurements of the resulting output voltage. Pass the configuration data, as well as the measurements, to this function to allow NI-FGEN to calculate the appropriate calibration constants and store them in the onboard EEPROM when the calibration session is committed.

Parameters

Input
Name Type Description
vi ViSession Identifies your instrument session. vi is obtained from the niFgen_InitExtCal function and identifies a particular instrument session.
channelName ViConstString Specifies the name of the channel being calibrated.

Default Value: "0"

configuration ViInt32 Specifies the pre-amp stage configuration.
gainDACValues ViInt32[] Specifies an array of the values programmed to the gain calibration DAC during this calibration stage.
offsetDACValues ViInt32[] Specifies an array of the values programmed to the offset calibration DAC during this calibration stage.
measuredOutputs ViReal64[] Specifies an array of the analog output voltages measured during this calibration stage.

Return Value

Name Type Description
Status ViStatus Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. You can examine the status code from each call to an NI-FGEN function to determine if an error occurred. To obtain a text description of the status code, call the niFgen_error_message function. To obtain additional information about the error condition, call the niFgen_GetError function. To clear the error information from NI-FGEN, call the niFgen_ClearError function.

The general meaning of the status code is as follows:

Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors