Here is the IBM PC distribution, dated Jan 13, 1991.

In order to use, copy the contents of this directory to your IBM
machine.

You'll also need the contents of the /mit/6.270/lib/as11 and
/mit/6.270/lib/ic directories.  Make the directories \lib\as11 and
\lib\ic on your PC to hold the files in these directories.  See below
for the list of necessary files.

(You can use dosread and doswrite to write to IBM floppy disks: 1.44mb
3.5" from VAXstation 3100s, 1.2mb 5.25" from some VAXstation 2000s and
IBM RTs.  Format the disk before you get to athena.  Consult athena
documentation for more info.)

If you need to put the library files somewhere else, or are not happy
with the default of "com1" for interacting with your board, try "ic
-config" -- it will let you change the defaults (and modify your
executable).

Also, you'll have to make a cable especially for your PC.  Look at
your instructions for the VAX 2000 DB9 cable, and modify as follows:
  PC DB9 connector:  Swap pins 2 and 3, move pin 7 to pin 5.
  PC DB25 connector: Pins 2, 3, and 7 are all correctly numbered, but
                     of course you have to hook them up to a DB25 instead
                     of a DB9.

You can also look at the file /mit/6.270/lib/ic/info/cables.doc for
how to make a cable adapter.

CAVEATS:

The IBM version of IC runs out of memory quite easily.  You may find
yourself restarting IC now and again (although you'll most likely be
doing this anyway so you can edit files).  If your project gets to be
large enough, you may not be able to load it at all.  Useful hint: run
ic with the files you're using on the command line, so they get loaded
at the beginning.  This will save on memory, as well as the startup
time.

It is possible to run IC under Windows 3.0, and run Freemacs, an
emacs-like editor, both at the same time.  It is recommended that you
have a 80386SX or higher processer.  You need to modify the .PIF
files, allowing 640KB wanted, 640KB necessary for IC and for Freemacs.
Windows can then swap the tasks by pressing Alt-TAB.  WARNING:  IC
will run out of memory, causing the application to crash.  It may be
necessary to kill a process using the Program Manager, or it may kill
itself.  Save your Freemacs files often.  You can restart IC again.
This is not necessarily recommended, and cannot be supported by the
6.270 organizers, but if you wish to play around with it, you can.
Freemacs is not available on Athena, but the organizers can find it
for you.  See Matt (luigi@athena.mit.edu) if you have questions
concerning IC and Windows.

The library files (/mit/6.270/lib/ic and /mit/6.270/lib/as11) change
often.  If it looks like a new feature isn't working, check that you
have the latest copies of these files before you report a bug.

Also, the IBM version is not officially supported.  It is provided in
the hopes that it will be useful, but when bugs are found in IC, the
highest priority will be to fix the Athena version.


Good luck!

Randy Sargent
rsargent@athena

These are the files necessary to have copied to your PC to run IC:
/mit/6.270/pc_distribution: *.*
/mit/6.270/lib/ic:
   lib_r21.lis
   lib_r21.c
   servo.icb
   servo.c
   r21_ir.lis
   r21expbd.icb
   r21_ir.icb
   r21_ir.c
   pcoder21.s19

You may also want the following files if you are using shaft encoders:
/mit/6.270/lib/ic:
   fencdr??.icb
   sencdr??.icb

If you are doing assembly programming, and are using AS11, you will
need several files from the /mit/6.270/lib/as11 directory:
   6811regs.asm
   ldxibase.asm
   ldxtest.asm
   pcode_eq.asm
   r21_beep.sm
   r21_eq.asm

This list is subject to update as new libraries are added.
Last updated:  1-22-91
