*********************** **** Read Me First **** *********************** Version 1.3.22.0 Sep 2012 Introducing the Agilent IVI-COM Driver for Agilent546XX ------------------------------------------------------- The instrument driver provides access to the functionality of 546XX family of Oscilloscopes through a COM server or ANSI C API which also complies with the IVI specifications. This driver works in any development environment which supports COM or C programming including Microsoft® Visual Basic, Microsoft Visual C++, Microsoft .NET, Agilent VEE Pro, National Instruments LabView, National Instruments LabWindows/CVI, and others. Supported Instruments --------------------- MSO6102A,DSO6102A,MSO6104A,DSO6104A,MSO6052A,DSO6052A,MSO6054A,DSO6054A,MSO6032A, DSO6032A,MSO6034A,DSO6034A,MSO6012A,DSO6012A,MSO6014A,DSO6014A,DSO6104L,DSO6054L, DSO6034L,DSO6014L,54621A,54621D,54622A,54622D,54624A,54641A,54641D,54642A,54642D, DSO5054A,DSO5052A,DSO5034A,DSO5032A,DSO5014A,DSO5012A,DSO7032A,DSO7052A,DSO7102A, DSO7034A,DSO7054A,DSO7104A,MSO7032A,MSO7052A,MSO7102A,MSO7034A,MSO7054A,MSO7104A, DSO7012A,MSO7012A,DSO7014A,MSO7014A,DSO7104B,DSO7012B,DSO7034B,DSO7032B,DSO7054B, DSO7052B,DSO7014B,MSO7014B,MSO7012B,MSO7032B,MSO7034B,MSO7052B,MSO7054B,MSO7104B 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 XP Windows Vista (32 bit) Win7 (32 bit) Disc Space: IVI Shared Components: 8.4 Mb Driver: 4.66MB The shared components must be installed before any drivers. Shared Components: Before this driver can be installed, your computer must already have several components already installed. The easiest way to to install these other components is by running the IVI Shared Components installation package available from the IVI Foundation as noted below. It installs all the items mentioned below. IVI Shared Components version 1.5.0.0 or later. The driver installer requires these components. They must be installed before the driver installer can install the driver. The IVI Shared Components installer is available from: http://www.ivifoundation.org/Downloads/SharedComponents.htm To install, open or run the file: IviSharedComponents.msi If the driver installer exhibits problems with installing the IVI Shared Components, find the program IviSharedComponents.msi and Run the program. It is able to install many of the required system components, including Windows Installer 2.0. 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: http://microsoft.com/downloads Enter "windows installer" as keywords. Use the one appropriate for your Operating System. Microsoft XML 4.0 The Configuration Server, an IVI Shared 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 the 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 latest version of Agilent's IO Libraries is recommended and includes VISA-COM. I/O Libraries The latest version of Agilent IO Libraries Suite,15.0 is recommended. 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 3.0.1 or later and NI-488.2 version 2.2 or later. Note: Driver may operate without any I/O software in simulation mode. 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: :\Program Files\IVI Foundation\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 run the driver installer again 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, Agilent IVI Drivers, Agilent546XX group. It contains "Getting Started" information on using the driver in a variety of programming environments as well as documentation on IVI and instrument specific methods and properties. You will also see shortcuts to the Readme file and any programming examples for this driver. MSI Installer ------------- 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 Agilent546XX.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". The IVI Shared Components may also be uninstalled like any other software from the Control Panel using "Add or Remove Programs". Note: All IVI-COM drivers require the IVI Shared Components to function. To completely remove IVI components from your computer, uninstall all drivers and then uninstall the IVI Shared Components. Source Code ----------- Driver source code is available by choosing "Custom" and selecting "Source Code" when installing the driver. This code is provided as is for informational purposes only. Modification of this code is not supported. Using a New Version of the Driver --------------------------------- New versions of this Agilent IVI-COM driver may 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 functionality in a new version of the driver you will need to use the latest numbered IAgilent546XX[n] interface rather than the IAgilent546XX interface. The IAgilent546XX[n].[Interface] property will return a pointer to the new IAgilent546XX[n] interface. The IAgilent546XX[n] interface contains the methods and properties for the new functionality. 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 ------------ Revision History ---------------- Version Date Notes ------- ---------- -------- 1.3.22.0 Sep 21 2012 Updated the IVI class compliance information. 1.3.21.0 Mar 19 2010 Updated the code for Measurement.FetchWaveform method. 1.3.20.0 Mar 2 2010 Changed the copyright information for the year 2010. Made changes in the documentation. 1.3.19.0 Dec 15 2009 Added the support for DSO7104B,DSO7012B,DSO7034B,DSO7032B, DSO7054B,DSO7052B,DSO7014B,MSO7014B,MSO7012B,MSO7032B,MSO7034B, MSO7052B,MSO7054B,MSO7104B 1.3.18.0 May 25 2009 Updated the code for Measurements.Count property. Updated the code of Measurement.FetchWaveformMinMax method to handle Simulation. Update the default model for Simulation to DSO7032A from 54621A. Updated the documentation for Agilent546XXMeasurmentPhase Enum. Fixed the driver code to support 54622D model. Fixed code in the Measurement.FetchWaveform method. Added support for DSO7012A,MSO7014A,DSO7014A,MSO7014A. Fixed the code in the TriggerGlitch.Width method. Updated the Driver Help document. Updated the driver code in Configure methods for Simulation. Included the implementation for ConfigureNumAverages and ConfigureNumEnvelopes functions in IVI-C. Fixed the Reset timeout values in CoAgilent546XX.h source file. 1.3.8.0 Mar 26 2008 Minor Update. 1.3.7.0 Mar 14 2008 Added the support for simulation. Added the IVI-C driver. Includes the driver source code. 1.2.1.1 Apr 17 2007 Added support for 5K series of Oscilloscopes. Fixed several issue that have become known: Corrected the ErrorQuery() method to clear the instrument error queue was corrected. Corrected error handling in Trigger.Pattern. Condition for 5K series scopes as they do'nt have sequence trigger.Fixed the Memory leakage when array used to retrieve the raw waveform data. 1.2.0.8 Nov 08 2006 Add support for LXI Series 6000 oscilloscopes. 1.2.0.7 Jan 12 2006 Corrected IIviScope.Measurements.Abort() method. 1.2.0.6 Nov 29 2005 Add support for 100MHz Series 6000 oscilloscopes. Add enums in the Agilent specific trigger interface to support slopes = alternate, either. Correct ConfigStore mechanism to add Physical Names for "Channel3", "Channel4", VAL_EXTERN and LINE. Correct indices for UserDigitalChannels. Correct to allow IviScope specific Channel names to be sent and retrieved from the IviScope specific interface. Implement the Measurements.Abort() method. Fix the Measurements.Initiate() and Status() methods. Correct Measurement.ReadWaveform() method to return the correct data when a digital channel is specified used. 1.2.0.5 Aug 24 2005 Previously, setting the # averages in the Acquisition interface could modify the Type property from HiRes to Average. Now the # averages property can not be changed if the Type property is HiRes. 1.2.0.4 Jul 28 2005 Added support for 6000 series oscilloscopes. Implemented simulation which allows the driver to be used without an instrument. See updated help file for details on using simulation. Fixed several issue that have become known: 1. Accept TV as a valid trigger couple mode 2. Return "LINE" as trigger source when using AC trigger mode. 3. Enable write mode for the measurement reference levels from the IviScope interface. 4. Added Channels 3 & 4 as possible sources from the IviScope interface. 5. Updated help file for content and syntax. 6. Generate an error if attempting to set the cursor source to a source that is not enabled. 7. Return min data in min data array and max data in max array for the fetch and read min/max data methods. The data was switched before. 1.1.2.0 May 07 2003 Fixed several issue that have become known: 1. Incorporate the IO timeout fix listed below (March 24, 2003) into Min/Max wfm transfers. 2. When making the TimeAtValue measurement, use the TimeAtValue parameters vs the TimeAtEdge measurement parameters. 3. When setting the trigger coupling property to HF or Noise reject, use DC coupling vs Ac. 4. The Fetch/ReadWaveform methods allowed peak data to be retrieved as normal data. Driver now generates an error if this is attempted. 5. Modify help file to provide section labels in "Getting Started" for ANSI C and VEE vs two for VEE. Additionally, some system level issues concerning memory leaks and config store have been fixed. 1.1.1.1 Mar 31 2003 Fix errors in the help file links. 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 Mar 14 2003 Fix enum values for trigger coupling and type, tv trigger event & signal format to comform to the Ivi Scope spec. 1.1.0.0 Mar 11 2003 Fix enum values for measFunction to match those in the scope driver class. 1.0.1.0 Mar 06 2003 Initial release IVI Shared Component Revisions ------------------------------ 1.6.0.1 IviConfigServer.dll 1.6.0.0 IviConfigServerCAPI.dll 1.2.0.0 IviCShared.dll 1.0.238.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.238.0 IviFloat.dll 1.0.4.0 IviLxiSyncTypeLib.dll 1.0.0.0 IviPwrMeterTypeLib.dll 1.1.0.0 IviRfSigGenTypeLib.dll 3.0.0.0 IviScopeTypeLib.dll 1.0.1.2 IviSessionFactory.dll 1.5.0.0 IviSharedComponentVersion.dll 1.0.0.0 IviSpecAnTypeLib.dll 3.0.0.0 IviSwtchTypeLib.dll IVI Compliance -------------- IVI-COM/IVI-C IviScope Specific Instrument Driver IVI Instrument Class: IviScope IviScope Spec: IVI-4.1_v4.1 IviScopeBase yes IviScopeInterpolation yes IviScopeTVTrigger yes IviScopeGlitchTrigger yes IviScopeRuntTrigger no IviScopeWidthTrigger yes IviScopeAcLineTrigger yes IviScopeWaveformMeasurement yes IviScopeMinMaxWaveform yes IviScopeProbeAutoSense yes IviScopeContinuousAcquisition yes IviScopeAverageAcquisition yes IviScopeSampleMode yes IviScopeTriggerModifier yes IviScopeAutoSetup yes Optional Features: Interchangeability Checking no State Caching no Coercion Recording no Driver Identification: Vendor: Agilent Technologies Description: Agilent546xx Family of Oscilloscopes Revision: 1.3 Component Identifier: Ag546xx.Ag546xx Hardware Information: Instrument Manufacturer: Agilent Technologies Supported Instrument Models: MSO6102A,DSO6102A,MSO6104A,DSO6104A,MSO6052A,DSO6052A,MSO6054A,DSO6054A,MSO6032A, DSO6032A,MSO6034A,DSO6034A,MSO6012A,DSO6012A,MSO6014A,DSO6014A,DSO6104L,DSO6054L, DSO6034L,DSO6014L,54621A,54621D,54622A,54622D,54624A,54641A,54641D,54642A,54642D, DSO5054A,DSO5052A,DSO5034A,DSO5032A,DSO5014A,DSO5012A,DSO7032A,DSO7052A,DSO7102A, DSO7034A,DSO7054A,DSO7104A,MSO7032A,MSO7052A,MSO7102A,MSO7034A,MSO7054A,MSO7104A, DSO7012A,MSO7012A,DSO7014A,MSO7014A,DSO7104B,DSO7012B,DSO7034B,DSO7032B,DSO7054B, DSO7052B,DSO7014B,MSO7014B,MSO7012B,MSO7032B,MSO7034B,MSO7052B,MSO7054B,MSO7104B Supported Bus Interfaces: GPIB, USB, TCPIP (LAN), or ASRL (Serial) if supported by the instrument. More Information ---------------- For more information about this driver and other instrument drivers and software available from Agilent Technologies visit: http://www.agilent.com/find/ivi 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 Agilent Technologies, Inc. 2003-2012