Compiling and Installing the Komodo Tool under Linux or Unix

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

In this document, “$” will indicate the ordinary user’s shell prompt, and “#” will indicate the root superuser’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 Linux, Unix or Unix-like operating system, with all of the usual utilities, system header files and libraries, as well as the GTK - an advanced widget set, the X11 Window System (with header files and libraries), Perl, GNU gzip and bzip2.
2.	An ANSI-compatible C compiler tool-set, such as the GNU Compiler Collection (gcc),
3.	At least 10 MB of free disk space,
4.	The password to the root superuser’s account on your system.

Step-by-step Instructions

Compiling and installing the Komodo Tool is very simple. These instructions assume that you have already mounted the CD-ROM on your computer, and that the mount point (where the CD-ROM can be found within the file system) is /mnt/cdrom. See the instructions for mounting the CD-ROM for more details.

1. Log in as an ordinary user, not as the root superuser. This is highly recommended and is standard Unix practice. In fact, you should never directly log in as the root superuser; this helps save you from your own mistakes and/or any viruses that can destroy the working of your system!

2. 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`

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

4. Unpack the sources:

`$`	`gzip -dc /mnt/cdrom/board/software/komdo/komodo-linux-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

5. Configure the Komodo source:

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

7. 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.)

8. As the root superuser, install the Komodo Tool binaries. You will need the root superuser’s password:

`$`	`su`	`# Log in as root superuser`
`#`	`make install`	`# Create the executable files`
`#`	`exit`	`# Exit from root superuser`

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

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

10. You have successfully compiled and installed the Komodo Tool for the DSLMU microcontroller Board! You can run Komodo debugger under its simulation mode by typing:

$ 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. Please note that your browser may split up commands over a number of lines (depending on the width of your browser window); that does not mean you do the same! Each shell prompt (“`$`” or “`#`”) indicates a single command line.
2.	You may not have the appropriate GTK library. You need to install them and try again.

Happy compiling!