/** * @page quickstart Quickstart Guide * @ingroup guide \section quickstart_windows Prerequisites for Windows
  1. Install Cygwin including DEVEL\\make
  2. Install current mspgcc toolchain
  3. Make sure, that cygwin\\bin and mspgcc\\bin directories are included in the PATH. If you see errors about duplicate cygwin dlls, ensure that Cygwin is in the path before msgpcc, then remove all cygwin*.dll files from the mspgcc\\bin directory.
     
  4. See System\\makefile.platform for some configuration variables that might need to be adjusted for your environment.
     
  5. Now you are ready to compile ScatterWeb
     
  6. To compile the html and rtf documentation you need to install doxygen and (for the relation graphs) graphviz. Doxygen needs to be added to the path. Then go to the ScatterWeb Documentation directory and type "make doc".
    Get Doxygen: http://www.doxygen.org
\section compile_mspgcc Compile Toolchain from Source

This section descripes how to compile the MSPGCC toolchain for Linux/Unix/Cygwin. Please download exactly the noted versions of the source packages as they have been tested. Other versions might or might not compile.

binutils (2.17)

The binutils are a collection of binary tools including ld (linker) and as (assembler).

$ wget ftp://sources.redhat.com/pub/binutils/releases/binutils-2.17.tar.bz2
$ tar xjvf binutils-2.17.tar.bz2
$ cd binutils-2.17
$ ./configure --target=msp430 --prefix=/usr/local/msp430
$ make
$ make install

gcc (3.2.3)

The GNU C Compiler has to be compiled with a gcc version of 3.3 or 3.4 (export CC=gcc-3.3 or export CC=gcc-3.4). Version 4.1 doesn't work but you might try a newer one ).

$ wget ftp://gcc.gnu.org/pub/gcc/releases/gcc-3.2.3/gcc-core-3.2.3.tar.bz2
$ tar xjvf gcc-core-3.2.3.tar.bz2
$ wget ftp://gcc.gnu.org/pub/gcc/releases/gcc-3.2.3/gcc-g++-3.2.3.tar.bz2
$ tar xjvf gcc-g++-3.2.3.tar.bz2
$ cvs -d:pserver:anonymous@mspgcc.cvs.sourceforge.net:/cvsroot/mspgcc login
$ cvs -z3 -d:pserver:anonymous@mspgcc.cvs.sourceforge.net:/cvsroot/mspgcc co gcc/gcc-3.3
$ cp -r gcc/gcc-3.3/* gcc-3.2.3/
$ cd gcc-3.2.3
$ ./configure --target=msp430 --prefix=/usr/local/msp430 --enable-languages=c
$ make
$ make install

msp430-libc

The GNU C library supports the ISO C and POSIX standards.

$ cvs -d:pserver:anonymous@mspgcc.cvs.sourceforge.net:/cvsroot/mspgcc login
$ cvs -z3 -d:pserver:anonymous@mspgcc.cvs.sourceforge.net:/cvsroot/mspgcc co msp430-libc
$ cd msp430-libc/src
$ make
$ make install

gdb (6.0)

The GNU Debugger is an optional component - compile with gcc version 3.

$ wget http://mirrors.redwire.net/pub/sources.redhat.com/gdb/old-releases/gdb-6.0.tar.bz2
$ tar xjvf gdb-6.0.tar.bz2
$ cvs -d:pserver:anonymous@mspgcc.cvs.sourceforge.net:/cvsroot/mspgcc login
$ cvs -z3 -d:pserver:anonymous@mspgcc.cvs.sourceforge.net:/cvsroot/mspgcc co gdb/gdb-current
$ cp -r gdb/gdb-current/* gdb-6.0/
$ cd gdb-6.0
$ ./configure --target=msp430 --prefix=/usr/local/msp430
$ make
$ make install

JTAG

In this section the Hardware Interface Library (HIL) is compiled.

$ cvs -d:pserver:anonymous@mspgcc.cvs.sourceforge.net:/cvsroot/mspgcc login
$ cvs -z3 -d:pserver:anonymous@mspgcc.cvs.sourceforge.net:/cvsroot/mspgcc co jtag
$ cd jtag/hardware_access
$ make
$ mv libHIL.so /usr/local/lib
$ ldconfig

gdbproxy

The gdbproxy and MSP430 library are needed for in circuit debugging - optional component.

$ wget http://www.soft-switch.org/downloads/mspgcc/msp430-gdbproxy
$ wget http://www.soft-switch.org/downloads/mspgcc/libMSP430.so
$ chmod +x msp430-gdbproxy
$ mv msp430-gdbproxy /usr/local/msp430/bin/
$ mv libMSP430.so /usr/local/lib/

\section quickstart_start Quick start

You can compile any application from the application's main directory by using the provided makefiles (more info).

\section quickstart_eclipse Using Eclipse IDE */