readme.txt

uc/os-ii for 8051 This package provides the sources required to use the uC/OS-II v2.00 real time k

TASKING 8051 C Compiler

uC/OS-II, The Real-Time Kernel


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

This package provides  the sources required to use  the uC/OS-II v2.00
real time kernel  on the 8051 processor. To use  this package you will
need the TASKING C Compiler toolset v6.0r1 or higher.

For info on TASKING products you can contact our Web-site at:
    http://www.tasking.com


Unzip the  zipfile in the root  of the drive where  you also installed
the  uC/OS-II  general sources.   The  following  directories will  be
added:

\SOFTWARE\UCOS-II\8051
      This directory contains the microprocessor specific source code

\SOFTWARE\UCOS-II\ex1_8051r
      This directory contains the project files for the first example

\SOFTWARE\UCOS-II\ex2_8051r
      This directory contains the project files for the second example


----------------------------------------------------------------------
BUILDING THE EXAMPLES UNDER WINDOWS
----------------------------------------------------------------------

After you have  unzipped the package you can  find 2 example projects,
'ex1_8051r.pjt'   in   the    'ex1_8051r'   example   directory,   and
'ex2_8051r.pjt' in the 'ex2_8051r'  directory.  Open the 8051 EDE, use
File | Open to browse to one of the project files, and open it (ensure
you have 'Auto-detect file type' on).  Now the project should be added
to and  opened in  your project space.   Then press  the build/rebuild
button to create an absolute file.


----------------------------------------------------------------------
EXAMPLE 1 FOR THE CROSSVIEW PRO SIMULATOR
----------------------------------------------------------------------

The first example runs in the Crossview Pro simulator.  It consists of
5 tasks.

- The first  task is created  by main() and calculates  some processor
  statistics. It also creates the other tasks.
- The second task displays  different status-messages in the simulator
  (simulated I/O).
- The other  three tasks are  identical and toggle output  ports P1.7,
  P1.6 and P1.5.
- Use of printf() functions is protected by a semaphore.
- The status-messages  of the CPU  usage and the port-status  are sent
  via a queue.


----------------------------------------------------------------------
EXAMPLE 2 FOR THE PHYTEC KitCON 505L BOARD
----------------------------------------------------------------------

The  second example  runs  on a  Phytec  KitCON 505L  board and  looks
similar to the first example.  It consists of 5 tasks.

- The first  task is created  by main() and calculates  some processor
  statistics. It also creates the other tasks.
- The second task  displays a status on the onboard  LCD. It shows the
  usage of the processor and the status of the ports.
- The other  three tasks are  identical and toggle output  ports P1.7,
  P1.6, P1.5.
- Status of the ports and the usage of the CPU are sent to the display
  task via a queue.


----------------------------------------------------------------------
USING uC/OS-II IN YOUR OWN PROJECT
----------------------------------------------------------------------

To use  the uC/OS-II  kernel in your  application, take  the following
steps:

1. include  the source files  '\software\ucos-ii\source\ucos_ii.c' and
the '\software\ucos-ii\8051\os_cpu_c.c'. The first includes all target
independent  kernel  sources,  the  2nd contains  the  8051  processor
specific settings.
2. Select the reentrant  memory model under EDE |  C Compiler Options.
3. From one of the example project directories copy 'os_cfg.h' to your
own project directory and adapt it to your needs.
4. Go    to   EDE    |   Directories    and   add    the   directories
'\software\ucos-ii\source' and '\software\ucos-ii\8051' to the Include
Files Path.  Also add your  project directory (absolute or you can use
'.') to the Include Files Path, this allows the kernel sources to find
the project configuration file 'os_cfg.h'.
5. Open  the  EDE  |  C  Compiler  options  |  Preprocessing  and  add
'data=datax' as user  macro. This is required since  a variable 'data'
is used in the general sources.  Since 'data' is also an 8051 compiler
keyword, the define prevents a conflict.