Radio Shack TRS-80 User manual

TRS-80
DIGITIZER
Catalog No. 26-1195
CUSTOM MANUFACTURED IN USA FOR RADIO SHACK, ADIVISION OF TANDY CORPORATION

SERVICE POLICY
Radio Shack's nationwide network ofservice facilities provides quick, conve-
nient, ana rel'able repair services for all of its computer products, in most
instances. Warranty servce will be performed in accordance with Radio
Shack sLimited Warranty Non-warranty service will be provided at reasonable
parts and labor costs.
Because of the sensitivity of computer eauipment, and the problems which can
result from improper servicing, the following limitations also apply to the
services offered by Raaio Shack
1if any of the warranty seals on any Radio Shack computer products are
broken. Radio Shack reserves the right to refuse to service the equipment or
to void any remaining warranty on the equipment
2If any Radio Shack computer equipment has been modified so that it is not
within manufacturer's specifications, including, but not limited to. the in-
stallation of any non-Raa'O Shack parts, components, or replacement
boards, then RaO'O S^ack reserves the right to refuse to service the equip-
ment, void any remaining warranty, remove ana replace any non-Radio
Shack part found in the ea Jipment. and perform whatever modifications are
necessary to return the equipment to original factory manufacturer's speci-
fications
3The cost for the laborana parts requirea to return the Raaio Shack com-
puter equipment to or:gina; manufacturer's specifications will be charged to
the customer in addition to the normal repair charge

TRS-80 Digitizer ,Owner's Manual
TRS-80 °
TRS-80
Digitizer
Owner's Manual
Catalog Number 26-1195
Radio /hack
_i

TRS-80 Digitizer »»*» «-,« ®Owner's Manual
TRS-80
TRS-80 Digitizer Owner's Manual: Copyright 1982 Tandy
Corporation, Fort Worth, Texas 76102 U.S.A. All Rights
Reserved
.
Reproduction or use, without express written permission
from Tandy Corporation, of any portion of this manual is
prohibited. While reasonable efforts have been taken in
the preparation of this manual to assure its accuracy,
Tandy Corporation assumes no liability resulting from any
errors or omissions in this manual, or from the use of the
information obtained herein.
Radio /hack
-2-

TRS-80 Digitizer MOwner's Manual
Contents
Introduction 5
1/Description of the Digitizer 7
2/Setting Up the Digitizer 11
3/Using the Digitizer 17
4/Sample Session 19
5/Troubleshooting and Maintenance 21
6/Specif ications 23
Appendix A/ Sample Programs and Driver Routines .... 25
Model I, Level II Cassette Interface 25
Model I/III RS-232 28
Model II 31
Color Computer Driver 34
Appendix B/ Skew Adjustment Routine 37
Appendix C/ Technical and Programming Information .. 39
Radio /hack
3-

TRS-80 Digitizer ori sOwner's tManaal
Radio /hack
4-

TRS-80 Digitizer .Owner's Manual
TRS-SO &
Introduction
Congratulations for selecting this Radio Shack TRS-80
Digitizer
.
You'll find it to be an easy-to-use, high-quality electronic
measuring device that can be used with the following Radio
Shack computers:
Model I, Level IK16K)
Model II
Model III
Color Computer
What exactly is aDigitizer? Basically, it's adevice that
describes aspecific point on asheet of paper in terms of
its X-Y (Cartesian) coordinates. For example, if you didn't
have aDigitizer and you wanted to describe the location of
aparticular point on an 81/2" X11" sheet of: paper, you
would need to measure how far from the left edge that point
is ,then how far from the top edge it is
.
ADigitizer does this for you. It tells you how far
horizontally (the X-axis) and how far vertically (the
Y-axis) that point is from the edge of the paper.
Note that the Digitizer does not do this totally
"automatically", however. The action of the Digitizer
depends upon the program you're running in the Computer. In
this manual, we've included asample program for use on
different models of TRS-80 1s. The sample program includes an
initialization routine which you will need to include in
programs you write. See Appendix Afor details.
We've also included a"skew adjustment" routine (see
Appendix B) if you ever need to oosition your paper to
true Cartesian coordinates.
Appendix Ccontains some additional information which you
might find valuable when writing your own programs.
Specific uses of the Digitizer include the:
Creation of bar graphs and charts.
Radio /hack
-5-

TRS-80 Digitizer —__-_ffi Owner's Manual
TRS-80
Measurement of coordinates.
Reading of maps.
Computation of areas.
Measurement of lengths.
Calculation of volumes.
Curving of averages.
Scaling (up or down) of measurements
And much more!
Radio /hack
-6

TRS-80 Digitizer ,Owner's Manual
TRS-80 s
1/ Description of the Digitizer
When referring to the position of the Digitizer, we're
assuming the Digitizer is facing you. That is, the back
"connection" panel of the Digitizer is away from you--on the
back side of the Digitizer.
When you move the Digitizer towards you, we'll call this
"moving to the front." When you move it away from you,
we'll refer to this as "moving to the back." Whenever you
move it to the front or back, you're moving it along the
"Y-axis."
When you move the Digitizer to the left or right (again
assuming the Digitizer is facing you), this is movement on
the "X-axis."
(1) TRAVERSE ARM. Moves left and right (X-axis) and front
and back (Y-axis). (Note the Traverse Arm Stop at the
end of the Arm away from the Cursor.)
(2) CURSOR. This allows you to identify aspecific
point. Simply place the circle in the center of the
Cursor on the point you wish to define.
(3) SEND SWITCH. When you've defined the point you wish
to describe, press the Send Switch down. To
continuously send location signals to the Computer as
you move the Cursor, hold the Switch down until two
location signals are sent, then release. The
Digitizer will continue sending location signals
until you press the Send Switch again.
(4) CARRIAGE. The Carriage moves back and forth and
carries the Traverse Arm. (See Figure 5.)
(5) BODY. This section contains the electronic
components which identify the positions of the
Cursor; it then sends those positions to the
Computer
.
(6) COVER. You will need to remove the Cover when you
mount the Traverse Arm onto the Carriage.
Radio /hack
7-

TRS-80 Digitizer TRS-80 Owner' sManual
U*-"®
Figure 1. Digitizer (Front View)
Radio /hack
-8-

TRS-80 Digitizer _Owner's Manual
TRS-80 *
(1
)
POWER CORO CONNECTOR (J2 ) . Connect the round
connector from the POWER PACK into this Connector.
(2) DATA AUDIO/RS-232 (J4). If you're connecting the
Digitizer via the Tape jack of your Model I. Level
II Computer or if you're using aTRS-80 Color
Computer, use this (4-pin) connector.
(3) CASS/NORM. The setting of this Switch depends
upon how (through which port) the Digitizer is
connected to the Computer. For Computers equipped
with RS-232-C, set to NORM. For Color Computers or
Model ILevel II cassette interface, set to CASS.
(4) RS-232 OUTPUT (Jl ) . Connect the Digitizer to your
Computer via this DB-25 (25-pin) connector when
using Model ILevel II, Model II, or Model III
RS-232-C.
(5) RESET. Press this Switch to reset X-Y values to
zero.
(6) POWER PACK. Plug the POWER PACK into an AC wall
outlet; plug the round connector into the Power
Connector (J2 )on the back panel of the
Digitizer. (See Figure 2.)
Radio /hack
-9-

TRS-80 Digitizer TRS-BO Owner 'sManual
©©©
Figure 2. Digitizer (Rear View)
Radio /hack
-10 -

TRS-80 Digitizer TRS-SO Owner 'sManual
2/ Setting Up the Digitizer
When you're ready to set up the Digitizer for use, follow
these steps:
1. Before setting up the Digitizer, be sure the Power Pack
is not plugged in.
2. Carefully remove the Cover of the Digitizer by gently
pushing up on both ends (see Figure 1).
3. Remove the plastic foam from the inside of the
Digitizer. The Carriage should then move freely to
the left and right. (See Figure 3.)
Figure 3. Unpacking the Digitizer
Gently reverse the position of the Cursor (on the end
of the Traverse Arm) by turning it around so that it is
not under the Traverse Arm. (See Figure 4.) Note that
the "bottom" of the Traverse Arm has adelicate grid
(with black stripes). The "top" of the Arm is bare
metal
.
Radio /hack
-ii -

TRS-80 Digitizer TRS-SO Owner' sManual
Caution: The silver and black grid on the Traverse Arm and
inside the Digitizer are part of the measuring system. Be
careful not to scratch these grids.
Figure 4. Cursor
With your left hand, hold the Carriage in place while
holding the Traverse Arm in your right hand with the
Cursor towards you
.
Place the groove on the left side of the Traverse Arm
against Pulley #1 so that the Arm Stop (on the end of
the Arm, on the left side) is just behind Pulley #1.
(See Figure 5.
)
Gently push the Traverse Arm along Pulley #1 until
Pulley #2 is encountered. Then place Pulley #2 into
the groove on the right side of the Arm so that it
moves smoothly. (See Figure 5.)
Radio /haek
-12 -

TRS-80 Digitizer TRS-BO Owner 'sManual
PuUey #2
Figure 5. Inserting the Traverse Arm
Move the Arm backwards until the Arm Stop meets Pulley
#3. Gently move the end of the Traverse Arm that is in
the pulleys to the right to allow the Arm Stop to get
past Pulley #3. (See Figure 6.)
Pullev #3
Figure 6
Once the Arm Stop has passed Pulley #3, straighten the
Arm and push it backwards along the pulley. Be sure
that Pulley #3 is in groove on the left side of the
Arm. (Figure 7.
)
Radio /hack
-13 -

TRS-80 Digitizer TRS-8Q Owner 'sManual
Figure 7
10 Replace the Cover.
Connecting the Digitizer to Your Computer
You have several options when connecting your TRS-80 to the
Digitizer
:
If you're using aModel ILevel II (with RS-232-C),
Model II, or Model III, you can connect the Computer to
the Digitizer via the Computer's R3-232-C Jack, using
the Digitizer's Jl port.
If you're using aModel ILevel II without RS-232-C or
aColor Computer, connect the Computer to the
Digitizer's J4 port.
If your Model Idoesn't have RS-232-C interface (or
even if it does), you can connect the Digitizer through
Tape port on the back of the Keyboard.
Note: The Model III cassette circuitry cannot be used
for serial communications with the Digitizer.
If aModel Iis connected to the Digitizer through the
Computer's RS-232-C Jack (via J4 on the Digitizer), program
changes are required before you can connect the components
via the Digitizer Jl port and Computer Tape Jack. This is
because of differences in the signals sent through the
Radio /hack
-14 -

TRS-80 Digitizer __ .Owner's Manual
TRS-SO '
Computer's RS-232 and Cassette ports. In other words, a
program that is running when connection is via the cassette
port will not run when connection is via the RS-232 port
(and vice versa)
.
Before connecting the Digitizer to your Computer, see your
Computer's operation manual for correct connection of
peripherals, locations of the RS-232-C jacks, and proper
power-up procedures.
Radio /hack
-15 -

TRS-80 Digitizer -m^ om *Owner' sManual
Radio /hack
16 -

TRS-80 Digitizer _Owner's Manual
TRS-80 8
3/ Using the Digitizer
Once the paper has been positioned and the Digitizer
properly connected and powered-up, you'll find the Digitizer
extremely simple to use.
Positioning the Paper
Before you begin using the Digitizer, we suggest you tape
the paper you're working on (i.e.. the document which
contains information you want to digitize) down on aflat,
level working surface, such as atable.
The Digitizer can then be positioned on any side of the
paper. However, the Computer must be told where the
Digitizer is so that the coordinates come out the way you
expect
.
For instance, if the Digitizer is facing you (the way we've
described it throughout this manual), the X-coordinate is
specified by moving the Carriage to the left or right and
the Y-coordinate is specified by moving the Traverse Arm
forward and backward.
On the other hand, if you position the Digitizer on the
right side of the paper, the X-coordinate is then specified
by moving the Traverse Arm to the left or right and the
Y-coordinate is specified by moving the Carriage forward and
backward
.
To compensate for differences such as these, the Computer
must be "told" which is the X-axis and which is the Y-axis.
An Skew Adjustment Routine (sometimes referred to as "axis
rotation") allows you to define the X-Y axis on any
particular document. For details on Skew Adjustment, see
Appendix B.
Once you've positioned the paper and Digitizer, do not move
them or the values the Digitizer returns will be inaccurate
in respect to the original origin.
When you are ready to use the Digitizer, be sure there's
enough room around the Digitizer for movement of the
Traverse Arm.
Radio /haek
17 -

TRS-80 Digitizer -roc; ori sOwner' sManual
——^————^———TR5"OU "™~~"
-
—^-—
~
SEND Switch
When you've positioned the Cursor and are ready to read
information about aspecific point on the document to the
Computer, gently cress down on the Send Switch. If you're
measuring aline and need continuous measurements, hold down
on the Switch until two points have been sent to the
Computer, then release. The Digitizer will continue sending
the location of the Cursor until you press the Send Switch
agai n
.
Note that there is adelay between the first point and the
second point transmitted. This prevents sending two points
to the Computer when you press the Send Switch momentarily.
RESET Switch
Whenever you press the RESET Switch (located on the back
panel of the Digitizer), you will reset the values of the
X-Y coordinates to zero.
This means that the origin (the point where Xand Yare made
zero) can be relocated anywhere in the working area simply
by moving the Cursor over apoint and pressing Reset.
Radio /hack
-18 -