TkIsem 4.5.7 and SPARC Documentation

Index

Documentation about (Tk)Isem and Sparc in general
Linux: Software and installation instructions
Windows: Software and installation instructions

This semester we'll be using the SPARC emulator TkIsem. You can obtain copies here. These packages were built by Dom Verity.

This page also contains general documentation about the SPARC architecture, and specific documentation for TkIsem.

Documentation

Here might be some documentation for the SPARC and TkIsem. Be very sparing about printing this information - there's a lot of it!

Reference card for the SPARC as implemented by TkIsem.
Lab manual from the university that produced TkIsem.
Assembler manual for the GNU assembler use in Comp226.
You can download the SPARC V8 architecture manual from the SPARC standards web page. It's in the Other Documents section, and is titled ``V8 (32-Bit SPARC) Architecture Book''.
Please don't print the whole thing! It's about 300 pages.
Tip: Download the complete PDF, view it in acroread, and save it as postscript via File, Print, check the File box and enter a file name. If you call it V8.ps, the unix command
```
	psselect -p79-89,93-94,102-106,108,111-118,123-124,129-133,135 V8.ps V8-226.ps
	
```
(all on one line) should peel out the pages particularly relevant to Comp226 into a file 226-V8.ps. This is much easier to print (35 pages), but still contains way more information than you need for Comp226.

The linux distribution is packaged as a RedHat rpm, and installs in /usr/bin, /usr/lib and /usr/doc. You need tcl and tk - these should be installed on a typical RedHat distribution. This distribution is untested at this time, so no warranties are provided (and Mike would welcome any information about how you go with it). The rpm should also work for SuSE Linux systems.

Downloads:

Binary Rpm
Source Rpm : You don't need the source rpm, but if you like source, it's provided in the interests of transparency.

To install, download the binary rpm, become root, and use

	rpm -Uvh tkisem-4.5.7-4.i386.rpm

To install tkisem on RedHat 7.1, there are a few special things that need to be done in order for the rpm to work, so heres a quick "howto". After tk, tcl, and their libraries etc have been installed, the installation of tkisem fails:

	> rpm -i tkisem-4.5.7-4.i386.rpm

	error: failed dependencies:

	        libtcl8.0.so is needed by tkisem-4.5.7-4

	        libtk8.0.so is needed by tkisem-4.5.7-4

This is because version 8.0 of tcl/tk has been outdated since redhat 6. Use the commands below to make tkisem use the new 8.3 libraries (they seem to be compatible)

	> ln -s /usr/lib/libtcl8.3.so /usr/lib/libtcl8.0.so

	> ln -s /usr/lib/libtk8.3.so /usr/lib/libtk8.0.so

Then force rpm to not look for dependencies with --nodeps:

	> rpm -i tkisem-4.5.7-4.i386.rpm --nodeps

A student suggested for SuSE 7.2 (this has not been tested by the Sysprog-team):

        > ln -s /usr/lib/tkisem/tkisem.so /usr/i486-linux-libc5/lib/

Windows

The windows distribution is packaged using install shield. You need tcl and tk - these are not installed on a typical Windows system, but can be downloaded here.

Downloads:

To install, download the required executables and double-click on them (first tcl, then isem, then asld).

You also need to modify your system PATH to include the locations of the

...\tkisem\bin directory.

In Windows 95/98 you do this by setting the PATH variable in your C:\autoexec.bat file. Open the file in notepad, and add the following line to the end of the file using the appropriate paths for your installation of TCL and tkisem. If you do not have an autoexec.bat on your system, use notepad to create one and save it as C:\autoexec.bat. Once you have made the changes, reboot your system.
(Note: Do not make any other changes to your autoexec.bat file, as this file contains important system configuration settings.)

For example: (Remember to include the quotes.)

PATH="%PATH%;C:\Program Files\tkisem;"

In Windows NT/2000 you do this by opening the System control panel, clicking on the Advanced tab, then clicking on the Environment Variables button. This will bring up a window in which you can set and modify environment variables. In the System variables list, modify or create a variable named PATH with a Value that includes the full path of your ...\tkisem\ directory. (Each directory in the path is seperated by a semicolon.)

For example:

PATH = existing path statements;C:\Program Files\tkisem

2001 Macquarie University

Adapted to Sysprog use by Christian Kurmann and Felix Rauch

Last modified: Dec 5 2001