UESA
----

The UESA project was my final year project at university for my BSc Computer Science Degree.
It is a processor simulator written entirely in Java, heavily based on the Motorola 68000
processor. The idea was to experiment to see how practical it is to produce a processor
simulator with an architecture than can be defined using RTL (Register Transfer Language)
It's worth noting that the UESA is not necessarily a practical program for the end user
but was only developed to test my research. The UESA has been tested on Linux and Windows
but should work with any platform that has a decent Java implementation.

The main documentation is a Word 2000 file which is actually my thesis, but it does explain
how the program works, technically as well as using it. Word documents can generally be
viewed under Linux with Star-Office, Open-Office, Kword or AbiWord.

The UESA was my first attempt at a Java program, and my induction to object oriented programming
so apologies to any experienced OO or Java programmers reading this :-)


Compiling
---------

In order to compile the source, you'll need the Java Development Kit. This program was written
using Sun's Java implementation, it may compile and work with other vendor's implementations but
Sun's is recommended. If java is installed correctly then the commands java and javac should be
in your command path.

For WINDOWS, run the following in the source directory:

compileuesa.bat

For LINUX/UNIX, run the following in the source directory (ensure it is executable):

./compileuesa.sh


Running
-------

To execute the program, type the following in the program directory:

java UESA

NOTE: You should be aware that even if your operating system does not use case sensitive file names,
java is still case sensitive, so ensure you preserve the case of the filenames.


Contact
-------

If you wish to contact me then send an E-Mail to: ian.chapman@amiga-hardware.com

