Keithley KM-488-ROM User manual

KM=4881ROM
Keithley Data Acquisition KeitNey MetraByte/Asyst

FCC Class B Compliance
NOTE: This equipment has been tested and found to comply with the limits for a Class B
Digital Device, pursuant to Part 15 of the FCC Rules. Theselimits are designed to provide
reasonable protection against harmful interference in a residential installation. This
equipment generates,uses,and can radiate radio frequency energy and, if not installed in
accordancewith the instructions, may causeharmful interference to radio communications.
However, there is no guarantee that interference will not occur in a particular installation. If
this equipment doesnot causeharmful interference to radio or television reception, which can
be determined by turning the equipment off and on, the user is encouraged to try to correct
the interferenceby one or more of the following measures:
l Reorient or relocatethe receiving antenna.
l Increasethe separation between theequipment and receiver.
l Connect the equipment into an outlet on acircuit different from that to which the receiver
isconnected.
l Consult the dealer or anexperiencedradio/tv technician for help.
NOTE: The useof a non-shielded interfacecablewith the referenceddeviceis prohibited.

User Guide
for the
KM-488-ROM
IEEE-488 Interface
Board
R~vislon A - March $99,
Copyrlghl Kelthley Data AC ulsltlon 1991
aPart Number: 244 9
KElTHLEY DATA ACQUISITION - Kelthley MetraSytelAsyst
440 Myles Standish Blvd., Taunton, MA 02790
TEL. 609/99%?0W. FAX MW990-0179
- 11,-

warrantyInformation
All products manufactured by Keithley Data Acquisition are warranted
against defectivematerials and worksmanship for aperiod of one year
from the date of delivery to the original purchaser. Any product that is
found to bedefectivewithin the warranty period will, at theoption of
the manufacturer, be repaired or replaced. This warranty doesnot apply
to products damaged by improper use.
warning
Keithley Data Acquisition assumesno liability for damages
consequent to the use of this product. This product is not designed
with components of alevel of reliability suitable for use in life
support or critical applications.
Disclaimer
Information furnished by Keithley Data Acquisition is believed to be
accurateand reliable. However, Keithley Data Acquisition assumesno
responsibility for the useof suchinformation nor for any infringements
of patentsor other rights of third parties that may result from its use. No
licenseisgranted by implication or otherwise under any patent rights of
Keithley Data Acquisition.
Copyright
All rights reserved. No part of this publication may be reproduced,
stored in a retrieval system,or transmitted in any form by any means,
electronic, mechanical,photoreproductive, recording, or otherwise
without the expressprior written permission of the Keithley Data
Acquisition.
Note:
Keithley MetraByteWis atrademark of Keithley Instruments.
Basi? is atrademark of Dartmouth College.
IBM@is a registered trademark of International BusinessMachines
Corporation.
PC,XT, AT, PS/Z,and Micro Channel Architecture@aretrademarks of
International BusinessMachinesCorporation.
Microsoft@is aregistered trademark of Microsoft Corporation.
Turbo C@isa registered trademark of Borland International.
-iv-

Contents
CHAPTER 1 - INTRODUCTION
1.1
1.2
1.3
1.4
Overview ................................... .1-l
Specifications ................................ 1 1 1 1 .I-2
Ordering Information ................................. . l-3
HowToUseThisManual.. ............................. .l-3
CHAPTER 2 - INSTALLATION
2.1
2.2
2.3
2.4
2.5
2.6
2.7
2.6
General ........................................
Unpacking & Inspecting
.2-i
Software Installation . 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 . ’ . .2-l
.2-l
Switches 3 Jumpers ............................. : : : : .2-2
Board Installation ...................................
Configuration Of The EEPROM .2-7
Reloading The EEPROM
........................ : : : : : : : : : : : : : : : : .. .2-a
2-10
Multiple Board Installation Notes ........................... 2-10
CHAPTER 3 - INTRODUCTION TO CALLABLE ROUTINES
3.1
3.2
3.3
3.4
3.5
3.6
3.7
3.6
3.9
Initializing The KM-486-ROM. ............................ .3-3
Selecting The Receive & Transmit Terminators
Transmitting Commands&Data. ........... : : : : : : : : : : : : : : : : .. .3-3
.3-5
Reading Data ..... ... ..
Transmitting/Receiving Data Via DMA
................. : : : : : : : : : : : : : : : : 3-11
3-14
Checking Device Status
..
3-15
Low-Level Routines. ...............................
................................. 3-17
Board Configuration Routines ............................ 3-16
Multiple Board Programming Notes ......................... 3-19
CHAPTER4 - PROGRAMMING IN BASICA OR GWBASIC
4.1
4.2
4.3
General ........................................ .4-i
Description Format For Routines. .4-3
Routines. . .... .. ........................ : : : : : : : : : : : : : : : : .. .4-3
CHAPTER 5 - PROGRAMMING IN QUICKBASIC
5.1
5.2 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-i
5.3 Description Format For Routines. . . . . . . . . . . . . . . . . . .5-3
Routines. . . . . . . . . . . . . . . . . . . . . . . . . . . .5-3
CHAPTER 6 - PROGRAMMING IN TURBO PASCAL
6.1
6.2
6.3
General . . . . . . . . . , . . . , . . . . . . . . . . . . . . . . . . . . . .6-l
Description Format For Routines. . . . . .
Routines. . . . . . . . . . . . . . . . : : : : : : : : : : : : : : : : : ’ . .6-2
. .6-3

Contents
CHAPTER 7 - PROGRAMMING IN C
7.1 General. ........................................ 7-l
7.2 Description Format For Routines ........................... 7-3
7.3 Routines ........................................ 7-3
CHAPTER6 - FACTORYRETURNS
APPENDICES
Appendix A - ASCII Code Chart
Appendix B - IEEE Tutorial
Appendix C - IEEE Multiline Commands
Appendix D - Device Capability Codes
Appendix E - Printer & Serial Port Redirection
n DD
- vi -

Chapter 1
INTRODUCTION
1.1 OVERVIEW
The KM4?8-ROM is an IEEE488 interfaceboard that allows programs written on IBM
PC/XT/ATs, IBM I’S225/3Os,or compatibles to communicate with an IEEE488 bus. This
Board complies with the 1978IEEE488 standard and is thus compatible with other IEEE488
products. Up to fourteen other devicesmay beconnectedto the IEEE488 bus, including
instruments, printers, and other computers. The KM48-ROM comprises a board, software,
and documentation.
Figure l-l is ablock diagram of the KM-488-ROM board.
Figure l-l. KM-4&WROh4Block Dlagram
The Kh4488-ROM design includes a Wait StateGenerator to adjust bus timing, allowing
performance within operating specificationsof the GLIB controller chip on the fastestPCs.
This Board canalsogenerateprogrammed interrupts on any of sixinterrupt request lines and
DMA transferson Channels 1,2, and 3. Selectionof messageterminators and timeouts is
modifiable to allow communication with GPIBdevicesusing non-standard charactersand
timeouts.
INTRODUCTION 1 - 1

1.2
The KM-488-ROM alsofeaturesan 8-KBEEPROM(Electrically ErasableProgrammable Read
Only Memory) containing firmware routines callable from aBASICA program. These
routines perform the IEEE-488transfer functions. KM-488ROM software libraries allow
accessto routines from programs in QuickBASIC, Microsoft C,and TURBO PASCAL.
Examplesfor eachlanguage are included.
SPECIFICATIONS
Dimensions:
DMA Level:
Interrupt URQ)Capability:
Data Transfer Rate(Governedby the
slowest device):
IEEEController Chip:
Power Consumption:
Operating Temperature:
StorageTemperature:
Humidity:
Wait States:
Net Weight:
ROM BaseAddress:
I/O BaseAddress:
DeviceInterfaceCapabilities
Supported:
OneShort PCSlot size.
Channels1,2,3, or None (JumperSelectable).
Levels2through 7or None (JumperSelectable).
> 300Kb per second.
NEC7210.
< 500mAmps.
0 to 50 T.
-4to 158‘F (-20to +70“0.
0 to 90%noncondensing.
1,2,3, or 4 (Switch Selectable).
.31 lb (.14kg).
Switch Selectable.
Switch Selectable.
SHl, AHI, T5,TE5,L.3,LE3,SRl, RLl, PPl, PP2,
DCl, DTl, Cl-5, E1/2. (SeeAppendix D for
clarification.)
1-2 KM-488~ROM USER GUIDE

1.3 ORDERING INFORMATION
PARTNUMBER DESCRIPTION
KM-488-ROM Includes the KM-488-ROM IEEE-488InterfaceBoard,
Software (on 5.25”disks), and appropriate
documentation.
KM-488-ROM/3.5 Includes the KM-488-ROM IEEE488 Interface Board,
Software (on 3.5”disks), and appropriate
documentation.
CGPIB-I 1meter IEEE-488cable.
CGPIB-2 2 meter IEEE-488cable.
CGPIB-4 4 meter IEEE-488cable.
1.4 HOW TO USE THIS MANUAL
This manual provides the information necessaryto install and program the KM-488-ROM.
The manual assumesyou are familiar with the language in which you aredeveloping your
application program; it alsoassumesyou are familiar with the IEEE-488protocol.
Chapter 2, Installation, details how to unpack, inspect,configure, and install the KM-488
ROM and how to copy the accompanying software. Additionally, Chapter 2describeshow to
install the KM48EROM software and to configure the EEPROMand reload EEPROM
software. There arealsonoteson using multiple boards in one system.
Chapter 3, Zntroductfanfothe CaRableRoutines, provides abrief functional description of each
KM488-ROM Interface Routine.
Chapter 4, Programmingthe KM-488-ROM, provides a detailed description of eachKM-488-
ROM InterfaceRoutine and how it iscalled from eachof the supported languages: BASICA,
QuickBASIC, C,and TURBO PASCAL.
Chapter 5, FactoryReturns, givesinstructions for returning the board to the factory.
The appendicescontain additional useful information. Appendix A contains an ASCII
EquivalenceChart. This giveshex and decimal equivalents for the ASCII 128Character set.
Appendix Bis an IEEE-488tutorial. Appendix C provides an explanation of the Device
Capability Identification codes. Appendix D provides across-referencechart of IEEE
Multiline Commands. Appendix Edescribeshow to usethe KM488-DD Printer Port Re-
director.
INTRODUCTION 1 - 3

0
l-4 KM-488-ROMUSERGUIDE