Digsim

the Digsim site
 
   

Download digsim

PDF
PDF

Why download

You are certainly free to download the digsim project.

Note
However, you should note that digsim is mainly an educational tool that demonstrates the software production process; digsim is not meant to be a usable tool for the simulation of real digital circuits.

The downloadable digsim.zip file contains the complete source code for the project as well as the documentation source code and the pre-compiled binaries and transformed documentation.

Download requirements

You need Java 1.4 (or greater) installed.

Download

Download digsim.zip (about 600 Kbytes).

Installing downloaded file

Unzip the downloaded digsim.zip. The directory dist contains two executables that invoke the simulator:

digsim.bat:
This Microsoft Windows batch file should start the simulator from any Windows platform.
digsim:
This shell script should invoke the simulator from any unix-like operating system (such as Linux, Solaris, etc.). Note that if the environment variable DIGSIM_HOME has not been set, it must be invoked from within the directory it resides in with ./digsim.

Caveats

The digsim.zip file is a complete distribution of my development site—WARTS included!

Casual examination of digsim should be simple: the Java source code is already compiled and the compiled classes are stuffed into a single jar file—digsim.jar. Furthermore, the pre-compiled javadocs are linked to html renditions of the actual source code.

If you want to experiment with the source code, you should use the command ant to re-compile any new source code (or ant jar to recreate the jar file). You need to have the Apache ant package installed to do this.

The build.xml file included in the distribution should work for basic targets. Alas, the build.xml is a ghastly kludge when it comes to higher-level targets such as re-creating the web site. In particular, beware the command ant clean: it will certainly delete derived files, but it is virtually certain that something like ant docs will not work on your system. (I have hard-coded various paths in many places...SORRY...)

by Ken Clowes; v1.0 April 5, 2004