Information on Using icc11 with the Mini Board
	    ----------------------------------------------

		 Fred G. Martin (fredm@media.mit.edu)
		last updated: Fri Jul  8 22:09:13 1994


icc11, a new 6811 C-language cross compiler, has recently become
available.  Developed by Richard Man of ImageCraft (P.O. Box 64225,
Sunnyvale, CA 94086; E-mail: imagecft@netcom.com), the icc11 compiler
runs on MS-DOS systems.  Version 0.48 of icc11 is free software; the
general release is now commercially available.  Contact ImageCraft for
details.

The compiler is available from the Mini Board FTP site
(cherupakha.media.mit.edu) in directory pub/miniboard/icc11.  Also
available is a version of the Mini Board libraries customized to work
with icc11, named "minilib.s."

This document explains how to install and use the minilib.s library
with the icc11 compiler.


Installing minilib.s -----------------------------------

The Mini Board library file is in pub/miniboard/icc11/minilib.s on the
FTP server.  To install, you replace icc11's default run-time library
file (crt.s) with minilib.s; i.e., you rename minilib.s to be crt.s.
You may wish to keep a copy of the original crt.s around in the
interest of future use.

Replacing ias11.exe ------------------------------------

As of this writing, the ias11.exe (ImageCraft's 6811 assembler)
included in the v0.48 icc11 distribution exhibits phasing errors when
user C programs have global variables and the minilib.s library is
installed.  As a workaround, I suggest using an older version of
ias11, which I have placed in the icc11 distribution directory.
Remove or rename the ias11.exe included in the distribution and
install the ias11.exe located in the icc11 directory.

Using the compiler -------------------------------------

The icc11 compiler is easy to use.  To compile a C file, you say
"icc11 myfile.c" at the MS-DOS command line, and it compiles your file
and links it with the run-time library file.  The resulting output
file is named "iccout.s19"; download it with the command "dlm iccout".

Functions available ------------------------------------

The following Mini Board functions described in the Mini Board Technical
Reference are available with the icc11 minilib.s file:  analog(),
digital(), motor(), off(), button(), msleep(), tone(), printdec(), and
getchar().  In addition, the functions putchar(), peek(), peekword(),
poke(), and pokeword() are available.  The "time" counter variable may
be accessed.  For documentation on using these functions, please see
the comment block at the start of the minilib.s file.  The functions
should work just as described in the Mini Board Technical Reference.

I encourage any Mini Board user who (a) has a PC or SoftPC setup and
(b) hasn't bought Dunfield's Micro-C to download icc11 and start
playing with it.  It's a big win.

	-Fred