National Instruments NI-488.2 user manual

NI-488.2™

NI-488.2 User Manual

for Windows

NI-488.2 User Manual for Windows

June 1999 Edition

Part Number 321819D-01

Contents

Main Page Important Information Warranty Copyright Trademarks WARNING REGARDING MEDICAL AND CLINICAL USE OF NATIONAL INSTRUMENTS PRODUCTS Contents About This Manual Chapter 1 Introduction Chapter 2 Measurement & Automation Explorer Chapter 3 Developing Your NI-488.2 Application Chapter 4 Debugging Your Application Chapter 5 NI Spy Utility Chapter 6 Interactive Control Utility Page Page Page About This Manual Using the NI-488.2 Documentation Accessing the NI-488.2 Online Help Conventions Related Documentation Introduction Setting up and Configuring Your System Controlling More Than One Interface Configuration Requirements Page Measurement & Automation Explorer Starting Measurement & Automation Explorer Getting Started with NI-488.2 Page Troubleshoot NI-488.2 Problems Add a New GPIB Interface Delete a GPIB Interface Scan for GPIB Instruments Instruments Not Found Instruments Enumeration Failed Communicate with Your Instrument Basic Communication (Query/Write/Read) Advanced Communication View NI-488.2 Software Version Monitor, Record, and Display NI-488.2 Calls View or Change GPIB Interface Settings Page View GPIB Instrument Information Change GPIB Device Templates Enable/Disable NI-488.2 DOS Support Access Additional Help and Resources NI-488.2 Online Help National Instruments GPIB Web Site View or Change GPIB-ENET Network Settings (Windows 98/95 Only) Assign IP Address Configure Advanced IP Settings Update GPIB-ENET Firmware Developing Your NI-488.2 Application Simple Instrument Control Interactive Instrument Control Choosing Your Programming Methodology Choosing a Method to Access the NI-488.2 Driver NI-488.2 Language Interfaces Direct Entry Access Choosing How to Use the NI-488.2 API Communicating with a Single GPIB Device Using Multiple Interfaces and/or Multiple Devices Checking Status with Global Variables Status Word (ibsta) Page Error Variable (iberr) Count Variables (ibcnt and ibcntl) Using Interactive Control to Communicate with Devices Programming Models Applications That Communicate with a Single GPIB Device Items to Include General Program Steps and Examples Initialization Device Communication Cleanup Applications That Use Multiple Interfaces or Communicate with Multiple GPIB Devices Items to Include General Program Steps and Examples Initialization Device Communication Cleanup Language-Specific Programming Instructions Microsoft Visual C/C++ (Version 2.0 or Later) Borland C/C++ (Version 4.0 or Later) Visual Basic (Version 4.0 or Later) Direct Entry with C gpib-32.dll Exports Directly Accessing the gpib-32.dll Exports Page Page Running Existing NI-488.2 Applications Running Existing Win32 and Win16 NI-488.2 Applications Running Existing DOS NI-488.2 Applications Under Windows 98/95 Running Existing DOS NI-488.2 Applications under Windows 2000/NT Debugging Your Application NI Spy Global Status Variables Existing Applications NI-488.2 Error Codes Configuration Errors Timing Errors Communication Errors Repeat Addressing Termination Method Other Errors NI Spy Utility Starting NI Spy Page Exiting NI Spy Performance Considerations Interactive Control Utility Getting Started with Interactive Control Page Page Interactive Control Syntax Number Syntax String Syntax Address Syntax Interactive Control Commands Page Page Page Page Status Word Error Information Count Information NI-488.2 Programming Techniques Termination of Data Transfers High-Speed Data Transfers (HS488) Enabling HS488 System Configuration Effects on HS488 Waiting for GPIB Conditions Asynchronous Event Notification in Win32 NI-488.2 Applications Calling the ibnotify Function ibnotify Programming Example Page Page Page Writing Multithreaded Win32 NI-488.2 Applications Page Device-Level Calls and Bus Management Talker/Listener Applications Serial Polling Service Requests from IEEE 488 Devices Service Requests from IEEE 488.2 Devices Automatic Serial Polling Stuck SRQ State Autopolling and Interrupts SRQ and Serial Polling with Device-Level Traditional NI-488.2 Calls SRQ and Serial Polling with Multi-Device NI-488.2 Calls Example 1: Using FindRQS This example shows you how to use FindRQS to find the first device that is requesting service: Example 2: Using AllSpoll This example shows you how to use AllSpoll to serial poll three devices with a single call: Parallel Polling Implementing a Parallel Poll Parallel Polling with Traditional NI-488.2 Calls Page Parallel Polling with Multi-Device NI-488.2 Calls A GPIB Basics Talkers, Listeners, and Controllers Controller-In-Charge and System Controller GPIB Addressing Sending Messages across the GPIB Data Lines Handshake Lines Interface Management Lines B Status Word Conditions ERR (dev, brd) TIMO (dev, brd) END (dev, brd) SRQI (brd) RQS (dev) CMPL (dev, brd) LOK (brd) REM (brd) CIC (brd) ATN (brd) TACS (brd) LACS (brd) DTAS (brd) DCAS (brd) C Error Codes and Solutions EDVR (0) ECIC (1) ENOL (2) EADR (3) EARG (4) ESAC (5) EABO (6) ENEB (7) EDMA (8) EOIP (10) ECAP (11) EFSO (12) EBUS (14) ESTB (15) ESRQ (16) ETAB (20) D Windows 98/95: Troubleshooting and Common Questions Troubleshooting EDVR Error Conditions EDVR Error Condition with ibcntl Set to 0xE028002C (534249428) EDVR Error Condition with ibcntl Set to 0xE0140025 (535560155) EDVR Error Condition with ibcntl Set to 0xE0140035 (535560139) EDVR Error Condition with ibcntl Set to 0xE0320029 (533594071) or 0xE1050029 (519765975) EDVR Error Condition with ibcntl Set to 0xE0140004 (535560188) EDVR Error Condition with ibcntl set to 0xE1030043 (519897021) Troubleshooting Device Manager Problems Enabling Interrupts Step 1. Free up an Interrupt Resource Step 2. Remove Your GPIB Interface from the Device Manager Step 3. Refresh the Device Manager or Reinstall Your GPIB interface Common Questions Page Page Page E Windows 2000/NT: Common Questions Common Questions Page Page F Technical Support Resources NI Web Support Online Problem-Solving and Diagnostic Resources Software-Related Resources Worldwide Support Glossary A B C D E F G H I L M N P R S T U Index Numbers/Symbols A B C D E F G H I L M N O P Q R S T V W