Compiling and Installing the Komodo Tool under Windows Cygwin

This document shows you how to compile and install the Komodo Tool for the DSLMU microcontroller Board under the Windows operating systems. Please note that it is much easier to install the precompiled binary image for Windows (as found on this CD-ROM).

In this document, “$” will indicate the Cygwin terminal user’s shell prompt. Anything in a bold monospaced font is what you are expected to type in; an ordinary monospaced font is used for the computer’s response. Please note that this document doesn’t show every response from the computer!

Minimum System Requirements

In order to successfully compile, install and run the Komodo Tool, you will need to meet at least the following requirements:

1.	A Windows 2000 or above operating system.
2.	A complete installation of Cygwin Unix Emulator from CD-ROM.
3.	At least 10 MB of free disk space.
4.	The password of Administrator’s account on your system.

Step-by-step Instructions

Installing the Komodo Tool is quite simple, but be careful that you type in the commands exactly as shown! These instructions assume that the CD-ROM can be found as drive D: on your computer (/cygdrive/d within the Cygwin environment). If it is not, simply substitute the actual drive letter for the “d”. See the instructions for mounting the CD-ROM for more details.

1. If you are running Microsoft Windows 2000 or Windows XP Professional, log in as Administrator. If you are running Microsoft Windows XP Home, simply log in.

2. Start a Cygwin command line (usually by selecting Start » Programs » Cygwin » Cygwin Bash Shell).

3. Create a directory to contain the sources. Note that at least 15 MB of space is required for both the source code and build files. In this document, /var/tmp/KMD will be used for the sources:

`$`	`mkdir /var/tmp/KMD`
`$`	`cd /var/tmp/KMD`

4. Locate the appropriate sources, either on this CD-ROM. Assuming the CD-ROM is mounted on /cygdrive/d, the source code archives can be found in /cygdrive/d/board/software/komdo/.

5. Unpack the sources:

`$`	`gzip -dc /cygdrive/d/board/software/komodo/komodo-windows-1.5.3-UNSW-2.0.tar.gz \| tar xv`

If your version of tar is compatible with GNU tar, you can use tar xzvf ... instead of gzip -dc ... | tar xv

6. Configure the Komodo source:

`$`	`cd kmd_windows`	`# Change to the Source directory`
`$`	`./configure`	`# Configure the program for your system`

8. Compile the Komodo source:

$ make all # Create the executable files

(If the compilation terminates with an error, read the section on common problems for some suggestions of what you should check.)

9. Install the Komodo Tool binaries:

# make install # Create the executable files

10. (Optional) Remove the source code and build files:

`$`	`cd /var/tmp`
`$`	`rm -fr KMD/kmd_windows`

11. You have successfully compiled and installed the Komodo Tool. You need start X-window to run komodo tools:

$ startx # New X-window terminal will appear

12. Run Komodo debugger simulation mode in the X-window Terminal:

`$`	`kmd -c`	`# Create Initial file, This just need done once after installation`
`$`	`kmd -e`

Common Problems

In most cases, you will not encounter any problems in compiling and installing the Komodo Tool. There might be exceptions, however. The following is a list of things you should check if the compilation (the “make all” step) terminates with an error:

1.	Check that you entered all commands exactly as specified.
2.	You may not have the appropriate GTK library. You need to install them and try again.

Happy compiling!