*********************** **** Read Me First **** *********************** Version 1.5.9.0 March 2018 Introducing the Agilent 34980A IVI Driver for the Agilent Multifunction Switch/Measure Mainframe and Modules. --------------------------------------------------------------------------- This instrument driver provides access to the functionality of Agilent 34980A 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. !!!!!!!!! NOTE !!!!!!!!!!!!!!!! -------------------------------- This revision of the driver changed the IviSwtch behavior of Form C ( General Purpose ) switches. The IviSwtch Specifications, Appendix A, section A.7 allows three possible behaviors for a Form C (GP) switch. The following is an excerpt from that specification, with the exception that the choices are given numbers here and are just bulleted in the specification: When developing a driver for form C switches, you may implement the Disconnect call in at least three different ways: 1. Disconnecting common (C) from normally open (NO) or normally closed (NC) never performs any action other than marking C as being disconnected from both NO and NC. This approach can save relay life by minimizing the number of relay operations. 2. Disconnecting C from NO or NC flips the relay state. For example, if C and NC are connected, a call to disconnect C from NC has the effect of connecting C to NO physically, but the driver considers C as being disconnected from both NO and NC. (To subsequently connect C to NO, the application developer should make an explicit call to Connect C to NO so that the driver considers C and NO connected.) 3. Disconnecting C from NO or NC always brings the relay to the normally closed state. As in the previous case, C is connected to NC only physically. The driver considers C as being disconnected from both NO and NC. The 34980A IVI driver defaults to using behavior #3 above. Starting with this revision of the driver, the DriverSetup portion of the OptionString passed into the Initialize call allows the user to specify either behavior #1 or #3 at initialization ( see section 'Initializing the IVI-COM Driver' in Ag34980A.chm help file). To choose behavior #1 the DriverSetup string must contain: "FormC = Mode1" (without the quotes), and for behavior #3 the DriverSetup string must contain: "FormC = Mode3" (without the quotes). --------------------------------- !!!!!!!!! END NOTE !!!!!!!!!!!!! Supported Instruments --------------------- Frame: 34980A Modules: 34921A 34922A 32923A 34924A 34925A 34931A 34932A 34933A 34934A 34937A 34938A 34939A 34941A 34942A 34945A 34946A 34947A 34950A 34951A 34952A 34959A 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 Windows 10 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 Keysight (Agilent) IO Libraries is recommended and includes VISA-COM. You can download the latest version from: http://www.keysight.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/Windows 10. 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/Windows 10. 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, Agilent34980A 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 IAgilent34980A[n] interface rather than the IAgilent34980A interface. The IAgilent34980A[n]. property will return a pointer to the new IAgilent34980A[n] interface. The IAgilent34980A[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.5.9.0 Mar 2018 Defect fix in IviDmm Configure method. 1.5.8.0 Jan 2018 Defect fix in Configure methods 1.5.7.0 Jun 2017 Defect fix in Measurement_DestructiveRead method 1.5.5.0 Nov 2015 Fixed defect with 34934A matric configuration 1.5.4.0 May 2015 Fixed defect with 34934A matric configuration 1.5.3.0 June 2013 Defect fixes, added 64bit support, MatLab wrapper 1.4.3.0 June 2010 Modified IviSwtchPath.Disconnect implementation to always open the channel IVI Compliance -------------- IVI Instrument Class: IviDmm IviDmm Spec: IVI-4.2 Revision: 4.1 IviDmmBase Yes IviDmmACMeasurement Yes IviDmmFrequencyMeasurement Yes IviDmmTemperatureMeasurement Yes IviDmmThermocouple Yes IviDmmResistanceTemperatureDevice Yes IviDmmThermistor Yes IviDmmMultiPoint Yes IviDmmTriggerSlope Yes IviDmmSoftwareTrigger Yes IviDmmDeviceInfo Yes IviDmmAutoRangeValue Yes IviDmmAutoZero Yes IviDmmPowerLineFrequency Yes IVI Instrument Class: IviSwtch IviDmm Spec: IVI-4.6 Revision: 4.0 IviSwtchBase Yes IviSwtchSoftwareTrigger Yes Optional Features: Interchangeability Checking no State Caching no Coercion Recording no Driver Identification: Vendor: Agilent Technologies Description: Agilent 34980A modular switch measurement system Revision: 1.5 Component Identifier: Agilent34980A Hardware Information: Instrument Manufacturer: Agilent Technologies Supported Instrument Models: 34980A Supported Bus Interfaces: TCPIP, GPIB, USB 32-bit Software Information: Supported Operating Systems: Windows XP, Windows Vista 32, Windows 7 32, Windows 10 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, Windows 10 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 2004-2018 Keysight Technologies