readme.txt

redboot在Tensilica平台上的源码

        Tensilica RedBoot Source Package and Build Tools
        ================================================

This directory contains sources for RedBoot for the Xtensa processor
architecture, with specific support for the XTAV60 and XTAV200 boards.
This is based on ECOS version 1.3.1 with many updates made by Tensilica.
The sources do not fully support eCos; they only implement enough to
run RedBoot (based on eCos) on the boards supported.

The sources are as they exist in the RB-2007.2 release from Tensilica.

To actually build RedBoot, you will need a few things:

 o  The contents of this directory
 o  Tensilica Tools for the configured Tensilica core being targeted,
    preferably RB-2007.2 or later (open-source toolchains never tested
    and will not work without making a number of changes).
 o  A Linux host supported by Tensilica Tools (the scripts herein
    do not work with Windows)
 o  The RedBoot memory map overlay for the core (in the Tensilica Tools
    core package; the build-redboot script knows where to find it)
 o  Tcl (only version 8.4 has been tested)
 o  The ecosconfig program (usually you would build this yourself
    using eCos sources provided here; for convenience, a prebuilt
    executable that works on many Linux hosts is included here)

The contents of this directory are:

    README.txt				    The file you are reading.
    build-redboot                           The script that builds RedBoot.
    linux2.6-x86/ecosconfig                 The eCos config tool for linux.
    linux2.6-x86/libstdc++.so.6.0.3         Needed by ecosconfig on some hosts.
    linux2.6-x86/libstdc++.so.6             Symlink to libstdc++.so.6.0.3 .
    linux2.6-x86/run_ecosconfig             Wrapper for ecosconfig.
    redboot-src.tgz                         The source package.
    mlt_xtav60_dc232b.tar                   Memory map files for Diamond
                                            232L rev.B Standard core.

The steps to build RedBoot are, after unpacking the contents of this directory:

1. Verify the scripts and executables have execute permission. If not:
    $ chmod a+x build-redboot linux2.6-x86/*ecosconfig

2. Edit the build-redboot script to select the targeted board (if not XT-AV60).
   The script builds RedBoot for the XT-AV60 FPGA board (Avnet LX60) by 
   default.  If your core package targets a different board (such as XT-AV200),
   edit the script to set shell variable 'board' to the designator for
   that board (eg. xtav200). The comments in the script give the choices.

3. Run the script.
    $ ./build-redboot

If all goes well, resulting RedBoot binaries appear in ./build/install/bin/ .
Otherwise, you're pretty much on your own.

You may, of course, edit the script to change the locations of things.


Miscellaneous Notes
-------------------

The memory map overlay is a tarball containing files that describe the
memory map of the particular processor and board being targeted.
This overlay can be found in the Tensilica core package for the relevant
Xtensa or Diamond processor, but only if the core was built targeting
an xtav60 or xtav200 FPGA development board.  The overlay file path is
  <xtensa_root>/xtensa-elf/src/redboot/mlt_<board>_files.tar
where <xtensa_root> is the path to the installed Tensilica core package,
and <board> is either xtav60 or xtav200 (or xt2000 for older packages),
or "unknown" for cores not built while targeting a specific board.

Note: the RedBoot linker script overlay for the Diamond 232L Standard core
 is also present in this source package (see directory contents above).