This tutorial will guide you through setting up your account at school to be able to run the LC-3 Simulator and Tools in the CAEDM Lab (on the gray HP-UX computers) or Talmage Building Open Linux Labs. If you need to setup the simulator somewhere else, you may try some of our other tutorials.

Step 1
login to a gray SPICE (HP-UX) machine in CAEDM (425 CB) or one of the Open Linux Lab computers in the Talmage Building (TMCB 1102, 1106, 1110, etc.) and open a shell window.

Step 2
Create a new directory called "lc3simulator" in your home directory by typing the following commands:

$ cd
$ mkdir lc3simulator

( Note: You may put this directory in a different location, but this tutorial will assume that you have done it this way. Only do things differently if you know what you are doing.)

Step 3
download lc3.jar and lc3arch.jar. Right-click these links, choose "Save As..." (or "Save link target as...") and save them to the newly created lc3simulator directory (from Step 2). Also download one of the following setup scripts depending on which building you are working in: spice_setup.sh or tmcb_setup.sh.

Step 4
Run the configuration script that you downloaded (first making sure the permissions are set so you can run it).

A) If working in CAEDM:

$ cd ~/lc3simulator
$ chmod 755 caedm_setup.sh
$ ./caedm_setup.sh

B) If working in the TMCB (Talmage building):

$ cd ~/lc3simulator
$ chmod 755 tmcb_setup.sh
$ ./tmcb_setup.sh

Step 5
Log out and log back in.

Step 6
Test your setup to make sure things work correctly. In a shell window type:
$ convert
If you see the following text:
To invoke: convert file (without .mco suffix)
you are now setup to use the LC-3 Simulator and Tools.

If you see something else, go back and make sure you followed all of the steps correctly. Ask a TA if you continue to have problems.

After you have set it up, you can run through the LC-3 Sim tutorial