read.me

ucos在所有cpu下的移植范例

                         uC/OS-II, The Real-Time Kernel

                             Motorola 68HC12 Port
                        
                                 READ ME FILE


------------------------------ COSMIC C COMPILER ------------------------------
1) The  current  version  of  the Motorola 68HC12 port is based on the COSMIC C
   Compiler V4.2F:

    COSMIC Software
    400 West Cummings Park, Suite 6000
    Woburn, MA 01801-6512
    USA
    
    781-932-2556
    781-932-2557 (FAX)
    
    www.cosmic-us.com
    [e-mail]
    
2) The C compiler is assumed to reside in the C:\C68HC12 directory.

3) The code was tested using the COSMIC ZAP V3.11b Instruction Set Simulator.

4) The ZAP debugger is assumed to reside in the C:\ZAP-HC12 directory.


------------------------------- 68HC12 PORT NOTES -----------------------------

1) The port installation batch file (INSTALL.BAT) places the 68HC12 port in the
   following directory of the selected drive:
   
   \SOFTWARE\uCOS-II\M68HC12\COSMIC
   
   This directory contains the following sub-directories:
   
   \SOFTWARE\uCOS-II\M68HC12\COSMIC\SOURCE
       This directory contains the port source files as well as the sample test
       code (i.e. TEST.C).
   
   \SOFTWARE\uCOS-II\M68HC12\COSMIC\TEST
       This directory contains BUILD.BAT which is used to compile, assemble and
       link the test code.
       
   \SOFTWARE\uCOS-II\M68HC12\COSMIC\WORK
       This is the directory in which the test code is built from.
       
   \SOFTWARE\uCOS-II\M68HC12\COSMIC\OBJ
       This  directory  contains the  object files produced by the compiler and
       assembler.
       
   \SOFTWARE\uCOS-II\M68HC12\COSMIC\LST
       This directory contains the 'listing' files produced by the compiler and
       the assembler.  For the C compiler, these files contain the  interleaved
       C source along with the assembly language code generated by the compiler.
   
2) The 'SWI' instruction is used by uC/OS-II for task level  context switching.
   The  'SWI' vectors to  'OSCtxSw()'  (see OS_CPU_A.S).   OS_TASK_SW() is thus
   #define to the assembly language instruction SWI.

3) Output  Compare  #7  (i.e. OC7) is used to generate the clock tick.  The OC7
   interrupt vector points to 'OSTimeTick()' (see OS_CPU_A.S).
 
4) The maximum interrupt disable time for the 68HC12 is:

       200 clock cycles or, 
        25 uS at 8 MHz


------------------------------ REPORTING PROBLEMS -----------------------------

If  you find a problem (i.e. bug) in uC/OS-II or this port,  do not hesitate to
report the problem to me:

 1) Through the INTERNET:

        My INTERNET address is:   [e-mail]

 2) By writing to me:

        Jean J. Labrosse
        9540 N.W. 9th Court
        Plantation, FL 33324
        U.S.A.

 3) By calling me (after 8PM Eastern time, US):

        [phone]
        [phone], FAX

Make sure that the problem you are  reporting is in  uC/OS-II or this port and
not your application.    

------------------------------ M68HC12 RELEASE NOTES -------------------------

March 15, 1999: V1.01
---------------------

 1) OSTickInit()  in  TEST.C was not  initializing  the timer system properly.
    I was not able to test the timer  initialization code since I debugged the
    port using the COSMIC ZAP debugger which doesn't know about hardware.
 
 2) OSTaskStkInit() was incorrectly initializing the A and B registers.  The B
    register was initialized with 0xAA and the A register was initialized with
    0xBB. This problem was not critical and the initial value of the registers
    was only done for debug purposes.   However, for that reason, they need to
    contains the desired value.
  
 3) XIRQ cannot be disabled under  software control  once enabled and thus the
    initial value in  OSTaskStkInit() of 0xC0 would not have any effect on the
    XIRQ mask. The code has been changed to only disable the STOP instruction.
    
 4) Many thanks to Mr. Todd Morton of  Western State University  for reporting
    the above problems with the port.
      

October 22, 1998: V1.00
-----------------------

 1) First release of the M68HC12 port.