***********************
**** Read Me First ****
***********************
March 31, 2003
1.1.1.1
The Agilent IVI-COM Driver for the 5462X and 5464X series of Oscilloscopes
-------------------------------------------------------------
This instrument driver provides access to the functionality of the
5462X and 5464X families of Oscilloscopes 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, National Instruments LabView, National Instruments
LabWindows, and others.
Supported Instruments
---------------------
54621A, 54621D, 54622A, 54622D, 54624A, 54641A, 54641D, 54642A, 54642D
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.0.4.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.agilent.com/find/ADN
or
http://www.ivifoundation.org
If the driver installer exhibits problems with installing the IVI
Shared Components, find 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/release.asp?ReleaseID=37176
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/release.asp?ReleaseID=33071
MS Windows Script
Typically wscript.exe is installed as part of the OS or with Internet
Explorer. If you see an error about wscript.exe, you need to install
the Windows Script.
Download from:
http://msdn.microsoft.com/downloads/default.asp?url=/downloads/sample.asp?url=/MSDN-FILES/027/001/733/msdncompositedoc.xml&frame=true
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/visacomforivicom
If you are using Agilent Technologies' VISA COM, use version
2.2.2.5 or later.
I/O
If you are using Agilent Technologies I/O libraries, use version
M.02.01 or later.
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 must be installed into the global assembly cache, GAC. If
you have just the framework installed and not Visual Studio, you
must drag and drop the PIAs into the gac. In ...\IVI\Bin\Primary
Interop Assemblies, select all the files which end in
Lib.dll. Drag them into \<windows>\assembly. The value <windows>
depends on your OS. It is something like WINNT, WIN98, or WINDOWS.
If you have Visual Studio installed, two batch files perform these
operations. One is installed with the Agilent shared components
in:
<drive>:\Program Files\IVI\Drivers\AgShared\IviDotNet.bat
The other is installed with the driver in:
<drive>:\Program Files\IVI\Drivers\AgilentRfSigGen\DotNet.bat
If you have already installed Agilent T&M Toolkit, the IVI primary
interop assemblies are already properly installed and
registered. In that case, run just DotNet.bat. Otherwise, you must
run both batch files. Run IviDotNet.bat in AgShared first.
Start Menu Help File
--------------------
A shortcut to the driver help file is added to the Start Menu, Programs,
IVI, AgilentSa 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 distibuted as an MSI 2.0
file. You can install the driver by double-clicking on the
file. This operation actually runs:
msiexec /i AgilentSa.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.
Known Issues
------------
This driver does not have any known defects.
Revision History
----------------
Version Date Notes
------- ---- -----
1.1.1.1 March 31 2003 Fix errors in the help file links. No changes in
the driver (Agilent546XX.dll).
1.1.1.1 March 24 2003 Fix error in the Measurement.FetchWaveform and
FetchWaveformMeasurement methods. The value for
the IO timeout was being set incorrectly and
caused problems using a gpib-pci card. Corrected
to use the system IO timeout value, see the
System.TimeoutMilliseconds property.
1.1.1.0 March 14 2003 Fix enum values for trigger coupling and type,
tv trigger event & signal format to comform
to the Ivi Scope spec.
Note: Install package 1.1.1.0.1 was not built
correctly and did not include these changes.
1.1.0.0 March 11 2003 Fix enum values for measFunction to match those
in the scope driver class.
1.0.1.0 March 06 2003 Initial release
IVI Shared Component Revisions
------------------------------
1.3.1.0 IviConfigServer.dll
1.0.2.0 IviConfigServerCAPI.dll
1.0.237.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.0.4.0 IviSharedComponentVersion.dll
1.0.0.0 IviSpecAnTypeLib.dll
3.0.0.0 IviSwtchTypeLib.dll
IVI Compliance
--------------
(The following information is required by IVI 3.1 section 5.21.)
IVI-COM IviScope Specific Instrument Driver
IVI Instrument Class: IviSpecScope 4.1
Group Capabilities:IviScopeBase,IviScopeInterpolation,IviScopeTVTrigger,
IviScopeGlitchTrigger,IviScopeWidthTrigger,IviScopeAcLineTrigger,
IviScopeEaveformMeas,IviScopeMinMaxWaveform,IviScopeProbeAutoSense,
IviScopeContinuousAcquistion,IviScopeAverageAcquisition,IviScopeAutoSetup,
IviScopeTriggerModifier,IviScopeSampleMode
Optional Features: This driver does no support Interchangeability
Checking, State Caching, or Coercion Recording.
Driver Identification:
(These three strings are values of properties in the IIviIdentity
interface.)
Vendor: Agilent Technologies
Description: IVI-COM Driver fpr Agilent 546XX Oscilloscope
Revision: 1.0
Component Identifier: Agilent546XX.Agilent546XX
(The component identifier can be used to create an instance of the COM
server.)
Hardware: This driver supports instruments manufactured by Agilent
Technologies. The supported model numbers are:
54621A, 54621D, 54622A, 54622D, 54624A, 54641A, 54641D, 54642A, 54642D
This driver supports communicating with the instrument using either
GPIB 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/contacts00 (two zeros at the end)
Trademarks
----------
Microsoft, Visual Basic, Visual C++, and Windows Installer are either
registered trademarks or trademarks of Microsoft Corporation in the
United States and/or other countries.
LabVIEW and LabWindows are trademarks of National Instruments
Corporation.