*********************** **** Read Me First **** *********************** Version 2.1.250.3 Jun 21, 2018 Introducing the AgM9391 IVI Driver for the Keysight Modular Receiver --------------------------------------------------------------------------- This instrument driver provides access to the functionality of the M9381 VSA Receiver 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 --------------------- M9214A Digitizer Module M9300A Reference Module M9301A Synthesizer Module M9350A Downconverter Module 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 7 32-bit, 64-bit Note: Due to the Microsoft end of support for Windows XP, AgM938x is not supported on Windows XP. At the time of release 2.1.250.3 there were no known major problems running on Windows XP. However if you encounter an issue unique to Windows XP, Keysight may not attempt to address the issue. 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, AgM9391 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 IAgM9391[n] interface rather than the IAgM9391 interface. The IAgM9391[n]. property will return a pointer to the new IAgM9391[n] interface. The IAgM9391[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.0.69.0 June 2013 Initial public release 1.1.300.0 Oct 2013 Added multi-channel support via 89600 VSA software. Added FFT Acquisition Mode for faster power measurements. Fixes to improve Fixture Loss performance. Fixes IVI Config Store to remember options and "simulate" mode. Improved IF flatness calibration. 1.2.403.0 Sept. 2014 Added support for 89600 VSA Software stepped spectrum measurement (Option 89601B-SSA). Added MultiChannelSync IVI interface and MultiChannel C# example to allow direct utilization of multi-channel capability. Previous 1.1.300.0 release offered multi-channel support via 89600 VSA software only. Improved speed performance. Eliminated AgModularVSA IVI interface. All functionality is now accessed directly via the AgM9391 interface. M9214A FPGA 1.0.2.3 available – Optional, not currently required for any new software features. M9300A FPGA 1.0.1.0 available – Optional, not currently required for any new software features. Fix allowing Modules.Reference.ProgrammableOutputTrigger properties to take effect. Fixed issue causing a ReadIQData() exception after running an IF Flatness alignment. Note: This release is not binary compatible with prior releases of the IVI-C driver. Programs using the C/C++ IVI-C driver must be recompiled for this version of the driver. Similarly, programs compiled with this version of the driver will not be compatible with older versions of the IVI-C driver. This incompatibility is due to renumbering of attribute constants defined in the AgM9391.h include file. 1.2.417.1 Jan 14, 2015 Added features for 89600 VSA Software power spectrum measurements (Option 89601B-SSA): - Zero span measurements (power vs time) - Sweep trigger - IF Magnitude trigger (for gating and sweep trigger) - Equivalent sweep time - Allow higher Span/RBW ratios when using a 64 bit process - Support M9000 resource manager sharing with multi-channel configurations Fixture Loss tables are no longer cleared by ResetDefaultProperties() or Reset(). Fix to allow IF Filter alignment even when M9300A Reference module is not in the system timing slot. 2.0.280.0 May 26, 2015 Updated help file, added IVI-2014 Compliance, rebranded as Keysight Technologies Improved multichannel timing synchronization performance. Support a maximum of 4 PXI VSAs in a single chassis sharing a single controller. Added phase synchronous operation via M9301A Synthesizer sharing capability, along with new IVI method and properties: Calibration2.LOLevelAlignment.AlignLoLevel Modulation3.BasebandPhase adjustment Modules.Synthesizer3.SharedRole Modules.Synthesizer.OutputPort Added Reference3.AlignExternalReferenceAnd10MHzOut method to align phase of the 10 MHz Output with the External Reference input. Fix to enable using Modules.Reference.ProgrammableOutputTrigger properties when sharing M9300A Reference between multiple instruments. 2.1.221.0 Jul 10, 2015 Enhanced multichannel capability to support a maximum of 8 PXI VSAs in two chassis, including phase coherent operation with an LO distribution unit. 2.1.230.1 Dec 12, 2016 Fix interaction between applications using shared Reference or shared Synthesizer that may result in self test failures. Fix triggered multi-channel record mode with 89600 VSA Software. 2.1.240.2 Feb 27, 2017 "Drive BP 10MHz Reference" checkbox is added to M9391 SFP. This is equivalent of IVI-COM's Modules.Reference.BackPlaneReferenceEnabled property. New FPGA bits for M9300A, M9301A and M9350A with improved stability and support for new memory module. 2.1.241.3 Beta Jun 27, 2017 Added Digitizer Sample Size input extension to 89600 VSA hardware extensions to select 32-bit or 64-bit samples. 2.1.244.3 Beta Sep 19, 2017 Move to Nimbus 4.1. 2.1.246.3 Beta Dec 14, 2017 New FPGA bits for M9214A with improved stability and support for new memory module. 2.1.247.3 Mar 07, 2018 Updates to prevent Apogee hang when doing 32 bit packing acquisitions. 2.1.248.3 May 11, 2018 Updates for StepCal error notifications. 2.1.250.3 Jun 18, 2018 New M9214A FPGA bits with fix for ADC dither support in C03 rev boards. 2.1.250.3 Jun 21, 2018 Second set of updates for StepCal error notifications. 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: Agilent Technologies Description: AgM9391 Modular Receiver Driver Revision: 2.1 Component Identifier: AgM9391.AgM9391 Hardware Information: Instrument Manufacturer: Agilent Technologies Supported Instrument Models: M9214A, M9300A, M9301A, M9350A Supported Bus Interfaces: PXI, PXIe 32-bit Software Information: Supported Operating Systems: Windows 7 32-bit Unsupported Operating System: Windows 2000 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 Support Software Required: VISA Source Code Availability: Source code included with driver via custom installation option. Note: Due to the Microsoft end of support for Windows XP, AgM938x is not supported on Windows XP. At the time of release 2.1.250.3 there were no known major problems running on Windows XP. However if you encounter an issue unique to Windows XP, Keysight may not attempt to address the issue. Unit Testing ------------ Test Setup Instrument: Instrument Models (FW Revision): M9214A, M9300A, M9301A, M9350A Bus Interface: PXI, PXIe Operating System (Service Pack): Windows 7 (SP1) 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) M9214A, M9300A, M9301A, M9350A Bus Interface: N/A Operating System (Service Pack): Windows 7 (SP1) 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) OS Bitness: 32-bit, 64-bit Driver Buildability: Operating System (Service Pack): Windows 7 (SP1) OS Bitness: 32-bit, 64-bit Visual Studio Version: VS2010 Driver Test Failures - Known Issues: None - This driver does not have any known defects. 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 2011-2015