National Instruments AT-GPIB Getting Started
National Instruments AT-GPIB Getting Started

National Instruments AT-GPIB Getting Started

Ni-488m software for interactive unix system v
Hide thumbs Also See for AT-GPIB:
Table of Contents

Advertisement

Quick Links

Getting Started with Your AT-GPIB
and the NI-488M
Software for
INTERACTIVE UNIX System V
July 1992 Edition
Part Number 320518-01
© Copyright 1992 National Instruments Corporation.
All Rights Reserved.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the AT-GPIB and is the answer not in the manual?

Questions and answers

Summary of Contents for National Instruments AT-GPIB

  • Page 1 Getting Started with Your AT-GPIB ™ and the NI-488M Software for INTERACTIVE UNIX System V July 1992 Edition Part Number 320518-01 © Copyright 1992 National Instruments Corporation. All Rights Reserved.
  • Page 2 National Instruments Corporate Headquarters 6504 Bridge Point Parkway Austin, TX 78730-5039 (512) 794-0100 (800) IEEE-488 (toll-free U.S. and Canada) Technical support fax: (512) 794-5678 Branch Offices: Australia 03 879 9422, Belgium 02 757 00 20, Canada 519 622 9310, Denmark 45 76 73 22, France 1 48 65 33 70, Germany 089 714 5093,...
  • 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 Any action against National Instruments must be brought within one year after the cause of action accrues. National Instruments shall not be liable for any delay in performance due to causes beyond its reasonable control. The warranty...
  • Page 5 FCC/DOC Radio Frequency Interference Compliance This equipment generates and uses radio frequency energy and, if not installed and used in strict accordance with the instructions in this manual, may cause interference to radio and television reception. This equipment has been tested and found to comply with the following regulatory agencies: •...
  • Page 6 U.S. Government Printing Office, Washington, DC 20402, Stock Number 004-000-00345-4. Bescheinigung des Herstellers/Importeurs Hiermit wird bescheinigt, daß die AT-GPIB in Übereinstimmung mit den Bestimmungen der Vfg. 1046/1984 funk-entstört ist. Der Detusche Bundespost wurde das Inverkehrbringen dieses Gerätes angezeigt und die Berechtigung zur Überprüfung der Serie auf...
  • Page 7: Table Of Contents

    New Kernel ..........2-7 Chapter 3 Hardware Configuration and Installation ......3-1 Step 1. Unpack Your AT-GPIB ..........3-1 Step 2. Configure the Hardware..........3-1 Choose the Switch and Jumper Settings ...... 3-2 Set the Base I/O Address ..........3-3 Set the Interrupt Request Line ........3-5 Set the DMA Channel ..........3-6...
  • Page 8 Appendix A Additional NI-488M Functions ........... A-1 IBDEV(3) ................... A-2 IBLINES(3) ................A-4 IBLN(3) ..................A-6 Appendix B Hardware Specifications ..............B-1 Appendix C Customer Communication ............C-1 Glossary ....................G-1 AT-GPIB/NI-488M/INTERACTIVE UNIX v i i i © National Instruments Corp.
  • Page 9 Contents Figures Figure 1-1. AT-GPIB Board..............1-1 Figure 3-1. AT-GPIB Parts Locator Diagram ........3-2 Figure 3-2. Base I/O Address Switch Settings........3-4 Figure 3-3. Interrupt Jumper Settings to Match Software Defaults ..3-5 Figure 3-4. DMA Channel Jumper Setting ..........3-7 Figure 3-5.
  • Page 10: About This Manual

    The material in this manual is for users who have extensive knowledge of the INTERACTIVE UNIX operating system and have super-user privilege. This manual also assumes that the user has already received an AT-GPIB board along with a user manual.
  • Page 11: Conventions Used In This Manual

    • Appendix C, Customer Communication, contains forms you can use when requesting help from National Instruments or to comment on our products and manuals. • The Glossary contains an alphabetical list and description of terms used in this manual including abbreviations, acronyms, metric prefixes, mnemonics, and symbols.
  • Page 12: Related Documentation

    Programmer’s Reference Manual 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 13: Chapter 1 Introduction

    Chapter 1 Introduction This chapter contains a picture of the AT-GPIB board, lists the contents of your NI-488M kit and optional equipment, and briefly describes the AT-GPIB board and NI-488M software. Figure 1-1 shows the AT-GPIB board. Figure 1-1. AT-GPIB Board ©...
  • Page 14: What Your Kit Should Contain

    INTERACTIVE UNIX System V/386 Driver and C Interface 3.5 in. disk 422884-55 5.25 in. disk 420884-55 Getting Started with Your AT-GPIB and the NI -488M Software for INTERACTIVE UNIX System V 320518-01 NI-488M Software Reference Manual 320062-01 Make sure each of these items is in your kit. If any item is missing, contact National Instruments.
  • Page 15: Optional Equipment

    PC AT compatible computer with a 386 or higher processor (herein referred to as the PC AT) that is equipped with 16-bit plug-in slots. The AT-GPIB board makes the PC AT a high-performance IEEE 488 Controller.
  • Page 16: Software Installation

    Install the subset now if you have not already done so. • The NI-488M Distribution Disk for AT-GPIB and INTERACTIVE UNIX System V/386 Driver and C Interface is in tar format. Note: This disk will be referred to as the NI-488M distribution disk throughout the remainder of this manual.
  • Page 17: Step 2. Install The Software

    For a 5.25 in. disk: • Enter the following command to copy files from drive 0: tar xvf /dev/dsk/f0q15dt • Enter the following command to copy files from drive 1: tar xvf /dev/dsk/f1q15dt AT-GPIB/NI-488M/INTERACTIVE UNIX 2- 2 © National Instruments Corp.
  • Page 18: Install The Utility Files

    To install the NI-488M driver, go to the working directory (/usr/gpib) that you created earlier in this chapter under Step 2A. Set Up a Working Directory, and enter the following command: ./ibinstall © National Instruments Corp. 2- 3 AT-GPIB/NI-488M/INTERACTIVE UNIX...
  • Page 19: Choosing The Software Settings

    Choosing the Software Settings You can install up to four AT-GPIB boards. For each AT-GPIB board you install, you must select a unique base address, DMA channel, and interrupt request line. Use the software default settings if possible. Table 2-1 lists the software default settings and other possible settings.
  • Page 20: Table 2-1. Software Default Settings And Possible Settings

    The system checks your base I/O address and interrupt request line settings to make sure they are unique for each AT-GPIB board installed, but it checks the DMA channel setting for gpib0 only. The INTERACTIVE...
  • Page 21: Using The Kconfig Utility

    For more information about using kconfig, refer to the section entitled Using kconfig to Tailor Your System Kernel in the INTERACTIVE UNIX System Maintenance Procedures section of the INTERACTIVE UNIX System V/386 Release 3.2 Operating System Guide. AT-GPIB/NI-488M/INTERACTIVE UNIX 2- 6 © National Instruments Corp.
  • Page 22: Ending The Installation Procedure

    If you are using this version, you can use the kconfig CONFIGURE menu to change the NI-488M driver's software configuration settings, then choose the BUILD menu to build the kernel again. If you are using an earlier version of INTERACTIVE © National Instruments Corp. 2- 7 AT-GPIB/NI-488M/INTERACTIVE UNIX...
  • Page 23 If you need more information about the kernel configuration, you can use the files /etc/conf/cf.d/mdevice and /etc/conf/cf.d/sdevice . For an explanation of these files, refer to section 4 of the INTERACTIVE UNIX Software Development System Guide and Programmer's Reference Manual. AT-GPIB/NI-488M/INTERACTIVE UNIX 2- 8 © National Instruments Corp.
  • Page 24: Hardware Configuration And Installation

    Hardware Configuration and Installation This chapter contains step-by-step instructions for unpacking, configuring, and installing your AT-GPIB board in a PC AT after you have installed your NI-488M software. Step 1. Unpack Your AT-GPIB If you have not already unpacked your AT-GPIB board, follow these steps.
  • Page 25: Choose The Switch And Jumper Settings

    Hardware Configuration and Installation Chapter 3 Figure 3-1 shows the location of the AT-GPIB configuration jumpers and switches. Figure 3-1. AT-GPIB Parts Locator Diagram Choose the Switch and Jumper Settings The NI-488M software supports four boards: gpib0 is the default name of the first board, gpib1 is the name of the second board, and so on.
  • Page 26: Set The Base I/O Address

    I/O address 2C0 hex (refer to Figure 3-2). This setting uses the I/O address space 2C0 through 2DF hex. If you install more than one AT-GPIB board in your computer, each board must be configured to use a unique base I/O address.
  • Page 27: Figure 3-2. Base I/O Address Switch Settings

    Default Setting for gpib0 (Base I/O Address 2C0 hex) ADDRESS Binary Switch Set to Match Software Default Setting for gpib1 (Base I/O Address 2A0 hex) Figure 3-2. Base I/O Address Switch Settings AT-GPIB/NI-488M/INTERACTIVE UNIX 3- 4 © National Instruments Corp.
  • Page 28: Set The Interrupt Request Line

    Set the Interrupt Request Line Use the settings you recorded in Table 3-1 to set the interrupt request lines on your AT-GPIB board(s). If you install more than one AT-GPIB board in your computer, each board must be configured to use a unique interrupt request line.
  • Page 29: Set The Dma Channel

    Set the DMA Channel Use the settings you recorded in Table 3-1 to set the DMA channels on your AT-GPIB board(s). If you install more than one AT-GPIB board in your computer, each board must be configured to use a unique DMA channel.
  • Page 30: Figure 3-4. Dma Channel Jumper Setting

    If you do not want to use DMA for GPIB transfers, remove the two DMA jumpers on the AT-GPIB board. Removing the jumpers disconnects the AT-GPIB board from the DMA channel lines of the PC AT bus and disables the board from asserting a DRQ line on the PC AT I/O channel.
  • Page 31: Set The Shield Ground Configuration

    Figure 3-5. DMA Jumper Setting for No DMA Channel Set the Shield Ground Configuration The AT-GPIB board is set at the factory with the jumper in place to connect the logic ground of the AT-GPIB board to its shield ground. This configuration minimizes the EMI emitted from a PC AT equipped with an AT-GPIB board.
  • Page 32: Step 3. Install The Hardware

    Step 3. Install the Hardware You can install the AT-GPIB board in any unused expansion slot in your computer. After you change the switch and jumper settings, verify the settings, and record the settings in Table 3-1 and on the AT-GPIB Hardware and Software Configuration Form located in Appendix C, you are ready to install your AT-GPIB board.
  • Page 33: Software Verification And Configuration

    If the installation was successful, the National Instruments copyright statement appears on your screen when you reboot your computer, along with the software settings for each AT-GPIB board installed. If you do not see the copyright message, then the NI-488M driver is not in the kernel that the system uses to boot up with, and you need to reinstall the driver.
  • Page 34: Configure The Software With Ibconf (Optional)

    Run the verification test again, following the instructions carefully. Check the interrupt and DMA settings on your AT-GPIB board(s). They should match the settings that appear on your screen with the National Instruments copyright when you boot your computer.
  • Page 35: Using The Ni-488M Software With Your Application Program

    GPIB library libgpib.a at compile time as shown in the following examples: cc dcsamp.c cib.o cc dcsamp.c -lgpib © National Instruments Corp. 4- 3 AT-GPIB/NI-488M/INTERACTIVE UNIX...
  • Page 36: Removing The Ni-488M Software

    , refer to the section entitled Using kconfig to Tailor Your System Kernel in the INTERACTIVE UNIX System Maintenance Procedures section of the INTERACTIVE UNIX System V/386 Release 3.2 Operating System Guide . AT-GPIB/NI-488M/INTERACTIVE UNIX 4- 4 © National Instruments Corp.
  • Page 37: Additional Ni-488M Functions

    Appendix A Additional NI-488M Functions This appendix describes three additional NI-488M functions included in the NI-488M software. These functions are not described in the NI-488M Software Reference Manual . © National Instruments Corp. A- 1 AT-GPIB/NI-488M/INTERACTIVE UNIX...
  • Page 38 Be sure to return the device descriptor to the pool of available devices by calling ibonl with v = 0 when you are finished using the device. If you do not, that device will not be available for the next ibdev call. AT-GPIB/NI-488M/INTERACTIVE UNIX A- 2 © National Instruments Corp.
  • Page 39: Ibdev(3

    (iberr == EDVR) { /* Bad boardindex or no devices * available. else if (iberr == EARG) { /* The call succeeded, but at least one * pad, sad, tmo, eos, or eot is incorrect. © National Instruments Corp. A- 3 AT-GPIB/NI-488M/INTERACTIVE UNIX...
  • Page 40: Iblines(3

    For iblines to return valid data, a well-behaved IEEE 488 bus must exist. A well-behaved IEEE 488 bus is a bus in which all attached devices are following the IEEE 488 specification. AT-GPIB/NI-488M/INTERACTIVE UNIX A- 4 © National Instruments Corp.
  • Page 41 ((ibsta = iblines (brd0 , &clines)) & ERR) error(); if ( !(clines & 0x10)) { printf("GPIB board cannot monitor REN!"); exit(); if (clines & 0x1000) { printf("REN is asserted."); exit(); printf("REN is not asserted."); © National Instruments Corp. A- 5 AT-GPIB/NI-488M/INTERACTIVE UNIX...
  • Page 42: Ibln(3

    NO_SAD = 0 ALL_SAD = -1 If ud specifies a device, ibln tests for a Listener on the board associated with the given device. Refer also to IBFIND in the NI-488M Software Reference Manual. AT-GPIB/NI-488M/INTERACTIVE UNIX A- 6 © National Instruments Corp.
  • Page 43 IBLN(3) (continued) IBLN(3) Example Test for a GPIB Listener at pad 2 and sad 0x60 . ibln (ud, 2, 0x60, &listen); if (!listen) { /* No Listener found at this address */ © National Instruments Corp. A- 7 AT-GPIB/NI-488M/INTERACTIVE UNIX...
  • Page 44: Hardware Specifications

    Appendix B Hardware Specifications This appendix contains a description of the electrical, physical, and environmetal characteristics of the AT-GPIB board and the conditions under which it should be used. Table B-1. Electrical Characteristics Characteristic Specification NAT4882 clock 20 MHz Turbo clock...
  • Page 45: Table B-3. Environmental Characteristics

    Specification Operating Environment Component Temperature 0° to 70° C Relative Humidity 5% to 90%, noncondensing Storage Environment Temperature -20° to 70° C Relative Humidity 5% to 90%, noncondensing FCC Class B Certified AT-GPIB/NI-488M/INTERACTIVE UNIX B- 2 © National Instruments Corp.
  • Page 46: Customer Communication

    By completing these forms before calling National Instruments, you will save yourself time, and our applications engineers will be able to answer your questions more accurately and efficiently.
  • Page 47 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 48 National Instruments software product Version Configuration The problem is List any error messages The following steps will reproduce the problem...
  • Page 49 AT-GPIB Hardware and Software Configuration Form Record the settings and revisions of your hardware and software on the line to the right of each item. Update this form each time you revise your software or hardware configuration, and use this form as a reference for your current configuration.
  • Page 50 • Software Settings Base I/O Interrupt Address Request Line Channel gpib0 gpib1 gpib2 gpib3 Other Products • Programming Language and Version • INTERACTIVE UNIX SYSTEM V Release 3.2 Version • Computer Make and Model • Microprocessor • Clock Frequency • Type of other boards installed and their respective hardware settings Base I/O Interrupt...
  • Page 51 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: Getting Started with Your AT-GPIB and the NI -488M Software for INTERACTIVE UNIX System V Edition Date: July 1992 Part Number:...
  • Page 52 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 53: Glossary

    Institute of Electrical and Electronic Engineers Interface Clear inches Interrupt Request megabytes of memory meters NDAC Not Data Accepted NRFD Not Ready for Data Remote Enable SCSI Small Computer System Interface (bus) seconds Service Request volts direct current © National Instruments Corp. AT-GPIB/NI-488M/ INTERACTIVE UNIX...

Table of Contents