National Instruments NI-488.2M Software Reference Manual
  1. Manuals
  2. Brands
  3. National Instruments Manuals
  4. Computer Hardware
  5. NI-488.2M
  6. Software reference manual
National Instruments NI-488.2M Software Reference Manual

National Instruments NI-488.2M Software Reference Manual

For os/2
Hide thumbs Also See for NI-488.2M:
Table of Contents

Advertisement

Quick Links

Download this manual
™
NI-488.2M
Software Reference Manual
for OS/2
January 1995 Edition
Part Number 370950A-01
© Copyright 1993, 1995 National Instruments Corporation.
All Rights Reserved.

Advertisement

Table of Contents
loading

Related Manuals for National Instruments NI-488.2M

Summary of Contents for National Instruments NI-488.2M

  • Page 1 ™ NI-488.2M Software Reference Manual for OS/2 January 1995 Edition Part Number 370950A-01 © Copyright 1993, 1995 National Instruments Corporation. All Rights Reserved.
  • Page 2 National Instruments Corporate Headquarters 6504 Bridge Point Parkway Austin, TX 78730-5039 (512) 794-0100 Technical support fax: (800) 328-2203 (512) 794-5678 Branch Offices: Australia (03) 879 9422, Austria (0662) 435986, Belgium 02/757.00.20, Canada (Ontario) (519) 622-9310, Canada (Québec) (514) 694-8521, Denmark 45 76 26 00, Finland (90) 527 2321, France (1) 48 14 24 24,...
  • Page 3 The reader should consult National Instruments if errors are suspected. In no event shall National Instruments be liable for any damages arising out of or related to this document or the information contained in it.
  • Page 4 Under the copyright laws, this publication may not be reproduced or transmitted in any form, electronic or mechanical, including photocopying, recording, storing in an information retrieval system, or translating, in whole or in part, without the prior written consent of National Instruments Corporation. Trademarks ®...

  • Page 5: Table Of Contents

    NI-488.2M Driver and Driver Utilities ......1-1 Language Files ............. 1-2 Example Program Files ..........1-2 API-Related Files ............1-3 How the NI-488.2M Software Works with OS/2....... 1-4 GPIB Overview ................1-5 The IEEE 488 Standard and GPIB....... 1-5 Talkers, Listeners, and Controllers ......1-5 Controller-In-Charge and System Controller....
  • Page 6 GPIB Cables Connected..........4-2 Debugging with the Global Status Variables ......4-3 Debugging with ibic ..............4-3 GPIB Error Codes............... 4-3 Configuration Errors..............4-4 Reconfiguring the NI-488.2M Software ......4-5 Timing Errors ................4-5 NI-488.2M SRM for OS/2 © National Instruments Corp.
  • Page 7 Termination of Data Transfers ........... 6-1 Waiting for GPIB Conditions............. 6-2 Device-Level Calls and Bus Management ......... 6-2 Serial Polling ................6-3 Service Requests from IEEE 488 Devices ....6-3 Service Requests from IEEE 488.2 Devices ....6-4 © National Instruments Corp. NI-488.2M SRM for OS/2...
  • Page 8 Terminate Read on EOS..........7-11 Set EOI with EOS on Write ......... 7-11 Type of Compare on EOS ..........7-11 EOS Byte..............7-11 Send EOI at End of Write ..........7-12 GPIB-Specific Errors ........... 7-12 NI-488.2M SRM for OS/2 viii © National Instruments Corp.
  • Page 9 Default Configurations in ibconf ..........7-16 Exiting ibconf ................7-17 Appendix A Status Word Conditions ..............A-1 Appendix B Error Codes and Solutions ............B-1 Appendix C Customer Communication ............C-1 Glossary ....................G-1 Index ....................... I-1 © National Instruments Corp. NI-488.2M SRM for OS/2...
  • Page 10 Contents Figures Figure 1-1. How the NI-488.2M Software Works with OS/2 ....1-4 Figure 1-2. Linear and Star System Configuration......1-8 Figure 1-3. Example of Multiboard System Setup......1-9 Figure 2-1. Program Flowchart for Example 1........2-3 Figure 2-2. Program Flowchart for Example 2........2-5 Figure 2-3.

  • Page 11: About This Manual

    About This Manual This manual describes the features and functions of the NI-488.2M software for OS/2. The NI-488.2M software package is meant to be used with OS/2 (IBM Operating System/2) version 2.0 or higher. This manual assumes that you are already familiar with the OS/2 system.

  • Page 12: Conventions Used In This Manual

    • Appendix C, Customer Communication, contains forms you can use to request help from National Instruments or to comment on our products and manuals. • The Glossary contains an alphabetical list and a description of terms, including abbreviations, acronyms, metric prefixes, mnemonics, and symbols, that this manual uses.
  • Page 13 ANSI/IEEE Standard 488.1-1987 and the ANSI/IEEE Standard 488.2-1987, respectively, which define the GPIB. NI-488.2M software NI-488.2M software refers to the NI-488.2M software for OS/2 unless otherwise noted. Abbreviations, acronyms, metric prefixes, mnemonics, symbols, and terms are listed in the Glossary.

  • Page 14: How To Use This Manual Set

    Examples Use the getting-started manual to install and configure your GPIB hardware and NI-488.2M software for OS/2. Use the software reference manual if you want to learn the basics of GPIB and how to develop an application program. The software reference manual also contains debugging information and detailed examples.

  • Page 15: Related Documentation

    Common Commands. Customer Communication National Instruments wants to receive your comments on our products and manuals. We are interested in the applications you develop with our products, and we want to help if you have problems with them. To make it easy for you to contact us, this manual contains comment and configuration forms for you to complete.

  • Page 16: Ni-488.2M Software Description

    Chapter 1 NI-488.2M Software Description This chapter describes the NI-488.2M software package and explains how the software works with your OS/2 system. The NI-488.2M Software Package The following section highlights important elements of the NI-488.2M software for OS/2 and describes the function of each element.

  • Page 17: Language Files

    GPIB device. • clr_trg.c is a C program that illustrates how to clear or trigger GPIB devices. • asynch.c is a C program that illustrates how to perform asynchronous I/O. NI-488.2M SRM for OS/2 © National Instruments Corp.

  • Page 18: Api-Related Files

    OS/2 API functions. • nicode.h is a C language declaration file that contains definitions of NI- 488.2M function codes and other NI-488.2M-related constant and structure definitions. • nictl_32.h is a C language declaration file that contains a macro definition.

  • Page 19: How The Ni-488.2M Software Works With Os/2

    OS/2 device driver services are available to all OS/2 programs running in the system. Figure 1-1 shows two ways you can access the NI-488.2M driver. You can use either the NI-488.2 language interface or the OS/2 API (Application Program Interface) calls.

  • Page 20: Gpib Overview

    Some devices are capable of playing more than one role. A digital voltmeter, for example, can be a Talker and a Listener. If your personal computer has a GPIB interface board and GPIB software installed, it can function as a Talker, Listener, and Controller. © National Instruments Corp. NI-488.2M SRM for OS/2...

  • Page 21: Controller-In-Charge And System Controller

    Listening device is ready/not ready to receive a message byte. NDAC (not data accepted) Listening device has/has not accepted a message byte. DAV (data valid) Talking device indicates signals on data lines are stable (valid) data. NI-488.2M SRM for OS/2 © National Instruments Corp.

  • Page 22: Interface Management Lines

    24-conductor cable with both a plug and receptacle connector at each end. With this design, you can link devices in a linear configuration, a star configuration, or a combination of the two. Figure 1-2 shows the linear and star configurations. © National Instruments Corp. NI-488.2M SRM for OS/2...

  • Page 23: Figure 1-2. Linear And Star System Configuration

    NI-488.2M Software Description Chapter 1 Linear Device A Configuration Device B Device C Star Configuration Device D Device A Device B Device C Figure 1-2. Linear and Star System Configuration NI-488.2M SRM for OS/2 © National Instruments Corp.

  • Page 24: Controlling More Than One Board

    Chapter 1 NI-488.2M Software Description Controlling More Than One Board Multiboard drivers, such as the NI-488.2M driver for OS/2, can control more than one interface board. Figure 1-3 shows an example of a multiboard system configuration. GPIB Digital Voltmeter gpib0...

  • Page 25: Application Examples

    Example 8. It uses NI-488.2 routines to conduct parallel polls. • non_cic.c is the source code file for Example 9. It illustrates how you can use the NI-488.2M driver in a non-Controller application. © National Instruments Corp. NI-488.2M SRM for OS/2...

  • Page 26: Example 1: Basic Communication

    GPIB device. A technician needs to monitor voltage readings using a GPIB multimeter. His computer is equipped with an IEEE 488.2 interface board. The NI-488.2M software is installed and a GPIB cable runs from the computer to the GPIB port on the multimeter.
  • Page 27 "VOLTS DC;AUTO" to Take Voltages ibwrt Tell Multimeter to "VOLTS?" Take Measurement ibrd Read "+ 5 volts" Measurement from Multimeter Finished Getting Measurements? CLEAN UP Figure 2-1. Program Flowchart for Example 1 © National Instruments Corp. NI-488.2M SRM for OS/2...

  • Page 28: Example 2: Clearing And Triggering Devices

    This example illustrates how you can clear and trigger GPIB devices. Two freshman physics lab partners are learning how to use a GPIB digital oscilloscope. They have successfully loaded the NI-488.2M software on a personal computer and connected their GPIB board to a GPIB digital oscilloscope.
  • Page 29 Trigger Trigger Oscilloscope to Command Get Reading ibwrt Request Data from "CURV?" Oscilloscope ibrd Read Data from Data Oscilloscope Display Waveform Finished Reading? CLEAN UP Figure 2-2. Program Flowchart for Example 2 © National Instruments Corp. NI-488.2M SRM for OS/2...

  • Page 30: Example 3: Asynchronous I/O

    GPIB color printer and fitted with the NI-488.2M software package. The biologist is familiar with the command set of her color printer, as described in the user manual provided by the manufacturer.
  • Page 31 Scan ibwrta Print Image Print Image Asynchronously Non-GPIB Activity: Save to Disk ibwait Is GPIB Printing Non-GPIB Activity: Done? Compute Statistics More Images? CLEAN UP Figure 2-3. Program Flowchart for Example 3 © National Instruments Corp. NI-488.2M SRM for OS/2...

  • Page 32: Example 4: End-Of-String Mode

    The application starts the scan by writing the scan command to the scanner. The application reads the scan data into the computer. As a cleanup step before exiting, the application returns the interface board back to its original state by taking it offline. NI-488.2M SRM for OS/2 © National Instruments Corp.
  • Page 33 "RES:3 \ r \ n" Resolution ibrd Read Status "OK" ibwrt Start Scan "scan \ r \ n" ibrd Read Scanned Data Data CLEAN UP Figure 2-4. Program Flowchart for Example 4 © National Instruments Corp. NI-488.2M SRM for OS/2...

  • Page 34: Example 5: Service Requests

    GPIB digital film recorder. A GPIB cable connects the GPIB port on the film recorder to the IEEE 488.2 interface board installed in her computer. She has installed the NI-488.2M software package on the host computer and is familiar with the programming instructions for the film recorder, as described in the user manual provided by the manufacturer.
  • Page 35 10. As a cleanup step before exiting, the application returns the interface board back to its original state by taking it offline. © National Instruments Corp. 2-11 NI-488.2M SRM for OS/2...
  • Page 36 Did You Request Request Service Service ? ibrsp Read Response from Response the Film Recorder Finished Loading Film? Exit Application and Repair Film Recorder (continues) Figure 2-5. Program Flowchart for Example 5 NI-488.2M SRM for OS/2 2-12 © National Instruments Corp.

  • Page 37: Figure 2-5. Program Flowchart For Example 5

    Wait for Film Recorder to Did You Request Request Service? Service ibrsp Read Response From Response Film Recorder Reached End of Film? CLEAN UP Figure 2-5. Program Flowchart for Example 5 (Continued) © National Instruments Corp. 2-13 NI-488.2M SRM for OS/2...

  • Page 38: Example 6: Basic Communication With Ieee

    Steps 3 and 4 are repeated for each of the devices detected in Step 2. As a cleanup step before exiting, the application returns the interface board back to its original state by taking it offline. NI-488.2M SRM for OS/2 2-14 © National Instruments Corp.

  • Page 39: Figure 2-6. Program Flowchart For Example 6

    Response "MUTT 10426" from Device 2 Send Tell Device "*IDN?" 3 to Identify Itself Receive Read "MUTT 10528" Response from Device 3 CLEAN UP Figure 2-6. Program Flowchart for Example 6 © National Instruments Corp. 2-15 NI-488.2M SRM for OS/2...

  • Page 40: Example 7: Serial Polls Using Ni-488.2 Routines

    The GPIB strain gauges are connected to a computer equipped with an IEEE 488.2 interface board and fitted with the NI-488.2M software. The process is controlled by an application that uses NI-488.2 routines to communicate with the IEEE 488.2 compliant strain gauges.
  • Page 41 From Strain Gauge Does the Gauge Need Service? Provide Whatever Service is Mixture is Ready. Required Display "Remove Mixture" Message Done for Day? CLEAN UP Figure 2-7. Program Flowchart for Example 7 © National Instruments Corp. 2-17 NI-488.2M SRM for OS/2...

  • Page 42: Example 8: Parallel Polls

    The three monitoring units are connected to the IEEE 488.2 interface board of a computer fitted with the NI-488.2M software and operated by an application using NI- 488.2 routines. The application obtains information from the multiple units by conducting a parallel poll, then determines when to pour the metals into the mixture tank.
  • Page 43 The application unconfigures all the transducers so that they no longer participate in parallel polls. As a cleanup step before exiting, the application returns the interface board back to its original state by taking it offline. © National Instruments Corp. 2-19 NI-488.2M SRM for OS/2...
  • Page 44 Parallel Polls Non-GPIB Activity PPoll Parallel Poll Are All Metals Ready? SendList "MIX ON" Start Power Supplies PPollUnconfig PPoll Parallel Poll Unconfigure Disable CLEAN UP Figure 2-8. Program Flowchart for Example 8 NI-488.2M SRM for OS/2 2-20 © National Instruments Corp.

  • Page 45: Example 9: Non-Controller Example

    Application Examples Example 9: Non-Controller Example This example illustrates how you can use the NI-488.2M software to emulate a GPIB device that is not the GPIB Controller. A software engineer has written firmware to emulate a GPIB device for a research project and is testing it by using an application that makes simple GPIB calls.
  • Page 46 Is This the Internal Clear Event? State Is This the Talk Addressed Event? ibwrt Write Out Data New Data ibrd Read In Data New Data Figure 2-9. Program Flowchart for Example 9 NI-488.2M SRM for OS/2 2-22 © National Instruments Corp.

  • Page 47: Developing Your Application

    This chapter explains how to develop a GPIB application program using NI-488 functions and NI-488.2 routines. Choosing a Programming Method Programs that need to communicate across the GPIB can access the NI-488.2M driver using either the NI-488.2 language interface or the OS/2 API calls. Using the NI-488.2 Language Interface One method of programming the NI-488.2M driver is with an NI-488.2...

  • Page 48: Using Ni-488 Functions: One Device For Each Board

    GPIB protocol or bus management. For information about device-level calls and how they manage the GPIB, refer to Device-Level Calls and Bus Management, in Chapter 6, GPIB Programming Techniques. NI-488.2M SRM for OS/2 © National Instruments Corp.

  • Page 49: Ni-488 Board-Level Functions

    Find all of the Listeners on the bus • Configure the attached instruments • Find a device requesting service • Determine the state of the SRQ line • Wait for SRQ to be asserted • Address multiple devices © National Instruments Corp. NI-488.2M SRM for OS/2...

  • Page 50: Using The Os/2 Api Interface

    Using the OS/2 API Interface If the NI-488.2 interface does not meet your requirements, you can access the NI-488.2M driver through the OS/2 API interface. This interface uses the OS/2 standard device driver interface instead of a particular language interface.

  • Page 51: Table 3-1. Status Word (Ibsta) Layout

    GPIB error, use either of the following statements after each NI-488 function and NI-488.2 routine: if (ibsta & ERR) gpiberr(); if (ibsta & 0x8000) gpiberr(); where gpiberr() is an error-handling routine that you have defined. © National Instruments Corp. NI-488.2M SRM for OS/2...

  • Page 52: Error Variable-Iberr

    Data begins in the array at index 0; therefore, ibcntl is the position for the null character that marks the end of the string. NI-488.2M SRM for OS/2 © National Instruments Corp.

  • Page 53: Using Ibic To Communicate With Devices

    If the function is declared as follows void gpiberr (char *msg); /* function prototype */ your application invokes the function as follows if (ibsta & ERR) { gpiberr("GPIB error"); © National Instruments Corp. NI-488.2M SRM for OS/2...

  • Page 54: Ni-488 Program Shell

    • Clear Device (ibclr) (ibrsp) • Serial Poll Device and so on Finished GPIB Programming? Close Board or Device (ibonl) Closed All Boards/Devices? Figure 3-1. General Program Shell Using NI-488 Device Functions NI-488.2M SRM for OS/2 © National Instruments Corp.

  • Page 55: General Program Steps And Examples

    Send END message with the last byte when writing to the device – Disable EOS detection mode When you call ibdev, the driver automatically initializes the GPIB by sending an Interface Clear (IFC) message and placing the device in the remote programming state. © National Instruments Corp. NI-488.2M SRM for OS/2...
  • Page 56 Next, you must instruct the device to send the next triggered reading to its GPIB output buffer. ibtrg(ud); if (ibsta & ERR) { gpiberr("ibtrg error"); NI-488.2M SRM for OS/2 3-10 © National Instruments Corp.
  • Page 57 4 in the status byte that you receive from the instrument. ibrsp (ud, &StatusByte); if (ibsta & ERR) { gpiberr("ibrsp error"); if ( !(StatusByte & MAVbit)) { gpiberr("Improper Status Byte"); printf(" Status Byte = 0x%x\n", StatusByte); © National Instruments Corp. 3-11 NI-488.2M SRM for OS/2...
  • Page 58 10 readings is %f\n", sum/10.0); Step 8. Place the Device Offline As a final step, take the device offline by using the ibonl function. ibonl (ud, 0); NI-488.2M SRM for OS/2 3-12 © National Instruments Corp.

  • Page 59: Writing Your Ni-488.2 Application

    If the function is declared as follows void gpiberr (char *msg); /* function prototype */ your application invokes the function as follows if (ibsta & ERR) { gpiberr("GPIB error"); © National Instruments Corp. 3-13 NI-488.2M SRM for OS/2...

  • Page 60: Ni-488.2 Program Shell

    • Receive Data from Addressed Talker (ReadStatusByte) (RcvRespMsg) and so on and so on Finished GPIB Programming? Close Board (ibonl) Are All Boards Closed? Figure 3-2. General Program Shell Using NI-488.2 Routines NI-488.2M SRM for OS/2 3-14 © National Instruments Corp.

  • Page 61: General Program Steps And Examples

    (loop = 0; loop <=30; loop++){ instruments[loop] = loop; instruments[31] = NOADDR; printf("Finding all Listeners on the bus...\n"); Findlstn(0, instruments, result, 30); if (ibsta & ERR) { gpiberr("FindLstn error"); © National Instruments Corp. 3-15 NI-488.2M SRM for OS/2...
  • Page 62 The constant NLend signals that the new line character with EOI is automatically appended to the data to be sent. The constant STOPend indicates that the read is stopped when EOI is detected. NI-488.2M SRM for OS/2 3-16 © National Instruments Corp.
  • Page 63 Send to append a linefeed character with EOI asserted to the end of the message sent to the multimeter. Send (0, fluke, "VAC; AUTO; TRIGGER 2; *SRE 16", 29L, NLend); if (ibsta & ERR) { gpiberr("Send setup error"); © National Instruments Corp. 3-17 NI-488.2M SRM for OS/2...
  • Page 64 GPIB address of the instrument, and the last argument is a variable that ReadStatusByte uses to store the status byte of the instrument. ReadStatusByte(0, fluke, &statusByte); if (ibsta & ERR) { gpiberr("ReadStatusByte error"); NI-488.2M SRM for OS/2 3-18 © National Instruments Corp.
  • Page 65 Repeat Steps 5 through 8 in a loop until 10 measurements have been read, then print the average of the readings as shown: printf (" The average of the 10 readings is : %f\n", sum/10); © National Instruments Corp. 3-19 NI-488.2M SRM for OS/2...

  • Page 66: Compiling And Linking Your Program

    Compile your 32-bit IBM C program by using the following command: cprog.c then enter the following command to link your compiled program with the NI- 488.2 32-bit IBM C language interface: link386 /NOI cprog.obj,,,ni488.lib; NI-488.2M SRM for OS/2 3-20 © National Instruments Corp.

  • Page 67: 16-Bit C Applications

    LIBPATH statement in your config.sys file. For example, if the DLL is in a directory d:\at-gpib\c, the LIBPATH configuration command may appear as follows: LIBPATH=.;d:\os2\dll;d:\os2\mdos;d:\;d:\at-gpib\c; If you discover errors when you execute the program, refer to Chapter 4, Debugging Your Application. © National Instruments Corp. 3-21 NI-488.2M SRM for OS/2...

  • Page 68: Debugging Your Application

    Before you run your application program, you should run the software diagnostic test, ibtest, that came with your NI-488.2M software. The ibtest program is an NI-488.2M application that makes calls to the driver. If ibtest passes, your GPIB hardware and NI-488.2M software are interacting correctly.

  • Page 69: Presence Test Of Gpib Board

    Call(25) 'ibcmd “ “' failed, ibsta (0x134) not what was expected (0x8130) Call(25) 'ibcmd “ “' failed, expected ibsta (0x100) to have the ERR bit set. Disconnect all GPIB cables before trying the test again. NI-488.2M SRM for OS/2 © National Instruments Corp.

  • Page 70: Debugging With The Global Status Variables

    Debugging Your Application Debugging with the Global Status Variables After each function call to your NI-488.2M driver, ibsta, iberr, and ibcnt are updated before the call returns to your application. You should check for an error after each GPIB call. Refer to Chapter 3, Developing Your Application, for more information about how to use these variables within your program to automatically check for errors.

  • Page 71: Configuration Errors

    Data is corrupted If these problems occur, make sure that the GPIB hardware settings match the NI-488.2M software settings for the interrupt request level and the DMA channel. For information on hardware and software default settings, refer to the getting-started manual that came with your kit. The next section discusses how to reconfigure your NI-488.2M software, if necessary.

  • Page 72: Reconfiguring The Ni-488.2M Software

    If your program uses dynamic configuration, it will always work regardless of the previous driver configuration. For more information, refer to the description of ibconfig in the NI-488.2M Function Reference Manual for OS/2. Timing Errors If your application fails but the same calls issued in ibic are successful, your program might be issuing the NI-488.2 calls too quickly for your device to...

  • Page 73: Communication Errors

    IEEE 488.2 standard should remain in their current state until specific commands are sent across the GPIB to change their state. You might need to configure your NI-488.2M driver to perform repeat addressing if your device does not remain in its currently addressed state. Refer to Chapter 7, ibconf—Interface Bus Configuration Utility, or to the description of ibconfig...

  • Page 74: Ibic-Interface Bus Interactive Control Utility

    The mnemonic value of the error variable (iberr) if an error exists (the ERR bit is set in ibsta). • The count value for each read, write, or command function. • The data received from your instrument. © National Instruments Corp. NI-488.2M SRM for OS/2...

  • Page 75: Starting Ibic

    Starting ibic The ibic program is contained in ibic.exe, the executable file that was copied from your distribution disk when you installed the NI-488.2M software. To run ibic, change to the appropriate subdirectory (AT-GPIB in the following example) and enter ibic at the prompt as shown: C:/AT-GPIB>...

  • Page 76: Table 5-1. Syntax For Ni-488 Functions In Ibic

    Set/clear ist ibist [v] iblines Read the state of all GPIB lines dev, brd ibln v v Check for presence of device of bus dev, brd Go to local dev, brd ibloc (continues) © National Instruments Corp. NI-488.2M SRM for OS/2...
  • Page 77 Trigger selected device Wait for selected event dev, brd ibwait [mask] ibwrt string Write data Write data asynchronously dev, brd ibwrta string ibwrtf Write data from a file dev, brd flname NI-488.2M SRM for OS/2 © National Instruments Corp.

  • Page 78: Table 5-2. Syntax For Ni-488.2 Routines In Ibic

    Send command bytes SendCmds data Send data bytes 4,11,12 SendDataBytes list data mode Send interface clear SendIFC Send data to multiple 4,11,12 SendList list data mode devices Put devices in local lockout SendLLO (continues) © National Instruments Corp. NI-488.2M SRM for OS/2...
  • Page 79 SetRWLS list lockout state Cause multiple devices to TestSys list perform self tests TestSRQ Test for service request Trigger address Trigger a device TriggerList list Trigger multiple devices Wait for service request WaitSRQ NI-488.2M SRM for OS/2 © National Instruments Corp.
  • Page 80 (see note 3), or a mask bit mnemonic. ibdev parameters are board id, pad, sad, tmo, eos, and eot. ibln parameters are pad and sad. © National Instruments Corp. NI-488.2M SRM for OS/2...
  • Page 81 Refer to the description of ibconfig in the NI-488.2M Function Reference Manual for OS/2 for the allowed mnemonics and their values.

  • Page 82: Adding End-Of-String Characters

    8 The \r and \n represent the carriage return and linefeed characters, respectively. Refer to Appendix A, Multiline Interface Messages, in the NI-488.2M Function Reference Manual for OS/2 for more information about non-printable characters. Status Word Return In ibic, all NI-488 functions (except ibfind and ibdev) and NI-488.2 routines return the status word ibsta in two forms: a hex value in square brackets and a list of mnemonics in parentheses.

  • Page 83: Error Codes Return

    The count return has a different meaning, depending on which NI-488 function or NI-488.2 routine is called. Refer to the function descriptions in the NI- 488.2M Function Reference Manual for OS/2 for the correct interpretation of the count return. NI-488.2M SRM for OS/2 5-10 © National Instruments Corp.

  • Page 84: Common Ni-488.2 Routines In Ibic

    EOI. You want to send the message from the computer to the devices at primary address 2 and 17. To do this, enter the SendList command at the 488.2 (0): prompt. © National Instruments Corp. 5-11 NI-488.2M SRM for OS/2...

  • Page 85: Receive

    The acquired data is then displayed in hex format along with its ASCII equivalent. The ibic program also displays the status word and the count of transferred bytes. NI-488.2M SRM for OS/2 5-12 © National Instruments Corp.

  • Page 86: Common Ni-488 Functions In Ibic

    For more information about valid names, refer to Chapter 7, ibconf—Interface Bus Configuration Utility. ibdev The ibdev command selects an unopened device, opens it, and initializes its access board. © National Instruments Corp. 5-13 NI-488.2M SRM for OS/2...
  • Page 87 6), a secondary address of hex 67 (sad = 0x67), a timeout of 10 ms (tmo = 7), the END message enabled (eot = 1), and the EOS mode disabled (eos = 0). : ibdev 0 6 0x67 7 1 0 id = 32259 ud0: NI-488.2M SRM for OS/2 5-14 © National Instruments Corp.
  • Page 88 If the ibdev call returns with an EARG error, you must identify which parameter is incorrect and use the appropriate command to correct it. In the following example, pad has an invalid value. You can correct it with an ibpad call. © National Instruments Corp. 5-15 NI-488.2M SRM for OS/2...

  • Page 89: Ibwrt

    [0100] (cmpl) count: The returned status word [0100] indicates a successful I/O completion, while the byte count indicates that all six characters were sent from the computer and received by the device. NI-488.2M SRM for OS/2 5-16 © National Instruments Corp.

  • Page 90: Ibrd

    This command acquires data from the device and displays it on the screen in hex format and in its ASCII equivalent, along with information about the data transfer, such as the status word and the byte count. © National Instruments Corp. 5-17 NI-488.2M SRM for OS/2...

  • Page 91: Auxiliary Functions

    If option is omitted, a menu of options appears. Replace function with correct ibic function syntax. filename is the path name of a file that contains ibic functions to be executed. NI-488.2M SRM for OS/2 5-18 © National Instruments Corp.

  • Page 92: Set (Select Device Or Board)

    This example assumes that you used ibconf to define the name plotter and that you had already called ibfind plotter during an earlier ibic session. The following example summarizes the use of ibfind and set in a typical program. © National Instruments Corp. 5-19 NI-488.2M SRM for OS/2...

  • Page 93: Help (Display Help Information)

    For example, the topic list1 lists all NI-488 functions. The status topic lists all status word (ibsta) codes. Help also gives information about the syntax of functions. NI-488.2M SRM for OS/2 5-20 © National Instruments Corp.

  • Page 94: (Repeat Previous Function)

    The + function causes the display to be restored. The following example shows how the - and + functions are used. Twenty-four consecutive letters of the alphabet are read from a device using three ibrd calls. © National Instruments Corp. 5-21 NI-488.2M SRM for OS/2...

  • Page 95: N* (Repeat Function N Times)

    In the following example, the message Hello is sent to the printer five times. printer: 5*ibwrt "Hello" In the following example, Hello is first sent 20 more times, then 10 more times. NI-488.2M SRM for OS/2 5-22 © National Instruments Corp.

  • Page 96: (Execute Indirect File)

    The following example repeats the operation three times. gpib0: 3*$ usrfile The display mode, in effect before this function was executed, is restored afterward but may be changed by functions in the indirect file. © National Instruments Corp. 5-23 NI-488.2M SRM for OS/2...

  • Page 97: Print (Display The Ascii String)

    NI-488.2 Routines Example This section shows how you might use ibic to test a sequence of NI-488.2 routines. Use the set command to set up ibic for NI-488.2 calls. NI-488.2M SRM for OS/2 5-24 © National Instruments Corp.
  • Page 98 [0130] (cmpl cic atn) Clear the device. The device is assumed to be on the GPIB bus at primary address 2. DevClear 2 488.2 (0): [0138] (cmpl cic atn tacs) count: 4 © National Instruments Corp. 5-25 NI-488.2M SRM for OS/2...
  • Page 99 Write the routine, range, and trigger source information to a digital voltmeter. 488.2 (0): Send 2 "F3R7T3" DABend [0128] (cmpl cic tacs) count: 6 Trigger the device. 488.2 (0): Trigger 2 [0138] (cmpl cic atn tacs) count: 4 NI-488.2M SRM for OS/2 5-26 © National Instruments Corp.
  • Page 100 • • N D C V - 0 30 30 2e 30 30 34 37 45 0 0 . 0 0 4 7 E 2b 30 0d 0a + 0 • • © National Instruments Corp. 5-27 NI-488.2M SRM for OS/2...

  • Page 101: Ni-488 Device Functions Example

    Find the device name that was given to the device in the ibconf program. : ibfind dvm id=32259 dvm: Clear the device. dvm: ibclr [0100] (cmpl) Write the function, range, and trigger source instructions to the DVM. ibwrt "F3R7T3" dvm: [0100] (cmpl) count: 6 NI-488.2M SRM for OS/2 5-28 © National Instruments Corp.
  • Page 102 (TIMO RQS) [0900] (rqs cmpl) Read the serial poll status byte. This serial poll status byte varies, depending on the device used. ibrsp dvm: [0100] (cmpl) Poll: 0x40 (decimal : 64) © National Instruments Corp. 5-29 NI-488.2M SRM for OS/2...
  • Page 103 N D C V 0 0 0 2e 30 30 34 37 45 2b 30 . 0 0 4 7 E + 0 0a 0a • • Terminate the ibic program. dvm: e NI-488.2M SRM for OS/2 5-30 © National Instruments Corp.

  • Page 104: Ni-488 Board Functions Example

    Send IFC to all devices. IFC clears the bus and asserts attention (ATN) on the bus. gpib0: ibsic [0130] (cmpl cic atn) Turn on the remote enable signal (REN). gpib0: ibsre 1 [0130] (cmpl cic atn) previous value: 0 © National Instruments Corp. 5-31 NI-488.2M SRM for OS/2...
  • Page 105 4 Write the function, range, and trigger source instructions to the DVM. Be sure an error has not occurred before proceeding. ibwrt "F3R7T3" gpib0: [0128] (cmpl cic tacs) count: 6 NI-488.2M SRM for OS/2 5-32 © National Instruments Corp.
  • Page 106 Controller. The hex value 18 represents the serial poll enable function, while A represents the talk address of the device. gpib0: ibcmd "?_ \x18A" [1174] (srqi cmpl rem cic atn lacs) count: 5 © National Instruments Corp. 5-33 NI-488.2M SRM for OS/2...
  • Page 107 • • N D C V - 0 30 30 2e 30 30 34 37 45 0 0 . 0 0 4 7 E 2b 30 0d 0a + 0 • • NI-488.2M SRM for OS/2 5-34 © National Instruments Corp.
  • Page 108 Chapter 5 ibic—Interface Bus Interactive Control Utility 12. Terminate the ibic program. gpib0: e © National Instruments Corp. 5-35 NI-488.2M SRM for OS/2...

  • Page 109: Gpib Programming Techniques

    You can use the ibeot function to enable the end of transmission (EOT) mode. If EOT mode is enabled, the NI-488.2M driver asserts the GPIB EOI line when the last byte of a write is sent out on the GPIB. If it is disabled, the EOI line is not asserted with the last byte of a write.

  • Page 110: Waiting For Gpib Conditions

    • The EOS read method. If the EOS read method is enabled, the NI-488.2M driver terminates ibrd calls when the EOS byte is detected on the GPIB or when the GPIB EOI line is asserted or when the specified count has been reached. If the EOS read method is disabled, ibrd calls terminate only when the GPIB EOI line is asserted or the specified count has been read.

  • Page 111: Serial Polling

    The interface board returns a response byte of hex 42. The current CIC passes control to the GPIB board. If the current CIC does not pass control, the NI-488.2M driver returns the ECIC error code to your application. This error can occur if the current CIC does not understand the CIC protocol.

  • Page 112: Service Requests From Ieee 488.2 Devices

    You should empty the queue as soon as an automatic serial poll occurs, because autopolling may not continue if the queue is full. NI-488.2M SRM for OS/2 © National Instruments Corp.

  • Page 113: Autopolling And The Stuck Srq State

    NI-488 call as long as no GPIB is currently I/O in progress. This means that an automatic serial poll can occur even when your application is not making any calls to the NI-488.2M software. Autopolling can also occur when a device-level ibwait for RQS is in progress.

  • Page 114: Srq And Serial Polling With Ni-488 Device Functions

    SerialPollResponse; SRQ and Serial Polling with NI-488.2 Routines The NI-488.2M software includes a set of NI-488.2 routines that you can use to conduct SRQ servicing and serial polling. Routines pertinent to SRQ servicing and serial polling are AllSpoll, FindRQS, ReadStatusByte, TestSRQ, and WaitSRQ.

  • Page 115: Example 1

    This example illustrates the use of FindRQS to determine which device is requesting service. void GetASerialPollResponse ( char *DevicePad, char *DeviceResponse ) char SerialPollResponse = 0; int WaitResult; Addr4882_t Addrlist[4] = {3,4,5,NOADDR}; WaitSRQ (0, &WaitResult); if (WaitResult) { printf (“SRQ is asserted.\n”); © National Instruments Corp. NI-488.2M SRM for OS/2...

  • Page 116: Example 2

    /* Use Allspoll to serial poll all the devices at once.*/ AllSpoll ( 0, AddrList, ResponseList ); if (!(ibsta & ERR)) for ( i = 0; AddrList[i] != NOADDR; i++ ) printf(“Device at pad %x returned byte %x.\n”, AddrList[i], ResponseList[i] ); return; NI-488.2M SRM for OS/2 © National Instruments Corp.

  • Page 117: Parallel Polling

    Implementing a Parallel Poll You can implement parallel polling with either NI-488 functions or NI-488.2M routines. If you use NI-488.2M routines to execute parallel polls, you do not need extensive knowledge of the parallel polling messages. However, you should use the NI-488.2M functions for parallel polling when the GPIB board is not the Controller and must configure itself for a parallel poll and set its own individual status bit (ist).

  • Page 118: Parallel Polling With Ni-488 Functions

    Follow these steps to implement parallel polling using NI-488 functions. Each step contains example code. Configure the device for parallel polling using the ibppc function, unless the device can configure itself for parallel polling. NI-488.2M SRM for OS/2 6-10 © National Instruments Corp.
  • Page 119 In the following example, the GPIB board is to configure itself to participate in a parallel poll. It asserts DIO5 when ist = 1 if a parallel poll is conducted. © National Instruments Corp. 6-11 NI-488.2M SRM for OS/2...
  • Page 120 Unconfigure the device for parallel polling with ibppc. Notice that any value having the parallel poll disable bit set (bit 4) in the bit pattern disables the configuration, so you can use any value between hex 70 and ibppc(dev, 0x70); NI-488.2M SRM for OS/2 6-12 © National Instruments Corp.

  • Page 121: Ibconf-Interface Bus Configuration Utility

    If you use dynamic configuration, you do not need to run ibconf before you start your application. Also, you can run your application on any computer with the appropriate NI-488.2M software regardless of its configuration, because the application configures the driver as necessary.

  • Page 122: Levels Of Ibconf

    The four levels are described in detail in the following sections. Input Selection Level Figure 7-1 shows the screen of the input selection level in ibconf. Figure 7-1. Input Selection Level of ibconf NI-488.2M SRM for OS/2 © National Instruments Corp.
  • Page 123 • Driver—an NI-488.2M driver file for OS/2, such as gpib.sys, that you copy from the distribution disk to your hard disk. Changes to a driver file do not affect your application until the system is restarted.

  • Page 124: Map Level

    The following options are available at the map level: • Device map of the boards • Help • Rename • (Dis)connect • Edit • Exit The following sections describe the options available in the map level of ibconf. NI-488.2M SRM for OS/2 © National Instruments Corp.
  • Page 125 You cannot rename the access boards gpib0, gpib1, gpib2, and gpib3. If you have pressed <F4 > and have then decided not to rename the device, press <F4> again to abort the function. © National Instruments Corp. NI-488.2M SRM for OS/2...

  • Page 126: (Dis)Connect

    Exiting ibconf section, which is located later in this chapter. If you have pressed <F9> and have then decided not to exit, press <F9> again to abort the function. NI-488.2M SRM for OS/2 © National Instruments Corp.

  • Page 127: Description Level

    The following options are available at the description level: • Change Characteristics • Next Board/Device © National Instruments Corp. NI-488.2M SRM for OS/2...

  • Page 128: Help

    Use <F6> to reset the current characteristic to the value it contained when it was last modified. Return to Map Use <F9> or <Esc> at the description level to return to the map level of ibconf. NI-488.2M SRM for OS/2 © National Instruments Corp.

  • Page 129: Output Selection Level

    For information on characteristics specific to a given driver, check the getting-started manual that came with your interface board. The following paragraphs describe the options available in ibconf for the NI- 488.2M software for OS/2. © National Instruments Corp. NI-488.2M SRM for OS/2...

  • Page 130: Primary Gpib Address

    The GPIB primary address of any device is set within the device, either with hardware switches or a software program. The address set within the device must correspond to the address in the memory-resident driver. In the NI-488.2M driver for OS/2, the default primary addresses of dev1 through dev32 are 1 through 32, respectively.

  • Page 131: Terminate Read On Eos

    You must explicitly include this byte in your data string. The EOS byte designation informs the driver of its value so that I/O can terminate correctly. © National Instruments Corp. 7-11 NI-488.2M SRM for OS/2...

  • Page 132: Send Eoi At End Of Write

    GPIB-Specific Errors Boards and devices have a switch that specifies whether the NI-488.2M driver returns OS/2 device errors or GPIB device errors when API IOCtl functions are used. A no response causes the OS/2 API functions (except the status query function) to return OS/2 device errors.

  • Page 133: Enable Auto Serial Polling

    2 µs. If you are using a GPIB bus extender in transparent parallel poll mode, you should increase the poll duration to 10 µs so that the bus extender can operate transparently to your applications. © National Instruments Corp. 7-13 NI-488.2M SRM for OS/2...

  • Page 134: Use This Gpib Interface

    Note: On Micro Channel systems, you can change the DMA channel only by booting the reference diskette. However, you can enable or disable the use of DMA with the ibconf utility. NI-488.2M SRM for OS/2 7-14 © National Instruments Corp.

  • Page 135: Interrupt Jumper Setting

    But it might be a problem for some older IEEE 488 devices that require their GPIB address to be sent with each I/O operation. Select yes to enable repeat addressing in such a situation. The default option for this characteristic is no. © National Instruments Corp. 7-15 NI-488.2M SRM for OS/2...

  • Page 136: Default Configurations In Ibconf

    Each GPIB board and device is set to return GPIB-specific errors while executing API-style calls. • At the end of each NI-488.2 routine, the NI-488.2M driver leaves the bus in its currently addressed state (IEEE 488.2 standard). • The time limit for a serial poll is set for 1 s.

  • Page 137: Exiting Ibconf

    If ibconf detects any problems, it notifies you and gives you the option of either re-entering or exiting ibconf. To disable automatic checking, use expert mode by entering the following command when you start ibconf: ibconf -e © National Instruments Corp. 7-17 NI-488.2M SRM for OS/2...

  • Page 138: Table A-1. Status Word (Ibsta) Layout

    1000 SRQ interrupt received Device requesting service CMPL dev, brd I/O completed Lockout State Remote State Controller-In-Charge Attention is asserted TACS Talker LACS Listener DTAS Device Trigger State DCAS Device Clear State © National Instruments Corp. NI-488.2M SRM for OS/2...

  • Page 139: Appendix A Status Word Conditions

    GPIB board is CIC, the GPIB SRQ line is asserted, and the automatic serial poll capability is disabled. SRQI is cleared when the GPIB board ceases to be the CIC or when the GPIB SRQ line is unasserted. NI-488.2M SRM for OS/2 © National Instruments Corp.
  • Page 140 GPIB board detects the Local Lockout (LLO) message has been sent either by the GPIB board or by another Controller. LOK is cleared when the System Controller unasserts the Remote Enable (REN) GPIB line. © National Instruments Corp. NI-488.2M SRM for OS/2...
  • Page 141 GPIB board itself or by another Controller. TACS is cleared whenever the GPIB board detects the Untalk (UNT) command, its own listen address, a talk address other than its own talk address, or Interface Clear (IFC). NI-488.2M SRM for OS/2 © National Instruments Corp.
  • Page 142 Controller. DCAS is cleared on any call immediately following an ibwait call if the DCAS bit was set in the ibwait mask parameter, or on any call immediately following a read or write. © National Instruments Corp. NI-488.2M SRM for OS/2...

  • Page 143: Table B-1. Gpib Error Codes

    Asynchronous I/O in progress ECAP No capability for operation EFSO File system error EBUS GPIB bus error ESTB Serial poll status byte queue overflow ESRQ SRQ stuck in ON position ETAB Table problem © National Instruments Corp. NI-488.2M SRM for OS/2...

  • Page 144: Error Codes And Solutions

    Make sure the NI-488.2M driver is installed by checking the gpibinst.inf file in the root directory. Check the config.sys file in the root directory and make sure it contains the following line: DEVICE= dir \gpib.sys...
  • Page 145 ENOL can occur in situations in which the GPIB board is not the CIC and the Controller asserts ATN before the write call in progress has ended. © National Instruments Corp. NI-488.2M SRM for OS/2...
  • Page 146 Solutions Make sure that the GPIB board is addressed correctly before calling ibrd or ibwrt. Avoid calling ibgts except immediately after an ibcmd call (ibcmd causes ATN to be asserted). NI-488.2M SRM for OS/2 © National Instruments Corp.
  • Page 147 Do not use a device descriptor in a board function or vice versa. ESAC (5) ESAC results when ibsic, ibsre, SendIFC, or EnableRemote is called when the GPIB board does not have System Controller capability. © National Instruments Corp. NI-488.2M SRM for OS/2...
  • Page 148 Make sure a GPIB board is in your computer that is configured both in hardware and software at a free base I/O address. Make sure that the Use this GPIB Interface field in ibconf is set to Yes. NI-488.2M SRM for OS/2 © National Instruments Corp.
  • Page 149 Solutions Check the validity of the call, or make sure your GPIB interface board and the driver both have the needed capability. © National Instruments Corp. NI-488.2M SRM for OS/2...
  • Page 150 Check for loose or faulty cabling or several powered off instruments on the GPIB. If the timeout period is too short for the driver to send command bytes, increase the timeout period. NI-488.2M SRM for OS/2 © National Instruments Corp.
  • Page 151 Check to see whether other devices not used by your application are asserting SRQ. Disconnect them from the GPIB if necessary. Call ibrsp for the device whose serial poll queue is full. © National Instruments Corp. NI-488.2M SRM for OS/2...
  • Page 152 • In the case of FindRQS, ETAB means that none of the devices in the given table were requesting service. Solutions Increase the size of result arrays for FindLstn and FindRQS. NI-488.2M SRM for OS/2 B-10 © National Instruments Corp.

  • Page 153: Customer Communication

    Filling out a copy of the Technical Support Form before contacting National Instruments helps us help you better and faster. National Instruments provides comprehensive technical assistance around the world.
  • Page 154 Getting Started Manual. Use additional pages if necessary. Name Company Address Fax ( Phone ( Computer brand Model Processor Operating system Speed Display adapter Mouse Other adapters installed Hard disk capacity Brand Instruments used National Instruments hardware product model Revision Configuration (continues)
  • Page 155 National Instruments software product Version Configuration The problem is List any error messages The following steps will reproduce the problem...
  • Page 156 Documentation Comment Form National Instruments encourages you to comment on the documentation supplied with our products. This information helps us provide quality products to meet your needs. ™ Title: NI-488.2M Software Reference Manual for OS/2 Edition Date: January 1995 Part Number:...
  • Page 157 Thank you for your help. Name Title Company Address Phone Mail to: Technical Publications National Instruments Corporation 6504 Bridge Point Parkway, MS 53-02 Austin, TX 78730-5039 Fax to: Technical Publications National Instruments Corporation MS 53-02 (512) 794-5678...

  • Page 158: Glossary

    ATN (Attention) A GPIB line that distinguishes between commands and data messages. When ATN is asserted, bytes on the GPIB DIO lines are commands. © National Instruments Corp. NI-488.2M SRM for OS/2...
  • Page 159 Glossary Automatic Serial Polling A feature of the NI-488.2M software in which (Autopolling) serial polls are executed automatically by the driver whenever a device asserts the GPIB SRQ line. Board Function A function that operates on or otherwise pertains to one of the GPIB interface boards in the computer.
  • Page 160 (END) or the parallel poll Identify (IDY) message. EOS or EOS Byte A 7- or 8-bit end-of-string character that is sent as the last byte of a data message. end of transmission © National Instruments Corp. NI-488.2M SRM for OS/2...
  • Page 161 (MSA). The GPIB board has both a GPIB address and an I/O address. GPIB Board Refers to the National Instruments family of GPIB interface boards. The NI-488.2M driver file name. gpib.sys Group Executed Trigger See GET.
  • Page 162 GPIB protocol matters. See Low-Level Function. hertz After each NI-488.2M I/O function, this global ibcnt variable contains the actual number of bytes transmitted. The NI-488.2M driver configuration program.
  • Page 163 Parallel Poll Configure function. LAD or Listen Address See MLA. Language Interface Code that enables an application program that uses NI-488.2M functions or NI-488.2M routines to access the driver. Listen Address See MLA. Listener A GPIB device that receives data messages from a Talker.
  • Page 164 One that has been enabled or placed online by a system or language open function. Parallel Poll The process of polling all configured devices at once and reading a composite poll response. See Serial Poll. See Programmed I/O. © National Instruments Corp. NI-488.2M SRM for OS/2...
  • Page 165 CIC to place devices in remote program mode. Request Service seconds Selected Device Clear is the GPIB command used to reset internal or device functions of an addressed Listener. See DCL and IFC. NI-488.2M SRM for OS/2 © National Instruments Corp.
  • Page 166 Status Word See ibsta. Synchronous Refers to the relationship between the NI-488.2M driver functions and a process when executing driver functions is predictable; the process is blocked until the OS/2 driver completes the function. System Controller The single-designated Controller that can assert control (become CIC of the GPIB) by sending the Interface Clear (IFC) message.
  • Page 167 Controller to an addressed Talker. Timeout A feature of the NI-488.2M driver that prevents I/O functions from hanging indefinitely when there is a problem on the GPIB. An integrated circuit that implements most of the GPIB Talker, Listener, and Controller functions in hardware.

  • Page 168: Index

    2-14 to 2-15 processing data, 3-12 clearing and triggering devices, reading measurement, 3-12 2-4 to 2-5 triggering devices, 3-10 end-of-string mode, 2-8 to 2-9 to 3-11 files on distribution disk, 1-1 to 1-2, 2-1 © National Instruments Corp. NI-488.2M SRM for OS/2...
  • Page 169 EOIP error code, B-7 basic communication with IEEE example, 2-6 to 2-7 488.2 compliant devices, 2-14 AT-GPIB boards, ibtest checking of, to 2-15 4-1 to 4-2 ATN (attention) line (table), 1-7 NI-488.2M SRM for OS/2 © National Instruments Corp.
  • Page 170 EDVR error code, 5-15, B-2 debugging applications. See EFSO error code, B-8 applications, debugging. end of string (EOS) default configurations in adding characters in ibic, 5-9 ibconf, 7-16 end-of-string mode (example), 2-8 to 2-9 © National Instruments Corp. NI-488.2M SRM for OS/2...
  • Page 171 5-23 EOS. See end of string (EOS). EOS byte, 7-11 EOT mode, 6-1 ERR status, A-2 error codes. See also ibsta (status files for NI-488.2M software. See word). NI-488.2M software. EABO, B-6 FindLstn routine, 3-15 EADR, 5-15, B-4...
  • Page 172 7-10 6-6 to 6-8 secondary GPIB termination of data transfers, address, 7-10 6-1 to 6-2 send EOI at end of waiting for GPIB write, 7-12 conditions, 6-2 serial poll timeout, 7-15 © National Instruments Corp. NI-488.2M SRM for OS/2...
  • Page 173 CIC protocol, 6-3 devices, 3-7 autopolling, 6-4 count return, 5-10 determining EOI line debugging applications, 4-3 assertion, 6-2 end-of-string characters, 5-9 dynamic configuration of error codes return, 5-10 drivers, 7-1 examples NI-488.2M SRM for OS/2 © National Instruments Corp.
  • Page 174 6-4 to 6-5 configuring, 3-17 serial polling, 6-6 identifying, 3-16 ibsta (status word) initializing, 3-17 ATN status, A-4 triggering, 3-18 CIC status, A-4 Interface Bus Interactive Control CMPL status, A-3 utility. See ibic utility. © National Instruments Corp. NI-488.2M SRM for OS/2...
  • Page 175 3-4 Receive function, 3-19 advantages, 3-1 to 3-2 waiting for NI-488 functions, 3-2 to 3-3 ibwait function, 3-11 NI-488.2 routines, 3-3 to 3-4 WaitSRQ routine, 3-18 NI-488.2 routines. See also specific routines. NI-488.2M SRM for OS/2 © National Instruments Corp.
  • Page 176 6-9 to 6-10 PPoll routine, 6-10 when to use, 3-3 PPollUnconfig routine, 6-10 writing applications, 3-3 to 3-4 primary GPIB address, 7-10 NI-488.2M driver, 1-1, 1-4 print (display ASCII string) NI-488.2M software function, ibic utility, 5-24 API-related files, 1-3 program shells...
  • Page 177 Set function to 6-2 description, 5-19 to 5-20 device termination methods, 4-6 selecting NI-488.2 function TestSRQ routine, 3-18, 6-7 mode, 5-11 timeout setting SRQ (service request) line configuring, 7-10 serial polls, 7-15 NI-488.2M SRM for OS/2 I-10 © National Instruments Corp.
  • Page 178 2-4 to 2-5 turn off display (-) function, ibic utility, 5-21 to 5-22 turn on display (+) function, ibic utility, 5-21 to 5-22 WaitSRQ routine, 3-18, 6-7, 6-8 writing applications. See applications, writing. © National Instruments Corp. I-11 NI-488.2M SRM for OS/2...

Table of Contents