Using ICC11 for Windows with Adapt-11 Products
==============================================
(5 November 1998)


The LINKER is the part of a compiler package that marries the software with the
particular hardware configuration being used.  Therefore, you need to setup the
LINKER before using ICC11.  Find the Linker setup tab by pulling down the
OPTIONS menu to COMPILER.  In the Linker, "text" refers to code, and should be
the starting address of EEPROM (or wherever you plan to put the code);  "data"
is for variables, and should be the start of RAM;  "stack" should be the end of
RAM, since it builds "downward".  There are some exceptions:  if you have a
large amount of RAM, you would probably start the "data" section following the
last address of on-chip registers, and put the stack at the top of internal
RAM.

If you have ICC11 V4.5 or higher, you can use the SetupWizard feature of the
Options|Compiler|Linker pulldown menu.  For Adapt11, select "Generic 6811E2
single-chip mode".  For Adapt11C75DX, select Generic 8K Upper ROM, 32K lower
RAM".  If you have Adapt-11C75, change the Stack value to 0x1ff and the data
section to 0x0000.  You can give this last configuration a name, and click on
the NEW button to add it to the list.

Every C program that you write requires the file vectors.c to be included
(either explicitly at the end of the program, or as the last file in the
Project file, if you are using the ProjectBuilder feature of ICC11).  You
should examine and compile the program "hello.c", in the Examples directory of
ICC11.  This program has the essentials set up for you.  The only time you
would not need vectors.c is if you had a resident monitor that was controlling
the loading and execution of a user program (such as the Buffalo monitor from
Motorola).

To compile and download your file, select "Compile to Executable" in the
pulldown menu.  ICC11 will compile, assemble, and link, creating an s-record
file called hello.s19.  This is the file you will download to your board.

Make sure Bootstrap Download Mode is checked in the TERMINAL pulldown menu.
Then activate the terminal window, and click on Bootstrap Options.

Select the appropriate Bootloader Programming setting for your hardware
configuration: Internal EEPROM for Adapt11, External EEPROM for all others
Adapt11 configurations.

BULK ERASE applies only to internal EEPROM in Adapt11, and, if selected, will
speed up the downloading process.

HW Echo Mode should be set to Normal.

Leave the Config Reg. setting at 0 (ie. "don't change") unless you want the
bootloader to change the value of the Config. register.  (Remember, the new
setting only takes effect following a Reset of the HC11).

After exiting Bootstrap Options, click on Bootstrap Download, and select
the s-record file you wish to download.  Press your board's Reset button and,
where applicable, slide the Write Protect switch to WRITE.  Then click OK.

===========================================================================