Orange Micro Interface The Grappler User Manual

INTRODUCTION

TM

The Grappler Interface is a Centronics compatible parallel
interface for the Apple II/II+ Computer. In addition to advanced
text features, it offers high resolution dot graphics (HIRES) dump
routines located in firmware. These are easily invoked using
simple control commands.

There is no standardization among printer manufacturers for
dot graphics. Therefore a specific version of the Grappler
interface was developed for each type of printer. If you connect
a printer to an incorrect version of the Grappler, the text
features should still function properly. However, the graphics
commands will have unpredictable results.

INSTALLATION INSTRUCTIONS

To install the Grappler simply plug it into any slot inside
the Apple (except

Ø), as follows:

1. Turn of

damage to the computer and the Grappler.

2. Connect the Grappler cable to the set of pins on the Grappler

interface card. Make sure that all the pins on the card go

into the cable~s matching holes. Also, the cable should

point away from the card (it will only fit one way).

3. Remove the cover from the Apple. This is done by pulling up

on the cover at the rear edge (the edge farthest from the

keyboard) just until the two corner fasteners pop apart.

Don't lift the edge any further, but instead slide the cover

backward until it comes free.

4. Inside the Apple along the rear edge of the circuit board,

there is a series of eight long, narrow sockets called “slots”.

The leftmost slot (looking at the computer from the keyboard

end) is slot #9~. The adjacent slot is slot #1 and this is

where most Apple programs expect the Grappler to be.

f the power to the Apple . This is important to prevent

—1—

5. Be sure the power is off. Insert the Grappler card into

slot #1 (or any other slot except zero) with a gentle rocking
motion until fully seated.

6. Pass the cable through one of the vertical openings in the

back of the Apple case.

7. Replace the Apple’s cover. Slide the front edge of the cover

into place, and then press down on the rear corners until
they pop into place.

8. Connect the Grappler cable to the printer.

TEXT FEATURES

Before sending a character to the printer, the Grappler will
check the SELECT and PAPER EMPTY Status lines. If the printer is
not “online’, or is out of paper, a warning will be printed on
the screen and the Apple will beep. If this occurs check the
following:

1. The cable is firmly and properly attached to the printer.

2. The cable is firmly seated on the Grappler interface card.

3. The printer is on.

4. The printer is on-line.

5. There is paper in the printer. Note: The Grappler will
not check for paper on Epson printers.

6. The printer is set up for parallel operation. (Check
Appendix B of this manual for proper dip switch settings.)

Once the error condition has been corrected you may continue by
pressing the return key.

The Grappler interface has many text features, including
adjustable margins, line length, page length, etc. All commands
affecting these features are listed on the following pages with
a description of their function. Each one is preceded by a
control character which is CTRL—I from BASIC or CTRL-Y from
Pascal or CP/M, unless specifically changed by the user's
program.

—2-

To type a control character, hold down the control key
(marked “CTRL’ on the Apple) and then press the appropriate
letter. Then release the letter key, and then the control key.
Control characters do not appear on the screen as they are
typed. You may also use the CHR$ function found in Applesoft
Basic (consult your Apple manual and Appendix A).

TEXT COMMANDS

Spaces have only been used to make the commands easier to
read: do not type the spaces when issuing the command.

PR#n Turns on the Grappler interface card. n is equal to

the slot number of the Grappler. All subsequent
characters appearing on the Apple video screen will
also be printed on the printer. This command must be
used before any of the following commands will be
accepted by the Grappler.

PR#Ø Turns off the Grappler.

CTRL-I A Append line feeds onto carriage returns. Basic will

not send a linefeed after a carriage return. This
means the printhead will return to the left margin but
will not advance the paper. The Grappler will auto­matically issue a linefeed command and advance the
paper after every carriage return. If your printer is
performing double line spacing, check Appendix B of
this manual.

CTRL-I K Don’t append linefeeds onto carriage returns.

CTRL-I H Allows the high order (8th) bit to be output to the

printer. On many printers this has no effect. On
some it allows printing of block graphics (Epson MX/8Ø).
However, when block graphics are being printed, the
standard character set is not accessible.

—3—

CTRL-I X Don’t output the high order bit to the printer. This

puts the printer back in standard text mode.

CTRL-InN Set line length to n characters from left side of page

(not from left margin). After issuing this command,
characters will only be printed on the printer, and
not on the Apple video screen. A carriage return will
automatically be generated after n characters have
been printed. If the line length is set to zero, the
Grappler will not issue a carriage return until it
receives one from the Apple. Note: When listing basic
programs, the printing will automatically be formatted
for 4Ø columns unless this command is used (i.e.
CTRL-I 8Ø N).

CTRL-II Transmits characters to both the Apple screen and

printer. When the line length is set with a CTRL-InN
command the screen will be turned off and printed
characters will go only to the printer. If you wish
characters to appear on the. screen while they are
being printed, use this command.

CTRL-InL Set left margin to nth column. All subsequent printing

will have n spaces at the start of each line. For
example, when using CTRL—I lØL, all printing will start
in the 1Øth column.

CTRL-InR Set right margin to nth column from left edge of page

(not left margin). This command will prevent words
from being split at the right margin. The Grappler
will end the line at the first space that occurs after
the right margin, but before the end of the line as set
by the CTRL-InN command. A right margin of zero
disables this feature.

CTRL-InP Set page length to n. The printer will print six line—

feeds after n number of lines have been printed. A page
length of zero disables the page length feature. Con­tinuous form paper typically has a total of 66 possible

—4—

lines per page (this may vary with the type of
printer). Therefore if you specify a printed
page length of 6Ø lines (CTRL—I 6ØP), your
printer will print 6Ø lines and automatically
skip over the perforation with 6 line feeds.

CTRL—I B Turn on bell. This allows a CTRL—G to ring the

printer bell. Many printers do not have a bell
so check your printer manual to see if this
feature is available.

CTRL-I C Turn off bell.

CTRL—I S Duplicate the present text screen on-the printer.

The screen will be printed 20 spaces from the left
edge of the paper. This command is accessible from
BASIC only as it uses some of the monitor
routines, Only the forty character screen is
printed. Eighty character boards are not
supported.

CTRL—I CTPL-Y Change to new command character CTRL—Y. To do this,

type in CTRL-I CTRL-Y. Any control character may be
used here (instead of CTRL—Y) but you should avoid
characters used by your printer or normal text con­trol characters such as CTRL—M (carriage return).

CTRL-Y CTRL-I changes back to command character CTRL—I.

The values and conditions listed below are the values which
are automatically set any time the Grappler is “turned on” with
a PR#n command or initialized from Pascal or CP/M:

Left Margin = Ø Right Margin = Ø
Line Length = Ø Page Length= Ø
Video = On Printer Bell = Off
Eighth Bit = Off Line feed after

carriage return? = Yes with Basic

No with Pascal or CP/M

—5—