1BSVC "A Microprocessor Simulation Framework"
2============================================
3
4I've tested BSVC under the following operating systems:
5
6    Linux  2.x
7    Solaris (SunOS 5.5.1)
8
9The makefiles for these system should work.  I'm sure there are still
10bugs in BSVC so if you find any please let me know.
11
12Installation
13------------
14
151. Edit the appropriate operating system-specific Makefile in the src/
16   directory:
17
18   - Change PREFIX to where you want BSVC installed.
19
20   - Change WISH to the path/filename of the Tcl/Tk "wish"
21     executable.  If you don't know where wish is then try
22     `which wish` and see if it's in your path anywhere.
23
24   - You can also customize compilers and other tools used
25     during the build.
26
272. Build the BSVC executables:
28
29   - Using the correct makefile for your system, run GNU Make:
30
31         `make -f Makefile.your_os`     (e.g for Linux use Makefile.linux)
32
33     or
34
35         `gmake -f Makefile.your_os`    (if GNU make is called `gmake`)
36
37   - If there is no makefile for your system then you'll have to make
38     one yourself.  If you do then please send it to me so I can include
39     it in the distribution.
40
413. Install the BSVC executable:
42
43   - To install the BSVC executables do:
44
45         `make -f Makefile.your_os install`
46
47
48Testing the installation
49------------------------
50
51After you have built the programs there are some sample setups and programs
52for the Motorola 68000 simulator in the bsvc/samples/m68000 directory.
53
54Run 'bsvc' from the $BINDIR directory to start the user interface.
55Then choose "File / Open Setup..." and select the "serial.setup" in the
56bsvc/samples/m68000 directory.  After the system starts up choose
57"File / Load Program..." and load the "tutor.h68" program.  Press "Reset"
58and then press "Run" in about 10 seconds you should see "TUTOR >" in the
59terminal window that appeared.
60
61I would suggest adding the $BINDIR directory to your PATH if you're going
62to be using it very often.
63
64There's a postscript version of the user manual in the bsvc/doc/manual
65directory.
66
67If you have any questions or comments send email to the mailing list:
68
69  bsvc-users@googlegroups.com
70
71If you'd like announcements about new versions, etc, subscribe to the
72announcements list:
73
74  bsvc-announce@googlegroups.com
75