
              How to assemble the sample program for the Olimex msp430-1121STK

You can download the sample program from the Olimex web site.
The sample program has already been programmed into the 
flash memory, but you may want to modify the program and
"burn" it into the flash memory yourself.

The source file should be named "msp430-1121stk.s43".

Assembler source files should have an extension of .s43.
The assembled output (in Hex format) will have an extension of .r43.

Before we go too far, there are a few things you should know.
The IAR software, and most of the msp430 files on the TI web site,
refer to the term "FET".  This is used to refer to the hardware boards
AND the software tools that were designed for those boards. You 
don't need a real TI "FET" board since the 1121STK boards from
Olimex are compatible with them. You also need a JTAG adapter from
Olimex to go with your board. 

The JTAG connector plugs in to your PC's parallel port. The 1121STK 
also has a serial port connector, but you normally use the JTAG
connector to program the device. The serial port on the board can
be used to interact with the device after it's been programmed.

You can download the IAR Embedded Workbench from the Texas
Instruments web site. This "free" version of the tools is also called the
"Kickstart" package. The file I downloaded is called "fet_304.exe"
and it was over 19 megabytes in size. Once installed, you can get 
the version number from Help, About. My version is:
   User Interface 2.31E
   Target Descriptor: 2.16A/WIN

Create a "build" directory. Copy your assembler source file (from the
Olimex web site) into that directory.
This is a good choice:
  C:\Olimex\build

Create a command-line options file for the linker. This is just a text file
with some option settings and comments. These files end with an
extension of .XCL.  You must not use the default file because it won't
let you set up your own interrupt vectors. The default assumes you want
to link to C language modules.

I made up an XCL file called "ASSEM.XCL" and I put it in the build 
directory with the assembler source file.

Here's the contents of the ASSEM.XCL file I made for this sample project.
You can use NOTEPAD or WORDPAD to make this file:
----------------- cut here -----------------
// Define CPU
-cMSP430

// Allocate the interrupt vector table segment INTVEC.
-Z(CODE)INTVEC=FFE0-FFFF
----------------- cut here -----------------

Once you have set up these 2 files you can start up the Embedded Workbench:
    C:\Olimex\build\msp430-1121stk.s43
    C:\Olimex\build\assem.xcl

1) Start IAR Embedded Workbench
2) File, New, Project, "testproj", Create
3) Select Release
4) Project, New Group, "Testgrp", Release, OK
5) Project, Files, type=Assembler Files, select "msp430-1121stk.s43", Add, Done
6) Project, Options, A430, select List tab, check List File
7) Project, Options, XLINK,select List tab, check Generate linker listing and Segment map 
8) Project, Options, XLINK,select Include tab, under XCL check "override default" and press
    the button with the 3 dots so you can locate your "assem.xcl" file.
9) File, Save All
10) Project, Build All

Your output files will be under your "build" directory:
   C:\Olimex\build\release\list\testproj.map
   C:\Olimex\build\release\list\msp430-1121stk.lst
   C:\Olimex\build\release\obj\msp430-1121stk.r43

The first file is a memory map.
The second file is a listing of your assembly process.
The last file is your ouput "hex" file.

You can use the IAR "CSPY" debugger to write the hex file into 
the flash memory on the 1121STK using the JTAG adapter.
 
Good Luck!
Eric Engler

