Subversion Repositories mips32r1

README for XUM Demo 5 : Threads
-------------------------------

Creator: Grant Ayers (ayers@cs.utah.edu)
Date:    26 July 2012



DEMONSTRATES
------------

Atomic locks, threads, LEDs, LCD.



DESCRIPTION
-----------

This demo implements a basic thread scheduler which runs eight separate
threads on a single processor. Each thread writes a continuously-changing
value to a location on the LCD screen corresponding to its unique thread ID
(1 through 8). However, it only changes and updates this value when it holds
a lock which is shared among the eight threads. XXX

Each thread has its own 16 KB stack space, arranged as follows:

    Thread      Start      End        Initial SP
    --------------------------------------------
    Kernel      0x90000    0x93ffc    0x94000
    Thread 1    0x8c000    0x8fffc    0x90000
    Thread 2    0x88000    0x8bffc    0x8c000
    Thread 3    0x84000    0x87ffc    0x88000
    Thread 4    0x80000    0x83ffc    0x84000
    Thread 5    0x7c000    0x7fffc    0x80000
    Thread 6    0x78000    0x7bffc    0x7c000
    Thread 7    0x74000    0x77ffc    0x78000
    Thread 8    0x70000    0x73ffc    0x74000

Scheduling decisions are made each time the timer interrupts, and the
scheduling policy is a simple round-robin rotation.



BUILDING AND RUNNING
--------------------

To compile, enter the 'bin' directory and update the paths in the Makefile.
Then run 'make' from within the same directory. Use the XUM bootloader to
send the resulting .xum file to the FPGA.