View source for MSP430F5529 Launchpad


== What it is ==
[http://processors.wiki.ti.com/index.php/MSP430F5529_LaunchPad Official webpage]

== Linux command-line flashing tools ==
=== Introduction ===
To program the device, one can use [http://energia.nu/ Energia], [http://www.ti.com/tool/ccstudio-msp430 Code Composer Studio] or some other integrated IDE. We would like to avoid using such IDEs, thus we need to make the flashing and compilation work from the command-line.

The following ''notes'' describe the process of building tools required for flashing on Ubuntu 13.10, x86_64 system. Readers discretion is advised.

=== First steps ===
To be able to flash the msp430f5529 present on the Launchpad, it is necessary to compile the <tt>mspdebug</tt> and the ''so called'' <tt>msp430.DLLv3</tt> library (including <tt>hidapi</tt>).

The <tt>msp430.DLLv3</tt> library provided by the TI is not only used to communicate with the [http://processors.wiki.ti.com/index.php/EZ-FET_lite programmer] present on the board, but also to upgrade the firmware inside the [http://processors.wiki.ti.com/index.php/EZ-FET_lite programmer].

More info:
[http://mspdebug.sourceforge.net/tilib.html]
[http://forum.43oh.com/topic/4419-ms430f5529-launchpad-does-not-enumerate-after-allow-fw-update/?p=39870]
[http://michael-rushanan.blogspot.cz/2013/07/ubuntu-1304-my-experience-with-mspdebug.html]

The first step is to install necessary libraries and compilers (for later use).
<pre>
sudo apt-get install gcc-msp430 gdb-msp430 msp430-libc msp430mcu
sudo apt-get install libboost-all-dev
sudo apt-get install libusb-dev libreadline-dev libusb-1.0-0-dev libudev-dev
</pre>

=== MSP430.DLLv3 ===
[http://processors.wiki.ti.com/index.php/MSP_Debug_Stack MSP_Debug_Stack]
[http://processors.wiki.ti.com/index.php/MSPDS_Open_Source_Package MSPDS_Open_Source_Package]
[http://mspdebug.sourceforge.net/tilib.html mspdebug.sourceforge.net/tilib.html]

<pre>
wget http://www-s.ti.com/sc/techzip/slac460.zip

unzip slac460.zip
cd MSPDebugStack_OS_Package/
# read README-BUILD.txt
</pre>

Jump to the section describing <tt>hidapi</tt> compilation. Compile it, copy to the <tt>ThirdParty</tt> folder and continue ...

<pre>
make
</pre>

If there is an error saying "FILE" does not correspond to any known datatype, open the file causing the error and add line
<pre>
#include <stdio.h>
</pre>

Either copy the freshly compiled library to <tt>/usr/local/lib</tt> or always call <tt>export LD_LIBRARY_PATH= ... </tt> before running <tt>mspdebug</tt>

=== Hidapi ===
<pre>
sudo apt-get install libudev-dev libusb-1.0-0-dev libfox-1.6-dev
sudo apt-get install autotools-dev autoconf automake libtool
git clone git://github.com/signal11/hidapi.git

cd hidapi
git checkout hidapi-0.7.0 #This particular version is required for 'MSP430.DLLv3.3.1.4 Open Source version -- Released 10/02/2013'
cd linux
</pre>

modify Makefile

<pre>
diff --git a/linux/Makefile b/linux/Makefile
index 338bbd3..f88344b 100644
--- a/linux/Makefile
+++ b/linux/Makefile
@@ -9,15 +9,15 @@
 all: hidtest
 
 CC       ?= gcc
-CFLAGS   ?= -Wall -g
+CFLAGS   ?= -Wall -g -fPIC
 
 CXX      ?= g++
-CXXFLAGS ?= -Wall -g
+CXXFLAGS ?= -Wall -g -fPIC
 
 COBJS     = hid-libusb.o
 CPPOBJS   = ../hidtest/hidtest.o
 OBJS      = $(COBJS) $(CPPOBJS)
-LIBS      = `pkg-config libusb-1.0 libudev --libs`
+LIBS      = `pkg-config libusb-1.0 libudev --libs` -lpthread
 INCLUDES ?= -I../hidapi `pkg-config libusb-1.0 --cflags`
</pre>

Continue ...

<pre>
make
copy hid-libusb.o to MSPDebugStack_OS_Package/Thirdparty/lib
     and hiapi.h to MSPDebugStack_OS_Package/Thirdparty/include
</pre>

=== mspdebug ===
<pre>
git clone git://git.code.sf.net/p/mspdebug/code mspdebug

make

make install
</pre>

Using the mspdebug

<pre>
vim /etc/group #Add user to dialout

mspdebug tilib -d /dev/ttyACM0 --allow-fw-update

# if there is no ttyACM, you can use something like
mspdebug -U 0451:2046 tilib

# Flash a binary to the MCU
mspdebug tilib "prog main.elf"
</pre>