The uC/OS-II port for Keil C V7.07 or higher
By Stuart Wright, England, (swright@jiskoot.com)
This port for the Dallas 80C390 was based on a port for the 8051 by
John X. Liu from China (johnxliu@163.com). Johns port was a very clear
and consise port which allowed me to easily port and testing of this
port. Incluced within this port are a number of his test files.
1. About this port.
This package contains the files of porting uC/OS-II V2.70 to
Keil C environment, including the necessary head files and
source files and an example to show how to use this port.
2. Files list.
This package only included the files specific to port for
Keil C, and assumed that you have all the other uC/OS source
files.
Porting files:
OS_CPU.H Defines the data types and some macros needed
by uC/OS. Also defines some macros to work-
around the problem that some keil c keywords
were used as identifiers in uC/OS-II source
files.
uCOS_II.H Header file for OS functions, all functions
have been declared KCREENTRANT.
OS_CPU_C.C The c part of porting source files.
OS_CPU_A.ASM The assembling language part of the port.
Example files:
OS_CFG.H The configuaration file, specific to every
application, used to define what features of
the os are needed to be included
EX1L.C The example file ported from borland c++ port
which can be found in directory:
\SOFTWARE\uCOS-II\EX1_IX86L
PC.H The PC-emulating head file, ported from its
original directory \SOFTWARE\PC
PC.C The PC-emulating source file,implementes PC's
display screen, ported from \SOFTWARE\PC
PC51EMU.DLL The debug DLL of Keil UV2 degugger environ-
ment. To be used to emulate the behavior of
a PC display screen.
START390.A51 File to configure the dallas 80C390 processor
EX1KC51.UV2 The example's project file.
EX1KC51.OPT Option file of the project.
Document:
Readme.Txt This file.
3. About the porting files.
The required functions have been implemented according to the
description in the book 'uC/OS-II, The Real-Time Kernel'. Mainly
the work of porting is arround how to save the status of CPU
and restore it later. The status include the register ACC,B,
PSW, DPTR,IE,R0-R7,SP, and the hardware stack resides in 8051
strach RAM. This work is fulfiled by c code in OS_CPU_C.C and
some assembly code in OS_CPU_A.ASM.
Due to the specific grammer of keil c, the functions declared
by default are non-reentrantable. If you need re-entrantable
function, you must add a 'reentrant' after the declaration,
like this:
func() reentrant
{
.
.
.
}
So it is necessary to modify the declarations and definitions
of uC/OS-II's system functions to make them work as expected.
Head file uCOS_II.h declares all uC/OS functions reentrant.
But you still need do lot of things. You need modify all the
uC/OS-II function declarations in .h files and definitions in
.c files so as to make them conform to the respective ones in
uCOS_II.h.
4. The example.
The example comes from \SOFTWARE\UCOS-II\EX1_IX86L, which is
intended running under MS-DOS originally. Seeing it's a nice
illustration of uC/OS multi-tasking feature, I included it in
this port for keil c environment. In order to show the result
I wrote a Keil UV2 debugger simulator DLL to emulate PC's the
display screen to show the result of the examle. It maps the
XDATA:0-0x1000 as PC's display buffer at B800:0 and displays
the characters and attributes as same as PC does. To see the
result of the example, you should copy the PC51Emu.DLL to the
Keil's C51\Bin directory and add '-dPC51Emu' at the paramters
editbox of dialog DLL in debug panel of the project's options.
5. Compiling and running the example files.
First, Unzip the files in this package to a directory,
i.e. \SOFTWARE\uCOS-II\I8051\Keil, make the directory current.
Then copy all uC/OS files in the directory \SOFTWARE\uCOS-II\
SOURCE to the current directory, edit the declarations of all
functions and the definitions in OS_*.C to make
them same with the respective ones in UCOS_II.H.
Second, Run Keil UV2 IDE, open the project file "Ex1KC51.UV2",
click compile or build, let KC compile all the source files,
and build the target Ex1Kc51. If any error occurs, correct it.
Mostly circumstance it is due to incorrect modifing of uC/OS
source files. It is rather simple to find the mismatches out
and correct them.
Third, start debugging,and check the peripheral menu,you will
see a menu item 'Virtual screen' added there. Click the menu
item, a PC-liked virtual screen window will display. Run the
example in full speed, you will see the output of the example
shown on the virtual screen window.
You may run the original example in \SOFTWARE\uCOS-II\EX1_I86L,
to have a comparation between them.
6. Adapting this port in your application.
1) Copy the files you need from the directory of this example to
the directory of your project.
2) Edit the OS_CPU.H and select a critical method best to you by
set the OS_CRITICAL_METHOD to 1,2, or 3. You may refer to the
book 9.03.02 to decide which method to be used.
3) Read and edit the OS_CFG.H and decide what system services
you need include in your project.
4) Write your own interrupt service routines as demonstrated in
OS_CPU_C.C. If you like you may reimplement the OSTickISR.
5) At least in your first task you must write code to initialize
the timer that uC/OS uses. If you change the timer rate, you
must change the OS_TICKS_PER_SEC to the right value as well.
7. Support for multiple DPTR's of the Dallas 80C390
The code can support the second DTPR of the Dallas 80C390 this
requires a number of changes to the code
1) The first change required is to the function "OSTaskStkInit" in
the file OS_CPU_C.C. This function contains 5 lines of code are
currently commented out, to enable support for the second DPTR
this code must be uncommented.
2) The second change must be performed within the file OS_CPU_A.A51.
This file has two macros called PUSHR and POPR, these are used
to push and pop the registers to and from the stack. Within both
of these macros there are two versions of the registers to push
and pop. Currently the register list for one DPTR is uncommented
and the list for two DPTR's is commented out. The commenting must
must be swapped around to enable the second DPTR
8. The arithmetic unit of the Dallas 390
This arithmetic unit appears to work ok on condition that you
only use this unit within one process or interrupt. I do not
believe it is possible to allow more than one process or interrupt
to use this unit due to the way this unit functions. See relevent
Dallas 80C390 literature.
9. System clock speed and timing.
Currently the system is set for a clock speed of 29491200Hz which
is what I use within my system. To change this you need to change
the "#