National Instruments NI-488.2 About This Manual

© National Instruments Corp. xiii NI-488.2 User Manual for Windows

About This Manual

This manual describes the features and functions of the NI-488.2 software for Windows.

The NI-488.2 software is meant to be used with Microsoft Windows version 3.0 or

higher. This manual assumes that you are already familiar with Windows.

How to Use This Manual Set

NI-488.2 User

Manual for Windows

Application

Development

and Examples

Getting Started

Manual

Novice

Users

Installation and

Configuration

NI-488.2 Function

Reference Manual

for DOS/Windows

Experienced

Users

Function

and Routine

Descriptions

Use the getting started manual to install and configure your GPIB hardware and NI-488.2

software for Windows.

Use the NI-488.2 User Manual for Windows to learn the basics of GPIB and how to

develop an application program. The user manual also contains debugging information

and detailed examples.

Use the NI-488.2 Function Reference Manual for DOS/Windows for specific information

about each NI-488 function and NI-488.2 routine such as format, parameters, and

possible errors.

Contents

Main Page Limited Warranty Copyright Trademarks WARNING REGARDING MEDICAL AND CLINICAL USE OF NATIONAL INSTRUMENTS PRODUCTS Contents About This Manual Chapter One Introduction Chapter 2 Application Examples Chapter 3 Developing Your Application Chapter 4 Debugging Your Application Chapter 5 wibicWindows Interface Bus Interactive Control Utility Chapter 6 GPIB Spy Chapter 7 GPIB Programming Techniques Chapter 8 wibconfWindows Interface Bus Configuration Utility Page Tables About This Manual How to Use This Manual Set Organization of This Manual Conventions Used in This Manual italic monospace Related Documentation Customer Communication Chapter 1 Introduction GPIB Overview Talkers, Listeners, and Controllers Controller-In-Charge and System Controller GPIB Addressing Sending Messages Across the GPIB Page Setting Up and Configuring Your System Configuration Requirements The NI-488.2 Software Package NI-488.2 Driver and Driver Utilities C Language Files Visual Basic Language Files Win 32s Files Sample Application Files How the NI-488.2 Software Works with Windows Windows Unloading and Reloading the NI-488.2 Driver Chapter 2 Application Examples Example 1: Basic Communication National Instruments Corp. 2-3 NI-488.2 User Manual for Windows Figure 2-1. Program Flowchart for Example 1 Example 2: Clearing and Triggering Devices National Instruments Corp. 2-5 NI-488.2 User Manual for Windows Figure 2-2. Program Flowchart for Example 2 Example 3: Asynchronous I/O National Instruments Corp. 2-7 NI-488.2 User Manual for Windows Figure 2-3. Program Flowchart for Example 3 Example 4: End-of-String Mode National Instruments Corp. 2-9 NI-488.2 User Manual for Windows Figure 2-4. Program Flowchart for Example 4 Example 5: Service Requests Page Application Examples Chapter 2 NI-488.2 User Manual for Windows 2-12 National Instruments Corp. (continues) Figure 2-5. Program Flowchart for Example 5 National Instruments Corp. 2-13 NI-488.2 User Manual for Windows (Continued) Figure 2-5. Program Flowchart for Example 5 (Continued) Example 6: Basic Communication with IEEE 488.2-Compliant Devices National Instruments Corp. 2-15 NI-488.2 User Manual for Windows Figure 2-6. Program Flowchart for Example 6 Example 7: Serial Polls Using NI-488.2 Routines National Instruments Corp. 2-17 NI-488.2 User Manual for Windows SendList Figure 2-7. Program Flowchart for Example 7 "SRQ=HI" WaitSRQ FindRQS Example 8: Parallel Polls National Instruments Corp. 2-19 NI-488.2 User Manual for Windows Figure 2-8. Program Flowchart for Example 8 Example 9: Non-Controller Example National Instruments Corp. 2-21 NI-488.2 User Manual for Windows fffffffffff Figure 2-9. Program Flowchart for Example 9 Chapter 3 Developing Your Application Choosing How to Access the NI-488.2 DLL Choosing Between NI-488 Functions and NI-488.2 Routines Using NI-488 Functions: One Device for Each Board Using NI-488.2 Routines: Multiple Boards and/or Multiple Devices Checking Status with Global Variables Status Word ibsta Page Error Variable iberr Count Variables ibcnt and ibcntl Using wibic to Communicate with Devices Writing Your NI-488 Application Items to Include Chapter 3 Developing Your Application National Instruments Corp. 3-7 NI-488.2 User Manual for Windows NI-488 Program Shell Figure 3-1. General Program Shell Using NI-488 Device Functions General Program Steps and Examples Page Page Writing Your NI-488.2 Application Items to Include Developing Your Application Chapter 3 NI-488.2 User Manual for Windows 3-12 National Instruments Corp. NI-488.2 Program Shell Figure 3-2. General Program Shell Using NI-488.2 Routines Figure 3-2 is a flowchart of the steps to create your application program using NI-488.2 routines. General Program Steps and Examples Page Page Page Compiling, Linking, and Running Your Application Microsoft C Borland C++ Visual Basic Direct Entry with C Page Page Page Page Direct Entry with Visual Basic Chapter 4 Debugging Your Application Running wibtest gpibx x Presence Test of Driver Running GPIBInfo Debugging with the Global Status Variables Debugging with wibic Debugging with GPIB Spy GPIB Error Codes Configuration Errors Timing Errors Communication Errors Repeat Addressing Termination Method Common Questions Page Page Chapter 5 wibicWindows Interface Bus Interactive Control Utility Example Using NI-488 Functions Page Page wibic Syntax Number Syntax String Syntax Address Syntax wibic Syntax for NI-488 Functions Page Page wibic Syntax for NI-488.2 Routines Status Word Error Information Count Common NI-488 Functions ibfind ibdev Page ibwrt ibrd Common NI-488.2 Routines in wibic Set Send and SendList Receive Auxiliary Functions Set (Select Device or Board) Help (Display Help Information) ! (Repeat Previous Function) - (Turn Display Off) and + (Turn Display On) n* (Repeat Function n Times) $ (Execute Indirect File) Print (Display the ASCII String) Buffer (Set Buffer Display Mode) Chapter 6 GPIB Spy Starting GPIB Spy Exiting GPIB Spy Viewing Call Details GPIB Spy Configuration Options Calls To Highlight Calls To Trap On Buffer History Set Highlight Color GPIB Spy Output Options To Screen To File Clear Screen GPIB Spy Help Performance Considerations Chapter 7 GPIB Programming Techniques Termination of Data Transfers High-Speed Data Transfers (HS488) Enabling HS488 System Configuration Effects on HS488 Waiting for GPIB Conditions Device-Level Calls and Bus Management Talker/Listener Applications Waiting for Messages from the Controller Using the Event Queue Requesting Service Serial Polling Service Requests from IEEE 488 Devices Service Requests from IEEE 488.2 Devices Automatic Serial Polling SRQ and Serial Polling with NI-488 Device Functions SRQ and Serial Polling with NI-488.2 Routines Page Parallel Polling Implementing a Parallel Poll Page Page Chapter 8 wibconfWindows Interface Bus Configuration Utility Starting wibconf driver Upper and Lower Levels of wibconf Upper-Level Device Map Page Lower-Level Device/Board Characteristics Page Board and Device Configuration Options Primary GPIB Address Secondary GPIB Address Timeout Setting Page Send EOI at End of Write System Controller (Board Characteristic Only) Assert REN when SC (Board Characteristic Only) Enable Auto Serial Polling (Board Characteristic Only) Enable CIC Protocol (Board Characteristic Only) Bus Timing (Board Characteristic Only) Cable Length for High Speed (Board Characteristic Only) Parallel Poll Duration (Board Characteristic Only) Use This GPIB Interface (Board Characteristic Only) Base I/O Address (Board Description Only) DMA Channel (Board Characteristic Only) Interrupt Jumper Setting (Board Characteristic Only) Enable Repeat Addressing (Device Characteristic Only) GPIB-PCII/IIA Mode Switch Default Configurations in wibconf Exiting wibconf Checking for Errors wibconf Batch Mode Page Page Appendix A Status Word Conditions ERR (dev, brd) TIMO (dev, brd) END (dev, brd) SRQI (brd) RQS (dev) SPOLL (brd) EVENT (brd) CMPL (dev, brd) LOK (brd) REM (brd) CIC (brd) ATN (brd) TACS (brd) LACS (brd) DTAS (brd) DCAS (brd) Appendix B Error Codes and Solutions EDVR (0) ECIC (1) ENOL (2) EADR (3) EARG (4) ESAC (5) EABO (6) ENEB (7) EDMA (8) drive path EOIP (10) ECAP (11) EFSO (12) EBUS (14) ESTB (15) ESRQ (16) ETAB (20) Appendix C Customer Communication Technical Support Form Page Documentation Comment Form Page Glossary A B C D E G H I K L M N P R S T U W Index Symbols A Page B C D E Page Page F G H I L M N O P R S T V W