*********************** **** Read Me First **** *********************** Version 2.1.1006.3 Mar 10, 2020 Introducing the AgM9393 IVI Driver for the Keysight M9393 Vector Signal Analyzer --------------------------------------------------------------------------- This instrument driver provides access to the functionality of the M9393 Vector Signal Analyzer 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 M9300A Reference M9308A Synthesizer M9365A Wideband Downconverter M9169E Switchable-Input Attenuator 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 Windows 8 32-bit, 64-bit Windows 10 32-bit, 64-bit Note: Due to the Microsoft end of support for Windows XP, AgM9393 is not supported on Windows XP. At the time of release 2.1.1006.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, AgM9393 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 IAgM9393[n] interface rather than the IAgM9393 interface. The IAgM9393[n]. property will return a pointer to the new IAgM9393[n] interface. The IAgM9393[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.70.0 Jul 09, 2014 Initial public release 1.0.80.1 Aug 07, 2014 Documentation updates. Various defects fixed: - Alignments fail if conversion mode is not set to Auto. - Alignments fail if multiple instances of M9393 in the same process. - Corrected trigger qualification of wideband burst trigger for IVI and 89600. - 89600: Reconnecting to M9393 from 89600 fails in certain sequences. - 89600: Large span to RBW ratios may generate errors. - 89600: Certain triggered measurements stall if trigger not received in 1 sec. - 89600: Incorrect power reading at certain settings when using average detector. - 89600: Corrected handling of trigger delay limits. - 89600: Minimum span can be less than 800 Hz. - 89600: Interaction with M90XA when running in process with 89600. - 89600: Overlap Percentage error with Gate Trigger and Power Spectrum. 1.1.240.0 Sept 18, 2014 Added LabVIEW driver for AgM9393. Added IF Dither mode for Stepped Spectrum. See IAgM9393Ex2.SteppedSpectrumAcquisition2.IFDither.* Added multi-channel synchronization. See IAgM9393.MultiChannelSync.* Documentation updates. Various defects fixed: - Comprehensive alignment failed if initial instrument state is Stepped Spectrum and conversion is image protect - 89600: Overlap Percentage error with Gate Trigger and Power Spectrum 1.1.518.1 Feb 10, 2015 89600: allow driver sharing using M9000 resource manager for multi-channel configurations Various defects fixed: - WIT 353338 – Issue starting system if locale uses comma as decimal separator - WIT 357918 – LO Nulling intermittently fails on some systems - WIT 369709 – Issue with field calibration resulting in ~0.2 dB flatness error on some units - WIT 335725 – 89600: error reported when IF Dither enabled and Span/RBW ratio too large - WIT 353408 – 89600: error reported when switching between IF Mag & External Trigger in Sequenced Mode - WIT 353905 – 89600: minimum gate length limited to 100 ns in zero span - WIT 355118 – 89600: added VBW limiting in zero span - WIT 356920 – 89600: channel filter was not set correctly for non-power spectrum measurements - WIT 359033 – 89600: allow higher Span to RBW ratio based on physical memory available 1.1.522.2 Mar 9, 2015 Field calibration enhancement to improve expected input level accuracy Various defects fixed: - WIT 361207 – Fixture Loss Enabled is now set to False on Reset (previously was unchanged) 1.2.1016.0 May 7, 2015 Support for M9415A Peer To Peer operation. Not supported via IVI. Support for M9415A Noise Correction in FFT Acquisition Mode. Not supported via IVI. Various defects fixed: - WIT 385288 - LO Feedthrough causes IF Overloads when using Noise Corrections - WIT 391319 - Interaction with M90XA prevents newer M90XA versions from running 1.2.1019.1 Sep 4, 2015 Various defects fixed: - Corrected frequency scaling for soft front panel FFT Acquisition mode - Increased maximum value for soft front panel IQ averaging period to match IVI maximum - Fixed intermittent glitch on narrowband time trace after using FFT Acquisition mode 2.0.200.0 Oct 20, 2015 Support for extended frequency range (3.6 GHz - 50 GHz) using option M9365A-FRX. Use of M9169E Programmable Attenuator is recommended for range control, automated field alignments, and self test. Support for wideband IF (up to 800 MHz) using option M9365A-WB1 and use of an external wideband digitizer, such as M9202A or M9703A. Limited (setup) support for data streaming using the M9202A wideband digitizer. All streaming controls are available from the M9392A VSA Soft Front Panel and IVI interfaces. Support for peer-to-peer IQ data transfer from the M9214A Digitizer module to another module that supports peer-to-peer data transfer, such as the M9451A module, using the PeertoPeerPort IVI interface. Enhanced self-tests for extended frequency ranges with or without the M9169E Step Attenuator. 89600: Power Spectrum speed improvements. Various defects fixed: 2.0.225.1 Jan 14, 2016 Enhanced self-tests and corrections for installed hardware options. Enhanced support for external applications software. 2.1.855.0 Mar 31, 2016 Added property, RF3.Attenuator, to select RF attenuator type used for certain hardware configurations. Added property, RF3.AttenuatorMode, to control the RF input signal path in front of the mixer. Added interface, FFTAcquisition2.NoiseCorrection, with properties Enabled and Mode to support noise correction in FFT acquisition mode. M9300A-Carrier FPGA 1.0.4.0 available – Optional, not currently required for any new software features. 2.1.875.1 Aug 19, 2016 Enhanced support for list mode with external attenuator configuration. Corrected external attenuator module identification. Corrected selection of external attenuator module in simulation mode. Corrected field alignment backwards compatibility with 1.x factory calibration data. Corrected resource locking for the M9300 Reference module. 2.1.910.2 May 18, 2017 When the M9393A driver is initialized with “ExternalDigitizer=true” or “ExternalDigitizer=1” in the option string, M9214A IF Digitizer is no longer required in the PXI chassis. A new M9393 wideband IF hardware extension for the 89600 VSA has been added that allows a M3993A to be paired with a M9203A digitizer to obtain measurement bandwidth up to 1 GHz. New FPGA bits with improved stability. 2.1.968.3 Jun 05, 2018 Added support for detector type Peak. Further enhanced 89600 VSA control with M9203A 1 GHz module. New M9214A IF Digitizer FPGA bits to fix issues with dither setup being ignored with board rev numbers greater than 2 2.1.1006.3 Mar 10, 2020 New M9365A FPGA bits with header and speed setting fixes. Updated to the latest version v1.0.5.4 M9155CH40 fundamental dlls to address Win10 connection issues Updated to the latest version v2.5.5.0 of the M916x attenuator / M9169E 50 GHz switched attenuator fundamental dlls to address Win10 connection issues H01 option updates Security settings updates Various bug fixes 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: AgM9393 PXIe Vector Signal Analyzer Revision: 2.1 Component Identifier: AgM9393.AgM9393 Hardware Information: Instrument Manufacturer: Keysight Technologies Supported Instrument Models: M9214A, M9300A, M9308A, M9365A Supported Bus Interfaces: PXI, PXIe 32-bit Software Information: Supported Operating Systems: Windows 7 32-bit, Windows 8 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, Windows 8 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, AgM9393 is not supported on Windows XP. At the time of release 2.1.1006.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, M9308A, M9365A 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, M9308A, M9365A 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), Windows 8 OS Bitness: 32-bit, 64-bit Driver Buildability: Operating System (Service Pack): Windows 7 (SP1), Windows 8 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. © Keysight Technologies 2016, All rights reserved.