
The files included here are the same as in the file "icc11fre.zip" available
from ImageCraft as a freeware compiler. See the other "readme" files for
their copyright information. The files added are indicated inside that they
are from me. Some modifications were made to the "crt.s" (runtime) file
so that is would work with the U-HC11 board properly, and so that the code
could be used from ROM or RAM.

To get started without studying for a week, have your U-HC11 board ready
and working, with a RAM chip installed in the Expansion Board. Then
copy "example1.c" to "work.c", we now have our "work" file ready to
compile into a program. You can look at the "work.c" file with a editor,
and modify it to your liking after we run some simple tests.

"example1.c" simply prints "Hello" out the serial port and prints the
value found in memory location 6000 (hex). You can use the monitor to
modify the location and then run this program. The program starts at
4000 (hex) and you need to set the "Offset" to 0000 using the monitor.

If you type "go" at the DOS Prompt, a batch file called "go.bat" calls
the "icc" compiler, and creates a ".s19" file as output, you can look
at the "work.lst" file to see what the "asm" file looks like if you want.

Press "R" on the monitor, to start the U-HC11 download, and send the
"work.s19" to the U-HC11 RAM.

At the monitor prompt, press "L4000" and then press any key 
to stop printout, you should see the code that was transfered to the RAM.

At the monitor prompt, press "G4000" to run your program in RAM, it
should print "Hello x = [whatever]" and return to the monitor.

You have now compiled and run a program in RAM !


See the other examples and stuff for more fun.


If you want to make a ROM version of your program, you will need to
modify the "crt.s" file as it states inside and #include the "zend.h"
file at the end of your "work.c" file.



 Notes on "Small C" files:

Some of the files that are supplied were written in "Small C", a
freeware compiler from motorola and modified by many others.

It was limited, and different than this version of "icc11", so if
you wish to use those files, you may need to make some changes.

See the "icc11" docs for more info.

If the #asm is used in "Small C", you need to put each LINE of asm
code in a asm("LDX #$25"); format for "icc11".

If a "global" is used (RAM memory from 0 to FF hex) in "Small C",
see "example1.c" for how to do it in "icc11".

Some things may take a bit of thinking, but it all makes sense in the end.

 MAC PEOPLE: Don't try using this with a DOS simulator, switching back
 and forth is a complete waste of time, besides the fact that the files
 need to have LINE FEEDS in them!
