Setting up Tiva C Launchpad project template with Sourcery Codebench and Eclipse

Tiva C series TM4C123G (MCU:TM4C1233H6PM)Launchpad is updated version of Stellaris Launchpad LM4F120 (MCU: LM4F120H5QR). Practically this is due TI’s choice to change name of product line. Such action led to some confusion especially for software developers. This means that software libraries had to be renamed, software tool adapted and so on. Since this work is most renaming things from one point this is easy task, from another point it may be tricky to check all corners. So if you just in to Texas Instruments ARM Cortex microcontrollers, it is better to start with Tiva C series and forget Stellaris. Otherwise this might get confusing to switch from one to another.

At the moment TivaWare 1.1 still has some issues due to migration, but most things sould work fine. So lets try to create a project template for Eclipse IDE and Sourcery Codebench Lite GCC compiler tools. First you need to download and install Eclipse with CDT C/C++ tools (Eclipse Indigo includes this). Next you need to install latest Mentor Sourcery Codebench Lite. Also download and extract TivaWare for C series, where all libraries and examples are located. In order to Flash microcontroller download LM Flash Programmer. Other materials and introduction videos are here. So you need everything except CCS.

Lets start putting template together. First launch Eclipse and select workplace where project will be created:

Now we create new project by selecting File->New->C Project and in project type select Executable->Empty project-> Cross GCC:

Lets name it TivaCTemplate.

Then click Next and if second screen click Advanced settings… button:

Under Resource property select Text file encoding as Other->UTF8 and New text file line delimiter as Other->Unix:

Next go to C/C++ Build branch and select Settings. Go to Cross Settings and in prefix type in arm-none-eabi- . As path you may also browse to sourcery bin folder:

While you are in Settings go to Cross GCC Compiler → Includes and add path to TivaWare folder which by default should be installed to “C:\ti\TivaWare_C_Series-1.1”:

Then follow to Miscelaneous branch and in Other flags filed you will find -c -fmessage-length=0. Append following to the end: -mthumb -mcpu=cortex-m4 -mfpu=fpv4-sp-d16 -mfloat-abi=softfp -ffunction-sections -fdata-sections:

Now lets add TivaWare driver library. For this in same window go to Cross GCC Linker->Libraries and add driver. And in Library Search path add library location which is at “C:\ti\TivaWare_C_Series-1.1\driverlib\gcc”:

While in Cross GCC Linker go to in Miscellaneous branch and enter Linker Flags:

-Wl,--static,--gc-sections,-T../startup_src/TM4C.ld -mthumb -mcpu=cortex-m4

In same window go to Build Steps tab. In Post-Build steps field enter:

arm-none-eabi-objcopy -O binary ${ProjName}.elf ${ProjName}.bin

In description you may enter “Generate .bin file from .elf”:

Then follow to next tab called Build Artifact and append to Artifact name .elf so you had ${ProjName}.elf :

Then you can click Apply, then OK and Finish to create project.

The empty project should be visible in project tree. Before we start running examples we need to take care of two important files – startup code and linker script. Since microcontroller is same as in stellaris launchpad we can use same files. As starting point I’ve chosen Scompo template for launchpad where startup and linker script files are ready to go. From this template we take LM4F.ld and LM4F_startup.c and rename them to TM4C.ld and TM4C_startup.c. In the project tree lets create new folder called startup_src and import those two files here:

Just for quick test import blinky.c file from “C:\ti\TivaWare_C_Series-1.1\examples\boards\ek-tm4c123gxl\blinky”:

And try to compile. If build is succesful you should see TivaCTemplate.bin file in release folder.

In order to flash Tiva C Launchapad just run LM Flash programmer software, browse to generated TivaCTemplate.bin file and click Program button. You should see blinking LED immediatelly.

You can alternatively add LM Flash Programmer to Eclipse as alternative tool that can be called from menu.

In order to make this possible go to Exlipse menu Run->External Tools->External Tools Configurations and enter following:

First of all Enter name of your item like “LM Flash Programmer”. Then under Location browse to Installed LMFlash.exe file “C:\Program Files (x86)\Texas Instruments\Stellaris\LM Flash Programmer\LMFlash.exe” that has to be invoked. Then Browse Workspace in order to add working directory “${workspace_loc:/TivaCTemplate/Release}”. And under Arguments enter what has to be flashed. Our binary file consists of Projectname with .bin extension. So ${project_name}.bin works fine.

Then go to Common tab and select External Tools under Display in favorites menu.

Now next time you select Run->External Tools->LM_Flash_Programmer you start programming immediately in background mode:

Hope you get your free GCC project up and running. Please comment if you notice an error in text or stuck at some place. Download Tiva C template here: TivaCTemplate.zip