README.TXT for
Agilent Technologies E4406A Vector Signal Analyzer (VSA)
Universal Instrument Driver (UID)
Driver Revision A.07.00
VSA E4406 Instrument Firmware Revision Supported: A.05.37
PSA E444XA Instrument Firmware Revision Supported: A.03.03
Release Date: 14 June 2002
Revision History
************************************************************
A.07.00 14 Jun 2002 Shipment Release - Complete Driver
VSA Instrument Firmware revision Supported A.05.37
PSA Instrument Firmware revision Supported A.03.03
This driver adds support for the 1xEV-DO personality. Note that
the function prefixes begin with EV_DO and use the capital
letter "O", not zero.
EV_DO Measurements
Channel Power (CHP)
Intermod (IM)
Power vs Time (PVT)
Spurious Emissions & ACP (SEM)
Occupied Bandwidth (OBW)
Code Domain Power (CDP)
Modulation Accuracy (Rho)
Error Vector Magnitude QPSK (EVMQ)
Power Stat CCDF (PST)
Other Additions:
Input Functions
hpe4406_Input_EV_DOSetConditions (new)
hpe4406_Input_EV_DOGetConditions (new)
GSM - Output RF Spectrum Measurement
hpe4406_ORFSSetMeasurementType (modified)
hpe4406_ORFSGetMeasurementType (modified)
hpe4406_ORFSSetPeakDetectionState (new)
hpe4406_ORFSGetPeakDetectionState (new)
EDGE w/GSM - Output RF Spectrum Measurement
hpe4406_EDGEORFSetMeasurementType (modified)
hpe4406_EDGEORFGetMeasurementType (modified)
hpe4406_EDGEORFSetPeakDetectionState (new)
hpe4406_EDGEORFGetPeakDetectionState (new)
cdmaOne - Adj Channel Power Ration (ACPR) Measurement
hpe4406_ACPRSetOffsetRBWs (new)
hpe4406_ACPRGetOffsetRBWs (new)
W-CDMA (3GPP) - Code Domain Power (CDP)
hpe4406_W_CDMA_CDPSetSymbolBound (modified)
hpe4406_W_CDMA_CDPGetSymbolBound (modified)
W-CDMA (3GPP) - Modulation Accuracy
hpe4406_W_CDMA_ModAccSetSymbolBound (modified)
hpe4406_W_CDMA_ModAccGetSymbolBound (modified)
hpe4406_W_CDMA_ModAccSetView (new)
hpe4406_W_CDMA_ModAccGetView (new)
W-CDMA (3GPP) - Spectrum Emission Mask (SEM)
hpe4406_W_CDMA_SEMSetRRCFilterState (new)
hpe4406_W_CDMA_SEMGetRRCFilterState (new)
hpe4406_W_CDMA_SEMSetRRCFilterAlpha (new)
hpe4406_W_CDMA_SEMSetRRCFilterAlpha (new)
CDMA2000 - Modulation Accuracy
hpe4406_CDMA2K_ModAccSetView (new)
hpe4406_CDMA2K_ModAccGetView (new)
Marker Functions
Modified all functions to add support
for 1xEV-DO measurements
Calculation Functions
hpe4406_TestCurrentLimitsResults (new )
Input Functions
hpe4406_Input_SetIntPreampState (new)
hpe4406_Input_GetIntPreampState (new)
hpe4406_Input_SetIntPreampAtten (new)
hpe4406_Input_SetIntPreampAtten (new)
Comments:
The hpe4406.c file is currently over 65k lines in length.
A bug in Visual C++ prevents the debugging of code beyond
line 65534. This problem does not seem to occur when
debugging in other environments. One way around this
problem would be to split the hpe4406.c file into two
parts and at the end of the first file, add the statement
#include "hpe4406-part2.c", replacing hpe4406-part2.c
with the name given to the second file.
Use the E4406.exe file to install the driver, not
the floppy disk images as they are incomplete.
The driver now has 3 .bas files:
hpe4406_1.bas
hpe4406_2.bas
hpe4406_3.bas
A.06.00 11 Jan 2002 Shipment Release - Complete Driver
Instrument Firmware Supported:
VSA E4406 revision A.05.35
PSA E444XA revision A.02.04
Driver now works on the PSA instrument family for all
application modes except Spectrum Analyzer.
When changing instrument modes on the PSA instrument family,
the driver's timeout value may need to be increased by using
utility function hpe4406_timeOut().
W-CDMA (Trial and Arib) is no longer supported by the driver.
For faster data transfers, all measure trace functions use
binary data transfer with byte-swapping performed by the
instrument. NOTE: If using a operating system such as UNIX
that does not require byte-swapping, modify the passthrough
function hpe4406_cmdReal64BoardSwapArr_Q by removing the
":FORM:BORD SWAP" command.
Driver function hpe4406_EnableVerification is enabled by default.
This is a useful feature during development as it verifies the
instrument is in the proper mode, but program execution will
be faster if it is turned off.
This driver adds support for:
BBIQ
All Measurements
1 new INIT function for each measurement
BASIC Applications
ACP - 2 new functions for Fast ACP
GSM and EDGE w/GSM Applications
Non Measurement Specific - 2 new functions
GSM Power vs Time (PVT) - 2 new functions
GSM Output RF Spectrum (ORFS) - 2 new functions
EDGE Power vs Time (EDGEPVT)
EDGE Output RF Spectrum (EDGEORF)
EDGE Transmit Band Spur (EDGETSP)
cdmaOne Applications
Adj Channel Power Ratio - 2 new functions for Fast ACP
W_CDMA (3GPP)Applications
Adj Channel Power Ratio (ACP) - 2 new functions
Code Domain Power (CDP) - 14 new functions
Modulation Accuracy (ModAcc) - 10 new functions
Spectrum Emission Mask (SEM) - 2 new functions
CDMA 2000 Applications
Modulation Accuracy (RHO) - 6 new functions
Spectrum Emission Mask (SEM) - 2 new functions
Code Domain Power (CDP) - 6 new functions
Non-Application Specific
Spectrum - 4 new functions
Waveform - 4 new functions
Marker Functions - 1 new function
Input Functions - 8 new functions
Calculation Functions - 1 new function
Calibrate Functions - 1 new function
Display Functions - 4 new functions
Remote Functions - 2 new functions
Utility Functions - 1 new function
Passthrough Functions - 1 new function
A.05.00 11 Dec 2000 Shipment Release - Complete Driver
Instrument Firmware revision Supported A.04.21
This driver adds support for:
Basic Application functions
Power Stat(CCDF)
GSM Application functions
All previous GSM functions now support EDGE wGSM
EDGE EVM (EDGEEVM) supports EDGE wGSM only
cdmaOne functions
Adjacent Channel Power Ration (ACPR) - 4 new functions
W_CDMA functions
All previous W_CDMA functions now support both
W-CDMA (Trial & Arb) and W-CDMA (3GPP) modes.
Code Domain Power (CDP) - 8 new functions
Modulation Accuracy (ModAcc) - 6 new functions
Intermod (IM) - W-CDMA (3GPP) only
Multi Carrier Power (MCP) - W-CDMA (3GPP) only
Spectrum Emission Mask (SEM) - W-CDMA (3GPP) only
Occupied BW (OBW) - W-CDMA (3GPP) only
CDMA2000 functions
Modulation Accuracy (ModAcc) - 4 new functions
Intermod (IM)
Spectrum Emission Mask (SEM)
Occupied BW (OBW)
Code Domain Power (CDP)
NOTE: As of driver version A.05.00, the .BAS file is too large to
be compiled in Visual Basic without encountering "ERROR 7 Out of
Memory". Therefore it has now been split into two sections, each of
which must be included in the Visual Basic project:
hpe4406_1.bas
hpe4406_2.bas
NOTE: The functions hpe4406_cdmaOneACPRSetDynamicRange and
hpe4406_cdmaOneACPRSetDynamicRange do not work at this time.
The SCPI commands are not implemented in firmware version A.04.21,
but may be added in a future release.
NOTE: Intermod markers do not work at this time.
The SCPI commands are not implemented in firmware version A.04.21,
but may be added in a future release.
A.04.00 31 Mar 2000 Shipment Release - Complete Driver
Instrument Firmware revision Supported A.03.30
This driver adds support for
W_CDMA functions
Channel Power (CHP)
Adjacent Channel Power Ratio (ACPR)
CCDF Measurements
Code Domain Power (CDP)
Error Vector Magnitude QPSK (EVMQPSK)
Modulation Accuracy (ModAcc)
CDMA2K functions
Channel Power (CHP)
Adjacent Channel Power Ratio (ACPR)
CCDF Measurements
Error Vector Magnitude QPSK (EVMQPSK)
Modulation Accuracy (ModAcc)
Other additions:
The function tree has been rearranged to
provide a more organized function grouping.
A.03.01 26 Jan 2000 Shipment Release - Complete Driver
Instrument Firmware Revision Supported: A.03.26
This driver adds additional help scripts.
A.03.00 22 Dec 1999 Shipment Release - Complete Driver
Instrument Firmware Revision Supported: A.03.26
This driver adds support for:
GSM (Proxima)
Transmit Spur (TSP)
Power vs Time (PVT)
BASIC
Channel Power (CHP)
Adjacent Channel Power (ACP)
cdmaOne
Adjacent Channel Power (ACP)
Additional Mode Controls
No new example programs are included in this release.
Although there are driver functions and function panels for the
Functions listed below, they are not to be considered part of this
release and have not been through QA testing and acceptance.
- hpe4406_Radio_W_CDMASetConditions()
- hpe4406_Radio_W_CDMAGetConditions()
- hpe4406_Radio_CDMA2KSetConditions()
- hpe4406_Radio_CDMA2KGetConditions()
- hpe4406_Input_W_CDMASetConditions()
- hpe4406_Input_W_CDMAGetConditions()
- hpe4406_Input_CDMA2KSetConditions()
- hpe4406_Input_CDMA2KGetConditions()
A.02.00 22 Sept 1999 Shipment Release - Complete Driver
Instrument Firmware Revision Supported: A.02.11
This driver adds support for PDC and NADC measurement types:
Adjacent Channel Power (ACP)
Error Vector Magnitude (EVM)
Occupied Bandwidth (OBW)
Example programs are included in this release.
A.01.03 19 May 1999 Shipment Release - Complete Driver
This driver fixes a LabWindows/CVI checksum bug
that prevents the Borland hpe4406.lib from being accessed.
Also, the driver now accommodates differences between the
between the HP and National Instruments VISA libraries.
Otherwise, it is identical to version A.01.02 in functionality.
A.01.02 31 Mar 1999 Shipment Release - Complete Driver
This driver adds support for GSM measurement types:
Transmit Power (TXP)
Power vs. Time (PVT)
Phase & Frequency (PFER)
Output RF Spectrum (ORFS)
The hpe4406.hlp and hpe4406.bas are included.
Example programs are not included in this release.
A.01.01 18 Feb 1999 Beta Release 2 - Partial Driver
This driver only supports the following measurement
types for the Basic and cdmaOne modes:
Channel Power (CHP)
Modulation Accuracy (RHO)
Code Domain Power (CDP)
Close Spurs Power (CSP)
Adjacent Channel Power Ratio (ACPR)
Spectrum (Frequency Domain)
Waveform (Time Domain)
Files not included are the following:
hpe4406.hlp
hpe4406.bas
Refer to the hpe4406.h and E4406A Device Support
Document (DSD) for details on driver functionality.
This driver has been tested only in the following:
Microsoft Visual C++ 5.0
National Instruments LabWindows/CVI
National Instruments LabVIEW
A.01.00 15 Dec 1998 Beta Release - Partial Driver
This driver only supports "Spectrum" measurements
for the "Basic" and "cdmaOne" modes.
Files not included are the following:
hpe4406.hlp
hpe4406.bas
Refer to the hpe4406.h and E4406A Device Support
Document (DSD) for details on driver functionality.
This driver has been tested only in the following:
Microsoft Visual C++ 5.0
National Instruments LabWindows/CVI
National Instruments LabVIEW
-----------------------------------------------------------------------
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 E4406 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) 4.0.1 (& higher)
4.0 Known Defects
There are no known defects in the Agilent hpe4406 driver.
5.0 Online Information
-----------------------------------------------------------------------
1.0 Introduction
The help file included with the Agilent Technologies E4406 UID
contains instrument and programming information. This readme
file contains additional information concerning the driver.
The Agilent E4406 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 E4406 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 E4406 since it is not a VXI instrument.
First, there is no soft front panel, as the E4406 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 HP 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 an 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 E4406 UID in Application Development
Environments
For general instructions on using the driver with HP 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) 4.0.1 (& higher)
The Agilent Technologies E4406 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 hpe4406.fp in your project.
This file can be found in vxipnpwin95hpe4406. Do not
include hpe4406.c in your project. You must also provide
an include path for hpe4406.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 Technologies E4406 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.