background image

Appendix B

Function Reference

NI 54XX Calibration Procedure

B-20

ni.com

ni54xx_SetAdjustedGainAndOffset

Format

__declspec(dllexport) long __stdcall 

ni54xx_SetAdjustedGainAndOffset(unsigned long   sessionHandle,

                                double          offsetInVolts,

                                unsigned long   attenuationInDb,

                                unsigned long   terminatedState );

Purpose

Configures the device to output with a certain level of attenuation and a certain offset. It uses
the calibration constants for the session (including those that have been changed during the
session) to calculate the appropriate settings for the calibration DACs. The user must also
provide the termination state, whether the device is unterminated (high-impedance load)
or terminated (50-ohm load).

Parameters

Name

Description

sessionHandle

The handle of the calibration session for the device,
created with a call to

ni54xx_CalStart

.

offsetInVolts

The DC offset of the waveform can be from –2.5 to 2.5 volts.

attenuationInDb

The amount of post-amplifier attenuation applied to the
signal from 0 to 73 dB in 1dB increments.

terminationState

NI54XX_UNTERMINATED

(high-impedance load)

NI54XX_TERMINATED

(50-ohm load).

Summary of Contents for NI 54 Series

Page 1: ...Computer Based Instruments NI 54XX Calibration Procedure NI 54xx Calibration Procedure May 2001 Edition Part Number 370332A 01 ...

Page 2: ...and 09 725 725 11 France 01 48 14 24 24 Germany 089 741 31 30 Greece 30 1 42 96 427 Hong Kong 2645 3186 India 91805275406 Israel 03 6120092 Italy 02 413091 Japan 03 5472 2970 Korea 02 596 7456 Malaysia 603 9596711 Mexico 5 280 7625 Netherlands 0348 433466 New Zealand 09 914 0488 Norway 32 27 73 00 Poland 0 22 528 94 06 Portugal 351 1 726 9011 Singapore 2265886 Spain 91 640 0085 Sweden 08 587 895 0...

Page 3: ... service failures caused by owner s failure to follow the National Instruments installation operation or maintenance instructions owner s modification of the product owner s abuse misuse or negligent acts and power failure or surges fire flood accident actions of third parties or other events outside reasonable control Copyright Under the copyright laws this publication may not be reproduced or tr...

Page 4: ... and dialog box options Bold text also denotes parameter names italic Italic text denotes variables emphasis a cross reference or an introduction to a key concept This font also denotes text that is a placeholder for a word or value that you must supply monospace Text in this font denotes text or characters that you should enter from the keyboard sections of code programming examples and syntax ex...

Page 5: ...DC Offset 2 3 Verifying Amplitude Accuracy 2 4 Verifying Amplitude Flatness over Frequency 2 5 Verifying Total Harmonic Distortion and Spurious Free Dynamic Range 2 8 Verifying Device Oscillator Frequency Accuracy 2 10 Chapter 3 Adjustment Internal Adjustment 3 1 External Adjustment 3 1 Setting Up and Configuring Your Device 3 1 Adjusting Your NI 54XX Procedural Overview 3 4 Finding the Low Freque...

Page 6: ...Contents NI 54XX Calibration Procedure vi ni com Appendix A Overview of the Calibration Constants Appendix B Function Reference Appendix C Function Constants Appendix D Technical Support Resources ...

Page 7: ...that are stored in non volatile memory on the device When you use the device to generate signals the driver software retrieves these constants and uses them to determine the fine adjustments needed to achieve optimal signal characteristics You have two options for calibrating your NI 54XX devices internal adjustment and external adjustment Internal Adjustment You can do internal adjustment or self...

Page 8: ...ice See the recommended calibration schedule in Table 1 1 Refer to Chapter 2 Verification at any time to determine if your device needs a full calibration Equipment and Other Test Requirements This section describes the equipment software documentation and test conditions required for calibrating your NI 54XX device Test Equipment Internal adjustment does not require any test equipment External ad...

Page 9: ... 1 3 for file locations Table 1 2 Equipment Required for Calibrating NI 54XX Devices Instrument Specifications Recommended Equipment 5 1 2 Digit Digital Multimeter DMM At least 1 kHz bandwidth NI 4060 or HP 34401A Digital Counter Ability to make duty cycle measurements measure 1 MHz frequency and have frequency measurement accuracy 1 ppm accounting for clock stability and measurement error due to ...

Page 10: ... and c winnt system32 on NT systems niArbCal dll provides calibration functionality that does not reside in the standard NI DAQ driver This functionality includes protecting the calibration constants and updating the calibration date You can access the functions in this DLL through any 32 bit compiler or LabVIEW To write calibration procedures in LabVIEW you must use the VIs included in the ni54xx...

Page 11: ...allows you to create applications which call functions in the niArbCal DLL You must link to this library when building applications in Microsoft Visual C or National Instruments CVI vxipnp winnt win95 include niArbCal h This is a header file for the accessible functions in the niArbCal DLL You must include this file in any C code that you write in order to call these functions vxipnp winnt win95 S...

Page 12: ...ling and configuring National Instruments DAQ devices Test Conditions Follow these guidelines to optimize the connections and the environment during calibration Keep connections to the NI 54XX device short Long cables and wires act as antennae picking up extra noise that can affect measurements Use twisted pair shielded copper wire for all cable connections to the device for any part of cabling th...

Page 13: ...and the NI FGEN function calls you make to verify specifications The code varies depending on which programming application you use LabVIEW CVI C or Visual Basic The examples shown in this section use CVI C code but LabVIEW has a corresponding VI for each function You can verify the following specifications for NI 54XX devices DC offset Amplitude accuracy Amplitude flatness over frequency Total ha...

Page 14: ...for Verification is the same for each specification you are verifying For a diagram of the connectors referenced in the procedure that follows see Figure 2 1 Figure 2 1 NI 5411 5431 I O Connectors VIDEO OUT SYNC OUT EXT TRIG MARKER OUT PLL REF LOCK ACCESS VIDEO DIGITAL PATTERN ARB OUT SYNC OUT EXT TRIG MARKER OUT PLL REF LOCK ACCESS DIGITAL PATTERN NI 5431 PXI PCI PXI PCI ISA NI 5411 SYNC PLL IN A...

Page 15: ...onfigureOutputMode to select the standard function output mode for the function generator to use Set the following parameters vi The output value sessionHandle that you obtained from the niFgen_init function OutPut_Mode NIFGEN_VAL_OUTPUT_FUNC Verifying DC Offset Complete the following steps to measure the DC offset of your NI 54XX device when you use it to generate a 0 0 V DC voltage 1 Complete th...

Page 16: ...Accuracy Use a DMM to measure the amplitude accuracy of your NI 54XX by generating a 10 Vpp into 50 Ω 1 kΗz sine wave 1 Complete the setup steps described in the Initializing Device for Verification section 2 Call niFgen_EnableAnalogFilter to select the channel to enable an analog filter on Set the following parameters vi The output value sessionHandle that you obtained from the niFgen_init functi...

Page 17: ...curacy of your device Verifying Amplitude Flatness over Frequency Use a power meter or thermoconverter to measure the amplitude accuracy of your NI 54XX by generating a 100 kHz sine wave Use the largest possible amplitude that the power meter can accept but ensure that your power meter meets the specifications from Table 1 2 Equipment Required for Calibrating NI 54XX Devices Make sure that the ana...

Page 18: ...r NI 54XX device This measurement is your baseline 7 Call niFgen_Close to close the instrument I O session destroy the instrument driver session and all of its properties and release any memory resources the driver uses The only parameter required for this function is the sessionHandle 8 Use the code in steps 9 though 17 to generate sine waves of the same amplitude you used for the 100 kHz sine wa...

Page 19: ...plitude x where x the largest possible peak to peak amplitude for the power meter Frequency i Start_Phase 0 c Call niFgen_InitiateGeneration to initiate signal generation This function causes the function generator to leave its configuration state and enter its signal generation state The only parameter required for this function is sessionHandle Note Measure the power of the signal at this step d...

Page 20: ...steps described in the Initializing Device for Verification section 2 Call niFgen_EnableAnalogFilter to select the channel to enable an analog filter on Set the following parameters vi The output value sessionHandle that you obtained from the niFgen_init function Channel_Name 0 FilterCorrectionFrequency 1000000 3 Call niFgen_EnableDigitalFilter to select the channel to enable a digital filter on S...

Page 21: ...s and release any memory resources the driver uses The only parameter required for this function is sessionHandle Generate a 16 MHz sine wave with a 10 Vpp amplitude for a 50 Ω load by completing the following steps 1 Complete the setup steps described in the Initializing Device for Verification section 2 Call niFgen_EnableAnalogFilter to select the channel to enable an analog filter on Set the fo...

Page 22: ...ory resources the driver uses The only parameter required for this function is the sessionHandle You have completed verifying the THD and the SFDR of your device Verifying Device Oscillator Frequency Accuracy Use a counter timer to measure the frequency accuracy of your NI 54XX device The counter timer should provide frequency measurement accuracy of 15 parts per million ppm or better The measurem...

Page 23: ... generation This function causes the function generator to leave its configuration state and enter its signal generation state The only parameter required for this function is sessionHandle 6 Measure the 1 MHz frequency generated by the NI 54XX device at SYNC OUT using the counter timer The frequency measurement should fall between 999 985 Hz and 1 000 015 Hz A frequency error of 15 Hz in 1 MHz co...

Page 24: ...ibrate which is assigned by Measurement Automation Explorer MAX The calibration proceeds automatically The procedure takes approximately one minute to complete Note To restore the last external adjustment call the function ni54xx_CalRestoreExternalConstants External Adjustment This section describes the basic steps in an external adjustment Setting Up and Configuring Your Device To set up and conf...

Page 25: ... OUT VIDEO OUT DMM A7 A9 Magnitude of a sinusoidal voltage either amplitude peak to peak amplitude or RMS value ARB OUT VIDEO OUT DMM Internal reference DC voltage ARB OUT VIDEO OUT DMM Frequency response Magnitude of a sinusoidal voltage either amplitude peak to peak amplitude or RMS value ARB OUT VIDEO OUT Scope Power Meter Duty cycle Duty cycle SYNC OUT Counter VCXO Frequency SYNC OUT Counter ...

Page 26: ...I 5411 5431 I O connectors Figure 3 1 NI 5411 5431 I O Connectors VIDEO OUT SYNC OUT EXT TRIG MARKER OUT PLL REF LOCK ACCESS VIDEO DIGITAL PATTERN ARB OUT SYNC OUT EXT TRIG MARKER OUT PLL REF LOCK ACCESS DIGITAL PATTERN NI 5431 PXI PCI PXI PCI ISA NI 5411 SYNC PLL IN ARB PATTERN OUT SYNC PLL IN ARB PATTERN OUT ...

Page 27: ...fterfunctionsas a handle for the calibration session 2 Reset the device to the default state by calling the following functions a Call ni54xx_DeviceReset using the following parameters sessionHandle The handle of the calibration session for the device b Call ni54xx_SetAttenuation to disable all the attenuators using the following parameters sessionHandle The handle of the calibration session for t...

Page 28: ...TS You may either commit the constants you have calculated or abort the whole session Aborting saves no changes to the device Finding the Low Frequency Characteristics of the Analog Channel Tofindthelow frequencycharacteristicsoftheanalogchannel calibratefor the constants A0 A8 A9 terminated and A9 unterminated You should calculate constants A0 through A8 in the order the sections appear below Tak...

Page 29: ...ues for x where x 8192 6144 4096 2048 0 2048 4096 6144 8191 complete the following steps a Set the offset calibration DAC to x by calling the function ni54xx_SetOffsetDAC Set the following parameters sessionHandle The handle of the calibration session for the device DACValue x b Measure the outputs measurements 4 Call ni54xx_CalAdjust using the output measurements from step 3b as the measuredData ...

Page 30: ...llowing parameters sessionHandle The handle of the calibration session for the device waveType NI54XX_DC amplitudeInVolts 0 frequencyInHz 0 3 For each of the following values for x where x 8192 6144 4096 2048 0 2048 4096 6144 8191 complete the following steps a Set the gain calibration DAC to x by calling the function ni54xx_SetGainDAC Set the following parameters sessionHandle The handle of the c...

Page 31: ... corresponding input values and expected output voltage of the main DAC 1 Set the offset calibration DAC to 0 by calling the function ni54xx_SetOffsetDAC Set the following parameters sessionHandle The handle of the calibration session for the device DACValue 0 2 Set the gain calibration DAC to 0 by calling the function ni54xx_SetGainDAC Set the following parameters sessionHandle The handle of the ...

Page 32: ...utputs see Table 3 2 Call the function ni54xx_CalAdjust using the following parameters sessionHandle The handle of the calibration session for the device measurementMode NI54XX_SET_A3 actualData mainDACSweepValues measuredData mainDACSweepResults 5 Set the gain calibration DAC to 8192 by calling the function ni54xx_SetGainDAC Set the following parameters sessionHandle The handle of the calibration...

Page 33: ...d pass both measurement results to ni54xx_CalAdjust You can measure the amplitude peak to peak amplitude or RMS value as long as both measurements are the same 1 Set the offset calibration DAC to 0 by calling the function ni54xx_SetOffsetDAC Set the following parameters sessionHandle The handle of the calibration session for the device DACValue 0 2 Set the gain calibration DAC to 4079 the approxim...

Page 34: ...A7 actualData lowFrequencyAmplitude measuredData amplitudeWithAnalogFilterEnabled Determining the Low Frequency Gain of the Pre Amplification 10db Attenuator Constant A8 To determine the value of constant A8 generate a low frequency sine wave outputwiththeattenuatordisabledandmeasuretheoutputs Repeat the process with the attenuator enabled and pass both results to ni54xx_CalAdjust You can measure ...

Page 35: ...eed the measurements to ni54xx_CalAdjust The measuredData isapointertothevalueoftheoutputwiththeattenuatorenabled and the actualData is a pointer to the value of the output with the attenuator disabled Call the function ni54xx_CalAdjust using the following parameters sessionHandle The handle of the calibration session for the device measurementMode NI54XX_SET_A8 actualData lowFrequencyAmplitude me...

Page 36: ...e outputs offsetInResetState 5 Enable the analog filter by calling the function ni54xx_SetAnalogFilter Set the following parameters sessionHandle The handle of the calibration session for the device filterState NI54XX_ENABLE 6 Measure the outputs offsetWithAnalogFilterEnabled 7 Disable the analog filter by calling the function ni54xx_SetAnalogFilter Set the following parameters sessionHandle The h...

Page 37: ...st for A5 The measuredData should be an array of values with the first element being the offsetInResetState and the second element being the offsetWith10dbAttenuatorEnabled Call the function ni54xx_CalAdjust using the following parameters sessionHandle The handle of the calibration session for the device measurementMode NI54XX_SET_A5 actualData 0 or NULL measuredData see the description in step 11...

Page 38: ...s all measurements are consistent 1 Make sure the output is unterminated 2 Set the gain calibration DAC to 4079 the approximate value for a gain of 1 by calling the function ni54xx_SetGainDAC Set the following parameters sessionHandle The handle of the calibration session for the device DACValue 4079 3 Set the offset calibration DAC to 0 by calling the function ni54xx_SetOffsetDAC Set the followin...

Page 39: ... A9_UNTERMINATED actualData lowFrequencyAmplitude measuredData attenuatedAmplitudes 8 Terminate the output with a 50 Ω load and measure the remaining A9 outputs across this load 9 Disable all attenuators by calling the function ni54xx_SetAttenuation Set the following parameters sessionHandle The handle of the calibration session for the device attenuation 0 10 Measure the outputs lowFrequencyAmpli...

Page 40: ...un attenuated output lowFrequencyAmplitude Call the function ni54xx_CalAdjust using the following parameters sessionHandle The handle of the calibration session for the device measurementMode NI54XX_SET_A9TA actualData lowFrequencyAmplitude measuredData lowFrequencyAmplitudeTerminated Determining the Value of the On Board High Precision Voltage Reference This calibration constant stores the actual...

Page 41: ...yInHz 0 4 Set the calibration multiplexer to route the device output and the internal reference to the calibration ADC by calling the function ni54xx_SetCalibrationMux Set the following parameters sessionHandle The handle of the calibration session for the device muxSetting NI54XX_OUT_VS_REF 5 Read the value of the calibration ADC by calling the function ni54xx_ReadCalibrationADC Set the following...

Page 42: ...2 Enable the analog filter by calling the function ni54xx_SetAnalogFilter Set the following parameters sessionHandle The handle of the calibration session for the device filterState NI54XX_ENABLE 3 Adjust the gain and offset by calling the function ni54xx_SetAdjustedGainAndOffset rather than setting the gain and offset calibration DACs directly This function uses the current calibrationconstants i...

Page 43: ...ll ni54xx_CalAdjust for the unterminated frequency response The measuredData should be the array of output amplitudes The actualData shouldbeNULL Callthefunctionni54xx_CalAdjust using the following parameters sessionHandle The handle of the calibration session for the device measurementMode NI54XX_SET_FREQUENCY_ RESPONSE_UNTERMINATED actualData NULL measuredData frequencyResponses 8 Terminate the ...

Page 44: ...on session for the device measurementMode NI54XX_SET_FREQUENCY_ RESPONSE_TERMINATED actualData NULL measuredData frequencyResponses Determining the SYNC Duty Cycle Constants Two calibration constants D0 and D1 calculate the value written to the SYNC DAC to set a specified duty cycle on the SYNC output To determine the proper values use an iterative method by setting the SYNC DAC to the best guess ...

Page 45: ...arameters sessionHandle The handle of the calibration session for the device offsetInVolts 0 attenuationInDb 0 terminationState NI54XX_UNTERMINATED 4 Set a 50 duty cycle by calling the function ni54xx_SetDutyCycle Set the following parameters sessionHandle The handle of the calibration session for the device dutyCycle 50 5 Measure the duty cycle currentDutyCycle 6 While the measured duty cycle 50 ...

Page 46: ...ted adjusting the constant D0 D1 Constant 1 Set a 25 duty cycle by calling the function ni54xx_SetDutyCycle Set the following parameters sessionHandle The handle of the calibration session for the device dutyCycle 25 2 Measure the duty cycle currentDutyCycle 3 While the measured duty cycle 25 is larger than the tolerance a Call ni54xx_CalAdjust for D1_25 This calculates the next best guess based o...

Page 47: ...results The measuredData should be a pointer to the measured duty cycle The actualData should be a pointer to the desired duty cycle in this case 75 Call the function ni54xx_CalAdjust using the following parameters sessionHandle The handle of the calibration session for the device measurementMode NI54XX_SET_D1_75 actualData desiredDutyCycle measuredData currentDutyCycle b Try the new best guess by...

Page 48: ...54xx_CalibrateVCXO This function like ni54xx_SetDutyCycle sets the VCXO with the current best guess Next measure the output frequency If the measured frequency differs substantially from the desired frequency callni54xx_CalAdjust whichcalculatesthenext best guess value Call ni54xx_CalibrateVCXO again setting the VCXO to the new best guess and measure the frequency again Repeat this process until t...

Page 49: ...54xx_CalibrateVCXO Set the following parameters sessionHandle The handle of the calibration session for the device type NI54XX_SET_VCXO 6 Use the counter to measure the frequency of the signal on SYNC OUT currentFrequency 7 Whilethe frequency 1MHz isgreaterthanthetoleranceandwhileyou have not entered this loop more than 12 times follow these steps Note While defining your tolerance leave adequate ...

Page 50: ...M PAL video mode for NI 5431 devices only complete the following steps 1 Enable the analog filter by calling the function ni54xx_SetAnalogFilter Set the following parameters sessionHandle The handle of the calibration session for the device filterState NI5XX_ENABLE 2 Generate a full scale 10 V sine wave at 1 MHz in M PAL video mode by calling ni54xx_GenerateVideoWaveform Set the following paramete...

Page 51: ...eaterthanthetoleranceandyouhave not entered this loop more than 12 times follow these steps a Call ni54xx_CalAdjust for measurement mode NI54XX_SET_VCXO_PAL_M which calculates the next best guess VCXO DAC value The measuredData should be a pointer to the measured frequency and the actualData should be a pointer to the desired frequency 1 MHz Call the function ni54xx_CalAdjust using the following p...

Page 52: ...at 1 MHz in NTSC video mode by calling the function ni54xx_GenerateVideoWaveform Set the following parameters sessionHandle The handle of the calibration session for the device waveType NI54XX_SINE amplitudeInVolts 10 frequencyInHz 1000000 videoMode NI54XX_NTSC_M 3 Set the gain and offset by calling the function ni54xx_SetAdjustedGainAndOffset with 0 offset and 0 attenuation in the unterminated ca...

Page 53: ...C value The measuredData should be a pointer to the measured frequency and the actualData should be a pointer to the desired frequency 1 MHz Call the function ni54xx_CalAdjust using the following parameters sessionHandle The handle of the calibration session for the device measurementMode NI54XX_SET_VCXO_NTSC_M actualData desiredFrequency measuredData currentFrequency b Set the VCXO with the new b...

Page 54: ...s A0 through A8 can be calculated during an internal calibration Constants A9_Unterminated A9_Terminated and A9TA are calculated only during an external calibration Table A 1 shows the names of these constants and a brief description of each Table A 1 DC or Low Frequency Gains and Offsets of Components within the Analog Channel Constant Name Description A0 Output dependence on the cumulative offse...

Page 55: ...igh level of a signal to the total period of the signal The duty cycle of the SYNC TTL output is adjustable from 20 to 80 To set a desired duty cycle the driver software must use two calibration constants called D0 and D1 Calibrating for these constants involves iteratively converging on the proper values to achieve specified duty cycles A7 The low frequency gain of the analog filter A8 The gain o...

Page 56: ...ked to an external signal the driver must determine what value to write to the VCXO DAC that controls the voltage to the oscillator Calibrating the VCXO involves iteratively converging on the value that sets the update clock rate as near to 40 MHz as possible For the NI 5431 two additional constants are stored These constants represent the proper VCXO settings for generating phase alternation line...

Page 57: ...ons that support calibration of signal source performance by listing the calibration functions and constants for NI 54XX devices This interface provides access to the niarbcal dll and can be used to write calibration procedures for any NI 54XX device Note All functions return signed 32 bit integers corresponding to the status of the operation ...

Page 58: ...e Purpose Initiates a calibration session for the specified device Parameters Name Description device A number corresponding to the DAQ device number of the device to be calibrated password The external adjustment password This must point to a buffer of characters at least four characters long sessionHandle A pointer to the handle of the calibration session used in most other calibration functions...

Page 59: ...ased on the values of the measured and actual data Parameters Name Description sessionHandle The handle of the calibration session for the device created with a call to ni54xx_CalStart measurementMode The calibration constant s being adjusted One of the NI54XX_SET_ constants in Appendix C Function Constants actualData An array of doubles a pointer to one double or NULL depending on the measurement...

Page 60: ... action Purpose Closes the calibration session and either commits or discards the new constants that have been calculated Parameters Name Description sessionHandle A pointer to the handle of the calibration session for the device created with a call to ni54xx_CalStart action NI54XX_ABORT or NI54XX_COMMIT_CONSTANTS Using abort avoids storing the newly calculated calibration constants ...

Page 61: ...call ni54xx_CalSelfCalibrate unsigned long device Purpose Internallycalibratesthedeviceandstoresthenewcalibrationconstants Theselfcalibrationcan only determine constants A0 through A8 CalStart and CalEnd do not need to be called with this function Parameter Name Description device A number corresponding to the DAQ device number of the device to be calibrated ...

Page 62: ...r from the internal self calibration or external manual calibration area Parameters Name Description device A number corresponding to the DAQ device number of the device to be calibrated area The area internal or external from where to get the date NI54XX_INTERNAL or NI54XX_EXTERNAL month A pointer to a long integer which receives the month value day A pointer to a long integer which receives the ...

Page 63: ... count Purpose Retrieves the number of times the device has been calibrated either internally self calibration or externally manual calibration Parameters Name Description device A number corresponding to the DAQ device number of the device to be calibrated area The area internal or external from where to get the date NI54XX_INTERNAL or NI54XX_EXTERNAL count A pointer to a long integer which recei...

Page 64: ...gned long device char miscInfo Purpose Retrieves four bytes of data from the external adjustment miscellaneous data area Parameters Name Description device A number corresponding to the DAQ device number of the device to be calibrated miscInfo This should be a char pointer which points to a buffer which is at least 4 bytes long This buffer should be allocated by you ...

Page 65: ...reMiscInfo unsigned long device char miscInfo Purpose Stores four bytes of data in the external adjustment miscellaneous data area Parameters Name Description device A number corresponding to the DAQ device number of the device to be calibrated miscInfo This should be a char pointer which points to a buffer which is at least 4 bytes long This buffer should be allocated by you ...

Page 66: ...sword unsigned long device char oldPassword char newPassword Purpose Changes the password which is needed to do a full external adjustment Parameters Name Description device A number corresponding to the DAQ device number of the device to be calibrated oldPassword The currently existing password newPassword The new password which replaces the current password ...

Page 67: ...rnalConstants unsigned long device Purpose Copies the constants from the last external adjustment into the internal adjustment area thereby restoring the state of the device to that of the last external adjustment Use if an internal adjustment goes awry or produces unacceptable results Parameter Name Description device A number corresponding to the DAQ device number of the device to be calibrated ...

Page 68: ...Format __declspec dllexport long __stdcall ni54xx_DeviceReset unsigned long sessionHandle Purpose Resets the NI 54XX device and puts it in a default reset state Parameter Name Description sessionHandle The handle of the calibration session for the device created with a call to ni54xx_CalStart ...

Page 69: ...all ni54xx_SetArbOutput unsigned long sessionHandle unsigned long outputState Purpose Enables or disables the output of the device Parameters Name Description sessionHandle The handle of the calibration session for the device created with a call to ni54xx_CalStart outputState Indicates whether to enable or disable the output NI54XX_ENABLE or NI54XX_DISABLE ...

Page 70: ...alogFilter unsigned long sessionHandle unsigned long filterState Purpose Enables or disables the analog filter of the device Parameters Name Description sessionHandle The handle of the calibration session for the device created with a call to ni54xx_CalStart filterState Indicates whether to enable or disable the filter NI54XX_ENABLE or NI54XX_DISABLE ...

Page 71: ...lFilter unsigned long sessionHandle unsigned long filterState Purpose Enables or disables the digital filter of the device Parameters Name Description sessionHandle The handle of the calibration session for the device created with a call to ni54xx_CalStart filterState Indicates whether to enable or disable the filter NI54XX_ENABLE or NI54XX_DISABLE This normally should be enabled ...

Page 72: ...ts the output impedance of the device 50 or 75 ohms During calibration the impedance should never be set to 75 ohms because the terminated case assumes a 50 ohm load This requirement is true also for the NI 5431 devices Parameters Name Description sessionHandle The handle of the calibration session for the device created with a call to ni54xx_CalStart impedance The output impedance value to set NI...

Page 73: ...es the device to output a DC voltage or a sine wave with a specified amplitude and frequency Parameters Name Description sessionHandle The handle of the calibration session for the device created with a call to ni54xx_CalStart waveType The type of waveform to generate NI54XX_DC or NI54XX_SINE amplitudeInVolts The amplitude of the waveform in volts this is the amplitude into an unterminated high im...

Page 74: ...ncy Use this function only when creating a PAL or NTSC video signal for calibrating the VCXO of the NI 5431 Parameters Name Description sessionHandle The handle of the calibration session for the device created with a call to ni54xx_CalStart waveType The type of waveform to generate NI54XX_DC or NI54XX_SINE amplitudeInVolts The amplitude of the waveform in volts this is the amplitude into an unter...

Page 75: ...utyCycle Purpose Sets the duty cycle of the SYNC output of the device Note This function works when the device is generating a sine wave at full scale 10 V into an unterminated load Parameters Name Description sessionHandle The handle of the calibration session for the device created with a call to ni54xx_CalStart dutyCycle The duty cycle of the SYNC output in percentage for example for 50 duty cy...

Page 76: ...those that have been changed during the session to calculate the appropriate settings for the calibration DACs The user must also provide the termination state whether the device is unterminated high impedance load or terminated 50 ohm load Parameters Name Description sessionHandle The handle of the calibration session for the device created with a call to ni54xx_CalStart offsetInVolts The DC offs...

Page 77: ...inDAC unsigned long sessionHandle long DACValue Purpose Sets the gain calibration DAC to the specified value which affects the pre attenuation gain of the signal Parameters Name Description sessionHandle The handle of the calibration session for the device created with a call to ni54xx_CalStart DACValue The integer value to write to the gain DAC ranges from 8192 to 8191 ...

Page 78: ...ong sessionHandle long DACValue Purpose Sets the offset calibration DAC to the specified value which affects the pre attenuation offset of the signal Parameters Name Description sessionHandle The handle of the calibration session for the device created with a call to ni54xx_CalStart DACValue The integer value to write to the gain DAC which ranges from 8192 to 8191 ...

Page 79: ...g __stdcall ni54xx_SetAttenuation unsigned long sessionHandle unsigned long attenuation Purpose Sets the attenuation of the signal in dB Parameters Name Description sessionHandle The handle of the calibration session for the device created with a call to ni54xx_CalStart attenuation Amount of attenuation to apply to the signal in dB 0 1 2 4 8 10 16 32 ...

Page 80: ...value is read by a call to ReadCalibrationADC the ground vs the ground the reference vs the reference the output vs the ground or the output vs the reference You should only set to output vs reference Parameters Name Description sessionHandle The handle of the calibration session for the device created with a call to ni54xx_CalStart muxSetting The multiplexer setting NI54XX_GND_VS_GND NI54XX_REF_V...

Page 81: ...lue of the calibration analog to digital converter which holds the difference of the two inputs to the calibration multiplexer For example the output can be compared to the internal reference of the device This function returns the average of many readings of the ADC Parameters Name Description sessionHandle The handle of the calibration session for the device created with a call to ni54xx_CalStar...

Page 82: ...e The VCXO is calibrated iteratively Call this function before calibrating the VCXO because it sets many internal variables to appropriate values for the calibration Parameters Name Description sessionHandle The handle of the calibration session for the device created with a call to ni54xx_CalStart type The typeofVCXOcalibrationtobedoneNI54XX_SET_VCXO or NI54XX_SET_PAL_M for the NI 5431 ONLY or NI...

Page 83: ... function is used during calibration to iteratively converge on the best value A new value is calculated then this function is called to set the VCXO then the output is measured and then a new value is calculated and so on Parameters Name Description sessionHandle The handle of the calibration session for the device created with a call to ni54xx_CalStart type The typeofVCXOcalibrationtobedoneNI54X...

Page 84: ...54XX_STATUS_INCORRECT_PASSWORD NI54XX_STATUS_INVALID_ACTION NI54XX_STATUS_INVALID_WAVE_TYPE NI54XX_STATUS_INVALID_AMPLITUDE NI54XX_STATUS_INVALID_FREQUENCY NI54XX_STATUS_INVALID_VIDEO_MODE NI54XX_STATUS_INVALID_DUTY_CYCLE NI54XX_STATUS_INVALID_OFFSET NI54XX_STATUS_INVALID_ATTENUATION NI54XX_STATUS_INVALID_TERMINATION_STATE NI54XX_STATUS_INVALID_DAC_VALUE NI54XX_STATUS_INVALID_FILTER_STATE NI54XX_S...

Page 85: ...6 NI54XX_STATUS_UNKNOWN_ERROR Constants that are Option Parameters for the ni54xx_CalEnd Function NI54XX_ABORT NI54XX_COMMIT_CONSTANTS Constants Used as Parameters in Functions that Control the Device NI54XX_50_OHMS NI54XX_75_OHMS NI54XX_DISABLE NI54XX_ENABLE NI54XX_UNTERMINATED NI54XX_TERMINATED NI54XX_DC NI54XX_SINE NI54XX_PAL_M NI54XX_NTSC_M NI54XX_GND_VS_GND NI54XX_REF_VS_REF NI54XX_OUT_VS_GND...

Page 86: ...being adjusted NI54XX_SET_A1 NI54XX_SET_A2 NI54XX_SET_A3 NI54XX_SET_A4 NI54XX_SET_A7 NI54XX_SET_A8 NI54XX_SET_A0 NI54XX_SET_A5 NI54XX_SET_A6 NI54XX_SET_A9_UNTERMINATED NI54XX_SET_INTERNAL_REFERENCE NI54XX_SET_A9_TERMINATED NI54XX_SET_A9TA NI54XX_SET_FREQUENCY_RESPONSE_UNTERMINATED NI54XX_SET_FREQUENCY_RESPONSE_TERMINATED NI54XX_SET_D0 NI54XX_SET_D1_25 NI54XX_SET_D1_75 NI54XX_SET_D1 NI54XX_SET_VCXO...

Page 87: ...automation systems At the NI Developer Zone you can easily access the latest example programs system configurators tutorials technical news as well as a community of developers ready to share their own techniques Customer Education National Instruments provides a number of alternatives to satisfy your training needs from self paced tutorials videos and interactive CDs to instructor led hands on co...

Page 88: ...Web sites from the Worldwide Offices section of ni com Branch office Web sites provide up to date contact information support phone numbers e mail addresses and current events If you have searched the technical support resources on our Web site and still cannot find the answers you need contact your local office or National Instruments corporate Phone numbers for our worldwide offices are listed a...

Reviews: