National Instruments NI-488.2 Exiting GPIB Spy, Viewing Call Details

GPIB Spy Chapter 6

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

Exiting GPIB Spy

Exit GPIB Spy by choosing Exit from the Spy menu.

Caution: When you exit GPIB Spy, all of the recorded information is lost. See the

section in this chapter entitled GPIB Spy Output Options if you want to avoid

losing the information.

Viewing Call Details

To see detailed information about calls recorded in GPIB Spy, use the Call Details

window. You can activate the Call Details window in two different ways. If you

double-click on any recorded call in the main GPIB Spy window, the call details for that

particular call are displayed in the Call Details window. You can also select the View

Details option from the Spy menu, which makes the Call Details window the top-level

window.

You can use the Call Details window in two ways. If you check the Continuously item

in the View menu, the Call Details window is updated as each new GPIB is recorded and

you cannot scroll through the details for each recorded call. If you uncheck the

Continuously item in the View menu, you can use the <Page Up> or <Page Down> keys

to scroll through the call details of all recorded calls. If a call to the driver produces a

GPIB error condition, the corresponding Call Details window displays an iberr Help

button. Clicking on this button launches an interactive help utility which helps you

identify and correct the problem.

Figure 6-2 shows the GPIB Spy Call Details window for the NI-488 function, ibwrt.

Figure 6-2. GPIB Spy Call Details Window for ibwrt

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