TI EZ430 in Linux with IAR Kickstart

by Travis Goodspeed [travis at utk.edu]
at the Extreme Measurement Communications Center
of the Oak Ridge National Laboratory


What follows are instructions for running the free version of IAR's C compiler for the MSP430 with Texas Instruments' EZ430 development tool in Linux under Wine. This will not work for Mac OS X until msp430-gdbproxy is made available for that platform. Also, this might not work with the full version of the compiler.

These instructions assume that you've installed wine, mspgcc, and msp430-gdbproxy. The assumption is also made that you've purchased the EZ430-F2013 development tool from Texas Instruments.

IAR Embedded Workbench

First, download slac050q.zip from the EZ430-F2013 page. Unzip it to get FET_R510.exe. Running wine FET_R510.exe installs the compiler to your C: drive under wine.



Next, you must find the executable and run it.

karen% find ~/.wine/drive_c -name icc\*.exe
/home/travis/.wine/drive_c/Program Files/IAR Systems/Embedded Workbench 4.0/430/bin/icc430.exe
karen% wine "C:\Program Files\IAR Systems\Embedded Workbench 4.0\430\bin\icc430.exe"
  IAR MSP430 C/C++ Compiler V4.09A/W32  [Kickstart]
  Copyright 1996-2007 IAR Systems. All rights reserved.

Available command line options:
--char_is_signed
               'Plain' char is treated as signed char
--core {430|430X}
               The processor core
                  430       (default)
                  430X    
--data_model {small|medium|large}
               Select data model (only for 430X core)
                  small      Small model
                        16 bit registers. __data16 default. (default)
                  medium     Medium model
                        20 bit registers. __data16 default. __data20 allowed.
                  large      Large model
                        20 bit registers. __data20 default. __data16 allowed.
--debug
-r              Insert debug info in object file
--dependencies=[i][m] file|directory
               List file dependencies
                  i     Include filename only (default)
                  m     Makefile style
--diagnostics_tables file|directory
               Dump diagnostic message tables to file
--diag_error tag,tag,...
               Treat the list of tags as error diagnostics
--diag_remark tag,tag,...
               Treat the list of tags as remark diagnostics
--diag_suppress tag,tag,...
               Suppress the list of tags as diagnostics
--diag_warning tag,tag,...
               Treat the list of tags as warning diagnostics
--discard_unused_publics
               Discard unused public functions and variables (experimental)
--dlib_config pathname
               Specify DLib library configuration file
--double {32|64}
               The size of the double floating point type
                  32     32 bits (default)
                  64     64 bits
--ec++          Embedded C++
--eec++         Extended EC++ (EC++ with templates/namespaces/mutable/casts)
--enable_multibytes
               Enable multibyte support
--error_limit limit
               Stop after this many errors (0 = no limit)
--header_context
               Adds include file context to diagnostics
--library_module
               Make a library module
--lock_r4       Exclude register R4 from use by the compiler
--lock_r5       Exclude register R5 from use by the compiler
--mfc           Enable multiple file compilation (experimental)
--migration_preprocessor_extensions
               Enable IAR migration preprocessor extensions
--misrac        Enable MISRA C diagnostics (not available)
--misrac_verbose
               Enable verbose MISRA C messages (not available)
--module_name name
               Set module name
--no_code_motion
               Disable code motion
--no_cse        Disable common sub-expression elimination
--no_fragments  Do not generate section fragments
--no_inline     Disable function inlining
--no_path_in_file_macros
               Strip path from __FILE__ and __BASE_FILE__ macros
--no_tbaa       Disable type based alias analysis
--no_typedefs_in_diagnostics
               Don't use typedefs when printing types
--no_unroll     Disable loop unrolling
--no_warnings   Disable generation of warnings
--no_wrap_diagnostics
               Don't wrap long lines in diagnostic messages
--omit_types    Omit function/variable type info in object output
--only_stdout   Use stdout only (no console output on stderr)
--output file|path
-o file|path    Specify object file
--pic           Generate position independent code
--preinclude filename
               Include file before normal source
--preprocess=[c][n][l] file|directory
               Preprocessor output
                  c     Include comments
                  n     Preprocess only
                  l     Include #line directives
--public_equ symbol[=value]
               Define public assembler symbol (EQU)
--reduce_stack_usage
               Reduce usage of stack at the cost of larger and slower code
--regvar_r4     Allow register R4 to be used as a global register variable
--regvar_r5     Allow register R5 to be used as a global register variable
--remarks       Enable generation of remarks
--require_prototypes
               Require prototypes for all called or public functions
--save_reg20    Save 20-bit registers in interrupt functions
--silent        Silent operation
--strict_ansi   Strict ANSI rules
--warnings_affect_exit_code
               Warnings affect exit code
--warnings_are_errors
               All warnings are errors
-D symbol[=value]
               Define macro (same as #define symbol [value])
-e              Enable IAR C/C++ language extensions
-f file         Read command line options from file
-I directory    Add #include search directory
-l[c|C|D|E|a|A|b|B][N][H] file|directory
               Output list file
                  c     C source listing
                  C        with assembly code
                  D        with pure assembly code
                  E        with non-sequential assembly code
                  a     Assembler file
                  A        with C source
                  b     Basic assembler file
                  B        with C source
                  N     Don't include diagnostics
                  H     Include header file source lines
-O[n|l|m|h|hs|hz]
               Select level of optimization:
                  n   No optimizations
                  l   Low optimizations (default)
                  m   Medium optimizations
                  h   High optimizations
                  hz  High optimizations, tuned for small code size
                  hs  High optimizations, tuned for high speed
                      (-O without argument) The same setting as -Oh
-s{0-9}         Optimize for speed:
                  0-2   Debug
                  3     Low
                  4-6   Medium
                  7-9   High
-z{0-9}         Optimize for size:
                  0-2   Debug
                  3     Low (default)
                  4-6   Medium
                  7-9   High
karen%

The usage information will be valuable, but is too long to scroll through. Pipe it to a textfile for later reference. Also, make some symlinks to more easily get at include files and the documentation:

karen% sudo ln -s /home/travis/.wine/drive_c/Program\ Files/IAR\ Systems/Embedded\ Workbench\ 4.0 /opt/IAR
karen% ls /opt/IAR/430/doc/
EW430_AssemblerReference.pdf  HelpMISRAC.chm              embOS_IAR_plugin.pdf
EW430_CompilerReference.pdf   IAR_Systems.jpg             ew430.htm
EW430_MigrationGuide.pdf      MSP-FET430 Users Guide.pdf  htm.gif
EW430_UserGuide.pdf           a430.htm                    icc430.htm
EW_MisraCReference.pdf        a430_msg.htm                icc430_msg.htm
Help430Compiler.chm           appnotes                    migration.htm
Help430Contents.ENU.chm       clib.pdf                    pdf.gif
Help430IDE1.chm               cs430.htm                   readme.htm
Help430IDE2.chm               embOSRelease.htm            uC-OS-II-KA-CSPY-UserGuide.pdf
karen%

Make scripts for both the compiler and the assembler. I'm uninterested in the IDE.

#!/bin/sh
#/usr/local/bin/a430
wine "C:\Program Files\IAR Systems\Embedded Workbench 4.0\430\bin\a430.exe" $*

#!/bin/sh
#/usr/local/bin/icc430
wine "C:\Program Files\IAR Systems\Embedded Workbench 4.0\430\bin\icc430.exe" $*

The compiler's options are very different from those of GCC, and you must remember (or update your script) to include the IAR include directory if you intend to use its headers. A test compile of the LED blinker from slac080b.zip follows.

karen% icc430 -I "Z:\opt\IAR\430\inc" msp430x20x3_1.c --output blink.exe

  IAR MSP430 C/C++ Compiler V4.09A/W32  [Kickstart]
  Copyright 1996-2007 IAR Systems. All rights reserved.

34 bytes of CODE memory
 0 bytes of DATA memory (+ 4 bytes shared)

Errors: none
Warnings: none
karen%

Now that the compiler is working, you'll need a linker. I use the following script:

#!/bin/sh
opts="-f Z:\opt\IAR\430\config\lnk430F2013.xcl -Fintel-standard  Z:\opt\IAR\430\LIB\CLIB\cl430f.r43 -s __program_start "
xlink="C:\Program Files\IAR Systems\Embedded Workbench 4.0\common\bin\xlink.exe"
wine "$xlink" $* $opts

msp430-objcopy aout.a43 aout.exe

The format switch, -Fintel-standard, makes the output file in the ihex format, one which msp430-objcopy can handle. This will let us program the board using msp430-gdb, so the GNU tools may be used to load the executable. Also note that you'll need to uncomment lines 76 and 77 of /opt/IAR/430/config/lnk430F2013.xcl to define the stack and heap sizes. This script is called as xlink msp430x20x3_1.r43.

The following is a functional, if inelegant, Makefile:

ALL=msp430x20x3_1.exe

all: $(ALL)

msp430x20x3_1.r43:  msp430x20x3_1.c
       icc430 -I "Z:\opt\IAR\430\inc" msp430x20x3_1.c
msp430x20x3_1.exe: msp430x20x3_1.r43
       xlink msp430x20x3_1.r43
       cp aout.exe msp430x20x3_1.exe

GDB

Assuming that msp430-gdb and the USB-FET drivers have been properly installed, the GDB server can be loaded as

karen% msp430-gdbproxy msp430 --spy-bi-wire /dev/ttyUSB0

Remote proxy for GDB, v0.7.1, Copyright (C) 1999 Quality Quorum Inc.
MSP430 adaption Copyright (C) 2002 Chris Liechti and Steve Underwood

GDBproxy comes with ABSOLUTELY NO WARRANTY; for details
use `--warranty' option. This is Open Source software. You are
welcome to redistribute it under certain conditions. Use the
'--copying' option for details.

debug: MSP430_Initialize()
debug: MSP430_Configure()
debug: MSP430_VCC(3000)
debug: MSP430_Identify()
info:      msp430: Target device is a 'MSP430F20x3' (type 52)
debug: MSP430_Configure()
notice:    msp430-gdbproxy: waiting on TCP port 2000

Your ~/.gdbinit file should be

set remoteaddresssize 16
set remotetimeout 999999
target remote localhost:2000
monitor interface spy-bi-wire

msp430-gdb runs with no options. Use load foo.exe to load an executable that has been made by msp430-objcopy.

karen% msp430-gdb
GNU gdb 6.0
Copyright 2003 Free Software Foundation, Inc.
GDB is free software, covered by the GNU General Public License, and you are
welcome to change it and/or distribute copies of it under certain conditions.
Type "show copying" to see the conditions.
There is absolutely no warranty for GDB.  Type "show warranty" for details.
This GDB was configured as "--host=i686-pc-linux-gnu --target=msp430".notice:    msp430-gdbproxy: connected
debug: MSP430_Registers(READ)
0x0000f800 in ?? ()

(gdb) load aout.exe
Loading section .sec1, size 0x38 lma 0xf800
debug: MSP430_Memory(WRITE)
Loading section .sec2, size 0x2 lma 0xfffe
debug: MSP430_Memory(WRITE)
Start address 0xf800, load size 58
Transfer rate: 464 bits in <1>

Note that without "monitor interface spy-bi-wire" in .gdbinit and "--spy-bi-wire" to msp430-gdbproxy, load will still work but many debugging functions will not. Also note that the run command seems to have issues with spy-bi-wire; use continue instead.

You should now be able to play around with the MSP430. Grab the msp430f2013 datasheet and family guide if you'll be doing anything fancy.