readme.txt

mpc55**系列芯片的例程 包括SCI,SPI,TIMER,FIT,EDMA等几乎所有功能的实现

This is release 1.00 of the eTPU function set1. The package contains the
binary image of the eTPU code for the CPU to use, the source code and the
interface files for the function APIs.

This release contains the GPIO, PWM, UART, QOM, SM and SPI functions which have
passed testing (the PWM function has had DMA requests added but has not been
re-tested yet). In addition to support development work with the eTPU the IC and
PPA functions are also included. These functions are being tested and
should be considered prototypes only be used for testing.

All size are in bytes. Version 1.0.0.5 of the ByteCraft eTPU compilier was used.

 Nickname    |Version| Start |  End  |Code Size|Entry Table| Total |  Status  |
-------------+-------+-------+-------+---------+-----------+-------+----------+
GPIO         |  1.2  | 0x0400| 0x0494|    152  |      64   |   216 | Tested   |
PWM          |  1.5  | 0x0498| 0x05C4|    304  |      64   |   368 | Tested*  |
IC           |  1.4  | 0x05C8| 0x06B0|    236  |      64   |   300 | In Test  |
PPA          |  1.2  | 0x06B4| 0x093C|    652  |      64   |   716 | In Test  |
-------------+-------+-------+-------+---------+-----------+-------+----------+
UART         |  1.2  | 0x0940| 0x0B34|    504  |      64   |   568 | Tested   |
QOM          |  1.3  | 0x0B38| 0x0DE0|    684  |      64   |   748 | Tested   |
SM           |  1.3  | 0x0DE4| 0x10C4|    740  |      64   |   804 | Tested   |
SPI          |  1.3  | 0x10C8| 0x1240|    380  |      64   |   444 | Tested   |
-------------+-------+-------+-------+---------+-----------+-------+----------+
test         |  1.2  | 0x1244| 0x126C|     44  |      64   |   108 |  N/A     |
Global_error |       | 0x1270| 0x12A0|     52  |       0   |    52 |          |
Link4        |       | 0x12A4| 0x12B4|     20  |       0   |    20 |          |
-------------+-------+-------+-------+---------+-----------+-------+----------+
                                     TOTAL Code Memory used: 4,344

*The PWM has not be re-tested after DMA requests were added.

The test function is used to test the eTPU functions and not designed for
customer use. Global_error is a subroutine used by some of the functions
to provide error information to the host CPU. Link4 is a subroutine used by
some of the functions to generate links to other channels.

To support the eTPU functions the etpu.h (vesion 1.01) and etpuc_common.h
(version 1.0) files from ByteCraft were used.

Files included in this package:
===============================
etpu_set1\readme.txt - This file.
etpu_set1\etpu_set1.h - Image of eTPU code for host CPU (generate by eTPU compiler).
etpu_set1\makefile - A makefile used to build the code.
etpu_set1\etpuc_set1.cod - Debug information for set1 functions.

eTPU code
---------
etpu_set1\etpu_set1.c - Top level file for set1 functions.
etpu_set1\etpuc.h - Standard include file for eTPU code from ByteCraft.
etpu_set1\etpuc_common.h - Standard include file for eTPU code from ByteCraft.
etpu_set1\etpuc_gpio.c - The eTPU GPIO function.
etpu_set1\etpuc_ic.c - The eTPU IC function.
etpu_set1\etpuc_ppa.c - The eTPU PPA function.
etpu_set1\etpuc_pwm.c - The eTPU PWM function.
etpu_set1\etpuc_qom.c - The eTPU QOM function.
etpu_set1\etpuc_sm.c - The eTPU SM function.
etpu_set1\etpuc_spi.c - The eTPU SPI function.
etpu_set1\etpuc_test.c - The eTPU test function.
etpu_set1\etpuc_uart.c - The eTPU UART function.

CPU interface files
-------------------
etpu_set1\cpu\etpu_gpio_auto.h - GPIO function interface information.
etpu_set1\cpu\etpu_ic_auto.h - IC function interface information.
etpu_set1\cpu\etpu_ppa_auto.h - PPA function interface information.
etpu_set1\cpu\etpu_pwm_auto.h - PWM function interface information.
etpu_set1\cpu\etpu_qom_auto.h - QOM function interface information.
etpu_set1\cpu\etpu_sm_auto.h - SM function interface information.
etpu_set1\cpu\etpu_spi_auto.h - SPI function interface information.
etpu_set1\cpu\etpu_test_auto.h - test function interface information.
etpu_set1\cpu\etpu_uart_auto.h - UART function interface information.

HISTORY
-------
1.00 Files updated since release 0.81.
    etpu_set1.h 1.6: -Updated global error function to reduce code size.
	GPIO 1.2: -Added support for building function stand alone or in a set.
              -This includes using the global error function if avaialable.
              -Updated comments in auto generated file to include version number.
	GPIO 1.1: No changes to code, just updated for CVS and checked into CVS.
	PWM 1.5: -Fixed possible problem with comments in auto generated file.
	PWM 1.4: -Added standard support for building function stand alone or in a set.
             -Updated comments in auto generated file to include version number.
    PWM 1.3: -Added support for building function stand alone or in a set.
             -This includes using the global error function if avaialable.
             -Change PWM_flag to just Flag, since it is local to function.
             -Added comments about Flag parameter.
             -Updated comments in auto generated file to include version number.
    PWM 1.2: -Updated with new CVS log style comments.
    IC 1.4: -Added option for Link4 to use register passing. This require
               assembler with the current compiler.
    IC 1.3: -Fixed use of  global error function.
    IC 1.2: -Added support for building function stand alone or in a set.
            -This includes using the global error function if avaialable.
            -Updated comments in auto generated file to include version number.
    IC 1.1: -No changes to code, just updated for CVS and checked into CVS.
    PPA 1.2: -Add #defines for FM bits in API.
    PPA 1.1: -First version in CVS.
             -Added support for building function stand alone or in a set.
             -This includes using the global error function if avaialable.
             -Updated comments in auto generated file to include version number.
    UART 1.2: -Added support for building function stand alone or in a set.
              -This includes using the global error function if avaialable.
              -Updated comments in auto generated file to include version number.
    UART 1.1: -No changes to code, just updated for CVS and checked into CVS.
    QOM 1.3: -Fix for first match behaviour when the reference is in the past
    QOM 1.2: -Added support for building function stand alone or in a set.
             -This includes using the global error function if avaialable.
             -Updated comments in auto generated file to include version number.
             -Fixed comments for version 1.0.0.5 compiler.
    QOM 1.1: -No changes to code, just updated for CVS and checked into CVS.
    SM 1.3: -Optimization of 16-bit fractional multyp.
            -Update for 1.0.0.5 compiler.
            -Removed variables used to work around compiler issue.
    SM 1.2: -Added support for building function stand alone or in a set.
            -This includes using the global error function if avaialable.
            -Updated comments in auto generated file to include version number.
            -Updated to only use C style comments.
    SM 1.1: -No changes to code, just updated for CVS and checked into CVS.
    SPI 1.3: -Add labels to prevent 1.0.0.5 compiler over optimising
    SPI 1.2: -Added support for building function stand alone or in a set.
             -This includes using the global error function if avaialable.
             -Updated comments in auto generated file to include version number.
    SPI 1.1: -No changes to code, just updated for CVS and checked into CVS.
    test 1.2: -Added support for building function stand alone or in a set.
              -Updated comments in auto generated file to include version number.
    test 1.1: -No changes to code, just updated for CVS and checked into CVS.

0.81 -Added PPA function (version 0.2)
     -Updated PWM function to version 1.06.