Agilent IO Libraries Installation and Configuration Guide for Windows Manual Part Number: E2094-90022 Printed in U.S.A.
Contents IO Libraries Installation and Configuration Guide for Windows Front Matter ............................................................................................... 5 Notice ............................................................................................ 5 Warranty Information .................................................................... 5 U.S. Government Restricted Rights .............................................. 5 Trademark Information ...............................
3. Using IO Configuration Utilities ........................................................ 53 Getting Started .............................................................................55 Before You Begin Configuration ...........................................55 Getting Started Using IO Configuration Utilities ....................55 Using IO Config ............................................................................56 IO Config Requirements .....................................................
Notice The information contained in this document is subject to change without notice. Agilent Technologies shall not be liable for any errors contained in this document. Agilent Technologies makes no warranties of any kind with regard to this document, whether express or implied. Agilent Technologies specifically disclaims the implied warranties of merchantability and fitness for a particular purpose.
Trademark Information Microsoft®, Windows ® 95, Windows ® 98, Windows ® 2000, Windows ® Me and Windows NT® are U.S. registered trademarks of Microsoft Corporation. All other brand and product names are trademarks or registered trademarks of their respective companies.
1 Introducing the IO Libraries 7
Introducing the IO Libraries This Agilent IO Libraries Installation Guide for Windows shows how to install and configure Agilent IO Libraries on Windows 95, Windows 98, Windows Me, Windows NT 4.0, and Windows 2000. NOTE This guide does not include instructions to install IO Libraries on HP-UX systems. See the I/O Libraries Installation and Configuration Guide for HP-UX for HP-UX system installation. Unless otherwise indicated, Windows NT refers to Windows NT 4.0.
Introducing the IO Libraries Using This Guide Using This Guide This guide shows how to install and configure the Agilent IO Libraries software. What’s in This Guide? The steps described in this guide assume: n The software will be installed on a Windows-based PC instrument system. The PC can be an external or an embedded PC. n You have already installed and configured the interfaces for your system and have installed any required application programs (C/C++, Agilent VEE, etc.).
Introducing the IO Libraries IO Libraries Overview IO Libraries Overview The Agilent IO Libraries application consists of two libraries: Agilent Virtual Instrument Software Architecture (VISA) and Agilent Standard Instrument Control Library (SICL) plus four I/O Utilities: IO Config, VISA Assistant, VXI Resource Manager, and LAN Server. See Chapter 3 - Configuring I/O Interfaces for details on the I/O Utilities.
Introducing the IO Libraries IO Libraries Overview Software development using VISA is intended for instrument I/O and C/C++ or Visual BASIC programmers who are familiar with Windows 95, Windows 98, Windows Me, Windows 2000, or Windows NT. To perform VISA installation and configuration on Windows NT, you must have system administration privileges on the Windows NT system. VISA Documentation This table shows associated documentation you can use when programming with Agilent VISA.
Introducing the IO Libraries IO Libraries Overview Agilent SICL Description Agilent Standard Instrument Control Library (SICL) is an I/O library developed by Agilent that is portable across many I/O interfaces and systems. I/O applications using this library can be ported at the source code level from one system to another with few (or no) changes. You can use Agilent SICL if you have been using SICL and want to remain compatible with software currently implemented in SICL.
Introducing the IO Libraries IO Libraries Overview IO Config Description The IO Config utility is used by the Agilent IO Libraries to configure instrument I/O hardware interfaces. An interface must be configured with IO Config before the interface can be used with the IO Libraries. You can configure all available interfaces with IO Config for use with the Agilent IO Libraries. With IO Config, you can also add, edit, or remove configuration entries for the interface(s) you specify.
Introducing the IO Libraries IO Libraries Overview VXI Resource Manager Description If your system includes an E8491 IEEE-1394 PC Link to VXI interface, you can view the output of the VXI Resource Manager to determine if your system is properly configured. The easiest way to view this output is to use the IO Config utility to run the VXI Resource Manager. The VXI Resource Manager initializes and prepares the VXI system for use.
2 Installing the IO Libraries 15
Installing the IO Libraries This chapter shows how to install the libraries on Windows 95, Windows 98, Windows Me, Windows NT, and Windows 2000. Chapter contents are: n n n n Getting Started Installing New IO Libraries Upgrading Existing IO Libraries Maintaining Existing IO Libraries See the following table to select the applicable installation section for your PC configuration. Note that IO Library version numbers skip from H to J. There are no I versions of the Agilent IO Libraries.
Installing the IO Libraries Getting Started Getting Started This section gives guidelines to get started installing the Agilent IO Libraries, including system requirements and supported interfaces. You should verify that your system meets the minimum requirements shown and the system interfaces are supported before you install the Agilent IO Libraries. Before You Begin Before you begin installation of the Agilent IO Libraries, please consider the following items.
Installing the IO Libraries Getting Started System Requirements The following table summarizes minimum hardware and software requirements to install and use the IO Libraries. Adding additional RAM may improve overall system performance. Item Minimum Requirements Hardware Requirements PC Operation/ Memory 100 MHz operation and 16 MB RAM. PC Plug-in Slots EISA I/O slots for GPIB, RS-232, or GPIO interface or for a LAN adapter. PCI slots for GPIB (PCI) and IEEE-1394 interfaces.
Installing the IO Libraries Getting Started Supported Interfaces This table shows the I/O interfaces supported for 32-bit applications (16-bit applications are not supported). The table shows the IO Libraries version (or later) required, based on the IO interface and operating system used. For example, a J.02.00 entry means version J.02.00 or later. Windows 95 Windows 98 Windows Me Windows 2000 Windows NT 4.0 82335B GPIB Interface for MS Windows and DOS J.02.
Installing the IO Libraries Getting Started IO Libraries Versions Support This table shows the operating systems and interfaces supported by versions G.02.00 through K.01.00 of the Agilent IO Libraries. See “Supported Interfaces” for a description of each interface. IO Libraries Version Supported Operating Systems Supported Interfaces See Note K.01.00 Windows 98 Windows Me Windows NT 4.0 Windows 2000 82341C 82350A E2050A E1406A E8491B E623x E985x RS-232 1 J.02.
Installing the IO Libraries Installing New IO Libraries Installing New IO Libraries Use these steps to install a new version of the IO Libraries on your PC. The steps in this section assume no version of the IO Libraries is installed on the PC. n If you have a version of the IO Libraries already installed on your PC and want to upgrade, see “Upgrading Existing IO Libraries”. n If you want to modify, repair, or remove the same version of an existing IO Library, see “Maintaining Existing IO Libraries”.
Installing the IO Libraries Installing New IO Libraries 4 The InstallShieldÒ Wizard appears to begin the IO Libraries installation. 5 When the title screen appears, click Next > to go to the License Agreement screen and then click Yes to accept the license terms and to display the Readme Information screen. NOTE The Readme Information screen contains important information on the IO Libraries. We suggest you read this information before continuing with IO Libraries installation.
Installing the IO Libraries Installing New IO Libraries 8 Use this table for guidelines to select the type of installation for your application. Then, click Next > to install the option. Option Description 1. SICL and Agilent VISA Installation Installs SICL and Agilent VISA with the default options for your computer configuration. This option allows development and runtime capabilities using SICL and Agilent VISA. The option also allows you to select Agilent E8491 IEEE-1394 to VXI support.
Installing the IO Libraries Installing New IO Libraries Option 2. SICL and side-by-side Agilent VISA Installation Description Installs SICL and side-by-side Agilent VISA with the default options for your computer configuration. With this option, another vendor’s VISA will not be overwritten. Beginning with version K.01.00, you can install Agilent VISA as a secondary VISA (side-by-side). When this is done, Agilent VISA will not overwrite another vendor's VISA, if one is present on the computer.
Installing the IO Libraries Installing New IO Libraries Option 3. SICL Installation Description Installs SICL (but not Agilent VISA) with the default options for your computer configuration. This option allows development and runtime capabilities using SICL. The option also allows you to select Agilent E8491 IEEE-1394 to VXI support. If another vendor’s VISA is installed, installing this option will not overwrite the other vendor’s VISA. 4.
Installing the IO Libraries Installing New IO Libraries NOTE A different screen will appear if it is not necessary to restart the computer. Even if you are not prompted to restart the computer, if you experience difficulty after installing the IO Libraries, restart the computer to see if this solves the problem.
Installing the IO Libraries Installing New IO Libraries Steps to Install New IO Libraries (Modified) NOTE This section applies ONLY to the systems listed. For a Windows NT 4.0 operating system OR for other IO cards, do NOT use this section. Use “Steps to Install New IO Libraries (Standard)”. n Windows 95/98/Me/2000 operating system and a 1394 PCI FireWire card connected to an Agilent E8491B VXI interface or n Windows 95/98/Me/2000 operating system and an Agilent 82350 PCI GPIB card.
Installing the IO Libraries Installing New IO Libraries 4 When the title screen appears, click Next > to go to the License Agreement screen and then click Yes to accept the license terms and to display the Readme Information screen. NOTE The Readme Information screen contains important information on the IO Libraries. We suggest you read this information before continuing with IO Libraries installation. 28 5 Click Next > to display the SICL installation directory screen.
Installing the IO Libraries Installing New IO Libraries 7 Use this table for guidelines to select the type of installation for your application. Then, click Next > to install the option. Option Description 1. SICL and Agilent VISA Installation Installs SICL and Agilent VISA with the default options for your computer configuration. This option allows development and runtime capabilities using SICL and Agilent VISA. The option also allows you to select Agilent E8491 IEEE-1394 to VXI support.
Installing the IO Libraries Installing New IO Libraries Option 2. SICL and side-by-side Agilent VISA Installation (continued) Description Copies of the Agilent version of the VISA support files are in the 'agbin', 'include' and 'lib' subdirectories under \agvisa. These files are installed even when Agilent VISA is the primary VISA. The Agilent VISA utilities vifind32.exe and VISA Assistant use Agilent VISA even if another vendor's VISA is installed as primary VISA.
Installing the IO Libraries Installing New IO Libraries 9 Move through the screens (as applicable to the option selected) until you get to the IO Libraries Configuration screen. Then, select the type of configuration you want performed (automatic, manual, or none) and click Next > to start the installation. 10 When installation is complete, the Installation Complete screen appears. Note that you must re-start your computer to initialize the IO Libraries.
Installing the IO Libraries Installing New IO Libraries 13 1394 FireWire Card connected to an E8491B VXI Interface Card n Windows 95. If the Wizard asks for the HPI/OLibraries CD, click OK. When the Wizard asks for the wn1394.vxd file, browse to C:\windows\system\ and click OK. n Windows 98. If the Wizard asks for the 1394bus.sys file, you must provide the CD for the Windows 98 operating system and let the Wizard search for and install the file.
Installing the IO Libraries Installing New IO Libraries What Was Created During Installation? Depending on the installation option you selected, SICL and/or VISA were installed and several program icons were created. In addition, an Agilent IO Libraries Control was created. Program Groups Created During installation, the Agilent IO Libraries program group was created. To access this group, click Start|Programs|Agilent IO Libraries to display the following icons.
Installing the IO Libraries Installing New IO Libraries A typical display follows when View Documentation is selected. You can run IO Config, VISA Assistant, or VXI Resource Manager to configure your specific system. In addition, you can run the Event Viewer (Message Viewer) for troubleshooting or you can select VISA Logging for logging messages. Electronic manuals (.
Installing the IO Libraries Installing New IO Libraries Clicking View Documentation|Installation and Paths Information displays the IO Libraries, VISA, and Registry installation paths. This is primarily useful for troubleshooting installation problems. See the following figures for typical displays. The first figure shows Agilent VISA as the primary VISA, while the second figure shows Agilent VISA installed side-by-side with another vendor’s VISA.
Installing the IO Libraries Upgrading Existing IO Libraries Upgrading Existing IO Libraries Use these steps to upgrade existing IO Libraries on your PC. The steps in this section assume version H.01.03 or earlier of the IO Libraries is already installed on your PC and you are installing version J.01.00 or later of the IO Libraries. n If no version of the IO Libraries is installed on your PC and you want to install a new version, see “Installing New IO Libraries”.
Installing the IO Libraries Upgrading Existing IO Libraries 5 An Upgrade screen appears that shows the current version installed and the new version that will be installed. 6 Click Next > to go to the License Agreement screen and then click Yes to accept the license terms and to display the Readme Information screen. NOTE The Readme Information screen contains important information on the IO Libraries. Please read this information before continuing with IO Libraries upgrade.
Installing the IO Libraries Upgrading Existing IO Libraries 7 After reading the ReadMe information, click Next > to display the Select Type of Installation screen. 8 Use this table for guidelines to select the type of installation for your application. Then, click Next > to install the option. Option Description 1. SICL and Agilent VISA Installation Installs SICL and Agilent VISA with the default options for your computer configuration.
Installing the IO Libraries Upgrading Existing IO Libraries Option 2. SICL and side-by-side Agilent VISA Installation Description Installs SICL and side-by-side Agilent VISA with the default options for your computer configuration. With this option, another vendor’s VISA will not be overwritten. Beginning with version K.01.00, you can install Agilent VISA as a secondary VISA (side-by-side). When this is done, Agilent VISA will not overwrite another vendor's VISA, if one is present on the computer.
Installing the IO Libraries Upgrading Existing IO Libraries Option Description 3. SICL Installation Installs SICL (but not Agilent VISA) with the default options for your computer configuration. This option allows development and runtime capabilities using SICL. The option also allows you to select Agilent E8491 IEEE-1394 to VXI support. If another vendor’s VISA is installed, installing this option will not overwrite the other vendor’s VISA. 4.
Installing the IO Libraries Upgrading Existing IO Libraries 11 When installation is complete, the Installation Complete screen appears. Note that you must re-start your computer to initialize the IO Libraries. Select the Yes or No option, remove any disks from their drives, and click Finish to complete the installation. NOTE A different screen will appear if it is not necessary to restart the computer.
Installing the IO Libraries Upgrading Existing IO Libraries What Was Created During Installation? Depending on the installation option you selected, SICL and/or VISA were installed and several program icons were created. In addition, an Agilent IO Libraries Control was created. Program Groups Created During installation, the Agilent IO Libraries program group was created. To access this group, click Start|Programs|Agilent IO Libraries to display the following icons.
Installing the IO Libraries Upgrading Existing IO Libraries A typical display follows, with View Documentation highlighted. You can run IO Config, VISA Assistant, or VXI Resource Manager to configure your specific system. In addition, you can run the Event Viewer (Message Viewer) for troubleshooting or you can select VISA Logging for logging messages. Electronic manuals (.
Installing the IO Libraries Upgrading Existing IO Libraries Clicking View Documentation|Installation and Paths Information displays the IO Libraries, VISA, and Registry installation paths. This is primarily useful for troubleshooting installation problems. See the following figures for typical displays. The first figure shows Agilent VISA as the primary VISA, while the second figure shows Agilent VISA installed side-by-side with another vendor’s VISA.
Installing the IO Libraries Maintaining Existing IO Libraries Maintaining Existing IO Libraries This section gives guidelines to modify, repair, or remove the same version of the IO Libraries (version J.01.00 or later) currently installed on your PC. n To modify the same version of an existing IO Library, see “Steps to Modify IO Libraries”. n To repair the same version of an existing IO Library, see “Steps to Repair IO Libraries”.
Installing the IO Libraries Maintaining Existing IO Libraries 46 4 After a few seconds, the Setup Maintenance screen appears. From this screen, select Modify and then click Next > to modify the current IO Libraries installation. 5 When the Tree View screen appears, select the components you want to install and clear the components you do not want to install.Then, click Next > to begin the (modified) installation.
Installing the IO Libraries Maintaining Existing IO Libraries 6 After the modified setup is installed, the IO Libraries Configuration screen appears. Select an option and then click Next > to complete the modification process. n If you select “Refresh configured interfaces” or “Auto-configure all interfaces”, all applicable interfaces are refreshed or configured. n If you select “Manually configure interfaces”, the IO Config utility appears from which you can manually configure interfaces.
Installing the IO Libraries Maintaining Existing IO Libraries 7 For any option selected, when the Setup Complete screen appears, (see the following figure) click Finish to complete the process and then remove the IO Libraries for Instrument Control CD. Steps to Repair the IO Libraries 48 1 Turn the PC ON and close all open applications. 2 Insert the Agilent IO Libraries for Instrument Control CD into the CD-ROM drive and wait a few seconds for the application to run.
Installing the IO Libraries Maintaining Existing IO Libraries 4 After a few seconds, the IO Libraries Setup Maintenance screen appears. From this screen, select Repair and then click Next > to re-install the current IO Libraries components. 5 The Setup Status screen appears, and the existing IO Library components are re-installed.
Installing the IO Libraries Maintaining Existing IO Libraries 6 When re-installation is complete, the Setup Complete screen appears. Click Finish to complete the process and then remove the IO Libraries for Instrument Control CD. Steps to Remove the IO Libraries 50 1 Turn the PC ON and close all open applications. 2 Insert the Agilent IO Libraries for Instrument Control CD into the CD-ROM drive and wait a few seconds for the application to run.
Installing the IO Libraries Maintaining Existing IO Libraries 4 After a few seconds, the IO Libraries Setup Maintenance screen appears. From this screen, select Remove and then click Next > to remove the current IO Libraries installation. 5 The Confirm Delete screen appears. Click Yes to delete all currently installed IO Libraries components.
Installing the IO Libraries Maintaining Existing IO Libraries 6 52 When component removal is complete, the following screen appears. Click Finish to complete the process and then remove the IO Libraries for Instrument Control CD.
3 Using IO Configuration Utilities 53
Using IO Configuration Utilities This chapter gives guidelines to use IO utilities to configure I/O interfaces, including: n n n n n Getting Started Using I/O Config Using VISA Assistant Using VXI Resource Manager Using LAN Server NOTE In most cases, you can open and run the IO Config utility and use the default choices for your specific interface. If you have questions about interface configuration or you want to change the interface settings, see Chapter 4 - Configuring IO Interfaces.
Using IO Configuration Utilities Getting Started Getting Started Depending on the hardware interfaces in your system, you can use one or more IO utilities to configure the Agilent IO Libraries for your system. This section shows how to get started using these utilities.
Using IO Configuration Utilities Using IO Config Using IO Config This section gives guidelines to use the IO Libraries configuration utility IO Config. You can use IO Config to configure hardware interfaces (such as an 82350A GPIB card, etc.) for use with VISA and SICL on a Windows 95, Windows 98, Windows Me, Windows 2000, or Windows NT environment.
Using IO Configuration Utilities Using IO Config Running IO Config The purpose of IO Config is to configure an I/O interface for use with VISA or SICL. IO Config does this by associating a unique VISA and/or SICL name with a hardware interface. To begin this configuration: 1 Open IO Config by double-clicking the IO Config icon in the IO Libraries program group or by clicking the Agilent IO Libraries Control icon (blue IO icon on the Windows taskbar) and then selecting Run IO Config.
Using IO Configuration Utilities Using IO Config 2 The above figure shows the available interface types (ASRL, GPIB, etc.) you can configure with IO Config and a description of each interface. In addition, the figure shows Configured Interfaces (interfaces already configured). Each configured interface has an associated VISA and/or SICL name.
Using IO Configuration Utilities Using IO Config 5 If you want IO Config to automatically configure new interfaces, click the Auto Add button. However, Auto Add will not add an 82341 ISA GPIB card, nor will it remove any interfaces that are no longer installed. 6 In most cases, you can use the automatic defaults. However, if you need to change a value, click the arrows next to the value’s field. If there are no arrows, click the field and type in the value you want.
Using IO Configuration Utilities Using IO Config GPIB Interface (82350 PCI GPIB Cards) Interface VISA/SICL Names Windows PC GPIB Cable GPIB Instruments 5 VISA Name SICL Name "GPIB0" "hpib7" 82350 GPIB Card #1 "GPIB1" "hpib8" 82350 GPIB Card #2 3 3 VISA/SICL Addressing VISA: viOpen (... "GPIB0::5::INSTR"...) viOpen (... "GPIB0::3::INSTR"...) viOpen (... "GPIB1::3::INSTR"...
Using IO Configuration Utilities Using VISA Assistant Using VISA Assistant VISA Assistant is an application program that uses the IO Libraries to communicate with and to control VXI, GPIB, and serial Instruments. VISA Assistant Overview VISA Assistant can automatically detect and assign VXIplug&play instrument drivers to instruments. VISA Assistant can also be used to send and receive strings to instruments which support formatted I/O.
Using IO Configuration Utilities Using the VXI Resource Manager Using the VXI Resource Manager If your system includes an E8491 IEEE-1394 PC Link to VXI interface, you can view the output of the VXI Resource Manager to determine if your system is properly configured. VXI Resource Manager Overview The VXI Resource Manager initializes and prepares the VXI system for use.
Using IO Configuration Utilities Using the VXI Resource Manager Opening VXI Resource Manager The easiest way to view this output is to use the IO Config utility to run the VXI Resource Manager. Click Start|Programs|Agilent IO Libraries|IO Config OR click the Agilent IO Libraries Control icon and select Run IO Config to display the IO Config main panel. Highlight the E8491 IEEE 1394 to VXI entry. Then, click Configure.
Using IO Configuration Utilities Using the VXI Resource Manager On the main screen, highlight the vxi entry and then click Edit to re-display the E8491 VXI Board Configuration screen. Click Edit VISA Config... on this screen to display the Show Devices screen.
Using IO Configuration Utilities Using the VXI Resource Manager On the Show Devices screen, you can add or remove devices manually or auto-add devices. Click OK when you have added/deleted devices manually. NOTE If the Identify devices at run-time box is not checked, the only devices that VISA can open are the ones listed in the Devices present on interface VXIn box. You can add or remove devices from this box using the Add device or Remove device buttons, respectively.
Using IO Configuration Utilities Using the VXI Resource Manager Displaying VXI Resource Manager Output If an E8491 has previously been installed and configured with IO Config, the VXI Resource Manager will automatically run every time Windows starts. If you change the E8491 configuration in IO Config, the VXI Resource Manager will run automatically (after a 5-second delay) when IO Config is closed. After the VXI Resource Manager has run, you can view its output.
Using IO Configuration Utilities Using the LAN Server Using the LAN Server If you configured the LAN server on this system using IO Config, you must now start the LAN server process on this system. Starting the LAN Server n To start the LAN server, you can either restart (reboot) this system now or manually start the LAN server process on this system.
Using IO Configuration Utilities Using the LAN Server 68 Chapter 3
4 Configuring I/O Interfaces 69
Configuring I/O Interfaces This chapter gives guidelines to use IO configuration utilities to configure I/O interfaces, including: n n n n Configuring GPIB Interfaces Configuring VXI Interfaces Configuring LAN Interfaces Configuring Other Interfaces NOTE See Chapter 3 - Using IO Configuration Utilities for information on using IO Configuration utilities (IO Config, VISA Assistant, VXI Resource Manager, and LAN Server) to configure I/O interfaces.
Configuring I/O Interfaces Configuring GPIB Interfaces Configuring GPIB Interfaces This section gives guidelines to use the IO Config utility to configure GPIB interfaces, including: n GPIB Interface Overview n Configuring GPIB (82350 PCI) Interfaces n Configuring GPIB (82341 ISA) Interfaces GPIB Interfaces Overview As shown in the following figure, a typical GPIB interface consists of a Windows PC with one or more GPIB cards (PCI and/or ISA) cards installed in the PC and one or more GPIB instruments con
Configuring I/O Interfaces Configuring GPIB Interfaces Configuring GPIB (82350 PCI) Interfaces An IO interface can be defined as both a hardware interface and as a software interface. The purpose of the IO Config utility is to associate a unique interface name with a hardware interface. The IO Libraries use an Interface Name or Logical Unit Number to identify an interface.
Configuring I/O Interfaces Configuring GPIB Interfaces When the 82350 PCI GPIB Card Configuration screen appears (see the following figure), set the VISA and SICL Interface Names and the Logical Unit and Bus Address values as required. Then, click the OK button. If you have more than one 82350 card in your system, repeat for remaining cards. NOTE After the system is configured, this screen may also display an Edit VISA Config... button.
Configuring I/O Interfaces Configuring GPIB Interfaces GPIB Interface (82350 PCI GPIB Cards) Interface VISA/SICL Names Windows PC GPIB Cable GPIB Instruments 5 VISA Name SICL Name "GPIB0" "hpib7" 82350 GPIB Card #1 "GPIB1" "hpib8" 82350 GPIB Card #2 3 3 VISA/SICL Addressing VISA: viOpen (... "GPIB0::5::INSTR"...) viOpen (... "GPIB0::3::INSTR"...) viOpen (... "GPIB1::3::INSTR"...
Configuring I/O Interfaces Configuring GPIB Interfaces Configuring GPIB (82341 ISA) Interfaces An IO interface can be defined as both a hardware interface and as a software interface. The purpose of the IO Config utility is to associate a unique interface name with a hardware interface. The IO Libraries use an Interface Name or Logical Unit Number to identify an interface.
Configuring I/O Interfaces Configuring GPIB Interfaces When the 82341 ISA GPIB Card Configuration screen appears, set the VISA and SICL Interface Names and the Logical Unit, IRQ Line, and Bus Address values as required. Then, click the OK button. If you have more than one 82341 card in your system, repeat for remaining cards. NOTE After the system is configured, this screen may also display an Edit VISA Config... button. Clicking this button allows you to manually configure the interface as desired.
Configuring I/O Interfaces Configuring GPIB Interfaces Since unique names have been assigned by IO Config, you can use the VISA viOpen command to open the I/O paths to the GPIB instruments as shown in the above figure. Or, you can use the SICL iopen command to open the I/O paths shown. See the Agilent VISA User’s Guide for details on VISA commands. See the Agilent SICL User’s Guide for Windows for details on SICL commands.
Configuring I/O Interfaces Configuring VXI Interfaces Configuring VXI Interfaces This section gives guidelines to use the IO Config utility to configure VXI interfaces, including: n VXI Interfaces Overview n Configuring GPIB-VXI (E1406A) Interfaces n Configuring VXI (E8491B) Interfaces VXI Interfaces Overview As shown in the following figure, a typical VXI interface consists of one of two main hardware configurations: E1406A Command Module or E8491B IEEE-1394 to VXI Module.
Configuring I/O Interfaces Configuring VXI Interfaces n The E1406A Command Module version consists of a Windows PC with an 82350 (or equivalent) GPIB card and a VXI mainframe with an E1406A Command Module and one or more VXI instruments. I/O communication from the PC to the VXI instruments is via the GPIB card, GPIB cable, and E1406A Command Module.
Configuring I/O Interfaces Configuring VXI Interfaces 80 Chapter 4
Configuring I/O Interfaces Configuring VXI Interfaces Example: Configuring GPIB-VXI (E1406A) Interface The GPIB-VXI interface system in the following figure consists of a Windows PC with an 82350 GPIB card that connects to an E1406A Command Module in a VXI Mainframe. The VXI mainframe includes one or more VXI instruments. When the IO Libraries were installed, a GPIB-VXI driver with GPIB address 9 was also installed and the E1406A was configured for primary address 9 and logical address (LA) 0.
Configuring I/O Interfaces Configuring VXI Interfaces Configuring VXI (E8491B) Interfaces An IO interface can be defined as both a hardware interface and as a software interface. The purpose of the IO Config utility is to associate a unique interface name with a hardware interface. The IO Libraries use an Interface Name or Logical Unit Number to identify an interface.
Configuring I/O Interfaces Configuring VXI Interfaces When the E8491 VXI Board Configuration screen appears, set the VISA Interface Name, as required. Then, click the OK button. NOTE After the system is configured, this screen may also display an Edit VISA Config... button. Clicking this button allows you to manually configure the interface as desired. See the IO Libraries Readme file for details.
Configuring I/O Interfaces Configuring VXI Interfaces Example: The VXI interface system in the following figure consists of a Windows PC with an E8491 PC card that connects to an E8491B IEEE-1394 to VXI Configuring VXI (E8491B) Interfaces Module in a VXI Mainframe. The VXI mainframe includes one or more VXI instruments. For this system, the three VXI instruments shown have logical addresses 8, 16, and 24.
Configuring I/O Interfaces Configuring LAN Interfaces Configuring LAN Interfaces This section gives guidelines to use the IO Config utility to configure LAN interfaces, including: n n n n LAN Interfaces Overview Configuring LAN Client Interfaces Configuring VISA LAN Client Interfaces Configuring LAN Server Interfaces LAN Interfaces Overview This section gives guidelines to use the Agilent IO Libraries to configure instruments over a LAN (Local Area Network).
Configuring I/O Interfaces Configuring LAN Interfaces Series 700 PCs or Windows 95/98/Me/2000/NT PCs Client LAN E2050 LAN/GPIB Gateway Server Series 700 PCs or Windows 95/98/Me/ 2000/NT PCs GPIB Instrument 86 GPIB bus GPIB bus (or other) LAN Instruments (VXI-11.2 GPIB Emulation or VXI-11.
Configuring I/O Interfaces Configuring LAN Interfaces LAN Software Architecture As shown in the following figure, the client system contains the LAN client software and the LAN software (TCP/IP) needed to access the server (gateway). The gateway contains the LAN server software, LAN (TCP/IP) software, and the instrument driver software needed to communicate with the client and to control the instruments or devices connected to the gateway.
Configuring I/O Interfaces Configuring LAN Interfaces The LAN software is built on top of standard LAN networking protocols. There are two LAN networking protocols provided with the Agilent IO Libraries software. You can use one or both of these protocols when configuring your systems (via Agilent IO Libraries configuration) to use VISA and SICL over LAN. n SICL-LAN Protocol is a networking protocol developed by Agilent that is compatible with all VISA LAN products.
Configuring I/O Interfaces Configuring LAN Interfaces n iopen("lan[machineName]:hpib7,1") will use the configured default protocol. If AUTO is configured, SICL-LAN protocol will be attempted. If that is not supported, VXI-11 protocol will be used. n iopen("lan;auto[machineName]:hpib7,1") will automatically select the protocol (SICL-LAN if available and VXI-11 otherwise.) n iopen("lan;sicl-lan[machineName]:hpib7,1") will use SICL-LAN protocol.
Configuring I/O Interfaces Configuring LAN Interfaces Configuring LAN Client Interfaces An IO interface can be defined as both a hardware interface and as a software interface. The purpose of the IO Config utility is to associate a unique interface name with a hardware interface. The IO Libraries use an Interface Name or Logical Unit Number to identify an interface.
Configuring I/O Interfaces Configuring LAN Interfaces When the LAN Client screen appears, set the VISA Interface Name and Logical Unit number, as required. Also, you can select the Default Protocol (AUTO, VXI-11, or SICL-LAN) and choose whether or not to Log Errors. Then, click the OK button. NOTE After the system is configured, this screen may also display an Edit VISA Config... button. Clicking this button allows you to manually configure the interface as desired.
Configuring I/O Interfaces Configuring LAN Interfaces Example: Configuring LAN Client (Gateway) Interface The LAN Client interface system in the following figure consists of a Windows PC with a LAN card, an E2050 LAN/GPIB gateway, and two GPIB instruments. For this system, the IO Config utility has been used to assign the LAN card a VISA name of “TCPIP0” and SICL name of “lan”. With these names assigned to the interface, VISA/SICL addressing is as shown in the figure.
Configuring I/O Interfaces Configuring LAN Interfaces Example: Configuring LAN Client (LAN) Interface The LAN Client interface system in the following figure consists of a Windows PC with a LAN card and three LAN instruments. Instrument1 and instrument2 are VXI-11.2 (GPIB Emulation) instruments and instrument3 is a VXI-11.3 LAN instrument. For this system, the IO Config utility has been used to assign the LAN card a VISA name of “TCPIP0” and SICL name of “lan”.
Configuring I/O Interfaces Configuring LAN Interfaces Configuring VISA LAN Client Interfaces An IO interface can be defined as both a hardware interface and as a software interface. The purpose of the IO Config utility is to associate a unique interface name with a hardware interface. The IO Libraries use an Interface Name or Logical Unit Number to identify an interface.
Configuring I/O Interfaces Configuring LAN Interfaces Chapter 4 95
Configuring I/O Interfaces Configuring LAN Interfaces Example: Configuring VISA LAN Client (Gateway) Interface The VISA LAN Client interface system in the following figure consists of a Windows PC with a LAN card, an E2050 LAN/GPIB gateway, and two GPIB instruments. The IO Config utility has been used to assign the LAN card a VISA name of “TCPIP0” and SICL name of “lan”. In addition, a VISA LAN Client has been configured with the interface names and host names shown in the figure.
Configuring I/O Interfaces Configuring LAN Interfaces VISA LAN Client (Gateway) Interface VISA/SICL Names Windows PC "TCPIP0" VISA LAN Client "GPIB1" "lan" "machine1" "hpib" N/A GPIB Instruments machine1 hpib-name = hpib VISA Name SICL Name "GPIB1" LAN/GPIB Gateway 5 E2050 3 "lan" LAN Card LAN GPIB Cable VISA LAN Client Parameters VISA Interface Name LAN Client SICL Interface Name Remote Host Name Remote SICL Interface Name "GPIB1" "lan" "machine1" "hpib" VISA/SICL Addressing (Using LAN Cl
Configuring I/O Interfaces Configuring LAN Interfaces Example: Configuring VISA LAN Client (LAN) Interface The VISA LAN Client interface system in the following figure consists of a Windows PC with a LAN card and three LAN instruments. Instrument1 and instrument2 are VXI-11.2 (GPIB Emulation) instruments and instrument3 is a VXI-11.3 LAN instrument. For this system, the IO Config utility has been used to assign the LAN card a VISA name of “TCPIP0” and SICL name of “lan”.
Configuring I/O Interfaces Configuring LAN Interfaces VISA LAN Client (LAN) Interface VISA/SICL Names Windows PC VISA Name SICL Name "GPIB1" "GPIB2" LAN Instruments instrument1 VISA LAN Client "GPIB1" "lan" "instrument1" "gpib0" N/A LAN 5 VXI-11.2 GPIB Emulation gpib0,5 VISA LAN Client "GPIB2" "lan" "1.2.3.4" "gpib0" N/A machine name 1.2.3.4 IP address 3 VXI-11.2 GPIB Emulation gpib0,3 "TCPIP0" LAN Card "lan" instrument3 VXI-11.
Configuring I/O Interfaces Configuring LAN Interfaces Configuring LAN Server Interfaces An IO interface can be defined as both a hardware interface and as a software interface. The purpose of the IO Config utility is to associate a unique interface name with a hardware interface. The IO Libraries use an Interface Name or Logical Unit Number to identify an interface.
Configuring I/O Interfaces Configuring LAN Interfaces When the Agilent LAN Server screen appears, set the Server Timeout as required. Also, as required, set Log Errors, Log Locks and Connections and/or Use Keepalive Client Probes. Then, click the OK button. Example: Configuring LAN Server Interface The LAN Server interface system in the following figure consists of a Windows PC acting as a LAN client, a second PC acting as a LAN server, and a GPIB instrument.
Configuring I/O Interfaces Configuring LAN Interfaces LAN Server (PC as Server) Interface VISA/SICL Names Windows PC (LAN Client) Windows PC (LAN Server) GPIB Instrument machine2 SICL name hpib7 VISA Name LAN Card: "TCPIP0" GPIB Card: "GPIB0" SICL Name "lan" "hpib7" LAN Card 5 GPIB Card LAN GPIB VISA/SICL Addressing VISA: viOpen (... "TCPIP0::machine2::hpib7,5::INSTR".....
Configuring I/O Interfaces Configuring Other Interfaces Configuring Other Interfaces This section gives guidelines to use the IO Config utility to configure ASRL (RS-232) and GPIO interfaces, including: n ASRL and GPIO Interfaces Overview n Configuring ASRL Interfaces n Configuring GPIO Interfaces ASRL and GPIO Interface Overview As shown in the following figure, a typical ASRL (RS-232) interface consists of a Windows PC with one or more RS-232 COM Ports.
Configuring I/O Interfaces Configuring Other Interfaces Configuring ASRL Interfaces An IO interface can be defined as both a hardware interface and as a software interface. The purpose of the IO Config utility is to associate a unique interface name with a hardware interface. The IO Libraries use an Interface Name or Logical Unit Number to identify an interface. This information is passed in the parameter string of the viOpen function call in a VISA program or in the iopen function call in a SICL program.
Configuring I/O Interfaces Configuring Other Interfaces When the RS-232 COM Ports screen appears, set the VISA Interface Name and Serial port attributes, as required. Then, click the OK button. Example: Configuring ASRL Interfaces The ASRL interface system in the following figure consists of a Windows PC with two RS-232 COM ports, each of which is connected to a single Serial instrument via RS-232 cables.
Configuring I/O Interfaces Configuring Other Interfaces ASRL Interface (RS-232 COM Ports) Interface VISA/SICL Names Windows PC VISA Name SICL Name "ASRL1" "COM1" RS-232 COM Port 1 "ASRL2" "COM2" RS-232 COM Port 2 RS-232 Cable Serial Instruments VISA/SICL Addressing VISA: viOpen (... "ASRL1::INSTR"...) viOpen (... "ASRL2::INSTR"...
Configuring I/O Interfaces Configuring Other Interfaces Configuring GPIO Interfaces An IO interface can be defined as both a hardware interface and as a software interface. The purpose of the IO Config utility is to associate a unique interface name with a hardware interface. The IO Libraries use an Interface Name or Logical Unit Number to identify an interface. This information is passed in the parameter string in the iopen function call in a SICL program.
Configuring I/O Interfaces Configuring Other Interfaces When the E2075 ISA GPIO Card Configuration screen appears, set the attributes as desired. Then, click the OK button. Example: Configuring GPIO Interfaces The GPIO interface system in the following figure consists of a Windows PC with an E2075A GPIO card that is connected to a GPIO instrument via GPIO cable. The IO Config utility has been used to assign the E2075A GPIO card a SICL name of “gpio12”. (GPIO is NOT supported by VISA.
Configuring I/O Interfaces Configuring Other Interfaces GPIO Interface (E2075A ISA Card) Windows PC Interface SICL Name VISA Name N/A GPIO Cable GPIO Instrument SICL Name "gpio12" E2075 GPIO Card SICL Addressing iopen ("gpio12") Chapter 4 Open IO path to GPIO instrument 109
Configuring I/O Interfaces Configuring Other Interfaces Notes: 110 Chapter 4
Index A G Agilent telephone numbers, 9 Agilent web site, 9 ASRL interfaces configuring, 104 overview, 103 C configuring GPIB interfaces, 71 configuring I/O interfaces, 70 configuring LAN interfaces, 85 configuring VXI interfaces, 78 copyright information, 6 E emergency repair disk, 17 examples Configuring ASRL Interfaces, 105 Configuring GPIB (82341) Interface, 76 Configuring GPIB (82350) Interface, 73 Configuring GPIB-VXI (E1406A) Interface, 81 Configuring GPIO Interfaces, 108 Configuring LAN Client (G
L LAN, client/server model, 85 LAN Client definition, 85 interfaces, 90 LAN interfaces client/server model, 85 configuring, 85 configuring LAN Server, 100 hardware architecture, 85 LAN Client interfaces, 90 overview, 85 software architecture, 87 VISA LAN Client Interfaces, 94 LAN Server definition, 85 using, 67 M modifying IO Libraries, 45 P printing history, 6 program groups created, 33, 42 R readme file, 22, 28, 34, 43 removing IO Libraries, 45, 50 repairing IO Libraries, 45, 48 restricted rights, 5 ru