uC/OS-II for the Texas Instruments TMS320C5409 DSP

	Ported by : Yi Han (yhan@ti.com)

		July, 2000

Note the Code is WITHOUT ANY WARRANTY whatsoever; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SOFTWARE IMPLEMENTATION.
The TI C Compiler  "TMS320C54x C Compiler ShellVersion 3.10" Cl500 is used.

A. To install the port, unzip all the files into a single directory and copy
the following cpu indepent files to that directory:
"\software\uCOS-II\source\os_core.c"
"\software\uCOS-II\source\os_mbox.c"
"\software\uCOS-II\source\os_mem.c"
"\software\uCOS-II\source\os_q.c"
"\software\uCOS-II\source\os_sem.c"
"\software\uCOS-II\source\os_task.c"
"\software\uCOS-II\source\os_time.c"
"\software\uCOS-II\source\ucos_ii.h"

Open the project file ucos_ii.mak from Code Composer. You may have to find
the rts.lib from your Code Composer installation directory (see explanation
for rts.lib below). Then you should be able to compile and run the example 
program.

B. The following files are unique to the C5409 port:

1. Sample Project File "Ucos_ii.mak"
The project file is created by Code Composer Version 1.1

2. Run Time Support Lib "rts.lib"
"rts.lib" is needed for the operators "*", "/", "%". They only appear in
two functions: OSTaskStat() and OSTimeDlyHMSM(). Due to the inefficient
implementation of "/" on DSPs, you may want to avoid using the above two
functions and not including rts.lib altogether. Note that this file is not
included in the .zip package. You should find it from your TI Code Composer
installation directory.

3. "Boot.asm"
This file contains the code to set up the runtime C environment and then
branch to main().

4. "Init_C54.asm"
This file contains a function to init some C549 registers.

5. "C54_Timer.asm"
This file contains a function to set up the C549 timer registers and enable timer interrupt

6. "Timer_ISR.C" and "Timer_ISR.asm"
The Timer_ISR.C contains OSTickISR() implemented in C with the keyword "interrupt".
Since I don't want to change the definition of the function in Ucos_ii.h, I just have
the compiler generated Timer_ISR.asm and include the .asm in the project.

8. "Vector.asm"
This file has the interrupt vector table. Only two entries have ISRs:
software interrupt 17 is used for context switching and timer interrupt is used for
generating time ticks.

9. "ucos_ii.cmd"
This is the linker command file.

10. "exit.c"
This file clears up the C environment.

Please contact yhan@ti.com for questions.