=================================================================================
        How to Install GNU Tool Suite for NaviEngine

        Copyright (C) 2009 T-Engine Forum. All Rights Reserved.
    -------------------------------------------------------------------------
        Version: 1.00.00
        Released by T-Engine Forum (http://www.t-engine.org) on 2009/02/25.
=================================================================================

1. Preface
2. Caveats
3. How to Install

-----------------------------------------------------------------------------------------------------------------------
1. Preface
-----------------------------------------------------------------------------------------------------------------------

This note explains how to install the GNU Tool Suite used to compile T-Kernel for NaviEngine. By using this tool to compile the T-Kernel reference code distributed from the T-Engine Forum, a T-Kernel binary that is executable by NaviEngine can be created. 


-----------------------------------------------------------------------------------------------------------------------
2. Caveats
-----------------------------------------------------------------------------------------------------------------------

It is assumed that this GNU Tool Suite will be used only to create executable T-Kernels by NaviEngine only and will not be used for any other purposes. 
The T-Engine Forum does not support this tool.


-----------------------------------------------------------------------------------------------------------------------
3. How to Install the GNU Tool Suite
-----------------------------------------------------------------------------------------------------------------------

3.1 Installation of Cygwin(TM)

This GNU Tool Suite runs on the Cygwin(TM), the UNIX Emulator for Windows(R). Refer to Cygwin website (http://www.cygwin.com/) for instructions on how to install Cygwin. 
The packages below, in addition to the ones selected by default, are necessary for installation.
    EDevel category: "gcc", "make"
    EInterpreters category: "perl"
    ELibs category: "libgmp-devel", "libmpfr-devel"
    EUtils category: "file", "patch"

After installation, start Cygwin and create symbolic links. 
    $ ln -s make /usr/bin/gmake
    $ ln -s /usr/bin/perl /usr/local/bin/perl


3.2 Installation of the GNU Tool Suite

    --------------------------------------------------------------------------------------------------------
    Note:
If there is already a file under the /usr/local/te/arm11mpcore, change the directory name in advance so that the file is not accidently overwritten by installing this tool.
    --------------------------------------------------------------------------------------------------------

(1) Installation of the GNU Tool Suite

The GNU Tool Suite is installed under /usr/local/te/arm11mpcore when the archive file (devenv_arm11mpcore.tar.gz) downloaded from the website is copied and expanded in /usr/local/te directory.
    $ cd /usr/local/te
    $ tar zxf devenv_arm11mpcore.tar.gz

(2) Setting Environment Variables

To set the environment variables, enter the following commands. 
    $ export GNUs=/usr
    $ export GNU_BD=/usr/local/te/arm11mpcore
    $ export GNUarm=$GNU_BD/arm-elf
    $ export GCC_EXEC_PREFIX=$GNU_BD/lib/gcc/
    $ export PATH=$GNU_BD/bin:$PATH

When Cygwin is restarted, the environment variables must be reset. You can write the above command sequence in ".bashrc" file to omit retyping the commands when cygwin is restarted.


This finishes the installation.