ARM VERSION 1.2 Fiche technique

Copyright © 1999-2001 ARM Limited. All rights reserved.ARM DUI 0064DARM® Developer SuiteVersion 1.2Getting Started

Preface x Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D

Creating an Application 3-16 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D3.3.2 Using the assembler from the command lineThe b

Creating an Application ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 3-17Building the exampleTo build the example: 1. Enter t

Creating an Application 3-18 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DThe default output from the linker is a non-relocata

Creating an Application ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 3-19-rw-base addressThis option sets the execution addre

Creating an Application 3-20 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D3.3.4 Using the CodeWarrior IDE from the command lin

Creating an Application ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 3-213.4 Using ARM librariesThe following run-time librar

Creating an Application 3-22 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DNote • The ARM C libraries are supplied in binary fo

Creating an Application ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 3-23You must re-implement functions that the C library u

Creating an Application 3-24 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D3.5 Using your own librariesThe ARM librarian, armar

Creating an Application ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 3-253.6 Debugging the application with AXDAXD enables yo

ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 1-1Chapter 1 IntroductionThis chapter introduces the ARM Developer Suite Version

Creating an Application 3-26 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DFigure 3-14 Loading an imageStepping through an appl

Creating an Application ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 3-27Figure 3-15 The Execute menuThe disassembled code is

Creating an Application 3-28 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DFigure 3-16 DisassemblyProcessor viewUse the Process

Creating an Application ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 3-29Figure 3-18 Viewing register contents3.6.2 Configuri

Creating an Application 3-30 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D

ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 4-1Chapter 4 Migrating Projects from SDT to ADSThis chapter describes some of th

Migrating Projects from SDT to ADS 4-2 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D4.1 Converting makefiles and APM project f

Migrating Projects from SDT to ADS ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 4-37. Check any other assembler, compiler, an

Migrating Projects from SDT to ADS 4-4 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D4.2 Moving your development project from S

Migrating Projects from SDT to ADS ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 4-5In ADS, all code is compiled as -apcs /nar

Introduction 1-2 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D1.1 About the ARM Developer SuiteADS consists of a suite of appl

Migrating Projects from SDT to ADS 4-6 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DIn ADS, -zz0, -zt, -zzt0, and -zz-1 are fa

Migrating Projects from SDT to ADS ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 4-74.2.2 AssemblingSome assembler features ha

Migrating Projects from SDT to ADS 4-8 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064Dto:basesym SETS "|Image$$$$":C

Migrating Projects from SDT to ADS ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 4-9• The linker normally finds the correct C

Migrating Projects from SDT to ADS 4-10 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DError: L6242E: Cannot link object _main.o

Migrating Projects from SDT to ADS ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 4-11The ADS C library defines an entry point

Migrating Projects from SDT to ADS 4-12 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D Peripherals 0x02000000 { periph.

Migrating Projects from SDT to ADS ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 4-13Section naming in scatter-loadingYou shou

Migrating Projects from SDT to ADS 4-14 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DThere are no Embedded C libraries supplie

Migrating Projects from SDT to ADS ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 4-15 IMPORT __rt_entry EXPORT __main

Introduction ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 1-3armsd The ARM and Thumb symbolic debugger. This enables source

Migrating Projects from SDT to ADS 4-16 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D4.2.5 Calling constructors and destructor

Migrating Projects from SDT to ADS ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 4-17readsyms embed.axfpc = 0x0cpsr = %IFt_SCV

Migrating Projects from SDT to ADS 4-18 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D

ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. Glossary-1GlossaryADS See ARM Developer Suite.AFS See ARM Firmware Suite.AIF ARM

Glossary Glossary-2 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DARM Developer SuiteA suite of applications, together with sup

Glossary ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. Glossary-3Big-endian Memory organization in which the least significant

Glossary Glossary-4 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DDSP Digital Signal ProcessorDWARF Debug With Arbitrary Record

Glossary ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. Glossary-5Immediate values Values which are encoded directly in the ins

Glossary Glossary-6 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DProcessor Status RegisterSee Program Status Register.Program

Glossary ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. Glossary-7Rounding modes Specify how the exact result of a floating-poi

Introduction 1-4 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DFlash downloader Utility for downloading binary images to Flash

Glossary Glossary-8 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DThumb instruction A halfword which specifies an operation for

ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. Index-1IndexAANSI C library 1-4ISO C standardAPM project filesconverting 4-2

IndexIndex-2 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DConverting from SDT to ADSAPM project files 4-2assembling 4-7com

IndexARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. Index-3Stepping through an application 3-26Symbolslinker 2-25Ttcc 1-2

IndexIndex-4 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D

Introduction ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 1-51.2 Printed documentationThis section lists publications from bo

Introduction 1-6 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D• CodeWarrior IDE Guide (ARM DUI 0065). This book provides tutor

Introduction ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 1-71.3 Online documentationThe ADS printed documentation is also av

Introduction 1-8 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DFigure 1-1 DynaText browser with list of available booksOpening

Introduction ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 1-9Figure 1-2 Opening a bookNavigating through the bookClick on a s

ii Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DARM Developer SuiteGetting StartedCopyright © 1999-2001 ARM Limited. All righ

Introduction 1-10 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DFigure 1-3 Selecting a section from the table of contentsNaviga

Introduction ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 1-11Figure 1-4 Using text linksDisplaying graphicsGraphics are not

Introduction 1-12 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DFigure 1-6 Graphic displayedNavigating to a different bookIf th

Introduction ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 1-13Figure 1-7 Navigating to a different bookDisplaying help for Dy

Introduction 1-14 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D1.3.2 HTMLThe manuals for the Rogue Wave C++ library for ADS ar

Introduction ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 1-151.4 Online helpA Help menu is available for the Graphical User

Introduction 1-16 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DNote Most help selections can be done by key presses or mouse c

ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-1Chapter 2 DifferencesThis chapter describes the major differences between SDT

Differences 2-2 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D2.1 OverviewThis chapter describes the changes that have been mad

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-3• Limited support for GNU images in AXD.• More components are lic

ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. iiiContentsARM Developer Suite Getting StartedPrefaceAbout this book ...

Differences 2-4 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D2.2 Changes between ADS 1.2 and ADS 1.1This section describes cha

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-5Note ADS version 1.2 is the last release of ADS that supports Win

Differences 2-6 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DNew or changed compiler options and pragmasThe following compiler

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-7__use_realtime_division() Selects a helper division routine that

Differences 2-8 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D• New instructions and directives• Access to C++ class members• I

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-9Changed linker behaviorThe following changes have been made to th

Differences 2-10 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DNew fromELF optionsThis section gives a brief summary of new fro

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-11If you have written your own .ami ARMulator configuration files,

Differences 2-12 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D• The Developer Guide has a new chapter on cached processors and

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-132.3 Changes between ADS 1.1 and ADS 1.0This section describes ch

Contentsiv Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D3.6 Debugging the application with AXD ...

Differences 2-14 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D• Reliably examine the contents of variables. Where the value of

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-15 .text .type $a,function @ or $t for Thumb$a:

Differences 2-16 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DCode size improvements and improved optimizationADS 1.1 optimiza

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-17connected. For example, the target can describe the number, name

Differences 2-18 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DThe ADS 1.1 assembler supports two new directives to mark assemb

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-192.3.2 Differences in default behaviorThis section describes how

Differences 2-20 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DNew compiler options and pragmasThis section gives a brief summa

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-21-fpu vfpv1Selects hardware Vector Floating Point unit conforming

Differences 2-22 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D• Tentative declarations are allowed by default in ADS 1.1 and l

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-23• the compilers now place zero initialized global and static def

ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. vPrefaceThis preface introduces the ARM Developer Suite (ADS) and its user docum

Differences 2-24 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DNew assembler optionsThis section gives a brief summary of new a

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-25ImpactYou must modify existing makefiles that use these options.

Differences 2-26 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D-mangledThis option instructs the linker to display mangled C++

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-27New fromELF optionsThis section gives a brief summary of new fro

Differences 2-28 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D• AXD displays the XScale coprocessors CP0, CP13, CP14, and CP15

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-29Changes to armsdThe armsd debugger has been enhanced in the foll

Differences 2-30 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D• New configuration mechanism• ARMulator byte order set from the

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-31In order to avoid loading files that are not meant for the armul

Differences 2-32 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D2.4 Changes between ADS 1.0 and SDT 2.50/2.51This section descri

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-33Note BATS is no longer shipped with ADS 1.1 or later.The compile

Preface vi Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DAbout this bookThis book provides an overview of the ADS tools and doc

Differences 2-34 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DNote The order of the words in a little-endian double is differe

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-35Remote Debug InterfaceA new variant of the Remote Debug Interfac

Differences 2-36 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D• Improved stack-unwinding due to the use of DWARF2 descriptions

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-37Hardware other than serial, parallel, or ethernet ports can be u

Differences 2-38 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DImpactThe linker supports the deprecated ALF library format. Use

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-39— simple Overlay (OVERLAY).• Direct support for ROPI and RWPI pr

Differences 2-40 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DC++ compilersThe C++ compilers included with ADS inherit all the

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-41License managementADS components are license-managed by FLEXlm.

Differences 2-42 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D2.4.2 Differences in default behaviorThe differences in the defa

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-43—a short enum type—a struct containing only fields of short alig

Preface ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. viimonospace Denotes a permitted abbreviation for a command or option.

Differences 2-44 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DEntry point set by linker optionThe -entry option sets the entry

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-45Floating-point exceptionsThe ADS tools have been changed to conf

Differences 2-46 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DThe variable is used only to specify alternative search paths to

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-472.4.3 Changed compiler behaviorThis section describes compiler b

Differences 2-48 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DImpactUpdate your projects or makefiles to compile with the appr

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-49-zinumberReplaced by -Ospace and -Otime.-gxletterReplaced by the

Differences 2-50 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D-proc, -archSelect processor or architecture. Use -cpu instead.-

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-51The new predefined macros are listed in Table 2-3.__APCS_REENTOb

Differences 2-52 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D2.4.4 Changed assembler behaviorThis section describes assembler

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-53• There are new synonyms FIELD and SPACE for # and % directives.

Preface viii Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D• ARM ELF specification (SWS ESPC 0003). This is supplied in PDF for

Differences 2-54 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DFeatures of the SDT assembler not supportedThe following assembl

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-55-archSelect architecture (use -cpu instead).ImpactUse DWARF2 for

Differences 2-56 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D-keepSpecify sections to be retained even if unused-localsAdd lo

Differences ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 2-57APMAPM is not provided. ImpactUse the CodeWarrior IDE or a make

Differences 2-58 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D26-bit addressingADS does not support 26-bit addressing. Removal

ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 3-1Chapter 3 Creating an ApplicationThis chapter describes how to create an appl

Creating an Application 3-2 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D3.1 Using the CodeWarrior IDEThe CodeWarrior IDE prov

Creating an Application ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 3-33.2 Creating and building a simple projectThis sectio

Creating an Application 3-4 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DFigure 3-1 New dialog3. Ensure that the Project tab i

Creating an Application ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 3-56. Navigate to the directory where you want to save t

Preface ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. ixFeedbackARM Limited welcomes feedback on both the ARM Developer Suite

Creating an Application 3-6 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DFigure 3-4 Select files to add… dialog4. Click Open.

Creating an Application ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 3-7Figure 3-6 Project messages windowThe access paths fo

Creating an Application 3-8 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DBuild target settings must be selected separately for

Creating an Application ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 3-9Figure 3-9 DebugRel Settings3. Click the ARM C Compil

Creating an Application 3-10 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D4. Click the Preprocessor tab to display a list of p

Creating an Application ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 3-11Note You can also cut and paste build target settin

Creating an Application 3-12 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064DNote This example has shown how to use the configura

Creating an Application ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 3-133.2.5 Debugging the projectBy default, the ARM proje

Creating an Application 3-14 Copyright © 1999-2001 ARM Limited. All rights reserved. ARM DUI 0064D3.3 Building from the command lineThis section descr

Creating an Application ARM DUI 0064D Copyright © 1999-2001 ARM Limited. All rights reserved. 3-152. Link the image using the following command:armlin