RealView Debugger Trace User Guide

Chapter 1 Introduction to Tracing

1.1 About Tracing in RealView Debugger ...................................................................... 1-2
1.2 Requirements for tracing ......................................................................................... 1-3
1.3 Features for setting up the conditions for trace capture .......................................... 1-5
1.4 Tracing with RealView Debugger commands .......................................................... 1-6
1.5 Available resources ................................................................................................. 1-7
1.6 Using the examples ................................................................................................. 1-9

Chapter 2 Getting Started with Tracing

2.1 Preparations for tracing ........................................................................................... 2-2
2.2 About the trace hardware setup ............................................................................... 2-3
2.3 About the Analysis window ...................................................................................... 2-8
2.4 Basic RealView Debugger tracing procedure .......................................................... 2-9
2.5 Configuring trace from a Cortex-R4 processor and a CoreSight ETM .................. 2-13
2.6 Configuring trace from a Cortex-R4 processor and a CoreSight ETB ................... 2-15
2.7 Connecting to an analyzer ..................................................................................... 2-17
2.8 Disconnecting from the Analyzer ........................................................................... 2-18
2.9 Enabling and disabling tracing .............................................................................. 2-19
2.10 Setting up new trace conditions on a running processor ....................................... 2-20
2.11 Capturing trace output ........................................................................................... 2-21
2.12 Profiling trace information ...................................................................................... 2-22

Chapter 3 Configuring the Conditions for Trace Capture

3.1 Setting up the global conditions for trace capture .................................................... 3-2
3.2 Setting up the conditions for profiling captured trace ............................................... 3-3

3.3 Capturing trace without using tracepoints ................................................................ 3-4
3.4 Capturing trace with tracepoints .............................................................................. 3-5
3.5 Setting tracepoints ................................................................................................... 3-6
3.6 Setting tracepoints on exception vectors ................................................................. 3-7
3.7 Configuring common trace options .......................................................................... 3-8

Chapter 4 Configuring the ETM

4.1 About configuring the ETM ...................................................................................... 4-2
4.2 Opening the Configure ETM dialog box ................................................................... 4-3
4.3 Configuring the ETM parameters ............................................................................. 4-5
4.4 Equivalent ETM_CONFIG CLI command qualifiers ............................................... 4-13

Chapter 5 Tracepoints in RealView Debugger

5.1 About tracepoints ..................................................................................................... 5-2
5.2 Tracepoint types ...................................................................................................... 5-3
5.3 Setting trace ranges in conjunction with trace start and end points ......................... 5-7

Chapter 6 Setting Unconditional Tracepoints

6.1 About setting unconditional tracepoints ................................................................... 6-2
6.2 Capturing instructions and data ............................................................................... 6-3
6.3 Setting a trigger point ............................................................................................... 6-4
6.4 Setting a trace start and end point ........................................................................... 6-5
6.5 Setting a trace range ............................................................................................... 6-7
6.6 Setting an ExternalOut Point ................................................................................. 6-10
6.7 Equivalent CLI commands used by the New Tracepoint dialog box ...................... 6-11
6.8 Setting a trace range for selected source lines or disassembly ............................. 6-13
6.9 Setting unconditional tracepoints with the Create Tracepoint dialog box .............. 6-14
6.10 Setting tracepoints from your Favorites List .......................................................... 6-17

Chapter 7 Setting Conditional Tracepoints

7.1 About setting conditional tracepoints ....................................................................... 7-2
7.2 Common parameters for setting conditional tracepoints ......................................... 7-3
7.3 Setting a tracepoint to trace a specific memory access ......................................... 7-10
7.4 Setting a tracepoint to trace a specific data value ................................................. 7-11
7.5 Setting tracepoints to test for external conditions .................................................. 7-12
7.6 Setting a tracepoint that activates after a number of passes ................................. 7-13
7.7 Setting tracepoints to trace accesses of a specific size ......................................... 7-14
7.8 Setting tracepoints to trace instruction execution status ........................................ 7-16
7.9 Setting tracepoints to trace accesses on a specific security level ......................... 7-18
7.10 Setting a Trace on X after Y [and/or Z] tracepoint chain ........................................ 7-20
7.11 Setting a Trace on X after Y executed N times tracepoint chain ........................... 7-22
7.12 Setting a Trace on X after A==B tracepoint chain ................................................. 7-24
7.13 Setting a Trace if A==B in X tracepoint chain ........................................................ 7-26
7.14 Chaining tracepoints .............................................................................................. 7-28

Chapter 8 Managing Tracepoints

8.1 About managing tracepoints .................................................................................... 8-2
8.2 Editing tracepoints ................................................................................................... 8-3
8.3 Disabling tracepoints ............................................................................................... 8-4
8.4 Deleting tracepoints ................................................................................................. 8-5
8.5 Creating tracepoint favorites .................................................................................... 8-6
8.6 Finding source code corresponding to a tracepoint ................................................. 8-8

Chapter 9 Analyzing Trace with the Analysis Window

9.1 About analyzing trace with the Analysis window ..................................................... 9-2
9.2 Changing the displayed trace details ....................................................................... 9-4
9.3 Viewing the captured trace .................................................................................... 9-11
9.4 Finding information in captured trace .................................................................... 9-16
9.5 Filtering information in captured trace ................................................................... 9-22

9.6 Viewing source for the captured trace ................................................................... 9-29
9.7 Viewing captured profiling information ................................................................... 9-30
9.8 Copying selected text from the trace output .......................................................... 9-42
9.9 Saving and loading trace information .................................................................... 9-43
9.10 Changing the current connection ........................................................................... 9-47
9.11 Attaching the Analysis window to the current connection ...................................... 9-48
9.12 Mapping Analysis window options to CLI commands and qualifiers ..................... 9-49

Chapter 10 Tracing Tutorial

10.1 About the tracing tutorial ........................................................................................ 10-2
10.2 Preparing to start the tracing tutorial ...................................................................... 10-5
10.3 Running from application reset to a breakpoint ..................................................... 10-7
10.4 Running to a second breakpoint .......................................................................... 10-11
10.5 Using a trace start point ....................................................................................... 10-15
10.6 Using trace start and end points to trace and time a function .............................. 10-18
10.7 Comparing trace start and end points with a trace range .................................... 10-24
10.8 Excluding a trace range to avoid tracing a function ............................................. 10-34
10.9 Tracing data with auto trace ................................................................................ 10-40
10.10 Tracing data with trace ranges ............................................................................ 10-48
10.11 Tracing data accesses to a specific address ....................................................... 10-53
10.12 Tracing data accesses to addresses in an address range .................................. 10-58
10.13 Collecting trace on a running target ..................................................................... 10-62
10.14 Using triggers to collect trace around a specific instruction ................................. 10-67
10.15 Using triggers to collect trace around a specific data access .............................. 10-75
10.16 Capturing profiling information ............................................................................. 10-84
10.17 Setting up a conditional tracepoint ....................................................................... 10-91

Appendix A Setting up the Trace Hardware

A.1 RealView Trace and RealView ICE ......................................................................... A-2
A.2 Embedded Trace Buffer and RealView ICE ............................................................ A-3
A.3 Embedded Trace Buffer and DSTREAM ................................................................. A-4

Appendix B Setting up the Trace Software

B.1 Configuring trace capture from an ETM with RealView Trace ................................. B-2
B.2 Configuring trace capture from an ETB with DSTREAM or RealView ICE .............. B-3
B.3 Configuring trace capture from a CoreSight ETM with RealView Trace .................. B-5
B.4 Configuring trace capture from a CoreSight ETB with DSTREAM and RealView ICE ...B-7

Appendix C Status Messages in Captured Trace

C.1 Error messages ....................................................................................................... C-2
C.2 Warning messages .................................................................................................. C-4