National Instruments NI-488.2 user manual

NI-488.2TM

NI-488.2 User Manual

January 2007

370428F-01

Contents

Main Page Important Information Warranty Copyright Trademarks Patents Contents About This Manual Chapter 1 Introduction Chapter 2 Measurement & Automation Explorer (Windows) Chapter 3 GPIB Explorer (Mac OS X and Linux) Chapter 4 Developing Your NI-488.2 Application Chapter 5 Debugging Your Application Chapter 6 NI Spy Utility Chapter 7 Interactive Control Utility 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 (Windows) Starting Measurement & Automation Explorer Troubleshoot NI-488.2 Problems Add a New GPIB Interface Remove a GPIB Interface Scan for GPIB Instruments Instruments Not Found Too Many Listeners on the GPIB Communicate with Your Instrument Basic Communication (Query/Write/Read) Page 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 Instrumentation 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/100 Network Settings Device Configuration Update GPIB-ENET/100 Firmware Page Page Page Add a New GPIB Interface Delete a GPIB Interface View NI-488.2 Software Version View or Change GPIB Interface Settings Page Access Additional Help and Resources NI-488.2 Online Help National Instruments GPIB Web Site View or Change GPIB-ENET/100 Network Settings Device Configuration Update GPIB-ENET/100 Firmware Developing Your NI-488.2 Application Interactive Instrument Control Choosing Your Programming Methodology Choosing a Method to Access the NI-488.2 Driver 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) 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 for Windows 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 Language-Specific Programming Instructions for Mac OS X Language-Specific Programming Instructions for Linux Page Debugging Your Application NI Spy Global Status Variables NI-488.2 Error Codes Configuration Errors Timing Errors Communication Errors Repeat Addressing Termination Method Other Errors NI Spy Utility Starting NI Spy Windows Mac OS X and Linux Page Debugging Existing Applications Viewing Properties for Recorded Calls 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 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 NI-488.2 Applications Calling the ibnotify Function Page ibnotify Programming Example Page Page Writing Multithreaded 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 Example 2: Using AllSpoll Parallel Polling Implementing a Parallel Poll Parallel Polling with Traditional NI-488.2 Calls Parallel Polling with Multi-Device NI-488.2 Calls Page 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 Page 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) EOIP (10) ECAP (11) EFSO (12) EBUS (14) ESRQ (16) ETAB (20) ELCK (21) EARM (22) EHDL (23) EWIP (26) ERST (27) EPWR (28) D Common Questions General GPIB Questions Page Windows E Technical Support and Professional Services Glossary A B C D E F G H I L M N P R S T U Index Symbols A B C D E F G H I K L M N O P Q R S T V W