*********************** **** Read Me First **** *********************** Version 1.3.115.0 January 2015 Introducing the Keysight AgM950x IVI Driver for the M950x Series AXIe Chassis Sensors --------------------------------------------------------------------------- This instrument driver provides access to the functionality of the M950x 2 and 5 slot AXIe Chassis 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, Keysight VEE Pro, National Instruments LabView, LabWindows CVI, MATLAB(32 bit only) and others. Supported Instruments --------------------- M9502A (2-slot AXIe Chassis) M9505A (5-slot AXIe Chassis) 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 7 32-bit, 64-bit Windows 8 32-bit, 64-bit Shared Components Before this driver can be installed, your computer must already have: IVI Shared Components Version: 2.2.1 or newer installed VISA Shared Components Version 1.6 or newer installed The IVI Shared Components installers are 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's 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 7/Windows 8. 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 7/Windows 8. 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 enabling the "Source Code" option in the "Custom Setup" dialog when installing the driver. This code is provided as is for informational purposes only. Modification of this code is not supported. Code is a Visual Studio 2010 C++ project and may be updated to new versions of Visual Studio. 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 2010 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, Keysight Instrument Drivers, IVI-COM-C Drivers, AgM950x 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 and Introduction files and 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: drive:\\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 Keysight 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 IAgM950x[n] interface rather than the IAgM950x interface. The IAgM950x[n]. property will return a pointer to the new IAgM950x[n] interface. The IAgM950x[n] interface contains the methods and properties for the new functionality and inherits all prior interface 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. Revision History ---------------- Version Date Notes --------- -------- ----- 1.3.115.0 Jan 2015 Visual Studio Examples updated to version 2010. Document changes to meet IVI-2014 Compliance. Rebranded with Keysight name and copyrights. Changes made to support the HP Z440/640/840 series of controllers. 1.2.1.6 May 2012 Increased the chassis fan speed resolution by expanding the range of fan speed levels from 8-15 to 35-100. The minimum/maximum fan RPMs remain the same as before, they are just mapped into the expanded range of fan speed levels accessible from the Soft Front Panel and programmatically. Use of the expanded fan speed ranges requires chassis firmware version 1.3.23 or later. Added support for Agilent IO Libraries 16.2. Agilent Connection Expert now displays the chassis and all installed modules under the PXI0 interface. On 64-bit systems, the Agilent IO Libraries version 16.2 32-bit mDNS responder patch will be installed automatically. Previous versions of the AXIe chassis software required a separate download and install of this patch to allow 32-bit applications to resolve LAN hostnames correctly on 64-bit systems. 1.1.1.1 May 2011 Initial public release IVI Compliance -------------- IVI-COM/IVI-C Custom Specific Instrument Driver IVI Generation: IVI-2014 IVI Instrument Class: None Optional Features: Interchangeability Checking No State Caching No Coercion Recording No Driver Identification: Vendor: Keysight Technologies Description: IVI Driver for the Agilent M950x Series AXIe Chassis Sensors Revision: 1.3.115.0 Component Identifier: AgM950x.AgM950x Hardware Information: Instrument Manufacturer: Keysight Technologies Supported Instrument Models: M9502A, M9505A Supported Bus Interfaces: TCPIP 32-bit Software Information: Supported Operating Systems: Windows XP, Windows 7 32-bit, Windows 8.1 32-bit Unsupported Operating Systems: Windows 2000, Windows Vista 32-bit Support Software Required: VISA Source Code Availability: Source code included with driver via custom installation option. 64-bit Software Information: Supported Operating Systems: Windows 7 64-bit, Windows 8.1 64-bit Unsupported Operating Systems: Windows Vista 64-bit Support Software Required: VISA Source Code Availability: Source code included with driver via custom installation option. Unit Testing ------------ Test Setup Instrument: Instrument Models (FW Revision): M9502A, M9505A Bus Interface: TCPIP Operating System (Service Pack): Windows 7 (SP1), Windows 8.1 OS Bitness/Application Bitness: 64-bit/32-bit VISA Vendor and Version: Keysight VISA (IO Libraries 16.3, Update 2) IVI Shared Components Version: 2.2.1 Test Setup Simulation: Instrument Models: (FW Rev N/A) M9502A, M9505A Bus Interface: N/A Operating System (Service Pack): Windows 7 (SP1), Windows 8.1 OS Bitness/Application Bitness: 64-bit/32-bit, 64-bit/64-bit VISA Vendor and Version: N/A IVI Shared Components Version: 2.2.1 Driver Installation Testing: Operating System (Service Pack): Windows 7 (SP1), Windows 8.1 OS Bitness: 32-bit, 64-bit Driver Buildability: Operating System (Service Pack): Windows 7 (SP1), Windows 8.1 OS Bitness: 32-bit, 64-bit Visual Studio Version: VS2010 Driver Test Failures - Known Issues: Known Issues ------------ All OSes: Version _VERSION_ of the M950x driver requires chassis firmware version 1.3.23 or later. Please refer to the AXIe Chassis User Guide for information on how to install the latest firmware. WinXP: If you're using the PCIe interface to connect to this chassis, the Intel 82573L NIC inside the chassis will appear to Windows as a locally installed device. While Windows Vista and Windows 7 provide the necessary Intel NIC driver, Windows XP does not natively include the required Intel NIC driver. If you're using the PCIe interface on Windows XP and you see the Windows "Found New Hardware Wizard" dialog indicating that software needs to be installed for an Ethernet Controller, you'll need to install the Intel PROWin32.exe network driver. If you're connected to the chassis using only the LAN interface, the NIC will not be visible to the Host Controller PC and no additional action is needed. To install the Intel network driver on Windows XP, perform the following steps: 1) Install the latest Agilent M950x software (M950x_Setup.exe), version _VERSION_ or later. 2) Install the Intel network driver (PROWin32.exe) from one of the following locations: C:/Program Files/Agilent/M950x/Network Driver/Windows XP (for 32 bit systems) C:/Program Files (x86)/Agilent/M950x/Network Driver/Windows XP (for 64 bit systems) Keysight Technologies has evaluated and tested this driver to verify that it meets all applicable requirements of the IVI specifications at the time this compliance document was submitted to the IVI Foundation and agrees to abide by the dispute arbitration provisions in Section 7 of IVI-1.2: Operating Procedures, if the IVI Foundation finds this driver to be non-conformant. More Information ---------------- For more information about this driver and other instrument drivers and software available from Keysight Technologies visit: http://www.keysight.com/find/drivers A list of contact information is available from: http://www.keysight.com/find/contactus Microsoft, Windows, MS Windows, and Windows NT are U.S. registered trademarks of Microsoft Corporation. Copyright Keysight Technologies 2015