National Instruments AT-GPIB/TNT User manual

© Copyright 1994 National Instruments Corporation.
All Rights Reserved.
Getting Started with Your AT-GPIB/TNT and
the NI-488.2™Software for DOS
Graphics Applications
September 1994 Edition
Part Number 370879A-01

National Instruments Corporate Headquarters
6504 Bridge Point Parkway
Austin, TX 78730-5039
[phone]
Technical support fax: [phone]
[phone]
Branch Offices:
Australia [phone], Austria [phone], Belgium 02/757.00.20,
Canada (Ontario) [phone], Canada (Québec) [phone],
Denmark 45 76 26 00, Finland (90) 527 2321, France (1) 48 14 24 24,
Germany 089/741 31 30, Italy 02/48301892, Japan [phone],
Mexico 95 800 010 0793, Netherlands 03480-33466, Norway 32-84 84 00,
Singapore 2265886, Spain (91) 640 0085, Sweden 08-730 49 70,
Switzerland 056/20 51 51, Taiwan 02 377 1200, U.K. 0635 523545

Limited Warranty
The AT-GPIB/TNT and AT-GPIB hardware are warranted against defects in materials
and workmanship for a period of two years from the date of shipment, as evidenced by
receipts or other documentation. National Instruments will, at its option, repair or replace
equipment that proves to be defective during the warranty period. This warranty includes
parts and labor.
The media on which you receive National Instruments software are warranted not to fail
to execute programming instructions, due to defects in materials and workmanship, for a
period of 90 days from date of shipment, as evidenced by receipts or other
documentation. National Instruments will, at its option, repair or replace software media
that do not execute programming instructions if National Instruments receives notice of
such defects during the warranty period. National Instruments does not warrant that the
operation of the software shall be uninterrupted or error free.
A Return Material Authorization (RMA) number must be obtained from the factory and
clearly marked on the outside of the package before any equipment will be accepted for
warranty work. National Instruments will pay the shipping costs of returning to the
owner parts which are covered by warranty.
National Instruments believes that the information in this manual is accurate. The
document has been carefully reviewed for technical accuracy. In the event that technical
or typographical errors exist, National Instruments reserves the right to make changes to
subsequent editions of this document without prior notice to holders of this edition. 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.
EXCEPT AS SPECIFIED HEREIN, NATIONAL INSTRUMENTS MAKES NO
WARRANTIES, EXPRESS OR IMPLIED, AND SPECIFICALLY DISCLAIMS ANY
WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
CUSTOMER'S RIGHT TO RECOVER DAMAGES CAUSED BY FAULT OR NEGLIGENCE
ON THE PART OF NATIONAL INSTRUMENTS SHALL BE LIMITED TO THE AMOUNT
THERETOFORE PAID BY THE CUSTOMER. NATIONAL INSTRUMENTS WILL NOT BE
LIABLE FOR DAMAGES RESULTING FROM LOSS OF DATA, PROFITS, USE OF
PRODUCTS, OR INCIDENTAL OR CONSEQUENTIAL DAMAGES, EVEN IF ADVISED OF
THE POSSIBILITY THEREOF. This limitation of the liability of National Instruments will
apply regardless of the form of action, whether in contract or tort, including negligence.
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 provided herein does not
cover damages, defects, malfunctions, or service failures caused by owner's failure to
follow the National Instruments installation, operation, or maintenance instructions;
owner's modification of the product; owner's abuse, misuse, or negligent acts; and power
failure or surges, fire, flood, accident, actions of third parties, or other events outside
reasonable control.

Copyright
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
NAT4882®, NI-488®,Turbo488®, NI-488.2™, and TNT4882C™are trademarks of
National Instruments Corporation.
Product and company names listed are trademarks or trade names of their respective
companies.
WARNING REGARDING MEDICAL AND CLINICAL
USE OF NATIONAL INSTRUMENTS PRODUCTS
National Instruments products are not designed with components and testing intended to
ensure a level of reliability suitable for use in treatment and diagnosis of humans.
Applications of National Instruments products involving medical or clinical treatment can
create a potential for accidental injury caused by product failure, or by errors on the part
of the user or application designer. Any use or application of National Instruments
products for or involving medical or clinical treatment must be performed by properly
trained and qualified medical personnel, and all traditional medical safeguards,
equipment, and procedures that are appropriate in the particular situation to prevent
serious injury or death should always continue to be used when National Instruments
products are being used. National Instruments products are NOT intended to be a
substitute for any form of established process, procedure, or equipment used to monitor
or safeguard human health and safety in medical or clinical treatment.

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 two regulatory agencies:
Federal Communications Commission
This device complies with Part 15 of the Federal Communications Commission (FCC)
Rules for a Class B digital device. A Class B device is distinguishable from a Class A
device by the appearance of an FCC ID number located on the Class B device.
Canadian Department of Communications
This device complies with the limits for radio noise emissions from digital apparatus set
out in the Radio Interference Regulations of the Canadian Department of
Communications (DOC).
Le présent appareil numérique n’émet pas de bruits radioélectriques dépassant les limites
applicables aux appareils numériques de classe B prescrites dans le règlement sur le
brouillage radioélectrique édicté par le ministère des communications du Canada.
Instructions to Users
These regulations are designed to provide reasonable protection against harmful
interference from the equipment to radio reception in residential areas.
There is no guarantee that interference will not occur in a particular installation.
However, the chances of interference are much less if the equipment is installed and used
according to this instruction manual.
If the equipment does cause interference to radio or television reception, which can be
determined by turning the equipment on and off, one or more of the following
suggestions may reduce or eliminate the problem.
• Operate the equipment and the receiver on different branches of your AC electrical
system.
• Move the equipment away from the receiver with which it is interfering.
• Reorient or relocate the receiver’s antenna.
• Be sure that the equipment is plugged into a grounded outlet and that the grounding
has not been defeated with a cheater plug.

Notice to user: Changes or modifications not expressly approved by National
Instruments could void the user’s authority to operate the equipment
under the FCC Rules.
If necessary, consult National Instruments or an experienced radio/television technician
for additional suggestions. The following booklet prepared by the FCC may also be
helpful: How to Identify and Resolve Radio-TV Interference Problems. This booklet is
available from the 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 Detuschen Bundespost wurde das Inverkehrbringen dieses Gerätes angezeigt und die
Berechtigung zur Überprüfung der Serie auf Bestimmungen eingeräumt.

© National Instruments Corp. vii AT-GPIB/TNT for DOS Graphics
Contents
About This Manual ............................................................................................. xi
Organization of This Manual......................................................................... xi
Conventions Used in This Manual................................................................. xii
Related Documentation ................................................................................. xiii
Customer Communication............................................................................. xiii
Chapter 1
Introduction............................................................................................................1-1
How to Use This Manual............................................................................... 1-1
What You Need to Get Started ......................................................................1-2
Optional Equipment....................................................................................... 1-2
Hardware Description....................................................................................1-2
Software Description..................................................................................... 1-3
Chapter 2
Hardware Installation........................................................................................2-1
Default Hardware Configuration................................................................... 2-1
Install the Hardware....................................................................................... 2-1
Note to EISA Users ....................................................................................... 2-3
Chapter 3
Software Installation........................................................................................... 3-1
NI-488.2 Software Components ....................................................................3-1
Install the Software........................................................................................3-2
Chapter 4
Installation Verification and Troubleshooting......................................... 4-1
Run the Hardware Diagnostic Program......................................................... 4-1
Troubleshooting ibdiag Error Messages ......................................... 4-1
Using Single-Cycle DMA................................................. 4-1
Correcting Hardware Settings........................................... 4-2
Run the Software Diagnostic Program ..........................................................4-3
Troubleshooting ibtest Error Messages........................................... 4-3
Common Questions ....................................................................................... 4-4
Appendix A
Changing Hardware Configuration Settings............................................A-1
Selecting the Base I/O Address ..................................................................... A-3
Selecting the Interrupt Request Line ............................................................. A-7
Note to EISA Users......................................................................... A-9
Selecting the DMA Channel..........................................................................A-9
Note to EISA Users......................................................................... A-10

Contents
AT-GPIB/TNT for DOS Graphics viii © National Instruments Corp.
Using Programmed I/O for GPIB Transfers..................................................A-11
Setting the Shield Ground Configuration ......................................................A-11
Appendix B
Changing Software Configuration Settings............................................... B-1
Overview........................................................................................................B-1
Default Software Configuration..................................................................... B-1
Note to EISA Users ....................................................................................... B-2
Starting ibconf ............................................................................................... B-2
Upper and Lower Levels of ibconf................................................................B-3
Upper-Level Device Map................................................................B-3
Lower-Level Device/Board Characteristics....................................B-5
Board and Device Configuration Options ..................................................... B-7
Primary GPIB Address....................................................................B-7
Secondary GPIB Address................................................................B-7
Timeout Setting............................................................................... B-7
Terminate Read on EOS..................................................................B-7
Set EOI with EOS on Writes........................................................... B-8
Type of Compare on EOS............................................................... B-8
EOS Byte......................................................................................... B-8
Set EOI at End of Write................................................................... B-8
System Controller (Board Characteristic Only)..............................B-8
Assert REN when SC (Board Characteristic Only)......................... B-9
Enable Auto Serial Polling (Board Characteristic Only) ................B-9
Enable CIC Protocol (Board Characteristic Only)..........................B-9
Bus Timing (Board Characteristic Only) ........................................B-9
Cable Length for High Speed (Board Characteristic Only) ............B-9
Parallel Poll Duration (Board Characteristic Only)......................... B-9
Use This GPIB Interface (Board Characteristic Only)....................B-10
Base I/O Address (Board Characteristic Only)............................... B-10
DMA Channel (Board Characteristic Only)....................................B-10
Interrupt Jumper Setting (Board Characteristic Only) ....................B-10
Serial Poll Timeout (Device Characteristic Only)........................... B-10
Enable Repeat Addressing (Device Characteristic Only) ............... B-10
Exiting ibconf................................................................................................. B-11
Checking for Errors......................................................................... B-11
Saving Changes to the Loaded Driver............................................. B-11
Appendix C
Hardware Specifications................................................................................... C-1
Appendix D
Customer Communication............................................................................... D-1
Glossary....................................................................................................................G-1

Contents
© National Instruments Corp. ix AT-GPIB/TNT for DOS Graphics
Figures
Figure 2-1. Installing the GPIB Board................................................................... 2-2
Figure 3-1. Software Installation Screen............................................................... 3-2
Figure A-1. AT-GPIB/TNT Parts Locator Diagram............................................... A-2
Figure A-2. AT-GPIB Parts Locator Diagram ....................................................... A-3
Figure A-3. Base I/O Address Switch Settings ......................................................A-6
Figure A-4. Interrupt Jumper Setting for IRQ11 (Default Setting)........................A-8
Figure A-5. Interrupt Jumper Setting for IRQ5......................................................A-8
Figure A-6. Jumper Setting for Disabling Interrupts..............................................A-8
Figure A-7. DMA Channel Jumper Setting for DMA Channel 7........................... A-10
Figure A-8. DMA Jumper Setting for No DMA Channel......................................A-11
Figure A-9. Ground Configuration Jumper Settings ..............................................A-12
Figure B-1. Upper Level of ibconf......................................................................... B-3
Figure B-2. Lower Level of ibconf......................................................................... B-5
Tables
Table 2-1. Hardware Default Settings..................................................................2-1
Table A-1. Possible Base I/O Address Switch Settings........................................A-4
Table A-2. DMA Channels ................................................................................... A-10
Table B-1. Options for Starting ibconf ................................................................B-2
Table C-1. Electrical Characteristics of the AT-GPIB/TNT................................. C-1
Table C-2. Electrical Characteristics of the AT-GPIB ......................................... C-1
Table C-3. Physical Characteristics ......................................................................C-1
Table C-4. Environmental Characteristics............................................................C-2

© National Instruments Corp. xi AT-GPIB/TNT for DOS Graphics
About This Manual
This manual contains instructions to help you install and configure the National
Instruments AT-GPIB/TNT or AT-GPIB interface board and the NI-488.2 software for
DOS graphics applications. The NI-488.2 software is intended for use with MS-DOS
(version 3.0 or higher) or equivalent.
This manual uses the term AT-GPIB/TNT to refer to a National Instruments GPIB board
for the ISA (PC AT) bus equipped with the TNT4882C ASIC. The term AT-GPIB refers
to a National Instruments GPIB board for the ISA bus equipped with the NAT4882 and
Turbo488 ASICs. This manual also uses the term GPIB board in cases where the
material can apply to either board.
This manual assumes that you are already familiar with DOS.
Organization of This Manual
This manual is organized as follows:
• Chapter 1, Introduction, explains how to use this manual, lists what you need to get
started and optional equipment you can order, and briefly describes the GPIB
hardware and the NI-488.2 software.
• Chapter 2, Hardware Installation, contains instructions for installing your GPIB
board.
• Chapter 3, Software Installation, contains a description of the files on the NI-488.2
distribution disk and instructions for installing your NI-488.2 software.
• Chapter 4, Installation Verification and Troubleshooting, describes how to verify the
hardware and software installation and how to troubleshoot problems.
• Appendix A, Changing Hardware Configuration Settings, contains instructions for
changing the configuration settings of your GPIB board.
• Appendix B, Changing Software Configuration Settings, contains instructions for
using the ibconf utility to change the default board and device characteristics of
the NI-488.2 software for DOS.
• Appendix C, Hardware Specifications, describes the electrical, physical, and
environmental characteristics of the GPIB board and the recommended operating
conditions.
• Appendix D, Customer Communication, contains forms you can use to request help
from National Instruments or to comment on our products and manuals.