Agilent IO Libraries Suite 15.1

Table of Contents

What Is Agilent IO Libraries Suite?

System Requirements

Installing the Software

What's Changed?

Known Issues

Uninstalling the Software

License Grant

Agilent Open System Developer Community

 

What Is Agilent IO Libraries Suite?

 top

Agilent IO Libraries Suite is a collection of libraries and utility programs. The IO libraries (SICL, VISA, and VISA COM) enable instrument communication for a variety of development environments (Agilent VEE Pro, Microsoft Visual Studio, etc.) that are compatible with GPIB, USB, LAN, RS-232, and VXI test instruments from a variety of manufacturers. Several utility programs help you quickly and easily connect your instruments to your PC.

Establishing communication between your instruments and your PC is as easy as 1, 2, 3:

1.  Install the IO Libraries Suite: Get all the software you need to connect via GPIB, USB, LAN, and other standard interfaces.

2.  Connect Your Instrument:  Connect cables and apply power.

3.  Run Agilent Connection Expert to Configure Your Connection: See your system graphically and send commands to your instruments.

If you received two CD-ROMs with your Agilent product, install the IO Libraries Suite first. Then browse the second CD to find instrument drivers, documentation, and other application software, depending on the product you have purchased.

 

Note on Version Numbering: Agilent IO Libraries Suite is an enhanced, improved successor to the Agilent IO Libraries product. Agilent IO Libraries versions began with A.01.00 and ended with M.01.01. Agilent IO Libraries Suite versions began with 14.0, which is a higher version than M.01.01 for purposes of determining compatibility with other software and hardware products.

System Requirements for Agilent IO Libraries Suite 15.1

  top


The system requirements for Agilent IO Libraries Suite 15.1 are as follows:

Operating
System		Windows XP, Service Pack 3 (or later)
Windows 2000 Professional, SP 4 (or later)		Windows Vista (32 bit), Service Pack 1
(Business, Ultimate, Enterprise, Home Basic, Home Premium)1
Processor450MHz Pentium II or higher required
800MHz recommended		1Ghz 32-bit (x86)
Available
Memory		128MB minimum
(256MB or greater recommended)		512MB minimum
(1GB recommended)
Available
Disk Space2
  • 280MB minimum, 1GB recommended
    for Microsoft .NET Framework 2.0
  • 65MB for Agilent IO Libraries Suite
  • 280MB minimum, 1GB recommended
    for Microsoft .NET Framework 2.03
  • 65MB for Agilent IO Libraries Suite
VideoSuper VGA (800x600) 256 colors or moreSupport for DirectX 9 graphics with
128MB graphics memory recommended
(Super VGA graphics is supported)
BrowserMicrosoft Internet Explorer 5.01 or greaterMicrosoft Internet Explorer 7 or greater
1 Windows Vista 64-bit editions are not supported.
2 Note: because of the installation procedure, less memory may be required for operation than is required for installation.
3 .NET Framework 3.0 Runtime Components are installed by default with Windows Vista. Therefore, you may not need this amount of available disk space.

You may want the Adobe Reader, which will allow you to read Agilent IO Libraries Suite manuals in PDF format. It can be obtained at http://www.adobe.com.

Who is licensed to install IO Libraries Suite 15.x?

 

See the License Grant at the end of this file to determine whether you are licensed to install this software.

 

What if I need support for an older operating system?

It is generally best to use the current version of the Agilent IO Libraries Suite. This version will support the newest interfaces and operating systems, and will have the most advanced features. However, you may need to install an earlier version of the IO Libraries Suite to support an older interface or operating system. Refer to http://www.agilent.com/find/iolib to locate the version you need.

Installing the Software

 top

To install Agilent IO Libraries Suite 15.x:

First, disconnect any USB instruments, USB/GPIB converters, and FireWire® (IEEE 1394)-VXI interfaces that are connected to your PC.

Shut down all other applications that are running on the PC.

      If you have the Automation-Ready CD in your CD-ROM drive:

1.      Click this link, which opens a Windows File Explorer for the CD.

2.      Browse to the Autorun folder and double-click to execute auto.exe.

        If you are downloading Agilent IO Libraries Suite from the Web:

1.     Go to http://www.agilent.com/find/iolib.

2.      Download the IO Libraries Suite self-extracting zip file (*.exe) to any location on your hard disk.

3.      Double-click the .exe file to extract all files and start the installation process.

After the installation is complete, re-connect any devices that you disconnected prior to installing.

For detailed discussion of installation options, refer to the Agilent IO Libraries Suite Connectivity Guide. You will need Adobe Reader (available at www.adobe.com). You can also find the Connectivity Guide at http://www.agilent.com/find/iolib.

What's Changed in Agilent IO Libraries Suite 15.1?

  top

Agilent IO Libraries Suite 15.1 includes defect fixes and makes several significant improvements and additions:
  • LAN instrument discovery and configuration is now significantly easier and faster and includes mDNS.

  • Support for the LXI 1.3 standard. Support for this standard includes IEEE 1588-2008 Precision Time Protocol (PTP) standard. IO Libraries 15.0 included is a new Interactive LXI gui interface to test and experiment with both LAN/LXI events (to send and receive events) and the IEEE 1588 PTP.

  • IO Monitor has been significantly revised.

  • USBTMC driver for Windows Vista now supports the Microsoft-supplied WinUSB components. This also allows allows better interoperability with NI VISA.

  • On Agilent GPIB interfaces, the Agilent 488 board numbers now always track the VISA interface ID and the board number cannot be changed independently. E.g. GPIB1 has an Agilent 488 board number of 1; GPIB2 has a board number of 2; etc.

  • Duplicate VISA Interface ID’s, SICL Interface ID’s, Logical Unit numbers and Agilent 488 board numbers are now automatically resolved by renaming duplicate values.

  • Fixed a problem where loading sicl32.dll failed prematurely rather than waiting for the system to initialize after Windows startup or reboot.

  • Shortened the timeout while waiting to close an LAN instrument that is no longer present. The timeout now defaults to five seconds rather than 120 seconds.

  • LAN discovery in the LAN ‘Add Instrument’ dialog now discovers mDNS enabled instruments before doing its standard discovery.

  • Updated visa32.cs and visa32.vb to include a viEventHandler delegate definition plus new viInstallHandler and viUninstallerHandler definitions so event callbacks can be used from C# and VB.NET.

  • Reduced the ‘Reboot required’ occurrences when Agilent 8235x GPIB interface parameters are changed and when IO Libraries are installed or updated.

  • Allows changing the Logical Unit parameter on Agilent 82357 interfaces.

  • IO Libraries now detects and configures more than four NI-488.2 GPIB interfaces.

IO Libraries 15.0 added the following features:
  • VISA Open Reports added to help diagnose IO problems.
  • VISA 4.0 Compliance
  • Microsoft Windows VISTA support
  • The option to Enable Agilent GPIB cards for 488 programs is disabled by default if another vendor’s NI-488.2–compatible library is also installed. This reduces the likelihood of error messages from the third-party software. (You can always enable this option and your 488 programs will work correctly, regardless of the presence of third-party software.)
  • Location of Agilent Connection Expert log changed: As part of the migration to Vista, we moved the location of the Ace.log file out of:
        C:\Program Files\Agilent\IO Libraries Suite
    to the standard Windows location for program data. In Windows XP it is:
        C:\Documents and Settings\All Users\Application Data\Agilent\Agilent IO Libraries
    and in Windows Vista it is:
        C:\ProgramData\Agilent\Agilent IO Libraries
  • Agilent IO Libraries Suite 15 uses the new IVI VISA COM Standard Components. They install both the IVI VISA COM files, and create the VXIplug&play directory structure if it doesn't already exist. The default base directory for the VXIpnp components in this installer is:
        C:\Program Files\IVI Foundation\VISA
    Note that if you already have a set of VXIpnp directories on your PC, the new installer will continue to use your current set of directories (probably either
        C:\Program Files\VISA
    or
        C:\VXIPNP
    and not create a new set in
        C:\Program Files\IVI Foundation\VISA.
  • The default board number for Agilent PCI-GPIB interfaces is now zero, to conform to hardcoded board numbers in many NI-488.2 programs.
  • The default board number for National Instruments PCI-GPIB cards in Agilent Connection Expert is now 0 (it was 21). This makes Connection Expert more compatible with the NI-MAX default value. However, one or more of the following situations may occur:
    1) An additional device appears in the VISA Open report at the board GPIB address specified in Agilent Connection Expert. The device is shown as configured in NI-MAX.
    2) Agilent Connection Expert shows a real device on the interface as 'OK' but Interactive IO returns a VI_ERROR_IO when doing a *IDN?
    3) NI-MAX reports an error on the real device when scanning for instruments.
    4) Agilent Connection Expert shows the real device in the error state.

Known Issues

  top

  • IO Monitor: Agilent IO Monitor installed as part of Agilent T&M ToolKit will cease to function after IO Libraries Suite 15.x is installed. IO Libraries installs a newer, revised version of IO Monitor.

  • Windows Vista Power Management: Microsoft changed the Power Management behavior in Windows Vista. Vista does not send a QuerySuspend message to the service. Apparently there have been problems with people closing their laptop computers expecting them to sleep but with XP, if a program (such as IOLibraries) refused the query suspend, the machine would display a message and not sleep. Since the laptop had been closed, the user never saw the message - he just put his laptop back in the case where it either overheated or drained the battery. In Vista this won't happen because programs never get the option to refuse a QuerySuspend. When running the LAN server on a Vista machine, the machine must be configured to not enter sleep mode. If it does, the LAN server will cease to respond and any remote IO that is in progress will fail. On Windows XP and Windows 2000, the AgilentIOLibrariesService prevents transition to 'standby' mode.

  • Location of Agilent Connection Expert log changed: As part of the migration to Vista, we moved the location of the Ace.log file out of:
        C:\Program Files\Agilent\IO Libraries Suite
    to the standard Windows location for program data. In Windows XP it is:
        C:\Documents and Settings\All Users\Application Data\Agilent\Agilent IO Libraries
    and in Windows Vista it is:
        C:\ProgramData\Agilent\Agilent IO Libraries

  • Instruments disappear in Connection Expert: When you install IO Libraries Suite 15 and one or more of your LAN instruments no longer appear in the Connection Expert, it may be because those instruments have incorrect subnet masks. Refer to the instrument's documentation.


  • VISA Assistant help file does not work in Vista OS: WinHlp32.exe is required to display 32-bit Help files that have the ".hlp" file name extension. To view .hlp files on Windows Vista, you need to install the WinHlp32.exe. If you click on Help > Help Topics, an error message pops up stating the problem and providing the following link to install WinHlp32.exe:
    http://www.microsoft.com/downloads/details.aspx?familyid=6EBCFAD9-D3F5-4365-8070-334CD175D4BB&displaylang=en


  • LAN Discovery without DNS: The ‘Auto Find’ capability for LAN instruments may, under some conditions fail to find instruments that are present on the local subnet if there is no DNS server available. The problem can manifest as long search times or a search that returns few or no instrument. This problem can occur when you reconfigure you LAN topology without rebooting the PC or the router. If a DNS server was configured but is no longer available, Windows will still attempt to reach the configured DNS server and may take 30 seconds or more before giving up and deciding that it can’t resolve a hostname. The severity of this problem varies with different routers. Some routers cause long DNS delays and others do not. If you experience LAN discovery delays or problems due to DNS issues, here are some suggestions to work around the problem.
    1. Uncheck the ‘Lookup hostnames’ box so the Connection Expert will not attempt to do a DNS lookup.
    2. Reboot both the router and the PC after changing LAN topology to make sure the current DNS situation is reflected in the LAN setup of both the PC and the router.
    3. Manually configure your LAN instruments using IP addresses, not host names.
    Note: it is not necessary to configure a LAN instrument in the Connection Expert for a program to be able to communicate with it. If the IP address of the device is known, a program can talk to it even if it is not configured in the Connection Expert.

  • Vista Installation with UAC Disabled: If you experience problems installing Agilent IO Libraries on a system with Windows Vista OS, you may have User Account control (UAC) Enabled. Typically, you may get an error message stating that a directory name is invalid. UAC must be disabled prior to installing IO Libraries.

    To disable UAC:
    1. Log into your system with Administrator privileges.
    2. Left mouse click the Start button (lower right-hand corner).
    3. Click Control Panel > Administrative Tools > Local Security Policies
    4. Click Local Policies > Security Options
    5. Scroll down to the bottom of the Policy list. You may also need to increase the width of the Policy pane.
    6. Locate the policy, “User Account Control: Run all administrators in Admin Approval Mode”.
    7. If it is “Enabled”, you must change it to “Disabled”.
    8. Right mouse click on the UAC and select Properties. Select the “Disabled” radio button and click OK.
    9. Close out of all the windows.
    10. You must reboot your computer before the setting will take place.
    For additional information, refer to: http://technet2.microsoft.com/WindowsVista/en/library/0d75f774-8514-4c9e-ac08-4c21f5c6c2d91033.mspx?mfr=true

  • Windows Vista, PTP and LXI C samples may not run the first time from Visual Studio 2005. If you attempt to open the C sample projects for LXI and PTP by double clicking on the solution file in the Windows Explorer after starting the IO Libraries install from that same explorer, the projects will compile, but the resulting sample programs will not run from Visual Studio. The symptom is a dialog box saying that the PtpManagerC.dll (PTP sample) or LxiEventManagerC.dll (LXI sample) cannot be found. The error is caused by a Vista defect that fails to refresh the environment variables passed to programs started based on file associations.
    Workaround: Close all instances of Windows Explorer after completing installation of IO Libraries. Thereafter, the environment variables seen by Visual Studio reflect the additions made by the IO Libraries install and the C samples will find PtpManagerC.dll or LxiEventManagerC.dll and run successfully.

  • Configuring a remote USB1. Note: NI corrected this problem in their VISA version 4.4 and later. If you are using NI VISA prior to version 4.4 and you configure a remote USB1 device, NI-VISA will find it and report it correctly if NI Passport for VISA is enabled. But when you try to open the USB1 device, NI appears to ignore the board number on the USB interface and attempts to open it on their USB0 interface. This process fails. Agilent's VISA Open Report correctly shows the USB1 device and indicates that it is managed by Agilent Connection Expert and that the device is available to a VISA program. This device can only be accessed by VISA programs that use an Agilent Connection Expert configured alias to the USB1 device.

Uninstalling the Software

  top

Use the Windows Control Panel ("Add or Remove Programs" in Windows XP or "Programs and Features" in Windows Vista) to remove the Agilent IO Libraries Suite. Do not delete files directly.

Removing the IO Libraries Suite does not delete the standard VISA directory, standard VISA COM files, standard IVI (Interchangeable Virtual Instrument Foundation) files, and IVI Shared Components. There is no reliable way for the IO Libraries Suite uninstaller to be sure that no other installed product (whether from Agilent or another vendor) is using these files and directories.

License Grant

  top

For every individual Agilent instrument, Agilent hardware I/O product (including Agilent GPIB cards and Agilent I/O converters), and development copy of Agilent T&M Toolkit or Agilent VEE Pro that you legally own or have a valid, legal license from Agilent to use, Agilent grants you one non-exclusive license of the Software at no charge pursuant to the terms of the License Agreement. The License Agreement is displayed when you install the software and is available in the IO Libraries Suite Online Help.  You may download one copy of the Software, and store or run that copy of the Software for internal use and purposes in accordance with this Agreement and the documentation provided with the Software.  Such documentation may include license terms provided by Agilent's third party suppliers, which will apply to the use of the Software and take precedence over these license terms.  In the absence of documentation specifying the applicable license, you may store or run one copy of the Software on one machine or instrument.  If the Software is otherwise licensed for concurrent or network use, you may not allow more than the maximum number of authorized users to access and use the Software concurrently.

Agilent Open System Developer Community

Thank you for your interest in Agilent IO Libraries Suite 15.x.  As you use IO Libraries Suite, we also invite you to join the Agilent System Developer community at www.systemcomponents.tm.agilent.com for additional test & measurement connectivity resources and information free of charge.

Microsoft and Windows are U.S. registered trademarks of Microsoft Corporation.

FireWire is a registered trademark of Apple Computer, Inc.

Copyright © Agilent Technologies, Inc. 2004-2008