Installation

Getting Started
...     Installation

The Mic-1 MMV software requires the Java Runtime Environment (JRE) 1.4 or later. Visit http://java.sun.com/j2se/ to find a JDK or JRE for your platform.

If you are installing from the CD-ROM, you have already copied the folder Mic1MMV to your drive. Skip to Step 2.

  1. If your are installing from the Website, you need to unpack before proceeding.
    Windows NT/XP unpacking
    Run the self-extracting zip file Mic1MMV.exe. The folder Mic1MMV will be created and all program files, source code, and documentation will be extracted into that folder.

    Unix/Linux unpacking
    To decompress Mic1MMV.tar.gz under Unix-like operating systems, you'll need the GNU gunzip program or other compatible decompression software, and the tar program. GNU software is available from a number of FTP sites which are listed at http://www.gnu.org/order/ftp.html. If you're using gunzip, at a shell prompt, type:
    $ gunzip mic1.tar.gz
    $ tar xvf Mic1MMV.tar
    
    You may instead be able to do this in one step if you're using GNU tar:
    $ tar xzf Mic1MMV.tar.gz 
    
    This will create the Mic1MMV directory, as in Windows unpacking.

    Macintosh unpacking
    Double-click (or open with Stuffit Expander) the file Mic1MMV.tar.gz. This will create the folder Mic1MMV, as in Windows unpacking.

  2. There are two jar files in the Mic1MMV folder: Mic1MMV_lr.jar is designed to work on low resolution screens, while Mic1MMV_hr.jar is intended for high resolution screens. If you are using a resolution of 1280 x 960 or higher, you should use Mic1MMV_hr.jar; otherwise use Mic1MMV_lr.jar.

    Note: When Mic1MMV is launched, it automatically loads a microcode program. At first this program is mic1ijvm.mic1, the IJVM microcode interpreter described in Chapter 4 of Tanenbaum, Structured Computer Organization, 5th Edition. You can load a different microprogram once Mic1MMV is running, or even specify a different microprogram to load on startup. See the User Guide for details.

  3. Windows users:
    make sure your PATH variable points to the Java bin directory (Java installation should take care of this).

    Unix/Linux users:
    set the PATH environment variables. In order to run any of the Mic-1 MMV software, the PATH variable must contain the path of the JDK executables. To see if the PATH is set correctly, type which java. If a directory path is returned, the PATH is properly set. If nothing is returned, you need to find the jdk and then set the PATH.

    Mac OSX users:
    check that the Java JRE is properly installed on your machine. You should be able to launch the jar files by double clicking on their icons.

  4. Try both Mic1MMV_hr.jar and Mic1MMV_lr.jar, and rename the appropriate file Mic1MMV.jar. Launch, either by double-clicking the icon or with the terminal console command:
    java -jar Mic1MMV.jar
    
    Alternatively, edit the batch file runMic1.bat and use it to launch the simulator. Instructions for editing runMic1.bat are contained in that file.