CPU SIM 3.9.X
July 2013


INSTALLATION INSTRUCTIONS

1.  Download the CPUSim3.9.X.zip file onto your hard disk.

2.  Unzip the CPUSim3.9.X.zip file. The unzipping process
will create a folder called "CPUSim3.9.X" containing 10
documents and a folder with 3 more documents.

3.  Install Java 1.5 or later on your
machine if it is not already there.  Go to the web site
    http://java.sun.com/
to get the software and to read installation instructions.
MacOS X users will find Java comes installed
with the OS.

4.  Fix, if necessary, your PATH system variable so that
it includes the directory (installed as part of the
Java installation) in which the java interpreter
application is located.  MacOS X users can skip this step.


STARTING CPU SIM

1.  On a Macintosh computer, just double-click on the "CPUSim3.9.0.app"
    file for the English language version or "CPUSim3.9.0.Chinese.app"
    for the Chinese language version.

2.  On a Windows computer, double-click on the "CPUSim.bat" file.

3.  On a Linux computer or for those who prefer to use the command line,
    (a) open a command or terminal window and navigate to
        the "CPUSim3.9.X" folder.
    (b) Type in one of the following commands (all on one line):
        (Windows users)
          java -cp CPUSim3.9.jar;jhall.jar;CPUSimHelp3.9.jar cpusim.Main
        (Mac or Linux users)
          java -cp CPUSim3.9.jar:jhall.jar:CPUSimHelp3.9.jar cpusim.Main
    (c) You can also add four optional arguments to the
        command line in any order:
           -m <machine file name>
           -t <text (assembly program) file name>
           -l <language>
           -c
        CPU Sim will load the machine indicated by the -m flag and the 
        text file indicated by the -t flag and will display menus and dialogs
        using the language specified by the -l flag.  You can specify either 
        "-l Chinese" or "-l English".  If no language is specified, English is used.
        For example, to start up the Wombat1 machine and load the
        W1-0.a assembly language program that appear in the
        SampleAssignments folder, you could type in the following
        command (all on one line) on Windows:
           java -cp CPUSim3.9.jar;jhall.jar;CPUSimHelp3.9.jar cpusim.Main
             -m SampleAssignments/Wombat1.cpu -t SampleAssignments/W1-0.a
        (This command is, in fact, the command in the "CPUSim.bat" file.)
        If the user does not specify a machine file, a new empty
        machine is opened.
        The -c flag indicates that the Java Swing GUI should not be used
        and instead CPU Sim should run in command line mode.
        Note that if you use the -c flag, you must also
        use the -m and -t flags.  In that case, CPU Sim will load the
        machine indicated by the -m flag and the text file indicated by
        the -t flag and run them without a GUI.  Instead, all user input
        and output is done via the command line.


TUTORIAL

The User's manual (included in the zip file as a PDF
document) and CPU Sim's online help include tutorials on
CPU Sim that use the sample assignments.


CONTACT INFO

Questions and comments should be directed to:
Dale Skrien
Author email:  djskrien@colby.edu
Author home page:  http://www.cs.colby.edu/djskrien
CPU Sim home page:  http://www.cs.colby.edu/djskrien/CPUSim/