TRACE32 Directory

Home , NuttX, Symbian

TRACE32 Directory

TRACE32 Online Help

TRACE32 Index

TRACE32 Directory ...... 1

Version 22-Mar-2018

Directory and Index

About the TRACE32 Online Help ...... (main.pdf) 1

TRACE32 Glossary ...... (glossary.pdf) 1

History ...... 3

Terms, Abbreviations, and Definitions ...... 4

Terms with Explanations and Examples ...... 6 Access Classes 6 Address Spaces 12 Address Types 14 Build Path 17 Chip Timestamp 18 Cycle-accurate Tracing 18 Machine ID 19 Multicore Debugging 20 Multiprocessor Debugging 20 OS-aware Debugging 20 OS-aware Tracing 21 Run-time Memory Access 30 Sample-based Profiling 38 Space ID 38 StopAndGo Mode 38 Symmetrical Multi-Processing (SMP) 39 TRACE32 Virtual Memory 39 Trace Errors 43 Trace Sources 46 Tool Timestamp 47

ICD Quick Installation

ICD Quick Installation ...... (icd_quick_installation.pdf) 1

Warning ...... 3

Introduction ...... 4 How This Manual is Organized 4 Contacting Support 4

Brief Overview of Documents for New Users ...... 6

System Concept ...... 7 On-chip Debug Interface 7 On-chip Debug Interface plus Trace Port 11 NEXUS 16 µTrace for Cortex-M 19 CombiProbe 20

Power Integrator and Power Trace / Ethernet ...... 23

Software Installation ...... 24 MS Windows 24 PC_LINUX 27 POWERDEBUG/TRACE ETHERNET on SunOS, Solaris (SUN) 35 POWERDEBUG/TRACE ETHERNET on HP-UX 10.X (HP-9000) 39 Mac OS 42

Troubleshooting ...... 45

FAQ ...... 49

T32Start

T32Start ...... (app_t32start.pdf) 1

Abstract ...... 3

Quick Start ...... 6 First Steps 6 Debug Environment for a Single Core 7 Debug Environment for a Single Core with Power Debug II / Power Trace II 14 Debug Environment for Multicore Debugging (Single Device Solution) 22 Debug Environment for Multiprocessor Debugging 34

Software-only Debugging (Host MCI) ...... 36

©1989-2018 Lauterbach GmbH TRACE32 Directory 5 Debug Environment for Setup 1 (Single Instance) 37 Debug Environment for Setup 2 (Integrated Server) 39 Debug Environment for Setup 3 (Dedicated Server) 41

Modification of Configuration Tree Items ...... 43

Configuration Tree Item Types ...... 46 Complex Tree Items 46

Advanced Actions on Tree Items and Subtrees ...... 61 Mouse Actions 61 Copy and Paste with the Clipboard 62 Load and Store based on Files 62 References to Environment Variables and Tree Items 63

Command Line Interpretation ...... 64

Error Messages ...... 65

Establish Your Debug Session

Establish Your Debug Session ...... (tutor_setup.pdf) 1

Establish your Debug Session ...... 4 Key TRACE32 Setup Commands 4 Debug Scenarios 10

Establish the Debug Communication ...... 12

Debug Scenario 1 ...... 18 Onchip/NOR Flash Programming 19 Configure the TRACE32 OS-Awareness 36

Debug Scenario 2 ...... 37 Typical Boot Sequence 37 Flash Programming (NAND/Serial/eMMC) 42 Establish the Communication 56 Load the Debug Symbols 56

Debug Scenario 3 ...... 57 Run the Boot Loader 58 Load Application (and/or OS) Code and Debug Symbols 59 Load Debug Symbols only 59 Configure the TRACE32 OS-Awareness 59 Complete Setup Example 59

Debug Scenario 4 ...... 60 Write a Script to Configure the Target 61 Load Application (and/or OS) Code and Debug Symbols 61 Configure the TRACE32 OS-Awareness 61

ICD Tutorial

ICD Tutorial ...... (icd_tutorial.pdf) 1

About the Tutorial ...... 2

Working with the Debugger ...... 3 Set up the Program Environment 3 Start TRACE32-ICD 4

Main Window of TRACE32 ...... 5 About TRACE32 6 Getting Online Help 7 Set up the Debug Environment 9 PRACTICE Scripts 14 The User Interface 16 Display and Modify Memory 18 Debug the Program 20 How to Set Breakpoints 26 Display and Modify HLL Variables 36 Format HLL-Variables 39 Exit TRACE32 41

IDE User Interface

IDE User's Guide

IDE User's Guide ...... (ide_user.pdf) 1

History ...... 5

Structure and Contents of the Documentation ...... 5 Online Documentation 5 In-Circuit Debugger TRACE32-ICD 7 In-Circuit Emulator TRACE32-ICE 8 Fully Integrated RISC Emulator TRACE32-FIRE 10

Program Start ...... 12 In-Circuit Debugger TRACE32-ICD 12 In-Circuit Emulator TRACE32-ICE 12 Fully Integrated RISC Emulator TRACE32-FIRE 13

Program End ...... 14

Screen Display ...... 15 Concept 15 Graphical User Interface 15 Main Menu Bar 18 Accelerators 18 Main Toolbar 19 Work Area 19 Message Line 20 Softkeys 21 State Line 22 Window Pages 26 Colors 27 How the TRACE32 PowerView GUI Assists You in Scripting 28

Commands ...... 30 Command Structure 30 Long Form and Short Form of Commands and Functions 31 Entering Commands 32 Command History 34 Command and Function Parameters 35

General Command Parameter Parser - Behavior in the Different Radix Modes ...... 47 Parser Changes in Version V2.00 and Higher 47

Window System ...... 59 Windows 59 Window Operations 63 Text-based Functions 72 Selection Service 72

Message Windows ...... 73

Window Tracking ...... 74

File and Folder Operations ...... 76

File Contents ...... 77

Encrypt/Execute Encrypted Files ...... 78

Host Commands ...... 79

Printer Operations ...... 80

System Setup and Configuration ...... 82

Command Logging ...... 83

Dialog Programming ...... 84 Dialog Syntax and File Types 84 Comments in Dialogs 86 Dialog Commands 87 Dialog Elements 88 Return Values and Labels 90 PRACTICE Macros inside Dialog Definitions 91

HELP System ...... 92 Ways to Get Help 92 Context-Sensitive Help 93 Structure of the Help System 94 Configure the Help System 95 Recommendations for Choosing a PDF Viewer 96 Bookmarks for Help Topics 97 Troubleshooting the Help System 99 Change the Installation Path of the PDF Files 100 Winhelp Compatibility 100

Previous Releases - HELP System ...... 101 Previous Releases - HELP Installation and Setup 101 Previous Releases - Configuring an Alternate PDF Viewer 101 Previous Releases - HELP Installation Problems 105

InterCom ...... 107

Editing ...... 109

Icons ...... 110 Built-in Icons and Icon Library 111 Inserting a Placeholder for User-Defined Icons 112 Drawing Icons 113

Interface ...... 115

Shortcuts ...... 116

IDE Reference Guide

IDE Reference Guide ...... (ide_ref.pdf) 1

History ...... 11

ABORT ...... 12 ABORT Abort driver program 12

AREA ...... 13 AREA Message windows 13 AREA.CLEAR Clear area 14 AREA.CLOSE Close output file 14 AREA.Create Create or modify message area 15 AREA.Delete Delete message area 16 AREA.List Display a detailed list off all message areas 17 AREA.OPEN Open output file 19 AREA.RESet Reset areas 20 AREA.SAVE Save AREA window contents to file 20 AREA.Select Select area 21 AREA.view Display message area in AREA window 22

AutoSTOre ...... 23 AutoSTOre Save and restore settings (history, GUI, etc.) automatically 23

BITMAPEDIT ...... 25 BITMAPEDIT Bitmap editor for user-defined icons 25

ChDir ...... 26 ChDir Change directory 26

ClipSTOre ...... 27 ClipSTOre Store settings to clipboard 27

CmdPOS ...... 28 CmdPOS Controls the position of TRACE32 in MWI window mode 28

ComPare ...... 30 ComPare Compare files 30

DATE ...... 32 DATE Display date and time 32

DEL ...... 33 DEL Delete file 33

DIALOG ...... 34 DIALOG Custom dialogs 34 Dialog Definition Programming Commands 34 DIALOG.AREA Adds an output area to a custom dialog 73 DIALOG.DIR Display a folder picker dialog 74 DIALOG.Disable Disable dialog elements 75 DIALOG.Enable Enable dialog elements 76 DIALOG.END Close the dialog window 76 DIALOG.EXecute Execute a dialog button 76 DIALOG.File Pass file name from OS file dialog to PRACTICE script 77 DIALOG.File.open Display an OS file-open dialog 78 DIALOG.File.SAVE Display an OS file-save dialog 79 DIALOG.File.SELECT Display an OS file-select dialog 80 DIALOG.MESSAGE Create dialog box with an information icon 81 DIALOG.OK Create dialog box with an exclamation mark 82 DIALOG.Program Interactive programming 83 DIALOG.ReProgram Dialog programming 84 DIALOG.SELect Programmatically focus on this dialog 84 DIALOG.Set Modify the value of a dialog element 85 DIALOG.SetDIR Browse for folder 87 DIALOG.SetFile Pass file name from OS file dialog to custom dialog 88 DIALOG.SetFile.open OS file-open dialog > file name > EDIT element 88 DIALOG.SetFile.SAVE OS file-save dialog > file name > EDIT element 90 DIALOG.SetFile.SELECT OS file-select dialog > file name > EDIT element 90 DIALOG.view Show dialog window 91 DIALOG.YESNO Create dialog box with YES and NO buttons 92

DIR ...... 93 DIR List subdirectories and files 93

DUMP ...... 95 DUMP Binary file dump 95

EDIT ...... 97 EDIT TRACE32 editor 97 EDIT.CLOSE Close a text file 97 EDIT.EXTern Use specified external ASCII editor to edit file 98 EDIT.file Edit file 99

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 1 EDIT.List List editor files 100 EDIT.LOAD Load text files 100 EDIT.OPEN Use internal TRACE32 editor to edit file 101 EDIT.QUIT Discard modifications 102 EDIT.SAVE Store a text file 103

ERROR ...... 104 ERROR.RESet Reset PRACTICE error 104

EVAL ...... 105 Eval Evaluates expression 105

FIND ...... 107 FIND Search in file 107

FramePOS ...... 108 FramePOS Controls the position of TRACE32 in MDI window mode 108

HELP ...... 111 HELP Online help 111 HELP.Bookmark Show help bookmark list 112 HELP.Bookmark.ADD Files on bookmark list 113 HELP.Bookmark.ADD.file Add file to bookmark list 113 HELP.Bookmark.ADD.Find Add file to bookmark list 114 HELP.Bookmark.ADD.Index Add file to bookmark list 115 HELP.Bookmark.DELete Delete from bookmark list 115 HELP.Bookmark.show Show help bookmark list 116 HELP.checkUPDATE Automatic update check for new help-files 116 HELP.command Command related support 116 HELP.FILTER Filters for online help 117 HELP.FILTER.Add Add a filter to the filter list 117 HELP.FILTER.Delete Delete filter from filter list 118 HELP.FILTER.RESet Remove all help filters 118 HELP.FILTER.set Enable filters for online help 119 HELP.Find Perform a full-text search 120 HELP.Index Search in indexed terms, commands, and functions 122 HELP.PDF Open PDF file 124 HELP.PICK Context-sensitive help 124 HELP.PRinT Print help files 125 HELP.PRinT.PRinTSel Print selected files 125 HELP.PRinT.SELect Select files to print 125 HELP.PRinT.show Show print help files 126 HELP.PRinT.UNSELect Unselect all print files 126 HELP.Topics Help content list - document tree 127 HELP.TREE Display command tree 129 HELP.WINHELP Open a winhelp file 130

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 2 HISTory ...... 131 HISTory Command history of last executed commands 131 HISTory.eXecute Execute command history 131 HISTory.SAVE Store command history log 132 HISTory.Set History settings 133 HISTory.SIZE Command history and file history 134 HISTory.SIZE.cmd Define log size of command history 134 HISTory.SIZE.FILE Define number of recently used files in 'File' menu 135 HISTory.type Display command history log of last executed commands 135

IFCONFIG ...... 136 IFCONFIG Ethernet or USB communication 136 IFCONFIG.PROfile Display operation profiles 136 IFCONFIG.TEST Test interface function and speed 138 IFCONFIG.state Interface configuration 139

INTERCOM ...... 141 INTERCOM Data exchange between different TRACE32 systems 141 INTERCOM.Evaluate Evaluate function via INTERCOM 142 INTERCOM.execute Execute command via INTERCOM 143 INTERCOM.executeNoWait Execute command via INTERCOM 143 INTERCOM.PING Test INTERCOM system 144 INTERCOM.PipeCLOSE Close named pipe 144 INTERCOM.PipeOPEN Open named pipe 145 INTERCOM.PipeREAD Read from named pipe 145 INTERCOM.PipeWRITE Write to named pipe 145 INTERCOM.WAIT Wait for remote INTERCOM system 146

LICENSE ...... 147 LICENSE Manage TRACE32 licenses 147 LICENSE.List Display all license information 147 LICENSE.REQuest Request a license 148 LICENSE.state Display the currently used maintenance contract 149 LICENSE.UPDATE Update the maintenance contract 150

LOG ...... 151 LOG Log TRACE32 commands 151 LOG.CLOSE Close command log 151 LOG.OFF Switch off command log 152 LOG.ON Switch on command log 152 LOG.OPEN Open command log file 153 LOG.toAREA Log commands by writing them to an AREA window 154 LOG.type Display command log 158

LS ...... 158 LS Display directory 158

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 3 MENU ...... 159 MENU Customize the user interface TRACE32 PowerView 159 MENU.AddMenu Add one standard menu item 159 MENU.AddTool Add a button to the main toolbar 160 MENU.Delete Delete nested menu 161 MENU.Program Interactive programming 161 MENU.ReProgram Menu programming 162 MENU.RESet Default configuration 164 Programming Commands 165

MKDIR ...... 178 MKDIR Create new directory 178

MV ...... 179 MV Rename file 179

OS ...... 180 OS Execute host commands 180 OS.Area Re-route host command output to AREA window 181 OS.Command Execute a host command 182 OS.Hidden Execute a host command in silent mode 184 OS.screen Call up the shell or execute host command 185 OS.Window Re-route host command output to the OS.Window 187

PACK ...... 188 PACK Compress files (with LZW algorithm) 188

PATCH ...... 189 PATCH Binary file patching 189

PATH ...... 190 PATH Define searchpath 190

PRinTer ...... 191 PRinTer Print and export window contents 191 PRinTer.Area Re-route printer output to AREA window in specified format 192 PRinTer.ClipBoard Re-route printer output to clipboard in specified format 193 PRinTer.CLOSE Close file after multiple printer outputs 193 PRinTer.EXPORT Export formatted printer output to file 194 PRinTer.FILE Re-route printer output to a file in specified file format 198 PRinTer.FileType Select file format 201 PRinTer.HardCopy Make a hardcopy of the screen 202 PRinTer.OFFSET Specify print-out borders 203 PRinTer.OPEN Re-route multiple printer outputs to the same file 204 PRinTer.PRINT Print to opened printer file 206 PRinTer.select Select printer 207 PRinTer.SIZE Specify print-out size 208

PWD ...... 209

QUIT ...... 210 QUIT Return to operating system 210

REN ...... 211 REN Rename file 211

RM, RMDIR ...... 212 RM Delete file 212 RMDIR Remove directory 212

SCreenShot ...... 213 SCreenShot Save a screenshot of a window to a file 213

SETUP ...... 215 SETUP Setup commands (part 1 of 2) 215 SETUP.ASCIITEXT Configure ASCII text display 216 SETUP.BAKfile Set backup file mode 217 SETUP.CClear Erase caches 217 SETUP.COLOR Change colors 218 SETUP.DEVNAME Set logical device name 219 SETUP.DRV Send command to driver 220 SETUP.EDITEXT Define an external editor 221 SETUP.EXTension Set default file name extensions 223 SETUP.HOLDDIR Configure working directory 225 SETUP.ICONS Display icons in popup menus 225 SETUP.INTERCOMACKTIMEOUT Sets the intercom acknowledge timeout 226 SETUP.MEMory Display free and used SCU memory 226 SETUP.PDFViewer Context-sensitive help via your favorite PDF viewer 227 SETUP.PDFViewer.EXEcutable Path and executable of your PDF viewer 228 SETUP.PDFViewer.OPEN Open a PDF of the help system 228 SETUP.PDFViewer.PRinT Print PDF via HELP window 228 SETUP.PDFViewer.RESet Reset the settings in SETUP.PDFViewer dialog 229 SETUP.PDFViewer.TEMPorary Help configuration for demo purposes 230 SETUP.PDFViewer.TEMPorary.EXEcutable PDF viewer for demo purposes 230 SETUP.PDFViewer.TEMPorary.OPEN Open a PDF of the help system 230 SETUP.PDFViewer.TEMPorary.PRinT Print PDF via HELP window 230 SETUP.PDFViewer.TEMPorary.RESet Reset demo-help configuration 231 SETUP.QUITDO Define quit PRACTICE script file 232 SETUP.RADIX Radix mode 233 SETUP.RANDOM Set seed for RANDOM() function 234 SETUP.ReDraw Update whole screen 234 SETUP.RESTARTDO Define restart PRACTICE script file 234 SETUP.SOUND Set sound generator mode 235 SETUP.STATistic Cache and memory usage 235 SETUP.STOre Configure output of the STOre commands 236

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 5 SETUP.TabSize Configure tab width 237 SETUP.TIMEFORM Select scientific time format 238 SETUP.UpdateRATE Update rate for windows 239 SETUP.WARNSTOP Configure PRACTICE stops 240 SETUP.XSLTSTYLESHEET Reference to XSLT stylesheet for XML files 241

SILENT ...... 242 SILENT Suppress informational messages in AREA window 242

SOFTKEYS ...... 243 SOFTKEYS Toggle the buttons on the softkey bar 243

STATUSBAR ...... 244 STATUSBAR Toggle state line 244

STOre ...... 245 STOre Store a setting 245

SUBTITLE ...... 246 SUBTITLE Define a window subtitle for AMP debugging 246

TAR ...... 248 TAR Pack files into an archive 248

TIMEOUT ...... 250 TIMEOUT Specify time-out for TRACE32 command 250

TITLE ...... 251 TITLE Define a screen title for TRACE32 PowerView GUI 251

TOOLBAR ...... 252 TOOLBAR Toggle toolbar 252

TYPE ...... 253 TYPE Display text file 253

UNARchive ...... 254 UNARchive Linux and Microsoft libraries 254 UNARchive.extract Extract files from Linux library and Microsoft library 254 UNARchive.Show Extract files from library and list them in window 255 UNARchive.Table Display table of contents of library 255

UNPACK ...... 256 UNPACK Expand files (with LZW algorithm) 256

UNZIP ...... 257 UNZIP Expand GZIP archive file (with DEFLATE algorithm) 257

VERSION ...... 258 VERSION TRACE32 version information 258 VERSION.ENVironment Display environment settings 258 VERSION.HARDWARE Display hardware versions 259 VERSION.SOFTWARE Display software versions 259

WELCOME ...... 261 WELCOME Welcome to TRACE32 261 WELCOME.CONFIG Configure search paths for PRACTICE demo scripts 261 WELCOME.CONFIG.ADDDIR Add a new script search path 262 WELCOME.CONFIG.FILTER Set the script search filter 262 WELCOME.CONFIG.ReMoveDIR Remove a script search path 262 WELCOME.CONFIG.RESet Reset the script search configuration 262 WELCOME.CONFIG.state Open the welcome config window 263 WELCOME.SCRIPTS Open the script search window 264 WELCOME.STARTUP Open the welcome window if not disabled 264 WELCOME.view Open the welcome window 265

Window ...... 266 Win Window handling (size, position, font size, etc.) 266 WinBack Generate background window 267 WinCLEAR Erase windows 267 WinDEFaultSIZE Apply a user-defined default size to windows 269 WinDuplicate Duplicate window 270 WinExt Generate external window 270 WinFIND Search for text in window 271 WinFreeze Generate frozen window 273 WinLarge Generate window with large font 274 WinMid Generate window with regular font 274 WinOverlay Pile up windows on top of each other 275 WinPAGE Window pages 276 WinPAGE.Create Create and select page 277 WinPAGE.Delete Delete page 277 WinPAGE.List Display an overview of all pages and their windows 278 WinPAGE.REName Rename page 279 WinPAGE.RESet Reset window system 279 WinPAGE.select Select page 279 WinPAN Specify a window cut-out 280 WinPOS Define window dimensions and window name 281 WinPrint Print window 284 WinPRT Hardcopy of window 284 WinResist Generate a resistant window 285 WinRESIZE New size for window 286 WinSmall Generate window with small font 287 WinTABS Specify size of re-sizable columns 287 WinTOP Bring window to top 288 WinTrans Generate transparent window 289

ZERO ...... 290

ZIP ...... 291 ZIP Compress files to GZIP archive (with DEFLATE algorithm) 291

Appendix A - Help Filters ...... 292

PRACTICE Script Language

PRACTICE Script Language User's Guide

PRACTICE Script Language User's Guide ...... (practice_user.pdf) 1

History ...... 2

Why Use PRACTICE Scripts ...... 3

Related Documents ...... 5

A ... D ...... 6 APPEND Append to file 6 BEEP Acoustic signal 6 CLOSE Close file 7 CONTinue Continue PRACTICE script 7 DECRYPT Decrypts a text or binary file 8 DO Start PRACTICE script 9 DODECRYPT Execute encrypted PRACTICE script (*.cmm) 10

E ... F ...... 11 ECHO Write text and data to an AREA window (with format decoration) 11 ELSE Conditional script execution 13 ENCRYPT Encrypt a text or binary file 14 ENCRYPTDO Encrypt a PRACTICE script (*.cmm) 15 ENCRYPTPER Encrypt a PER file (*.per) 16 END Terminate PRACTICE scripts, etc. 17 ENDDO Return from a PRACTICE script 18 ENTER Window-based input 19 ENTRY Parameter passing 21

G ... H ...... 22 GLOBAL Create global PRACTICE macro 22 GLOBALON Global event-controlled PRACTICE script execution 23 GOSUB Subroutine call 28 GOTO Local script jump 29

I ... L ...... 30 IF Conditional script execution 30 INKEY Character input 31 JUMPTO Global script jump 31 LOCAL Create local PRACTICE macro 32

M ... O ...... 34 ON Event-controlled PRACTICE script execution 34 OPEN Open data file 38

P ...... 39 PARAMETERS Parameter fetching 39 PBREAK Breakpoints in PRACTICE script files (*.cmm) 40 PBREAK.at Deprecated 40 PBREAK.Delete Delete breakpoint 41 PBREAK.DISable Disable breakpoint 41 PBREAK.ENable Enable breakpoint 42 PBREAK.List Display breakpoint list 43

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 9 PBREAK.OFF TRACE32 disables breakpoint handling 44 PBREAK.ON TRACE32 re-enables breakpoint handling 45 PBREAK.RESet Clear all breakpoints 45 PBREAK.Set Add breakpoint 46 PEDIT Edit PRACTICE script 49 PLIST List PRACTICE script 50 PMACRO PRACTICE macros 51 PMACRO.EXPLICIT Enforce explicit PRACTICE macro declaration 51 PMACRO.IMPLICIT Implicit PRACTICE macro declaration 53 PMACRO.list Display PRACTICE macros 54 PMACRO.LOCK Lock PRACTICE macros 54 PMACRO.RESet Clear current PRACTICE macros 55 PMACRO.UNLOCK Unlock PRACTICE macros 55 PRINT Write text and data to an AREA window (without format decoration) 56 PRINTF Write formatted data to an AREA window 60 PRIVATE Create private PRACTICE macro 68 PSKIP Skip command or block in PRACTICE script 70 PSTEP Execute single line 71 PSTEPOUT Back to caller 72 PSTEPOVER Step over callee and stop at the next script line 73

Q ... R ...... 74 READ Read from data file 74 RePeaT Loop with check at end of loop 75 RETURN Return from subroutine 77 RETURNVALUES Take return values 78 RUN Start PRACTICE script 79

S ... T ...... 80 SCREEN Screen updating 80 SCREEN.ALways Refresh always 80 SCREEN.display Refresh screen 81 SCREEN.OFF No refresh 81 SCREEN.ON Refresh when printing 81 SCREEN.WAIT Update screen while waiting 82 SPRINTF Write formatted data to a PRACTICE macro 84 STOP Interrupt PRACTICE script 85

W ... Z ...... 86 WAIT Wait until a condition is true or a period has elapsed 86 WHILE Loop with check at start of loop 88 WRITE Write to data file 89 WRITEB Write binary data to file 90

IDE Functions

IDE Functions ...... (ide_func.pdf) 1

History ...... 8

In This Document ...... 9

AREA Functions ...... 10 In This Section 10 AREA.COUNT() Number of existing message areas 10 AREA.EXIST() Check if message area exists 10 AREA.LINE() Extract line from message area 11 AREA.MAXCOUNT() Maximal number of message areas 11 AREA.NAME() Names of existing message areas 12 AREA.SELECTed() Name of active message area 12 AREA.SIZE.COLUMNS() Columns of a message area 13 AREA.SIZE.LINES() Lines of a message area 13

CLOCK Functions ...... 13

CONFIG Function ...... 13 CONFIG.SCREEN() Check if screen output is switched on 13

CONVert Functions ...... 14 In This Section 14 CONVert.ADDRESSTODUALPORT() Dualport access class 14 CONVert.ADDRESSTONONSECURE() Non-secure access class 15 CONVert.ADDRESSTOSECURE() Secure accesss class 15 CONvert.BOOLTOINT() Boolean to integer 16 CONVert.CHAR() Integer to ASCII character 16 CONVert.FLOATTOINT() Float to integer 17 CONVert.HEXTOINT() Hex to integer 17 CONVert.INTTOBOOL() Integer to boolean 17 CONVert.INTTOFLOAT() Integer to floating point value 18 CONVert.INTTOHEX() Integer to hex 19 CONVert.INTTOMASK() Compose bit-mask from integer value and mask 19 CONVert.MASKMTOINT() Bits set to don't-care in given bit-mask 20 CONVert.MASKTOINT() Bits set to 1 in given bit-mask 20 CONVert.OCTaltoint() Octal to decimal 21 CONVert.SignedByte() 1 byte to 8 bytes 21 CONVert.SignedLong() 4 bytes to 8 bytes 22 CONVert.SignedWord() 2 bytes to 8 bytes 22 CONVert.TIMEMSTOINT() Time to milliseconds 23 CONVert.TIMENSTOINT() Time to nanoseconds 23

©1989-2018 Lauterbach GmbH TRACE32 Directory 2 1 CONVert.TIMESTOINT() Time to seconds 24 CONVert.TIMEUSTOINT() Time to microseconds 24 CONVert.TOLOWER() String to lower case 25 CONVert.TOUPPER() String to upper case 25

DATE Functions ...... 26 In This Section 26 DATE.DATE() Current date 26 DATE.DAY() Today’s date 26 DATE.MakeUnixTime() Date to Unix timestamp 27 DATE.MONTH() Number of current month 27 DATE.SECONDS() Seconds since midnight 28 DATE.TIME() Current time 28 DATE.TimeZone() Timezone identifier and hh:mm:ss 28 DATE.UnixTime() Seconds since Jan 1970 29 DATE.utcOffset() Offset of current local time to UTC 29 DATE.YEAR() Current year 29

DIALOG Functions ...... 30 In This Section 30 DIALOG.BOOLEAN() Current boolean value of checkbox 30 DIALOG.EXIST() Existence of dialog element 31 DIALOG.STRing() Current string value of dialog element, e.g. EDIT box 32 DIALOG.STRing2() Comma-separated list of values, e.g. from LISTBOX 33

ERROR Functions ...... 34 In This Section 34 ERROR.ID() ID of last error message 34 ERROR.OCCURRED() Error status 35

EVAL Functions ...... 36 In This Section 36 EVAL() Value of expression evaluated with EVAL command 36 EVAL.STRing() String composed by expression evaluated with EVAL cmd. 36 EVAL.TYPE() Type of expression evaluated with EVAL command 36

FALSE Function ...... 37 FALSE() Boolean expression 37

FILE Functions ...... 38 In This Section 38 __FILE__() Directory of current PRACTICE script 38 __LINE__() Number of script line to be executed next 38 FILE.EOF() Check if end of read-in file has been reached 38 FILE.EOFLASTREAD() Check if last read from file reached the end of the file 39 FILE.EXIST() Check if file exists 39 FILE.OPEN() Check if file is open 40

FORMAT Functions ...... 41 In This Section 41 FORMAT.BINary() Numeric to binary value (leading spaces) 41 FORMAT.CHAR() Numeric to ASCII character (fixed length) 41 FORMAT.Decimal() Numeric to string (leading spaces) 42 FORMAT.DecimalU() Numeric to unsigned decimal as string (leading spaces) 43 FORMAT.DecimalUZ() Numeric to unsigned decimal as string (leading zeros) 45 FORMAT.FLOAT() Floating point value to string 46 FORMAT.HEX() Numeric to hex (leading zeros) 46 FORMAT.STRing() Output string with fixed length 47 FORMAT.TIME() Time to string (leading spaces) 48 FORMAT.UDECIMAL() Refer to FORMAT.DecimalU() 48 FORMAT.UDECIMALZ() Refer to FORMAT.DecimalUZ() 49 FORMAT.UnixTime() Format Unix timestamps 49

FOUND Functions ...... 53 In This Section 53 FOUND() TRUE() if search item was found 53 FOUND.COUNT() Number of occurrences found 54

GDB Function (TRACE32 as GDB Back-End) ...... 55 GDB.PORT() Port number for communication via GDB interface 55

HELP Function ...... 56 HELP.MESSAGE() tbd. 56

HOST Functions ...... 57 HOSTID() Host ID 57 HOSTIP() Host IP address 57

IFCONFIG and IFTEST Functions ...... 58 In This Section 58 IFCONFIG.COLLISIONS() Collisions since start-up 58 IFCONFIG.CONFIGURATION() Connection type 59 IFCONFIG.DEVICENAME() Name of TRACE32 device 59 IFCONFIG.ERRORS() Errors since start-up 59 IFCONFIG.ETHernetADDRESS() MAC address of TRACE32 device 59 IFCONFIG.IPADDRESS() IP address of TRACE32 device 60 IFCONFIG.RESYNCS() Resyncs since start-up 60 IFCONFIG.RETRIES() Retries since start-up 60 IFTEST.DOWNLOAD() Download in KByte/sec 60 IFTEST.LATENCY() Latency in microseconds 61 IFTEST.UPLOAD() Upload in KByte/sec 61

INTERCOM Functions ...... 62 In This Section 62

©1989-2018 Lauterbach GmbH TRACE32 Directory 2 3 INTERCOM.PING() Check if ping is successful 62 INTERCOM.PODPORT() Port of a TRACE32 PowerView instance 62 INTERCOM.PODPORTNUMBER() Number of PowerView instances 63 INTERCOM.PORT() Port number for communication via intercom interface 63

LICENSE Functions ...... 64 In This Section 64 LICENSE.DATE() Expiration date of maintenance contract 64 LICENSE.FAMILY() Name of the CPU family license 64 LICENSE.FEATURES() List of features licensed 65 LICENSE.getINDEX() Index of maintenance contract 65 LICENSE.GRANTED() License state 65 LICENSE.HAVEFEATURE() Checks if license is stored in debugger hardware 66 LICENSE.MSERIAL() Serial number of the maintenance contract 67 LICENSE.MULTICORE() Check if multicore debugging is licensed 67 LICENSE.SERIAL() Serial number of debug cable 67

Mathematical Functions ...... 68 In This Section 68 math.ABS() Absolute value of decimal value 68 math.FABS() Absolute value of floating point number 68 math.FCOS() Cosine of an angle given in radian 69 math.FEXP() Exponentiation with base e (Euler's number) 69 math.FEXP10() Exponentiation with base 10 69 math.FINF() Positive infinity 69 math.FLOG() Natural logarithm of given value 70 math.FLOG10() Logarithm to base 10 of given value 70 math.FMAX() Return the larger one of two floating point values 70 math.FMIN() Return the smaller one of two floating point values 71 math.FNAN() Not a number value 71 math.FPOW() Y-th power of base x 71 math.FSIN() Sine of an angle given in radian 72 math.FSQRT() Square-root of given value 72 math.MAX() Return the larger one of two decimal values 72 math.MIN() Return the smaller one of two decimal values 73 math.SIGN() Return -1 or +1 depending on argument 73 math.SIGNUM() Return -1 or 0 or +1 depending on argument 73 math.TimeMAX() Return the larger one of two time values 74 math.TimeMIN() Return the smaller one of two time values 74

NODENAME Function ...... 75 NODENAME() Node name of connected TRACE32 device 75

OS Functions ...... 76 In This Section 76 OS.DIR() Check if directory exists 77

©1989-2018 Lauterbach GmbH TRACE32 Directory 2 4 OS.DIR.ACCESS() Access rights to directory 77 OS.ENV() Value of OS environment variable 78 OS.FILE() Check if file exists 78 OS.FILE.ABSPATH() Absolute path to file or directory 79 OS.FILE.ACCESS() Access rights to file 79 OS.FILE.DATE() Modification date and timestamp of file 80 OS.FILE.DATE2() Modification date of file 80 OS.FILE.EXTENSION() File name extension 80 OS.FILE.LINK() Real file name of file link 81 OS.FILE.NAME() Extract file name from path 81 OS.FILE.PATH() Return path of file 82 OS.FILE.REALPATH() Canonical absolute path to file or directory 83 OS.FILE.SIZE() File size in bytes 83 OS.FILE.TIME() Modification timestamp of file 83 OS.FILE.UnixTime() Unix timestamp of file 84 OS.FIRSTFILE() First file name matching a pattern 84 OS.ID() User ID of TRACE32 instance 85 OS.NAME() Basic name of operating system 86 OS.NEXTFILE() Next file name matching a pattern 86 OS.PresentConfigurationFile() Name of used TRACE32 configuration file 86 OS.PresentDemoDirectory() Demo directory for the current architecture 87 OS.PresentExecutableDirectory() Directory of current TRACE32 exe. 87 OS.PresentExecutableFile() Path and file name of current TRACE32 exe. 87 OS.PresentHomeDirectory() Path of the home directory 88 OS.PresentHELPDirectory() Path of the TRACE32 online help directory 88 OS.PresentLicenseFile() Current TRACE32 license file 88 OS.PORTAVAILABLE.TCP() Check if TCP port is used 89 OS.PORTAVAILABLE.UDP() Check if UDP port is used 89 OS.PresentPracticeDirectory() Directory of currently executed script 90 OS.PresentPracticeFile() Path and file name of currently executed script 90 OS.PresentSystemDirectory() TRACE32 system directory 90 OS.PresentTemporaryDirectory() TRACE32 temporary directory 91 OS.PresentWorkingDirectory() Current working directory 91 OS.RETURN() Return code of the last executed operating system command 91 OS.TIMER() OS timer in milliseconds 92 OS.TMPFILE() Name for a temporary file 92 OS.VERSION() Type of the host operating system 93

ProcessID Function ...... 96 ProcessID() Process identifier of a TRACE32 PowerView instance 96

PRACTICE Functions ...... 97 In This Section 97 PRACTICE.ARG() Return value of GOSUB, DO, RETURN, and ENDDO 97 PRACTICE.ARG.SIZE() Number of passed or returned arguments 98

©1989-2018 Lauterbach GmbH TRACE32 Directory 2 5 PRACTICE.CALLER.FILE() File name of the script/subscript caller 99 PRACTICE.CALLER.LINE() Line number in caller script 99 PRACTICE.CoMmanD.AVAILable() Check if command is available 100 PRACTICE.FUNCtion.AVAILable() Check if function is available 100

PRINTER Function ...... 102 PRINTER.FILENAME() Path and file name of next print operation 102

RADIX Function ...... 103 RADIX() Current radix setting 103

RANDOM Functions ...... 104 RANDOM() Pseudo random number 104 RANDOM.RANGE() Pseudo random number from specified range 104

RCL Function ...... 105 RCL.PORT() Port number of remote API interface 105

SOFTWARE Functions ...... 106 In This Section 106 SOFTWARE.64BIT() Check if TRACE32 executable is 64-bit 106 SOFTWARE.BUILD() Upper build number 106 SOFTWARE.BUILD.BASE() Lower build number 106 SOFTWARE.SCUBASED() Controller-based TRACE32 software 107 SOFTWARE.VERSION() Release build or nightly build, etc. 108

STRing Functions ...... 109 In This Section 109 STRing.CHAR() Extract a character 109 STRing.ComPare() Check if string matches pattern 110 STRing.COUNT() Substring occurrences 110 STRing.CUT() Cut string from left or right 111 STRing.FIND() Check if search characters are found within string 111 STRing.LENgth() Length of string 112 STRing.LoWeR() String to lowercase 112 STRing.MID() Extract part of string 112 STRing.Replace() Modified string after search operation 113 STRing.SCAN() Offset of the found string 114 STRing.SCANAndExtract() Extract remaining string after search string 115 STRing.SPLIT() Return element from string list 116 STRing.TRIM() String without leading and trailing whitespaces 116 STRing.UPpeR() String to uppercase 117

TCF Functions (TRACE32 as TCF Agent) ...... 118 TCF.PORT() Port number of TCF interface 118 TCF.DISCOVERY() Check if TCF discovery is enabled 118

TEST Function ...... 119 TEST.TIMEISVALID() Check if time value is valid 119

TITLE Function ...... 121 TITLE() Caption of the TRACE32 main window 121

TRUE Function ...... 121 TRUE() Boolean expression 121

WARNINGS Function ...... 122 WARNINGS() Check if warning occurred during command execution 122

WINDOW Functions ...... 123 In This Section 123 WINdow.COMMAND() Command string displayed in window 123 WINdow.EXIST() Check if window name exists 124 WINdow.POSition() Information on window position and dimension 124 WINPAGE.EXIST() Check if window page exists 125

General Functions

General Functions ...... (general_func.pdf) 1

History ...... 21

In This Document ...... 22 How This Document is Organized 22 Difference between Functions and Commands in TRACE32 23 Purpose of Functions 24 How to Use Functions 25 Which Return Values of Functions can be Printed? 27 Related Documents 27

ACCESS Functions ...... 28 In This Section 28 ACCESS.isGUEST() TRUE if access class belongs to guest 28 ACCESS.isHYPERVISOR() TRUE if access class belongs to hypervisor 29

ADDRESS Functions ...... 30 In This Section 30 ADDRESS.ACCESS() 30 ADDRESS.EXPANDACCESS() Fully qualified access class 30 ADDRESS.isDATA() Check if memory class refers to data 31 ADDRESS.INSTR.LEN() 31 ADDRESS.isGUEST() TRUE if address is guest address 32 ADDRESS.isHYPERVISOR() TRUE if address is hypervisor address 32 ADDRESS.isINTERMEDIATE() Check if intermediate physical address 33 ADDRESS.isNONSECURE() TRUE if non-secure (Trustzone) access 33 ADDRESS.isNONSECUREEX() 33

©1989-2018 Lauterbach GmbH TRACE32 Directory 2 7 ADDRESS.MACHINEID() Extract machine ID 34 ADDRESS.MAU() Minimal addressable unit size (MAU) 35 ADDRESS.OFFSET() Address without class 36 ADDRESS.isONCHIP() TRUE if on-chip address area 36 ADDRESS.isPHYSICAL() TRUE if physical address 36 ADDRESS.isPROGRAM() TRUE if program address 37 ADDRESS.isSECURE() TRUE if secure (Trustzone) access 38 ADDRESS.isSECUREEX() 38 ADDRESS.RANGE.BEGIN() Lowest address value of address range 39 ADDRESS.RANGE.END() Highest address value of address range 39 ADDRESS.RANGE.SIZE() Size of address range 40 ADDRESS.SEGMENT() 40 ADDRESS.STRACCESS() Access class of an address 41

Analyzer Functions ...... 42 In This Section 43 Analyzer() Check if Analyzer command group is available 43 Analyzer.CONFIG.() Check if ICE Analyzer is included 43 Analyzer.CONFIG.() Check if specified PowerTrace connected 44 Analyzer.CONFIG.FEC() Check if FIRE contains Analyzer 45 Analyzer.CONFIG.RISCTRACE() Check if RISC trace module connected 45 Analyzer.COUNTER.EVENT() Get value of trigger program event counter 46 Analyzer.COUNTER.EXTERN() Get value of trigger program ext. counter 46 Analyzer.COUNTER.TIME() Get value of trigger program time counter 47 Analyzer.DSEL() For internal usage only 47 Analyzer.FIRST() Get record number of first trace record 47 Analyzer.FLAG() Check state of trigger program FLAG 48 Analyzer.FLOW.ERRORS() Get number of flow errors / hard errors 48 Analyzer.FLOW.FIFOFULL() Get number of FIFO overflows 48 Analyzer.FOCUS.EYE() Check quality of data eye 49 Analyzer.ISCHANNELUP() Check if serial link is established 50 Analyzer.MAXSIZE() Get max. size of trace buffer in records 51 Analyzer.MODE() Get Analyzer recording mode 51 Analyzer.MODE.FLOW() Check if Analyzer operates as flowtrace 51 Analyzer.PC() Get current PC with FIRE/ICE 51 Analyzer.PROBEREVISION() Get revision of StarCore NEXUS probe 52 Analyzer.RECORDS() Get number of used trace records 52 Analyzer.RECORD.ADDRESS() Get address recorded in trace record 52 Analyzer.RECORD.DATA() Get data recorded in trace record 53 Analyzer.RECORD.OFFSET() Get address in trace record as number 54 Analyzer.RECORD.TIME() Get time stamp of trace record 54 Analyzer.REF() Get record number of reference record 55 Analyzer.SIZE() Get current trace buffer size in records 55 Analyzer.STATE() Get state of Analyzer 56

©1989-2018 Lauterbach GmbH TRACE32 Directory 2 8 Analyzer.THRESHOLD() Get threshold voltage of parallel preprocessor 56 Analyzer.TraceCONNECT() Name of trace sink of the SoC 56 Analyzer.TRACK.RECORD() Get record number matching search 57 Analyzer.TRIGGER.A() Get inputs from ICE TRIGGER A connector 57 Analyzer.TRIGGER.B() Get inputs from ICE TRIGGER B connector 57 Analyzer.TRIGGER.TIME() Time of trigger point in trace 58

ARM Function ...... 59 ARMARCHVERSION() ARM architecture version of CPU 59

Advanced Register Trace (ART) Functions ...... 60 In This Section 60 ART.FIRST() Get record number of first trace record 60 ART.MAXSIZE() Get max. size of trace buffer in records 61 ART.MODE() Get ART recording mode 61 ART.RECORD.ADDRESS() Get address recorded in trace record 61 ART.RECORD.OFFSET() Get address in trace record as number 61 ART.RECORD.TIME() Get time stamp of trace record 62 ART.RECORDS() Get number of used trace records 62 ART.REF() Get record number of reference record 62 ART.SIZE() Get current trace buffer size in records 62 ART.STATE() Get state of ART trace 63 ART.TRACK.RECORD() Get record number matching search 63

AUTOFOCUS Functions ...... 64 In This Section 64 AUTOFOCUS() TRUE if AutoFocus preprocessor attached 64 AUTOFOCUS.OK() TRUE if command execution successful 64 AUTOFOCUS.FREQUENCY() Frequency of trace-port clock 64

AVX Function ...... 65 AVX() Content of AVX register 65

Break Functions ...... 66 In This Section 66 Break.Alpha.EXIST() TRUE if Alpha breakpoint exists 66 Break.Beta.EXIST() TRUE if Beta breakpoint exist 66 Break.Charly.EXIST() TRUE if Charly breakpoint exists 67 Break.Program.EXIST() TRUE if enabled program breakpoint exists 67 Break.ReadWrite.EXIST() TRUE if enabled data address breakpoint exists 67

BMC Functions (Benchmark Counter) ...... 68 In This Section 68 BMC.CLOCK() Frequency of core clock 68 BMC.COUNTER() Value of a benchmark counter 68 BMC.COUNTER.BYNAME() Value of a benchmark counter 69 BMC.COUNTER.CORE() Value of a benchmark counter 69

©1989-2018 Lauterbach GmbH TRACE32 Directory 2 9 BMC.COUNTER.BYNAME.CORE() Value of a benchmark counter 70 BMC.OVERFLOW() TRUE if benchmark counter overflow 70 BMC.OVERFLOW.BYNAME() TRUE if benchmark counter overflow 70 BMC.OVERFLOW.CORE() TRUE if benchmark counter overflow 71 BMC.OVERFLOW.BYNAME.CORE() TRUE if benchmark counter overflow 71

Boundary Scan Description Language (BSDL) Functions ...... 72 In This Section 72 BSDL.CHECK.BYPASS() Chain bypass test 72 BSDL.CHECK.FLASHCONF() Flash configuration test 72 BSDL.CHECK.IDCODE() Chain IDCODE test 72 BSDL.GetDRBit() Data register bit 73 BSDL.GetPortLevel() Port level value 73

CABLE Functions ...... 74 In This Section 74 CABLE.GalvanicISOlation() Cable has galvanic isolation 74 CABLE.GalvanicISOlation.SERIAL() Serial number of adapter 74 CABLE.NAME() Name of debug cable 74 CABLE.SERIAL() Serial number of debug cable 75 CABLE.TWOWIRE() TRUE if two-wire debugging supported 75

CACHE Functions ...... 76 In This Section 76 CACHE.DC.DIRTY() 76 CACHE.DC.DIRTYMASK() 76 CACHE.DC.LRU() 77 CACHE.DC.TAG() 77 CACHE.DC.VALID() 77 CACHE.DC.VALIDMASK() 78 CACHE.IC.DIRTY() 78 CACHE.IC.DIRTYMASK() 78 CACHE.IC.LRU() 79 CACHE.IC.TAG() 79 CACHE.IC.VALID() 79 CACHE.IC.VALIDMASK() 80 CACHE.L2.DIRTY() 80 CACHE.L2.DIRTYMASK() 80 CACHE.L2.LRU() 81 CACHE.L2.SHARED() 81 CACHE.L2.SHAREDMASK() 81 CACHE.L2.TAG() 82 CACHE.L2.VALID() 82 CACHE.L2.VALIDMASK() 82 CACHE.L3.DIRTY() 83

CAnalyzer Functions (CombiProbe, µTrace) ...... 85 In This Section 85 CAnalyzer() Check if CAnalyzer command group is available 86 CAnalyzer.BOTHCables() TRUE if both debug cables are plugged 86 CAnalyzer.CableTYPE() Type of adapter 86 CAnalyzer.DebugCable() CombiProbe whisker cable is A or B 87 CAnalyzer.FIRST() Get record number of first trace record 87 CAnalyzer.MAXSIZE() Get max. size of trace buffer in records 87 CAnalyzer.PIN() Status of trace pins 88 CAnalyzer.RECORD.ADDRESS() Get address recorded in trace record 88 CAnalyzer.RECORD.DATA() Get data recorded in trace record 88 CAnalyzer.RECORD.OFFSET() Get address in trace record as number 89 CAnalyzer.RECORD.TIME() Get time stamp of trace record 89 CAnalyzer.RECORDS() Get number of used trace records 89 CAnalyzer.REF() Get record number of reference record 89 CAnalyzer.SIZE() Get current trace buffer size in records 90 CAnalyzer.STATE() Get state of Compact Analyzer 90 CAnalyzer.TraceCONNECT() Name of trace sink of the SoC 91 CAnalyzer.TracePort() CombiProbe whisker cable is A or B 91 CAnalyzer.TRACK.RECORD() Get record number matching search 91

CERBEURS Functions ...... 92 CERBERUS.IOINFO() IOINFO of Cerberus module 92 CERBERUS.IOINFO.IFLCK() TRUE if IF_LCK bit in Cerberus INONFO set 92

CHIP Functions ...... 93 CHIP.EmulationDevice() TRUE if emulation device 93 CHIP.STEPping() Major silicon step of an TriCore AURIX device 93

CIProbe Functions (Analog Probe for CombiProbe or µTrace) ...... 94 In This Section 94 CIProbe() 94 CIProbe.ADC.ENABLE() 94 CIProbe.ADC.SHUNT() Get shunt-resistor value 94 CIProbe.MAXSIZE() Get max. size of trace buffer in records 95 CIProbe.RECORDS() Get number of used trace records 95 CIProbe.SIZE() Get current trace buffer size in records 95 CIProbe.STATE() Get state of Compact Analyzer for CIProbe 95 CIProbe.TRACK.RECORD() Get record number matching search 96

COMPonent Functions ...... 97

CORE Functions ...... 99 In This Section 99 CONFIGNUMBER() Number of cores configured in TRACE32 100 CORE() Get the selected core 100 CORE.ISACTIVE() TRUE if this core is active 101 CORE.ISASSIGNED() TRUE if physical core is assigned to debug session 102 CORE.LOGICALTOPHYSICAL() This is the physical core number 103 CORE.NAMES() Physical core names assigned to TRACE32 104 CORENAME() Name of core within selected chip 105 CORE.NUMBER() Number of logical cores 105 CORE.PHYSICALTOLOGICAL() Logical core number of physical core 107

Count Functions ...... 108 In This Section 108 Count.Frequency() 108 Count.LEVEL() 108 Count.Time() 109 Count.VALUE() 109

COVerage Functions ...... 110 In This Section 110 COVerage.BDONE() Byte count of all executed instructions 111 COVerage.SCOPE() Degree of code coverage 112 COVerage.TreeWalk() Walk symbol tree 113

CPU Functions ...... 114 In This Section 114 CPU.FEATURE() TRUE if CPU feature exists 114 CPU.PINCOUNT() For internal usage only 115 CPUBONDOUT() Name of boundout processor 116 CPUCOREVERSION() Core or architecture version of CPU 116 CPUDERIVATE() 116 CPUFAMILY() 116 CPUHELP() For internal usage only 116 CPUIS() 117 CPUIS64BIT() 117

DAP Functions ...... 118 DAP.Available() TRUE if debugging via DAP is supported 118 DAP.USER() Status of the DAP user pin 118

Data Functions ...... 119 In This Section 119 Data.() Memory contents in default endianness 119

©1989-2018 Lauterbach GmbH TRACE32 Directory 3 2 Data..() Mem. contents in specified byte order 122 Data..() Mem. contents in specified width 124 Data.AL.ERRORS() Get number of errors detected by Data.AllocList 126 Data.Float() Get floating point number 126 Data.STRing() Get zero-terminated string 127 Data.STRingN() 128 Data.SUM() Get checksum 128 Data.WSTRING() Get zero-terminated wide string 128 Data.WSTRING.BigEndian() Get big-endian wide string 129 Data.WSTRING.LittleEndian() 129

DEBUGMODE Function ...... 130 DEBUGMODE() Current debug mode 130

DISASSEMBLE Function ...... 131 DISASSEMBLE.ADDRESS() Disassembled instruction at address 131

DONGLEID Function ...... 131 DONGLEID(0) Serial number of USB WibuKey 131

ELA Function (ARM Coresight Embedded Logic Analyzer) ...... 132 ELABASE() ELA base address 132

DPP Function (C166/ST10 only) ...... 132 DPP() Content of DPP register 132

EPOC Functions ...... 133 In This Section 133 EPOC.DATAADDRESS() Start address of data area (EPOC debugger) 133 EPOC.ENTRYPOINT() 133 EPOC.TEXTADDRESS() 133

EPROM Simulator Function ...... 134 hardware.ESI() 134

ERROR Function (target-dependent) ...... 134 ERROR.ADDRESS() 134

ETM Functions ...... 135 In This Section 135 ETM() 135 ETM.ADDRCOMP() For internal usage only 135 ETM.ADDRCOMPTOTAL() 136 ETM.COUNTERS() 136 ETM.DATACOMP() 136 ETM.EXTIN() 136 ETM.EXTOUT() 137 ETM.FIFOFULL() 137 ETM.MAP() 137

EXTENDED Function (Z80 only) ...... 138 EXTENDED() 138

FDX Function ...... 138 FDX.INSTRING() 138

FIRE Function ...... 138 hardware.FIRE() 138

FLAG Functions ...... 139 In This Section 139 FLAG() 139 FLAG.READ() 139 FLAG.WRITE() 139

FLASH Functions ...... 140 In This Section 140 FLASH.CFI.SIZE() 141 FLASH.CLocK.Frequency() 141 FLASH.List.STATE.PENDING() 142 FLASH.List.TYPE() FLASH family code of FLASH list entry 142 FLASH.SECTOR.BEGIN() 143 FLASH.SECTOR.END() 143 FLASH.SECTOR.EXIST() TRUE if sector exists 143 FLASH.SECTOR.EXTRAvalue() Extra value of FLASH.Create 144 FLASH.SECTOR.NEXT() Address of next sector 145 FLASH.SECTOR.OTP() TRUE if OTP sector 145 FLASH.SECTOR.RANGE() Address range of a FLASH sector 145 FLASH.SECTOR.SIZE() Size in bytes 145 FLASH.SECTOR.STATE() FLASH programming state 146 FLASH.SECTOR.TYPE() FLASH family code of sector 147 FLASH.SECTOR.WIDTH() Width of FLASH sector 148 FLASH.TARGET.BUILD() Build number of FLASH algorithm file 148 FLASH.TARGET.CODERANGE() Code range of FLASH algorithm 149 FLASH.TARGET.DATARANGE() Data range of FLASH algorithm 149 FLASH.TARGET.FILE() Name of FLASH algorithm file 149 FLASH.UNIT() Unit number of FLASH sector 150 FLASH.UNIT.BEGIN() Unit start address 150 FLASH.UNIT.END() Unit end address 150 FLASH.UNIT.EXIST() TRUE if unit exists 151 FLASH.UNIT.NEXT() Number of next unit 151

FLASHFILE Function ...... 152 FLASHFILE.SPAREADDRESS() Address of spare area 152

©1989-2018 Lauterbach GmbH TRACE32 Directory 3 4 FPU Functions (Floating Point Unit) ...... 153 FPU() FPU register contents 153 FPUCR() FPU control register contents 153 FPU.RAW() FPU register raw contents 153

FXU Function ...... 154 FXU() Content of FXU register 154

GROUP Function ...... 154 GROUP.EXIST() TRUE if group exists 154

Hardware Functions ...... 155 In This Section 155 hardware.COMBIPROBE() TRUE if CombiProbe is connected 155 hardware.ICD() TRUE if universal base module is connected 155 hardware.QUADPROBE() TRUE if QuadProbe is connected 156 hardware.SCU() TRUE if ICE or PodBus Ethernet Controller is used 156 hardware.UTRACE() TRUE if debugger is a µTrace 156

HVX Function ...... 157 HVX() Content of HVX register 157

I2C Functions ...... 158 In This Section 158 I2C.DATA() Data read by I2C.TRANSFER 158 I2C.PIN() Pin status 158

ICE Functions ...... 159 hardware.ICE() 159 ICEFAMILY() 159

ID Functions ...... 160 In This Section 160 ID.CABLE() Hardware ID of debug cable 160 ID.PREPROcessor() Hardware ID of preprocessor 160 ID.WHISKER() ID of whisker cable 161 IDCODE() ID code of TAP in JTAG chain 164 IDCODENUMBER() Number of detected TAPs 164

Integrator Functions ...... 165 In This Section 165 Integrator() 165 Integrator.FIRST() Get record number of first trace record 165 Integrator.ADC.ENABLE() 165 Integrator.ADC.SHUNT() 166 Integrator.ANALOG() 166 Integrator.COUNTER.EVENT() Get value of trigger program event counter 166 Integrator.COUNTER.EXTERN() Value of trigger program external counter 166 Integrator.COUNTER.TIME() Get value of trigger program time counter 167

©1989-2018 Lauterbach GmbH TRACE32 Directory 3 5 Integrator.DIALOGDSEL() For internal usage only 167 Integrator.DIALOGDSELGET() For internal usage only 167 Integrator.DSEL() For internal usage only 167 Integrator.FIND.PI_CHANNEL() For internal usage only 168 Integrator.FIND.PI_WORD() 168 Integrator.FLAG() Check state of trigger program FLAG 168 Integrator.GET() 168 Integrator.MAXSIZE() Get max. size of trace buffer in records 169 Integrator.PROBE() For internal usage only 169 Integrator.PROGRAMFILENAME() 169 Integrator.RECORD.DATA() Get data recorded in trace record 169 Integrator.RECORD.TIME() Get time stamp of trace record 170 Integrator.RECORDS() Get number of used trace records 170 Integrator.REF() 170 Integrator.SIZE() Get current trace buffer size in records 170 Integrator.STATE() Get state of the Integrator 171 Integrator.TRACK.RECORD() Get record number matching search 171 Integrator.USB() For internal usage only 171

INTERFACE Functions ...... 172 In This Section 172 INTERFACE.CADI() TRUE if connection to target is via CADI interface 172 INTERFACE.GDB() TRUE if connection to target is via GDB interface 172 INTERFACE.GDI() TRUE if connection to target via GDI interface 173 INTERFACE.HOST() TRUE if connection to application via HOST interface 173 interface.HOSTMCI() 173 INTERFACE.MCD() TRUE if connection to target via MCD interface 173 INTERFACE.NAME() Name of debugger 174 INTERFACE.QNX() TRUE if PBI=QNX 174 INTERFACE.SIM() TRUE if simulator 174 INTERFACE.VAST() TRUE if connection to target via VAST interface 174 INTERFACE.VDI() TRUE if connection to target via Virtio interface 175

IOBASE Functions ...... 176 In This Section 176 IOBASE() 176 IOBASE.ADDRESS() 176 IOBASE2() 176

IProbe Functions ...... 177 In This Section 178 IProbe() 178 IProbe.ADC.ENABLE() 178 IProbe.ADC.SHUNT() 179 IProbe.ANALOG() 179

©1989-2018 Lauterbach GmbH TRACE32 Directory 3 6 IProbe.FIRST() Get record number of first trace record 180 IProbe.GET() 180 IProbe.MAXSIZE() Get max. size of trace buffer in records 180 IProbe.PROBE() 181 IProbe.RECORD.DATA() Get data recorded in trace record 181 IProbe.RECORD.TIME() Get time stamp of trace record 182 IProbe.RECORDS() Get number of used trace records 182 IProbe.REF() Get record number of reference record 182 IProbe.SIZE() Get current trace buffer size in records 183 IProbe.STATE() Get state of IProbe 183 IProbe.TRACK.RECORD() Get record number matching search 184

JTAG Functions ...... 185 In This Section 185 JTAG.PIN() Level of JTAG signal 185 JTAG.SHIFT() TDO output of JTAG shift 185 JTAG.X7EFUSE.RESULT() Result of JTAG.X7EFUSE command 185 JTAG.X7EFUSE.CNTL() CNTL flags read by JTAG.X7EFUSE command 186 JTAG.X7EFUSE.DNA() DNA value read by JTAG.X7EFUSE command 187 JTAG.X7EFUSE.KEY() AES key read by JTAG.X7EFUSE command 187 JTAG.X7EFUSE.USER() User code read by JTAG.X7EFUSE command 187

LOGGER Functions ...... 188 In This Section 188 LOGGER.FIRST() Get record number of first trace record 188 LOGGER.RECORD.ADDRESS() Get address recorded in trace record 189 LOGGER.RECORD.DATA() Get data recorded in trace record 189 LOGGER.RECORD.OFFSET() Get address in trace record as number 189 LOGGER.RECORD.TIME() Get time stamp of trace record 189 LOGGER.RECORDS() Get number of used trace records 190 LOGGER.REF() Get record number of reference record 190 LOGGER.SIZE() Get current trace buffer size in records 190 LOGGER.STATE() Get state of Logger trace 190

MachO Format Function (Apple) ...... 192 MACHO.LASTUUID() Universally unique identifier of MachO file 192

MAP Functions ...... 193 In This Section 193 MAP.CONFIG.FDPRAM() TRUE if full dualported RAM module 193 MAP.RAMSIZE() Emulation memory size of TRACE-ICE or TRACE-FIRE 193 MAP.ROMSIZE() Size of the defined ROM 193

MCDS Functions ...... 194 In This Section 194 MCDS.MODULE.NAME() Name of MCDS module 194 MCDS.MODULE.NUMBER() Number-part of MCDS module ID 195

©1989-2018 Lauterbach GmbH TRACE32 Directory 3 7 MCDS.MODULE.REVision() Revision-part of MCDS module ID 195 MCDS.MODULE.TYPE() Type-part of MCDS module ID 196 MCDS.STATE() MCDS module is switched on/off 196 MCDS.TraceBuffer.LowerGAP() Trace buffer lower gap 196 MCDS.TraceBuffer.SIZE() Trace buffer size 197 MCDS.TraceBuffer.UpperGAP() Trace buffer upper gap 197

MMU Functions (Memory Management Unit) ...... 198 In This Section 198 MMU() Value of MMU register 198 MMU.DEFAULTPT() Base address of default page table 198 MMU.FORMAT() Currently selected MMU format 198

MMX Function (MultiMedia eXtension) ...... 200 MMX() Value of MMX register 200

MONITOR Function ...... 200 MONITOR() TRUE if debugger is running as monitor 200

NEXUS Functions ...... 201 In This Section 201 NEXUS() TRUE if Nexus trace is supported 201 NEXUS.PortMode() Current PortMode setting 201 NEXUS.PortSize() Current PortSize setting 202

Onchip Functions ...... 203 In This Section 203 Onchip() TRUE if the onchip trace is available 203 Onchip.FIRST() Get record number of first trace record 203 Onchip.FLOW.ERRORS() Get number of flow errors / hard errors 203 Onchip.FLOW.FIFOFULL() Get number of FIFO overflows 204 Onchip.MAXSIZE() Get max. size of trace buffer in records 204 Onchip.RECORD.ADDRESS() Get address recorded in trace record 205 Onchip.RECORD.DATA() Get data recorded in trace record 205 Onchip.RECORD.OFFSET() Get address in trace record as number 205 Onchip.RECORD.TIME() Get time stamp of trace record 205 Onchip.RECORDS() Get number of used trace records 206 Onchip.REF() Get record number of reference record 206 Onchip.SIZE() Get current trace buffer size in records 206 Onchip.STATE() Get state of Onchip trace 206 Onchip.TraceCONNECT() Name of trace sink of the SoC 207 Onchip.TRACK.RECORD() Get record number matching search 208

PCI Functions ...... 209 In This Section 209 PCI.Read.B() Byte from PCI register 209 PCI.Read.L() Long from PCI register 209

PER Functions ...... 210 In This Section 210 PER.() Memory contents in default endianness 210 PER..() Memory contents in specified endianness 211 PER.ARG() 212 PER.Buffer.() 213 PER.EVAL() 214

PERF Functions (Performance) ...... 215 In This Section 215 PERF.MEMORY.HITS() 215 PERF.MEMORY.SnoopAddress() 216 PERF.MEMORY.SnoopSize() 216 PERF.METHOD() 216 PERF.MODE() Get Performance Analyzer recording mode 217 PERF.PC.HITS() 217 PERF.RATE() 217 PERF.RunTime() 218 PERF.SNOOPFAILS() 218 PERF.STATE() Get state of Performance Analyzer 218 PERF.TASK.HITS() 219 PERF.WATCHTIME() 219

Port Analyzer Functions for TRACE32-ICE or TRACE32-FIRE ...... 220 In This Section 220 PORT.GET() 220 PORT.MAXSIZE() Get max. size of trace buffer in records 220 PORT.RECORDS() Get number of used trace records 220 PORT.REF() Get record number of reference record 220 PORT.SIZE() Get current trace buffer size in records 221 PORT.STATE() Get state of Port Analyzer 221 PORT.TRACK.RECORD() Get record number matching search 221 PORTANALYZER() 222

PORTSHARING Function ...... 222 PORTSHARING() Current setting of PortSHaRing 222

POWER Functions ...... 223 In This Section 223 hardware.POWERDEBUG() 223 hardware.POWERINTEGRATOR() 223 hardware.POWERINTEGRATOR2() 223 hardware.POWERNEXUS() 224 hardware.POWERTRACE() 224 hardware.POWERTRACE2() 224

PowerProbe Functions ...... 226 In This Section 226 hardware.POWERPROBE() 226 PROBE.COUNTER.EVENT() Get value of trigger program event counter 226 PROBE.COUNTER.EXTERN() Get value of trigger program external counter 226 PROBE.COUNTER.TIME() Get value of trigger program time counter 227 Probe.FIRST() Get record number of first trace record 227 PROBE.FLAG() Check state of trigger program FLAG 227 PROBE.GET() 227 PROBE.MAXSIZE() Get max. size of trace buffer in records 228 PROBE.RECORD.DATA() Get data recorded in trace record 228 PROBE.RECORD.TIME() Get time stamp of trace record 228 PROBE.RECORDS() Get number of used trace records 228 PROBE.REF() Get record number of reference record 229 PROBE.SIZE() Get current trace buffer size in records 229 PROBE.STATE() Get state of PowerProbe 229 PROBE.TRACK.RECORD() Get record number matching search 230

Program Pointer Function ...... 231 PP() 231

RTS Functions ...... 234 RTS.ERROR() Check for flowerrors during RTS processing 234 RTS.RECORDS() Get number of trace records transferred to RTS 234

RunTime Functions ...... 235 In This Section 235 RunTime.ACCURACY() 235 RunTime.ACTUAL() 235 RunTime.LAST() 235 RunTime.LASTRUN() 236 RunTime.REFA() 236 RunTime.REFB() 236

SMMU Functions ...... 237 SMMU.BaseADDRESS() 237 SMMU.StreamID2SMRG() 237

SNOOPer Functions ...... 239 In This Section 239 SNOOPer.FIRST() Get record number of first trace record 239

©1989-2018 Lauterbach GmbH TRACE32 Directory 4 0 SNOOPer.MAXSIZE() Get max. size of trace buffer in records 240 SNOOPer.RECORD.ADDRESS() Get address recorded in trace record 240 SNOOPer.RECORD.DATA() Get data recorded in trace record 240 SNOOPer.RECORD.OFFSET() Get address in trace record as number 240 SNOOPer.RECORD.TIME() Get time stamp of trace record 241 SNOOPer.RECORDS() Get number of used trace records 241 SNOOPer.REF() Get record number of reference record 241 SNOOPer.SIZE() Get current trace buffer size in records 241 SNOOPer.STATE() Get state of SNOOPer trace 242

Target STATE Functions ...... 243 In This Section 243 STATE.HALT() 243 STATE.OSLK() 243 STATE.POWER() 244 STATE.PROCESSOR() 245 STATE.RESET() 246 STATE.RUN() 246 STATE.TARGET() 246

SPE Function ...... 246 SPE() 246

SSE Function ...... 247 SSE() 247

Stimuli Generator Function ...... 247 hardware.STG() 247

sYmbol Functions ...... 248 In This Section 248 sYmbol.AutoLOAD.CHECK() 248 sYmbol.AutoLOAD.CHECKCMD() 248 sYmbol.AutoLOAD.CONFIG() 249 sYmbol.BEGIN() 249 SYStem.CADIconfig.RemoteServer() 250 SYStem.CADIconfig.Traceconfig() 250 sYmbol.COUNT() 251 sYmbol.END() 251 sYmbol.EPILOG() 252 sYmbol.EXIST() 253 sYmbol.EXIT() 253 sYmbol.FUNCTION() 254 sYmbol.IMPORT() 254 sYmbol.List.MAP.() Information about address ranges on the target 255 sYmbol.LIST.PROGRAM() 256 sYmbol.LIST.SOURCE() 257

©1989-2018 Lauterbach GmbH TRACE32 Directory 4 1 sYmbol.MATCHES() 257 sYmbol.NAME() 258 sYmbol.NAME.AT() 258 sYmbol.NEXT.BEGIN() 259 sYmbol.PRANGE() 259 sYmbol.RANGE() 259 sYmbol.SEARCHFILE() 260 sYmbol.SECADDRESS() 260 sYmbol.SECEND() 260 sYmbol.SECPRANGE() 261 sYmbol.SECRANGE() 261 sYmbol.SIZEOF() 261 sYmbol.SOURCEFILE() 262 sYmbol.SOURCELINE() 262 sYmbol.SOURCEPATH() 263 sYmbol.STATE() 264 sYmbol.TYPE() 264 sYmbol.VARNAME() 265

SYStem Functions ...... 266 In This Section 266 SYStem.ACCESS.DENIED() 267 SYStem.AMBA() 267 SYStem.BigEndian() 267 SYStem.CONFIG.() 267 SYStem.CONFIG.DEBUGPORT() 268 SYStem.CONFIG.DEBUGPORTTYPE() 268 SYStem.CONFIG.ListCORE() 269 SYStem.CONFIG.ListSIM() 270 SYStem.CONFIG.Slave() 270 SYStem.CONFIG.TAPState() 271 SYStem.CPU() 271 SYStem.GTL.LIBname() 272 SYStem.GTL.PLUGINVERSION() 272 SYStem.GTL.VENDORID() 272 SYStem.GTL.VERSION() 272 SYStem.HOOK() 272 SYStem.IMASKASM() 273 SYStem.IMASKHLL() 273 SYStem.JtagClock() 273 SYStem.LittleEndian() 273 SYStem.MCDconfig.LIBrary() 274 SYStem.Mode() 274 SYStem.NOTRAP() 1 if the option NOTRAP is active 275

©1989-2018 Lauterbach GmbH TRACE32 Directory 4 2 SYStem.RESetBehavior() Current setting of RESetBehavior 275 SYStem.TRACEEXT() TRUE if an external trace is activated 275 SYStem.TRACEINT() TRUE if an internal trace is activated 275 SYStem.Up() TRUE if debugger has access to debug resources 276 SYStem.USECORE() 276 SYStem.USEMASK() 277

TASK Functions ...... 278 In This Section 278 TASK() Name of current task 278 TASK.BACK() Background task number 279 TASK.CONFIG(magic) Address of magic number 279 TASK.CONFIG(magicsize) Size of magic number 279 TASK.CONFIGFILE() Path of loaded OS awareness 280 TASK.F<1..4> For internal usage only 280 TASK.FORE() Foreground task number 280 TASK.ID() ID of task 280 TASK.MACHINE.ACCESS() Default access class 281 TASK.MACHINE.NAME() Name of machine 282 TASK.MAGIC() Magic number of task 283 TASK.NAME() Name of task 283 TASK.SPACEID() Space ID of task 283 TASK.ACCESS() Access class 284 TASK.ACCESS.ZONE() Access class zone 284

TERM Function (Terminal Window) ...... 285 TERM.LINE() Get line from active terminal window 285

Timing Analyzer Function ...... 285 hardware.TA32() TRUE if TA32 is available 285

TPIU Functions ...... 286 In This Section 286 TPIU.PortMode() PortMode setting 286 TPIU.PortSize() PortSize setting 286 TPIU.SWVPrescaler() SWVPrescaler value 287

TPUBASE Function ...... 287 TPUBASE.ADDRESS() Address of TPU 287

Trace Functions ...... 288 In This Section 288 Trace.FIRST() Get record number of first trace record 288 Trace.FLOW() 289 Trace.FLOW.ERRORS() Get number of flow errors / hard errors 289 Trace.FLOW.FIFOFULL() Get number of FIFO overflows 289 Trace.MAXSIZE() Get max. size of trace buffer in records 290

©1989-2018 Lauterbach GmbH TRACE32 Directory 4 3 Trace.METHOD() Currently configured trace method 290 Trace.METHOD.Analyzer() TRUE if the trace method is Analyzer 290 Trace.METHOD.ART() TRUE if the trace method is ART 291 Trace.METHOD.CAnalyzer() TRUE if the trace method is CAnalyzer 291 Trace.METHOD.FDX() TRUE if the trace method is FDX 291 Trace.METHOD.HAnalyzer() TRUE if the trace method is HAnalyzer 291 Trace.METHOD.Integrator() TRUE if the trace method uses the Integrator 292 Trace.METHOD.IProbe() TRUE if the trace method uses the IProbe 292 Trace.METHOD.LA() TRUE if the trace method is LA 292 Trace.METHOD.LOGGER() TRUE if the trace method is LOGGER 293 Trace.METHOD.ONCHIP() TRUE if the trace method is ONCHIP 293 Trace.METHOD.Probe() TRUE if trace method uses the PowerProbe 293 Trace.METHOD.SNOOPer() TRUE if the trace method is SNOOPer 293 Trace.RECORD.ADDRESS() Get address recorded in trace record 294 Trace.RECORD.DATA() Get data recorded in trace record 294 Trace.RECORD.OFFSET() Get address in trace record as number 294 Trace.RECORD.TIME() Get time stamp of trace record 295 Trace.RECORDS() Get number of used trace records 295 Trace.SIZE() Get current trace buffer size in records 295 Trace.STATE() Get state of PowerTrace hardware 295 Trace.TraceCONNECT() Name of trace sink of the SoC 296

TRACK Functions ...... 297 In This Section 297 TRACK.ADDRESS() Get tracking address 297 TRACK.ADDRESS.DATA() 297 TRACK.ADDRESS.PROG() 297 TRACK.COLUMN() Number of column where the found item starts 298 TRACK.LINE() Number of line containing the found item 298 TRACK.RECORD() Number of record containing the found item 298 TRACK.STRing() Current selection in a TRACE32 window 299 TRACK.TIME() Timestamp of current tracking record 300

TRANS Functions (Debugger Address Translation) ...... 301 In This Section 301 TRANS.ENABLE() TRUE if address translation is enabled 301 TRANS.INTERMEDIATE() Convert a guest logical address 301 TRANS.INTERMEDIATE.VALID() TRUE if address translation is valid 302 TRANS.LINEAR() Convert logical to linear address 302 TRANS.LINEAR.VALID() TRUE if address translation is valid 302 TRANS.LOGICAL() Convert physical to logical address 303 TRANS.LOGICAL.VALID() TRUE if address translation is valid 303 TRANS.PHYSICAL() Convert logical to physical address 304 TRANS.PHYSICAL.VALID() TRUE if address translation is valid 304 TRANS.TABLEWALK() TRUE if address translation table walk is ON 304

©1989-2018 Lauterbach GmbH TRACE32 Directory 4 4 TRIGGER Functions (ICE only) ...... 305 In This Section 305 TRIGGER.ACCESS() Access class of last trigger event 305 TRIGGER.ADDRESS() Address of last trigger event 305 TRIGGER.BYTES() tbd. 305 TRIGGER.COUNT.ALPHA() Values of trigger counter ALPHA 306 TRIGGER.COUNT.BETA() Values of trigger counter BETA 306 TRIGGER.COUNT.CHARLY() Values of trigger counter CHARLY 306 TRIGGER.CYCLE() Cycle type of trigger cycle 306 TRIGGER.DELAY.CYCLE() Value of trigger counter CYCLE 307 TRIGGER.DELAY.TIME() Value of trigger counter TIME 307 TRIGGER.DELAY.TRACE() Values of trigger counter TRACE 307 TRIGGER.OFFSET() Address of last trigger event 307 TRIGGER.SOURCE() Source of last trigger event 308 TRIGGER.STATE() Get state of trigger 308

TRIN Function (ICE only) ...... 309 TRIN.VALUE() Current value of trigger input probe 309

TSS Function ...... 309 TSS() TSS base address 309

Var Functions ...... 310 In This Section 310 Var.ADDRESS() Address of HLL expression 310 Var.BITPOS() Bit position inside a C bit field 310 Var.BITSIZE() Size of bit field element 311 Var.END() Last address of HLL expression 311 Var.FVALUE() Contents of HLL expression 311 Var.ISBIT() TRUE if HLL expression is a bit field element 312 Var.RANGE() Address range of HLL expression 312 Var.SIZEOF() Size of HLL expression 313 Var.STRing() Zero-terminated string or variable contents 313 Var.TYPEOF() Type of HLL expression 314 Var.VALUE() Value of HLL expression 314

VCO Function ...... 315 VCO() Frequency of VCO generator 315

VCU Function ...... 315 VCU() Value of VCU register 315

VERSION Functions ...... 316 In This Section 316 VERSION.BUILD() Upper build number 316 VERSION.BUILD.BASE() Lower build number 317 VERSION.CABLE() Hardware version of debug cable 317

©1989-2018 Lauterbach GmbH TRACE32 Directory 4 5 VERSION.DATE() Version date YYYY/MM 318 VERSION.ENVironment() TRACE32 environment setting 318 VERSION.FirmWare.DEBUG() Version number of firmware 319 VERSION.LICENSE() Deprecated 319 VERSION.SERIAL() Serial number 319 VERSION.SERIAL.CABLE() First serial number of debug cable 319 VERSION.SERIAL.DEBUG() Serial number of debug module 320 VERSION.SERIAL.PREPROcessor() Serial number of preprocessor 320 VERSION.SERIAL.TRACE() Serial number of trace module 320 VERSION.SOFTWARE() Release build or nightly build, etc. 321

VPU Functions ...... 322 In This Section 322 VPU() Value of VPU register 322 VPUCR() Value of VRSAVE or VSCR register 322

Stimuli Generator Functions

Stimuli Generator Functions ...... (stg_func.pdf) 1

Functions ...... 2

Application Notes for PRACTICE

Converter from GEL to PRACTICE

Converter from GEL to PRACTICE ...... (converter_gel.pdf) 1

Introduction ...... 2

Brief Overview of Documents for New Users ...... 2

Launching Converter ...... 3

Using @prog, @data and @io ...... 4

Using Menuitem, Hotmenu, Dialog and Slider ...... 5

Recognizing Types of Identifiers in GEL ...... 5

Functions Parameters ...... 6

Preprocessor ...... 6

Callback GEL Functions ...... 6

Built-in GEL Functions ...... 6

Using PRACTICE Commands from GEL Script ...... 8

Converter-specific Reserved Words ...... 8

Target CPU Register Names ...... 9

General Commands

General Commands Reference Guide A

General Commands Reference Guide A ...... (general_ref_a.pdf) 1

AET ...... 9

Analyzer ...... 10 Analyzer tbd. 10 Trace Method Analyzer 10

Analyzer Remap Commands ...... 12 Functional Description - Pin Remapping 12 Pinouts 14 Analyzer.REMAP Remap trace port channels 16 Analyzer.REMAP.RESet Reset pinout configuration 16 Analyzer.REMAP.state Display remap configuration window 16

Analyzer Trace Commands ...... 17 Analyzer.ACCESS Define access path to source code for trace decoding 17 Analyzer.Arm Arm the trace 17 Analyzer.AutoArm Arm automatically 17 Analyzer.AutoFocus Calibrate AUTOFOCUS preprocessor 17 Analyzer.AutoInit Automatic initialization 17 Analyzer.AutoStart Automatic start 17 Analyzer.AutoTEST Continuous measurement 18 Analyzer.BookMark Set a bookmark in trace listing 18 Analyzer.BookMarkToggle Toggles a single trace bookmark 18 Analyzer.Chart Display trace contents graphically 18 Analyzer.Chart.Address Time between program events as a chart 18 Analyzer.Chart.DistriB Distribution display 18 Analyzer.Chart.Func Function activity chart 18 Analyzer.Chart.GROUP Group activity chart 19 Analyzer.Chart.Line Graphical HLL lines analysis 19 Analyzer.Chart.Nesting Show function nesting at cursor position 19 Analyzer.Chart.sYmbol Symbol analysis 19 Analyzer.Chart.TASK Task activity chart 19 Analyzer.Chart.TASKFunc Task related function run-time analysis (legacy) 19 Analyzer.Chart.TASKINTR Display ISR2 time chart (ORTI) 19 Analyzer.Chart.TASKKernel Task run-time chart with kernel markers (flat) 20 Analyzer.Chart.TASKSRV Service routine run-time analysis 20 Analyzer.Chart.TASKState Task state analysis 20

©1989-2018 Lauterbach GmbH TRACE32 Directory 4 7 Analyzer.Chart.TASKVSINTERRUPT Time chart 20 Analyzer.Chart.TASKVSINTR Time chart 20 Analyzer.Chart.VarState Variable activity chart 20 Analyzer.CLOCK Clock to calculate time out of cycle count information 20 Analyzer.ComPare Compare trace contents 21 Analyzer.CustomTraceLoad Load a DLL for trace analysis/Unload all DLLs 21 Analyzer.DISable Disable the trace 21 Analyzer.DRAW Visualization of trace data 21 Analyzer.DRAW.channel Graphical display of no-data values 21 Analyzer.DRAW.Data Draw any memory access 21 Analyzer.DRAW.Var Graphical display of HLL variables 21 Analyzer.EXPORT Export trace data for processing in other applications 22 Analyzer.EXPORT.Ascii Export trace data as ASCII 22 Analyzer.EXPORT.Bin Export trace data as binary file 22 Analyzer.EXPORT.BRANCHFLOW Export branch events from trace data 22 Analyzer.EXPORT.CSVFunc Export the function nesting to a CSV file 22 Analyzer.EXPORT.flow Export trace data 22 Analyzer.EXPORT.Func Export function nesting 22 Analyzer.EXPORT.TASKEVENTS Export task event to CSV 23 Analyzer.EXPORT.TracePort Export trace packets as recorded at trace port 23 Analyzer.EXPORT.VCD Export trace data in VCD format 23 Analyzer.EXPORT.VERILOG Export trace data in VERILOG format 23 Analyzer.EXPORT.VHDL Export trace data in VHDL format 23 Analyzer.FILE Load a file into the file trace buffer 23 Analyzer.Find Find specified entry in trace 23 Analyzer.FindAll Find all specified entries in trace 24 Analyzer.FindChange Search for changes in trace flow 24 Analyzer.FLOWPROCESS Process flowtrace 24 Analyzer.FLOWSTART Restart flowtrace processing 24 Analyzer.Get Display input level 24 Analyzer.GOTO Move cursor to specified trace record 24 Analyzer.Init Initialize trace 24 Analyzer.JOINFILE Concatenate several trace recordings 25 Analyzer.LEVEL Select trigger level manually 25 Analyzer.List List trace contents 25 Analyzer.ListNesting Analyze function nesting 25 Analyzer.ListVar List variable recorded to trace 25 Analyzer.LOAD Load trace file for offline processing 25 Analyzer.MERGEFILE Combine two trace files into one 25 Analyzer.Mode Set the trace operation mode 25 Analyzer.OFF Switch off 26 Analyzer.PC Display PC in real-time 26 Analyzer.PipeWRITE Connect to a named pipe to stream trace data 26

©1989-2018 Lauterbach GmbH TRACE32 Directory 4 8 Analyzer.PortFilter Specify utilization of trace memory 26 Analyzer.PortSize Set external port size 26 Analyzer.PortType Specify trace interface 26 Analyzer.PROfile Display counter profile 26 Analyzer.PROfileChart Profile charts 27 Analyzer.PROfileChart.COUNTER Display a profile chart 27 Analyzer.PROfileChart.DIStance Time interval for a single event 27 Analyzer.PROfileChart.DURation Time between two events 27 Analyzer.PROfileChart.GROUP Group profile chart 27 Analyzer.PROfileChart.Rate Event frequency 27 Analyzer.PROfileChart.sYmbol Dynamic program behavior graphically (flat) 27 Analyzer.PROfileChart.TASK Dynamic task behavior graphically (flat) 28 Analyzer.PROfileSTATistic Statistical analysis in a table versus time 28 Analyzer.Program Program trigger unit 28 Analyzer.PROTOcol Protocol analysis 28 Analyzer.PROTOcol.Chart Graphic display for user-defined protocol 28 Analyzer.PROTOcol.Draw Graphic display for user-defined protocol 28 Analyzer.PROTOcol.EXPORT Export trace buffer for user-defined protocol 28 Analyzer.PROTOcol.Find Find in trace buffer for user-defined protocol 29 Analyzer.PROTOcol.List Display trace buffer for user-defined protocol 29 Analyzer.PROTOcol.STATistic Display statistics for user-defined protocol 29 Analyzer.REF Set reference point for time measurement 29 Analyzer.ReProgram Program trigger unit 29 Analyzer.RESet Reset command 29 Analyzer.SAMPLE Set AutoFocus sample time offset 29 Analyzer.SAVE Save trace for postprocessing in TRACE32 30 Analyzer.SelfArm Automatic restart of trace recording 30 Analyzer.ShowFocus Display data eye for AUTOFOCUS preprocessor 30 Analyzer.ShowFocusClockEye Display clock eye 30 Analyzer.ShowFocusEye Display data eye for AUTOFOCUS preprocessor 30 Analyzer.SIZE Define buffer size 30 Analyzer.SnapShot Restart trace capturing once 30 Analyzer.SPY Enable analysis of streaming file while recording 31 Analyzer.state Display trace configuration window 31 Analyzer.STATistic Statistic analysis 31 Analyzer.STATistic.Address Time between up to 8 program events 31 Analyzer.STATistic.AddressDIStance Time interval for single program event 31 Analyzer.STATistic.AddressDURation Time between two program events 31 Analyzer.STATistic.BondOut Bondout mode 31 Analyzer.STATistic.ChildTREE Show callee context of a function 32 Analyzer.STATistic.COLOR Assign colors to function for colored graphics 32 Analyzer.STATistic.CYcle Analyze cycle types 32 Analyzer.STATistic.DatasYmbol Analyze pointer contents numerically 32

©1989-2018 Lauterbach GmbH TRACE32 Directory 4 9 Analyzer.STATistic.DIStance Time interval for a single event 32 Analyzer.STATistic.DistriB Distribution analysis 32 Analyzer.STATistic.DURation Time between two events 32 Analyzer.STATistic.FIRST Start point for statistic analysis 33 Analyzer.STATistic.Func Nesting function runtime analysis 33 Analyzer.STATistic.FuncDURation Statistic analysis of function 33 Analyzer.STATistic.FuncDURationInternal Stat analysis of function internal 33 Analyzer.STATistic.GROUP Group run-time analysis 33 Analyzer.STATistic.Ignore Ignore false records in statistic 33 Analyzer.STATistic.INTERRUPT Interrupt statistic 33 Analyzer.STATistic.InterruptIsFunction Statistics interrupt processing 34 Analyzer.STATistic.LAST End point for statistic analysis 34 Analyzer.STATistic.Line HLL-line analysis 34 Analyzer.STATistic.LINKage Per caller statistic of function 34 Analyzer.STATistic.LISTCONFIG tbd. 34 Analyzer.STATistic.Measure Analyze the performance of a single signal 34 Analyzer.STATistic.MODULE Code execution broken down by module 34 Analyzer.STATistic.PAddress Which instructions accessed data address 35 Analyzer.STATistic.ParentTREE Show the call context of a function 35 Analyzer.STATistic.PIPELINE tbd. 35 Analyzer.STATistic.PreFetch Prefetch detection 35 Analyzer.STATistic.PROGRAM Code execution broken down by program 35 Analyzer.STATistic.PsYmbol Shows which functions accessed data address 35 Analyzer.STATistic.Sort Specify sorting criterion for statistic commands 35 Analyzer.STATistic.sYmbol Flat run-time analysis 36 Analyzer.STATistic.TASK Task activity statistic 36 Analyzer.STATistic.TASKFunc Task specific function run-time analysis 36 Analyzer.STATistic.TASKKernel Task analysis with kernel markers (flat) 36 Analyzer.STATistic.TASKORINTERRUPT Statistic of interrupts and tasks 36 Analyzer.STATistic.TASKSRV Analysis of time in OS service routines 36 Analyzer.STATistic.TASKState Performance analysis 36 Analyzer.STATistic.TASKTREE Tree display of task specific functions 37 Analyzer.STATistic.TASKVSINTERRUPT Statistic of interrupts, task-related 37 Analyzer.STATistic.TREE Tree display of nesting function run-time analysis 37 Analyzer.STATistic.Use Use records 37 Analyzer.STREAMCompression Select compression mode for streaming 37 Analyzer.STREAMFILE Specify temporary streaming file path 37 Analyzer.STREAMFileLimit Set size limit for streaming file 37 Analyzer.STREAMLOAD Load streaming file from disk 38 Analyzer.STREAMSAVE Save streaming file to disk 38 Analyzer.TDelay Trigger delay 38 Analyzer.TERMination Use trace line termination of preprocessor 38 Analyzer.TestFocus Test trace port recording 38

©1989-2018 Lauterbach GmbH TRACE32 Directory 5 0 Analyzer.TestFocusClockEye Scan clock eye 38 Analyzer.TestFocusEye Check signal integrity 38 Analyzer.THreshold Optimize threshold for trace lines 39 Analyzer.Timing Waveform of trace buffer 39 Analyzer.TOut Route trigger to PODBUS (CombiProbe) 39 Analyzer.TraceCLOCK Export trace data 39 Analyzer.TraceCONNECT Select on-chip peripheral sink 39 Analyzer.TRACK Set tracking record 39 Analyzer.TSELect Select trigger source 39 Analyzer.View Display single record 40 Analyzer.XTrack Cross system tracking 40 Analyzer.ZERO Align timestamps of trace and timing analyzers 40

APU ...... 41 APU Auxiliary processing unit 41 APU.Break APU breakpoints 41 APU.Break.Delete Delete APU breakpoint 41 APU.Break.direct Stop the APU 42 APU.Break.Init Initialize APU breakpoint system 42 APU.Break.List List APU breakpoints 42 APU.Break.RESet Reset APU breakpoint system 43 APU.Break.Set Set permanent APU breakpoint 43 APU.command Execute APU specific command 44 APU.Data APU data command group 44 APU.Data.dump Data memory display 44 APU.Data.List Symbolic display 45 APU.Data.LOAD Load file 45 APU.Data.Set Data memory modification 45 APU.Go Start the APU 46 APU.GREP Search for string 46 APU.List View program 47 APU.LOAD Load APU library 47 APU.Register Show APU register window 48 APU.Register.Set Register modification 48 APU.Register.view Register display 49 APU.RESet Reset APU core 50 APU.Step Single-stepping 50 APU.View Display APU peripherals 50

ART ...... 51 ART Trace method for Advanced Register Trace 51 Trace Method ART 51

ART Trace Commands ...... 53 ART.Arm Arm the trace 53

©1989-2018 Lauterbach GmbH TRACE32 Directory 5 1 ART.AutoArm Arm automatically 53 ART.AutoFocus Calibrate AUTOFOCUS preprocessor 53 ART.AutoInit Automatic initialization 53 ART.AutoTEST Continuous measurement 53 ART.BookMark Set a bookmark in trace listing 53 ART.Chart Display trace contents graphically 54 ART.Chart.DistriB Distribution display 54 ART.Chart.Func Function activity chart 54 ART.Chart.GROUP Group activity chart 54 ART.Chart.Line Graphical HLL lines analysis 54 ART.Chart.sYmbol Symbol analysis 54 ART.Chart.TASK Task activity chart 54 ART.Chart.TASKFunc Task related function run-time analysis (legacy) 55 ART.Chart.TASKSRV Service routine run-time analysis 55 ART.Chart.TASKState Task state analysis 55 ART.Chart.VarState Variable activity chart 55 ART.ComPare Compare trace contents 55 ART.DISable Disable the trace 55 ART.DRAW Visualization of trace data 55 ART.EXPORT Export trace data for processing in other applications 56 ART.FILE Load a file into the file trace buffer 56 ART.Find Find specified entry in trace 56 ART.FindAll Find all specified entries in trace 56 ART.FindChange Search for changes in trace flow 56 ART.GOTO Move cursor to specified trace record 56 ART.Init Initialize trace 56 ART.List List trace contents 56 ART.ListNesting Analyze function nesting 57 ART.LOAD Load trace file for offline processing 57 ART.Mode Set the trace operation mode 57 ART.OFF Switch off 57 ART.PROfileChart Profile charts 57 ART.PROfileChart.DIStance Time interval for a single event 57 ART.PROfileChart.DURation Time between two events 57 ART.PROfileChart.GROUP Group profile chart 58 ART.PROfileChart.Rate Event frequency 58 ART.PROTOcol.Chart Graphic display for user-defined protocol 58 ART.PROTOcol.Draw Graphic display for user-defined protocol 58 ART.PROTOcol.EXPORT Export trace buffer for user-defined protocol 58 ART.PROTOcol.Find Find in trace buffer for user-defined protocol 58 ART.PROTOcol.List Display trace buffer for user-defined protocol 58 ART.PROTOcol.STATistic Display statistics for user-defined protocol 59 ART.REF Set reference point for time measurement 59

©1989-2018 Lauterbach GmbH TRACE32 Directory 5 2 ART.RESet Reset command 59 ART.SAVE Save trace for postprocessing in TRACE32 59 ART.SelfArm Automatic restart of trace recording 59 ART.SIZE Define buffer size 59 ART.SnapShot Restart trace capturing once 59 ART.state Display trace configuration window 59 ART.STATistic Statistic analysis 60 ART.STATistic.DIStance Time interval for a single event 60 ART.STATistic.DistriB Distribution analysis 60 ART.STATistic.DURation Time between two events 60 ART.STATistic.Func Nesting function runtime analysis 60 ART.STATistic.GROUP Group run-time analysis 60 ART.STATistic.Ignore Ignore false records in statistic 60 ART.STATistic.InterruptIsFunction Statistics interrupt processing 61 ART.STATistic.Line HLL-line analysis 61 ART.STATistic.LINKage Per caller statistic of function 61 ART.STATistic.Measure Analyze the performance of a single signal 61 ART.STATistic.PreFetch Prefetch detection 61 ART.STATistic.Sort Specify sorting criterion for statistic commands 61 ART.STATistic.sYmbol Flat run-time analysis 61 ART.STATistic.TASK Task activity statistic 62 ART.STATistic.TASKFunc Task specific function run-time analysis 62 ART.STATistic.TASKKernel Task analysis with kernel markers (flat) 62 ART.STATistic.TASKSRV Analysis of time in OS service routines 62 ART.STATistic.TASKState Performance analysis 62 ART.STATistic.TASKTREE Tree display of task specific functions 62 ART.STATistic.TREE Tree display of nesting function run-time analysis 62 ART.STATistic.Use Use records 63 ART.Timing Waveform of trace buffer 63 ART.TRACK Set tracking record 63 ART.View Display single record 63 ART.ZERO Align timestamps of trace and timing analyzers 63

AutoSTOre ...... 64 AutoSTOre Save and restore settings (history, GUI, etc.) automatically 64

AVX ...... 66 AVX AVX registers (Advanced Vector Extension) 66 AVX.Init Initialize AVX registers 66 AVX.OFF Inhibit AVX accesses by the debugger 66 AVX.ON Permit AVX accesses by the debugger 67 AVX.Set Modify AVX registers 67 AVX.view Display AVX registers 67

AVX512 ...... 68

©1989-2018 Lauterbach GmbH TRACE32 Directory 5 3 AVX512 AVX512 registers (Advanced Vector Extension) 68 AVX512.Init Initialize AVX512 registers 68 AVX512.OFF Inhibit AVX512 accesses by the debugger 68 AVX512.ON Permit AVX512 accesses by the debugger 69 AVX512.Set Modify AVX512 registers 69 AVX512.view Display AVX512 registers 69

General Commands Reference Guide B

General Commands Reference Guide B ...... (general_ref_b.pdf) 1

History ...... 4

BMC ...... 5 BMC Benchmark counters 5 BMC. Benchmark counters 6 BMC..EVENT Assign event to counter 6 BMC..FORMAT Counter value format 6 BMC..RATIO Set two counters in relation 7 BMC..SIZE Specify counter size 7 BMC.AtoBTrace Capture multiple alpha-beta counter values 8 BMC.AutoInit Automatic initialization 9 BMC.CLOCK Provide core clock for cycle counter 9 BMC.Init Initialize counters 9 BMC.PROfile Display counter changes per second 10 BMC.RESet Reset benchmark counter configuration 10 BMC.SELect Select counter for statistic analysis 11 BMC.state Display BMC configuration window 12 BMC.STATistic.sYmbol Flat run-time analysis with benchmark counter 15

BookMark ...... 16 BookMark Address and trace bookmarks 16 BookMark.CHange Edit the settings of a bookmark 17 BookMark.Create Create a new address bookmark 18 BookMark.Delete Delete an existing bookmark 19 BookMark.EditRemark Add/edit remark of a bookmark 20 BookMark.EXPORT Export bookmarks to an XML file 21 BookMark.List List all existing bookmarks 23 BookMark.RESet Resets all bookmarks 24 BookMark.Toggle Toggles a single address bookmark 25

Break ...... 26 Break Breakpoints 26 Breakpoints within the TRACE32 Debugger 26 Break System of the TRACE32-ICE 28 Break System of the TRACE32-FIRE 29

©1989-2018 Lauterbach GmbH TRACE32 Directory 5 4 Break.Asm Stop program/set temporary breakpoint and switch to Asm mode 31 Break.BackGround Break background task 31 Break.Delete Delete breakpoints 32 Break.DeleteFAST Delete fast breakpoints 33 Break.DeleteHll Delete HLL breakpoints 33 Break.direct Stop program execution or set temporary breakpoints 35 Break.DISable Disable breakpoints 36 Break.ENable Enable breakpoints 38 Break.HALT Program break in hold 38 Break.Hll Stop program/set temporary breakpoint and switch to HLL mode 40 Break.IMPLementation Breakpoint implementation 41 Break.Init Initialize breakpoints 44 Break.List Display list of breakpoints 44 Break.ListFAST Delete fast breakpoints 44 Break.Mix Stop program/set temporary breakpoint and switch to MIX mode 46 Break.MONitor Switch back to stop mode debugging 46 Break.Pass Define pass condition for breakpoint 48 Break.RESet Delete all breakpoints and reset the TRACE32 break system 48 Break.Set Set breakpoints 49 Break.SetFAST Set fast breakpoints 83 Break.SetFunc Mark HLL functions 84 Break.SetHll Set HLL breakpoints 85 Break.SetLine Mark HLL lines 86 Break.SetMONitor Switch to run mode debugging at the next “Go” 87 Break.SetSec Protect program sections 87 Break.SetTask Stop the program execution when task is scheduled 88

BSDL ...... 89 BSDL Boundary scan description language 89 BSDL.BYPASSall Check bypass mode 90 BSDL.CHECK Enable test result checking 90 BSDL.FILE Load a BSDL file 90 BSDL.FLASH Flash programming 91 BSDL.FLASH.IFCheck Check flash interface definition 91 BSDL.FLASH.IFDefine Define flash interface 93 BSDL.FLASH.IFMap Map flash interface 94 BSDL.FLASH.INIT Initialize flash interface 95 BSDL.HARDRESET TAP reset via TRST 95 BSDL.IDCODEall Check ID codes 96 BSDL.LoadDR Load data register from file 96 BSDL.MOVEDOWN Move selected chip downwards 97 BSDL.MOVEUP Move selected chip upwards 97 BSDL.ParkState Select JTAG parking state 98 BSDL.RESet Reset boundary scan configuration 98

©1989-2018 Lauterbach GmbH TRACE32 Directory 5 5 BSDL.RUN Run JTAG sequence 99 BSDL.SAMPLEall Sample all signals 99 BSDL.SELect Select a chip 100 BSDL.SET Set chip parameters 100 BSDL.SetAndRun Immediate data register takeover 106 BSDL.SOFTRESET TAP reset via TMS 107 BSDL.state Display BSDL chain configuration window 108 BSDL.SToreDR Store data register to file 109 BSDL.TwoStepDR Single/double data register shift 110 BSDL.UNLOAD Unload a chip from chain 110

BTrace ...... 111 BTrace Script-controlled trace sink 111 BTrace.state Display BTrace configuration window 111

General Commands Reference Guide C

General Commands Reference Guide C ...... (general_ref_c.pdf) 1

History ...... 7

CACHE ...... 8 CACHE View and modify CPU cache contents 8 CACHE.CLEAN Clean CACHE 8 CACHE.ComPare Compare CACHE with memory 9 CACHE.DUMP Dump CACHE 10 CACHE.FLUSH Clean and invalidate CACHE 11 CACHE.GET Get CACHE contents 12 CACHE.INFO View all information related to an address 12 CACHE.INVALIDATE Invalidate CACHE 12 CACHE.List List CACHE contents 13 CACHE.ListFunc List cached functions 14 CACHE.ListLine tbd. 15 CACHE.ListVar List cached variables 16 CACHE.RELOAD Reload CACHE 17 CACHE.view Display CACHE control register 17

CAnalyzer ...... 18 CAnalyzer Trace features of CombiProbe 18 Trace Method CAnalyzer 18

CAnalyzer - CombiProbe-specific Trace Commands ...... 19 CAnalyzer.DecodeMode Define how to decode the received trace data 19 CAnalyzer.PipeWRITE Define a named pipe as trace sink 20 CAnalyzer.TraceCLOCK Configure the trace port frequency 20 CAnalyzer.WRITE Define a file as trace sink 21

Generic CAnalyzer Trace Commands ...... 22

©1989-2018 Lauterbach GmbH TRACE32 Directory 5 6 CAnalyzer.ACCESS Define access path to source code for trace decoding 22 CAnalyzer.Arm Arm the trace 22 CAnalyzer.AutoArm Arm automatically 22 CAnalyzer.AutoFocus Calibrate AUTOFOCUS preprocessor 22 CAnalyzer.AutoInit Automatic initialization 22 CAnalyzer.BookMark Set a bookmark in trace listing 22 CAnalyzer.Chart Display trace contents graphically 23 CAnalyzer.CLOCK Clock to calculate time out of cycle count information 23 CAnalyzer.ComPare Compare trace contents 23 CAnalyzer.CustomTrace Custom trace 23 CAnalyzer.CustomTraceLoad Load a DLL for trace analysis/Unload all DLLs 23 CAnalyzer.DISable Disable the trace 23 CAnalyzer.DRAW Visualization of trace data 23 CAnalyzer.EXPORT Export trace data for processing in other applications 24 CAnalyzer.FILE Load a file into the file trace buffer 24 CAnalyzer.Find Find specified entry in trace 24 CAnalyzer.FindAll Find all specified entries in trace 24 CAnalyzer.FindChange Search for changes in trace flow 24 CAnalyzer.Get Display input level 24 CAnalyzer.GOTO Move cursor to specified trace record 24 CAnalyzer.Init Initialize trace 24 CAnalyzer.List List trace contents 25 CAnalyzer.ListNesting Analyze function nesting 25 CAnalyzer.ListVar List variable recorded to trace 25 CAnalyzer.LOAD Load trace file for offline processing 25 CAnalyzer.Mode Set the trace operation mode 25 CAnalyzer.OFF Switch off 25 CAnalyzer.PipePROTO.load Define a user-supplied DLL as trace sink 25 CAnalyzer.PortFilter Specify utilization of trace memory 25 CAnalyzer.PortType Specify trace interface 26 CAnalyzer.PROfileChart Profile charts 26 CAnalyzer.PROfileSTATistic Statistical analysis in a table versus time 26 CAnalyzer.PROTOcol Protocol analysis 26 CAnalyzer.REF Set reference point for time measurement 26 CAnalyzer.RESet Reset command 26 CAnalyzer.SAVE Save trace for postprocessing in TRACE32 26 CAnalyzer.SelfArm Automatic restart of trace recording 27 CAnalyzer.SIZE Define buffer size 27 CAnalyzer.SnapShot Restart trace capturing once 27 CAnalyzer.SPY Enable analysis of streaming file while recording 27 CAnalyzer.state Display trace configuration window 27 CAnalyzer.STATistic Statistic analysis 27 CAnalyzer.STREAMCompression Select compression mode for streaming 27

©1989-2018 Lauterbach GmbH TRACE32 Directory 5 7 CAnalyzer.STREAMFILE Specify temporary streaming file path 28 CAnalyzer.STREAMFileLimit Set size limit for streaming file 28 CAnalyzer.STREAMLOAD Load streaming file from disk 28 CAnalyzer.STREAMSAVE Save streaming file to disk 28 CAnalyzer.TDelay Trigger delay 28 CAnalyzer.THreshold Optimize threshold for trace lines 28 CAnalyzer.TOut Route trigger to PODBUS (CombiProbe) 28 CAnalyzer.TRACK Set tracking record 29 CAnalyzer.TSELect Select trigger source 29 CAnalyzer.View Display single record 29 CAnalyzer.ZERO Align timestamps of trace and timing analyzers 29

CIProbe ...... 30 CIProbe Trace with Analog Probe and CombiProbe 30

ClipStore ...... 31 ClipSTOre Store settings to clipboard 31

CLOCK ...... 32 CLOCK Display date and time 32 CLOCK.BACKUP Set backup clock frequency 32 CLOCK.DATE Alias for DATE command 33 CLOCK.OFF Disable clock frequency computation 33 CLOCK.ON Enable clock frequency computation 33 CLOCK.OSCillator Set board oscillator frequency 34 CLOCK.Register Display PLL related registers 34 CLOCK.RESet Reset CLOCK command group settings 34 CLOCK.state Display clock frequencies 35 CLOCK.VCOBase Set 'VCOBase' clock frequency 35 CLOCK.VCOBaseERAY Set 'FlexRay VCOBase' clock frequency 36

CMI ...... 37 CMI Clock management interface 37

CORE ...... 38 CORE Cores in an SMP system 38 Overview CORE 38 CORE.ADD Add core/thread to the SMP system 39 CORE.ASSIGN Assign a set of physical cores/threads to the SMP system 40 CORE.List List information about cores 46 CORE.NUMber Assign a number of cores/threads to the SMP system 47 CORE.ReMove Remove core from the SMP system 48 CORE.select Change currently selected core 48 CORE.SHOWACTIVE Show active/inactive cores in an SMP system 49

Count ...... 51 Count Universal counter 51

©1989-2018 Lauterbach GmbH TRACE32 Directory 5 8 Counter of TRACE32-ICD 51 Counter of TRACE32-ICE 52 Counter of TRACE32-FIRE 55 Counter Functions 56 Count.AutoInit Automatic counter reset 57 Count.Enable Counter control 57 Count.Gate Gate time 58 Count.GLitch Glitch detector 58 Count.GO Start measurement 60 Count.Init Reset counter 60 Count.Mode Mode selection 61 Count.OUT Forward counter input signal to trigger system/output 63 Count.PROfile Graphic counter display 63 Count.RESet Reset command 65 Count.Select Select input source 66 Count.state State display 69

COVerage ...... 70 COVerage Trace-based code coverage 70 COVerage.ACCESS Set the memory access mode 71 COVerage.ADD Add trace contents to database 72 COVerage.Delete Modify coverage 72 COVerage.EXPORT Export code coverage information to an XML file 73 COVerage.EXPORT.CBA Export HLL lines in CBA format 73 COVerage.EXPORT.ListFunc Export the HLL functions 74 COVerage.EXPORT.ListGroup Export the groups 77 COVerage.EXPORT.ListLine Export the HLL lines 77 COVerage.EXPORT.ListModule Export the modules 78 COVerage.EXPORT.ListVar Export the HLL variables 78 COVerage.Init Clear coverage database 79 COVerage.List Coverage display 79 COVerage.ListFunc Display code coverage for HLL functions 80 COVerage.ListGroup Display coverage for groups 82 COVerage.ListLine Display coverage for HLL lines 83 COVerage.ListModule Display coverage for modules 84 COVerage.ListVar Display coverage for variable 85 COVerage.LOAD Load coverage database from file 86 COVerage.MAP Map the coverage to a different range 87 COVerage.METHOD Select code coverage method 88 COVerage.Mode Activate code coverage for virtual targets 91 COVerage.OFF Deactivate coverage 91 COVerage.ON Activate coverage 92 COVerage.Option Set coverage options 93 COVerage.Option.EXLiteralPools Ignore literal pools for coverage 93

©1989-2018 Lauterbach GmbH TRACE32 Directory 5 9 COVerage.Option.NoStaticInfo Skip the generation of static flow information 93 COVerage.Option.SourceMetric Set coverage criterion for HLL lines 94 COVerage.Option.StaticInfo Perform code coverage precalculations 99 COVerage.RESet Clear coverage database 100 COVerage.SAVE Save coverage database to file 100 COVerage.Set Coverage modification 100 COVerage.state Configure coverage 101 COVerage.StaticInfo Generate static program flow information 102 COVerage.TreeWalkSETUP Prepare a tree with code coverage symbols 103

CTS ...... 104 CTS Context tracking system (CTS) 104 Trace-based Debugging 105 Full HLL Trace Display 106 Reconstruction of Trace Gaps (TRACE32-ICD) 106 CTS.CACHE CTS cache analysis 106 CTS.CACHE.Allocation Define the cache allocation technique 108 CTS.CACHE.Chart Graphical display of cache analysis 109 CTS.CACHE.CYcles Define counting method for cache analysis 113 CTS.CACHE.DefineBus Define bus interface 114 CTS.CACHE.L1Architecture Define architecture for L1 cache 115 CTS.CACHE.ListAddress Address based cache analysis 116 CTS.CACHE.ListFunc Function based cache analysis 117 CTS.CACHE.ListLine HLL line based cache analysis 118 CTS.CACHE.ListModules Module based cache analysis 118 CTS.CACHE.ListRequests Display request for a single cache line 119 CTS.CACHE.ListSet Cache set based cache analysis 120 CTS.CACHE.ListVar Variable based cache analysis 120 CTS.CACHE.MMUArchitecture Define MMU architecture for cache control 121 CTS.CACHE.Mode Define memory coherency strategy 122 CTS.CACHE.Replacement Define the replacement strategy 123 CTS.CACHE.RESet Reset settings of CTS cache window 124 CTS.CACHE.SETS Define the number of cache sets 124 CTS.CACHE.Sort Define sorting for all list commands 124 CTS.CACHE.state Display settings of CTS cache analysis 125 CTS.CACHE.Tags Define address mode for cache lines 126 CTS.CACHE.TLBArchitecture Define architecture for the TLB 127 CTS.CACHE.View Display the results for the cache analysis 128 CTS.CACHE.ViewBPU Display statistic for branch prediction unit 132 CTS.CACHE.ViewBus Display statistics for the bus utilization 133 CTS.CACHE.ViewStalls Display statistics for idles/stalls 134 CTS.CACHE.WAYS Define number of cache ways 135 CTS.CACHE.Width Define width of cache line 136 CTS.CAPTURE Copy real memory to the virtual memory for CTS 136

©1989-2018 Lauterbach GmbH TRACE32 Directory 6 0 CTS.GOTO Select the specified record for CTS (absolute) 137 CTS.INCremental CTS displays intermediate results while processing 137 CTS.Init Restart CTS processing 138 CTS.List List trace contents 138 CTS.Mode Operation mode 140 CTS.OFF Switch off trace-based debugging 140 CTS.ON Switch on trace-based debugging 140 CTS.PROCESS Process cache analysis 141 CTS.RESet Reset the CTS settings 141 CTS.SELectiveTrace Trace contains selective trace information 142 CTS.SKIP Select the specified record for CTS (relative) 142 CTS.state Display CTS settings 143 CTS.TAKEOVER Take memory/registers reconstructed by CTS over to target 144 CTS.UseCACHE Cache analysis for CTS 145 CTS.UseConst Use constants for the CTS processing 146 CTS.UseMemory Use memory contents for CTS 147 CTS.UseReadCycle Use read cycles for CTS 148 CTS.UseRegister Use the CPU registers for CTS 148 CTS.UseSIM Use instruction set simulator for CTS 149 CTS.UseVM Use the virtual memory contents as initial values for CTS 150 CTS.UseWriteCycle Use write cycles for CTS 151

General Commands Reference Guide D

General Commands Reference Guide D ...... (general_ref_d.pdf) 1

History ...... 6

Data ...... 7 Data Memory access 7 Memory Access by the TRACE32 Debugger 7 Memory Access by TRACE32-ICE, TRACE32-FIRE 9 Keywords for 11 Functions 12 Data.AllocList Static memory allocation analysis 13 Data.Assemble Built-in assembler 18 Data.BDTAB Display buffer descriptor table 19 Data.BENCHMARK Determine cache/memory bandwidth 20 Data.CHAIN Display linked list 24 Data.CHAINFind Search in linked list 27 Data.CLEARVM Clear the TRACE32 virtual memory (VM:) 28 Data.ComPare Compare memory 29 Data.COPY Copy memory 31 Data.CSA Display linked list of CSA entries 34 Data.DRAW Graphical memory display of arrays 35

©1989-2018 Lauterbach GmbH TRACE32 Directory 6 1 Data.DRAWFFT Graphical display of fast fourier transformation 39 Data.DRAWXY Graphical display of xy-graphs 42 Data.dump Memory dump 45 Data.EPILOG Automatic data modification on program execution halt 57 Data.EPILOG.CONDition Define condition for data epilog 58 Data.EPILOG.CORE Select core for data epilog 59 Data.EPILOG.OFF Switch data epilog off 59 Data.EPILOG.ON Switch data epilog on 60 Data.EPILOG.RESet Reset all data epilogs 60 Data.EPILOG.SELect Increment the index number to the next data epilog 61 Data.EPILOG.SEQuence Define epilog sequence 62 Data.EPILOG.state Display data epilogs 63 Data.EPILOG.TARGET Define epilog target call 64 Data.Find Search in memory 65 Data.FindCODE Execute command on specified code type 67 Data.GOTO Track to address 68 Data.GREP Search for string 69 Data.IMAGE Display image data 70 Data.In Read port 73 Data.List 73 Data.LOAD Load file 74 Format Specific Data.LOAD Commands and Options 88 Data.LOAD.AIF Load ARM image file 88 Data.LOAD.AOUT Load a.out file 89 Data.LOAD.ASAP2 Load ASAP2 file 89 Data.LOAD.AsciiHex Load hex file 90 Data.LOAD.AsciiOct Load octal file 90 Data.LOAD.AVocet Load AVOCET file 91 Data.LOAD.BDX Load BDX file 91 Data.LOAD.Binary Load binary file 92 Data.LOAD.BounD Load BOUND file 95 Data.LOAD.CDB Load SDCC CDB file format 95 Data.LOAD.COFF Load COFF file 97 Data.LOAD.COMFOR Load COMFOR (TEKTRONIX) file 98 Data.LOAD.CORE Load Linux core dump file 99 Data.LOAD.COSMIC Load COSMIC file 100 Data.LOAD.CrashDump Load MS Windows Crash Dump file 101 Data.LOAD.DBX Load a.out file 102 Data.LOAD.Elf Load ELF file 103 Data.LOAD.ESTFB Load EST flat binary 112 Data.LOAD.eXe Load EXE file 112 Data.LOAD.HiCross Load HICROSS file 113 Data.LOAD.HiTech Load HITECH file 114

©1989-2018 Lauterbach GmbH TRACE32 Directory 6 2 Data.LOAD.HP Load HP-64000 file 115 Data.LOAD.ICoff Load ICOFF file 116 Data.LOAD.Ieee Load IEEE-695 file 117 Data.LOAD.IntelHex Load INTEL-HEX file 119 Data.LOAD.Jedec Load JEDEC file 119 Data.LOAD.MachO Load 'Mach-O' file 120 Data.LOAD.MAP Load MAP file 123 Data.LOAD.MCDS Load MCDS file 123 Data.LOAD.MCoff Load MCOFF file 124 Data.LOAD.OAT Load OAT file 124 Data.LOAD.Omf Load OMF file 125 Data.LOAD.Omf2 Load OMF-251 files 129 Data.LOAD.OriginHex Load special hex files 129 Data.LOAD.REAL Load R.E.A.L. file 130 Data.LOAD.ROF Load OS-9 file 131 Data.LOAD.SDS Load SDSI file 132 Data.LOAD.Srecord Load S-Record file 133 Data.LOAD.sYm Load symbol file 134 Data.LOAD.SysRof Load RENESAS SYSROF file 135 Data.LOAD.TEK Load TEKTRONIX file 136 Data.LOAD.TekHex Load TEKTRONIX HEX file 136 Data.LOAD.Ubrof Load UBROF file 137 Data.LOAD.VersaDos Load VERSADOS file 138 Data.LOAD.XCoff Load XCOFF file 138 Data.MSYS M-SYSTEMS FLASHDISK support 139 Data.Out Write port 140 Data.PATTERN Fill memory with pattern 141 Data.Print Display multiple areas 143 Data.PROfile Graphical display of data value 146 Data.PROGRAM Assembler window 148 Data.PROLOG Automatic data modification on program execution start 149 Data.PROLOG.CONDition Define PROLOG condition 150 Data.PROLOG.CORE Select core for data prolog 151 Data.PROLOG.OFF Switch data prolog off 151 Data.PROLOG.ON Switch data prolog on 152 Data.PROLOG.RESet Reset all data prologs 152 Data.PROLOG.SELect Increment the index number to the next data prolog 153 Data.PROLOG.SEQuence Define prolog sequence 154 Data.PROLOG.state Display data prologs 155 Data.PROLOG.TARGET Define PROLOG target call 156 Data.REF Display current values 157 Data.ReProgram Assembler 157 Data.ReRoute Reroute function call 158

©1989-2018 Lauterbach GmbH TRACE32 Directory 6 3 Data.SAVE. Save data in file with specified format 159 Data.SAVE.AsciiHex Save hex file 161 Data.SAVE.AsciiOct Save octal file 162 Data.SAVE.BDX Save BDX file 162 Data.SAVE.Binary Save binary file 163 Data.SAVE.CCSDAT Save CCSDAT file 163 Data.SAVE.DAB Save DAB file 164 Data.SAVE.Elf Save ELF file 164 Data.SAVE.ESTFB Save EST flat binary file 165 Data.SAVE.IntelHex Save INTEL-HEX file 165 Data.SAVE.Omf Save OMF file 166 Data.SAVE.PureHex Save pure HEX file 166 Data.SAVE.Srecord Save S-record file 167 Data.Set Modify memory 169 Data.SOFTEPILOG Automated sequence after setting software breakp. 172 Data.SOFTPROLOG Automated sequence before setting software breakp. 172 Data.STANDBY Standby data sequence 172 Data.STARTUP Startup data sequence 173 Data.STARTUP.CONDition Define startup condition 173 Data.STARTUP.OFF Switch startup sequence off 173 Data.STARTUP.ON Switch startup data sequence on 174 Data.STARTUP.RESet Reset startup data sequence 174 Data.STARTUP.SEQuence Define startup data sequence 175 Data.STARTUP.state Startup data state display 176 Data.STRING ASCII display 177 Data.SUM Memory checksum 177 Data.TABle Display arrays 180 Data.TAG Tag code for analysis 182 Data.TAGFunc Tag code for analysis 182 Data.Test Memory integrity test 185 Data.TestList Test for memory type 188 Data.TIMER Periodically data sequence 189 Data.TIMER.CONDition Define timer condition 189 Data.TIMER.OFF Switch timer off 190 Data.TIMER.ON Switch timer on 190 Data.TIMER.RESet Reset timer 190 Data.TIMER.SEQuence Define timer sequence 191 Data.TIMER.state Timer state display 192 Data.TIMER.TARGET Define timer target call 192 Data.TIMER.Time Define period for timer 193 Data.UNTAGFunc Remove code tags 193 Data.UPDATE Target memory cache update 193 Data.USRACCESS Prepare USR access 194

DCI ...... 198 DCI Direct Connect Interface (DCI) 198

DQMTrace ...... 199

DTM ...... 200 DTM DTM trace sources (Data Trace Module) 200

DTU ...... 200 DTU Debug Trace Unit (DTU) 200

General Commands Reference Guide E

General Commands Reference Guide E ...... (general_ref_e.pdf) 1

History ...... 6

ELA ...... 7 ELA Embedded logic analyzer (ELA) 7 ELA.CLEAR Clear ELA.Set settings 9 ELA.CLOCK ELA sample rate 10 ELA.OFF Switch ELA off 10 ELA.ON Switch ELA on 10 ELA.Register Display the ELA registers 11 ELA.RESet Reset ELA settings 11 ELA.SELect Select signal group 12 ELA.Set Set ELA registers 13 ELA.state Display ELA configuration window 20 ELA.TimeStampCLOCK External clock frequency 20 ELA.TimeStamps Emit global timestamp packets 21 ELA.TimeStampThreshold Set granularity for occurrence of timestamps 21 ELA.Trace Control generation of trace information 22

ETA ...... 23 ETA Energy test analysis for energy profiling 23 Getting Started 24 Tips ‘n’ Tricks 26 ETA.DRAW Line chart 27 ETA.List Lists the ETA trace data 29 ETA.ListNesting Displays the function call nesting 30 ETA.PROfileChart Power consumption by function as function of time 31 ETA.PROfileChart.AddressGROUP Memory access as a chart 32 ETA.PROfileChart.DatasYmbol Symbolic statistics for data as a chart 33 ETA.PROfileChart.DistriB Graphical distribution analysis 34 ETA.PROfileChart.GROUP Energy per GROUP graphically 35

©1989-2018 Lauterbach GmbH TRACE32 Directory 6 5 ETA.PROfileChart.Line Energy per high-level language line graphically 36 ETA.PROfileChart.POWER Power consumption per channel graphically 37 ETA.PROfileChart.sYmbol Energy for all program symbols graphically 40 ETA.PROfileChart.TASK Energy consumption per task graphically 42 ETA.PROfileChart.TASKINTR Energy of interrupt service routines as a chart 42 ETA.PROfileChart.TASKSRV Energy consumption per service routine 43 ETA.PROfileSTATistic.DatasYmbol Statistics about data symbols 44 ETA.PROfileSTATistic.GROUP Energy per GROUP as a table 45 ETA.PROfileSTATistic.sYmbol Energy for all program symbols as a table 46 ETA.PROfileSTATistic.TASK Energy consumption per TASK as a table 47 ETA.PROfileSTATistic.TASKINTR Energy statistics about ISR2 as a table 47 ETA.PROfileSTATistic.TASKKernel Energy consumption as a table 48 ETA.PROfileSTATistic.TASKSRV Energy analysis of service routines 48 ETA.RESet Reset command 49 ETA.SELect Select the power channels to be analyzed 50 ETA.state Opens the ETA configuration window 53 ETA.STATistic Statistical energy analysis 54 ETA.STATistic.ChildTREE All children of a function as a tree 55 ETA.STATistic.DistriB Distribution analysis 56 ETA.STATistic.Func Function energy analysis 57 ETA.STATistic.GROUP Group analysis 58 ETA.STATistic.LINKage Linkage analysis 60 ETA.STATistic.ParentTREE Parents of a function 61 ETA.STATistic.sYmbol Statistical analysis of energy consumption 62 ETA.STATistic.TASK Task energy analysis 63 ETA.STATistic.TASKINTR Energy of interrupt service routines 64 ETA.STATistic.TASKKernel Energy consumption of tasks and kernel 65 ETA.STATistic.TASKSRV Energy analysis of service routines 66

ETM ...... 67 ETM.AbsoluteTimestamp Absolute cyclecount pakets 67 ETM.ATBTrigger Use ATB to transfer trace trigger to trace sink 67 ETM.AUXCTLR Set ETMv4 implementation-specific auxiliary control register 67 ETM.BBC Branch address broadcast 67 ETM.BBCExclude Exclude address ranges from branch-broadcasting 67 ETM.BBCInclude Enable branch-broadcasting for dedicated address ranges 67 ETM.CLEAR Clear sequencer settings 67 ETM.CLOCK Set core clock frequency for timing measurements 68 ETM.COND Conditional non-branch instructions 68 ETM.ContextID Select the width of the 'ContextID' register 68 ETM.CORE Select core for ETM 68 ETM.CPRT Monitor coprocessor register transfers 68 ETM.CycleAccurate Cycle accurate tracing 68 ETM.CycleCountThreshold Set granularity for cycle accurate timing info 68

©1989-2018 Lauterbach GmbH TRACE32 Directory 6 6 ETM.DataSuppress Suppress data flow to prevent FIFO overflow 68 ETM.DataTrace Configure data-trace 69 ETM.DataTracePrestore Show program trace cycle for data trace cycle 69 ETM.DataViewExclude Suppress data trace for specified address range 69 ETM.DataViewInclude Restrict broadcast of data accesses to range 69 ETM.DBGRQ Debug request control 69 ETM.FifoFullExclude No activation of FIFOFULL in range 69 ETM.FifoFullInclude FIFOFULL only in range 69 ETM.FifoLevel Define FIFO level for FIFOFULL 69 ETM.FunnelHoldTime Define minimum funnel hold time 70 ETM.HalfRate Halfrate mode 70 ETM.INSTP0 Load and store instructions 70 ETM.LPOVERRIDE Prohibit lower power mode 70 ETM.MapDecode Memory map decode control 70 ETM.NoOverflow Enable ETMv4 feature to prevent target FiFo overflows 70 ETM.OFF Switch ETM off 70 ETM.ON Switch ETM on 70 ETM.PortClock Baud rate of serial trace 71 ETM.PortDisable Force trace-port enable signal to zero 71 ETM.PortDisableOnchip Disable ETM trace port when ETB is used 71 ETM.PortFilter Specify utilization of trace memory 71 ETM.PortMode Select ETM mode 71 ETM.PortRoute Set up trace hardware 71 ETM.PortSize Define trace port width 71 ETM.PowerUpRequest Power-up request for the ETM by the debugger 71 ETM.ProcID Define 'ProcID' size 72 ETM.PseudoDataTrace Enable pseudo data trace detection 72 ETM.QE Enable Q elements 72 ETM.QTraceExclude Prohibit Q trace elements in given address range 72 ETM.QTraceInclude Allow Q trace elements in given address range 72 ETM.RefClock Enable STP reference clock 72 ETM.Register Display the ETM registers 72 ETM.ReserveContextID Reserve special values used with context ID 72 ETM.RESet Reset ETM settings 73 ETM.ReturnStack Enable return stack tracing mode 73 ETM.Set Precise control of ETM trigger events 73 ETM.SmartTrace Configure smart trace 73 ETM.STALL Stall processor to prevent FIFO overflow 73 ETM.state Display ETM settings 73 ETM.StoppingBreakPoints Use ETM comparators for breakpoints 73 ETM.SyncPeriod Set synchronization frequency 73 ETM.TDelay Define trigger delay 74 ETM.TImeMode Improve ETM/PTM timestamp information 74

©1989-2018 Lauterbach GmbH TRACE32 Directory 6 7 ETM.TimeStampCLOCK Specify frequency of the global timestamp 74 ETM.TimeStamps Control for global timestamp packets 74 ETM.TimeStampsTrace Specify data trace correlation method (ETMv4) 74 ETM.Trace Control generation of trace information 74 ETM.TraceERRor Force ETM to emit all system error exceptions 74 ETM.TraceExclude Suppress program trace for specified address range 74 ETM.TraceExclude Suppress program trace for specified address range 75 ETM.TraceID Change the default ID for an ETM trace source 75 ETM.TraceInclude Restrict program trace to specified address range 75 ETM.TraceNoPCREL No data trace for accesses relative to program counter 75 ETM.TraceNoSPREL No data trace for accesses relative to stack pointer 75 ETM.TracePriority Define priority of ETM 75 ETM.TraceRESet Forces the ETM to emit all core resets 75 ETM.TRCIDR Define TRCIDR register values for simulator 75 ETM.VMID Virtual machine ID tracing 76

eXception ...... 77 Exception-System of the TRACE32-ICE/TRACE32-FIRE 77 Exception-Command for the ROM-Monitor 77 eXception.Activate Activate lines 77 eXception.Delay Delayed activation 78 eXception.Enable Enable lines 78 eXception.NMIBREAK Enable NMI-Break 79 eXception.NMIPOL NMI polarity 79 eXception.OFF Switch off 80 eXception.ON Switch on 80 eXception.PERiod Cycle duration 80 eXception.POLarity Polarity 81 eXception.Pulse Stimuli generator 81 eXception.RESet Reset command 82 eXception.RESetPOL Reset polarity 83 eXception.Single Trigger single impulse 83 eXception.state Display setup 84 eXception.Trigger Select trigger events 84 eXception.Vector Select vector number 85 eXception.Width Pulse width 86

EXTension ...... 87 EXTension Extend the TRACE32 debugger with custom features 87 EXTension.ACCESS Control memory access 87 EXTension.CONFIG Configure extension 88 EXTension.DEBUG Debug outputs of extension 88 EXTension.DELETE Delete loaded extension 88 EXTension.LOAD Load extension 89 EXTension.MaxVSize Set max vertical size of extension windows 89

General Commands Reference Guide F

General Commands Reference Guide F ...... (general_ref_f.pdf) 1

History ...... 7

FDX ...... 8 FDX tbd. 8 Trace Method FDX 8

FDX-specific Trace Command ...... 9 FDX.METHOD Select communication channel 9

Generic FDX Commands ...... 11 FDX.Arm Arm the trace 11 FDX.AutoArm Arm automatically 11 FDX.AutoFocus Calibrate AUTOFOCUS preprocessor 11 FDX.AutoInit Automatic initialization 11 FDX.AutoTEST Continuous measurement 11 FDX.BookMark Set a bookmark in trace listing 11 FDX.Chart Display trace contents graphically 12 FDX.Chart.DistriB Distribution display 12 FDX.Chart.Func Function activity chart 12 FDX.Chart.GROUP Group activity chart 12 FDX.Chart.Line Graphical HLL lines analysis 12 FDX.Chart.sYmbol Symbol analysis 12 FDX.Chart.TASK Task activity chart 12 FDX.Chart.TASKFunc Task related function run-time analysis (legacy) 13 FDX.Chart.TASKSRV Service routine run-time analysis 13 FDX.Chart.TASKState Task state analysis 13 FDX.Chart.VarState Variable activity chart 13 FDX.CLEAR Clear FDX communication buffers 13 FDX.CLOSE Close FDX files 13 FDX.ComPare Compare trace contents 13 FDX.DISable Disable the trace 14 FDX.DISableChannel Disable FDX communication 14 FDX.DRAW Visualization of trace data 14 FDX.ENableChannel Enable FDX communication 14 FDX.EXPORT Export trace data for processing in other applications 14 FDX.FILE Load a file into the file trace buffer 14 FDX.Find Find specified entry in trace 14 FDX.FindAll Find all specified entries in trace 14

©1989-2018 Lauterbach GmbH TRACE32 Directory 6 9 FDX.FindChange Search for changes in trace flow 15 FDX.GOTO Move cursor to specified trace record 15 FDX.InChannel Inchannel state display 15 FDX.Init Initialize trace 15 FDX.List List trace contents 15 FDX.ListNesting Analyze function nesting 15 FDX.ListVar List variable recorded to trace 15 FDX.LOAD Load trace file for offline processing 15 FDX.Mode Set the trace operation mode 16 FDX.OFF Switch off 16 FDX.Out tbd. 16 FDX.PROfileChart Profile charts 16 FDX.PROfileChart.DIStance Time interval for a single event 16 FDX.PROfileChart.DURation Time between two events 16 FDX.PROfileChart.GROUP Group profile chart 16 FDX.PROfileChart.Rate Event frequency 17 FDX.PROTOcol.Chart Graphic display for user-defined protocol 17 FDX.PROTOcol.Draw Graphic display for user-defined protocol 17 FDX.PROTOcol.EXPORT Export trace buffer for user-defined protocol 17 FDX.PROTOcol.Find Find in trace buffer for user-defined protocol 17 FDX.PROTOcol.List Display trace buffer for user-defined protocol 17 FDX.PROTOcol.STATistic Display statistics for user-defined protocol 17 FDX.Rate Select sampling rate 18 FDX.REF Set reference point for time measurement 18 FDX.RESet Reset command 18 FDX.SAVE Save trace for postprocessing in TRACE32 18 FDX.SelfArm Automatic restart of trace recording 18 FDX.SIZE Define buffer size 18 FDX.SnapShot Restart trace capturing once 18 FDX.state Display trace configuration window 18 FDX.STATistic Statistic analysis 19 FDX.STATistic.DIStance Time interval for a single event 19 FDX.STATistic.DistriB Distribution analysis 19 FDX.STATistic.DURation Time between two events 19 FDX.STATistic.Func Nesting function runtime analysis 19 FDX.STATistic.GROUP Group run-time analysis 19 FDX.STATistic.Ignore Ignore false records in statistic 19 FDX.STATistic.InterruptIsFunction Statistics interrupt processing 20 FDX.STATistic.Line HLL-line analysis 20 FDX.STATistic.LINKage Per caller statistic of function 20 FDX.STATistic.Measure Analyze the performance of a single signal 20 FDX.STATistic.PreFetch Prefetch detection 20 FDX.STATistic.Sort Specify sorting criterion for statistic commands 20

©1989-2018 Lauterbach GmbH TRACE32 Directory 7 0 FDX.STATistic.sYmbol Flat run-time analysis 20 FDX.STATistic.TASK Task activity statistic 21 FDX.STATistic.TASKFunc Task specific function run-time analysis 21 FDX.STATistic.TASKKernel Task analysis with kernel markers (flat) 21 FDX.STATistic.TASKSRV Analysis of time in OS service routines 21 FDX.STATistic.TASKState Performance analysis 21 FDX.STATistic.TASKTREE Tree display of task specific functions 21 FDX.STATistic.TREE Tree display of nesting function run-time analysis 21 FDX.STATistic.Use Use records 22 FDX.TimeStamp Configure timestamp usage of LOGGER trace 22 FDX.Timing Waveform of trace buffer 22 FDX.TraceChannel tbd. 22 FDX.TRACK Set tracking record 22 FDX.View Display single record 22 FDX.ZERO Align timestamps of trace and timing analyzers 22

FIFO ...... 23 FIFO Display on-chip trace FIFO 23

FLAG ...... 24 FLAG Flag system of ICE and FIRE 24 Overview FLAG 24 FLAG.Delete Delete flags 26 FLAG.Init Initialization 27 FLAG.List Display flags 27 FLAG.ListFunc Code-coverage functions 28 FLAG.ListModul Code-coverage modules 31 FLAG.ListVar Code-coverage variables 33 FLAG.OFF Switch off flag system 35 FLAG.ON Switch on flag system 36 FLAG.RESet Reset 36 FLAG.Set Set 36 FLAG.SetSec Mark sections 37 FLAG.state State 37

FLASH ...... 39 FLASH External FLASH memories and on-chip FLASH memories 39 Overview FLASH 39 FLASH.AUTO Auto programming of FLASH 40 FLASH.BSDLaccess Enables FLASH access via boundary scan 41 FLASH.CFI Generate FLASH declaration by CFI 42 FLASH.CHANGEtype Changes the FLASH type 46 FLASH.CLocK Setup input clock for processor internal flash 47 FLASH.Create Declare FLASH 48 FLASH.CreateALIAS Create address alias 53

©1989-2018 Lauterbach GmbH TRACE32 Directory 7 1 FLASH.Delete Delete entry in FLASH declaration table 54 FLASH.Erase Erase FLASH 55 FLASH.HOOKSCRIPT PRACTICE script based FLASH programming prolog 55 FLASH.List Display FLASH definition table 57 FLASH.LOCK Lock FLASH 58 FLASH.MultiProgram Simultaneous programming of flash sectors 59 FLASH.OFFSET Change FLASH control address 59 FLASH.Program Program FLASH 60 FLASH.ReProgram Re-program FLASH 61 FLASH.RESet Reset FLASH declaration table 62 FLASH.SPICMD Send data to SPI FLASH device 63 FLASH.state FLASH programming dialog 65 FLASH.TARGET Define target controlled algorithm 66 FLASH.TARGET2 Define second target controlled algorithm 73 FLASH.UNLOCK Unlock FLASH 74 FLASH.UNSECUREerase Unsecure a device 76

FLASHFILE ...... 77 FLASHFILE NAND flash and serial flash devices 77 FLASHFILE.BSDLaccess Enables FLASH access via boundary scan 77 FLASHFILE.BSDLFLASHTYPE Define FLASH type 78 FLASHFILE.CONFIG Configure FLASH 78 FLASHFILE.COPY Copy to FLASH 79 FLASHFILE.COPYSPARE Copy to spare area of NAND FLASH 80 FLASHFILE.Create Declaration of flash memories: create a block/sector 81 FLASHFILE.DUMP Dump FLASH 82 FLASHFILE.Erase Erase FLASH 83 FLASHFILE.GETBADBLOCK Get the bad block addresses 84 FLASHFILE.GETEXTCSD Get the extended CSD register 84 FLASHFILE.GETID Get ID 85 FLASHFILE.GETONFI Display ONFI 85 FLASHFILE.List List blocks or sectors of FLASH memory 86 FLASHFILE.LOAD Load files to FLASH 87 FLASHFILE.LOAD.binary Write FLASH 87 FLASHFILE.LOAD.Elf Load ELF file 90 FLASHFILE.LOAD.IntelHex Load Intel hex file 90 FLASHFILE.LOAD.Srecord Load an 'Srecord' file 91 FLASHFILE.LOADALL Load to main area and spare area 91 FLASHFILE.LOADECC Load ECC file to spare area 92 FLASHFILE.LOADSPARE Write NAND FLASH spare area 94 FLASHFILE.LOCK Lock the FLASH device 94 FLASHFILE.MSYSDLL Access an M-Systems DiskOnChip flash device 95 FLASHFILE.RESet Reset FLASH configuration 95 FLASHFILE.SAVE Save FLASH 96

©1989-2018 Lauterbach GmbH TRACE32 Directory 7 2 FLASHFILE.SAVEALL Save the main area and the spare area 96 FLASHFILE.SAVEECC Save error correction code (ECC) to file 97 FLASHFILE.SAVEECC.BCH Save ECC with BCH algorithm 97 FLASHFILE.SAVEECC.hamming Save ECC with Hamming algorithm 100 FLASHFILE.SAVEECC.ReedSolomon Save ECC with Reed-S. algorithm 103 FLASHFILE.SAVESPARE Read NAND FLASH spare area 105 FLASHFILE.Set Modify FLASH data 105 FLASHFILE.SETEXTCSD Modify the extended CSD register 106 FLASHFILE.SPICMD Send data to SPI FLASH device 107 FLASHFILE.state tbd. 109 FLASHFILE.TARGET Define target controlled algorithm 110 FLASHFILE.UNLOCK Unlock FLASH device 111

FPU ...... 112 FPU Access to FPU registers 112 FPU.OFF FPU access off 112 FPU.ON FPU access on 113 FPU.RESet Reset command 113 FPU.Set Modify FPU registers 113 FPU.TARGET Define FPU access agent 114 FPU.view Display FPU registers 114

Frame ...... 115 Frame Call-tree and context 115 Frame.CONFIG Fine-tune stack unwinding 115 Frame.CONFIG.Asm Frame back-trace mode 115 Frame.CONFIG.EABI Use chained frame pointers 116 Frame.CONFIG.EPILOG Use epilog code for frame display 117 Frame.CONFIG.PROLOG Use prolog code for frame display 117 Frame.CONFIG.RELOAD Generate frame information again 118 Frame.CONFIG.sYmbol Use symbol code for frame display 118 Frame.COPY Copy to TRACE32 registers 119 Frame.Down Go down in stack nesting 119 Frame.GOTO Change source code view temporarily 119 Frame.Init Initialize the processor registers 120 Frame.REDO Recover from UNDO registers 123 Frame.SkipFunc Change view to previous/subsequent function 123 Frame.SkipLine Change view to previous/subsequent HLL line 124 Frame.SWAP Swap TRACE32 registers 124 Frame.TASK Change view to specified task 124 Frame.UNDO Recover previous registers 126 Frame.Up Go up in stack nesting 126 Frame.view Display stack frame 128

FXU ...... 130

©1989-2018 Lauterbach GmbH TRACE32 Directory 7 3 FXU FXU registers (extended floating point unit) 130 FXU.Init Initialize FXU registers 130 FXU.Set Modify FXU registers 130 FXU.view Open FXU register window 131

General Commands Reference Guide G

General Commands Reference Guide G ...... (general_ref_g.pdf) 1

History ...... 3

GLOBALON ...... 4 GLOBALON Global event-controlled PRACTICE script execution 4

Go ...... 9 Go Debug control, program execution, and real-time emulation 9 Debug Control for Debuggers 9 Debug Control for TRACE32-ICE 10 Go.Asm Start the program execution and switch to Asm mode 11 Go.Back Go back in program (CTS) 13 Go.BackEntry Go back in program to function entry (CTS) 14 Go.BackGround Start background program 14 Go.BackTillWarning Go back in program until warning (CTS) 15 Go.Change Run program till content changes 15 Go.direct Start the program execution 16 Go.Hll Start the program execution and switch to HLL mode 18 Go.Java Run program until JAVA code starts 19 Go.Mix Start the program execution and switch to 'Mix' mode 20 Go.MONitor Switch to run mode debugging 21 Go.Next Start program and stop at next line 21 Go.NoBreak Emulation breakpoints disabled 21 Go.Return Complete HLL function 22 Go.Till Run program till expression becomes true 25 Go.TillWarning Re-run program until warning (CTS) 26 Go.Up Go up in function nesting 27

GROUP ...... 28 GROUP Group functions, modules, or tasks 28 Features 28 GROUP.COLOR Define color for group indicator 32 GROUP.Create Create a new group 33 GROUP.CreateFunctions Pool functions to group 34 GROUP.CreateLabels Use labels to pool address ranges to group 35 GROUP.CreateModules Pool modules to group 37 GROUP.CreatePrograms Pool programs group 38 GROUP.CreateSources Pool source files to group 39

©1989-2018 Lauterbach GmbH TRACE32 Directory 7 4 GROUP.CreateTASK Pool tasks to group 40 GROUP.Delete Delete the specified group 42 GROUP.DeleteTASK Delete specified task from group 42 GROUP.DISable Disable a group 43 GROUP.ENable Enable a group 43 GROUP.HIDE Hide group from debugging 44 GROUP.List List all specified groups 44 GROUP.Merge Merge group members in statistic 45 GROUP.RESet Clear all group specifications 45 GROUP.SEParate Separate group members in statistic 46 GROUP.SHOW Show group for debugging 46

General Commands Reference Guide H

General Commands Reference Guide H ...... (general_ref_h.pdf) 1

HAnalyzer ...... 5 HAnalyzer Host analyzer 5 Trace Method HAnalyzer 5

HAnalyzer-specific Trace Command ...... 7 HAnalyzer.state Display HAnalyzer trace configuration window 7

Generic HAnalyzer Trace Commands ...... 8 HAnalyzer.ACCESS Define access path to source code for trace decoding 8 HAnalyzer.Arm Arm the trace 8 HAnalyzer.BookMark Set a bookmark in trace listing 8 HAnalyzer.BookMarkToggle Toggles a single trace bookmark 8 HAnalyzer.Chart Display trace contents graphically 8 HAnalyzer.CLOCK Clock to calculate time out of cycle count information 8 HAnalyzer.ComPare Compare trace contents 9 HAnalyzer.DISable Disable the trace 9 HAnalyzer.DRAW Visualization of trace data 9 HAnalyzer.EXPORT Export trace data for processing in other applications 9 HAnalyzer.FILE Load a file into the file trace buffer 9 HAnalyzer.Find Find specified entry in trace 9 HAnalyzer.FindAll Find all specified entries in trace 9 HAnalyzer.FindChange Search for changes in trace flow 9 HAnalyzer.FLOWPROCESS Process flowtrace 10 HAnalyzer.FLOWSTART Restart flowtrace processing 10 HAnalyzer.Get Display input level 10 HAnalyzer.GOTO Move cursor to specified trace record 10 HAnalyzer.Init Initialize trace 10 HAnalyzer.List List trace contents 10 HAnalyzer.ListNesting Analyze function nesting 10 HAnalyzer.LOAD Load trace file for offline processing 10

©1989-2018 Lauterbach GmbH TRACE32 Directory 7 5 HAnalyzer.OFF Switch off 11 HAnalyzer.PROfileChart Profile charts 11 HAnalyzer.PROfileSTATistic Statistical analysis in a table versus time 11 HAnalyzer.REF Set reference point for time measurement 11 HAnalyzer.RESet Reset command 11 HAnalyzer.SAVE Save trace for postprocessing in TRACE32 11 HAnalyzer.STATistic Statistic analysis 11 HAnalyzer.Timing Waveform of trace buffer 11 HAnalyzer.TRACK Set tracking record 12 HAnalyzer.View Display single record 12 HAnalyzer.ZERO Align timestamps of trace and timing analyzers 12

HTM ...... 13 HTM CoreSight HTM (AHB Trace Macrocell) 13 HTM.AsicControl Set HTMASICCONTROL register 13 HTM.AuxTrace Auxiliary packet control 14 HTM.BusSelect Set HTMBUSSELECT register 14 HTM.BusTrigger Bus trigger definition 14 HTM.CLEAR Clear HTM.Set settings 15 HTM.CLOCK Core clock frequency 15 HTM.CycleAccurate Cycle accurate tracing 16 HTM.DataTrace Define broadcast of data accesses 17 HTM.ExtDisable Set EXTDISABLE bit 17 HTM.FifoLevel Define FIFO level 18 HTM.OFF Switch HTM off 18 HTM.ON Switch HTM on 18 HTM.Register Display HTM control registers 19 HTM.RESet Reset HTM settings 19 HTM.Set Program HTM manually 20 HTM.state Display HTM configuration window 20 HTM.SyncPeriod Set period of sync packet injection 21 HTM.Trace Trace packet control 21 HTM.TraceExclude No broadcast of data accesses within range 22 HTM.TraceID Set trace ID manually 22 HTM.TraceInclude Restrict broadcast of data accesses to range 23 HTM.TraceOFF HTM stops to emit trace information on event 23 HTM.TraceON HTM starts to emit trace information on event 24 HTM.TracePriority Set priority for the HTM manually 25 HTM.TraceTrigger Trace trigger definition 25

HTM - Trace Data Analysis ...... 26 Overview HTM 26 HTMAnalyzer Analyze HTM information recorded by TRACE32 PowerTrace 26 HTMOnchip Analyze HTM information captured in target onchip memory 27

HVX ...... 29 HVX HVX registers (Hexagon Vector Extensions) 29 HVX.Init Initialize HVX registers 29 HVX.OFF Inhibit HVX accesses by the debugger 29 HVX.ON Permit HVX accesses by the debugger 30 HVX.Set Modify HVX registers 30 HVX.view Open HVX register window 30

General Commands Reference Guide I

General Commands Reference Guide I ...... (general_ref_i.pdf) 1

I2C ...... 7 I2C I2C control 7 I2C.PIN Set I2C pin to specified level 7 I2C.THreshold Specify threshold for logical low 8 I2C.TRANSFER Transfer bytes on I2C bus 8

Integrator ...... 10 Integrator tbd. 10 Trace Method Integrator 10

Integrator Trace Commands ...... 12 Integrator.ABCDEF Sampling configuration for probes ABCDEF 12 Integrator.ACCESS Define access path to source code for trace decoding 12 Integrator.Arm Arm the trace 12 Integrator.AutoArm Arm automatically 12 Integrator.AutoFocus Calibrate AUTOFOCUS preprocessor 12 Integrator.AutoInit Automatic initialization 12 Integrator.AutoTEST Continuous measurement 13 Integrator.BookMark Set a bookmark in trace listing 13 Integrator.Break Stop trace 13 Integrator.Chart Display trace contents graphically 13 Integrator.Chart.DistriB Distribution display 13 Integrator.Chart.Func Function activity chart 13 Integrator.Chart.GROUP Group activity chart 13 Integrator.Chart.Line Graphical HLL lines analysis 14 Integrator.Chart.sYmbol Symbol analysis 14 Integrator.Chart.TASK Task activity chart 14 Integrator.Chart.TASKFunc Task related function run-time analysis (legacy) 14 Integrator.Chart.TASKSRV Service routine run-time analysis 14 Integrator.Chart.TASKState Task state analysis 14 Integrator.Chart.VarState Variable activity chart 14

©1989-2018 Lauterbach GmbH TRACE32 Directory 7 7 Integrator.ComPare Compare trace contents 15 Integrator.CSELect Select signal for counter 15 Integrator.DISable Disable the trace 15 Integrator.DisConfig Trace disassembler configuration 15 Integrator.DisConfig.CYcle Trace disassemble setting 15 Integrator.DisConfig.FlowMode Enable FlowTrace analysis 15 Integrator.DisConfig.RESet Reset trace disassemble setting 15 Integrator.DisConfig.view Trace disassemble setting 16 Integrator.DRAW Visualization of trace data 16 Integrator.EXPORT Export trace data for processing in other applications 16 Integrator.FILE Load a file into the file trace buffer 16 Integrator.Find Find specified entry in trace 16 Integrator.FindAll Find all specified entries in trace 16 Integrator.FindChange Search for changes in trace flow 16 Integrator.FLOWPROCESS Process flowtrace 17 Integrator.FLOWSTART Restart flowtrace processing 17 Integrator.Get Display input level 17 Integrator.GOTO Move cursor to specified trace record 17 Integrator.Init Initialize trace 17 Integrator.JKLMNO Sampling configuration for probes JKLMNO 17 Integrator.List List trace contents 17 Integrator.ListNesting Analyze function nesting 18 Integrator.ListVar List variable recorded to trace 18 Integrator.LOAD Load trace file for offline processing 18 Integrator.Mode Set the trace operation mode 18 Integrator.OFF Switch off 18 Integrator.PROfileChart.DIStance Time interval for a single event 18 Integrator.PROfileChart.DURation Time between two events 18 Integrator.PROfileChart.GROUP Group profile chart 19 Integrator.PROfileChart.Rate Event frequency 19 Integrator.Program Program trigger unit 19 Integrator.PROTOcol Protocol analysis 19 Integrator.PROTOcol.Chart Graphic display for user-defined protocol 19 Integrator.PROTOcol.Draw Graphic display for user-defined protocol 19 Integrator.PROTOcol.EXPORT Export trace buffer for user-defined protocol 19 Integrator.PROTOcol.Find Find in trace buffer for user-defined protocol 20 Integrator.PROTOcol.List Display trace buffer for user-defined protocol 20 Integrator.PROTOcol.STATistic Display statistics for user-defined protocol 20 Integrator.REF Set reference point for time measurement 20 Integrator.ReProgram Program trigger unit 20 Integrator.RESet Reset command 20 Integrator.SAVE Save trace for postprocessing in TRACE32 20 Integrator.SelfArm Automatic restart of trace recording 21

©1989-2018 Lauterbach GmbH TRACE32 Directory 7 8 Integrator.SIZE Define buffer size 21 Integrator.SnapShot Restart trace capturing once 21 Integrator.state Display trace configuration window 21 Integrator.STATistic Statistic analysis 21 Integrator.STATistic.BondOut Bondout mode 21 Integrator.STATistic.DIStance Time interval for a single event 21 Integrator.STATistic.DistriB Distribution analysis 22 Integrator.STATistic.DURation Time between two events 22 Integrator.STATistic.Func Nesting function runtime analysis 22 Integrator.STATistic.GROUP Group run-time analysis 22 Integrator.STATistic.Ignore Ignore false records in statistic 22 Integrator.STATistic.InterruptIsFunction Statistics interrupt processing 22 Integrator.STATistic.Line HLL-line analysis 22 Integrator.STATistic.LINKage Per caller statistic of function 23 Integrator.STATistic.Measure Analyze the performance of a single signal 23 Integrator.STATistic.PreFetch Prefetch detection 23 Integrator.STATistic.Sort Specify sorting criterion for statistic commands 23 Integrator.STATistic.sYmbol Flat run-time analysis 23 Integrator.STATistic.TASK Task activity statistic 23 Integrator.STATistic.TASKFunc Task specific function run-time analysis 23 Integrator.STATistic.TASKKernel Task analysis with kernel markers (flat) 24 Integrator.STATistic.TASKSRV Analysis of time in OS service routines 24 Integrator.STATistic.TASKState Performance analysis 24 Integrator.STATistic.TASKTREE Tree display of task specific functions 24 Integrator.STATistic.TREE Tree display of nesting function run-time analysis 24 Integrator.STATistic.Use Use records 24 Integrator.TCount Set trigger counter 24 Integrator.TDelay Trigger delay 25 Integrator.Timing Waveform of trace buffer 25 Integrator.TOut Enable trigger output line (PowerIntegrator) 25 Integrator.TPreDelay Pre-trigger delay 25 Integrator.TRACK Set tracking record 25 Integrator.TRIGGER Trigger the trace 25 Integrator.TSELect Select trigger source 25 Integrator.TSYNC Select trigger line and mode 25 Integrator.TView Display trigger settings 26 Integrator.TWidth Set trigger filter 26 Integrator.View Display single record 26 Integrator.ZERO Align timestamps of trace and timing analyzers 26

IProbe ...... 27 IProbe IProbe logic analyzer 27 Trace Method IProbe 28 IProbe.Arm Enables IProbe recording 30

©1989-2018 Lauterbach GmbH TRACE32 Directory 7 9 IProbe.AutoArm IProbe self-contained recording 30 IProbe.AutoInit IProbe self-contained initialization 31 IProbe.BookMark Set a bookmark in trace listing 31 IProbe.Break Manual IProbe break 31 IProbe.BusA Podbus trigger signal 32 IProbe.Chart Display trace contents graphically 32 IProbe.ComPare Compare two traces or the trace buffer against a file 32 IProbe.CSELect Source select for system counter 33 IProbe.DISable Disable the IProbe 33 IProbe.DRAW Display analog trace graphically 33 IProbe.EXPORT Export trace data 34 IProbe.FILE Load a file into the file trace buffer 34 IProbe.Find Search for pattern 34 IProbe.FindAll Search for pattern 35 IProbe.FindChange Search for changes in trace flow 35 IProbe.Get Input signal level and activity 35 IProbe.GOTO Move cursor to specified trace record 35 IProbe.Init IProbe initialization 36 IProbe.List Displays trace in table format 36 IProbe.LOAD Reload saved IProbe trace contents 36 IProbe.Mode Set trace operation mode 37 IProbe.OFF Switch off IProbe recording 37 IProbe.PROfileChart Graphic display of time interval 37 IProbe.PROTOcol Protocol analysis 37 IProbe.PROTOcol.Chart Graphic display for user define protocol 38 IProbe.PROTOcol.Draw Graphic display for user define protocol 38 IProbe.PROTOcol.EXPORT Export trace buffer for user-defined protocol 38 IProbe.PROTOcol.Find Find in trace buffer for user-defined protocol 38 IProbe.PROTOcol.List Display trace buffer for user-defined protocol 39 IProbe.PROTOcol.STATistic Display statistic for user-defined protocol 39 IProbe.REF Set reference record for timing measurements 39 IProbe.RESet Reset command 39 IProbe.SAVE Save IProbe trace memory into file 40 IProbe.SelfArm Immediate IProbe analyzer turn on 40 IProbe.SELFTEST Iprobe self-test 40 IProbe.SIZE Define the trace buffer size 41 IProbe.SnapShot Restart trace capturing once 41 IProbe.state Display the IProbe configuration window 42 IProbe.STATistic Statistic analysis 43 IProbe.TCount Define a trigger counter 43 IProbe.TDelay Define a trigger delay counter 43 IProbe.Timing Displays channels as waveform graphics 43 IProbe.TOut Activates/deactivates the trigger output signal (BUSA) 44

©1989-2018 Lauterbach GmbH TRACE32 Directory 8 0 IProbe.TPreDelay Define the trigger pre-delay counter 44 IProbe.TRIGGER Ineffective command 44 IProbe.TSELect Select trigger input line 44 IProbe.TSYNC Select trigger line and mode 45 IProbe.TSYNC.SELect Select trigger input pin and edge or state 45 IProbe.TSYNC.SIMPLE Select simple trigger 45 IProbe.TWidth Define trigger pulse width 45 IProbe.View Displays just a single trace record 46 IProbe.XTrack Use 'SYnch.XTrack' instead 46

ISTATistic ...... 47 ISTATistic Instruction statistics 47 Overview ISTATistic 47 ISTATistic.ADD Add trace contents to ISTAT database 51 ISTATistic.Delete Delete selected code coverage information 54 ISTATistic.EXPORT Export instruction statistics to an XML file 55 ISTATistic.EXPORT.ListFunc Export the HLL functions 55 ISTATistic.EXPORT.ListLine Export the HLL lines 56 ISTATistic.EXPORT.ListModule Export the modules 57 ISTATistic.Init Initialize ISTAT database 57 ISTATistic.List Runtime analysis overview 57 ISTATistic.ListFunc List run-time analysis of functions 58 ISTATistic.ListLine List run-time analysis of HLL lines 59 ISTATistic.ListModule List module tree of ISTAT database 59 ISTATistic.LOAD Load ISTAT database from file 59 ISTATistic.METHOD Recording method for instruction statistics 60 ISTATistic.OFF Deactivate the selected instruction statistics method 61 ISTATistic.ON Activate the selected instruction statistics method 61 ISTATistic.RESet Delete ISTAT database 61 ISTATistic.SAVE Save ISTAT database to file 62 ISTATistic.Set Mark specified addresses as executed 62 ISTATistic.state Display ISTAT configuration window 63

ITM ...... 64 ITM CoreSight ITM (Instrumentation Trace Macrocell) 64 ITM.CLEAR Reset ITM control register 65 ITM.CLOCK Core clock frequency 65 ITM.CycleAccurate Cycle accurate tracing 66 ITM.CycleMode Timestamp source 66 ITM.CyclePrescaler Set timestamp clock prescaler 67 ITM.DataTrace Define broadcast of data accesses 68 ITM.DWTADDRESS Supply comparator values 70 ITM.InterruptTrace Emit interrupt event information 71 ITM.OFF Switch ITM off 72 ITM.ON Switch ITM on 72

©1989-2018 Lauterbach GmbH TRACE32 Directory 8 1 ITM.PCSampler Emit PC in a regular interval 72 ITM.PortClock ITM traceport configuration 73 ITM.PortFilter Filter by channel 73 ITM.PortMode Trace export information 74 ITM.PortRoute Selects the trace port 74 ITM.PortSize Trace export size 75 ITM.ProfilingTrace Provide DWT counter information 75 ITM.Register Display ITM control registers 76 ITM.RESet Reset ITM settings 76 ITM.state Display ITM configuration window 77 ITM.SyncPeriod Set period of sync packet injection 78 ITM.TImeMode Type of timestamp 79 ITM.TimeStamp Emit global timestamp packets 80 ITM.TimeStampCLOCK External clock frequency 80 ITM.TimeStampMode Clock source for local timestamp 81 ITM.TraceID Set trace ID manually 81 ITM.TracePriority Set priority for the ITM manually 81

ITM - Trace Data Analysis ...... 82 Overview ITM 82 ITMAnalyzer Analyze ITM information recorded by TRACE32 PowerTrace 82 ITMCAnalyzer Analyze ITM information recorded by TRACE32 CombiProbe 83 ITMOnchip Analyze ITM information captured in target onchip memory 83

General Commands Reference Guide J

General Commands Reference Guide J ...... (general_ref_j.pdf) 1

Java ...... 4 Java Java debugging subsystem 4 Java.CONFIG Configure VM type for debugging 5 Java.LOAD Load all Java symbols 6 Java.LOADCLASS Load Java class information 6 Java.MAP Java VM specific mappings 7 Java.MAP.ByteCode Define bytecode area 7 Java.MAP.IP Configure Java VM instruction pointer 8 Java.MAP.List List Java VM specific mappings 9 Java.MAP.LOADATTR Load attribute information from Java class files 9 Java.MAP.NoByteCode Remove bytecode mapping 9 Java.MAP.NoVM Remove VM interpreter flag 10 Java.MAP.NoVMStop Remove breakpoint in VM interpreter 10 Java.MAP.RESet Reset Java VM mappings 10 Java.MAP.VM Configure Java VM interpreter routine area 11 Java.MAP.VMStop Configure breakpoint in VM interpreter 11 Java.OFF Disable Java VM debugging subsystem 12

JTAG ...... 13 JTAG Low-level JTAG control 13 JTAG.LOADBIT Configure a Xilinx FPGA with a BIT file 14 JTAG.LOCK Grab the JTAG port for manual control 15 JTAG.PARKSTATE Define the hand over TAP state 16 JTAG.PIN Set JTAG signals manually 17 JTAG.PROGRAM Run programming file 19 JTAG.PROGRAM.Altera Program Altera FPGAs 20 JTAG.PROGRAM.auto Detect and run programming file 20 JTAG.PROGRAM.JAM Run programming file in JAM/STAPL format 21 JTAG.PROGRAM.JBC Run programming file in binary JAM/STAPL format 22 JTAG.PROGRAM.SVF Run programming file in SVF format 23 JTAG.PROGRAM.Xilinx Program Xilinx FPGAs 25 JTAG.RESet tbd. 26 JTAG.SHIFTREG Send a TDI pattern on the JTAG port 26 JTAG.SHIFTTDI Send a TDI pattern on the JTAG port 27 JTAG.SHIFTTMS Send a TMS pattern on the JTAG port 28 JTAG.UNLOCK Hand the JTAG port control back to the debugger 28 JTAG.USECLOCK Observe shift commands 29 JTAG.X7EFUSE Program Xilinx 7-Series eFuses 30

General Commands Reference Guide K

General Commands Reference Guide K ...... (general_ref_k.pdf) 1

General Commands Reference Guide L

General Commands Reference Guide L ...... (general_ref_l.pdf) 1

LA ...... 8 LA Logic analyzer 8 Trace Method LA 8

LA - Trace Commands ...... 9 LA.ACCESS Define access path to source code for trace decoding 9 LA.Arm Arm the trace 9 LA.AutoArm Arm automatically 9 LA.AutoFocus Calibrate AUTOFOCUS preprocessor 9 LA.AutoInit Automatic initialization 9 LA.AutoTEST Continuous measurement 9 LA.BookMark Set a bookmark in trace listing 10 LA.Chart Display trace contents graphically 10 LA.Chart.Func Function activity chart 10

©1989-2018 Lauterbach GmbH TRACE32 Directory 8 3 LA.Chart.GROUP Group activity chart 10 LA.Chart.Line Graphical HLL lines analysis 10 LA.Chart.sYmbol Symbol analysis 10 LA.Chart.TASK Task activity chart 10 LA.Chart.TASKFunc Task related function run-time analysis (legacy) 11 LA.Chart.TASKSRV Service routine run-time analysis 11 LA.Chart.TASKState Task state analysis 11 LA.Chart.VarState Variable activity chart 11 LA.ComPare Compare trace contents 11 LA.DISable Disable the trace 11 LA.DRAW Visualization of trace data 11 LA.EXPORT Export trace data for processing in other applications 12 LA.FILE Load a file into the file trace buffer 12 LA.Find Find specified entry in trace 12 LA.FindAll Find all specified entries in trace 12 LA.FindChange Search for changes in trace flow 12 LA.FLOWPROCESS Process flowtrace 12 LA.FLOWSTART Restart flowtrace processing 12 LA.GOTO Move cursor to specified trace record 13 LA.IMPORT Import trace information 13 LA.IMPORT.CoreByteStream Import pure single core trace data 13 LA.IMPORT.ETB Import on-chip trace data 13 LA.IMPORT.flow Import bus trace data 13 LA.IMPORT.GUESSWRAP Guess wrap pointer 13 LA.IMPORT.STP Import STP recording from file (nibble) 13 LA.IMPORT.STPByteStream Import STP recording from file (byte) 14 LA.IMPORT.TraceFile Import trace data where processing has failed 14 LA.IMPORT.TracePort Import off-chip trace data 14 LA.IMPORT.VCD Import recorded signals in VCD file format 14 LA.IMPORT.WRAP Define wrap pointer 14 LA.Init Initialize trace 14 LA.List List trace contents 14 LA.ListNesting Analyze function nesting 15 LA.ListVar List variable recorded to trace 15 LA.LOAD Load trace file for offline processing 15 LA.Mode Set the trace operation mode 15 LA.OFF Switch off 15 LA.PROfileChart Profile charts 15 LA.PROfileChart.DIStance Time interval for a single event 15 LA.PROfileChart.GROUP Group profile chart 16 LA.PROfileChart.Rate Event frequency 16 LA.PROTOcol Protocol analysis 16 LA.PROTOcol.Chart Graphic display for user-defined protocol 16

©1989-2018 Lauterbach GmbH TRACE32 Directory 8 4 LA.PROTOcol.Draw Graphic display for user-defined protocol 16 LA.PROTOcol.EXPORT Export trace buffer for user-defined protocol 16 LA.PROTOcol.Find Find in trace buffer for user-defined protocol 16 LA.PROTOcol.List Display trace buffer for user-defined protocol 17 LA.PROTOcol.STATistic Display statistics for user-defined protocol 17 LA.REF Set reference point for time measurement 17 LA.RESet Reset command 17 LA.SAVE Save trace for postprocessing in TRACE32 17 LA.SelfArm Automatic restart of trace recording 17 LA.SIZE Define buffer size 17 LA.SnapShot Restart trace capturing once 18 LA.state Display trace configuration window 18 LA.STATistic Statistic analysis 18 LA.STATistic.BondOut Bondout mode 18 LA.STATistic.DIStance Time interval for a single event 18 LA.STATistic.DistriB Distribution analysis 18 LA.STATistic.DURation Time between two events 18 LA.STATistic.Func Nesting function runtime analysis 19 LA.STATistic.GROUP Group run-time analysis 19 LA.STATistic.Ignore Ignore false records in statistic 19 LA.STATistic.InterruptIsFunction Statistics interrupt processing 19 LA.STATistic.Line HLL-line analysis 19 LA.STATistic.LINKage Per caller statistic of function 19 LA.STATistic.Measure Analyze the performance of a single signal 19 LA.STATistic.PreFetch Prefetch detection 20 LA.STATistic.Sort Specify sorting criterion for statistic commands 20 LA.STATistic.sYmbol Flat run-time analysis 20 LA.STATistic.TASK Task activity statistic 20 LA.STATistic.TASKFunc Task specific function run-time analysis 20 LA.STATistic.TASKKernel Task analysis with kernel markers (flat) 20 LA.STATistic.TASKSRV Analysis of time in OS service routines 20 LA.STATistic.TASKState Performance analysis 21 LA.STATistic.TASKTREE Tree display of task specific functions 21 LA.STATistic.TREE Tree display of nesting function run-time analysis 21 LA.STATistic.Use Use records 21 LA.Timing Waveform of trace buffer 21 LA.TRACK Set tracking record 21 LA.View Display single record 21 LA.ZERO Align timestamps of trace and timing analyzers 22

List ...... 23 List Display modes for programs 23 List.auto Display source listing 24 List.Asm Display disassembler 32

©1989-2018 Lauterbach GmbH TRACE32 Directory 8 5 List.EXPORT Export a listing to an XML file 33 List.EXPORT.Asm Export disassembler listing 33 List.EXPORT.auto Export source and disassembler listing 34 List.EXPORT.Mix Export source and disassembler listing 34 List.Hll Display source 36 List.Java Display Java byte code 37 List.Mix Disassembler and source 38

LOGGER ...... 39 LOGGER tbd. 39 Trace Method LOGGER 39

LOGGER Trace Commands ...... 41 LOGGER.ADDRESS Software trace address 41 LOGGER.Arm Arm the trace 41 LOGGER.AutoArm Arm automatically 41 LOGGER.AutoFocus Calibrate AUTOFOCUS preprocessor 41 LOGGER.AutoInit Automatic initialization 41 LOGGER.BookMark Set a bookmark in trace listing 41 LOGGER.Chart Display trace contents graphically 42 LOGGER.Chart.DistriB Distribution display 42 LOGGER.Chart.Func Function activity chart 42 LOGGER.Chart.GROUP Group activity chart 42 LOGGER.Chart.Line Graphical HLL lines analysis 42 LOGGER.Chart.sYmbol Symbol analysis 42 LOGGER.Chart.TASK Task activity chart 42 LOGGER.Chart.TASKFunc Task related function run-time analysis (legacy) 43 LOGGER.Chart.TASKSRV Service routine run-time analysis 43 LOGGER.Chart.TASKState Task state analysis 43 LOGGER.Chart.VarState Variable activity chart 43 LOGGER.ComPare Compare trace contents 43 LOGGER.DISable Disable the trace 43 LOGGER.DRAW Visualization of trace data 43 LOGGER.EXPORT Export trace data for processing in other applications 44 LOGGER.FILE Load a file into the file trace buffer 44 LOGGER.Find Find specified entry in trace 44 LOGGER.FindAll Find all specified entries in trace 44 LOGGER.FindChange Search for changes in trace flow 44 LOGGER.FLOWPROCESS Process flowtrace 44 LOGGER.FLOWSTART Restart flowtrace processing 44 LOGGER.GOTO Move cursor to specified trace record 45 LOGGER.Init Initialize trace 45 LOGGER.List List trace contents 45 LOGGER.ListNesting Analyze function nesting 45 LOGGER.ListVar List variable recorded to trace 45

©1989-2018 Lauterbach GmbH TRACE32 Directory 8 6 LOGGER.LOAD Load trace file for offline processing 45 LOGGER.Mode Set the trace operation mode 45 LOGGER.OFF Switch off 45 LOGGER.PROfileChart Profile charts 46 LOGGER.PROfileChart.DIStance Time interval for a single event 46 LOGGER.PROfileChart.DURation Time between two events 46 LOGGER.PROfileChart.GROUP Group profile chart 46 LOGGER.PROfileChart.Rate Event frequency 46 LOGGER.PROTOcol Protocol analysis 46 LOGGER.PROTOcol.Chart Graphic display for user-defined protocol 46 LOGGER.PROTOcol.Draw Graphic display for user-defined protocol 47 LOGGER.PROTOcol.EXPORT Export trace buffer for user-defined protocol 47 LOGGER.PROTOcol.Find Find in trace buffer for user-defined protocol 47 LOGGER.PROTOcol.List Display trace buffer for user-defined protocol 47 LOGGER.PROTOcol.STATistic Display statistics for user-defined protocol 47 LOGGER.REF Set reference point for time measurement 47 LOGGER.RESet Reset command 47 LOGGER.SAVE Save trace for postprocessing in TRACE32 48 LOGGER.SelfArm Automatic restart of trace recording 48 LOGGER.SIZE Define buffer size 48 LOGGER.SnapShot Restart trace capturing once 48 LOGGER.state Display trace configuration window 48 LOGGER.STATistic Statistic analysis 48 LOGGER.STATistic.BondOut Bondout mode 48 LOGGER.STATistic.DIStance Time interval for a single event 49 LOGGER.STATistic.DistriB Distribution analysis 49 LOGGER.STATistic.DURation Time between two events 49 LOGGER.STATistic.Func Nesting function runtime analysis 49 LOGGER.STATistic.GROUP Group run-time analysis 49 LOGGER.STATistic.Ignore Ignore false records in statistic 49 LOGGER.STATistic.InterruptIsFunction Statistics interrupt processing 49 LOGGER.STATistic.Line HLL-line analysis 50 LOGGER.STATistic.LINKage Per caller statistic of function 50 LOGGER.STATistic.Measure Analyze the performance of a single signal 50 LOGGER.STATistic.PreFetch Prefetch detection 50 LOGGER.STATistic.Sort Specify sorting criterion for statistic commands 50 LOGGER.STATistic.sYmbol Flat run-time analysis 50 LOGGER.STATistic.TASK Task activity statistic 50 LOGGER.STATistic.TASKFunc Task specific function run-time analysis 51 LOGGER.STATistic.TASKKernel Task analysis with kernel markers (flat) 51 LOGGER.STATistic.TASKSRV Analysis of time in OS service routines 51 LOGGER.STATistic.TASKState Performance analysis 51 LOGGER.STATistic.TASKTREE Tree display of task specific functions 51

©1989-2018 Lauterbach GmbH TRACE32 Directory 8 7 LOGGER.STATistic.TREE Tree display of nesting function run-time analysis 51 LOGGER.STATistic.Use Use records 51 LOGGER.TimeStamp Configure timestamp usage of LOGGER trace 52 LOGGER.Timing Waveform of trace buffer 52 LOGGER.TRACK Set tracking record 52 LOGGER.View Display single record 52 LOGGER.ZERO Align timestamps of trace and timing analyzers 52

LUA ...... 53 LUA Support for the Lua script language 53 LUA.List List the current Lua scripts 53 LUA.LOAD Load a Lua script to debugger 54 LUA.RESet Reset the Lua context 54 LUA.RUN Execute a Lua script 55 LUA.SET Modify the Lua input buffer 56 LUA.ShowInput Show current content of the input buffer 56 LUA.ShowOutput Show current content of the output buffer 57 LUA.UNLOAD Remove a Lua script from the debugger 57

General Commands Reference Guide M

General Commands Reference Guide M ...... (general_ref_m.pdf) 1

History ...... 7

MACHINE ...... 8 MACHINE.select Display context of specified virtual machine 8

MAP ...... 9 MAP Mapping memory attributes for debugger, ICE, and FIRE 9 Mapping the EPROM Simulator for BDM/ROM 10 Mapping-System of TRACE32-ICE 12 MAP.Ack Generate acknowledge signals 14 MAP.ADelay tbd. 14 MAP.AFlag tbd. 15 MAP.BANK Set bank range 15 MAP.BE Define big endian area 15 MAP.BOnchip Use on-chip breakpoints 16 MAP.Break Map break memory 16 MAP.BURST Burst area mapping 17 MAP.BUS Read/write data in specified access width 18 MAP.BUS8 Bus width mapping 20 MAP.BUS16 Bus width mapping 21 MAP.BUS24 Bus width mapping 21 MAP.BUS32 Bus width mapping 22 MAP.BUSEXT External bus mapping 22

©1989-2018 Lauterbach GmbH TRACE32 Directory 8 8 MAP.BYTE Set EPROM width 22 MAP.Cache Cache area mapping 23 MAP.CFlag tbd. 23 MAP.COMSTART tbd. 24 MAP.CONST Mapped address range contains constants 24 MAP.CS tbd. 25 MAP.Data Map data memory 25 MAP.DEFault Standard memory mapping 26 MAP.DenyAccess Deny memory access by TRACE32 26 MAP.DenyBurst Deny burst access to memory by TRACE32 27 MAP.DMA DMA area mapping 28 MAP.DMUX tbd. 28 MAP.Extern External memory 28 MAP.Flag Map flag memory 28 MAP.FRAG Form fragment 29 MAP.GAP Define gap 29 MAP.Intern Internal memory 30 MAP.LE Define little endian area 30 MAP.List List allocation 31 MAP.MFlag tbd. 33 MAP.MIrror Mirroring 33 MAP.Mode Mode 34 MAP.MONITOR tbd. 35 MAP.NEW Initialization 35 MAP.NoAck Disable acknowledge signals 35 MAP.NoAFlag tbd. 36 MAP.NOBANK Release bank area 36 MAP.NoBE Switch off big endian 36 MAP.NoBOnchip Use on-chip breakpoints 37 MAP.NoBreak Release break memory 37 MAP.NoBURST Burst area mapping 38 MAP.NOBUS16 Bus width mapping 38 MAP.NOBUS32 Bus width mapping 38 MAP.NOBUS8 Bus width mapping 39 MAP.NoCache Cache area mapping 39 MAP.NoCONST Undo the MAP.CONST settings 39 MAP.NOCS tbd. 40 MAP.NoData Release data memory 40 MAP.NoDenyAccess Switch off deny access for TRACE32 40 MAP.NoDenyBurst Undo settings of MAP.DENYBURST command 40 MAP.NODMA DMA area mapping 41 MAP.NoDMUX tbd. 41 MAP.NoFlag Release flag memory 41

©1989-2018 Lauterbach GmbH TRACE32 Directory 8 9 MAP.NOFRAG Switch off fragmentation 42 MAP.NOGAP Switch off gap 42 MAP.NoLE Switch off little endian 42 MAP.NoMFlag tbd. 43 MAP.NoOPFetch Switch off opfetch area mapping 43 MAP.NOPAGE Define pages 43 MAP.NoPOOL Undo setting of MAP.POOL command 44 MAP.NoProtect Erase write protection 44 MAP.NoRam Release RAM 44 MAP.NoReadFlag Undo setting of MAP.READFLAG command 45 MAP.NOROM Unmap ESI 45 MAP.NoShadow Undo setting of MAP.SHADOW command 45 MAP.NoSOnchip Undo setting of MAP.SONCHIP command 46 MAP.NOSWAP Keep byte order 46 MAP.NoUpdateOnce Undo setting of MAP.UPDATEONCE command 46 MAP.NoVMREAD Undo the setting of the MAP.VMREAD command 47 MAP.NoVOLATILE Undo the setting of the MAP.VOLATILE command 47 MAP.NOWB Premapper settings 47 MAP.NoXBus Maps XBUS to XPER device 48 MAP.OPFetch Opfetch area mapping 48 MAP.PAGE Define pages 48 MAP.POOL tbd. 49 MAP.PRE Premapper 49 MAP.Protect Write protection 50 MAP.Ram Map RAM 50 MAP.ReadFlag tbd. 51 MAP.RELOCate Relocate ROM area 51 MAP.RESet Reset 52 MAP.ROM Map ESI 52 MAP.Shadow tbd. 53 MAP.SOnchip tbd. 53 MAP.SPlit Splitting 53 MAP.state State 54 MAP.SWAP Change byte order 54 MAP.UpdateOnce Read memory only once each time CPU stops 55 MAP.VERIFY Internal usage only 56 MAP.VMREAD Redirect memory reads/writes to TRACE32 virtual memory 56 MAP.VOLATILE Mapped address range is volatile 56 MAP.Wait Wait cycles 56 MAP.WORD Set EPROM width 57 MAP.WriteFlag tbd. 58 MAP.XBus Maps the XBUS to emulation memory 58

MCDS ...... 59

©1989-2018 Lauterbach GmbH TRACE32 Directory 9 0 MCDS Multicore debug solution 59 Overview MCDS 59 MCDS.CLEAR Clear programming and initialize MCDS registers 60 MCDS.CLOCK Configure MCDS clock system 60 MCDS.CLOCK DEPRECATED Enable deprecated MCDS clock programming 61 MCDS.CLOCK EXTern Set the external clock frequency 62 MCDS.CLOCK Frequency Specify MCDS-related frequencies by commands 63 MCDS.CLOCK Frequency.McdsClock Specify the MCDS clock 63 MCDS.CLOCK Frequency.ReferenceClock Specify the reference clock 63 MCDS.CLOCK MCDSDIV Set divider for generating the MCDS clock 64 MCDS.CLOCK REFDIV Set divider for generating the reference clock 64 MCDS.CLOCK REFerence Select the reference clock source 65 MCDS.CLOCK SYStem Set the system clock frequency 65 MCDS.CLOCK TIMER Setup timer for periodic trigger event 66 MCDS.CLOCK TimeStamp Force decoding of timestamp messages 67 MCDS.DIAG Enable diagnostic output 68 MCDS.INFO Information on MCDS and usage 68 MCDS.Init Initialize MCDS registers 69 MCDS.OFF Disable MCDS programming 69 MCDS.ON Enable MCDS programming 69 MCDS.Option Control MCDS feature behavior 70 MCDS.Option AddressBreak Use MCDS for address breakpoints 70 MCDS.Option CoreBreak Break when BREANK_OUT becomes active 71 MCDS.Option DataAssign Data assignment in trace listing 71 MCDS.Option DataBreak Use MCDS for data breakpoints 72 MCDS.Option eXception Exception identification in trace decoder 72 MCDS.Option ProgramBreak Use MCDS for program breakpoints 73 MCDS.Option QuickOFF Disable trace recording by hardware 73 MCDS.Option TTRESet Enable generation of reset information in trace 74 MCDS.PortSIZE Set number of used Aurora lanes 74 MCDS.PortSPEED Set Aurora lane speed 75 MCDS.Program Program MCDS triggers 75 MCDS.Register Open window with MCDS registers 76 MCDS.ReProgram Load and execute an OCTL trigger program 76 MCDS.RESet Reset the MCDS unit in the debug tool 77 MCDS.RM MCDS resource management commands 78 MCDS.RM ReSTore Restore MCDS registers 78 MCDS.RM WriteTarget Flush MCDS register cache 78 MCDS.SessionKEY Provide MCDS session key 79 MCDS.Set Program MCDS on hardware level 79 MCDS.SOURCE Set MCDS trace sources 81 MCDS.SOURCE.ALL Enable all MCDS trace sources 81 MCDS.SOURCE.DEFault Set default MCDS trace sources 81

©1989-2018 Lauterbach GmbH TRACE32 Directory 9 1 MCDS.SOURCE.NONE Disable all MCDS trace sources 82 MCDS.SOURCE.Set Set individual MCDS trace sources 82 MCDS.state Display MCDS configuration window 88 MCDS.TimeStamp Enable MCDS trace sources 89 MCDS.TraceBuffer Configure MCDS trace buffer 90 MCDS.TraceBuffer ARRAY Select MCDS trace buffer array 90 MCDS.TraceBuffer DETECT Auto-detect MCDS trace buffer configuration 91 MCDS.TraceBuffer LowerGAP Set MCDS trace buffer lower gap 91 MCDS.TraceBuffer NoStealing Prevent conflicts with third-party tools 92 MCDS.TraceBuffer SIZE Set MCDS trace buffer size 93 MCDS.TraceBuffer UpperGAP Set MCDS trace buffer upper gap 93 MCDSBase Non-optimized trace MCDS trace processing 94 MCDSDCA MCDS trace processing with data cycle assignment 94 MCDSDDTU MCDS trace processing with DDTU reordering 95

MergedAnalyzer ...... 96 Merge Program-Flow-only ETM and HTM Data Access Trace 97 Merge Program-Flow-only ETM and ITM DataPC Trace 98

MIPS ...... 99 MIPS Number of instructions per second 99 Overview MIPS 99 MIPS.PROfileChart Profile charts for MIPS 103 MIPS.PROfileChart.GROUP MIPS profile chart for groups 103 MIPS.PROfileChart.Line MIPS per high-level language line graphically 104 MIPS.PROfileChart.RWINST MIPS per cycle type graphically 104 MIPS.PROfileChart.sYmbol MIPS for all program symbols graphically 105 MIPS.PROfileChart.TASK MIPS per task graphically 106 MIPS.PROfileSTATistic Profile statistics for MIPS 107 MIPS.PROfileSTATistic.GROUP MIPS per GROUP as profile chart 107 MIPS.PROfileSTATistic.Line MIPS per high-level language line as table 107 MIPS.PROfileSTATistic.RWINST MIPS per cycle type as table 107 MIPS.PROfileSTATistic.sYmbol MIPS for all program symbols as table 108 MIPS.PROfileSTATistic.TASK MIPS per task as table 108 MIPS.STATistic Statistical analysis for MIPS 109 MIPS.STATistic.GROUP MIPS statistic for groups 109 MIPS.STATistic.RWINST MIPS per cycle type numerically 109 MIPS.STATistic.sYmbol MIPS for all program symbols numerically 110 MIPS.STATistic.TASK MIPS per task numerically 110

MMU ...... 111 MMU Memory management unit 111 Overview MMU 111 MMU.DUMP Dump MMU tables 112 MMU.FORMAT Define MMU table structure 115

©1989-2018 Lauterbach GmbH TRACE32 Directory 9 2 MMU.INFO View all translation information related to an address 118 MMU.ITLB tbd. 118 MMU.ITLBSCAN tbd. 119 MMU.PageTable Handle MMU table for the current process 119 MMU.PTE Display MMU PTE entries 120 MMU.PTESCAN Load MMU PTE table from probe 120 MMU.SCAN Scan MMU tables (static snapshot) 121 MMU.Set Set MMU registers or tables 123 MMU.TaskPageTable Handles MMU table for a specific process 124 MMU.TDUMP Dump task page table 124 MMU.TLB Display MMU TLB entries 125 MMU.TLBINIT tbd. 125 MMU.TLBRESET tbd. 125 MMU.TLBSCAN Load MMU TLB table from probe 126 MMU.TLBSET Set MMU TLB entry 126 MMU.TSCAN Scan task page table 126 MMU.UTLB tbd. 127 MMU.UTLBSCAN tbd. 127 MMU.view View MMU registers 127

MMX ...... 128 MMX MMX registers (MultiMedia eXtension) 128 MMX.Init Initialize MMX registers 128 MMX.OFF Inhibit MMX accesses by the debugger 128 MMX.ON Permit MMX accesses by the debugger 129 MMX.Set Modify MMX registers 129 MMX.view Open MMX register window 129

Mode ...... 130 Mode Set up the debug mode 130

Appendix - Options of MMU.FORMAT ...... 131

General Commands Reference Guide N

General Commands Reference Guide N ...... (general_ref_n.pdf) 1

NAME ...... 2 NAME Logical names for physical connections 2 NAME.Combi Create virtual signal for trace events 2 NAME.Delete Delete names 4 NAME.Group Groups signals 5 NAME.list Display name definitions 6 NAME.RESet Clear names 6 NAME.SELect Define names 7 NAME.Set Define names 8

General Commands Reference Guide O

General Commands Reference Guide O ...... (general_ref_o.pdf) 1

OCP ...... 4 OCP OpenCoreProtocol WatchPoint 4

ON ...... 5 ON Event-controlled PRACTICE script execution 5

Onchip ...... 10 Onchip tbd. 10 Trace Method Onchip 10

Onchip Trace Commands ...... 11 Onchip.ACCESS Define access path to source code for trace decoding 11 Onchip.Arm Arm the trace 11 Onchip.AutoArm Arm automatically 11 Onchip.AutoFocus Calibrate AUTOFOCUS preprocessor 11 Onchip.AutoInit Automatic initialization 11 Onchip.AutoTEST Continuous measurement 11 Onchip.BookMark Set a bookmark in trace listing 12 Onchip.Chart Display trace contents graphically 12 Onchip.Chart.DistriB Distribution display 12 Onchip.Chart.Func Function activity chart 12 Onchip.Chart.GROUP Group activity chart 12 Onchip.Chart.Line Graphical HLL lines analysis 12 Onchip.Chart.sYmbol Symbol analysis 12 Onchip.Chart.TASK Task activity chart 13 Onchip.Chart.TASKFunc Task related function run-time analysis (legacy) 13 Onchip.Chart.TASKSRV Service routine run-time analysis 13 Onchip.Chart.TASKState Task state analysis 13 Onchip.Chart.VarState Variable activity chart 13 Onchip.CLOCK Clock to calculate time out of cycle count information 13 Onchip.ComPare Compare trace contents 13 Onchip.DISable Disable the trace 14 Onchip.DRAW Visualization of trace data 14 Onchip.EXPORT Export trace data for processing in other applications 14 Onchip.FILE Load a file into the file trace buffer 14 Onchip.Find Find specified entry in trace 14 Onchip.FindAll Find all specified entries in trace 14 Onchip.FindChange Search for changes in trace flow 14 Onchip.FLOWPROCESS Process flowtrace 14 Onchip.FLOWSTART Restart flowtrace processing 15

©1989-2018 Lauterbach GmbH TRACE32 Directory 9 4 Onchip.GOTO Move cursor to specified trace record 15 Onchip.Init Initialize trace 15 Onchip.JOINFILE Concatenate several trace recordings 15 Onchip.List List trace contents 15 Onchip.ListNesting Analyze function nesting 15 Onchip.ListVar List variable recorded to trace 15 Onchip.LOAD Load trace file for offline processing 15 Onchip.MERGEFILE Combine two trace files into one 16 Onchip.Mode Set the trace operation mode 16 Onchip.OFF Switch off 16 Onchip.PROfileChart Profile charts 16 Onchip.PROfileChart.DIStance Time interval for a single event 16 Onchip.PROfileChart.DURation Time between two events 16 Onchip.PROfileChart.GROUP Group profile chart 16 Onchip.PROfileChart.Rate Event frequency 17 Onchip.PROfileSTATistic Statistical analysis in a table versus time 17 Onchip.PROTOcol Protocol analysis 17 Onchip.PROTOcol.Chart Graphic display for user-defined protocol 17 Onchip.PROTOcol.Draw Graphic display for user-defined protocol 17 Onchip.PROTOcol.EXPORT Export trace buffer for user-defined protocol 17 Onchip.PROTOcol.Find Find in trace buffer for user-defined protocol 17 Onchip.PROTOcol.List Display trace buffer for user-defined protocol 18 Onchip.PROTOcol.STATistic Display statistics for user-defined protocol 18 Onchip.REF Set reference point for time measurement 18 Onchip.RESet Reset command 18 Onchip.SAVE Save trace for postprocessing in TRACE32 18 Onchip.SelfArm Automatic restart of trace recording 18 Onchip.SIZE Define buffer size 18 Onchip.SnapShot Restart trace capturing once 19 Onchip.state Display trace configuration window 19 Onchip.STATistic Statistic analysis 19 Onchip.STATistic.BondOut Bondout mode 19 Onchip.STATistic.DIStance Time interval for a single event 19 Onchip.STATistic.DistriB Distribution analysis 19 Onchip.STATistic.DURation Time between two events 19 Onchip.STATistic.Func Nesting function runtime analysis 20 Onchip.STATistic.GROUP Group run-time analysis 20 Onchip.STATistic.Ignore Ignore false records in statistic 20 Onchip.STATistic.InterruptIsFunction Statistics interrupt processing 20 Onchip.STATistic.Line HLL-line analysis 20 Onchip.STATistic.LINKage Per caller statistic of function 20 Onchip.STATistic.Measure Analyze the performance of a single signal 20 Onchip.STATistic.PreFetch Prefetch detection 21

©1989-2018 Lauterbach GmbH TRACE32 Directory 9 5 Onchip.STATistic.Sort Specify sorting criterion for statistic commands 21 Onchip.STATistic.sYmbol Flat run-time analysis 21 Onchip.STATistic.TASK Task activity statistic 21 Onchip.STATistic.TASKFunc Task specific function run-time analysis 21 Onchip.STATistic.TASKKernel Task analysis with kernel markers (flat) 21 Onchip.STATistic.TASKSRV Analysis of time in OS service routines 21 Onchip.STATistic.TASKState Performance analysis 22 Onchip.STATistic.TASKTREE Tree display of task specific functions 22 Onchip.STATistic.TREE Tree display of nesting function run-time analysis 22 Onchip.STATistic.Use Use records 22 Onchip.TDelay Trigger delay 22 Onchip.Timing Waveform of trace buffer 22 Onchip.TraceCONNECT Select on-chip peripheral sink 22 Onchip.TRACK Set tracking record 23 Onchip.TRIGGER Trigger the trace 23 Onchip.View Display single record 23 Onchip.ZERO Align timestamps of trace and timing analyzers 23

General Commands Reference Guide P

General Commands Reference Guide P ...... (general_ref_p.pdf) 1

History ...... 7

PCI ...... 8 PCI Legacy PCI configuration 8 PCI.Dump Display PCI device data 8 PCI.Read Read a PCI register 9 PCI.Scan List PCI devices 10 PCI.Write Write a PCI register 11

PCP ...... 12

PCPOnchip ...... 12

PER ...... 13 PER Peripheral files 13 Overview PER 13 PER.Program Interactive programming 14 PER.ReProgram Load default program 14 PER.Set Modify memory 15 PER.Set.Field Modify a bit field in memory 15 PER.Set.Index Modify indirect (indexed) register 17 PER.Set.Out Write data stream to memory 18 PER.Set.SaveIndex Modify indirect (indexed) register 18 PER.Set.SHADOW Modify data based on shadow RAM 19 PER.Set.simple Modify registers/peripherals 20

©1989-2018 Lauterbach GmbH TRACE32 Directory 9 6 PER.STOre Generate PRACTICE script from PER settings 20 PER.view Display peripherals 23 PER.viewDECRYPT View decrypted PER files in a PER window 25 Programming Commands 25

PERF ...... 26 PERF Sample-based profiling 26 Overview PERF 26 PERF.ADDRESS Restrict evaluation to specified address area 31 PERF.ANYACCESS Access selectivity 31 PERF.Arm Activate the performance analyzer manually 32 PERF.AutoArm Couple performance analyzer to program execution 33 PERF.AutoInit Automatic initialization 33 PERF.ContextID Enable sampling the context ID register 33 PERF.DISable Disable the performance analyzer 34 PERF.Display Select the display format 34 PERF.Entry Function runtime analysis 34 PERF.EntrySize Function header size 35 PERF.Filter Suppress display of items with specified characteristic 36 PERF.Gate Gate time of the measurements 36 PERF.Init Reset current measurement 37 PERF.List Default profiling 37 PERF.ListDistriB Memory contents profiling 43 PERF.ListFunc Function profiling 44 PERF.ListFuncMod HLL function profiling (restricted) 46 PERF.ListLABEL Label-based profiling 48 PERF.ListLine Profiling by HLL lines 50 PERF.ListModule Profiling by modules 51 PERF.ListProgram Profiling based on performance analyzer program 52 PERF.ListRange Profiling by ranges 52 PERF.ListS10 Profiling in n-byte segments 53 PERF.ListTASK Profiling by tasks/threads 54 PERF.ListTREE Profiling by module/function tree 56 PERF.ListVarState Variable state profiling 57 PERF.LOAD Load previously stored PERF results 58 PERF.METHOD Specify acquisition method 58 PERF.MMUSPACES Include address space identifier in the sampling 70 PERF.Mode Specify sampling object 71 PERF.OFF Stop the performance analyzer manually 72 PERF.PreFetch Prefetch handling 72 PERF.PROfile Graphic profiling display 73 PERF.Program Write a performance analyzer program 77 PERF.ReProgram Load an existing performance analyzer program 78 PERF.RESet Reset analyzer 78

©1989-2018 Lauterbach GmbH TRACE32 Directory 9 7 PERF.RunTime Retain time for program run 79 PERF.SAVE Save the PERF results for postprocessing 79 PERF.SCAN Scanning mode 79 PERF.SnoopAddress Address for memory sample 80 PERF.SnoopSize Size for memory sample 80 PERF.Sort Specify sorting of evaluation results 81 PERF.state Display state 82 PERF.ToProgram Automatic generation of performance analyzer program 83 PERF.View Detailed view 85

PMI ...... 87 PMI Power management interface 87

POD ...... 88 POD.ADC Probe configuration 88 POD.Level Input state 91 POD.RESet Input level reset 91 POD.state Input state 92

PORT ...... 93 Port.AutoFocus Calibrate AUTOFOCUS preprocessor 93 Port.AutoTEST Continuous measurement 93 Port.BookMark Set a bookmark in trace listing 93 Port.Chart.Func Function activity chart 93 Port.Chart.GROUP Group activity chart 93 Port.Chart.Line Graphical HLL lines analysis 94 Port.Chart.sYmbol Symbol analysis 94 Port.Chart.TASK Task activity chart 94 Port.Chart.TASKFunc Task related function run-time analysis (legacy) 94 Port.Chart.TASKSRV Service routine run-time analysis 94 Port.Chart.TASKState Task state analysis 94 Port.Chart.VarState Variable activity chart 94 Port.DisConfig.view Trace disassemble setting 95 Port.DRAW Visualization of trace data 95 Port.Enable Operation mode 95 Port.Enable Operation mode 95 Port.FindAll Find all specified entries in trace 95 Port.ListNesting Analyze function nesting 95 Port.ListVar List variable recorded to trace 95 Port.MUX Select channels 95 Port.PROTOcol Protocol analysis 96 Port.PROTOcol.Chart Graphic display for user-defined protocol 96 Port.PROTOcol.Draw Graphic display for user-defined protocol 96 Port.PROTOcol.EXPORT Export trace buffer for user-defined protocol 96 Port.PROTOcol.Find Find in trace buffer for user-defined protocol 96

©1989-2018 Lauterbach GmbH TRACE32 Directory 9 8 Port.PROTOcol.List Display trace buffer for user-defined protocol 96 Port.PROTOcol.STATistic Display statistics for user-defined protocol 96 Port.Select Select trigger/counter line 97 Port.SET Select line for recording 97 Port.SLAVE Select slave mode 97 Port.STATistic Statistic analysis 97 Port.STATistic.BondOut Bondout mode 97 Port.STATistic.DIStance Time interval for a single event 97 Port.STATistic.DistriB Distribution analysis 97 Port.STATistic.DURation Time between two events 98 Port.STATistic.Func Nesting function runtime analysis 98 Port.STATistic.GROUP Group run-time analysis 98 Port.STATistic.Ignore Ignore false records in statistic 98 Port.STATistic.InterruptIsFunction Statistics interrupt processing 98 Port.STATistic.Line HLL-line analysis 98 Port.STATistic.LINKage Per caller statistic of function 98 Port.STATistic.PreFetch Prefetch detection 99 Port.STATistic.Sort Specify sorting criterion for statistic commands 99 Port.STATistic.sYmbol Flat run-time analysis 99 Port.STATistic.TASK Task activity statistic 99 Port.STATistic.TASKFunc Task specific function run-time analysis 99 Port.STATistic.TASKKernel Task analysis with kernel markers (flat) 99 Port.STATistic.TASKSRV Analysis of time in OS service routines 99 Port.STATistic.TASKState Performance analysis 100 Port.STATistic.TASKTREE Tree display of task specific functions 100 Port.STATistic.TREE Tree display of nesting function run-time analysis 100 Port.STATistic.Use Use records 100 Port.TMode Select trigger mode 100 Port.TRACK Set tracking record 100 Port.ZERO Align timestamps of trace and timing analyzers 100

Probe ...... 101 Probe tbd. 101 Trace Method Probe 101

Probe Trace Commands ...... 103 Probe.Arm Arm the trace 103 Probe.AutoFocus Calibrate AUTOFOCUS preprocessor 103 Probe.Chart Display trace contents graphically 103 Probe.Chart.DistriB Distribution display 103 Probe.Chart.Func Function activity chart 103 Probe.Chart.GROUP Group activity chart 103 Probe.Chart.Line Graphical HLL lines analysis 104 Probe.Chart.sYmbol Symbol analysis 104 Probe.Chart.TASK Task activity chart 104

©1989-2018 Lauterbach GmbH TRACE32 Directory 9 9 Probe.Chart.TASKFunc Task related function run-time analysis (legacy) 104 Probe.Chart.TASKSRV Service routine run-time analysis 104 Probe.Chart.TASKState Task state analysis 104 Probe.Chart.VarState Variable activity chart 104 Probe.ComPare Compare trace contents 105 Probe.DISable Disable the trace 105 Probe.DRAW Visualization of trace data 105 Probe.EXPORT Export trace data for processing in other applications 105 Probe.FindAll Find all specified entries in trace 105 Probe.FindChange Search for changes in trace flow 105 Probe.FLOWPROCESS Process flowtrace 105 Probe.FLOWSTART Restart flowtrace processing 106 Probe.Get Display input level 106 Probe.GOTO Move cursor to specified trace record 106 Probe.Init Initialize trace 106 Probe.LOAD Load trace file for offline processing 106 Probe.PROfileChart.DIStance Time interval for a single event 106 Probe.PROfileChart.DURation Time between two events 106 Probe.PROfileChart.GROUP Group profile chart 107 Probe.PROfileChart.Rate Event frequency 107 Probe.PROTOcol.Chart Graphic display for user-defined protocol 107 Probe.PROTOcol.Draw Graphic display for user-defined protocol 107 Probe.PROTOcol.EXPORT Export trace buffer for user-defined protocol 107 Probe.PROTOcol.Find Find in trace buffer for user-defined protocol 107 Probe.PROTOcol.List Display trace buffer for user-defined protocol 107 Probe.PROTOcol.STATistic Display statistics for user-defined protocol 108 Probe.SAVE Save trace for postprocessing in TRACE32 108 Probe.state Display trace configuration window 108 Probe.STATistic Statistic analysis 108 Probe.STATistic.DIStance Time interval for a single event 108 Probe.STATistic.DistriB Distribution analysis 108 Probe.STATistic.DURation Time between two events 108 Probe.STATistic.Func Nesting function runtime analysis 109 Probe.STATistic.GROUP Group run-time analysis 109 Probe.STATistic.Ignore Ignore false records in statistic 109 Probe.STATistic.InterruptIsFunction Statistics interrupt processing 109 Probe.STATistic.Line HLL-line analysis 109 Probe.STATistic.LINKage Per caller statistic of function 109 Probe.STATistic.Measure Analyze the performance of a single signal 109 Probe.STATistic.PreFetch Prefetch detection 110 Probe.STATistic.Sort Specify sorting criterion for statistic commands 110 Probe.STATistic.sYmbol Flat run-time analysis 110 Probe.STATistic.TASK Task activity statistic 110

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 0 0 Probe.STATistic.TASKFunc Task specific function run-time analysis 110 Probe.STATistic.TASKKernel Task analysis with kernel markers (flat) 110 Probe.STATistic.TASKSRV Analysis of time in OS service routines 110 Probe.STATistic.TASKState Performance analysis 111 Probe.STATistic.TASKTREE Tree display of task specific functions 111 Probe.STATistic.TREE Tree display of nesting function run-time analysis 111 Probe.STATistic.Use Use records 111 Probe.TRIGGER Trigger the trace 111 Probe.XTrack Cross system tracking 111

PULSE ...... 111 Function 112 PULSE.PERiod Cycle duration 114 PULSE.Pulse Programming 115 PULSE.RESet Reset command 116 PULSE.Single Release single pulse 116 PULSE.state State display 117 PULSE.Width Pulse width 118

PULSE2 ...... 118 Function 119 PULSE2.Pulse Programming 119 PULSE2.RESet Reset command 121 PULSE2.Single Release single pulse 121 PULSE2.state Status display 121 PULSE2.Width Pulse width 122

General Commands Reference Guide Q

General Commands Reference Guide Q ...... (general_ref_q.pdf) 1

General Commands Reference Guide R

General Commands Reference Guide R ...... (general_ref_r.pdf) 1

History ...... 4

REFresh ...... 5 Function 5 REFresh.Address Refresh address range 6 REFresh.CYcle Access mode 6 REFresh.Inc Address distance 6 REFresh.OFF Switch off 7 REFresh.RESet Reset command 7 REFresh.StandBy Standby mode 8 REFresh.state Status display 8 REFresh.Time Refresh rate 9

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 0 1 Register ...... 10 Register Processor registers 10 Register.Init Initialize the processor registers 10 Register.LOG Log registers 14 Register.REFRESH Refresh register window 15 Register.RELOAD Reload the compiler register settings 15 Register.Set Modify register contents 16 Register.StackTop Define stack top address 17 Register.view Display registers 18

RESet ...... 21 RESet Reset all commands 21

RTP ...... 22 RTP.CLEAR Clear tracebuffer 22 RTP.DirectDataMode Simple trace mode 22 RTP.DirectDataMode.Mode Direct data mode read/write 22 RTP.HaltOnOverflow Halt system on RTP FIFO overflow 22 RTP.Mode Select the trace mode 22 RTP.OFF Disables the RTP module 22 RTP.ON Activates the RTP module 22 RTP.PortClock Configure RTPCLK 23 RTP.PortSize Size of RTP data port 23 RTP.Register Display the RTP register 23 RTP.RESet Resets RTP settings 23 RTP.state Display RTP setup 23 RTP.TraceMode Complex trace mode 23 RTP.TraceMode.RAM.SECTion Configures a trace region 23 RTP.TraceMode.TraceExclude Invert all trace regions 23

RTS ...... 24 RTS Real-time profiling (RTS) 24 RTS.Init Initialize RTS 27 RTS.OFF Deactivate real-time profiling 27 RTS.ON Activate real-time profiling 28 RTS.PROfile Display performance characteristics charts 29 RTS.RESet Restore default settings and initialize RTS 30 RTS.state Open status and control window 31 RTS.StopOnBadaddress Stop RTS on VM errors 32 RTS.StopOnError Stop RTS on flow errors 32 RTS.StopOnFifofull Stop RTS on FIFOFULL 32 RTS.StopOnNoaccesstocode Stop RTS on no access to code 33 RTS.TrackData Enable RTS data tracking 33

RunTime ...... 34 RunTime Runtime measurement 34

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 0 2 Overview RunTime 34 RunTime.Init Clear timers 37 RunTime.refA Set reference 37 RunTime.refB Set reference 37 RunTime.RESet Reset values to zero 38 RunTime.state Display results 38

General Commands Reference Guide S

General Commands Reference Guide S ...... (general_ref_s.pdf) 1

History ...... 13

SELFTEST ...... 14 SELFTEST Execute selftest operation 14

SETUP ...... 14 SETUP Setup commands (part 2 of 2) 14 SETUP.ALIST Default analyzer display 15 SETUP.BREAKDEF Default breakpoint types 15 SETUP.BreakTransfer Breakpoint synchronization 16 SETUP.COLORCORE Enable coloring for core-specific info in SMP systems 16 SETUP.DIS Disassembler configuration 17 SETUP.DUMP Defaults for hex-dumps 18 SETUP.EMUPATH Emulation softkeys configuration 19 SETUP.FLIST Default flag list display 19 SETUP.IMASKASM Mask interrupts during assembler step 20 SETUP.IMASKHLL Mask interrupts during HLL step 20 SETUP.LISTCLICK Double-click source line symbol to run this action 21 SETUP.PreFetch Define prefetch 21 SETUP.REFERR DRAM refresh monitoring 22 SETUP.SIMULINK Deprecated command 22 SETUP.StepAllCores Force single stepping on all cores 23 SETUP.StepAutoAsm HLL steps stops at assembler code 23 SETUP.StepBeforeGo Single step before go 24 SETUP.StepBreak Single step to skip breakpoint 24 SETUP.StepByStep Single step HLL lines 24 SETUP.StepNoBreak Stepping HLL lines with disabled breakpoints 25 SETUP.StepTrace Show stepping trail in list window 25 SETUP.StepWithinTask Task selective stepping 25 SETUP.sYmbol Length of symbols 26 SETUP.TIMEOUT Define emulation monitor time-out 26 SETUP.Var Defaults for the Var commands 27 SETUP.VarCall Define call dummy routine 30 SETUP.VarPtr Limit pointer access 31 SETUP.VerifyBreakSet Additional verification for software breakpoints 31

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 0 3 SHADOW ...... 31 SHADOW ICE-166 with a shadow memory 256K 32 SHADOW.Area Select the SHADOW area 32 SHADOW.AutoDelete Initialize the SHADOW RAM on every program start 32 SHADOW.Define Define a SHADOW area 32 SHADOW.Init Initialize all SHADOW areas 34 SHADOW.Mode Define the initialization value for the SHADOW areas 34 SHADOW.OFF Switch SHADOW RAM off 34 SHADOW.ON Switch SHADOW RAM on 34 SHADOW.RESet Reset settings for the SHADOW RAM 35 SHADOW.state Display SHADOW RAM settings 35

SIM ...... 37 SIM TRACE32 Instruction Set Simulators 37 SIM.AREA Selects area for simulation output 37 SIM.CACHE Cache/MMU simulation and more 38 SIM.CACHE.Allocation Define the cache allocation technique 39 SIM.CACHE.BaseAddress Specify base address for tightly-coupled memory 39 SIM.CACHE.Mode Define memory coherency strategy 40 SIM.CACHE.MPURegions Specify MPU regions 41 SIM.CACHE.OFF Disable cache and MMU simulation 41 SIM.CACHE.ON Enable cache and MMU simulation 41 SIM.CACHE.Replacement Define the replacement strategy 42 SIM.CACHE.SETS Define the number of cache/TLB sets 43 SIM.CACHE.SIZE Specify size of tightly-coupled memory 43 SIM.CACHE.state Display cache and MMU settings 44 SIM.CACHE.Tags Define address mode for cache lines 45 SIM.CACHE.TRACE Select simulator trace method 46 SIM.CACHE.View Analysis of memory accesses for cache simulation 46 SIM.CACHE.ViewTLB Analysis of TLB accesses for MMU simulation 47 SIM.CACHE.WAYS Define number of cache ways 47 SIM.CACHE.Width Define width of cache line 48 SIM.command Issue command to simulation model 49 SIM.INTerrupt Trigger interrupt 49 SIM.List List loaded simulator models 50 SIM.LOAD Load simulator module 50 SIM.RESet Reset TRACE32 Instruction Set Simulator 50 SIM.UNLOAD Unload simulator module 51

SNOOPer ...... 52 SNOOPer Sample-based trace 52 Trace Method SNOOPer 53

SNOOPer-specific Trace Commands ...... 54 SNOOPer.Mode Set the SNOOPer trace operation mode 54

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 0 4 SNOOPer.Rate Select sampling rate 56 SNOOPer.SELect Define address for monitoring 56 SNOOPer.SIZE Define trace buffer size 58 SNOOPer.TDelay Define trigger delay 58 SNOOPer.TOut Define the trigger destination 59 SNOOPer.TValue Define data value for trigger 60

Generic SNOOPer Trace Commands ...... 61 SNOOPer.Arm Arm the trace 61 SNOOPer.AutoArm Arm automatically 61 SNOOPer.AutoInit Automatic initialization 61 SNOOPer.BookMark Set a bookmark in trace listing 61 SNOOPer.Chart Display trace contents graphically 61 SNOOPer.Chart.DistriB Distribution display 61 SNOOPer.Chart.Func Function activity chart 62 SNOOPer.Chart.GROUP Group activity chart 62 SNOOPer.Chart.Line Graphical HLL lines analysis 62 SNOOPer.Chart.sYmbol Symbol analysis 62 SNOOPer.Chart.TASK Task activity chart 62 SNOOPer.Chart.TASKFunc Task related function run-time analysis (legacy) 62 SNOOPer.Chart.TASKSRV Service routine run-time analysis 62 SNOOPer.Chart.TASKState Task state analysis 63 SNOOPer.Chart.VarState Variable activity chart 63 SNOOPer.ComPare Compare trace contents 63 SNOOPer.DISable Disable the trace 63 SNOOPer.DRAW Visualization of trace data 63 SNOOPer.DRAW.channel Graphical display of no-data values 63 SNOOPer.DRAW.Var Graphical display of HLL variables 63 SNOOPer.EXPORT Export trace data for processing in other applications 64 SNOOPer.FILE Load a file into the file trace buffer 64 SNOOPer.Find Find specified entry in trace 64 SNOOPer.FindAll Find all specified entries in trace 64 SNOOPer.FindChange Search for changes in trace flow 64 SNOOPer.Get Display input level 64 SNOOPer.GOTO Move cursor to specified trace record 64 SNOOPer.Init Initialize trace 64 SNOOPer.List List trace contents 65 SNOOPer.LOAD Load trace file for offline processing 65 SNOOPer.OFF Switch off 65 SNOOPer.PROfileChart Profile charts 65 SNOOPer.PROfileChart.COUNTER Display a profile chart 65 SNOOPer.PROfileChart.DIStance Time interval for a single event 65 SNOOPer.PROfileChart.DURation Time between two events 65 SNOOPer.PROfileChart.GROUP Group profile chart 66

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 0 5 SNOOPer.PROfileChart.Rate Event frequency 66 SNOOPer.PROfileSTATistic Statistical analysis in a table versus time 66 SNOOPer.PROTOcol Protocol analysis 66 SNOOPer.PROTOcol.Chart Graphic display for user-defined protocol 66 SNOOPer.PROTOcol.Draw Graphic display for user-defined protocol 66 SNOOPer.PROTOcol.EXPORT Export trace buffer for user-defined protocol 66 SNOOPer.PROTOcol.Find Find in trace buffer for user-defined protocol 67 SNOOPer.PROTOcol.List Display trace buffer for user-defined protocol 67 SNOOPer.PROTOcol.STATistic Display statistics for user-defined protocol 67 SNOOPer.REF Set reference point for time measurement 67 SNOOPer.RESet Reset command 67 SNOOPer.SAVE Save trace for postprocessing in TRACE32 67 SNOOPer.SelfArm Automatic restart of trace recording 67 SNOOPer.SnapShot Restart trace capturing once 68 SNOOPer.state Display trace configuration window 68 SNOOPer.STATistic Statistic analysis 68 SNOOPer.STATistic.DIStance Time interval for a single event 68 SNOOPer.STATistic.DistriB Distribution analysis 68 SNOOPer.STATistic.DURation Time between two events 68 SNOOPer.STATistic.Func Nesting function runtime analysis 68 SNOOPer.STATistic.GROUP Group run-time analysis 69 SNOOPer.STATistic.Ignore Ignore false records in statistic 69 SNOOPer.STATistic.InterruptIsFunction Statistics interrupt processing 69 SNOOPer.STATistic.Line HLL-line analysis 69 SNOOPer.STATistic.LINKage Per caller statistic of function 69 SNOOPer.STATistic.Measure Analyze the performance of a single signal 69 SNOOPer.STATistic.PreFetch Prefetch detection 69 SNOOPer.STATistic.Sort Specify sorting criterion for statistic commands 70 SNOOPer.STATistic.sYmbol Flat run-time analysis 70 SNOOPer.STATistic.TASK Task activity statistic 70 SNOOPer.STATistic.TASKFunc Task specific function run-time analysis 70 SNOOPer.STATistic.TASKKernel Task analysis with kernel markers (flat) 70 SNOOPer.STATistic.TASKSRV Analysis of time in OS service routines 70 SNOOPer.STATistic.TASKState Performance analysis 70 SNOOPer.STATistic.TASKTREE Tree display of task specific functions 71 SNOOPer.STATistic.TREE Tree display of nesting function run-time analysis 71 SNOOPer.STATistic.Use Use records 71 SNOOPer.Timing Waveform of trace buffer 71 SNOOPer.TRACK Set tracking record 71 SNOOPer.View Display single record 71 SNOOPer.ZERO Align timestamps of trace and timing analyzers 71

SPE ...... 72 SPE Signal Processing eXtension (SPE) 72

SPot ...... 74 SPot Temporary break of the real-time program execution (TRACE32-ICE) 74 Overview SPot 74 SPot.Analyzer Analyzer spot points 75 SPot.Data Write/read accesses 75 SPot.OFF Switch off 76 SPot.ON Switch on 76 SPot.Program Program spot points 76 SPot.RESet Reset command 77 SPot.state State display 77 SPot.Test Set spot point 78

SSE ...... 79 SSE SSE registers (Streaming SIMD Extension) 79 SSE.Init Initialize SSE registers 79 SSE.OFF Inhibit SSE accesses by the debugger 79 SSE.ON Permit SSE accesses by the debugger 80 SSE.Set Modify SSE registers 80 SSE.view Display SSE registers 80

StatCol ...... 81 StatCol Statistics collector 81

Step ...... 82 Step Steps through the program 82 Step.Asm Assembler single-stepping 82 Step.Back Step back 82 Step.BackChange Step back till expression changes 83 Step.BackOver Step back 83 Step.BackTill Step back till expression true 84 Step.Change Step till expression changes 84 Step.CycleReq Single cycle 85 Step.CycleWait Single cycle 85 Step.Diverge Step till next unreached line 86 Step.Hll HLL single-stepping 88 Step.Mix Mixed single-stepping 88 Step.Over Step over call 89 Step.single Single-stepping 89 Step.Till Step till expression true 90

STM ...... 91 STM System trace configuration 91

sYmbol ...... 95 sYmbol Debug symbols 95 Overview sYmbol 95 PRACTICE Functions 96 sYmbol.AddInfo Provide additional symbolic information 98 sYmbol.AddInfo.Address Add symbol information to fixed address 100 sYmbol.AddInfo.Delete Delete information 101 sYmbol.AddInfo.LINK Define information for 'sYmbol.AddInfo' commands 102 sYmbol.AddInfo.List List additional information 103 sYmbol.AddInfo.LOADASAP2 Load scaling information from ASAP2 file 103 sYmbol.AddInfo.Member Add information to member of struct 104 sYmbol.AddInfo.RESet Remove all additional information 106 sYmbol.AddInfo.Type Add information for a data type 106 sYmbol.AddInfo.Var Add information for a variable 107 sYmbol.AutoLOAD Automated loading of symbols 108 sYmbol.AutoLOAD.CHECK Update autoloader table 109 sYmbol.AutoLOAD.CHECKCoMmanD Configure dynamic autoloader 109 sYmbol.AutoLOAD.CHECKDLL Configure automatic DLL file loader 110 sYmbol.AutoLOAD.CHECKEPOC Dynamic autoloader for Symbian 111 sYmbol.AutoLOAD.CHECKLINUX Configure autoloader for Linux debugging 111 sYmbol.AutoLOAD.CHECKUEFI Configure autoloader for UEFI debugging 112 sYmbol.AutoLOAD.CLEAR Remove symbol information 113 sYmbol.AutoLOAD.config Configure symbol autoloader 113 sYmbol.AutoLOAD.Create Create entry for autoloader table 114 sYmbol.AutoLOAD.List List autoloader table 114 sYmbol.AutoLOAD.LOADEPOC Definition for static autoloader for Symbian 115 sYmbol.AutoLOAD.RESet Reset autoloader 116 sYmbol.AutoLOAD.SET Mark symbol information manually as loaded 116 sYmbol.AutoLOAD.TOUCH Initiate automatic loading by command 117 sYmbol.Browse Browse symbols 118 sYmbol.Browse.Class Browse classes 118 sYmbol.Browse.Enum Browse enumeration types 118 sYmbol.Browse.Function Browse functions 119 sYmbol.Browse.Module Browse modules 120 sYmbol.Browse.SFunction Browse functions 121 sYmbol.Browse.SModule Browse modules 122 sYmbol.Browse.SOURCE Browse source 123 sYmbol.Browse.Struct Browse containers for different variable types 123 sYmbol.Browse.sYmbol Browse symbols 124 sYmbol.Browse.Type Browse HLL types 125 sYmbol.Browse.Var Browse variables 126

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 0 8 sYmbol.CASE Set symbol search mode 127 sYmbol.CHECK Check database 127 sYmbol.Class View class hierarchy 128 sYmbol.CLEANUP Remove redundant symbol information 129 sYmbol.CLEANUP.DOUBLES Make ambiguous symbols unique 129 sYmbol.ColorCode Enable color coding 130 sYmbol.ColorDef Specify color display for keywords 130 sYmbol.CREATE Create and modify user-defined symbols 131 sYmbol.CREATE.Done Finish symbol creation 131 sYmbol.CREATE.Function Create user-defined function 131 sYmbol.CREATE.Label Create user-defined symbol 132 sYmbol.CREATE.MACRO Create user-defined macro 133 sYmbol.CREATE.Module Create user-defined module 133 sYmbol.CREATE.RESet Erase all user-defined symbols 134 sYmbol.CREATE.Var Create user-defined variable 134 sYmbol.CUTLINE Limit size of text blocks 135 sYmbol.Delete Delete symbols of one program 135 sYmbol.DEMangle C++ demangler 136 sYmbol.ForEach Symbol wildcard command 137 sYmbol.INFO Display detailed information about debug symbol 138 sYmbol.LANGUAGE Select language 141 sYmbol.List Display list of all symbols 142 sYmbol.List.ATTRibute Display memory attributes 142 sYmbol.List.BUILTIN List built-in data types 142 sYmbol.List.ColorDef List the keyword color definitions 143 sYmbol.List.FRAME Display frames 144 sYmbol.List.Function Display functions 144 sYmbol.List.IMPORT List imported symbols 144 sYmbol.List.LINE Display source lines 145 sYmbol.List.Local Display local symbols 146 sYmbol.List.MACRO List all C macros 146 sYmbol.List.MAP Display memory load map 147 sYmbol.List.Module Display modules 147 sYmbol.List.Program Display programs 148 sYmbol.List.SECtion Display physical sections 148 sYmbol.List.SOURCE Display source file names 149 sYmbol.List.STACK Display virtual stack 151 sYmbol.List.Static Display static symbols 151 sYmbol.List.TREE Display symbols in tree form 152 sYmbol.List.Type Display data types 152 sYmbol.LSTLOAD Load assembler source file 153 sYmbol.LSTLOAD.GHILLS Load GHILLS assembler source file 153 sYmbol.LSTLOAD.HPASM Load HP assembler source file 153

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 0 9 sYmbol.LSTLOAD.IAR Load IAR assembler source file 155 sYmbol.LSTLOAD.INT68K Load Intermetrics assembler source file 156 sYmbol.LSTLOAD.INTEL Load INTEL assembler source file 156 sYmbol.LSTLOAD.KEIL Load Keil assembler source file 157 sYmbol.LSTLOAD.MicroWare Load MICROWARE assembler source file 157 sYmbol.LSTLOAD.MRI68K Load MICROTEC assembler source file 158 sYmbol.LSTLOAD.OAK Load OAK assembler source file 158 sYmbol.MARKER Fine-tune the nested function run-time analysis 159 sYmbol.MARKER.Create Marker for nesting function run-time analysis 160 sYmbol.MARKER.Delete Delete a marker 164 sYmbol.MARKER.List Displays the marker list 164 sYmbol.MARKER.RESet Erase all markers 164 sYmbol.MATCH Symbol search mode 165 sYmbol.MEMory Display memory usage 165 sYmbol.Modify Modify symbols 166 sYmbol.Modify.Access Modify access of symbols 166 sYmbol.Modify.ADDRess Modify address of symbols 167 sYmbol.Modify.CutFunction Reduce function address information 167 sYmbol.Modify.NAME Rename symbols 168 sYmbol.Modify.SOURCE Define source file 168 sYmbol.name Display symbols 169 sYmbol.NAMESPACES Search symbol in C++ namespace 171 sYmbol.NEW Create new symbol 172 sYmbol.NEW.ATTRibute Create user-defined memory attribute 173 sYmbol.NEW.Function Create user-defined function 175 sYmbol.NEW.Label Create user-defined symbol 175 sYmbol.NEW.MACRO Create user-defined macro 176 sYmbol.NEW.Module Create user-defined module 176 sYmbol.NEW.Var Create user-defined variable 177 sYmbol.OVERLAY Code overlay 178 sYmbol.OVERLAY.AutoID Automatically determine overlay IDs 178 sYmbol.OVERLAY.Create Declare code overlay section 180 sYmbol.OVERLAY.DETECT Detect the current overlay status 182 sYmbol.OVERLAY.FRIEND Declare a friend overlay segment 182 sYmbol.OVERLAY.List Show declared code overlay sections 184 sYmbol.OVERLAY.RESet Reset overlay declarations 184 sYmbol.POINTER Define special register 185 sYmbol.POSTFIX Set symbol postfix 185 sYmbol.PREFIX Set symbol prefix 186 sYmbol.RELOCate Relocate symbols 187 sYmbol.RELOCate.Auto Control automatic relocation 187 sYmbol.RELOCate.Base Define base address 188 sYmbol.RELOCate.List List relocation info 188

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 1 0 sYmbol.RELOCate.Magic Define program magic 188 sYmbol.RELOCate.Passive Define passive base address 189 sYmbol.RELOCate.shift Relocate symbols 189 sYmbol.RESet Clear symbol table 190 sYmbol.SourceCONVert Conversion for Japanese font 190 sYmbol.SourceLOAD Initiate the loading of an HLL source file 191 sYmbol.SourcePATH Source search path 192 sYmbol.SourcePATH.Delete Delete path from search list 192 sYmbol.SourcePATH.DOWN Make directory last in search order 193 sYmbol.SourcePATH.List List source search paths 193 sYmbol.SourcePATH.RESet Reset search path configuration 195 sYmbol.SourcePATH.Set Define search path 196 sYmbol.SourcePATH.SetBaseDir Define directory as base for relative paths 197 sYmbol.SourcePATH.SetCache Internal use only 198 sYmbol.SourcePATH.SetCachedDir Cache direct search path directory 198 sYmbol.SourcePATH.SetCachedDirCache Internal use only 199 sYmbol.SourcePATH.SetDir Define directory as direct search path 199 sYmbol.SourcePATH.SetDynamicDir Adjust search order at hit 201 sYmbol.SourcePATH.SetMasterDir Store cached files only relative 202 sYmbol.SourcePATH.SetRecurseDir Define recursive direct search path 203 sYmbol.SourcePATH.SetRecurseDirCache Internal use only 203 sYmbol.SourcePATH.Translate Replace part of the source path 204 sYmbol.SourcePATH.TranslateSUBpath Replace sub-path 205 sYmbol.SourcePATH.UP Move path up in the search order 205 sYmbol.SourcePATH.Verbose Display search details in message AREA 206 sYmbol.SourceRELOAD Reload source files 207 sYmbol.STATE Display statistic 207 sYmbol.STRIP Set max. symbol length 208 sYmbol.TYPEINFO Display information about a specific data type 208 sYmbol.View Show symbol info 209

SYnch ...... 210 SYnch Synchronization mechanisms between different TRACE32 systems 210 SYnch.Connect Connect to other TRACE32 instances 211 SYnch.MasterBreak Invite other TRACE32 to stop synchronously 211 SYnch.MasterGo Invite other TRACE32 to start synchronously 212 SYnch.MasterStep Invite other TRACE32 to Asm step synchronously 213 SYnch.MasterSystemMode Invite other TRACE32 to follow mode change 213 SYnch.OFF Disable connection mechanism 214 SYnch.ON Enable connection mechanism 214 SYnch.RESet Reset SYnch mechanism 214 SYnch.SlaveBreak Synchronize with stop in connected TRACE32 215 SYnch.SlaveGo Synchronize with start in connected TRACE32 216 SYnch.SlaveStep Synchronize with asm step in connected TRACE32 216

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 1 1 SYnch.SlaveSystemMode Synch. with mode changes in other TRACE32 217 SYnch.state Display current SYnch settings 217 SYnch.XTrack Establish time synchronization to another TRACE32 instance 218

SYStem ...... 219 SYStem System configuration 219 SYStem.Access Dual-port access mode 220 SYStem.BankFile Define the bank switch program 221 SYStem.BankMode Define the bank switch mode 221 SYStem.BdmClock Select BDM clock 222 SYStem.CADIconfig CADI-specific setups 223 SYStem.CADIconfig.RemoteServer Define connection to CADI server 223 SYStem.CADIconfig.Traceconfig Define network settings to CADI trace 225 SYStem.Clock Select clock 226 SYStem.CONFIG 227 SYStem.CONFIG Configure debugger according to target topology 227 SYStem.CONFIG.CORE Assign core to TRACE32 instance 235 SYStem.CONFIG.CoreNumber Set up number of hardware threads 242 SYStem.CONFIG.DEBUGTIMESCALE Extend debug driver timeouts 242 SYStem.CONFIG ELA tbd. 243 SYStem.CONFIG.ListCORE Display the cores of a virtual target 244 SYStem.CONFIG.ListSIMulation Display the simulations of a virtual target 245 SYStem.CONFIG.state Display target configuration 246 SYStem.CONFIG TRACEPORT tbd. 247 SYStem.CONFIG.TRANSACTORPIPENAME Set up pipe name 248 SYStem.CONFIG USB USB configuration 248 SYStem.CONFIG XCP XCP specific settings 249 SYStem.CPU Select CPU 250 SYStem.CpuAccess Run-time memory access (intrusive) 253 SYStem.DCI DCI configuration 255 SYStem.DETECT Detect target system resources 256 SYStem.DLLCommand Custom DLL connection to target 260 SYStem.Down Standby mode 261 SYStem.GTL Configure GTL debug port 262 SYStem.GTL.CONNECT Connect to emulation or simulation 262 SYStem.GTL.DISCONNECT Disconnect from emulation or simulation 263 SYStem.GTL.DMANAME Name of DMA transactor 263 SYStem.GTL.GPIONAME Name of GPIO transactor 264 SYStem.GTL.JTAGPROBENAME Name of JTAG probe transactor 264 SYStem.GTL.LIBname Name of 3rd-party plug-in library 264 SYStem.GTL.MODELCOMMAND Execute command in plug-in 265 SYStem.GTL.MODELCONFIG Configure emulation options 265 SYStem.GTL.MODELNAME Select emulation 265 SYStem.GTL.SERVERCONFIG Configure server options 266

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 1 2 SYStem.GTL.SHAREDMODEL Connect debug port to existing connection 266 SYStem.GTL.TRACENAME Name of trace transactor 267 SYStem.GTL.TransactorConfig Preconfigure a certain transactor 267 SYStem.InfineonDAS Configure the InfineonDAS debug port 269 SYStem.JtagClock Define JTAG frequency 270 SYStem.Line CPU signal control 271 SYStem.LOCK Tristate the JTAG port 271 SYStem.LOG Log read and write accesses to the target 273 SYStem.LOG.CLEAR Clear the ‘SYStem.LOG.List’ window 274 SYStem.LOG.CLOSE Close the system log file 274 SYStem.LOG.Init Clear the 'SYStem.LOG.List' window 275 SYStem.LOG.List Log the accesses made by TRACE32 276 SYStem.LOG.Mode Set logging mode 277 SYStem.LOG.OFF Pause logging 278 SYStem.LOG.ON Resume logging 278 SYStem.LOG.OPEN Open a system log file 279 SYStem.LOG.RESet Reset configuration of system log to defaults 279 SYStem.LOG.Set Select the TRACE32 accesses to be logged 280 SYStem.LOG.SIZE Define number of lines in the ‘SYStem.LOG.List’ window 281 SYStem.LOG.state Open configuration window of system log 282 SYStem.LOG.StopOnError Stop logging on error 283 SYStem.MemAccess Run-time memory access (non-intrusive) 284 SYStem.Mode Select mode 286 SYStem.MonFile Monitor extension 290 SYStem.MONITOR tbd. 290 SYStem.Option Special setup 291 SYStem.Option AMBA Select AMBA bus mode 292 SYStem.Option BigEndian Define byte order (endianness) 292 SYStem.Option HOOK Compare PC to hook address 293 SYStem.Option IMASKASM Disable interrupts while single stepping 294 SYStem.Option IMASKHLL Disable interrupts while HLL single stepping 296 SYStem.Option LittleEnd Selection of little endian mode 297 SYStem.Option MACHINESPACES Address extension for guest OSes 298 SYStem.Option MMUSPACES Enable space IDs 299 SYStem.Option TURBO Speed up memory access 301 SYStem.Option ZoneSPACES Enable symbol management for zones 302 SYStem.PAUSE Pause the execution of operations 303 SYStem.POLLING Polling mode of CPU 304 SYStem.PORT Configure external communication interface 305 SYStem.RESet Reset configuration 306 SYStem.RESetOut Reset peripherals 306 SYStem.RESetTarget Release target reset 307 SYStem.state Display SYStem.state window 308

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 1 3 SYStem.TARGET Set target IP name or address 309 SYStem.TimeOut Time-out for target access 309 SYStem.TimeoutDebug tbd. 310 SYStem.TimeReq Time-out dualport access 310 SYStem.Up Active mode 311 SYStem.VirtualTiming Modify timing constraints 312 SYStem.VirtualTiming.HardwareTimeout Disable/enable hardware timeout 313 SYStem.VirtualTiming.HardwareTimeoutScale Multiply hardware timeout 313 SYStem.VirtualTiming.InternalClock Base for artificial time calculation 314 SYStem.VirtualTiming.MaxPause Limit pause 314 SYStem.VirtualTiming.MaxTimeout Override time-outs 315 SYStem.VirtualTiming.OperationPause Insert a pause after each operation 315 SYStem.VirtualTiming.PauseinTargetTime Set up pause time-base 316 SYStem.VirtualTiming.PauseScale Multiply pause with a factor 316 SYStem.VirtualTiming.PollingPause Advance emulation time when polling 317 SYStem.VirtualTiming.TimeinTargetTime Set up general time-base 317 SYStem.VirtualTiming.TimeScale Multiply time-base with a factor 318

SystemTrace ...... 319 SystemTrace tbd. 319 SystemTrace.state Open system-trace configuration window 319

General Commands Reference Guide T

General Commands Reference Guide T ...... (general_ref_t.pdf) 1

History ...... 14

TargetSystem ...... 15 TargetSystem.state Show overview of multi-core system 15

TASK ...... 19 TASK RTOS debugger for TRACE32 19 Overview TASK 19 TASK.ACCESS Control memory access 22 TASK.Break Deprecated 22 TASK.CACHEFLUSH Reread task list 22 TASK.CONFIG Configure RTOS debugger 23 TASK.COPYDOWN Copy file from host into target 25 TASK.COPYUP Copy file from target into host 25 TASK.CreateExtraID Create a virtual task 25 TASK.CreateID Create virtual task 26 TASK.Debug Deprecated 26 TASK.DeleteID Delete virtual task 26 TASK.DETACH Detach from task 26 TASK.INSTALL tbd. 27

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 1 4 TASK.KILL End task 27 TASK.List Information about tasks 29 TASK.List.MACHINES List machines 29 TASK.List.SPACES List MMU spaces 30 TASK.List.tasks List all running tasks 31 TASK.List.TREE Display tasks in a tree structure 32 TASK.ListID List virtual tasks 33 TASK.MTXTRC Internal 33 TASK.NAME Task magic to name translation 34 TASK.NAME.DELete Delete a task name table entry 34 TASK.NAME.RESet Reset task name table 34 TASK.NAME.Set Set a task name table entry 35 TASK.NAME.view Show task name translation table 35 TASK.NoBreak Deprecated 35 TASK.NoDebug Deprecated 36 TASK.NoStop Deprecated 36 TASK.OFF Deprecated 36 TASK.ON Deprecated 37 TASK.ORTI AUTOSAR/OSEK support 38 TASK.ORTI.CPU Set OSEK SMP CPU number 38 TASK.ORTI.load Configure debugger for OSEK/ORTI 38 TASK.ORTI.NOSTACK Exclude an ORTI task from stack evaluation 39 TASK.RESet Reset RTOS debugger 40 TASK.RUN Load task 40 TASK.select Display context of specified task 40 TASK.SETDIR Set the awareness directory 42 TASK.STacK Stack usage coverage 43 TASK.STacK.ADD Add stack space coverage 44 TASK.STacK.DIRection Define stack growth direction 45 TASK.STacK.Init Initialize unused stack space 45 TASK.STacK.PATtern Define stack check pattern 46 TASK.STacK.PATternGAP Define check pattern gap 46 TASK.STacK.ReMove Remove stack space coverage 47 TASK.STacK.RESet Reset stack coverage 47 TASK.STacK.view Open stack space coverage 48 TASK.Stop Deprecated 48

TCB ...... 50 TCB Trace control block 50 TCB.AllBranches Broadcast all branches 51 TCB.CPU Broadcast information for specified CPU only 51 TCB.CycleAccurate Cycle accurate tracing 52 TCB.DataTrace Broadcast specified address and data information 53 TCB.EX Broadcast exception level information 54

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 1 5 TCB.FCR Broadcast function call-return information 54 TCB.IM Broadcast instruction cache miss information 54 TCB.InstructionCompletionSizeBits Specify size of completion message 55 TCB.KE Broadcast kernel mode information 55 TCB.LSM Broadcast load store data cache information 56 TCB.OFF Switch TCB off 56 TCB.ON Switch TCB on 56 TCB.PCTrace Broadcast program counter trace 57 TCB.PortFilter Disable port filter 57 TCB.PortMode Specify trace clock ratio 58 TCB.PortWidth Specify trace port width 58 TCB.Register Display TCB control register 59 TCB.RESet Reset TCB setup to default 60 TCB.SourceSizeBits Specify number of bit for core information in trace 60 TCB.STALL Stall CPU for complete trace 60 TCB.state Display TCB setup 61 TCB.SV Broadcast supervisor mode information 62 TCB.SyncPeriod Specify TCB sync period 62 TCB.TC Broadcast information for specified HW thread 63 TCB.ThreadSizeBits Specify number of bit for thread information in trace 63 TCB.Type Specify TCB type 64 TCB.UM Broadcast user mode information 64 TCB.Version Specify trace cell version 65

TERM ...... 66 TERM Terminal emulation 66 Overview TERM 66 TERM.CLEAR Clear terminal window 70 TERM.CLOSE Close files 70 TERM.CMDLINE Specify a command line 70 TERM.FastWRITE Fast data write 70 TERM.GATE Terminal with virtual hosting 72 TERM.HARDCOPY Print terminal window contents 72 TERM.HEAPINFO Define memory heap parameters 73 TERM.LocalEcho Enables/disables local echo for new terminal windows 73 TERM.METHOD Select terminal protocol 74 TERM.Mode Define terminal type 76 TERM.Out Send data to virtual terminal 77 TERM.PIPE Connect terminal to named pipe 77 TERM.PipeREAD Connect terminal input to named pipe 77 TERM.PipeWRITE Connect terminal output to named pipe 78 TERM.Protocol Select terminal protocol 78 TERM.PULSE Enable pulse generator for transfers 78 TERM.Rate Define polling rate 78

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 1 6 TERM.READ Get terminal input from file 79 TERM.RESet Reset terminal parameters 79 TERM.SCROLL Define terminal size 80 TERM.SIZE Define terminal size 80 TERM.TCP Route terminal input/output to TCP port 80 TERM.TELNET Open TELNET terminal window 81 TERM.Vector Define interrupt vectors 81 TERM.view Terminal display 82 TERM.WRITE Write terminal output to file 82

TPIU ...... 83 TPIU Trace Port Interface Unit (TPIU) 83 Overview TPIU 83 TPIU.CLEAR Re-write the TPIU registers 84 TPIU.IGNOREZEROS Workaround for a special chip 84 TPIU.NOFLUSH Workaround for a chip bug affecting TPIU flush 84 TPIU.PortClock Inform debugger about HSSTP trace frequency 85 TPIU.PortMode Select the operation mode of the TPIU 86 TPIU.PortSize Select interface type and port size of the TPIU 87 TPIU.RefClock Set up reference clock for HSSTP 88 TPIU.Register Display TPIU registers 88 TPIU.RESet Reset TPIU settings 89 TPIU.state Display TPIU configuration window 89 TPIU.SWVPrescaler Set up SWV prescaler 90 TPIU.SWVZEROS Workaround for a chip bug 90 TPIU.SyncPeriod Set period of sync packet injection 91

TPU ...... 92 TPU.BASE Base address 92 TPU.Break Break TPU 92 TPU.Dump Memory display 92 TPU.Go Start TPU 92 TPU.Register.ALL Register operation mode 92 TPU.Register.NEWSTEP New debugging mode 92 TPU.Register.Set Register modification 92 TPU.Register.view Register display 93 TPU.RESet Disable TPU debugger 93 TPU.SCAN Scanning TPU 93 TPU.SELect Select TPU for debugging 93 TPU.Step Single step TPU 93 TPU.view View TPU channels 93

Trace ...... 94 Trace Trace configuration and display 94 Overview Trace 95

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 1 7 .ABCDEF Sampling configuration for probes ABCDEF 104 .ACCESS Define access path to source code for trace decoding 105 .ADDRESS Software trace address 107 .Arm Arm the trace 108 .AutoArm Arm automatically 109 .AutoFocus Calibrate AUTOFOCUS preprocessor 109 .AutoInit Automatic initialization 114 .AutoStart Automatic start 114 .AutoTEST Continuous measurement 115 .BookMark Set a bookmark in trace listing 117 .BookMarkToggle Toggles a single trace bookmark 119 .Break Stop trace 120 .Chart Display trace contents graphically 121 .Chart.Address Time between program events as a chart 129 .Chart.DatasYmbol Analyze pointer contents graphically 130 .Chart.DistriB Distribution display 132 .Chart.Func Function activity chart 135 .Chart.GROUP Group activity chart 136 .Chart.Line Graphical HLL lines analysis 137 .Chart.Nesting Show function nesting at cursor position 138 .Chart.sYmbol Symbol analysis 139 .Chart.TASK Task activity chart 143 .Chart.TASKFunc Task related function run-time analysis (legacy) 144 .Chart.TASKINTR Display ISR2 time chart (ORTI) 144 .Chart.TASKKernel Task run-time chart with kernel markers (flat) 145 .Chart.TASKSRV Service routine run-time analysis 146 .Chart.TASKState Task state analysis 147 .Chart.TASKVSINTERRUPT Time chart 148 .Chart.TASKVSINTR Time chart 149 .Chart.VarState Variable activity chart 150 .CLEAR Clear FDX communication buffers 153 .CLOCK Clock to calculate time out of cycle count information 153 .CLOSE Close FDX files 154 .ComPare Compare trace contents 154 .CSELect Select signal for counter 156 .CustomTrace Custom trace 157 .CustomTrace..COMMAND Send command to specific DLL 157 .CustomTrace..UNLOAD Unload a single DLL 157 .CustomTraceLoad Load a DLL for trace analysis/Unload all DLLs 158 .DISable Disable the trace 159 .DISableChannel Disable FDX communication 159 .DisConfig Trace disassembler configuration 160 .DisConfig.CYcle Trace disassemble setting 160

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 1 8 .DisConfig.FlowMode Enable FlowTrace analysis 161 .DisConfig.RESet Reset trace disassemble setting 162 .DisConfig.view Trace disassemble setting 162 .DRAW Visualization of trace data 163 .DRAW.channel Graphical display of no-data values 163 .DRAW.Data Draw any memory access 165 .DRAW.Var Graphical display of HLL variables 182 .Enable Operation mode 186 .ENableChannel Enable FDX communication 186 .EXPORT Export trace data for processing in other applications 187 .EXPORT.Ascii Export trace data as ASCII 188 .EXPORT.Bin Export trace data as binary file 189 .EXPORT.BRANCHFLOW Export branch events from trace data 190 .EXPORT.CSVFunc Export the function nesting to a CSV file 191 .EXPORT.flow Export trace data 192 .EXPORT.Func Export function nesting 195 .EXPORT.TASKEVENTS Export task event to CSV 196 .EXPORT.TracePort Export trace packets as recorded at trace port 197 .EXPORT.VCD Export trace data in VCD format 198 .EXPORT.VERILOG Export trace data in VERILOG format 199 .EXPORT.VHDL Export trace data in VHDL format 199 .FILE Load a file into the file trace buffer 200 .Find Find specified entry in trace 202 .FindAll Find all specified entries in trace 206 .FindChange Search for changes in trace flow 207 .FLOWPROCESS Process flowtrace 208 .FLOWSTART Restart flowtrace processing 208 .Get Display input level 209 .GOTO Move cursor to specified trace record 211 .IMPORT Import trace information 214 .IMPORT.CoreByteStream Import pure single core trace data 216 .IMPORT.ETB Import on-chip trace data 217 .IMPORT.flow Import bus trace data 217 .IMPORT.GUESSWRAP Guess wrap pointer 218 .IMPORT.STP Import STP recording from file (nibble) 218 .IMPORT.STPByteStream Import STP recording from file (byte) 219 .IMPORT.TraceFile Import trace data where processing has failed 219 .IMPORT.TracePort Import off-chip trace data 220 .IMPORT.VCD Import recorded signals in VCD file format 220 .IMPORT.WRAP Define wrap pointer 221 .InChannel Inchannel state display 222 .Init Initialize trace 222 .JKLMNO Sampling configuration for probes JKLMNO 223

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 1 9 .JOINFILE Concatenate several trace recordings 223 .LEVEL Select trigger level manually 223 .List List trace contents 226 .ListNesting Analyze function nesting 237 .ListVar List variable recorded to trace 240 .LOAD Load trace file for offline processing 241 .MERGEFILE Combine two trace files into one 243 .METHOD Select trace method 244 .Mode Set the trace operation mode 246 .MUX Select channels 250 .OFF Switch off 250 .Out tbd. 250 .PC Display PC in real-time 251 .PipePROTO Unload all DLLs 252 .PipePROTO.COMMAND Send command to DLLs 252 .PipePROTO.load Define a user-supplied DLL as trace sink 252 .PipeWRITE Connect to a named pipe to stream trace data 253 .PortFilter Specify utilization of trace memory 253 .PortSize Set external port size 255 .PortType Specify trace interface 255 .PROfile Display counter profile 257 .PROfileChart Profile charts 258 .PROfileChart.COUNTER Display a profile chart 258 .PROfileChart.DIStance Time interval for a single event 259 .PROfileChart.DURation Time between two events 260 .PROfileChart.GROUP Group profile chart 265 .PROfileChart.Rate Event frequency 266 .PROfileChart.sYmbol Dynamic program behavior graphically (flat) 268 .PROfileChart.TASK Dynamic task behavior graphically (flat) 272 .PROfileSTATistic Statistical analysis in a table versus time 274 .Program Program trigger unit 274 .PROTOcol Protocol analysis 276 .PROTOcol.Chart Graphic display for user-defined protocol 276 .PROTOcol.Draw Graphic display for user-defined protocol 278 .PROTOcol.EXPORT Export trace buffer for user-defined protocol 279 .PROTOcol.Find Find in trace buffer for user-defined protocol 280 .PROTOcol.List Display trace buffer for user-defined protocol 281 .PROTOcol.STATistic Display statistics for user-defined protocol 284 Protocol specific Options 286 Definition of User-Specific Protocols 288 .Rate Select sampling rate 289 .REF Set reference point for time measurement 290 .ReProgram Program trigger unit 291

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 2 0 .RESet Reset command 291 .SAMPLE Set AutoFocus sample time offset 291 .SAVE Save trace for postprocessing in TRACE32 293 .Select Select trigger/counter line 297 .SelfArm Automatic restart of trace recording 297 .SET Select line for recording 299 .ShowFocus Display data eye for AUTOFOCUS preprocessor 299 .ShowFocusClockEye Display clock eye 303 .ShowFocusEye Display data eye for AUTOFOCUS preprocessor 305 .SIZE Define buffer size 307 .SLAVE Select slave mode 308 .SnapShot Restart trace capturing once 309 .SPY Enable analysis of streaming file while recording 310 .state Display trace configuration window 312 .STATistic Statistic analysis 315 .STATistic.Address Time between up to 8 program events 316 .STATistic.AddressDIStance Time interval for single program event 317 .STATistic.AddressDURation Time between two program events 318 .STATistic.BondOut Bondout mode 320 .STATistic.ChildTREE Show callee context of a function 320 .STATistic.COLOR Assign colors to function for colored graphics 321 .STATistic.CYcle Analyze cycle types 321 .STATistic.DatasYmbol Analyze pointer contents numerically 325 .STATistic.DIStance Time interval for a single event 327 .STATistic.DistriB Distribution analysis 330 .STATistic.DURation Time between two events 333 .STATistic.FIRST Start point for statistic analysis 336 .STATistic.Func Nesting function runtime analysis 338 .STATistic.FuncDURation Statistic analysis of function 363 .STATistic.FuncDURationInternal Stat analysis of function internal 364 .STATistic.GROUP Group run-time analysis 365 .STATistic.Ignore Ignore false records in statistic 366 .STATistic.INTERRUPT Interrupt statistic 367 .STATistic.InterruptIsFunction Statistics interrupt processing 368 .STATistic.LAST End point for statistic analysis 370 .STATistic.Line HLL-line analysis 372 .STATistic.LINKage Per caller statistic of function 375 .STATistic.LISTCONFIG tbd. 376 .STATistic.Measure Analyze the performance of a single signal 377 .STATistic.MODULE Code execution broken down by module 379 .STATistic.PAddress Which instructions accessed data address 379 .STATistic.ParentTREE Show the call context of a function 380 .STATistic.PIPELINE tbd. 381

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 2 1 .STATistic.PreFetch Prefetch detection 382 .STATistic.PROGRAM Code execution broken down by program 383 .STATistic.PsYmbol Shows which functions accessed data address 383 .STATistic.Sort Specify sorting criterion for statistic commands 385 .STATistic.sYmbol Flat run-time analysis 393 .STATistic.TASK Task activity statistic 398 .STATistic.TASKFunc Task specific function run-time analysis 405 .STATistic.TASKKernel Task analysis with kernel markers (flat) 413 .STATistic.TASKORINTERRUPT Statistic of interrupts and tasks 416 .STATistic.TASKSRV Analysis of time in OS service routines 416 .STATistic.TASKState Performance analysis 417 .STATistic.TASKTREE Tree display of task specific functions 421 .STATistic.TASKVSINTERRUPT Statistic of interrupts, task-related 422 .STATistic.TREE Tree display of nesting function run-time analysis 423 .STATistic.Use Use records 424 .STREAMCompression Select compression mode for streaming 425 .STREAMFILE Specify temporary streaming file path 426 .STREAMFileLimit Set size limit for streaming file 427 .STREAMLOAD Load streaming file from disk 428 .STREAMSAVE Save streaming file to disk 430 .TCount Set trigger counter 430 .TDelay Trigger delay 431 .TERMination Use trace line termination of preprocessor 433 .TestFocus Test trace port recording 433 .TestFocusClockEye Scan clock eye 436 .TestFocusEye Check signal integrity 436 .THreshold Optimize threshold for trace lines 438 .TimeStamp Configure timestamp usage of LOGGER trace 439 .Timing Waveform of trace buffer 440 .TMode Select trigger mode 442 .TOut Route trigger to PODBUS (CombiProbe) 442 .TOut Enable trigger output line (PowerIntegrator) 442 .TPreDelay Pre-trigger delay 443 .TraceChannel tbd. 443 .TraceCLOCK Export trace data 444 .TraceCONNECT Select on-chip peripheral sink 444 .TRACK Set tracking record 445 .TRIGGER Trigger the trace 445 .TSELect Select trigger source 446 .TSYNC Select trigger line and mode 447 .TView Display trigger settings 448 .TWidth Set trigger filter 448 .View Display single record 449

TRACEPORT ...... 452 TRACEPORT Configure trace hardware 452 TRACEPORT.EndsKiP Define number of bytes skipped at the end of frame 453 TRACEPORT.LaneCount Select port size of the trace port 454 TRACEPORT.LaneSpeed Inform debugger about trace port frequency 454 TRACEPORT.MsgBItEndian Change bit-order within each byte 455 TRACEPORT.MsgBYteEndian Change byte-order within each word 456 TRACEPORT.MsgLOngEndian Change dword-order within each qword 456 TRACEPORT.MsgWOrdEndian Change word-order within each dword 457 TRACEPORT.PinReMap Adapt the lane order of the trace port 458 TRACEPORT.RefCLocK Set up reference clock for trace port 459 TRACEPORT.RESet Reset trace port configuration 459 TRACEPORT.StartsKiP Define number of bytes skipped at the start of frame 460 TRACEPORT.state Display trace port configuration window 461

TrAddress ...... 462 TrAddress Select output signal 462

TRANSlation ...... 465 TRANSlation Debugger address translation 465 Overview TRANSlation 465 TRANSlation.AutoEnable Auto-enable debugger MMU translation 467 TRANSlation.AutoSCAN Autoscan feature for debugger MMU 467 TRANSlation.CacheFlush Flush TRACE32 address translation cache 468 TRANSlation.CLEANUP Clean up MMU table 468 TRANSlation.COMMON Common address ranges for kernel and tasks 469 TRANSlation.COMMON.ADD Add another common address range 471 TRANSlation.COMMON.CLEAR Clear all common logical address ranges 471 TRANSlation.Create Create translation 472 TRANSlation.CreateID Add entry to MMU space ID table 473 TRANSlation.CreateTab Create multiple translations 473 TRANSlation.Delete Delete translation 474 TRANSlation.DeleteID Remove entry from MMU space ID table 474 TRANSlation.List List MMU translation table 475 TRANSlation.ListID List MMU space ID table 476 TRANSlation.NoProtect Unprotect memory 476 TRANSlation.OFF Deactivate debugger address translation 477 TRANSlation.ON Activate debugger address translation 478 TRANSlation.PAGER Allow paged breakpoints for Linux 479 TRANSlation.Protect Protect memory 479 TRANSlation.RESet Reset MMU configuration 480 TRANSlation.SCANall Scan MMU tables 480

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 2 3 TRANSlation.ScanID Scan MMU address space tables from kernel 480 TRANSlation.SHADOW Enable shadow access to target memory 481 TRANSlation.TableWalk Automatic MMU page table walk 482 TRANSlation.TlbAutoScan Allow automatic TLB scans during table walk 482 TRANSlation.TRANSparent Transparent banking area 484

TrBus ...... 485 TRIGGER Connector 485 Interaction Between Independent PODBUS Devices 488 TrBus.Arm Arm the trigger bus 489 TrBus.Connect Configure TRIGGER as input or output 490 TrBus.Mode Define polarity/edge for the trigger signal 491 TrBus.OFF Switch trigger bus off 491 TrBus.Out Define source for the external trigger pulse 492 TrBus.RESet Reset setting for trigger bus 492 TrBus.Set Define the target for the incoming trigger 492 TrBus.state Display settings for the trigger bus 493 TrBus.Trigger Stimulate a trigger on the trigger bus 493

TrEvent ...... 495 Function 495 TrEvent.Delay Define delay 496 TrEvent.Enable Select time windows 496 TrEvent.Init Initialization 497 TrEvent.MinInit Initialization 497 TrEvent.Mode Select operation mode 497 TrEvent.OFF Switch off 501 TrEvent.ON Switch on 502 TrEvent.RESet Reset command 503 TrEvent.Select Select event source 503 TrEvent.view State display 505

TrPOD ...... 506 TrPOD Trigger probe 506 TrPOD.Clock Defines data mask 506 TrPOD.ClockPOL Defines data polarity 506 TrPOD.Data Defines data mask 507 TrPOD.DataPOL Defines data polarity 507 TrPOD.Mode Defines data polarity 508 TrPOD.OFF Switch off 509 TrPOD.ON Switch on 509 TrPOD.RESet Reset command 509 TrPOD.state State display 510 TrPOD.Time Defines the time for the pulse width trigger 511

TrIn ...... 512

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 2 4 Function 512 TrIn.Clock Define clock 513 TrIn.Data Define data 517 TrIn.Mask Define bits 517 TrIn.Normal Level operation 518 TrIn.RESet Reset command 518 TrIn.state State display 518 TrIn.Transient Transient operation 519

TrMain ...... 521 Trigger System of TRACE32-ICE 521 TrMain.ALways Constant triggering 524 TrMain.Arm Release and activate trigger system 524 TrMain.AutoInit Automatic trigger initialization 524 TrMain.AutoStart Automatic trigger initialization 525 TrMain.Break Break 525 TrMain.Count Set trigger counter 526 TrMain.Delay Set trigger delay 526 TrMain.Init Initialize trigger system 527 TrMain.Mode Select mode 527 TrMain.OFF Switch off trigger system 528 TrMain.Out Output trigger pulse 528 TrMain.RESet Reset trigger system 530 TrMain.Set Select trigger sources 530 TrMain.state Trigger state display 535 TrMain.Trigger Trigger 535

TrOnchip ...... 536 TrOnchip Onchip triggers 536 TrOnchip.Address tbd. 537 TrOnchip.CONVert Adjust range breakpoint in onchip registers 537 TrOnchip.CYcle tbd. 538 TrOnchip.Data tbd. 538 TrOnchip.RESet Reset settings to defaults 539 TrOnchip.Set Break on event 540 TrOnchip.state Display onchip trigger window 540 TrOnchip.TaskID tbd. 541 TrOnchip.TEnable tbd. 541

General Commands Reference Guide U

General Commands Reference Guide U ...... (general_ref_u.pdf) 1

General Commands Reference Guide V ...... (general_ref_v.pdf) 1

History ...... 4

Var ...... 5 Var HLL variables and expressions 5 Overview Var 5 Var.AddWatch Add variable to Var.Watch window 22 Var.Assign Assignment to a variable 23 Var.Break Breakpoint on variable 24 Var.Break.Delete Delete breakpoint on variable 24 Var.Break.direct Set temporary breakpoint on HLL expression 26 Var.Break.Pass Define pass condition for breakpoint 27 Var.Break.Set Set breakpoint to HLL expression 28 Var.Call Call a new procedure 29 Var.CHAIN Display linked list 30 Var.DelWatch Delete variable from watch 31 Var.DRAW Graphical variable display 31 Var.DUMP Memory dump 36 Var.EXPORT Export variables in CSV format to file 37 Var.FixedCHAIN Display linked list 37 Var.FixedTABle Display table 38 Var.Go Real-time emulation 40 Var.Go.Back Re-run program backwards until variable access (CTS) 40 Var.Go.Change Real-time emulation till expression changes 41 Var.Go.direct Real-time emulation with breakpoint 42 Var.Go.Till Real-time emulation till expression true 43 Var.IF PRACTICE conditional branching 43 Var.INFO View information about HLL variable or HLL expression 44 Var.Local Local variables 45 Var.LOG Log variables 46 Var.NEW Creates a TRACE32-internal variable 48 Var.NEWGLOBAL Creates a global TRACE32-internal variable 49 Var.NEWLOCAL Creates a local TRACE32-internal variable 50 Var.PRINT Display variables 53 Var.PROfile Graphical display of variable 54 Var.Ref Referenced variables 55 Var.set Modify variable 56 Var.Step Step 59 Var.Step.BackChange Step back till expression changes 59 Var.Step.BackTill Step back till expression true 59 Var.Step.Change Step till expression changes 60 Var.Step.Till Step till expression true 60

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 2 6 Var.TABle Display table 61 Var.TREE Display variables in the form of a tree structure 62 Var.TYPE Display variable types 63 Var.View Display variables 64 Var.Watch Open 'Var.Watch' window 66 Var.WHILE PRACTICE loop construction 67 Var.WRITE Write variables to file 68

VCO ...... 68 VCO Clock generator 69 Overview 69 VCO.BusFrequency Control bus clock 69 VCO.Clock Control emulation clock 70 VCO.Down Frequency down 70 VCO.Frequency Control VCO clock 71 VCO.Rate VCO rate 71 VCO.RESet VCO reset 72 VCO.state State display 72 VCO.TimeBaseFrequency Set the time base clock 73 VCO.Up Frequency up 73

VCU ...... 75 VCU VCU registers (Vector Computational Unit) 75 VCU.Init Initialize VCU registers 75 VCU.RESet Reset VCU registers 75 VCU.Set Set VCU register 76 VCU.view Display VCU registers 76

VE ...... 77 VE Virtual execution mode 77 VE.OFF Turn off virtual execution mode 77 VE.ON Turn on virtual execution mode 77

VPU ...... 78 VPU Vector Processing Unit (VPU) 78 VPU.Init Initialize ALTIVEC registers 78 VPU.Set Modify ALTIVEC registers 78 VPU.view Display ALTIVEC register window 79

General Commands Reference Guide W

General Commands Reference Guide W ...... (general_ref_w.pdf) 1

General Commands Reference Guide X

General Commands Reference Guide X ...... (general_ref_x.pdf) 1

General Commands Reference Guide Y

General Commands Reference Guide Y ...... (general_ref_y.pdf) 1

sYmbol ...... 2

General Commands Reference Guide Z

General Commands Reference Guide Z ...... (general_ref_z.pdf) 1

High-Level Language Debugging

Application Note C++ Debugging

Application Note C++ Debugging ...... (app_cpp_debugging.pdf) 1

Sample Code used by This Application Note ...... 2

Gathering Information of Objects ...... 3 Display Options Dedicated to Objects 3 Most Derived Class 5 Lifetime of the “this” Pointer 5 Class Conversions 6

Gathering Information of Classes ...... 7

C++ Overloading and Symbol Mangling ...... 8 Demangling 8 Ambiguous Symbols 8 Other Command Line Hints 9

ELF Loader Options ...... 10

Debugging in C++ Code ...... 11 Target Order / Source Order 11 Breakpoints 12

FLASH Programming

Onchip/NOR FLASH Programming User's Guide

Onchip/NOR FLASH Programming User's Guide ...... (norflash.pdf) 1

Introduction ...... 4

Programming Commands ...... 20 FLASH.ReProgram Command (Target-controlled) 20 FLASH.ReProgram Command (TRACE32 Tool-based) 26 FLASH.Erase / FLASH.Program Command 27 The FLASH.AUTO Command 30 Unlocking Command 39

DualPort FLASH Programming ...... 41 Benefits 41 Preconditions 41 Usage 42

Special Features for Onchip FLASHs ...... 44 OTP Sector Programming 44 Mirrored FLASH Addresses 46 FLASH.Create Command 48 FLASH.TARGET Command 53 FLASH.CLocK Command 54 FLASH.CHANGETYPE Command 55 FLASH.UNSECUREerase Command 56

FLASH Declaration in Detail ...... 57 Further Applications for FLASH Declarations Using CFI 57 Declarations for not CFI-conform FLASH Devices 68 TRACE32 Tool-based vs. Target-controlled FLASH Programming 74 Maintaining the Declared FLASH Devices 86 List of Supported FLASH Devices 86

FLASH Programming via Boundary Scan ...... 87 Boundary scan chain configuration 87 FLASH interface definition 88 FLASH Programming 89 Full Example 90

FAQ ...... 93

Further Information ...... 93

NAND FLASH Programming User's Guide

NAND FLASH Programming User's Guide ...... (nandflash.pdf) 1

Introduction ...... 4 How This Manual is Organized 4 Related Documents 5

List of Abbreviations ...... 7

Background Information ...... 7 What is a NAND Flash Device? 7 About Blocks, Pages, Main Area, and Spare Area 8 About Bad Block Markers 9 About NAND Flash Controllers 10

Standard Approach ...... 11 Identifying and Running Scripts for NAND Flash Programming 11 If There Is No Script 13

Scripts for NAND Flash Programming ...... 14 Establishing Communication between Debugger and Target CPU 16 Configuring the NAND Flash Controller 17 Resetting Default Values 19 Identifying the Type of NAND Flash Controller 20 Informing TRACE32 about the NAND Flash Register Addresses 22 Informing TRACE32 about the NAND Flash Programming Algorithm 24 Checking the Identification from the NAND Flash Device 33 Erasing the NAND Flash Device 34 Programming the NAND Flash Device 35 Other Useful Commands (NAND) 38 Full Examples: Generic NAND Flash Programming 50 Full Example: CPU-Specific NAND Flash Programming 54

About OneNAND Flash Devices ...... 55

Scripts for OneNAND Flash Devices ...... 56 Establishing Communication between Debugger and Target CPU 58 Configuring the OneNAND Flash Bus 58 Resetting Default Values 59 Informing TRACE32 about the OneNAND Flash Address 59 Informing TRACE32 about the OneNAND Flash Programming Algorithm 60 Checking the Identification from the OneNAND Flash Device 64 Erasing the OneNAND Flash Device 65 Programming the OneNAND Flash Device 66 Other Useful Commands (OneNAND) 68 Full Example 78

Appendix A: ECC (Error Correction Code) ...... 79 How to Generate ECC and to Detect Error 79

Appendix B: Spare Area Schemes ...... 83 Linux MTD NAND Driver Default Spare Area Schemes 83 SAMSUNG Standard Spare Area Schemes 85

Serial FLASH Programming User's Guide ...... (serialflash.pdf) 1

Introduction ...... 3 How This Manual is Organized 3 Related Documents 3 Contacting Support 4

List of Abbreviations ...... 6

Background Knowledge ...... 7 What is a Serial Flash Device? 7 About SPI Interface Controllers in Serial Flash Memories 7 About Blocks and Pages 8 File Name Convention for Serial Flash Drivers 9

Standard Approach ...... 10 Identifying and Running Scripts for Serial Flash Programming 10 If There Is No Script 12

Scripts for SPI Controllers ...... 13 Establishing Communication between Debugger and Target CPU 15 Configuring the SPI Controller 16 Resetting Default Values 17 Informing TRACE32 about the Serial Flash Register Addresses (SPI) 17 Informing TRACE32 about the Serial Flash Programming Algorithm 18 FLASHFILE Declaration Examples 24 Checking the Identification from the Serial Flash Device 26 Erasing the Serial Flash Device 27 Programming the Serial Flash Device 28 Other Useful Commands 32 Full Examples 34

FLASH Programming via Boundary Scan ...... 37 Example 1 for the SPI Protocol 37 Example 2 for the I2C Protocol 39 eMMC FLASH Programming User's Guide

eMMC FLASH Programming User's Guide ...... (emmcflash.pdf) 1

Introduction ...... 3 How This Manual is Organized 3 Related Documents 3 Contacting Support 4

List of Abbreviations ...... 6

Background Knowledge ...... 7

Standard Approach ...... 9 Identifying and Running Scripts for eMMC Flash Programming 9 If There Is No Script 11

Scripts for eMMC Controllers ...... 12 Establishing Communication between Debugger and Target CPU 13 Configuring the eMMC Controller 14 Resetting Default Values 15 Informing TRACE32 about the eMMC Controller Address 15 Informing TRACE32 about the eMMC Flash Programming Algorithm 15 FLASHFILE Declaration Examples 19 Checking the Identification from the eMMC Flash Device 21 Erasing the eMMC Flash Device 22 Programming the eMMC Flash Device 22 Other Useful Commands 26 Full Examples 28

FLASH Programming via Boundary Scan ...... 31

List of Supported FLASH Devices

List of Supported FLASH Devices ...... (flashlist.pdf) 1

List of NOR FLASH Devices ...... 2

List of Supported NAND FLASH Controllers ...... 138

Application Notes for FLASH

How to Write your own FLASH Algorithm

How to Write your own FLASH Algorithm ...... (flash_app_own_algorithm.pdf) 1

FLASH Programming ...... 2 Target Controlled Flash Programming 2

Tips to Solve NOR FLASH Programming Problems

Tips to Solve NOR FLASH Programming Problems ...... (flash_diagnosis.pdf) 1

Introduction ...... 3

General Recommendation ...... 5

TRACE32 Error Messages ...... 6

Target-controlled Programming ...... 33 Sources of Errors 34 General Course of Action in the Case of Problems (Target-controlled) 35

Errors Caused by Wrong Usage of the TRACE32 Commands ...... 46 Unintentional Erasing of the Complete FLASH Device 46 Multiple FLASH Devices on one Target 47

FAQ ...... 48

Appendix A ...... 49 Conversion of the Tool-based to Target-controlled FLASH Programming 49 Checking the Bus Configuration 50 Main Difference between Intel and AMD/Spansion FLASH Devices 51 Intel FLASH Devices 52 AMD/Spansion FLASH Devices 56

Appendix B ...... 68 FLASH Width BYTE 68 FLASH Width WORD 69 FLASH Width LONG 70 FLASH Width QUAD 72

How to Write your own FLASHFILE Algorithm

How to Write your own FLASHFILE Algorithm ...... (flashfile_app_own_algorithm.pdf) 1

FLASHFILE Programming ...... 2 Target Controlled Flashfile Programming 2

Boundary Scan

Boundary Scan User's Guide

Boundary Scan User's Guide ...... (boundary_scan.pdf) 1

Introduction ...... 3 Intended Audience 3 How This Manual is Organized 4 Related Documents 4

List of Abbreviations ...... 4

What to know about Boundary Scan ...... 5

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 3 3 Configuration of the Boundary Scan Chain ...... 7 Configure Boundary Scan Engine 7 Loading the BSDL Files 9 Initialization of the Boundary Scan Chain 10 Check the Configuration 11

General Operation ...... 12 Basic Mode of Operation 12 Preparation of the Boundary Scan Chain 12 Execution of the Boundary Scan Commands 16 Working with the GUI 17

Interactive Board Test ...... 25 Configure Run Mode 26 Execute Level and Connection Tests 29

Automated Board Test ...... 32 Prepare Boundary Scan Chain 33 Run Tests 34 Full Example 35

Test of Non-Boundary Scan Devices ...... 37

Special Tests ...... 41 Boundary Scan Oscilloscope 41 Other Instructions and Data Registers 42

Tips and Tricks ...... 44

TRACE32 Lua Library

TRACE32 Lua Library ...... (lua_library.pdf) 1

TRACE32 Lua Library ...... 2 Functions for JTAG Access 3 Input Output Functions 5 Example 6

Intel® DCI [Direct Connect Interface]

Debugging via Intel® DCI User´s Guide

Debugging via Intel® DCI User´s Guide ...... (dci_intel_user.pdf) 1

Start a TRACE32 Session using Intel® DCI ...... 7 Prepare Your Target 7 Connecting to an Intel® SoC using DCI OOB 7 Connecting to an Intel® Client or Server System using DCI OOB 8 Connecting to an Intel® SoC using DCI DbC 9 Connecting to an Intel® Client or Server System using DCI DbC 10

Troubleshooting ...... 11 DCI error: no response to connect pattern 11 Could not stop the target 11 Target Power Fail 11

Intel® DCI Specific Commands ...... 12 DCI Commands to configure the Intel® DCI trace handler 12 DCI.DESTination Set trace destination 12 DCI.ON Enable trace handler 12 DCI.OFF Disable trace handler 13 SYStem.DCI Intel® DCI specific SYStem commands 14 SYStem.DCI.Bridge Select DCI bridge 14 SYStem.DCI.BssbClock Configure DCI OOB clock rate 14 SYStem.DCI.DisCONnect Force DCI disconnect 16 SYStem.DCI.DOrouting Polarity of DO signal 16 SYStem.DCI.PortPower Configure VBUS 17

Intel® DCI Specific Functions ...... 18 SYStem.DCI.Bridge() Currently selected DCI bridge 18 SYStem.DCI.BssbClock() Currently selected DCI OOB clock 18

Peripheral Files

Peripheral Files Programming Commands

Peripheral Files Programming Commands ...... (per_prog.pdf) 1

Introduction ...... 3 Peripheral File General Description 3 Passing Arguments 7 Memory Classes 9

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 3 5 GROUP Commands ...... 10 GROUP Define read/write GROUP 10 HGROUP Define read-once/write GROUP 12 RGROUP Define read-only GROUP 12 WSGROUP Define write-only and shadow GROUP 13 WGROUP Define write-only GROUP 14

SGROUP Commands ...... 15 SGROUP Define sequence GROUP 15 SET Write constant value to memory 17 SETX Write SGROUP buffer to memory 18 GETX Read from memory to the SGROUP buffer 19 CONSTX Write constant value to the SGROUP buffer 20 VARX Write expression to SGROUP buffer 21 WRITEBACK Separate write a part from a read part 22

Other Top Level Commands ...... 24 ASSERT Abort if condition not met 24 BASE Define a base address for following group definitions 25 BASEOUT Output a value before calculating a base address 25 BASESAVEOUT Output a value before calculating a base address 27 CONFIG Configure default access width and line break for BIT 27 ELSE Conditional GROUP display 29 ELIF Conditional GROUP display 29 ENDIAN Define little or big endian 29 ENDIF Conditional GROUP display 29 ENTRY Assign parameters to macros 29 HELP Reference online manual 30 IF Conditional GROUP display 30 INCLUDE Include another peripheral file 32 SIF Conditional interpretation 33 TREE Define hierarchic display 34 WIDTH Width of register names and a BIT description 34 WAIT Wait with PER windows until system is ready 35

Commands within GROUPs ...... 36 ASCII Display ASCII character 36 BIT Define bits 36 BITFLD Define bits individually 37 BUTTON Define command button 41 COPY Copy GROUP 42 DECMASK Define bits for decimal display 43 FLOATMASK Define bits for decimal floating point display 44 EVENTFLD Define event flag bits individually 45 HEXFLD Define hexword individually 46

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 3 6 HEXMASK Define bits for a hexadecimal display 47 HIDE Define write-only line 48 IN Define input field 49 INDEX Output a value 49 LINE Define line 51 MUNGING Translate to little endian mode (PowerPC only) 52 NEWLINE Line break within detailed register description 52 RBITFLD Define bits individually (read-only) 53 SAVEINDEX Save original and output a value 54 SETCLRFLD Define set/clear locations 55 SYSCON SYSCON register (C166/ST10 only) 56 TEXTLINE Define text header with a new line 56 TEXTFLD Define text header 56

Functions ...... 58

History ...... 59

Converter SPIRIT XML to PER Commands

Converter SPIRIT XML to PER Commands ...... (converter_spiritxml.pdf) 1

Introduction ...... 2

Main view ...... 3

Component properties ...... 6

Start processing ...... 8

Trace Analysis

Trace Application Notes

Application Note for the Trace.Find Command

Application Note for the Trace.Find Command ...... (app_trace_find.pdf) 1

History ...... 3

The Trace Find Dialog ...... 4 Push Buttons 6 Cycle Tab (default) 9 Data Field 12 Expert Tab 14 Group Tab 20 Changes Tab 22

Trace Find Commands ...... 32 Overview 32 Combining Search Items 32 Record Numbers and Record Ranges 33 Trace Item with Specified Value 34 Format the Result 42 Related TRACE32 Functions 43

Convert Setting in Trace Find Dialog to a TRACE32 Command ...... 44

Use Cases ...... 45 Find Task Switches 45

Application Note for the SNOOPer Trace

Application Note for the SNOOPer Trace ...... (app_snooper.pdf) 1

Introduction ...... 3

SNOOPer Trace Configuration ...... 4 Accessing the Configuration Window for the SNOOPer Trace 4 Configuring the SNOOPer Trace 5 SNOOPer Trace State 6

Sampling the Memory ...... 8 Memory SNOOPer Configuration 10 Display the SNOOPer Trace Results 13 SNOOPer Trace Trigger 20

Sampling the Program Counter ...... 22 Setup 23 Display Options 23 Sampling the Program Counter and the Current Task 25

Data Sampling via Debug Communication Channel ...... 28

Sampling Benchmark Counters ...... 30

Sampling ETM Counters ...... 34

Save and Load ...... 38

AutoFocus User's Guide

AutoFocus User's Guide ...... (autofocus_user.pdf) 1

Installation ...... 7 Hardware Installation 7 Software Installation 15 Recommendation for the Software Start 15 Recommendation for Power Down 15

Utilization ...... 16 Preprocessor 16 Trace Port 20

FAQ ...... 25

Diagnosis ...... 26 Displaying Error Messages 26 Searching for Errors 27 Types of Trace Decoder Errors 29 Trace Test Failure Messages 30 Access the Diagnosis Tool 31 Diagnosis Check List 32 Choose the Best Termination PCB Type 52 How to understand A.ShowFocusEye and A.ShowFocusClockEye 53 Recommendations for Target Board Design 56

Pin Remapping ...... 58 Functional Description - Pin Remapping 58 Pinouts 60

Technical Data ...... 62 AutoFocus Preprocessor Hardware Versions 62 Electrical Specification for AutoFocus II Preprocessors 65 Dimensions 68 Connector Layout for ARM 77

Products ...... 83 Product Information 83 Order Information 85

PowerTrace Serial User´s Guide

PowerTrace Serial User´s Guide ...... (serialtrace_user.pdf) 1

History ...... 3

Introduction ...... 3 Intended Audience 3 Prerequisites 3

Installation ...... 5 Hardware Installation 5 Software Installation 21 Recommendation for the Software Start 21 Recommendation for Power Down 21

Trace Port Utilization ...... 22 HSSTP-based Trace Port 22 AGBT-based Trace Port 27 Serial NEXUS-based Trace Port 27 PCIe-based Trace Port 27

FAQ ...... 30

Diagnosis ...... 31 Device LED Codes 31 Displaying Error Messages 32 Searching for Errors 33 Types of Trace Decoder Errors 35 Trace Test Failure Messages 36 Diagnosis Check List 37 Recommendations for Target Board Design 42

Technical Data ...... 43 PowerTrace Serial Accessory Sets 43 Electrical Specification for PowerTrace Serial 45 Dimensions 47 Connector Layout 47

System Trace

System Trace User's Guide

System Trace User's Guide ...... (trace_stm.pdf) 1

Introduction ...... 5

Installation ...... 7 Software Installation 7 Hardware Installation 7

Utilization of the STM ...... 9 Start-up Script 9

SYStem.CONFIG.STM - Configuration of TRACE32 ...... 12 SYStem.CONFIG.STM Inform TRACE32 about trace source implementation 12

STM - Configuration of the Trace Source ...... 15 STM System trace configuration 15 STM.FilterMasters Display specified masters only 15 STM.FilterChannels Display specified channels only 16 STM.Init Initialize trace hardware 16 STM.OFF Switch STM off 16 STM.ON Switch STM on 17 STM.PortEndianness Select port endianness 17 STM.PortMode Select STM port modes 18 STM.PortRoute Select output of STP data 19 STM.PortSize Port size in bits 20 STM.PrintfTraceFormat Defines format of printftrace style messages 21 STM.Register Display STM register 21 STM.RESet Reset STM settings 22 STM.SetMaster Set master ID manually 22 STM.state Display STM settings 23 STM.SyncTime Trace decoder resync time 23 STM.SyncPeriod Add synchronization packets 24 STM.TimeStamps Enables timestamps 24 STM.TimeStampCLOCK Configure debugger for STM timestamp clock 24

STM - Configuration of the TI Specific Trace Source ...... 25 STM.HWMasters Enable hardware masters for tracing 25 STM.IdleCount Maximum idle packets 25 STM.IgnoreHeader Ignore leading dword in printftrace message 26 STM.SWMasters Enable software masters for tracing 26 STM.OCPAutoIdle Set OCP idle clock behavior 27 STM.PATTERN Enable test pattern generator 27 STM.ChannelRepeat Period of channel packet insertion 28 STM.MasterRepeat Period of master packet insertion 28

STM - Configuration of the CoreSight Specific Trace Source ...... 29 STM.DMArequests DMA requests enable 29 STM.COMPression Data compression enable 29 STM.EventMASK Mask hardware event inputs 30 STM.PortMASK Mask stimulus ports 30 STM.TraceID Sets trace ID 30 STM.TracePriority Set priority for STM manually 31

STM - Trace Data Analysis ...... 32 Overview STM 32 STMAnalyzer Analyze STM data recorded by TRACE32 PowerTrace 33 STMCAnalyzer Analyze STM data recorded by TRACE32 CombiProbe 34

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 4 1 STMHAnalyzer Analyze STM data recorded by the host 34 STMLA Analyze STM data from binary file 35 STMOnchip Analyze STM data stored on target memory 35 STMTrace Method independent trace analysis 35

PrintfTrace ...... 36 PrintfTrace Decoder for STP-based software messages 36

CMI ...... 39 CMI Clock management interface 39 CMI.EnableMessage Enables event or activity message generation 39 CMI.Mode Set event or activity mode 40 CMI.OFF Switch CMI off 41 CMI.ON Switch CMI on 41 CMI.Register Display the CMI register 41 CMI.RESet Resets CMI settings to their defaults 42 CMI.SamplingWindow Set sampling window 42 CMI.state Display CMI settings 42 CMI Example 43 CMI Module Configuration 43

CMITrace - Trace Data Analysis ...... 44 Overview CMITrace 44 CMITrace Analyze CMI trace data 45

OCP_WP ...... 46 OCP OpenCoreProtocol WatchPoint 46 OCP.AutoIDLE OCP-WP clocking strategy 46 OCP.DebugPort Select target to be traced 47 OCP.OFF Switch OCP off 47 OCP.ON Switch OCP on 47 OCP.Register Display OCP registers 48 OCP.RESet Reset OCP settings to their defaults 48 OCP.state Display OCP settings 49 OCP.TraceFilter Set filter criteria 50 OCP.TraceFilter.NAME Name a filter 50 OCP.TraceFilter.MCmd Filters traffic by transaction type 50 OCP.TraceFilter.Initiator Filters traffic by transaction initiator 51 OCP.TraceFilter.REQinfo Filters traffic by transaction qualifier 51 OCP.TraceEnable Filter OCP traffic by address range 52 OCP.TraceOFF Stop tracing 52 OCP.TraceON Start tracing 53 OCP.TriggerOut Generate trigger event 53 Displaying Trace Results 54 OCP Module Configuration 54

PMI ...... 55

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 4 2 PMI Power management interface 55 PMI.EnableMessage Enables event message generation 55 PMI.OFF Switch PMI off 56 PMI.ON Switch PMI on 56 PMI.Register Display the PMI registers 56 PMI.RESet Resets PMI settings to their defaults 57 PMI.SamplingWindow Set sampling window 57 PMI.state Display PMI settings 57 Displaying Trace Results 58 PMI Example 59 PMI Module Configuration 59

StatCol ...... 60 StatCol Statistics collector 60 StatCol.RESet Resets all statistics collector settings to their default 60 StatCol.state Display statistics collector settings 60 StatCol..OFF Switch probe off 61 StatCol..ON Switch probe on 61 StatCol..REQuestEVenT Select event detector 61 StatCol..ReSPonseEVenT Select event detector 62 StatCol..CollectTime Set up collection period 62 StatCol..Counter ADDRMAX Filter max address 63 StatCol..Counter ADDRMIN Filter min address 63 StatCol..Counter ADDREN Enable address filtering 63 StatCol..Counter EventInfo Select ‘EventInfo’ to count 64 StatCol..Counter MAX Set max threshold for events 64 StatCol..Counter MIN Set min threshold for events 64 StatCol..Counter SELect Set counter input 65 StatCol..Counter Filter MUX Input port 66 StatCol..Counter Filter OFF Switch filter off 66 StatCol..Counter Filter ON Switch filter on 66 StatCol..Counter Filter Set filter criteria 67 StatCol Macro Functions 68 Displaying Trace Results 71 StatCol Example 73 StatCol module configuration 73

FAQ ...... 74

Bootloader Debugger for coreboot

Bootloader Debugger for coreboot ...... (boot_coreboot.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 3

Supported Versions ...... 3

Configuration ...... 4 x86 32-Bit 4 x64 64-Bit 4

Features ...... 5 Display of coreboot Resources 5 Coreboot Specific Menu 6

Coreboot Commands ...... 7 EXTension.INFO Display coreboot build information 7 EXTension.BuildCONF Display coreboot build configuration 7 EXTension.LOG Display coreboot log 8 EXTension.CBFS Display coreboot file system 9 EXTension.TimeStamps Display timestamps 10 EXTension.MemoryMAP Display memory mapping 11 EXTension.CBTABLE Display contents of coreboot tables 12

UEFI Debuggers

UEFI BLDK Debugger

UEFI BLDK Debugger ...... (uefi_bldk.pdf)1

Overview ...... 3

Brief Overview of Documents for New Users ...... 4

Supported Versions ...... 4

Configuration ...... 5 x86 32-Bit 5 x64 64-Bit 5 Hooks & Internals in Intel BLDK 6

Features ...... 7 Display of UEFI Resources 7 Symbol Autoloader 8

Debugging UEFI Phases of Intel BLDK ...... 12 Debugging from Reset Vector 12 SEC Phase 12 PEI Phase 12 DXE Phase 13 BDS Phase 14

Intel BLDK Commands ...... 15 EXTension.ConfigTab Display DXE configuration table 15 EXTension.DXEDRiVer Display loaded DXE drivers 15 EXTension.DXEModule Display DXE modules 16 EXTension.FV Display firmware volumes 17 EXTension.HOB Display HOBs 18 EXTension.Option Set awareness options 18 EXTension.PEIModule Display PEI modules 19 EXTension.PEISvc Display PEI services 20 EXTension.POST Display POST code 20 EXTension.PROTocol Display installed protocols 21 EXTension.UCode Display microcodes 21

Intel BLDK PRACTICE Functions ...... 22

UEFI H2O Debugger

UEFI H2O Debugger ...... (uefi_h2o.pdf) 1

Overview ...... 3

Brief Overview of Documents for New Users ...... 4

Supported Versions ...... 4

Configuration ...... 5 x86/Atom 32-Bit 5 x64/Atom 64-Bit 5 Hooks & Internals in InsydeH2O 6

Features ...... 7 Display of UEFI Resources 7 Symbol Autoloader 8 InsydeH2O Specific Menu 11

Debugging UEFI Phases of InsydeH2O ...... 13 Debugging from Reset Vector 13 SEC Phase 13 PEI Phase 14 DXE Phase 15 BDS Phase 15

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 4 5 InsydeH2O Commands ...... 16 EXTension.ConfigTab Display DXE configuration table 16 EXTension.DXEDRiVer Display loaded DXE drivers 16 EXTension.DXEModule Display DXE modules 17 EXTension.FV Display firmware volumes 18 EXTension.HOB Display HOBs 19 EXTension.Option Set awareness options 20 EXTension.PEIModule Display PEI modules 20 EXTension.PEISvc Display PEI services 21 EXTension.POST Display POST code 21 EXTension.PROTocol Display installed protocols 22 EXTension.UCode Display microcodes 22

InsydeH2O PRACTICE Functions ...... 23

UEFI TianoCore Debugger

UEFI TianoCore Debugger ...... (uefi_tiano.pdf) 1

Overview ...... 3

Brief Overview of Documents for New Users ...... 4

Supported Versions ...... 4

Configuration ...... 5 ARM 32-Bit 5 ARM 64-Bit 6 Hooks & Internals in TianoCore 6

Features ...... 7 Display of UEFI Resources 7 Symbol Autoloader 8 TianoCore Specific Menu 11

Debugging UEFI Phases of TianoCore ...... 12 Debugging from Reset Vector 12 SEC Phase 12 PEI Phase 12 DXE Phase 12 BDS Phase 13

TianoCore Commands ...... 14 EXTension.ConfigTab Display DXE configuration table 14 EXTension.DXEDRiVer Display loaded DXE drivers 14 EXTension.DXEModule Display DXE modules 15 EXTension.FV Display firmware volumes 16 EXTension.HOB Display HOBs 17 EXTension.Option Set awareness options 17

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 4 6 EXTension.PEIModule Display PEI modules 18 EXTension.PEISvc Display PEI services 19 EXTension.POST Display POST code 19 EXTension.PROTocol Display installed protocols 20 TianoCore PRACTICE Functions 21

RTOS Debuggers

RTOS Debugger for AMX

RTOS Debugger for AMX ...... (rtos_amx.pdf) 1

Overview ...... 3

Brief Overview of Documents for New Users ...... 4

Supported Versions ...... 4

Configuration ...... 5 Manual Configuration 5 Automatic Configuration 6 Quick Configuration Guide 6 Hooks & Internals of AMX 7

Features ...... 8 Display of Kernel Resources 8 Task Stack Coverage 8 Task Related Breakpoints 9 Task Context Display 10 Dynamic Task Performance Measurement 11 Task Runtime Statistics 11 Task State Analysis 13 Function Runtime Statistics 14 AMX specific Menu 16

AMX Commands ...... 17 TASK.DBPool Display buffer pools 17 TASK.DEVent Display event groups 17 TASK.DEXChange Display message exchanges 17 TASK.DMailBoX Display mailboxes 18 TASK.DMPool Display memory pools 19 TASK.DSEMaphore Display semaphores 20 TASK.DSYStem Display system state 20 TASK.DTask Display tasks 21 TASK.DTIMer Display timers 22 TASK.TASKState Mark task state words 22

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 4 7 AMX PRACTICE Functions ...... 23 TASK.CONFIG(magic) Address of magic number 23 TASK.CONFIG(magicsize) Size of magic number 23 TASK.CONFIG(kdata) Address of kernel data area 23

Frequently-Asked Questions ...... 24

RTOS Debugger for ARTK

RTOS Debugger for ARTK ...... (rtos_artk.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 2

Supported Versions ...... 3

Configuration ...... 4 Manual Configuration 4 Automatic Configuration 5 Quick Configuration 5 Hooks and Internals 5

Features ...... 6 Display of Kernel Resources 6 Task Stack Coverage 6 Task Related Breakpoints 7 Dynamic Task Performance Measurement 8 Task Runtime Statistics 8 Task State Analysis 9 Function Runtime Statistics 10 AdaWorld ARTK specific Menu 11

ARTK Commands ...... 12 TASK.TaskList List tasks 12

PRACTICE Functions ...... 13

Frequently-Asked Questions ...... 13

RTOS Debugger for ARTX-166

RTOS Debugger for ARTX-166 ...... (rtos_rtxartx166.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 3

Supported Versions ...... 3

Configuration ...... 4 Manual Configuration 4 Automatic Configuration 4

ARTX-166 Commands ...... 14 TASK.Task Display tasks 14

ARTX-166 PRACTICE Functions ...... 15

Frequently-Asked Questions ...... 15

RTOS Debugger for ChibiOS/RT

RTOS Debugger for ChibiOS/RT ...... (rtos_chibios.pdf) 1

Overview ...... 3

Brief Overview of Documents for New Users ...... 4

Supported Versions ...... 4

Configuration ...... 5 Manual Configuration 5 Automatic Configuration 5 Quick Configuration Guide 6 Hooks & Internals in ChibiOS 6

Features ...... 7 Display of Kernel Resources 7 Task Stack Coverage 7 Task Related Breakpoints 8 Task Context Display 9 Dynamic Task Performance Measurement 10 Task Runtime Statistics 10 Function Runtime Statistics 11 ChibiOS specific Menu 14

ChibiOS Commands ...... 15 TASK.CONDvar Display condition variables 15 TASK.EVenT Display events 15 TASK.Heap Display heaps 16

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 4 9 TASK.MailBox Display mailboxes 16 TASK.MuTeX Display mutexes 17 TASK.Pool Display memory pools 17 TASK.Queue Display queues 18 TASK.SEMaphore Display semaphores 18 TASK.Thread Display threads 19 TASK.VTimer Display virtual timers 19

ChibiOS PRACTICE Functions ...... 20

Frequently-Asked Questions ...... 20

RTOS Debugger for Chorus Classic

RTOS Debugger for Chorus Classic ...... (rtos_chorus_classic.pdf) 1

Overview ...... 3

Brief Overview of Documents for New Users ...... 4

Supported Versions ...... 4

Configuration ...... 5 Manual Configuration 5 Automatic Configuration 6 Quick Configuration Guide 6 Hooks & Internals in ChorusOS 7

Features ...... 8 KDB Terminal Emulation 8 Display of Kernel Resources 8 Task Runtime Statistics 8 Task State Analysis 9 Function Runtime Statistics 10 Task Stack Coverage 11 MMU Support 12 ChorusOS specific Menu 14

ChorusOS Commands ...... 15 TASK.LActor List actor table 15 TASK.LPort List port table 16 TASK.LRsrc List resources 16 TASK.LThread List thread table 17 TASK.MMU.SCAN Scan actor MMU space 18 TASK.MmuSet Set emulator MMU to actor 19 TASK.TASKState Mark task state words 19

ChorusOS PRACTICE Functions ...... 20 TASK.ACTOR.SPACE() Space ID of actor 20 TASK.ACTOR.START() Start address of specified region 20

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 5 0 TASK.CONFIG(kernel) Address of the kernel state variable 20 TASK.CONFIG(magic) Address of magic number 21 TASK.CONFIG(magicsize) Size of magic number 21

Frequently-Asked Questions ...... 21

RTOS Debugger for Chorus Micro

RTOS Debugger for Chorus Micro ...... (rtos_chorus_micro.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 3

Supported Versions ...... 3

Configuration ...... 4 Manual Configuration 4 Automatic Configuration 5 Quick Configuration Guide 5 Hooks & Internals in Chorus Micro 5

Features ...... 6 Display of Kernel Resources 6 Thread Runtime Statistics 6 Task State Analysis 6 Function Runtime Statistics 7 Task Stack Coverage 7 Chorus Micro Specific Menu 7

Chorus Commands ...... 9 TASK.LThread List thread table 9

Chorus PRACTICE Functions ...... 10

Frequently-Asked Questions ...... 10

RTOS Debugger for Cmicro

RTOS Debugger for Cmicro ...... (rtos_cmicro.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 2

Supported Versions ...... 3

Configuration ...... 4 Manual Configuration 4 Automatic Configuration 5 Hooks & Internals of SDT-Cmicro 5

Features ...... 6

SDT-Cmicro Commands ...... 9 TASK.PList Display process instances 9 TASK.PType Display process types 9 TASK.QList Display signal queue 10

SDT-Cmicro PRACTICE Functions ...... 11

Frequently-Asked Questions ...... 11

RTOS Debugger for CMX

RTOS Debugger for CMX ...... (rtos_cmx.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 3

Supported Versions ...... 3

Configuration ...... 4 Manual Configuration 4 Automatic Configuration 4 Quick Configuration Guide 4 Hooks & Internals in CMX 5

Features ...... 6 CMXBug Terminal Emulation 6 Display of Kernel Resources 6 Task Stack Coverage 6 Task Related Breakpoints 7 Dynamic Task Performance Measurement 8 Task Runtime Statistics 8 Task State Analysis 9 Function Runtime Statistics 10 CMX specific Menu 12

CMX Commands ...... 13 TASK.DCyclic Display cyclic timers 13 TASK.DMailbox Display mailboxes 13 TASK.DQueue Display queues 14 TASK.DRes Display resources 14 TASK.DSema Display semaphores 15 TASK.DTask Display tasks 15 TASK.TASKState Mark task state words 16

Frequently-Asked Questions ...... 17

RTOS Debugger for CMX-TINY+

RTOS Debugger for CMX-TINY+ ...... (rtos_cmx_tiny.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 3

Supported Versions ...... 3

Configuration ...... 4 Manual Configuration 4 Automatic Configuration 4 Quick Configuration Guide 4 Hooks & Internals in CMX-TINY+ 5

Features ...... 6 Display of Kernel Resources 6 Task Runtime Statistics 6 Task State Analysis 7 Function Runtime Statistics 8 Task Stack Coverage 10 CMX-TINY+ specific Menu 10

CMX-TINY+ Commands ...... 11 TASK.DCyclic Display cyclic timers 11 TASK.DMailbox Display mailboxes 11 TASK.DResource Display resources 12 TASK.DTask Display tasks 12 TASK.TASKState Mark task state words 12

CMX-TINY+ PRACTICE Functions ...... 14 TASK.CONFIG(magic) Address of magic number 14 TASK.CONFIG(magicsize) Size of magic number 14 TASK.ID2MAGIC() Magic number of task ID 14 TASk.STACK() Stack address of task 15

Frequently-Asked Questions ...... 15

RTOS Debugger for DSP/BIOS

RTOS Debugger for DSP/BIOS ...... (rtos_bios.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 3

Supported Versions ...... 3

Features ...... 6 Display of Kernel Resources 6 Task Stack Coverage 6 Task Related Breakpoints 7 Dynamic Task Performance Measurement 8 DSP/BIOS specific Menu 8

DSP/BIOS Commands ...... 10 TASK.KerNeL Display kernel information 10 TASK.LOG.DISable Disable system log events 10 TASK.LOG.ENable Enable system log events 10 TASK.LOG.View Display logs 11 TASK.MailBoX Display mailboxes 12 TASK.MEMory Display memory segments 12 TASK.SEMaphore Display semaphores 13 TASK.SWI Display SWIs 13 TASK.TaSK Display tasks 14

RTOS BIOS PRACTICE Functions ...... 15

Frequently-Asked Questions ...... 15

RTOS Debugger for eCos

RTOS Debugger for eCos ...... (rtos_ecos.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 3

Supported Versions ...... 3

Configuration ...... 4 Manual Configuration 4 Automatic Configuration 4 Quick Configuration Guide 5 Hooks & Internals in eCos 5

Features ...... 6 Display of Kernel Resources 6 Task Stack Coverage 6 Task Related Breakpoints 7 Task Context Display 8 SMP Support 9

eCos Commands ...... 16 TASK.SCHEDuler Display scheduler information 16 TASK.TASKState Mark task state words 16 TASK.THRead Display threads 17

eCos PRACTICE Functions ...... 18

Frequently-Asked Questions ...... 18

RTOS Debugger for embOS

RTOS Debugger for embOS ...... (rtos_embos.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 3

Supported Versions ...... 3

Configuration ...... 4 Manual Configuration 4 Automatic Configuration 5 Quick Configuration Guide 5 Hooks & Internals in embOS 5

Features ...... 7 Display of Kernel Resources 7 Task Stack Coverage 7 Task Related Breakpoints 8 Task Context Display 9 Dynamic Task Performance Measurement 10 Task Runtime Statistics 10 Task State Analysis 11 Function Runtime Statistics 12 embOS specific Menu 13

embOS Commands ...... 15 TASK.CSema Display ’CSemaphore’ 15 TASK.MailBox Display mailbox 15 TASK.RSema Display ’RSemaphore’ 16 TASK.TaskList Display tasks 16 TASK.TIMer Display timer 17

embOS PRACTICE Functions ...... 18

RTOS Debugger for FAMOS

RTOS Debugger for FAMOS ...... (rtos_famos.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 3

Supported Versions ...... 3

Configuration ...... 4 Manual Configuration 4 Automatic Configuration 4 Quick Configuration Guide 5 Hooks & Internals in FAMOS 5

Features ...... 6 Display of Kernel Resources 6 Task Stack Coverage 6 Task Related Breakpoints 7 Task Context Display 8 Dynamic Task Performance Measurement 9 Task Runtime Statistics 9 Task State Analysis 10 Function Runtime Statistics 12 FAMOS Specific Menu 13

FAMOS Commands ...... 15 TASK.Kernel Display kernel state 15 TASK.MailBox Display mailboxes 15 TASK.MailQueues Display mailqueues 16 TASK.Semaphore Display semaphores 16 TASK.Thread Display threads 17 TASK.TIMer Display timers 18

FAMOS PRACTICE Functions ...... 19

Frequently-Asked Questions ...... 19

RTOS Debugger for FreeRTOS

RTOS Debugger for FreeRTOS ...... (rtos_freertos.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 3

Supported Versions ...... 3

Configuration ...... 4

Features ...... 7 Display of Kernel Resources 7 Task Stack Coverage 7 Task Related Breakpoints 8 Task Context Display 9 Dynamic Task Performance Measurement 10 Task Runtime Statistics 10 Task State Analysis 11 Function Runtime Statistics 12 FreeRTOS specific Menu 14

FreeRTOS Commands ...... 15 TASK.Queue Display queue 15 TASK.TaskList Display tasks 16

FreeRTOS PRACTICE Functions ...... 17 TASK.AVAIL() Availability of FreeRTOS objects 17 TASK.CONFIG(magic) Address of magic number 17 TASK.CONFIG(magicsize) Size of magic number 17 TASK.STRUCT() Structure names 18

Frequently-Asked Questions ...... 19

RTOS Debugger for HI7000

RTOS Debugger for HI7000 ...... (rtos_hi7000.pdf) 1

Overview ...... 3

Brief Overview of Documents for New Users ...... 4

Supported Versions ...... 4

Configuration ...... 5 Manual Configuration 5 Automatic Configuration 5 Quick Configuration Guide 6 Hooks & Internals in HI7000 6

Features ...... 7 Display of Kernel Resources 7 Task Stack Coverage 7 Task Related Breakpoints 8 Dynamic Task Performance Measurement 9 Task Runtime Statistics 9

HI7000 Commands ...... 14 TASK.ALarM Display alarm handlers 14 TASK.CYClic Display cyclic handlers 14 TASK.DaTaQueue Display data queues 15 TASK.FLaG Display event flags 15 TASK.MailBoX Display mailboxes 16 TASK.MemPooL Display variable memory pools 16 TASK.MemPoolF Display fixed memory pools 17 TASK.MsgBuFfer Display message buffers 17 TASK.MuTeX Display mutexes 18 TASK.SEMaphore Display semaphores 18 TASK.TaSK Display tasks 19

HI7000 PRACTICE Functions ...... 20

Frequently-Asked Questions ...... 20

RTOS Debugger for Linux

RTOS Debugger for Linux - Run Mode

RTOS Debugger for Linux - Run Mode ...... (rtos_linux_run.pdf) 1

Debugging Modes for Embedded Linux ...... 2 Run Mode Debugging with TRACE32 as GDB Front-end 2 Stop Mode Debugging via JTAG 2 Integrated Run & Stop Mode Debugging via JTAG 3 Supported Debugging Modes sorted by Architectures 4

Basic Concepts ...... 5 t32server (only ARM) 5 gdbserver 5 Ethernet as Communication Interface to the gdbserver 7 DCC as Communication Interface to the t32server 9 The Space ID for Run Mode Debugging 11 Process Debugging 12

Quick Start Example for ARM ...... 14

Quick Start Example for MIPS ...... 16

Quick Start Example for PowerPC ...... 18 SYStem.Option NoDebugStop 19

Switching between Run & Stop Mode Debugging ...... 20

Breakpoint Conventions ...... 24

Debugging of Multi-threaded Applications ...... 25

Frequently-Asked Questions ...... 26

RTOS Debugger for Linux - Stop Mode

RTOS Debugger for Linux - Stop Mode ...... (rtos_linux_stop.pdf) 1

History ...... 5

Debugging Modes for Embedded Linux ...... 5 Run Mode Debugging with TRACE32 as GDB Front-end 5 Stop Mode Debugging via JTAG 5 Integrated Run & Stop Mode Debugging via JTAG 7 Supported Debugging Modes sorted by Architectures 8

Overview ...... 9

Brief Overview of Documents for New Users ...... 9

Supported Versions ...... 10

Configuration ...... 11 Manual Configuration 11 Automatic Configuration 11 Quick Configuration Guide 12 Hooks & Internals in Linux 12

Features ...... 13 Display of Kernel Resources 13 Task Related Breakpoints 13 Task Context Display 14 MU Support 16 Symbol Autoloader 23 SMP Support 24 Dynamic Task Performance Measurement 25 Task Runtime Statistics 25 Process / thread switch support for ARM using context ID register: 26 Task State Analysis 26 Function Runtime Statistics 27 Linux Specific Menu 28

Basics of HW-based Debugging ...... 31

Debugging Linux Kernel and User Processes ...... 31 Linux Kernel 32 User Processes 34

Linux Commands ...... 46 TASK.CHECK Check awareness integrity 46 TASK.DMESG Display the kernel ring buffer 46 TASK.DTask Display tasks 47 TASK.DTB Display the device tree blob 48 TASK.DTS Display the device tree source 48 TASK.FS Display file system internals 48 TASK.MAPS Display process maps 49 TASK.MMU.SCAN Scan process MMU space 49 TASK.MODule Display kernel modules 49 TASK.Option Set awareness options 50 TASK.Process Display processes 51 TASK.PS Display “ps” output 51 TASK.sYmbol Process/Module symbol management 52 TASK.sYmbol.DELete Unload process symbols & MMU 52 TASK.sYmbol.DELeteLib Unload library symbols 53 TASK.sYmbol.DELeteMod Unload module symbols & MMU 53 TASK.sYmbol.LOAD Load process symbols & MMU 54 TASK.sYmbol.LOADLib Load library symbols 55 TASK.sYmbol.LOADMod Load module symbols & MMU 55 TASK.sYmbol.Option Set symbol management options 56 TASK.TASKState Mark task state words 59 TASK.VMAINFO Display vmalloced areas 59 TASK.Watch Watch processes 60 TASK.Watch.ADD Add process to watch list 60 TASK.Watch.DELete Remove process from watch list 60 TASK.Watch.DISable Disable watch system 61 TASK.Watch.DISableBP Disable process creation breakpoints 61 TASK.Watch.ENable Enable watch system 61 TASK.Watch.ENableBP Enable process creation breakpoints 62 TASK.Watch.Option Set watch system options 62 TASK.Watch.View Show watched processes 63

Linux PRACTICE Functions ...... 65 TASK.ARCHITECTURE() Target architecture 65 TASK.CONFIG(magic) Address of magic number 65 TASK.CONFIG(magicsize) Size of magic number 65 TASK.CURRENT() Magic or space ID of current task 66 TASK.ERROR.CODE() Awareness error code 66 TASK.ERROR.HELP() Awareness error help ID 66 TASK.LIB.ADDRESS() Library load address 66 TASK.LIB.CODESIZE() Library code size 67

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 6 0 TASK.LIB.PATH() Library target path and name 67 TASK.MOD.CODEADDR() Code start address of module 67 TASK.MOD.DATAADDR() Data start of module 68 TASK.MOD.SIZE() Size of module 68 TASK.MOD.MAGIC() Magic value of module 68 TASK.MOD.MCB() Structure address of module 68 TASK.MOD.NAME() Name of module magic 69 TASK.MOD.SECTION() Address of a specified module’s section 69 TASK.MOD.SECNAME() Name of a module section with a given number 69 TASK.MOD.SECADDR() Address of a module section with a given number 70 TASK.OS.VERSION() Version of the used Linux OS 70 TASK.PROC.CODEADDR() Code start address of process 70 TASK.PROC.CODESIZE() Code size of process 70 TASK.PROC.DATAADDR() Data start address of process 71 TASK.PROC.DATASIZE() Data size of process 71 TASK.PROC.LIST() List of processes 72 TASK.PROC.MAGIC() Magic value of process 72 TASK.PROC.MAGIC2SID() Space ID of process 73 TASK.PROC.NAME() Name of process 73 TASK.PROC.NAME2TRACEID() Trace ID of process 73 TASK.PROC.PATH() Path and file name of executable on target 73 TASK.PROC.PSID() Process ID 74 TASK.PROC.SID2MAGIC() Magic value of process 74 TASK.PROC.SPACEID() Space ID of process 74 TASK.PROC.TCB() Control structure address of task 74 TASK.PROC.TRACEID() Trace ID of process 75 TASK.PROC.VMAEND() End address of a process virtual memory area 75 TASK.PROC.VMASTART() Start address of a process virtual memory area 75 TASK.VERSION.BUILD() Build number of Linux awareness 76 TASK.VERSION.DATE() Build date of Linux awareness 76

Error Messages ...... 77

Appendix ...... 78 Appendix A: insmod patch for Linux 2.4 78 Appendix B: ARM context ID thread patch for Linux 2.6 and 3.x 82

Frequently-Asked Questions ...... 85

Training Linux Debugging

Training Linux Debugging ...... (training_rtos_linux.pdf) 1

Prolog ...... 4

Basic Terms on Embedded Linux ...... 5 1.) Linux Components 5

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 6 1 2.) The Linux Awareness 6 3.) Virtual Memory Management in Linux 8 4.) Run-Mode vs. Stop-Mode Debugging 14 5.) Building the Kernel, a Kernel Module and a Simple Demo Application 17

Setting up a Script for Linux-Aware debugging ...... 19 1.) Capture of Commands for a Script 19 2.) Linux Setup-Steps and -Commands 20 3.) Example Linux Setup-Scripts 33

Debugging the Linux Components ...... 36 1.) Debugging Linux Components 36 2.) Linux specific Windows and Features 50

Troubleshooting ...... 54

Linux Trace ...... 55 Overview 55 Example 1: Context ID Trace for ARM 55 Example 2: Using the LOGGER for Task Switch Trace 56

Epilog ...... 60

RTOS Debugger for LiteOS

RTOS Debugger for LiteOS ...... (rtos_liteos.pdf) 1

History ...... 2

Overview ...... 2

Brief Overview of Documents for New Users ...... 3

Supported Versions ...... 3

Configuration ...... 4 Manual Configuration 4 Automatic Configuration 4 Quick Configuration Guide 5 Hooks & Internals in LiteOS 5

Features ...... 6 Display of Kernel Resources 6 Task Stack Coverage 6 Task Related Breakpoints 7 Task Context Display 8 Dynamic Task Performance Measurement 8 Task Runtime Statistics 9 Function Runtime Statistics 10 LiteOS specific Menu 12

LiteOS Commands ...... 13

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 6 2 TASK.Task Display tasks 13 TASK.MUteX Display mutexes 13 TASK.QUEue Display queues 14 TASK.SEMaphore Display semaphores 14 TASK.TIMer Display timers 15

LiteOS PRACTICE Functions ...... 16

Frequently-Asked Questions ...... 16

RTOS Debugger for LynxOS

RTOS Debugger for LynxOS ...... (rtos_lynx.pdf) 1

Overview ...... 3

Brief Overview of Documents for New Users ...... 4

Supported Versions ...... 4

Configuration ...... 5 Manual Configuration 5 Automatic Configuration 5 Quick Configuration Guide 6 Hooks & Internals in LynxOS 6

Features ...... 7 Display of Kernel Resources 7 Task Stack Coverage 7 Task Context Display 8 MMU Support 8 Symbol Autoloader 9 Dynamic Task Performance Measurement 10 Task Runtime Statistics 11 Function Runtime Statistics 11 LynxOS specific Menu 13

Debugging LynxOS Kernel and User Processes ...... 14 LynxOS Kernel 14 User Processes 16

LynxOS Commands ...... 19 TASK.Driver Display drivers 19 TASK.MMU.SCAN Scan process MMU space 20 TASK.Process Display processes 20 TASK.sYmbol Process symbol management 22 TASK.sYmbol.DELete Unload process symbols & MMU 22 TASK.sYmbol.LOAD Load process symbols & MMU 22 TASK.sYmbol.Option Set symbol management options 23 TASK.TASKState Mark thread state words 25

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 6 3 TASK.Thread Display threads 25 TASK.Watch Watch processes 26 TASK.Watch.ADD Add process to watch list 26 TASK.Watch.DELete Remove process from watch list 26 TASK.Watch.DISable Disable watch system 27 TASK.Watch.DISableBP Disable process creation breakpoints 27 TASK.Watch.ENable Enable watch system 27 TASK.Watch.ENableBP Enable process creation breakpoints 28 TASK.Watch.View Show watched processes 28

LynxOS PRACTICE Functions ...... 31

Frequently-Asked Questions ...... 31

RTOS Debugger for MicroC/OS-II

RTOS Debugger for MicroC/OS-II ...... (rtos_ucos.pdf) 1

Overview ...... 3

Brief Overview of Documents for New Users ...... 4

Supported Versions ...... 4

Configuration ...... 5 Manual Configuration 5 Automatic Configuration 7 Quick Configuration Guide 7 Hooks & Internals in µC/OS-II 7

Features ...... 9 Display of Kernel Resources 9 Task Stack Coverage 9 Task Related Breakpoints 10 Task Context Display 11 Dynamic Task Performance Measurement 11 Task Runtime Statistics 12 Task State Analysis 12 Function Runtime Statistics 13 µC/OS-II specific Menu 15

µC/OS-II Commands ...... 16 TASK.Event Display events 16 TASK.Flag Display flags 16 TASK.Memory Display memory partitions 17 TASK.PARtition Display space partitions 17 TASK.PROCess Display MPU processes 18 TASK.Task Display tasks 18 TASK.TASKState Mark task state words 19

µC/OS-II PRACTICE Functions ...... 20

Frequently-Asked Questions ...... 20

RTOS Debugger for MicroC/OS-III

RTOS Debugger for MicroC/OS-III ...... (rtos_ucos3.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 3

Supported Versions ...... 3

Configuration ...... 4 Manual Configuration 4 Automatic Configuration 4 Quick Configuration Guide 5 Hooks & Internals in µC/OS-II3 5

Features ...... 6 Display of Kernel Resources 6 Task Stack Coverage 6 Task Related Breakpoints 7 Task Context Display 8 Dynamic Task Performance Measurement 8 Task Runtime Statistics 9 Task State Analysis 9 Function Runtime Statistics 10 µC/OS-III specific Menu 11

µC/OS-III Commands ...... 13 TASK.eventFLAG Display event flags 13 TASK.MEMory Display memory partitions 13 TASK.MUTEX Display mutexes 14 TASK.Queue Display message queues 14 TASK.SEMaphore Display semaphores 15 TASK.Task Display tasks 15 TASK.TiMeR Display timers 16

µC/OS-III PRACTICE Functions ...... 18

Frequently-Asked Questions ...... 18

RTOS Debugger for MicroC3/Compact

RTOS Debugger for MicroC3/Compact ...... (rtos_uc3cmp.pdf) 1

Overview ...... 2

Supported Versions ...... 3

Configuration ...... 4 Manual Configuration 4 Automatic Configuration 4 Quick Configuration Guide 5 Hooks & Internals in MicroC3/Cmp 5

Features ...... 6 Display of Kernel Resources 6 Task Stack Coverage 6 Task Related Breakpoints 7 Dynamic Task Performance Measurement 8 Task Runtime Statistics 8 Function Runtime Statistics 9 MicroC3/Cmp specific Menu 11

MicroC3/Cmp Commands ...... 12 TASK.CYClic Display cyclic handlers 12 TASK.DaTaQueue Display data queues 12 TASK.FLaG Display event flags 13 TASK.MailBoX Display mailboxes 13 TASK.MemPoolF Display fixed memory pools 14 TASK.SEMaphore Display semaphores 14 TASK.TaSK Display tasks 15

MicroC3/Cmp PRACTICE Functions ...... 16

Frequently-Asked Questions ...... 16

RTOS Debugger for MicroC3/Standard

RTOS Debugger for MicroC3/Standard ...... (rtos_uc3std.pdf) 1

Overview ...... 3

Brief Overview of Documents for New Users ...... 4

Supported Versions ...... 4

Configuration ...... 5 Manual Configuration 5 Automatic Configuration 5 Quick Configuration Guide 6 Hooks & Internals in MicroC3/Std 6

Features ...... 7 Display of Kernel Resources 7 Task Related Breakpoints 7

MicroC3/Std Commands ...... 12 TASK.ALarM Display alarm handlers 12 TASK.CYClic Display cyclic handlers 12 TASK.DaTaQueue Display data queues 13 TASK.FLaG Display event flags 13 TASK.ISR Display interrupt service routines 14 TASK.MailBoX Display mailboxes 14 TASK.MemPoolF Display fixed memory pools 15 TASK.MemPoolL Display variable memory pools 15 TASK.MsgBuFfer Display message buffers 16 TASK.MuTeX Display mutexes 16 TASK.PORt Display rendezvous ports 17 TASK.SEMaphore Display semaphores 17 TASK.TaSK Display tasks 18

MicroC3/Std PRACTICE Functions ...... 19

Frequently-Asked Questions ...... 19

RTOS Debugger for MQX

RTOS Debugger for MQX ...... (rtos_mqx.pdf) 1

Overview ...... 3

Brief Overview of Documents for New Users ...... 4

Supported Versions ...... 4

Configuration ...... 5 Manual Configuration 5 Automatic Configuration 5 Quick Configuration Guide 6 Hooks & Internals in MQX 6

Features ...... 7 Display of Kernel Resources 7 Task Stack Coverage 7 Task Related Breakpoints 8 Task Context Display 9 Dynamic Task Performance Measurement 10 Task Runtime Statistics 10 Task State Analysis 11 Function Runtime Statistics 12

MQX Commands ...... 15 TASK.EVent Display events 15 TASK.KLog Display kernel log 15 TASK.LWEvent Display light weight events 16 TASK.LWMEMPool Display light weight memory pools 16 TASK.LWMsgQ Display light weight message queues 17 TASK.LWSem Display light weight semaphores 17 TASK.MEMPool Display memory pools 18 TASK.MeSsaGe.POOL Display message pools 18 TASK.MeSsaGe.QUEUE Display message queues 19 TASK.MuteX Display mutexes 20 TASK.SEMaphore Display semaphores 20 TASK.TASK Display tasks 21 TASK.TASKQueue Display task queues 21 TASK.TASKState Mark task state words 22

MQX PRACTICE Functions ...... 23

Frequently-Asked Questions ...... 23

RTOS Debugger for MTOS-UX

RTOS Debugger for MTOS-UX ...... (rtos_mtos.pdf) 1

Overview ...... 3

Brief Overview of Documents for New Users ...... 3

Configuration ...... 5 Manual Configuration 5 Automatic Configuration 6 Hooks & Internals of MTOS-UX 6

Features ...... 7 SYSC Terminal Emulation 7 Display of Kernel Resources 8 Task Stack Coverage 8 Task Runtime Statistics 9 Task State Analysis 9 Function Runtime Statistics 10 MTOS-UX specific Menu 11

MTOS-UX Commands ...... 13 TASK.DispEvent Display global event flags 13 TASK.DispFixed Display fixed pools 13 TASK.DispmBuff Display message buffers 14 TASK.DispMbx Display mailboxes 14

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 6 8 TASK.DispPool Display common pools 15 TASK.DispSem Display semaphores 16 TASK.DispsVar Display shared variables 16 TASK.DispTask Display tasks 17 TASK.DispTIme Display time & TOD 18 TASK.DispUnit Display peripheral units 18 TASK.MAP Mapping suggestion 18 TASK.TASKState Mark task state words 19

MTOS-UX PRACTICE Functions ...... 20

Frequently-Asked Questions ...... 20

RTOS Debugger for NetBSD

RTOS Debugger for NetBSD ...... (rtos_netbsd.pdf) 1

Overview ...... 3

Brief Overview of Documents for New Users ...... 4

Supported Versions ...... 4

Configuration ...... 5 Manual Configuration 5 Automatic Configuration 5 Quick Configuration Guide 6 Hooks & Internals in NetBSD 6

Features ...... 7 Display of Kernel Resources 7 Task Related Breakpoints 7 Task Context Display 8 MMU Support 9 Dynamic Task Performance Measurement 10 Task Runtime Statistics 10 Function Runtime Statistics 11 NetBSD specific Menu 12

Debugging NetBSD Kernel and User Processes ...... 13 NetBSD Kernel 13 User Processes 14

NetBSD Commands ...... 16 TASK.LWP Display LWPs 16 TASK.MMU.SCAN Scan process MMU space 16 TASK.Process Display processes 17

NetBSD PRACTICE Functions ...... 18

Frequently-Asked Questions ...... 18

RTOS Debugger for NORTi ...... (rtos_norti.pdf) 1

Overview ...... 3

Brief Overview of Documents for New Users ...... 4

Supported Versions ...... 4

Configuration ...... 5 Manual Configuration 5 Automatic Configuration 5 Quick Configuration Guide 6 Hooks & Internals in NORTi 6

Features ...... 7 Display of Kernel Resources 7 Task Stack Coverage 7 Task Related Breakpoints 8 Dynamic Task Performance Measurement 9 Task Runtime Statistics 9 Task State Analysis 10 Function Runtime Statistics 11 NORTi specific Menu 14

NORTi Commands ...... 15 TASK.ALarM Display alarm handlers 15 TASK.CYClic Display cyclic handlers 15 TASK.DaTaQueue Display data queues 15 TASK.FLaG Display event flags 16 TASK.ISR Display interrupt service routines 16 TASK.MailBoX Display mailboxes 17 TASK.MemPoolF Display fixed memory pools 17 TASK.MemPoolL Display variable memory pools 18 TASK.MsgBuFfer Display message buffers 18 TASK.MuTeX Display mutexes 19 TASK.PORt Display rendezvous ports 19 TASK.SEMaphore Display semaphores 20 TASK.TaSK Display tasks 20

NORTi PRACTICE Functions ...... 21

Frequently-Asked Questions ...... 21

RTOS Debugger for Nucleus PLUS

RTOS Debugger for Nucleus PLUS ...... (rtos_nucleus.pdf) 1

Overview ...... 3

Supported Versions ...... 4

Configuration ...... 5 Manual Configuration 5 Automatic Configuration 6 Quick Configuration Guide 6 Hooks & Internals of Nucleus PLUS 7

Features ...... 8 DBUG+ Terminal Emulation 8 Display of Kernel Resources 8 Display of History Component 9 Task Stack Coverage 9 Task Related Breakpoints 10 Task Context Display 11 SMP Support 11 Dynamic Task Performance Measurement 12 Task Runtime Statistics 12 Task State Analysis 13 Function Runtime Statistics 14 Nucleus specific Menu 16 Debugging Nucleus Processes 16

Nucleus Commands ...... 18 TASK.DynMem Display dynamic memory status 18 TASK.EventStat Display event group status 18 TASK.HIsr Display HISRs 19 TASK.HISTory Display Nucleus history 19 TASK.MbxStat Display mailbox status 20 TASK.PartMem Display partition memory status 20 TASK.PipeStat Display pipe status 21 TASK.ProcList Display process list 21 TASK.QueueStat Display queue status 22 TASK.SemaStat Display semaphore status 23 TASK.TaskStat Display task status 23 TASK.TASKState Mark task state words 24 TASK.TImerstat Display timer status 25

Nucleus PLUS PRACTICE Functions ...... 26

Frequently-Asked Questions ...... 26

RTOS Debugger for NuttX

RTOS Debugger for NuttX ...... (rtos_nuttx.pdf) 1

Brief Overview of Documents for New Users ...... 2

Supported Versions ...... 3

Configuration ...... 4 Manual Configuration 4 Automatic Configuration 4 Quick Configuration Guide 5 Hooks & Internals in NuttX 5

NuttX Commands ...... 13 TASK.Task Display tasks 13 TASK.BuiLTinApp Display built-in applications 13

NuttX PRACTICE Functions ...... 14

Frequently-Asked Questions ...... 14

RTOS Debugger for OKL4

RTOS Debugger for OKL4 ...... (rtos_okl4.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 3

Supported Versions ...... 3

Configuration ...... 4 Manual Configuration 4 Automatic Configuration 4 Quick Configuration Guide 5 Hooks & Internals in OKL4 5

Features ...... 6 Display of Kernel Resources 6 Task Related Breakpoints 6 Task Context Display 7 MMU Support 8 Dynamic Task Performance Measurement 8

OKL4 Commands ...... 12 TASK.CList Display capability lists 12 TASK.MMU.SCAN Scan MMU address space 12 TASK.Space Display address spaces 13 TASK.Thread Display threads 14

OKL4 PRACTICE Functions ...... 15

Frequently-Asked Questions ...... 15

RTOS Debugger for OS21

RTOS Debugger for OS21 ...... (rtos_os21.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 3

Supported Versions ...... 3

Configuration ...... 4 Manual Configuration 4 Automatic Configuration 4 Quick Configuration Guide 5 Hooks & Internals in OS21 5

Features ...... 6 Display of Kernel Resources 6 Task Stack Coverage 6 Task Related Breakpoints 7 Task Context Display 8 Dynamic Task Performance Measurement 8 Task Runtime Statistics 9 Task State Analysis 9 Function Runtime Statistics 10 OS21 specific Menu 12

OS21 Commands ...... 13 TASK.EVenT Display event groups 14 TASK.MeSsaGe Display message queue 15 TASK.MuTeX Display mutexes 16 TASK.PARTition Display partition 17 TASK.SEMaphore Display semaphores 17 TASK.Task Display tasks 18 TASK.TASKState Mark task state words 19

Frequently-Asked Questions ...... 20

RTOS Debugger for OS-9

RTOS Debugger for OS-9 ...... (rtos_os9.pdf) 1

Overview ...... 3

Brief Overview of Documents for New Users ...... 4

Configuration ...... 5 Hooks in OS-9 6

Features ...... 7 Display of Kernel Resources 7 Symbol Relocation 7 Function Runtime Statistics 8 Task Runtime Analysis 8 Task State Analysis 9 Task Selective Debugging 9 System Calls 9

OS-9 Commands ...... 10 sYmbol.RELOCate.Auto Control automatic relocation 10 sYmbol.RELOCate.Base Define base address 10 sYmbol.RELOCate.List List relocation info 11 sYmbol.RELOCate.Magic Define program magic 11 sYmbol.RELOCate.Passive Define passive base address 12 TASK.ALARMS Alarm table 13 TASK.CCTL Cache control 13 TASK.DEVS Device table 14 TASK.EVENTS Event table 14 TASK.EXIT Exit system call 14 TASK.IRQS Interrupt polling table 15 TASK.MDIR Module table 15 TASK.MFREE Free memory 16 TASK.PROCS Process table 16 TASK.PROCSL Extended process table 17 TASK.QUEUES Process queues 18 TASK.SEND Send signal 18 TASK.SysCall Generic system call 18 TASK.SYSGLOB Display time 19

OS9 specific Functions ...... 20

Frequently-Asked Questions ...... 20

RTOS Debugger for OSE Classic ...... (rtos_ose_classic.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 3

Supported Version ...... 3

Configuration ...... 4 Manual Configuration 5 Automatic Configuration 6 Quick Configuration Guide 6 Hooks & Internals in OSE Classic 6

Features ...... 7 Display of Kernel Resources 7 Task Runtime Statistics 7 Task State Analysis 8 Function Runtime Statistics 8 System Calls 8 OSE Classic specific Menu 9

OSE Classic Commands ...... 10 TASK.DProc Process table 10 TASK.DPS Process statistics table 11 TASK.DQ Signal queue table 12 TASK.DS Signal names 12 TASK.SysCall Execute OS68 system call 13 TASK.TASKState Mark task state words 13

OSE Classic PRACTICE Functions ...... 14

Frequently-Asked Questions ...... 14

RTOS Debugger for OSE Delta

RTOS Debugger for OSE Delta ...... (rtos_ose_delta.pdf) 1

Overview ...... 3

Brief Overview of Documents for New Users ...... 4

Supported Versions ...... 4

Configuration ...... 5 Manual Configuration 5 Automatic Configuration 6 Quick Configuration Guide 6 Hooks & Internals in OSE Delta 7

Features ...... 8

©1989-2018 Lauterbach GmbH TRACE32 Directory 1 7 5 Terminal Emulation for dbgprintf 8 Display of Kernel Resources 8 Task Stack Coverage 8 Task Related Breakpoints 9 Task Context Display 10 MMU Support 11 SMP Support 13 Dynamic Task Performance Measurement 13 Task Runtime Statistics 14 Task State Analysis 14 Function Runtime Statistics 15 OSE Delta specific Menu 16 Debugging OSE Load Modules 17

OSE Delta Commands ...... 21 TASK.DBIOS Display bios modules 21 TASK.DBLock Display blocks 21 TASK.DConf Display kernel configuration 22 TASK.DLoadMod Display load modules 22 TASK.DPOOL Display pools 23 TASK.DProc Display processes 24 TASK.DProGram Display loaded programs 25 TASK.MMU.SCAN Scan OSE MMU 26 TASK.RAMLOG Display ramlog 26 TASK.SYMbol Symbol handling of load modules 27 TASK.TASKState Mark task state words 28 PRACTICE Functions 29

Frequently-Asked Questions ...... 29

RTOS Debugger for OSE Epsilon

RTOS Debugger for OSE Epsilon ...... (rtos_ose_epsilon.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 3

Supported Versions ...... 3

Configuration ...... 4 Manual Configuration 4 Automatic Configuration 4 Quick Configuration Guide 5 Hooks & Internals in OSE Epsilon 5

Features ...... 6 Display of Kernel Resources 6

OSE Epsilon Commands ...... 11 TASK.DProc Display processes 11 TASK.DQueue Display signal queue 11 TASK.TASKState Mark task state words 12

OSE Epsilon PRACTICE Functions ...... 13

Frequently-Asked Questions ...... 13

RTOS Debugger for OSEck

RTOS Debugger for OSEck ...... (rtos_oseck.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 3

Supported Versions ...... 3

Configuration ...... 4 Manual Configuration 4 Automatic Configuration 4 Quick Configuration Guide 5 Hooks & Internals in OSEck 5

Features ...... 6 Display of Kernel Resources 6 Task Stack Coverage 6 Task Related Breakpoints 7 Dynamic Task Performance Measurement 8 Task Runtime Statistics 9 Task State Analysis 10 Function Runtime Statistics 11 OSEck specific Menu 11

OSEck Commands ...... 12 TASK.PooL Display pools 12 TASK.Process Display processes 13 TASK.SysInfo Display system information 14

OSEck PRACTICE Functions ...... 15

Frequently-Asked Questions ...... 15

RTOS Debugger for OSEK/ORTI

RTOS Debugger for OSEK/ORTI ...... (rtos_orti.pdf) 1

Overview ...... 2

Brief Overview of Documents for New Users ...... 2

Supported Versions ...... 3

Configuration ...... 4 Quick Configuration Guide 4 Hooks and Internals in ORTI 5

Features ...... 7 Display of Kernel Resources 7 Task Stack Coverage 7 Task Related Breakpoints 8 Task Context Display 9 Dynamic Task Performance Measurement 9 Task Runtime Statistics 10 Task State Analysis 11 Service Runtime Statistics 11 ISR2 Runtime Statistics 12 Function Runtime Statistics 13 OSEK/ORTI specific Menu 15

ORTI Commands ...... 16 TASK.D