Introduction to the KtMAwg
IVI.NET/-C Instrument Driver
Driver Version: 2.2.741.0
This instrument driver provides access to the functionality of the AWG through a .NET or C API which also complies with the IVI specifications. This driver works in any development environment which supports .NET or C programming, including Microsoft Visual C++, Microsoft .NET languages, LabVIEW, LabWindows CVI, MATLAB and others.
For more information on this driver, visit www.keysight.com/find/usb-awg (for P9336A AWG) and www.keysight.com/find/M9336A (for M9336A AWG).
This Introduction document includes what would
have normally been in the ReadMe.txt file. It also includes required IVI 2014
introduction and compliance information.
The help files for the IVI.NET (Keysight.KtMAwg.Fx45.chm) and IVI-C (KtMAwg.chm) drivers can be found in the <Program Files (x86)>\Keysight\MAwg\Help directory. They contain:
In addition to the .chm file, the driver
installs MS Help Viewer driver help (VS2010 or newer) and may optionally
install integrated driver help for Visual Studio 2005/2008 (this may increase
the install time by several minutes).
Driver Examples and Source
Code
C# and VB.NET Driver example programs can be found in the folder: <Program Files (x86)>\IVI Foundation\IVI\Microsoft.NET\Framework32\v4.5.50709\Keysight.KtMAwg <driver version>\Examples and C++ Driver example programs can be found in the folder: <Program Files (x86)>\IVI Foundation\IVI\Drivers\KtMAwg\Examples. For
instructions on building examples, refer to Examples Readme.txt file in
the Examples folder.
The IVI.NET driver and IVI-C source code, if
optionally installed, can be found in the following folders: <Program Files (x86)>\IVI Foundation\IVI\Microsoft.NET\Framework32\v4.5.50709\Keysight.KtMAwg <driver version>\Source and <Program Files (x86)>\IVI Foundation\IVI\Drivers\KtMAwg\Source. The source code
is a Visual Studio 2013 C++ project and may be loaded in newer versions of
Visual Studio but the platform toolset must be set to Visual Studio 2013 (v120). To use the rebuilt driver, the driver dll
in the build output directory must be registered using the regsvr32.exe utility
or by setting the VS project C++ Linker settings to do so. This driver provides
the lowest-level API that is a reliable API.
The driver help topic, Driver Examples, documents program examples for Visual Studio (C#, C++, VB.NET).
Each of these examples illustrates how to connect to an instrument
in the respective development environment.
The IVI resources page
(http://ivifoundation.org/resources/default.aspx) has documents and videos that
explain how to get started with an IVI.NET driver in different development
environments:
Configuring Instrument
Settings
The KtMAwg instrument
driver application programming interface (API) includes methods and properties
for setting instrument state variables, as well as methods for controlling the
instrument and reading results from the instrument. These are documented in the
KtMAwg IVI.NET Driver > Reference help topic and KtMAwg IVI-C Driver > IVI-C Reference help topic.
There are two primary API hierarchies that client programs may use to control the instrument. The first one is referred to as the instrument specific hierarchy and the second one is the IviFgen (version 5.0) hierarchy. The IviFgen hierarchy is used when the user wishes to leverage code between multiple instruments that provide the IviFgen hierarchy. The instrument specific hierarchy provides settings/capabilities that are only found on the Keysight AWG.
To access the IviFgen hierarchy from IVI.NET, use the section of the driver documented under KtMAwg IVI.NET Driver > Reference > Driver Hierarchy > IIviFgen. In the IVI-C driver, it is partitioned differently. In the IVI-C driver help, the instrument specific functions and attributes are found under KtMAwg IVI-C Driver > IVI-C Reference > Instrument Specific. The functions and attributes found in all other sections under KtMAwg IVI-C Driver > IVI-C Reference (excluding Instrument Specific) are the IviFgen compliant functions and attributes.
Configuring
Driver Settings
IVI instrument drivers implement inherent capabilities including properties that control driver behavior, utility methods, and identifying information. For more information about using the inherent capabilities, refer to
KtMAwg IVI.NET
Driver
> Reference > Driver Hierarchy > IIviDriver help topic and KtMAwg IVI-C
Driver
> IVI-C Reference > Hierarchy > Inherent IVI Attributes help topic.
Properties that control driver behavior such as
simulation, range checking, and instrument status checking can be
enabled/disabled when initializing the driver or by using configuration
information in the IVI Configuration Store. For more information, refer to KtMAwg IVI.NET Driver > Instantiating the IVI.NET Driver help topic and KtMAwg IVI-C Driver > Initializing the IVI-C Driver help topic.
Driver Versions
Version 2.2 - December 2019
Version 2.1.2 - May 2019
Version 2.1 - March 2019
Version 1.1 - November 2017
Version 1.0 - July 2017
This is the initial release of the KtMAwg driver (version 1.0) for M9336A model. For future releases of the driver, this page will be updated with the essential information on the features and improvements in each AWG driver release.
Obtaining
the latest Introduction and KtMAwg driver
Obtaining the latest revision of this
Introduction: This document is released with a new revision letter whenever
any information in this document changes. The revisions to the Introduction are
listed in the table below, with the most recent revision listed first.
Date |
Revision |
Description |
2019-12-18 |
1.0 |
First release of the Introduction document for driver version 2.2. |
In addition to checking for a later revision of
this Introduction for your current driver version, you may also want to
consider installing a later version of this driver, if available. Refer to the
next section to determine if a later driver version is available.
To see if a later version
of this driver is available, perform the following steps:
Supported
Hardware and Software
Supported
PXIe Module
NOTE:
The P9336A AWG only supports a direct connection to an Intel PCH xHCI USB 3.0 hub. To determine if you are connected to a supported hub, refer to Hardware section of the Troubleshooting chapter in the AWG Operation Guide.
Supported
Module Firmware Revision
1.6.73
Supported
Operating Systems
Supported Keysight Embedded Controllers
Embedded Controller |
Operating System |
M9036A |
Windows Embedded Standard 7 (64 bit) |
M9037A |
Windows Embedded Standard 7 (64-bit) |
Keysight
IO
Libraries Suite
The IO Libraries Suite must be installed prior
to installing the KtMAwg driver. This driver supports the following IO
Libraries Suite releases, with the most recent
release listed first.
P9336A AWG
Release Date |
Release Version |
2019-07-23 |
2019 U1 |
2019-02-02 |
2019 |
2018-04-20 |
2018 Update 1 |
2018-01-31 |
2018 Update 0.2 |
2017-11-15 |
2018 Update 0.1 |
M9336A AWG
Release Date |
Release Version |
2019-07-23 |
2019 U1 |
2019-02-02 |
2019 |
2018-04-20 |
2018 Update 1 |
2018-01-31 |
2018 Update 0.2 |
2017-11-15 |
2018 Update 0.1 |
2017-10-11 |
2018 |
2017-06-14 |
2017 Update 1 |
Keysight P9336A AWG Weight and Dimensions
The table below shows the maximum weight and dimensions of the system components.
Model |
Weight |
Required Benchtop Dimensions for the System |
||
---|---|---|---|---|
Clearance |
Width |
Depth |
||
2-Port |
2.27 kg (5.00 lb) |
5.0 cm (2.00 in) |
27.94 cm (11.00 in) |
40.64 cm (16.00 in) |
Keysight Component Weight and Dimensions (P9336A AWG)
The table below shows the maximum weight and dimensions of the P9336A AWG.
Model |
Weight |
Height |
Width |
Depth |
---|---|---|---|---|
P9336A, 2-Port AWG |
2.27 kg (5.00 lb) nominal |
4.79 cm (1.89 in) |
17.60 cm (6.93 in) |
33.27 cm (13.10) |
Keysight Environmental Conditions (Operating) (for P9336A AWG)
The table below lists the environmental conditions for the P9336A AWG:
Environmental Conditions (Operating) |
|
---|---|
For indoor use only |
|
Altitude up to: |
Up to 10,000 ft (3048 m) |
Temperature: |
00C to 400C |
Humidity: |
Type tested at 95% RH, +400C (non-condensing) |
Keysight Equipment Ratings (for P9336A AWG)
The P9336A AWG can operate with mains supply voltage fluctuations up to ± 10% of the nominal voltage.
Keysight Instrument
DC input |
15 to 24 VDC |
Keysight External AC power adapter
Efficiency Level |
VI |
||
---|---|---|---|
Input |
100 to 240 VAC, 50 to 60 Hz, 1.5 A to 0.75 A |
||
Output |
15 VDC ±5%, 6A max (90W max @40°C, linearly derate to 45W at 55°C) |
||
Power consumption (from the mains) |
62 Watts typical, 100 Watts max |
Keysight
PC
Interface Cards (for M9336A AWG)
This driver supports the following Keysight
PC interface cards:
Keysight
Chassis
System Modules (for M9336A AWG)
This driver supports the following Keysight
chassis system modules:
Keysight Chassis
This driver supports the following Keysight
chassis:
NOTE : For more information about the right configuration of your single chassis and multi-chassis systems, refer to MultiChassisTool.pdf.
NOTE : Keysight recommends the use of Keysight chassis with Keysight PC Interface cards and chassis interface modules to avoid any errors. For detailed information about the tested PC Configurations for your chassis, refer to PC Tested Configurations with PXI/AXIe Chassis.
Supported
M9018A Chassis Driver Releases (for M9336A AWG)
This driver supports the following M9018A chassis driver releases:
Release Date |
Release Version |
2016-09-04 |
1.6.2.1 |
2015-02-05 |
1.5.80.1 |
Supported
Keysight Command Expert Releases
Command Expert can be used to write programs to
learn how the AWG module works and to perform simple operations. This driver supports the following Command Expert releases, with the most recent
release listed first.
Release Date |
Release Version |
Comments |
2019-03-09 |
2019 |
Use of this version is recommended |
2018-03-09 |
2018 |
|
2017-07-07 |
2017 Update 2 |
|
2017-06-14 |
2017 Update 1 |
|
2017-03-08 |
2017 |
|
2016-12-01 |
1.6 Update1 |
|
2016-05-25 |
1.6 |
|
IVI
Compliance
This page provides IVI-required compliance
information for the KtMAwg driver. IVI Compliance is
describes in the IVI Specifications at: http://ivifoundation.org/specifications/default.aspx.
IVI
Compliance Category
IVI drivers come in a variety of types and
configurations. This section provides IVI-required compliance information on
the various categories of IVI compliance for the KtMAwg
driver.
IVI Generation |
IVI-2014 |
Category Name |
IVI.NET/C Custom Specific Instrument Driver |
Class Specification Version |
Supports IviFgen version 5.0 |
The KtMAwg driver
supports the IVI Inherent Capabilities required of all IVI drivers. For
detailed information, refer to the KtMAwg
driver help file
.
Optional
Features
This section provides IVI-required information
regarding optional IVI driver features supported by the KtMAwg
driver.
Interchangeability checking |
No |
State caching |
No |
Coercion recording |
No |
Driver
Identification
This section provides IVI-required identity
information for the KtMAwg driver.
Driver Revision |
See driver version listed at top of this page |
Driver Vendor |
Keysight Technologies |
Driver Description |
IVI Driver for the M9336A/P9336A
Arbitrary Waveform Generator |
Prefix/Component Identifier |
KtMAwg |
Supported Models |
M9336A/P9336A |
Hardware
Information
P9336A AWG
Instrument Manufacturer |
Keysight Technologies |
Supported Instrument Models |
P9336A |
Supported Bus Interfaces |
USB 1.0 |
M9336A AWG
Instrument Manufacturer |
Keysight Technologies |
Supported Instrument Models |
M9336A |
Supported Bus Interfaces |
PXI, PXIe |
64-bit
Software Information
Supported Operating Systems |
Windows 7 64-bit, Windows 10 64-bit |
Unsupported Operating Systems |
Windows Vista 64-bit |
Support Software Required |
VISA |
Source Code Availability |
Source code is installed with this driver |
Unit
Testing
Test
Setup Instrument
P9336A AWG
Instrument Models (FW Revision) |
P9336A |
Bus Interface |
USB 1.0 |
Operating System (Service Pack) |
Windows 7 64-bit and Windows 10 64-bit |
OS Bitness/Application Bitness |
64-bit/64-bit |
VISA Vendor and Version |
Keysight VISA (IO Libraries Suite Version 2018 Update 0.1 or later) |
IVI Shared Components Version |
2.5.0 |
M9336A AWG
Instrument Models (FW Revision) |
M9336A |
Bus Interface |
PXI, PXIe |
Operating System (Service Pack) |
Windows 7 64-bit and Windows 10 64-bit |
OS Bitness/Application Bitness |
64-bit/64-bit |
VISA Vendor and Version |
Keysight VISA (IO Libraries Suite Version 2017 Update 1 or later) |
IVI Shared Components Version |
2.5.0 |
Test
Setup Simulation
Instrument Models |
M9336A/P9336A |
Bus Interface |
N/A |
Operating System (Service Pack) |
Windows 7 64-bit and Windows 10 64-bit |
OS Bitness/Application Bitness |
64-bit/64-bit |
VISA Vendor and Version |
N/A |
IVI Shared Components Version |
2.5.0 |
Driver
Installation Testing
Operating System (Service Pack) |
Windows 7 64-bit and Windows 10 64-bit |
OS Bitness/Application Bitness |
64-bit/64-bit |
Driver Buildability
Operating System (Service Pack) |
Windows 7 64-bit and Windows 10 64-bit |
OS Bitness/Application Bitness |
64-bit/64-bit |
Visual Studio Version |
VS2013 |
Known
Issues
Keysight
Technologies has evaluated and tested this driver to verify that it meets all
applicable requirements of the IVI specifications at this time. This compliance
document was submitted to the IVI Foundation and agrees to abide by the dispute
arbitration provisions in Section 7 of the IVI Specification, section 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.
Contact
Support
If you have feedback or need help using this
driver, contact Keysight Technical Support:
Trademarks
Ⓒ Keysight
Technologies 2017-2019
Microsoft, Windows, MS Windows, and Windows NT
are U.S. registered trademarks of Microsoft Corporation.