User guide

ManualsBrandsARM ManualsComputer HardwareVERSION 1.2

1 Introduction

This chapter introduces the ADS Developer Guide. It contains the following sections:

• About the ARM Developer Guide

• General programing issues

• Developing for the ARM.

1.1 About the ARM Developer Guide

This book contains information that will help you with specific issues when developing code for ARM-based

processors. In general, the chapters in this book assume that you are using the ARM Developer Suite (ADS) to

develop your code.

ADS consists of a suite of applications, together with supporting documentation and examples, that enable you to

write and debug applications for the ARM family of RISC processors. You can use ADS to develop, build, and debug

C, C++, and ARM assembly language programs.

The ADS toolkit consists of the following major components:

• command-line development tools

• GUI development tools

• utilities

• supporting software.

See Further reading for a list of the ADS documentation.

1.1.1 Example code

The code for many of the examples in this book is located in install_directory\examples. In addition, the

examples directory contains example code that is not described in this book. Read the readme.txt for each

example directory for more information. The examples are installed in the following directories:

asm

This directory contains some examples of ARM assembly language programming. The

examples are used in the Assembler Guide

cpp

This directory contains some simple C++ examples. In addition, the subdirectory rw contains the

Rogue Wave manual and tutorial examples.

databort

This directory contains design documentation and example code for a standard data abort

handler.

dcc

This directory contains example code that demonstrates how to use the Debug Communications

Channel. The example is described in Chapter 8 Debug Communications Channel.

dhry

This directory contains source for Dhrystone.

dhryansi

This directory contains an ANSI C version of Dhrystone.

explasm

This directory contains additional ARM assembly language examples.

inline

This directory contains examples that show how to use the inline assemblers for the C and C++

compilers. The examples are described in Chapter 4 Mixing C, C++, and Assembly Language.

interwork

This directory contains examples that show how to interwork between ARM code and Thumb

code. The examples are described in Chapter 3 Interworking ARM and Thumb.

mmugen

This directory contains the source and documentation for the MMUgen utility. This utility can

generate MMU pagetable data from a rules file that describes the virtual to physical address

translation required (see Chapter 7 Caches and Tightly Coupled Memories).

picpid

This directory contains an example of how to write position-independent code. See the

readme.txt for a detailed description.

embedded

This directory contains source code for the examples used in Chapter 6 Writing Code for ROM.

The examples are targeted at the ARM Integrator™ board.

sorts

This directory contains example code that compares an insertion sort, shell sort, and the quick

sort used in the ARM C libraries.

swi

This directory contains an example SWI handler.

Introduction