/** * @page quickstart Quickstart Guide * @ingroup guide \section quickstart_windows Prerequisites for Windows

1. Install Cygwin including DEVEL\\make
   - GNU MAKE \>= 3.81 is needed (to check type: make -v)
   - Get CYGWIN: http://www.cygwin.com
2. Install current mspgcc toolchain
   - Get MSPGCC: http://mspgcc.sourceforge.net/
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).

- Go to `Applications\\[Empty]` for a start.
- For a list of available build targets type "make help"
- To compile the application type "make"
- To flash and run an application type "make flash" or "make flashusb" depending on your jtag hardware.

\section quickstart_eclipse Using Eclipse IDE

- Get Eclipse IDE for C/C++ Developers (or Eclipse + CDT Plug-In) from http://www.eclipse.org/downloads/
- Get Subversion Plug-In (Subclipse) http://subclipse.tigris.org/
- Import the projects from the library and applications main directories into your workspace.

*/