First, you'll need to install a Java system. The Sun Java Runtime Environment, Standard Edition (J2SE), can be downloaded from Sun's official site. On Linux, you'll want to change your PATH environment variable so that the "java" command is on your search path. On Windows and OS X, double-clicking any of the 6.004 jar files will run the program (assuming you've installed the Sun Java environment).
Once you've installed a Java environment and downloaded the 6.004 files (see "Quick Clicks" above), you can run JSim using the following command:
You may have to specify complete pathnames for "java" and "jsim.jar" depending on your current search path and working directory. Each of the arguments is explained below.
If you get an error of the form "Exception in thread
"main" java.lang.NoClassDefFoundError: jsim/JSim", the Java
runtime didn't find the jsim.jar file -- try giving its full pathname,
-Xms8m -Xmx32m sets the minimum heap size to 8MB and the maximum heap size to 32MB. Starting JSim with a generous heap allocation avoids a lot of garbage collection overhead the first time your circuit is processed. If you run out of memory, try specifying the -no-local-names option when running JSim. This will greatly reduce the size of the node name hashtable JSim constructs when processing the netlist. The downside of using this option is that nodes can only be referred to by using their name in the (sub)circuit where they were first defined.
-reporterrors asks JSim to provide a backtrace whenever it encounters an internal error. In the unlikely event an error occurs, it would be very helpful if you can email this backtrace to firstname.lastname@example.org.
file... are optional arguments specifying one or more JSim netlist files.
Editing netlistsThe netlist editor built into JSim is based on the JTextArea class in Swing. Many people find the editing facilities provided by this class to be underwhelming and prefer to use an external editor. jsim.el defines a new major mode for EMACS useful for editing JSim netlists. You can invoke the mode automatically when reading in a ".jsim" file by adding the following to your .emacs file:
;;; jsim support, assumes jsim.el lives in your home directory