ARM® Workbench IDE User Guide

Version 4.1

Table of Contents

About this book
Intended audience
Using this book
Typographical conventions
Further reading
Feedback on the workbench
Feedback on this book
See also
1. Introduction
1.1. About the workbench
1.2. About ARM plug-ins
2. Getting Started
2.1. Launching the workbench
2.1.1. Language packs
2.1.2. Opening and closing the workbench window
2.2. Workbench features
2.2.1. Workspace
2.2.2. Resources
2.2.3. Perspectives and views
2.2.4. Menus
2.2.5. Toolbars
2.3. Editing source code
2.3.1. Navigating
2.3.2. Searching
2.3.3. Content assist
2.4. Configuring the workbench
2.4.1. Preferences dialog box
2.4.2. Properties dialog box
2.5. Builds
2.6. Importing and exporting
2.6.1. Importing
2.6.2. Exporting
2.7. Getting help
2.7.1. Dynamic help
2.7.2. ARM specific cheat sheets
2.7.3. Installing new features
2.7.4. Accessing the ARM website
2.8. Restrictions of use
3. Working with Projects
3.1. About ARM project types
3.1.1. Executable
3.1.2. Static library
3.1.3. ARM project types for Linux
3.1.4. Build configurations
3.1.5. Project template suite
3.2. Creating a new RealView project
3.3. Importing an existing Eclipse project
3.4. Importing an existing CodeWarrior project
3.5. Adding a file to your project
3.6. Adding a library to your project
4. Configuring the Build and Compilation Tools
4.1. Accessing the build properties for an ARM project
4.2. Accessing the build properties for a specific file
4.3. Configuring the ARM Compiler toolchain
4.4. Using the ARM fromelf utility
4.4.1. Disassembling code
4.5. Restoring defaults
5. Working with Editors
5.1. C/C++ editor
5.2. ARM assembler editor
5.3. Properties editor
5.3.1. Properties editor tabs
5.3.2. Embedding control tags in commented blocks
5.3.3. About control tags
5.3.4. Restrictions of use
5.3.5. Examples of use
5.4. Scatter file editor
5.4.1. Example of a scatter-loading description file
5.5. ELF content editor
5.5.1. Overview
5.5.2. Symbol table
5.5.3. Instruction sizes
5.5.4. Disassembly
6. Working with the ARM Flash Programmer
6.1. About the ARM flash programmer
6.2. Programming a flash device
6.3. Importing a flash image
6.4. Managing flash targets
6.5. Using the flash device manager
6.6. Creating a new flash algorithm
6.7. Exporting a board for use with RealView Debugger
6.8. Exporting a flash device for use with RealView Debugger
7. Working with RealView Debugger
7.1. Loading your executable image into RealView Debugger
7.1.1. Load using an existing workbench target configuration
7.1.2. Load without a workbench target configuration
7.2. Creating your debug configuration
7.3. Setting up your debug configuration
7.3.1. Selecting an existing debug configuration
7.3.2. Selecting a different image to debug
7.3.3. Configuring RealView Debugger connection settings
7.3.4. Specifying execution arguments
7.4. Launching RealView Debugger using your debug configuration
7.5. Exporting IP-XACT design files for use with RealView Debugger
A. Terminology, Shortcuts and Icons
A.1. Terminology
A.2. Keyboard shortcuts
A.3. Menu and toolbar icons

List of Figures

2.1. Welcome view
2.2. Workbench window
2.3. Workspace launcher dialog box
2.4. Linked file
2.5. Linked folder
2.6. Linked project
2.7. Changing perspective
2.8. Workbench toolbar
2.9. Perspective toolbar
2.10. View toolbar
2.11. Window preferences dialog box
2.12. Project properties dialog box
2.13. Workbench build behavior
2.14. Typical example of the import wizard
2.15. Typical example of the export wizard
2.16. Selecting a cheat sheet
2.17. Example of a cheat sheet
2.18. RealView Debugger message
3.1. ARM project types for installed toolchains
3.2. Project converters
3.3. Naming your project
3.4. Project template selection
3.5. Fine-tune target settings
3.6. Language settings
3.7. Project examples
3.8. Selecting the import source type
3.9. Selecting an existing Eclipse projects for import
3.10. Selecting CodeWarrior XML
3.11. Importing a CodeWarrior Project
3.12. Structure with the source folder above the project file
3.13. Filter include paths and path variables
3.14. Naming your file
4.1. Build configuration panel for an ARM project
4.2. Calling fromelf from the workbench
5.1. Bus configuration GUI components
5.2. Bus configuration bit positions
5.3. Password string GUI components
5.4. Data read protocol GUI component
5.5. Stack configuration GUI components
5.6. VPBDIV definitions GUI components
5.7. Add load region name
5.8. Overview tab
5.9. Overview tab
5.10. Symbol Table tab
5.11. Instruction Sizes tab
5.12. Disassembly tab
6.1. The ARM flash programmer
6.2. Create, manage, and run configurations
6.3. Results from programming your device
6.4. Select flash image to import
6.5. Flash image import settings
6.6. Manage configurations
6.7. Test target connection method
6.8. Results from testing your device
6.9. Add or remove flash devices
6.10. Import a flash device
6.11. Import flash device object files
6.12. New flash device project
6.13. Naming your flash project
6.14. Flash device details
6.15. Flash device configuration settings
6.16. Export RealView Debugger Board
6.17. Select board configuration
6.18. Export flash device to RealView Debugger
6.19. Export flash device object files
6.20. Export flash device structure
6.21. Export flash device block
6.22. Query device structure
6.23. Export flash device parameters
7.1. Debug panel
7.2. Export IP-XACT to RealView Debugger
7.3. Select IP-XACT design file

Proprietary Notice

Words and logos marked with ® or ™ are registered trademarks or trademarks of ARM Limited in the EU and other countries, except as otherwise stated below in this proprietary notice. Other brands and names mentioned herein may be the trademarks of their respective owners.

Neither the whole nor any part of the information contained in, or the product described in, this document may be adapted or reproduced in any material form except with the prior written permission of the copyright holder.

The product described in this document is subject to continuous developments and improvements. All particulars of the product and its use contained in this document are given by ARM in good faith. However, all warranties implied or expressed, including but not limited to implied warranties of merchantability, or fitness for purpose, are excluded.

This document is intended only to assist the reader in the use of the product. ARM Limited shall not be liable for any loss or damage arising from the use of any information in this document, or any error or omission in such information, or any incorrect use of the product.

Where the term ARM is used it means “ARM or any of its subsidiaries as appropriate”.

Confidentiality Status

This document is Non-Confidential. The right to use, copy and disclose this document may be subject to license restrictions in accordance with the terms of the agreement entered into by ARM and the party that ARM delivered this document to.

Product Status

The information in this document is final, that is for a developed product.

Revision History
Revision AMarch 2006Release v3.0 for ARM® RealView® Development Suite
Revision BMarch 2007Release v3.1 for RealView Development Suite
Revision CJuly 2007Release v3.1 for RealView Development Suite - ARM flash programmer and assembler editor update
Revision DDecember 2007Release v3.1 for RealView Development Suite - CodeWarrior Importer update
Revision ESeptember 2008RealView Development Suite v4.0 Release
Revision F28 May 2010RealView Development Suite v4.1 Release
Revision G30 September 2010RealView Development Suite v4.1 SP1 Release
Copyright © 2006-2008, 2010 ARM Limited. All rights reserved.ARM DUI 0330G