Updated README.
[fw/cortex-toolchain] / summon-arm-toolchain
index c8c29d54456a4c0d2306a0c59ddd3096b78a8dc0..f1ddff04fa21a80dcc6e93ee49873c8aafe77851 100755 (executable)
@@ -8,40 +8,98 @@
 # apt-get install flex bison libgmp3-dev libmpfr-dev libncurses5-dev \
 # libmpc-dev autoconf texinfo build-essential
 #
+# Or on Ubuntu Maverick give `apt-get build-dep gcc-4.5` a try.
+#
 
 # Stop if any command fails
 set -e
 
+##############################################################################
+# Settings section
+# You probably want to customize those
+##############################################################################
 TARGET=arm-none-eabi           # Or: TARGET=arm-elf
 PREFIX=${HOME}/arm-none-eabi   # Install location of your final toolchain
 PARALLEL=                      # Or: PARALLEL="-j 5" for 4 CPUs
 DARWIN_OPT_PATH=/opt/local     # Path in which MacPorts or Fink is installed
+# Set to 'sudo' if you need superuser privileges while installing
+SUDO=
+# Set to 1 to be quieter while running
+QUIET=0
+# Set to 1 to use linaro gcc instead of the FSF gcc
+USE_LINARO=0
+# Set to 1 to build libstm32 provided by ST
+LIBSTM32_EN=0
+# Set to 1 to build libopenstm32 an open source library for stm32
+LIBOPENSTM32_EN=0
+# Make the gcc default to Cortex-M3
+DEFAULT_TO_CORTEX_M3=0
+
+##############################################################################
+# Version and download url settings section
+##############################################################################
+if [ ${USE_LINARO} == 0 ] ; then
+       # For FSF GCC:
+       GCCVERSION=4.5.1
+       GCC=gcc-${GCCVERSION}
+       GCCURL=http://ftp.gnu.org/gnu/gcc/${GCC}/${GCC}.tar.gz
+else
+       # For the Linaro GCC:
+       GCCVERSION=4.5-2010.08-1
+       GCC=gcc-linaro-${GCCVERSION}
+       GCCURL=http://launchpad.net/gcc-linaro/4.5/${GCCVERSION}/+download/${GCC}.tar.gz
+fi
 
 BINUTILS=binutils-2.20
-GCC=gcc-4.5.1
 NEWLIB=newlib-1.18.0
 GDB=gdb-7.2
 LIBCMSIS=v1.10-2
 LIBSTM32=v3.0.0-1
 LIBSTM32USB=v3.0.1-1
 LIBOPENSTM32=master
-LIBSTM32_EN=0
-LIBOPENSTM32_EN=0
+
+##############################################################################
+# Flags section
+##############################################################################
+
+GDBFLAGS=
+BINUTILFLAGS=
+
+if [ ${DEFAULT_TO_CORTEX_M3} == 0 ] ; then
+       GCCFLAGS=
+else
+       # To default to the Cortex-M3:
+       GCCFLAGS="--with-arch=armv7-m --with-mode=thumb"
+fi
+
+# Pull in the local configuration, if any
+if [ -f local.sh ]; then
+    . ./local.sh
+fi
+
+MAKEFLAGS=${PARALLEL}
+TARFLAGS=v
+
+if [ ${QUIET} != 0 ]; then
+    TARFLAGS=
+    MAKEFLAGS="${MAKEFLAGS} -s"
+fi
+
+export PATH="${PREFIX}/bin:${PATH}"
 
 SUMMON_DIR=$(pwd)
 SOURCES=${SUMMON_DIR}/sources
 STAMPS=${SUMMON_DIR}/stamps
 
-export PATH="${PREFIX}/bin:${PATH}"
-
-GCCFLAGS=
-GDBFLAGS=
-BINUTILFLAGS=
+##############################################################################
+# Building section
+# You probably don't have to touch anything after this
+##############################################################################
 
 # Fetch a versioned file from a URL
 function fetch {
     if [ ! -e ${STAMPS}/$1.fetch ]; then
-        echo "Downloading $1 sources..."
+        log "Downloading $1 sources..."
         wget -c --no-passive-ftp $2
         touch ${STAMPS}/$1.fetch
     fi
@@ -56,8 +114,15 @@ function log {
 
 # Unpack an archive
 function unpack {
+    log Unpacking $*
     # Use 'auto' mode decompression.  Replace with a switch if tar doesn't support -a
-    tar xvaf $1
+    tar xaf${TARFLAGS} ${SOURCES}/$1.tar.*
+}
+
+# Install a build
+function install {
+    log $1
+    ${SUDO} make ${MAKEFLAGS} $2 $3 $4 $5 $6 $7 $8
 }
 
 case "$(uname)" in
@@ -83,13 +148,13 @@ mkdir -p ${STAMPS} ${SOURCES}
 cd ${SOURCES}
 
 fetch ${BINUTILS} http://ftp.gnu.org/gnu/binutils/${BINUTILS}.tar.bz2
-fetch ${GCC} ${GCC_URL}
+fetch ${GCC} ${GCCURL}
 fetch ${NEWLIB} ftp://sources.redhat.com/pub/newlib/${NEWLIB}.tar.gz
 fetch ${GDB} http://ftp.gnu.org/gnu/gdb/${GDB}.tar.bz2
 
 if [ ${LIBSTM32_EN} != 0 ]; then
 if [ ! -e libcmsis-${LIBCMSIS}.tar.bz2 ]; then
-       echo "Cloning libcmsis sources..."
+       log "Cloning libcmsis sources..."
        git clone git://git.open-bldc.org/libcmsis.git
         cd libcmsis
         git archive --format=tar --prefix=libcmsis-${LIBCMSIS}/ ${LIBCMSIS} | \
@@ -99,7 +164,7 @@ if [ ! -e libcmsis-${LIBCMSIS}.tar.bz2 ]; then
 fi
 
 if [ ! -e libstm32-${LIBSTM32}.tar.bz2 ]; then
-       echo "Cloning libstm32 sources..."
+       log "Cloning libstm32 sources..."
        git clone git://git.open-bldc.org/libstm32.git
         cd libstm32
         git archive --format=tar --prefix=libstm32-${LIBSTM32}/ ${LIBSTM32} | \
@@ -109,7 +174,7 @@ if [ ! -e libstm32-${LIBSTM32}.tar.bz2 ]; then
 fi
 
 if [ ! -e libstm32usb-${LIBSTM32USB}.tar.bz2 ]; then
-       echo "Cloning libstm32usb sources..."
+       log "Cloning libstm32usb sources..."
        git clone git://git.open-bldc.org/libstm32usb.git
         cd libstm32usb
         git archive --format=tar --prefix=libstm32usb-${LIBSTM32USB}/ ${LIBSTM32USB} | \
@@ -121,7 +186,7 @@ fi
 
 if [ ${LIBOPENSTM32_EN} != 0 ]; then
 if [ ! -e libopenstm32-${LIBOPENSTM32}.tar.bz2 ]; then
-       echo "Cloning libopenstm32 sources..."
+       log "Cloning libopenstm32 sources..."
        git clone git://libopenstm32.git.sourceforge.net/gitroot/libopenstm32/libopenstm32
         cd libopenstm32
         git archive --format=tar --prefix=libopenstm32-${LIBOPENSTM32}/ ${LIBOPENSTM32} | \
@@ -138,8 +203,7 @@ if [ ! -e build ]; then
 fi
 
 if [ ! -e ${STAMPS}/${BINUTILS}.build ]; then
-    log "Unpacking ${BINUTILS}"
-    unpack ${SOURCES}/${BINUTILS}.tar.bz2
+    unpack ${BINUTILS}
     cd build
     log "Configuring ${BINUTILS}"
     ../${BINUTILS}/configure --target=${TARGET} \
@@ -152,9 +216,8 @@ if [ ! -e ${STAMPS}/${BINUTILS}.build ]; then
                            --disable-werror \
                           ${BINUTILFLAGS}
     log "Building ${BINUTILS}"
-    make ${PARALLEL}
-    log "Installing ${BINUTILS}"
-    make install
+    make ${MAKEFLAGS}
+    install ${BINUTILS} install
     cd ..
     log "Cleaning up ${BINUTILS}"
     touch ${STAMPS}/${BINUTILS}.build
@@ -162,8 +225,7 @@ if [ ! -e ${STAMPS}/${BINUTILS}.build ]; then
 fi
 
 if [ ! -e ${STAMPS}/${GCC}-boot.build ]; then
-    log "Unpacking ${GCC}-boot"
-    unpack ${SOURCES}/${GCC}.tar.bz2
+    unpack ${GCC} boot
     cd build
     log "Configuring ${GCC}-boot"
     ../${GCC}/configure --target=${TARGET} \
@@ -180,9 +242,8 @@ if [ ! -e ${STAMPS}/${GCC}-boot.build ]; then
                       --disable-werror \
                      ${GCCFLAGS}
     log "Building ${GCC}-boot"
-    make ${PARALLEL} all-gcc
-    log "Installing ${GCC}-boot"
-    make install-gcc
+    make ${MAKEFLAGS} all-gcc
+    install ${GCC}-boot install-gcc
     cd ..
     log "Cleaning up ${GCC}-boot"
     touch ${STAMPS}/${GCC}-boot.build
@@ -190,8 +251,7 @@ if [ ! -e ${STAMPS}/${GCC}-boot.build ]; then
 fi
 
 if [ ! -e ${STAMPS}/${NEWLIB}.build ]; then
-    log "Unpacking ${NEWLIB}"
-    unpack ${SOURCES}/${NEWLIB}.tar.gz
+    unpack ${NEWLIB}
     cd build
     log "Configuring ${NEWLIB}"
     ../${NEWLIB}/configure --target=${TARGET} \
@@ -204,9 +264,8 @@ if [ ! -e ${STAMPS}/${NEWLIB}.build ]; then
                          --disable-werror \
                          --disable-newlib-supplied-syscalls
     log "Building ${NEWLIB}"
-    make ${PARALLEL}
-    log "Installing ${NEWLIB}"
-    make install
+    make ${MAKEFLAGS}
+    install ${NEWLIB} install
     cd ..
     log "Cleaning up ${NEWLIB}"
     touch ${STAMPS}/${NEWLIB}.build
@@ -215,8 +274,7 @@ fi
 
 # Yes, you need to build gcc again!
 if [ ! -e ${STAMPS}/${GCC}.build ]; then
-    log "Unpacking ${GCC}"
-    unpack ${SOURCES}/${GCC}.tar.bz2
+    unpack ${GCC}
     cd build
     log "Configuring ${GCC}"
     ../${GCC}/configure --target=${TARGET} \
@@ -232,9 +290,8 @@ if [ ! -e ${STAMPS}/${GCC}.build ]; then
                       --disable-werror \
                     ${GCCFLAGS}
     log "Building ${GCC}"
-    make ${PARALLEL}
-    log "Installing ${GCC}"
-    make install
+    make ${MAKEFLAGS}
+    install ${GCC} install
     cd ..
     log "Cleaning up ${GCC}"
     touch ${STAMPS}/${GCC}.build
@@ -242,8 +299,7 @@ if [ ! -e ${STAMPS}/${GCC}.build ]; then
 fi
 
 if [ ! -e ${STAMPS}/${GDB}.build ]; then
-    log "Unpacking ${GDB}"
-    unpack ${SOURCES}/${GDB}.tar.bz2
+    unpack ${GDB}
     cd build
     log "Configuring ${GDB}"
     ../${GDB}/configure --target=${TARGET} \
@@ -253,9 +309,8 @@ if [ ! -e ${STAMPS}/${GDB}.build ]; then
                       --disable-werror \
                      ${GDBFLAGS}
     log "Building ${GDB}"
-    make ${PARALLEL}
-    log "Installing ${GDB}"
-    make install
+    make ${MAKEFLAGS}
+    install ${GDB} install
     cd ..
     log "Cleaning up ${GDB}"
     touch ${STAMPS}/${GDB}.build
@@ -264,13 +319,11 @@ fi
 
 if [ ${LIBSTM32_EN} != 0 ]; then
 if [ ! -e .libcmsis-${LIBCMSIS}.build ]; then
-    log "Unpacking libcmsis-${LIBCMSIS}"
-    unpack ${SOURCES}/libcmsis-${LIBCMSIS}.tar.bz2
+    unpack libcmsis-${LIBCMSIS}
     cd libcmsis-${LIBCMSIS}
     log "Building libcmsis-${LIBCMSIS}"
     make arch_prefix=${TARGET} prefix=${PREFIX}
-    log "Installing libcmsis-${LIBCMSIS}"
-    make arch_prefix=${TARGET} prefix=${PREFIX} install
+    install libcmsis-${LIBCMSIS} arch_prefix=${TARGET} prefix=${PREFIX} install
     cd ..
     log "Cleaning up libcmsis-${LIBCMSIS}"
     touch .libcmsis-${LIBCMSIS}.build
@@ -278,13 +331,11 @@ if [ ! -e .libcmsis-${LIBCMSIS}.build ]; then
 fi
 
 if [ ! -e .libstm32-${LIBSTM32}.build ]; then
-    log "Unpacking libstm32-${LIBSTM32}"
-    unpack ${SOURCES}/libstm32-${LIBSTM32}.tar.bz2
+    unpack libstm32-${LIBSTM32}
     cd libstm32-${LIBSTM32}
     log "Building libstm32-${LIBSTM32}"
     make arch_prefix=${TARGET} prefix=${PREFIX}
-    log "Installing libstm32-${LIBSTM32}"
-    make arch_prefix=${TARGET} prefix=${PREFIX} install
+    install libstm32-${LIBSTM32} arch_prefix=${TARGET} prefix=${PREFIX} install
     cd ..
     log "Cleaning up libstm32-${LIBSTM32}"
     touch .libstm32-${LIBSTM32}.build
@@ -292,13 +343,11 @@ if [ ! -e .libstm32-${LIBSTM32}.build ]; then
 fi
 
 if [ ! -e .libstm32usb-${LIBSTM32USB}.build ]; then
-    log "Unpacking libstm32usb-${LIBSTM32USB}"
-    unpack ${SOURCES}/libstm32usb-${LIBSTM32USB}.tar.bz2
+    unpack libstm32usb-${LIBSTM32USB}
     cd libstm32usb-${LIBSTM32USB}
     log "Building libstm32usb-${LIBSTM32USB}"
     make arch_prefix=${TARGET} prefix=${PREFIX}
-    log "Installing libstm32usb-${LIBSTM32USB}"
-    make arch_prefix=${TARGET} prefix=${PREFIX} install
+    install libstm32usb-${LIBSTM32USB} arch_prefix=${TARGET} prefix=${PREFIX} install
     cd ..
     log "Cleaning up libstm32usb-${LIBSTM32USB}"
     touch .libstm32usb-${LIBSTM32USB}.build
@@ -307,13 +356,11 @@ fi
 fi
 
 if [ $LIBOPENSTM32_EN != 0 ]; then
-    log "Unpacking libopenstm32-${LIBOPENSTM32}"
-    unpack ${SOURCES}/libopenstm32-${LIBOPENSTM32}.tar.bz2
+    unpack libopenstm32-${LIBOPENSTM32}
     cd libopenstm32-${LIBOPENSTM32}
     log "Building libopenstm32-${LIBOPENSTM32}"
     make PREFIX=${TARGET} DESTDIR=${PREFIX}
-    log "Installing libopenstm32-${LIBOPENSTM32}"
-    make PREFIX=${TARGET} DESTDIR=${PREFIX} install
+    install libopenstm32-${LIBOPENSTM32} PREFIX=${TARGET} DESTDIR=${PREFIX} install
     cd ..
     log "Cleaning up libopenstm32-${LIBOPENSTM32}"
     touch .libopenstm32-${LIBOPENSTM32}.build