Introduction

For a complete C/C++ development system we need the following components:

This tutorial here will cover how to setup your YAGARTO toolchain, and how to compile your first ARM program. It is required that you already have installed the GDB Server from part 1.

Later I will describe how to expand YAGARTO by Eclipse.

Download and install

If you do not already have downloaded the GNU ARM toolchain, you can download the installer from the front page.

Press the "Next >" button an follow the instruction from the installer.

Test your installation

Now we want to make a short test if the compiler is available. Therefore open a command prompt and type:

C:\>arm-none-eabi-gcc --version

The result should look like:

arm-none-eabi-gcc (GCC) 4.5.0
Copyright (C) 2010 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

If there is no answer, probably the GNU ARM toolchain of YAGARTO was not installed or is not in your PATH.

How to use the toolchain?

Here I will show you, how to compile your first program. Therefore I have created some small examples for it. Download the example you need and expand the zip file in your working directory.

Note: The examples are updated because the GDB-6.8 and higher need the following option: set mem inaccessible-by-default off

I will show you the next steps with the STR7Test example, and have expanded it in the following directory:

This directory is only an example, choose what is the best for you. For the next steps I will use this directory.

Open a command prompt and change in the D:\projekte\ARM\STR7Test directory. First you must clean the project, therefore type:

D:\Projekte\ARM\STR7Test>make clean

The result should look like:

rm -f ./src/crt.o ./src/main.o
rm -f test_ram.elf
rm -f test_ram.map
rm -f test_ram.hex
rm -f test_rom.elf
rm -f test_rom.map
rm -f test_rom.hex
rm -f ./src/main.c.bak
rm -f ./src/main.lst
rm -f ./src/crt.s.bak
rm -f ./src/crt.lst
rm -fR .dep

All list and object files are deleted, now we want to compile the program, type:

D:\Projekte\ARM\STR7Test>make all

The output should look like:

arm-none-eabi-gcc -x assembler-with-cpp -c -mcpu=arm7tdmi -g -gdwarf-2 -Wa,-amhl
s=src/crt.lst src/crt.s -o src/crt.o
arm-none-eabi-gcc -c -mcpu=arm7tdmi -O0 -gdwarf-2 -mthumb-interwork -fomit-frame
-pointer -Wall -Wstrict-prototypes -fverbose-asm -Wa,-ahlms=src/main.lst -MD -
MP -MF .dep/main.o.d -I . -I./inc src/main.c -o src/main.o
arm-none-eabi-gcc ./src/crt.o ./src/main.o -mcpu=arm7tdmi -nostartfiles -T./prj/
hitex_str7_ram.ld -Wl,-Map=test_ram.map,--cref,--no-warn-mismatch -o test_ram
.elf
arm-none-eabi-objcopy -O ihex test_ram.elf test_ram.hex
arm-none-eabi-gcc ./src/crt.o ./src/main.o -mcpu=arm7tdmi -nostartfiles -T./prj/
hitex_str7_rom.ld -Wl,-Map=test_rom.map,--cref,--no-warn-mismatch -o test_rom
.elf
arm-none-eabi-objcopy -O ihex test_rom.elf test_rom.hex

A file test.elf should now be created in your build directory. If you could find it, congratulations, you have compiled your first ARM program with the new toolchain.

The next tutorial will describe how to expand the toolchain by Eclipse.

Support

If you need support, take a look here:

• A support-forum for WinARM / ARM-GCC

Additional information

An other very detailed tutorial by Jim Lynch "Using Open Source Tools for AT91SAM7S Cross Development, Revision 2" which based on YAGARTO can be found at the Atmel web site (tutorial + sample projects, 6MB).

If you do not like to play the installation puzzle, want to have only ONE application, and have the budget to pay for the toolchain, take a look at Rowley Associates.

Rowley has now extended the licensing scheme to include hobbyists and students with a new Personal License.

License information

Some of the software falls under the GNU General Public License (GPL).

You can download a copy of the GPL from this website, too:

Credits

• Thanks to Pablo for providing the GNUARM toolchain from where I use the t-arm-elf file, and get the modivation to create a MinGW based toolchain.

• Some of the scripts for the toolchain was derived from the devkitPro scripts (www.devkitpro.org).

• Thanks to the GNU community who improved the GNU tools day by day.

• Thanks to Martin from WinARM for the support forum.

The tutorial on this site is licensed under a Creative Commons Attribution 2.5 License and is copyright (C) 2006 by me, Michael Fischer.