README.TXT for
Agilent Technologies E444XA PSA Series Spectrum Analyzer
Universal Instrument Driver (UID)
Driver Revision A.02.00
PSA Instrument Firmware Revision Supported: A.03.04
ESA Instrument Firmware Revision Supported: A.09.00
24 Sep 2002
---------------------------------------------------------------
Revision History
A.02.00 24 Sep 2002 - Complete Driver
PSA Instrument Firmware Revision Supported: A.03.04
ESA Instrument Firmware Revision Supported: A.09.00
Support for the ESA series has been added to the age444xa_init
function and is compatible with the spectrum analysis measurement
functions.
This driver adds new support for:
Spectrum Analyzer Mode
Radio Setup
Burst Power Measurements
Multi-Carrier Power Measurements
CCDF Measurements
Third Order Intercept Measurements
Spurious Emission Measurements
Spectrum Emission Mask Measurements
Option 226 Phase Noise Personality
Option 1DS 500 kHz to 3 GHz Preamplifier
Additional support has been added for:
Spectrum Analyzer Mode
Adjacent Power Measurements
Channel Power Measurements
Occupied Bandwidth Measurements
Harmonic Distortion Measurements
Spectrum Analyzer Control
Amplitude Control
Bandwidth Control
Display Control
Frequency Control
Marker Control
Sweep Control
Trace Math Control
System Control
Utility Functions
The following driver functions are no longer supported as of
firmware version A.03.00:
Emission Bandwidth Measurements
The following functions have been modified or updated:
age444xa_measureSetMode
age444xa_measureGetMode
age444xa_ACPConfig (renamed age444xa_SA_ACPConfig)
age444xa_ACPConfigQuery (renamed age444xa_ACPConfigQuery
age444xa_ACPMeasure (renamed age444xa_SA_ACPMeasure)
age444xa_CHPConfig (renamed age444xa_SA_CHPConfig)
age444xa_CHPConfigQuery (renamed age444xa_CHPConfigQuery
age444xa_CHPMeasure (renamed age444xa_SA_CHPMeasure)
age444xa_OBWConfig (renamed age444xa_SA_OBWConfig)
age444xa_OBWConfigQuery (renamed age444xa_OBWConfigQuery
age444xa_OBWMeasure (renamed age444xa_SA_OBWMeasure)
age444xa_HarmonicDistConfig
(renamed age444xa_SA_HarmDistConfig)
age444xa_HarmonicDistConfigQuery
(renamed age444xa_HarmDistConfigQuery
age444xa_HarmonicDistMeasure (
renamed age444xa_SA_HarmDistMeasure)
age444xa_instrumentSetApplication
age444xa_instrumentGetApplication
age444xa_detectorSetMode
age444xa_detectorGetMode
age444xa_freqCounterSetResolution
age444xa_freqCounterGetResolution
age444xa_freqCounterSetResolutionAuto
age444xa_markerSetMode
age444xa_triggerSetSlope
age444xa_triggerGetSlope
age444xa_self_test
age444xa_reset
age444xa_option_query
age444xa_self_test
age444xa_timeOut
The following functions have been removed:
age444xa_ACPMeasure (replaced by age444xa_SA_ACPMeasureTrace)
age444xa_traceDoMath
Note: Enumeration names for the spectrum analyzer measurement
functions have been modified.
Note: National Instruments VISA 2.6 contains a bug
which will prevent parts of the driver from operating correctly.
If using this version of VISA, you must download the software
patch which replaces the visa32.dll located in your Windows
system directory. The driver will then work correctly.
A.01.00 26 Feb 2001 - Shipment Release - Complete Driver
Instrument Firmware Revision Supported: A.01.06
This driver adds support for:
Spectrum Analyzer Mode
Measurement Selection Functions
ACP Measurement Functions
Channel Power Functions (CHP)
Occupied BW Functions (OBW)
Emission BW Functions (EBW)
Harmonic Dist Functions (harmonicDist)
Spectrum Analyzer Control
Amplitude Control Functions
Bandwidth Control Functions
Calibration Alignment Functions
Detector Control Functions
Display Control Functions
Frequency Control Functions
Freq Counter Control Functions
Input Control Functions
Marker Control Functions
Sweep Control Functions
Trace Control Functions
Trace Math Control Functions
Trigger Control Functions
System Control Functions
Utility and Passthrough Functions
-----------------------------------------------------------------------
Contents:
1.0 Introduction
2.0 VTL/VISA Specific Information
2.1 Instrument Addresses
2.2 Language Specific Features
3.0 Using the Agilent Technologies E444XA UID in Application Development
Environments
3.1 Microsoft Visual C++ 6.0 (& higher)
and Borland C++ 4.5 (& higher)
3.2 Microsoft Visual Basic 6.0 (& higher)
3.3 LabWindows CVI/(R) 5.5 (& higher)
4.0 Known Defects
5.0 Online Information
-----------------------------------------------------------------------
1.0 Introduction
The help file included with the Agilent Technologies E444XA UID
contains instrument and programming information. This readme
file contains additional information concerning the driver.
The Agilent E444XA Windows 95 and Windows NT drivers are
actually a single 32-bit driver. All of the directory
paths which follow assume Windows 95. For Windows NT,
change references from win95 to WINNT.
This Agilent E444XA driver conforms to all portions of the
VXIplug&play driver standard which are applicable to
conventional GPIB. Two elements of the standard do not
apply to the E444XA since it is not a VXI instrument.
First, there is no soft front panel, as the E444XA can be
controlled from its hardware front panel. Second, there
is no knowledge base file, which is primarily a description
of a VXI board.
This driver features:
1. Conformance with the VXIplug&play standard. The
only exceptions are that it does not have a soft
front panel or a knowledge base file.
2. It is built on top of, and uses the services provided
by VISA. VISA supports GPIB and VXI protocols. The
driver can be used with any GPIB card for which the
manufacturer has provided a VISA DLL.
3. It includes a "Function Panel" (.fp) file which allows
it to be used with visual programming environments
such as Agilent VEE, LabWindows, and LabVIEW.
4. It includes a comprehensive on-line help file which
complements the instrument manual. The help file
presents application programming examples, a
cross-reference between instrument commands and
driver functions, and detailed documentation of each
function, with examples.
5. Source is included so that the driver can be modified
if desired. The source conforms to VXI Plug & Play
standards. Modifications should only be done by
people who are familiar with the VXIplug&play
standard.
6. It includes a Visual Basic include file (.bas) which
contains the function calls in Visual Basic syntax, so
that driver functions can be called from Visual Basic.
If you use Visual Basic with this driver, you should be
familiar with C/C++ function declarations. In particular,
care must be taken when working with C/C++ pointers.
-----------------------------------------------------------------------
2.0 VISA Specific Information
The following topics refer to instances when the driver is
used with different versions of VISA.
2.1 Instrument Addresses
When using Agilent Technologies UID, instrument
addresses must be all uppercase letters. Implementation of
the addressing scheme is vendor specific and some
vendors support mixed cases. However, for maximum
portability, the instrument address should use uppercase
characters only.
For example: use "GPIB0::18" instead of "gpib0::18"
2.2 Language Specific Features
Language Specific features are not supported with this
driver.
-----------------------------------------------------------------------
3.0 Using the Agilent Technologies E444XA UID in Application Development
Environments
For general instructions on using the driver with Agilent VEE,
Microsoft Visual C++, Borland C++, Microsoft Visual Basic,
LabVIEW, and LabWindows/CVI, see the online help file.
Additional notes:
3.1 Microsoft Visual C++ 6.0 (& higher) and
Borland C++ 4.5 (& higher)
1. The driver uses Pascal calling conventions.
2. Do not build the driver in the directory in which
it was installed.
3.2 Microsoft Visual Basic 6.0 (& higher)
Refer to the Microsoft Visual BASIC manual for additional
information on calling DLLs.
3.3 LabWindows CVI/(R) 5.5 (& higher)
The Agilent Technologies E444XA driver is supplied as both a source code file
and as a dynamic link library file (dll). There are
several advantages to using the dll form of the driver.
These include:
1. Transportability across different computer
platforms
2. A higher level of support from Agilent for
the compiled driver
3. Faster load time for your project
LabWindows/CVI (R) by default will attempt to load the
source version of the instrument driver. To load the dll
you must include the file age444xa.fp in your project.
This file can be found in vxipnpwin95age444xa. Do not
include age444xa.c in your project. You must also provide
an include path for age444xa.h. This is done by adding
vxipnpwin95include to the include paths (CVI Project
Option menu).
-----------------------------------------------------------------------
4.0 Known Defects
There are no known defects in the Agilent E444XA driver.
------------------------------------------------------------------------
5.0 Online Information
The latest copy of this instrument driver and other Agilent instrument
drivers are available at the Agilent Technologies customer WWW site:
http://www.agilent.com/find/inst_drivers
If you do not have Internet access, the drivers can be obtained by
contacting your country support organization. In the US, the phone
number is 800-452-4844. A list of contact information for other
countries is available on the Access Agilent Technologies website:
http://www.agilent.com/find/assist
-----------------------------------------------------------------------
LabWindows/CVI is a registered trademark of National
Instruments.