TkIsem 4.3

This document describes how to install the TkIsem SPARC assembler on a Windows machine so you can work at home. These instructions are based on the information provided on the TkIsem home page - http://www.cs.unm.edu/~maccabe/tkisem where you will find a Linux and a SunSparc Version as well.

Installing TkIsem 4.3 on Windows

The Windows version of the simulator is older than the version installed on titanic. As a result, you may encounter errors and/or instability with the simulator and build tools under Windows. In all cases you should check your code works on the version of TkIsem installed on titanic prior to any submission of your code.

Please note: The Windows version of TkIsem is not supported by the department. It is being provided on an as is basis to students. No guarantees are expressed or implied that this version of tkisem will work on your system.

Installing TkIsem on Windows 95/98/NT/2000

  1. Download the following two files: (Each file will fit onto a floppy disk.)
    win41p1.exe (744Kb)
    Tkisem.zip (1.21Mb)
     
  2. Execute the win41p1.exe file by double clicking on it. This will install Tk/Tcl version 4.1 on your machine. Choose a reasonable install location like D:\Language\TCL or C:\Program Files\TCL. Make a note of the location you used to install Tk/Tcl.
     
  3. Make a seperate directory for TkIsem like D:\Language\tkisem or C:\Program Files\tkisem and unzip the Tkisem.zip file into this directory. This should result in the following directory structure: (Where "..." is the parent path of the directory you created.)
     
  4. Use a text editor (eg WordPad or Notepad) to open the file ...\tkisem\lib\tkisem. Change the libdir setting on line 19 to point to the full path of the tkisem lib directory. (Note that you must use "/" rather than "\" in this path.) Then save the file using the same name. (If you use wordpad to make the changes, ensure that you save it as a plain text file.)
    For example:
    set libdir "D:/Language/tkisem/lib"
    or
    set libdir "C:/Program Files/tkisem/lib"
     
  5. You also need to modify your system PATH to include the locations of the
    ...\TCL\bin
    and
    ...\tkisem\bin directories.
     
    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%;D:\Language\TCL\bin;D:\Language\tkisem\bin;"
    or
    PATH="%PATH%;C:\Program Files\TCL\bin;C:\Program Files\tkisem\bin;"

     
    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 ...\TCL\bin and ...\tkisem\bin directories. (Each directory in the path is seperated by a semicolon.)
    For example:
    PATH = existing path statements;D:\Language\TCL\bin;D:\Language\tkisem\bin
    or
    PATH = existing path statements;C:\Program Files\TCL\bin;D:\Program Files\tkisem\bin
     
  6. Finally, open the properties window of the tkisem shortcut in your ...\tkisem\bin. Check that the Target and Start in fields of the shortcut refer to the full path of your install of TCL and tkisem.
    For example: (Remember to include the quotes.)
    Target = "D:\Language\TCL\bin\wish41.exe" "D:\Language\tkisem\lib\tkisem"
    Start in = "D:\Language\tkisem\Code"
    or
    Target = "C:\Program Files\TCL\bin\wish41.exe" "C:\Program Files\tkisem\lib\tkisem"
    Start in = "C:\Program Files\tkisem\Code"
     
  7. You should now be able to start tkisem by double-clicking on the tkisem shortcut in your ...\tkisem\bin folder. For convienience you may copy the shortcut to your desktop. The simulator defaults to loading the object files from its start directory.
    The assembler isem-as and linker isem-ld are run from the MS-DOS command line. You will get errors if you invoke them with incorrect arguments, but seem to work fine when used in the form:
    as-isem -o file1.o file1.s
    ld-isem -o file file1.o file2.o
     

Michael Richmond, Macquarie University