RealView Debugger Target Configuration Guide

Chapter 1 Introduction

1.1 About connection configuration ............................................................................... 1-2
1.2 Default configuration files ........................................................................................ 1-7
1.3 How configuration files are linked together ............................................................ 1-13
1.4 What the configuration files contain ....................................................................... 1-14
1.5 Locating the configuration files .............................................................................. 1-16
1.6 Summary of supplied BCD files ............................................................................. 1-19

Chapter 2 Customizing a Debug Interface configuration

2.1 About customizing a Debug Interface configuration ................................................ 2-2
2.2 About customizing a DSTREAM or RealView ICE Debug Interface configuration .. 2-3
2.3 Customizing a DSTREAM or RealView ICE Debug Interface configuration for non-CoreSight development platforms .................................................................... 2-7
2.4 Customizing a DSTREAM or RealView ICE Debug Interface configuration for development platforms containing CoreSight components ..................................... 2-9
2.5 Customizing a VSTREAM Debug Interface configuration ..................................... 2-11
2.6 Customizing an RVISS Debug Interface configuration .......................................... 2-13
2.7 Customizing an ISSM Debug Interface configuration ............................................ 2-17
2.8 Customizing an RTSM Debug Interface configuration ........................................... 2-19
2.9 Customizing a Model Library Debug Interface configuration ................................. 2-21
2.10 Customizing a Model Process Debug Interface configuration ............................... 2-23
2.11 Customizing a SoC Designer Debug Interface configuration ................................ 2-25

Chapter 3 Customizing a Debug Configuration

3.1 About customizing a Debug Configuration .............................................................. 3-2
3.2 Viewing the Connection Properties .......................................................................... 3-5
3.3 Changing connection settings ................................................................................ 3-10
3.4 Loading a different board file ................................................................................. 3-15
3.5 Hiding a Debug Configuration ................................................................................ 3-18
3.6 Specifying connect and disconnect mode ............................................................. 3-19
3.7 Creating a target-specific Advanced_Information group ........................................ 3-23
3.8 Configuring vector catch ........................................................................................ 3-24
3.9 Configuring Semihosting ........................................................................................ 3-29
3.10 Configuring the CLI commands for hardware cross-triggering .............................. 3-33
3.11 Configuring a connection sequence for multiple targets ........................................ 3-36
3.12 Running CLI commands automatically on connection ........................................... 3-41
3.13 Configuring RealMonitor for connections through DSTREAM or RealView ICE ... 3-43
3.14 Flash programming ................................................................................................ 3-50
3.15 Using the Thumb-2EE helper macro ..................................................................... 3-51
3.16 Restoring the default connections and configurations ........................................... 3-55
3.17 Preparing Debug Configurations for distribution .................................................... 3-56
3.18 Distributing Debug Configurations to other machines and users ........................... 3-58
3.19 Example of setting up an Integrator board and processor core module ................ 3-60
3.20 Troubleshooting Debug Configurations ................................................................. 3-65

Chapter 4 Configuring Custom Memory Maps, Registers and Peripherals

4.1 About configuring custom memory maps, registers, and peripherals ...................... 4-2
4.2 Assigning a board, chip, or component group to a Debug Configuration ................ 4-7
4.3 Using the supplied BCD files ................................................................................. 4-12
4.4 Creating a BCD file to use as a template ............................................................... 4-13
4.5 Basic procedure for creating BCD files .................................................................. 4-15
4.6 Creating a new BCD file ........................................................................................ 4-16
4.7 Creating and naming a board, chip, or component group ..................................... 4-18
4.8 Assigning board/chip definitions ............................................................................ 4-21
4.9 Setting top of memory ............................................................................................ 4-24
4.10 Creating a memory map block ............................................................................... 4-29
4.11 Creating an enumeration for setting register values .............................................. 4-35
4.12 Creating a custom memory mapped register ......................................................... 4-37
4.13 Creating a custom peripheral ................................................................................. 4-40
4.14 Creating the register tab for displaying custom registers and peripherals ............. 4-44
4.15 Creating memory map rules .................................................................................. 4-47
4.16 Setting up controlled memory blocks ..................................................................... 4-49
4.17 Creating a concatenated register ........................................................................... 4-54
4.18 Troubleshooting BCD files ..................................................................................... 4-58

Chapter 5 Debug Configuration Tutorial

5.1 About the Debug Configuration tutorial .................................................................... 5-2
5.2 Before starting the tutorial ........................................................................................ 5-5
5.3 Creating a new Debug Configuration ....................................................................... 5-6
5.4 Configuring the new Debug Configuration ............................................................... 5-7
5.5 Creating the EtherRouter.bcd file ............................................................................ 5-8
5.6 Creating the AMDLANCE.bcd file .......................................................................... 5-10
5.7 Creating the EtherRouter BOARD group ............................................................... 5-11
5.8 Creating the AMDLANCE CHIP group .................................................................. 5-12
5.9 Assigning board/chip definitions ............................................................................ 5-13
5.10 Creating the memory map ..................................................................................... 5-15
5.11 Creating the enumerations for the register values ................................................. 5-19
5.12 Creating a custom register ..................................................................................... 5-21
5.13 Creating the register tab for displaying custom registers ....................................... 5-24
5.14 Setting up controlled memory map blocks ............................................................. 5-27
5.15 Creating memory map rules .................................................................................. 5-29
5.16 Displaying the controlled memory map blocks ...................................................... 5-31
5.17 Creating a concatenated register ........................................................................... 5-33

Chapter 6 Programming Flash with RealView Debugger

6.1 Introduction to Flash programming with RealView Debugger .................................. 6-2
6.2 RealView Debugger files used for Flash programming ........................................... 6-7
6.3 pakflash utility command syntax ............................................................................ 6-10
6.4 Programming Flash on the ARM development boards .......................................... 6-11
6.5 Programming Flash for a custom development platform ....................................... 6-16
6.6 Gathering information about your development platform ....................................... 6-19
6.7 Creating algorithms for a Flash type supported by RealView Debugger ............... 6-20
6.8 Creating algorithms for a Flash type not provided with RealView Debugger ......... 6-23
6.9 Creating the Flash-level and board-level AME files ............................................... 6-29
6.10 Generating the FME file ......................................................................................... 6-34
6.11 Checking the FME file with the dispflash utility ...................................................... 6-38
6.12 Creating a BCD file ................................................................................................ 6-39
6.13 Programming an image into Flash ......................................................................... 6-44
6.14 Troubleshooting ..................................................................................................... 6-46

Appendix A Connection Properties Reference

A.1 About connection properties reference .................................................................... A-2
A.2 Debug Configuration generic groups and settings ................................................... A-6
A.3 Debug Configuration Advanced_Information settings reference ........................... A-10
A.4 Memory mapping Advanced_Information settings reference ................................ A-20

Appendix B ISSM Configuration Reference

B.1 Cortex-A8 model configuration ................................................................................ B-2
B.2 Cortex-M0 model configuration .............................................................................. B-10
B.3 Cortex-M1 model configuration .............................................................................. B-17
B.4 Cortex-M3 model configuration .............................................................................. B-25
B.5 Cortex-R4 model configuration .............................................................................. B-33