Tektronix User Guide for the Keithley PCF-M3 Pascal, C,,Fortran Callable Drivers For The MSTEP-3 24420A User guide

PCF-M3

Keithley Instruments, Inc.

Data Acquisition Division

User Guide

for the

Keithley MetraByte

PCF-M3

PASCAL, C, & FORTRAN

Callable Drivers

For The

MSTEP-3

Re&Jdon A - February 1992

Copyright

Keithley Instruments, Inc. Data Acquisition Division

440 MYLES STANDISH BLVD., Taunton, MA 02780

TEL. [phone], FAX 508t880-0179

Keithley Instruments, Inc. 1992

Part Number: 24429

. . .

- 111 -

Warranty Information

All products manufactured by Keithley Instruments, Inc. Data Acquisition Division
are warranted against defective materials and worksmanship for a period of one
year from the date of delivery to the original purchaser.

to be defective within the warranty period will, at the option of the manufacturer,
be repaired or replaced. This warranty does not apply to products damaged by
improper use.

Any product that is found

Warnlng

Keithley Instruments, Inc. Data Acquisition Division assumes no liability

for damages consequent to the use of this product. This product is not
designed with components of a level of reliability auitable for use in life

support or critical applications.

Dlsclalmer

Information furnished by Keithley Instruments, Inc. Data Acquisition Division is

believed to be accurate and reliable. However, the Keithley Instruments, Inc. Data
Acquisition Division assumes no responsibility for the use of such information nor

for any infringements of patents or other rights of third parttes that may result

from its use. No license is granted by implication or otherwise under any patent

rights of the Keithley Instruments, Inc. Data Acquisition Division.

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, mechantcal,

photomproductive. recording, or otherwise without the express prior written

permission of the Keithley Intsruments, Inc. Data Acquisition Division.

Note:

Keithley MetraByteN is a trademark of Keithley Instruments, Inc. Data

Acquisition Division.

Basic” is a trademark of Dartmouth College.

IBM@ is a registered trademark of International Business Machines Corporation.

PC, XT, AT, PS/2, and Micro Channel ArchitectureQ are trademarks of Intema-

tional Business Machines Corporation.

Microsoft@ is a registered trademark of Microsoft Corporation.

Turbo C@J is a registered trademark of Borland International.

- iv -

CHAPTER 1 INTRODUCTION

Contents

1.1

1.2

1.3

1.4

1.5

CHAPTER 2: DRIVER INFORMATION

2.1

2.2

2.3

2.4

2.5

2.6

CHAPTER 3: DRIVER USAGE

3.1

3.2

3.3

3.4

3.5

3.6

Overview

Supported Languages ................................. l-1

Copying The Distribution Software ........................... l-1

Generating Your Application Program ......................... l-2

This Manual. .....................................

Overview .......................................

Driver Source Modules

Drivers. ........................................

Mode Calls

Calling The Driver. ..................................

Creating New Drivers .................................

Overview
Microsoft C/Turbo C
Microsoft PASCAL

Borland Turbo PASCAL

Microsoft FORTRAN

Microsoft QuickBASIC

........................................

......................................

....................................... .3-l

................................

................................. .3-l

..................................

...............................

.................................

................................

l-1

.l-3

.2-l
.2-l
.2-l
.2-2
.2-3
.2-4

.3-3
.3-4

.3-5
.3-6

CHAPTER 4

SUMMARY OF ERROR CODES

n mm

-V-

CHAPTER 1

INTRODUCTION

1 .I OVERVIEW

The PCF-MS is a software package for programmers using Pascal, Turbo PASCAL, C, FORTRAN, and
QuickBASIC to write motion control routines (referred to herein as Application Code 1 for the MSTEP-

3. The Distribution Software for this package is normally supplied on 5.25” low-density diskettes but
is also available (upon request) on 3.5” diskette(s). Contents of the package include the following:

l MSTEP-3 Drivers for each of the supported languages
l Driver Source Modules for creating new Drivers
l Miscellaneous documentation (DOC) files

. Example program files in all supported languages

1.2 SUPPORTED LANGUAGES

The MSTEP-3 supports all memory modules of the following languages:

. Microsoft C (V4.0 - 6.0)

l Microsoft Quick C cVl.0 - 2.0)

l Microsoft Pascal 073.0 - 4.0)

. Microsoft FORTRAN (V4.0,4.1)

l Microsoft QuickBASIC (V4.0 and higher)
l Borland Turbo Pascal (V3.0 - 5.0)
l Borland Turbo C (V1.0 - 2.0)
l GW, COMPAQ and IBM BASIC (V2.0 and higher)

1.3 COPYING DISTRIBUTION SOFTWARE

As soon as possible, make a working copy of your Distribution Software. You may put the working
copy on diskettes or on the PC Hard Drive. In either case, making a working copy allows you to store
your original software in a safe place as a backup.

To make a working copy of your Distribution Software, you will use the DOS COPY or DISKCOPY
function according to one of the instructions in the following two subsections.

l-l

PCF-M3 USER GUIDE

To Copy Distribution Software To Another Diskette

Note that the source diskette is the diskette containing your Distribution Software; the target diskette
is the diskette you copy to. Before you start, be sure to have one (or more,as needed) formatted
diskettes on hand to serve as target diskettes.

First, place your Distribution Software diskette in your PC’s A Drive and log to that drive by typing

Then, use one of the following instructions to copy the diskette files.

A:.

l If your PC has just one diskette drive (Drive A), type COPY * . *

B : (in a single-drive PC,

Drive A also serves as Drive B) and follow the instructions on the screen.

If you prefer to use the DOS DISKCOPY function, instead of COPY, you will type DISKCOPY

A: A: and follow instructions on the screen. This alternative is faster, but requires access to

DISKCOPY .COM, in your DOS files.

l If your PC has two diskette drives (Drive A and Drive B), type COPY * . *

B : (the same as

above) and follow the instructions on the screen.

If you prefer to use the DOS DISKCOPY function, instead of COPY, you will type DISKCOPY

A: B : and follow instructions on the screen. This alternative is faster, but requires access to

DISKCOPY .COM, in your DOS files.

To Copy Distribution Software To The PC Hard Drive

Before copying Distribution Software to a hard drive, make a directory on the hard drive to contain
the files. While the directory name is your choice, the following instructions use PCFM3 .

1. After making a directory named PCFM3 , place your Distribution Software diskette in your PC’s
A Drive and log to that drive by typing A: .

2. Then, type COPY
needed) to the PCFMS directory.

* . * pafh\PCFMS , where path is the drive designation and DOS path (if

When you finish copying your Distribution Software, store it in a safe place (away from heat,
humidty, and dust) for possible future use as a backup.

1.4 GENERATING AN APPLICATION PROGRAM

In the Distribution Software, the example program for the language you are using provides most of

the information you need to start your own MSTEP-3-based Application Program. The overall
procedure for a typical executable program, however, is as follows:

1. Write your Application Code using a text editor or the language environment.

2. Compile your program.

3. Link the compiled program to a Driver (from the Distribution Software) suited to the language of
your Application Code.

This procedure gives you an executable Application Program, ready to test. Repeat all three steps as
you modify/fix this program.

1-2

CHAPTER 1: INTRODUCTION

1.5 THIS MANUAL

Chapter 1 of this manual is introductory material.

Chapter 2 presents information on the MSTEP-3 Drivers required for the supported languages. Since
the Drivers support the full series of MSTEP-3 Mode Calls, Chapter 2 also lists and briefly describes
the Mode Calls. And since the Drivers may not be perfectly suited to your particular applications,
Chapter 2 discusses the Driver Source Modules, which are the source-code files you may use for
creating new Drivers. Finally, the chapter includes instructions for creating new Drivers.

Chapter 3 presents brief instructions and examples for using the Drivers with your Application
Programs.

1-3

PCF-M3 USER GUIDE

l-4