
BSVC "A Microprocessor Simulation Framework"
============================================

I've tested BSVC under the following operating systems (the makefiles
for these systems should work):

    Linux  1.x.x
    Ultrix 4.3
    HP-UX  9.0
    SunOS
    Solaris

I'm sure there are bugs in the program, so if you find them let me know.


BSVC Requirements
-----------------

You will need:

   - Tcl/Tk (with the 'addinput' extension) See comp.lang.tcl for info on Tcl
     or get the new Tcl and the Tk Toolkit book by John K. Ousterhout.
     (Most prebuilt versions of Tcl/Tk on Linux have this extension installed).

   - GNU gcc and libg++


Installation
------------
1) Edit the Makefile.common in the bsvc/src directory

     - Change PROJECT_BASE to where you have untarred the BSVC
       package

     - Change INSTALL_DIR to where you want the BSVC executables
       installed. (I usually install them in bsvc/bin)

     - Change WISH to the path/filename of the Tcl/Tk "wish"
       executable

     - Change the WWW_BROWSER 

2) Build the BSVC executables:

     - Choose the correct Makefile.your_os for your system and execute:

         make -f Makefile.your_os     (e.g for Linux use Makefile.linux)

     - If there is no Makefile.your_os then you'll have to make one
       yourself (sorry!).

3) Install the BSVC executable:

     - To install the BSVC executables do:

         make -f Makefile.your_os install


After you've built the programs there are some sample setups and programs for 
the Motorola 68000 simulator in the bsvc/samples/Motorola68000 directory.

Just cd to the bsvc/bin directory and type 'bsvc' to start the user interface.
Then choose "Load setup" and select the TutorTelnet.setup in the 
bsvc/samples/Motorola68000 directory.  After the system starts up choose 
"Load program" and load in the tutor.h68 program.  Select "Reset" and press 
"Run" in about 10 seconds you should see "TUTOR >" in the xterm that pops up.

I would suggest adding the bsvc/bin directory to your PATH if you're going
to be using it very often.

There's a postscript version of the User Manual in the bsvc/doc/manual
directory.

If you have any questions or comments send me mail at:

  bwmott@eos.ncsu.edu

If you have questions about the Hector 1600 microprocessor you can contact
Dr. Tom Miller at:  

  tkm@eos.ncsu.edu


LICENSE
-------

   See the License file for information.  


