Companion CD-ROM: board/src directory

The board/src directory contains source code that either runs on the actual DSLMU Microcontroller Board or directly communicates with it. The software that runs on the Board is also known as “on-board”, “back-end” or “systems-level” software; you can browse the code by examining the files in the [List] board/src/monitor subdirectory. The software that communicates with the DSLMU Microcontroller Board is called the Komodo debugger, also known as the Komodo “front-end“; you can find the relevant files in the [List] board/src/komodo subdirectory.

The on-board software is divided into a number of modules, some of which are selected by the Boot Select switch. The modules include the Boot Loader ([File] boot.s), the Flash Programmer ([File] flash_prog.s) and the Komodo ARM Environment ([File] imp.s). Please note that this code, written by staff at the University of Manchester, does not use the usual GNU Assembler syntax. You have been warned!

The Komodo debugger is used in the Digital Systems Laboratory to communicate with the DSLMU Microcontroller Board and to debug your programs being run on that board. If you like, you can compile this program on your own computer by copying the source code files in the [List] board/src/komodo directory to some local directory, then configuring and compiling the program. The following command lines should be all you need:

cd /mnt/cdrom/board/src # Change to the appropriate CD-ROM directory
cp -pr ./komodo ~/komodo # Copy all of the files to a local directory
cd ~/komodo # Change to the new directory
./configure # Configure the program for your system
make all # Create the executable files
make install # Install the appropriate files to /usr/local/bin

Once you have installed Komodo, you can run it under its simulation mode by typing:

kmd -e

Please note that the files in these directories are not supported for use outside the Digital Systems Laboratory! In addition, the Komodo debugger only runs under the Linux operating system at this time.

Directory Contents

[Root] CD-ROM Root Directory
[Dir] board: Information about the DSLMU Microcontroller Board hardware
[Dir] src: Source code for the board   This is the current directory
[Dir] monitor: On-board software (back-end software)
[Dir] komodo: Source code for the Komodo debugger (front-end software)
[File] README.html: The file you are currently reading