Subversion Repositories openrisc_2011-10-31

                  OpenRISC Unified GNU Tool Chain Repository

                  ==========================================

This directory is where you will find all the source trees for the standard

GNU tool chain. The newlib library is included, since that is required for GCC

testing.

The structure mirrors that of the main Free Software Foundation repository.

Using a unified directory means that the entire tool chain can be built in a

single pass. The script "bld.sh" will build a unified source tree in the a

directory (default name "srcw") and then configure, build, check and install

all the tools using a separate build directory (default "bld-or32"). The

default install directory is "/opt/or32-elf-new").

Use "./bld.sh --help" to check the options available, which includes options

to change all the default directories, omit building newlib and to control

whichphases of the build process (linking, configuring, building, checking and

installing) are run.

By default the tests (which require DejaGnu to be installed) are *not* run.

Note in particular that the script requires a version of Or1ksim built from

SVN (not Or1ksim 0.4.0 release) and that the --or1ksim parameter should be

used to point to the directory where or1ksim is installed (default

/opt/or1ksim-new).

The current version builds GDB separately, because it is not compatible with

the libraries in binutils used in the unified build.

Apple OS X notes:

  * Install required libraries with MacPorts:

Some GNU libraries that are not supplied as standard with Apple's OS X must be

installed. They could be built and installed independently but the author found

the  MacPorts package management system a simple and easy way to install them.

First the MacPorts app must be installed. To install MacPorts follow the

instructions on the  project's page here:  http://www.macports.org

Once MacPorts is installed install the packages "gmp", "mpfr", and "dejagnu"

with the command:

$ sudo port install gmp mpfr dejagnu

  * Build environment variables:

Once the require libraries are installed, their location must be passed to the

compiler. The CPPFLAGS, CFLAGS and LFLAGS environment variables are used for

this. The standard place MacPorts places its installed libraries is /opt/local

so if this default location was used export the following flags before running

the bld.sh script:

$ export CPPFLAGS="-I/opt/local/include"

$ export CFLAGS="-L/opt/local/lib"

$ export LDFLAGS="-L/opt/local/lib"

The bld.sh script should then be OK to run as described above.

Any questions should be posted on the OpenRISC forum at

opencores.org/forum,OpenRISC, or discussed on IRC at freenode.net, channel

#opencores.

Jeremy Bennett

20 August 2010