CATkit initial setup instructions
---------------------------------

unpack the brood archive, and type this in it's top dir

   make bootstrap         # if you checked out from darcs you need this
   make                   # build the compiler

start the purrr console:

   bin/purrr

at the OK prompt, you select the CATkit project:

   prj CATkit

and (re-) initialize the project

   scrap

at this point, burn the file prj/CATkit/monitor.hex which contains the
boot loader to the PIC chip if it doesn't already have one. see if you
can connect by:

   ping

to make sure the chip is empty at this point, do:

   mark empty


CATkit start
------------

The chip and the file prj/CATkit/current.state will remember where you
left off last time you quit the console, so the above steps are not
necessary after initial setup. Just run bin/purrr and type

   prj CATkit

to continue where you were last time.


Loading the synth code
----------------------

To upload the synth code, do:

   ul sheepsint.f
   install

at this point, the synth can be started by typing:

   start main

which will start the mainloop of the synth application. At this point
communication with the synth is broken, and it runs stand-alone.


Loading your own code
---------------------

Code chunks are loaded incrementally, and are separated by
'marks'. The command 'ul' will replace the last chunk. To load your
own file on top of the synth code, first set a mark after doing 'ul
sheepsint.f'

   mark

then upload your code:

   ul your-code.f

every time you change something, type 'ul your-code.f' again. and type
'empty' to remove it entirely. 'empty' works as backspace.