Support

Usage

Download the binary distribution for your platform and decompress the file in an appropriate place. Add this location ('bin' subdirectory) to your PATH environment variable and you are ready to go.

When compiling, remember to specify the target chipset with the "-mcpu" switch with your custom building options. (Actually, you should also specify linker scripts to match your architecture in order to build useful images.)

Example

1. arm-elf-gcc -mcpu=arm7tdmi -mthumb -O2 -g -c hello_world.c
2. arm-elf-gcc -mcpu=arm7tdmi -mthumb -o hello_world hello_world.o -lc

Documentation

Local documents in PDF format.

• GDB’s Obsolete Annotations [annotate.pdf]
• Using as [as.pdf]
• libbfd - The Binary File Descriptor Library [bfd.pdf]
• The GNU Binary Utilities [binutils.pdf]
• The GNU Configure and Build System [configure.pdf]
• The C Preprocessor [cpp.pdf]
• Cpplib Internals [cppinternals.pdf]
• Using the GNU Compiler Collection [gcc.pdf]
• Installing GCC [gccinstall.pdf]
• GNU Compiler Collection Internals [gccint.pdf]
• Debugging with GDB - The GNU Source-Level Debugger [gdb.pdf]
• GDB Internals - A guide to the internals of the GNU debugger [gdbint.pdf]
• GNU History Library [history.pdf]
• Using ld - The GNU linker [ld.pdf]
• The Red Hat newlib C Library - Full Configuration [libc.pdf]
• GNU libiberty [libiberty.pdf]
• The Red Hat newlib C Math Library [libm.pdf]
• mmalloc - The GNU memory-mapped malloc package [mmalloc.pdf]
• Embed With GNU - Porting The GNU Tools To Embedded Systems [porting.pdf]
• GNU Readline Library [readline.pdf]
• GDB Quick Reference [refcard.pdf]
• GNU Readline Library User Interface [rluserman.pdf]
• The “stabs” debug format [stabs.pdf]
• GNU Coding Standards [standards.pdf]

Build process

GCC's t-arm-elf file was updated to enable support for the following options:

• marm/mthumb (arm or thumb code generation)
• mlittle-endian/mbig-endian (little or big endian architectures)
• mhard-float/msoft-float (hardware or software fpu instructions)
• mno-thumb-interwork/mthumb-interwork (arm-thumb modes interworking)
• mcpu=arm7 (arm7 targets without hardware multiply)

The disabled options were mapcs-32/mapcs-26 (for old ARM machines with 26-bit program counters) and fno-leading-underscore/fleading-underscore (non-ELF library function format).

The following steps and configuration switches were used in the compilation process:

1. cd [binutils-build]
2. [binutils-source]/configure --target=arm-elf --prefix=[toolchain-prefix] --enable-interwork --enable-multilib
3. make all install
4. export PATH="$PATH:[toolchain-prefix]/bin"
5. cd [gcc-build]
6. [gcc-source]/configure --target=arm-elf --prefix=[toolchain-prefix] --enable-interwork --enable-multilib --enable-languages="c,c++" --with-newlib --with-headers=[newlib-source]/newlib/libc/include
7. make all-gcc install-gcc
8. cd [newlib-build]
9. [newlib-source]/configure --target=arm-elf --prefix=[toolchain-prefix] --enable-interwork --enable-multilib
10. make all install
11. cd [gcc-build]
12. make all install
13. cd [gdb-build]
14. [gdb-source]/configure --target=arm-elf --prefix=[toolchain-prefix] --enable-interwork --enable-multilib
15. make all install