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