*********************** **** Read Me First **** *********************** Version 1.2.6.0 July 2013 Introducing the AgilentInfiniium IVI Driver for the Agilent Infiniium Oscilloscopes --------------------------------------------------------------------------- This instrument driver provides access to the functionality of Infiniium 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 C++, Microsoft .NET, Agilent VEE Pro, National Instruments LabView, LabWindows CVI, MATLAB(32 bit only) and others. Supported Instruments --------------------- 54830B, 54830D, 54831B, 54831D, 54832B, 54833A, 54832D, 54833D, MSO8104A, MSO8064A, DSO8104A, DSO8064A, 54835A, 54853A, 54854A, 54855A, DSO80804A, DSO81004A, DSO81204A, DSO81304A, 54845A, 54845B, 54846A, 54846B, 54810A, 54815A, 54820A, 54825A, DSO80204B, DSO80304B, DSO80404B, DSO80604B, DSO80804B, DSO81004B, DSO81204B, DSO81304B, DSO91304A, DSO91204A, DSO90804A, DSO90604A, DSO90404A, DSA91304A, DSA91204A, DSA90804A, DSA90604A, DSA90404A, DSO90254A, DSA90254A, DSO90808A, DSO91208A, DSO91308A, MSO9404A, MSO9254A, MSO9104A, MSO9064A, DSO9404A, DSO9254A, DSO9104A, DSO9064A, DSAX91604A, DSAX92004A, DSAX92504A, DSAX92804A, DSAX93204A, DSOX91604A, DSOX92004A, DSOX92504A, DSOX92804A, DSOX93204A, DSA93004L, DSO93004L 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 Windows 7 Shared Components Before this driver can be installed, your computer must already have the IVI Shared Components installed. Minimal IVI Version: 2.2.1 The IVI Shared Components installer is available from: http://www.ivifoundation.org/shared_components/Default.aspx 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. You can download the latest version from: http://www.agilent.com/find/iosuite Uninstall --------- This driver can be uninstalled like any other software from the Control Panel using "Add or Remove Programs" in Win XP or "Programs and Features" in Windows Vista/Windows 7. The IVI Shared Components may also be uninstalled like any other software from the Control Panel using "Add or Remove Programs" in Win XP and "Program & Features" in Windows Vista/Windows 7. Note: All IVI-COM/C 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. Caution: Once you have installed version 2.x of the IVI Shared Components, you will not be able to build IVI drivers and applications developed with earlier versions. You will need to upgrade those drivers/applications to the new IVI Shared Components and to build on Visual Studio 2008 or higher or you will need to build those drivers/applications on a different machine that does not have version 2.x of the IVI Shared Components. Start Menu Help File -------------------- A shortcut to the driver help file is added to the Start Menu, All Programs, Agilent IVI Drivers, AgilentInfiniium 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 many programming examples for this driver. Additional Setup ---------------- .NET Framework The .NET Framework itself is not required by this driver. If you plan to use the driver with .NET, the minimal .NET framework version is: 2.0 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 <(x86)>\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. Using a New Version of the Driver --------------------------------- New versions of this Agilent IVI-COM/C 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 IAgilentInfiniium[n] interface rather than the IAgilentInfiniium interface. The IAgilentInfiniium[n]. property will return a pointer to the new IAgilentInfiniium[n] interface. The IAgilentInfiniium[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. Pre-existing .NET client applications must be re-build before using the new version of the driver. Known Issues ------------ This driver does not have any known defects. Revision History ---------------- Version Date Notes ------- ---------- --------- 1.2.6.0 July 2013 Modify Trigger.Coupling to support AC, HF Reject and LF Reject trigger couplings for 9000 series models. 1.2.5.0 April 2013 Defect ID 183974 "ModulePath64 value missing from IVI Config Store" is fixed. 1.2.4.0 Dec 2012 Fixed the customer issue on IAgilentInfiniiumMeasurements.Initiate() method. 1.2.3.0 Apr 2012 Fixed the following bugs: 1. Corrected the behavior of Measurement->GetItem-> FetchWaveform so that it works correctly with "Channel3" and "Channel4". 1.2.2.0 Nov 2011 Added support for SetupMemory => Download and Fetch methods. Fixed the following bugs: 1. Corrected the behavior of ReadWaveform to to work correctly if the Digitize operation times out. 2. Corrected ReadWaveform to report an error when it is unable to acquire memory while reading a very large waveform dataset. 3. Corrected Trigger => Width => ThresholdLow and ThresholdHigh to return correct values. 1.1.0.0 Jan 2010 Adds IVI-C, updated Help, and Simulation 1.0.3.9 Feb 2008 Added support for 90000 family of Oscilloscopes. 1.0.3.7 Mar 2007 Fixed a memory leak in ReadWaveform. 1.0.3.0 Oct 2006 Corrected reading of waveform data with holes 1.0.2.0 Mar 2006 Added support for new models: DSO81304B, DSO81204B, DSO81004B, DSO80804B, DSO80604B, DSO80404B, DSO80304B, DSO80204B, DSO8104A, MSO8104A, DSO8064A, MSO8064A. Fixed the following bugs. 1. Corrected the ordering of digital channels. 2. Modified the drivers so that a correct record length is always fetched. 3. Corrected the behavior of IviScope->Channels-> GetItem so that it works correctly with "ChannelN" where N is a valid scope channel number. 4. Modified the driver to not put the scope in real time mode when averaging is turned on. 5. Corrected reset behavior so the trigger type is correct. 6. Return "LINE" as the trigger source when the trigger type is set to ACLine. 1.0.1.5 Jul 2005 Added support for new models: DSO80804A, DSO81004A, DSO81204A, DSO81304A Implemented simulation which allows the driver to be used without an instrument. See help file Getting Started section for details on using simulation. Fixed several issue that have become known: 1. Corrected help text on Y cursor position. 2. Modify drivers so no data-out-of-range error is generated when specifying a record length and points that require a sample rate greater than can be supplied by the instrument. 3. Modify the GetState method to work when QueryInstrumentStatus = true 4. Fixed ReadActivity and ResetActivity methods. 5. Switch the contents of the min and max arrays returned from the Fetch/ReadWaveformMinMax methods to match the specification. 1.0.0.0 Sep 2003 Initial release. IVI Compliance -------------- IVI-COM/C IviScope Specific Instrument Driver IVI Instrument Class: IviScope IviScope Spec: 4.1 IviScopeBase Yes IviScopeInterpolation Yes IviScopeTVTrigger Yes IviScopeRuntTrigger No IviScopeGlitchTrigger Yes IviScopeWidthTrigger Yes IviScopeAcLineTrigger Yes IviScopeWaveformMeas Yes IviScopeMinMaxWaveform Yes IviScopeProbeAutoSense Yes IviScopeContinuousAcquisition Yes IviScopeAverageAcquisition Yes IviScopeSampleMode No IviScopeTriggerModifier Yes IviScopeAutoSetup Yes Optional Features: Interchangeability Checking no State Caching no Coercion Recording no Driver Identification: Vendor: Agilent Technologies Description: Infiniium Series Oscilloscopes Revision: 1.2.4.0 Component Identifier: AgilentInfiniium.AgilentInfiniium Hardware Information: Instrument Manufacturer: Agilent Technologies Supported Instrument Models: 54830B, 54830D, 54831B, 54831D, 54832B, 54833A, 54832D, 54833D, MSO8104A, MSO8064A, DSO8104A, DSO8064A, 54835A, 54853A, 54854A, 54855A, DSO80804A, DSO81004A, DSO81204A, DSO81304A, 54845A, 54845B, 54846A, 54846B, 54810A, 54815A, 54820A, 54825A, DSO80204B, DSO80304B, DSO80404B, DSO80604B, DSO80804B, DSO81004B, DSO81204B, DSO81304B, DSO91304A, DSO91204A, DSO90804A, DSO90604A, DSO90404A, DSA91304A, DSA91204A, DSA90804A, DSA90604A, DSA90404A, DSO90254A, DSA90254A, DSO90808A, DSO91208A, DSO91308A, MSO9404A, MSO9254A, MSO9104A, MSO9064A, DSO9404A, DSO9254A, DSO9104A, DSO9064A, DSAX91604A, DSAX92004A, DSAX92504A, DSAX92804A, DSAX93204A, DSOX91604A, DSOX92004A, DSOX92504A, DSOX92804A, DSOX93204A, DSA93004L, DSO93004L Supported Bus Interfaces: TCPIP, GPIB, USB 32-bit Software Information: Supported Operating Systems: Windows XP, Windows Vista 32, Windows 7 32 Unsupported Operating Systems: Windows 2000 Support Software Required: VISA-COM Source Code Availability: Source code included with driver. 64-bit Software Information: Supported Operating Systems: Windows Vista 64,Windows 7 64 Support Software Required: VISA-COM Source Code Availability: Source code included with driver. More Information ---------------- For more information about this driver and other instrument drivers and software available from Agilent Technologies visit: http://www.agilent.com/find/adnivicominfo 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 2003-2013 Agilent Technologies, Inc. All rights reserved.