Quelltext der Seite MSPGCC

MSPGCC ist ein kostenloser, unbeschränkter [[C]]-[[Compiler]] für die [[MSP430]]-[[Mikrocontroller]] von [[TI]]. Die Portierung auf MSP430 wurde von Chris Liechti und Dmitry Diky durchgeführt.

== Dokumentation ==

* [http://mspgcc.sourceforge.net/manual/ MSPGCC Manual]
* [http://mspgcc.sourceforge.net/faq/ FAQ]

== Windows-Version ==

* [http://sourceforge.net/project/showfiles.php?group_id=42303&package_id=68584 MSPGCC Komplettpaket]
* [[MSP430_eclipse_helios_mspgcc4_gdb-proxy|Anleitung mit Eclipse 3.6 Helios via mspgcc4 compilieren und debuggen]] (06/2010)
* [http://www.mikrocontroller.net/articles/Eclipse_und_MSPGCC_unter_Windows Eclipse und MSPGCC unter Windows] (03/2009)
<!-- * [http://matthias-hartmann.blogspot.com/ Use Eclipse and mspgcc - the easy way] (Windows 02/2009). (offline) -->
* [http://www.mikrocontroller.net/Eclipse%20und%20MSPGCC/ ausführliche Anleitung zur Verwendung von Eclipse mit MSPGCC unter Windows] (03/2006)

== Installationsanleitung für Unix/Linux/Cygwin ==
man kann nach wie vor Schritt für Schritt über die Kommandozeile gehen:

<pre>
  $ su
 
  $ mkdir /tmp/mspgcc
  $ cd /tmp/mspgcc

</pre>
 
Oder die Installationsanleitung im MSPGCC-Wiki nutzen:
[http://sourceforge.net/apps/mediawiki/mspgcc/index.php?title=Linux_installation#Get_the_Sources_and_build_the_Package]

Dabei gibt es zwei Fallstricke:

1.: Das Beispiel geht davon aus, dass GCC 3.4 installiert ist. Diese Version ist relativ alt und behandelt Compilerwarnungen etwas nachsichtiger. Wer eine neuere oder andere Version von GCC installiert hat, muss das im Make-Aufruf

<pre>
 cvs -d:pserver:anonymous@mspgcc.cvs.sourceforge.net:/cvsroot/mspgcc login
 cvs -z3 -d:pserver:anonymous@mspgcc.cvs.sourceforge.net:/cvsroot/mspgcc co -P .
 cd packaging
 make folders
 CC=gcc-3.4 make build
</pre>

vorangestellte "CC=gcc-3.4" auf die installierte GCC-Version abändern, z.&nbsp;B. "CC=gcc-4.4". Tut man das nicht, wird der vorhandene GCC-Compiler nicht gefunden und make liefert Fehler 77 zurück (Compiler kann keine ausführbare Dateien erstellen).

2.: Das verlinkte Package lädt sich (eventuell nur im Moment, 7.2.2010) die binutils-2.18 per Ftp herunter. Einige der Quelldateien produzieren bei GCC Versionen ab 4.X Warnungen, die durch den Compilerschalter -Werror als Fehler behandelt und zum Abbruch des Compiliervorgangs führen.
Workaround: in der Datei /packaging/build/binutils-2.18/binutils/Makefile die Zeile
<pre>
CFLAGS = -g -O2
</pre>
auf 
<pre>
CFLAGS = -g -O2 -Wno-error
</pre>
erweitern.

Oder binutils-2.19 von Hand kompilieren und installieren, auch hier auf passende Angabe der GCC-Version achten.
[http://sourceforge.net/apps/mediawiki/mspgcc/index.php?title=Building_MSPGCC_from_Source_Code]
Achtung: in der aktuellen Version heißt die benötigte Datei /package/patches/binutils-2.19.patch irrtümlicherweise binutils-2.19'''-'''patch (mit bindestrich statt Punkt).

=== binutils ===

<pre>
  $ 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 --prefix=/usr/local/msp430 --target=msp430
  $ make
  $ make install
  $ cd ..
 
  $ export PATH=/usr/local/msp430/bin:$PATH
</pre>

Hinweis: Das Kommando wget setzt einen Internetzugang voraus.

Hinweis2:<br> Die Version 2.14 enthält nicht alle Controllertypen. So fehlen zum Beispiel die Typen MSP430F1611 und MSP430F1612.<br>
Bei Version 2.17 kann es zu fehlerhaften binarys kommen (Fehler: test.elf has no bss section)<br>
Mit der Version 2.16.1 sollte alles funktionieren.

Hinweis3:<br>Ich versuche es mit 2.19.1, wenn ich auf Fehler stosse, dann berichte ich davon..

=== gcc ===
'''Achtung:''' MSPGCC kompiliert nicht gcc-4.1. Abhilfe schafft es zu Beginn (oder vor configure) den Befehl "export CC=gcc-3.3" bzw. "export CC=gcc-3.4" aufzurufen. Auch ist darauf zu achten die Dateien gcc-core-3.2.3 und gcc-g++.tar.bz2 und nicht etwa gcc-3.2.3 runterzuladen. 
<pre>
  $ wget ftp://gcc.gnu.org/pub/gcc/releases/gcc-3.2.3/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-core-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 --prefix=/usr/local/msp430 --target=msp430 --enable-languages=c,c++
  $ make
  $ make install
  $ cd ..
</pre>

=== msp430-libc ===

<pre>
  $ 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
  $ cd ../..
</pre>

=== gdb ===

<pre>
  $ 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 --prefix=/usr/local/msp430 --target=msp430
  $ make
  $ make install
  $ cd ..
</pre>

Achtung: Der GDB kann nicht mit GCC 4.x übersetzt werden. Wenn dieser auf dem System standardmäßig installiert ist, kann man z.&nbsp;B. den GCC 3.4 zusätzlich installieren und dann vor der ./configure- Zeile

<pre>
  $ export CC=gcc-3.4
</pre>

einfügen.

Hinweis: Bei Ubuntu (evtl auch bei anderen Distributionen) sind die Entwicklerdateien für die Library libtermcap im Paket libncurses5-dev

=== JTAG ===

<pre>
  $ 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
</pre>

Wer ein 64-Bit-Linux verwendet, muss im makefile die CFLAGS und die LNOPTS um ein -m32 ergänzen. Das sollte dann so aussehen:

<pre>
    CFLAGS  += -fPIC -m32
    LNOPTS   = -fPIC -shared -m32
</pre>

Weiter geht's:

<pre>
  $ make
  $ mv libHIL.so /usr/local/lib
  $ ldconfig
  $ cd ../..
</pre>

=== gdbproxy ===

Den msp430-gdbproxy und libMSP430.so von http://www.soft-switch.org/downloads/mspgcc herunterladen. Danach

<pre>
  $ chmod +x msp430-gdbproxy
  $ mv msp430-gdbproxy /usr/local/msp430/bin/
  $ mv libMSP430.so /usr/local/lib/
</pre>

ausführen.

=== Installations-Skript ===

Für Installation/Update gibt es hier ein bash-Skript, das nach dem Starten (und einmal Return zum Downloaden der Sourcen aus dem CVS) das Installieren automatisch erledigt.

Eingebaut sind auch die Anpassungen von ~/.profile und ~/.gdbinit, so dass man sofort loslegen und auch debuggen kann.

* [http://www.true-random.com/files/mspgcc/build_mspgcc.sh Installations-Skript]

Dieses Script ist jedoch relativ veraltet. Daher ist es schneller obige Anleitung per Copy'n'Paste in eine Shell zu übernehmen, als das Script zu verwenden. 

=== Gentoo Ebuilds ===

Für Gentoo-Benutzer gibt es an der [http://pi4.informatik.uni-mannheim.de/pi4.data/content/projects/msp430/ Uni Mannheim] Ebuilds zum Download.

Diese Ebuilds haben bei mir aufgrund von Datei Kollisionen nicht funktioniert.
<pre>
 * Detected file collision(s):
 * 
 *      /usr/share/info/standards.info.bz2
 *      /usr/share/locale/de/LC_MESSAGES/opcodes.mo
</pre>
Mit der Anleitung von diesem [https://github.com/radhermit/msp430-overlay Overlay] hat es dann funktioniert.

=== .gdbinit ===

Um das JTAG-Interface schneller zu machen kann man in ~/.gdbinit diese Werte eintragen:

 set remoteaddresssize 16
 set remotetimeout 999999
 set download-write-size 512
 target remote localhost:2000
 set remote memory-write-packet-size 512
 set remote memory-write-packet-size fixed
 set remote memory-read-packet-size 512
 set remote memory-read-packet-size fixed

Und vor dem Debuggen von Programmen auf dem Rechner (nicht MSP430) sollte man ~/.gdbinit umbenennen, beispielsweise in ~/.gdbinit_msp430.

== Mac OS X ==

Um msp430-gcc unter Mac OS X (Intel) kompilieren zu können, 
gcc-3.2.3/gcc/config.gcc wie folgt aendern:

Von
<pre>
 i[34567]86-*-freebsd[12] | i[34567]86-*-freebsd[12].* | i[34567]86-*-freebsd*aout* )
</pre>

auf:
<pre>
 i[34567]86-*-freebsd[12] | i[34567]86-*-freebsd[12].* | i[34567]86-*-freebsd*aout* | i[34567]86-apple-darwin8* )
</pre>

Ansonsten die Anleitung für Linux befolgen.

== Einfaches C-Beispielprogramm ==

=== Sourcecode ===

<c>
 #include <io.h>

 void wait(void);         /* prototype for wait()      */

 int
 main(void)
 { /* main function, called by startup-code */
   P1DIR = 0xFF;          /* port 1 = output           */
   P1OUT = 0x01;          /* set bit 0 in port 1       */

   for(;;)
   { /* infinite loop */
     P1OUT = ~P1OUT;      /* invert port 1             */
     wait();              /* call delay function       */
   }
 }

 void
 wait(void)
 { /* simple delay function */
   volatile int i;        /* declare i as volatile int */
   for(i = 0; i < 32000; i++)
   ;                      /* repeat 32000 times (nop)  */
 }
</c>

=== Sourcecode für msp430x1121 kompilieren ===

  $ msp430-gcc -Os -mmcu=msp430x1121 -o test.elf test.c

=== Sourcecode für msp430x1121 kompilieren, wenn math.h includiert wird ===

  msp430-gcc -Os -mmcu=msp430x1121 -o test.elf test.c -lm

Wichtig ist hierbei -lm als letzte Option.

=== Assemblerlisting erzeugen (optional) ===

  $ msp430-objdump -DS test.elf > test.lst

=== Hex-Datei erzeugen ===

  $ msp430-objcopy -O ihex test.elf test.hex

Die Hex-Datei kann man mit C-Spy (im Kickstart-Paket enthalten) über das JTAG-Interface in den Controller programmieren. Nach einem Klick auf "Go" läuft das Programm los. Wenn 2 LEDs an P1.0 und P1.1 angeschlossen sind, sollten sie nun blinken.

== Einfaches Assembler-Beispielprogramm ==

In [https://gist.github.com/1303030 MSP430 - skeleton standalone assembler project for msp430-gcc and mspdebug] ist eine ausführliche Anleitung, wie man mit mspgcc Assemblerprogramme übersetzt und linkt. 

Statt ''msp430-gdbproxy'' wird dort allerdings das modernere [http://mspdebug.sourceforge.net/ MSPDebug] verwendet. Mit MinGW vorkompilierte Windows-Versionen von MSPDebug gibt es von [http://old.nabble.com/Re%3A-Confused-about-MSPGCC---MSPDEBUG...-p32885688.html Wayne] (0.17) und [http://develissimo.com/forum/topic/18188/?page=1#post-47990 Matthias] (0.18). Die Installation unter Windows ist in der [http://mspdebug.sourceforge.net/faq.html#launchpad_windows MSPDebug FAQ] beschrieben.

== Weitere Beispielprogramme ==

Für MSPGCC sind umfangreiche Beispielprogramme ([[LCD]]-Ansteuerung, TCP/IP, ...) verfügbar, außerdem wurden alle TI-Appnotes (C und Assembler) von Steve Underwood für MSPGCC angepasst.

* [http://mspgcc.cvs.sourceforge.net/mspgcc/examples/ MSPGCC Beispiele & Appnotes]

== In-System-Debugging mit GDB/Insight und dem Flash Emulation Tool (FET) ==

Wie bei anderen MSP430-Compilern ist es möglich mspgcc-Programme direkt in der Schaltung zu debuggen. Alles was man dazu braucht, ist ein JTAG-Adapter, msp430-gdbproxy, und gdb (im aktuellen Windows-Paket bereits enthalten).

Um ein Programm mit GDB/Insight debuggen zu können, muss man die Option "-g" an den mspgcc-Aufruf anhängen:

  $ msp430-gcc -mmcu=msp430x123 -g -Os -o test.elf test.c

Damit erhält man die Datei "test.elf".

=== gdbproxy starten ===

Der nächste Schritt ist das Programm gdbproxy zu starten, das für die Kommunikation zwischen GDB und dem FET zuständig ist:

  $ msp430-gdbproxy --port=2000 msp430

Wenn das FET richtig an den Parallelport angeschlossen ist, sollte ungefähr der folgende Text angezeigt werden:

 info:      msp430: Target device is a 'MSP430F12x' (type 11)
 notice:    msp430-gdbproxy: waiting on TCP port 2000

Hinweis: Falls /dev/parport0 nicht existiert, was sich so äußert:
 open: No such file or directory
 error:     msp430: Could not initialize device interface (1)
...als root ...
 mknod /dev/parport0 c 99 0 
...eingeben.

Hinweis: Bei udev im neuen Linuxkernel ab 2.6.x wird das Device /dev/parport0 nicht automatisch angelegt und man muss jedesmal neu den Aufruf mit mknod machen. Abhilfe schafft hier der Eintrag in der /etc/modules:
ppdev

Beim nächsten Booten dürfte der RAW-Parallelport vorhanden sein.

=== Insight benutzen (Windows) ===

Nachdem Insight gestartet ist (c:\msp430\bin\msp430-gdb.exe), klicke auf "File->Open" und wähle die elf-Datei (z.&nbsp;B. "test.elf") aus, die du debuggen möchtest.

Klicke dann auf "Run->Connect to target" und stelle folgendes ein:

  Target:                    "Remote/TCP"
  Hostname:                  "localhost"
  Port:                      "2000"
  Set breakpoint at 'main':  yes
  Set breakpoint at 'exit':  yes
  Attach to target:          yes
  Download Program:          yes
  Command  after attaching:  "monitor erase all" (ACHTUNG: Optional, damit wird der gesamte Flash-Inhalt gelöscht!)
  Run Method:                Continue from last Stop

Wenn man auf "Ok" klickt, sollte Insight berichten, dass die Verbindung erfolgreich aufgenommen wurde, und gdbproxy sollte melden:

  "notice: msp430-gdbproxy: connected".

Um den Debugging-Vorgang zu starten, klicke auf "Run" oder drücke einfach die Taste "r". Wenn alles geklappt hat, sollte nun der Sourcecode des Programmes angezeigt werden und die erste Zeile von main() grün markiert sein. Der rote Punkt ist der Breakpoint, der von Insight automatisch gesetzt wurde. Um selber Breakpoints zu setzen oder zu löschen, klicke auf den Strich '-' am Anfang der Zeile.

Jetzt kann man mit 'c' (continue) das Programm am nächsten Breakpoint fortsetzen, die Zeilen mit 's' (step) der Reihe nach ausführen, oder einzelne Assemblerbefehle ausführen... aber Vorsicht mit "finish": Anscheinend hängt sich Insight manchmal bei diesem Befehl auf. Wenn man also eine Funktion beenden will, ist es wohl besser, einen Breakpoint auf das Ende der Funktion zu setzen und "continue" zu verwenden.

=== DDD benutzen (Unix/Linux) ===

Leider läuft Insight nicht besonders stabil und ist auch etwas umständlich zu bedienen. Wer Unix bzw. Linux verwendet, der ist deshalb mit DDD (http://www.gnu.org/software/ddd/) besser bedient. Um DDD zu verwenden braucht man msp430-gdbproxy und die Kommandozeilen-Version von GDB (msp430-gdb).

Zuerst stellt man wie unter Windows über gdbproxy eine Verbindung zum JTAG-Adapter her. Wenn das funktioniert hat, kann man DDD starten. Als Parameter wird der zu verwendende Debugger (msp430-gdb) und die zu ladende ELF-Datei (test.elf) übergeben:

  $ ddd --debugger msp430-gdb test.elf

Zunächst sollte man nun unter "Commands / Edit Buttons" ein paar Buttons anlegen, indem man die folgenden Zeilen in das Textfeld bei "Console Buttons" einfügt:

  target remote localhost:2000     // Connect
  monitor erase all                // Erase
  load                             // Load
  monitor reset                    // Reset

Um jetzt die Verbindung zum gdbproxy herzustellen muss man nur auf "Connect" klicken, danach auf "Erase" um den Flash-Speicher des Controllers zu löschen, und schließlich auf "Load", damit das Programm in den Controller geladen wird. Mit "Reset" kann man einen Reset auslösen (wer hätte das gedacht?).

Wichtig: Nachdem einige breakpoints gesetzt sind, das Programm nicht mit "run" ausführen! Dass "run" Kommando wird benutzt um Programme auf dem lokalen Rechner zu starten. Für eingebettete Systeme ist das korrekte Kommando "continue" (siehe http://mspgcc.sourceforge.net/manual/x1602.html).

=== GDB Scripts ===

Hier eine kleine Ansammlung von Scripts, um download und reset via GDB etwas zu vereinfachen:

[[Media:Gdb_scripts_win.zip]]

[[Kategorie:MSP430]]