***********************
**** Read Me First ****
***********************
Version 1.0.0.16
November 17, 2004
Introducing the Agilent IVI-COM Driver for the 8113x series of Pattern
Generators
-------------------------------------------------------------
This instrument driver provides access to the functionality of the
8113x families of Pattern Generators through a COM server which
also complies with the IVI specifications. The driver works in any
development environment which supports COM programming including
Microsoft® Visual Basic, Microsoft Visual C++, Microsoft .NET,
Agilent VEE Pro, National Instruments LabView, National Instruments
LabWindows, and others.
Supported Instruments
---------------------
81133, 81134
Installation
------------
System Requirements - The driver installation will check for the
following requirements. If not found, the installer will either
abort, warn, or install the required component as appropriate.
Supported Operating Systems:
Windows® 98
Windows Me
Windows NT® 4.0 (SP6 or later)
Windows 2000
Windows XP
Windows Installer:
Version 2.0 or later. The IVISharedComponents.exe program will
install Version 2.0 of the Windows Installer.
It is also available from:
For Win98/Me:
http://www.microsoft.com/downloads/release.asp?ReleaseID=32831
For WinNt4/2000/XP:
http://www.microsoft.com/downloads/release.asp?ReleaseID=32832
IVI Shared Components version 1.1.3.0 or later.
The driver installer calls an installer for these components if
they are not already present on the system. The installer,
IviShareComponents.msi, must be in the same directory as the msi
file for this driver.
The IVI Shared Components installer is available from:
http://www.ivifoundation.org/Downloads/SharedComponents.htm
If the driver installer exhibits problems with installing the IVI
Shared Components, find the latest version of the program
IviShareComponents.exe on one of the above sources. Run this
program. It is able to install many of the required system
components, including Windows Installer 2.0.
Microsoft XML 4.0
The Configuration Server, an IVI share component, uses Microsoft's
XML 4.0 parser. The IVI Shared Components will install the XML 4.0
parser. You can download the parser and its associated SDK from:
http://microsoft.com/downloads
Enter "xml 4.0" as keywords.
Microsoft HTML Help Viewer (Win98, WinNT) Version 1.32 or later
The driver will install without the help viewer, but you will not be
able to use the help file for the driver. You can download the help
viewer from:
http://microsoft.com/downloads
Enter "html help workshop" as keywords
MS Windows® Script
Typically, wscript.exe is installed as part of the operating system
or with Internet Explorer. If you see an error about wscript.exe, you
need to install Windows Script.
Download from:
http://msdn.microsoft.com/downloads
Enter "windows script" as keywords.
Use the one appropriate for your operating system.
VISA COM
Any compliant implementation is acceptable. Typically, VISA COM is
installed with VISA and other I/O library modules.
The method of simulation supported by this driver is accessed
through a feature found only in Agilent's implementation of
VISA. Agilent's VISA is available at:
http://www.agilent.com/find/iolibsforivicom
If you are using Agilent Technologies' VISA COM, use version
2.2.2.5 or later. The latest version of Agilent's IO
Libraries includes the required version of VISA-COM.
I/O
If you are using Agilent Technologies IO Libraries, use version
M.01.04 or later. You can download the latest version from:
http://www.agilent.com/find/iolibsforivicom
If you are using National Instruments I/O libraries, use NI-VISA
version 2.6.0 or later and NI-488.2 version 1.70 or later.
Additional Setup
----------------
.NET Framework
The .NET Framework itself is not required by this driver. If you
plan to use the driver with .NET, Service Pack 2 is required.
Download from:
http://msdn.microsoft.com/netframework/downloads/updates/sp/default.asp
The .NET Framework requires an interop assembly for a COM
server. A Primary Interop Assembly, along with an XML file for
IntelliSense is installed with the driver. The driver's PIA, along
with IVI PIAs are installed, by default, in:
<drive>:\Program Files\IVI\Bin\Primary Interop Assemblies
The PIA is also installed into the Global Assembly Cache (GAC) if
you have the .NET framework installed.
If you install the .NET framework later, you can use the file:
<drive>:\Program Files\IVI\Drivers\<your driver>\DotNet.bat
to put the driver's PIA into the GAC and properly register it.
Start Menu Help File
--------------------
A shortcut to the driver help file is added to the Start Menu, Programs,
IVI, Agilent8113x group. It contains "Getting Started" information on
using the driver in a variety of programming environments as well as
documentation on IVI and driver specific methods and properties.
Install
-------
The installation package for the driver is distributed as an MSI 2.0
file. You can install the driver by double-clicking on the
file. This operation actually runs:
msiexec /i Agilent8113x.msi
You can run msiexec from a command prompt and utilize its many
command line options. There are no public properties which can be
set from the command line. You can also install this driver from
another installation package.
Uninstall
---------
This driver can be uninstalled like any other software from the
Control Panel using "Add or Remove Programs".
If the IVI PIAs are installed, use "Add or Remove Programs" to
remove them.
To completely remove IVI components from your computer, uninstall
all drivers then run the IVI Cleanup Utility. This utility is
available from the same location as the IVI Shared Components
Installer. This utility does not remove any IVI drivers.
Using a New Version of the Driver
---------------------------------
Each version of the Agilent 8113x IVI-COM driver will have a new
ProgId.
If you use the version dependent ProgId in CoCreateInstance,
you will need to modify and recompile your code to use the
new ProgID once you upgrade to the next version of the driver.
Doing a side-by-side installation of the driver to use multiple
versions of the driver is not supported. If you need to go back
to an older version of the driver, you need to uninstall the later
version and install the older version.
If you use the version independent ProgId in CoCreateInstance,
you will not need to modify and recompile your code. The new
version of the driver has been tested to be backwards compatible
with previous versions.
To access the new applications in the new version of the driver
you will need to use latest numbered IAgilent8113x[n]
interface rather than the IAgilent8113x interface. The
IAgilent8113x[n].Application property will return a pointer
to the new IAgilent8113xApplication[n] interface. The
IAgilent8113xApplication[n] interface contains the properties
for the new applications. The new interfaces were introduced
rather than modifying the existing interfaces for backwards
compatibility. The interfaces that were previously shipped have
not been changed.
Known Issues
------------
The examples included contain a VS7 solution and a VS6 project.
They were developed using W2K and source control. Importing them to
different programming environments may require some minor modifications.
Revision History
----------------
Version Date Notes
------- ---- -----
1.0.0.16 17 Nov 2004 Updated installer, added VISA-COM 3.0 PIA
1.0.0.15 10 Aug 2004 Initial release
IVI Shared Component Revisions
------------------------------
1.3.2.4 IviConfigServer.dll
1.0.7.0 IviConfigServerCAPI.dll
1.1.0.0 IviCShared.dll
1.0.237.0 IviCSharedSupport.dll
2.0.0.0 IviDCPwrTypeLib.dll
3.0.0.0 IviDmmTypeLib.dll
1.0.0.0 IviDriverTypeLib.dll
1.1.1.0 IviEventServer.exe
1.1.1.0 IviEventServerDLL.dll
1.1.1.0 IviEventServerDLLps.dll
1.1.1.0 IviEventServerps.dll
3.0.0.0 IviFgenTypeLib.dll
1.0.236.0 IviFloat.dll
1.0.0.0 IviPwrMeterTypeLib.dll
1.1.0.0 IviRfSigGenTypeLib.dll
3.0.0.0 IviScopeTypeLib.dll
1.0.1.0 IviSessionFactory.dll
1.1.3.0 IviSharedComponentVersion.dll
1.0.0.0 IviSpecAnTypeLib.dll
3.0.0.0 IviSwtchTypeLib.dll
IVI Compliance
--------------
IVI-COM AgilentPG Specific Instrument Driver
Agilent Instrument Class: AgilentPG 1.0
Group Capabilities:
Driver Identification: Agilent8113x
Vendor: Agilent Technologies
Description: IVI COM Driver for Agilent 8113x Pattern Generator
Revision: 1.0
Component Identifier: Agilent8113x.Agilent8113x
Hardware: This driver supports instruments manufactured by Agilent
Technologies. The supported model numbers are:
81133, 81134
This driver supports communicating with the instrument using either
GPIB, USB or LAN.
Software: See the section on installation in this document for
information on what other software is required by this driver.
Source for this driver is not available.
More Information
----------------
For more information about this driver and other instrument drivers
and software available from Agilent Technologies visit:
http://www.agilent.com/find/ADN
A list of contact information is available from:
http://www.agilent.com/find/assist
Microsoft, Windows, MS Windows, and Windows NT are U.S.
registered trademarks of Microsoft Corporation.
© Copyright 2004 Agilent Technologies, Inc.