*
* file: README - 10/28/98
*
*

		 Sparc Lite Multi-tasking RTOS

This is a very small, simple Multi-tasking RTOS .
The description for this kernel appears in Jean's book,
   
 
   R&D Publications
   Suite 200
   1601 West 23rd Street
   Lawrence, KS 66046
 
   (913) 841-1631
   FAX (913) 841-2624

The book contains all of the source code for uC/OS, descriptions
of its features, and an excellent general introduction to the concepts
of real-time operating systems.

Be sure that you get the accompanying diskette, it'll save a lot of typing! 

This directory contains the uC/OS kernel for the SparcLite processor.
uC/OS is a real-time kernel written by Jean J. Labrosse for the x86
processor and published in the magazine "Embedded Systems Programming" 
in 1992.

For more information about uC/OS I recommend the book by Jean J. Labrosse
"uC/OS The Real-Time Kernel" distributed by Prentice Hall, ISBN 0-13-031352-1.

To use this version of uC/OS, you need a Fujitsu 832 Evaluation Board and the 
GNU development software. Fujitsu makefile organization depends on the following
directory structure:
c:\slite
        \prom	/* monitor code */
        \sw
           \gnulib	/* debugger code */
   	       \programs
                    \ucos	/* operating system code */
   	                     \apps		/* example and test code */
                         \832		/* chip code */
                             \832ek		/* board code */
                        

The uC/OS code is in this directory. Chip specific code is in the 832 chip 
subdirectory. This code handles interrupts and task switching. Support code for
the 832 evaluation board is in the 832EV board subdirectory of the chip directory.
Board code sets up the interrupt controller and timer chips.

Test and example programs are in subdirectories of the ucos directory. 

To run any of the test programs:

- Connect two serial cables from the host computer to the evaluation board. 
  Follow Fujitsu directions for connecting the GNU debugger and test the
  connection.

- Start Microsoft Hyperterm and connect it to the second evaluation board serial
  port. 

- Enter any test program directory. For this example use 'looptime'.

- 'make' the program.

- 'd' is a batch command that starts the debugger

- Minimize the debugger and adjust so you can also see the hyperterm output

- At the debugger menu bar select 'Gdb' and 'Read script'

- Enter 'looptime.cmd'

- When loading ends, use the 'Enter' key to get the gnu> prompt

- Enter 'c' to continue but do not hit 'Enter' yet.

- Place the mouse cursor over the Hyperterm display, hit 'Enter' and left click.
  This immediately puts the focus onto the Hyperterm window which will not scroll
  unless it has the focus.

- Most of the tests run without stopping.  To stop execution use the very small
  black reset button on the evaluation board. The debugger will be blocked waiting
  for I/O from the board. You must use Ctrl-Alt-Del to get the task manager which
  allows you to kill the debugger.

Enjoy,

Brad Denniston


Disclaimer: This software is released "AS IS" and the authors do not assume any
liability arising out of this program or use thereof.