General Commands Reference Guide T TRACE32 Online Help TRACE32 Directory TRACE32 Index TRACE32 Documents ...................................................................................................................... General Commands ...................................................................................................................... General Commands Reference Guide T ................................................................................... 1 History ...................................................................................................................................... 14 TargetSystem ........................................................................................................................... 15 TargetSystem TRACE32 PowerView instances 15 TargetSystem.NewInstance Start new TRACE32 PowerView instance 16 TargetSystem.state Show overview of multicore system 18 TASK ......................................................................................................................................... 23 TASK OS Awareness for TRACE32 23 Overview TASK 23 TASK.ACCESS Control memory access 28 TASK.ATTACH Attach to a running process 28 TASK.Break Stop the execution of a single task or thread 28 TASK.CACHEFLUSH Reread task list 29 TASK.CONFIG Configure OS Awareness 29 TASK.COPYDOWN Copy file from host into target 30 TASK.COPYUP Copy file from target into host 31 TASK.CreateExtraID Create a virtual task 31 TASK.CreateID Create virtual task 31 TASK.DELete Delete file from target 32 TASK.DeleteID Delete virtual task 32 TASK.DETACH Detach from task 32 TASK.Go Start the execution of a single task or thread 33 TASK.INSTALL Deprecated 33 TASK.KILL End task 33 TASK.List Information about tasks 34 TASK.List.MACHINES List machines 34 TASK.List.SPACES List MMU spaces 35 TASK.List.tasks List all running tasks 36 TASK.List.TREE Display tasks in a tree structure 38 TASK.ListID List virtual tasks 39 TASK.NAME Translation of task magic number to task name 40 TASK.NAME.DELete Delete a task name table entry 40 ©1989-2021 Lauterbach GmbH General Commands Reference Guide T 1 TASK.NAME.RESet Reset task name table 40 TASK.NAME.Set Set a task name table entry 41 TASK.NAME.view Show task name translation table 41 TASK.ORTI AUTOSAR/OSEK support 42 TASK.ORTI.CPU Set OSEK SMP CPU number 42 TASK.ORTI.load Configure OS Awareness for OSEK/ORTI 42 TASK.ORTI.NOSTACK Exclude an ORTI task from stack evaluation 43 TASK.ORTI.SPLITSTACK Split stack analysis of idle ORTI task to cores 44 TASK.RESet Reset OS Awareness 45 TASK.RUN Load task 45 TASK.select Display context of specified task 46 TASK.SETDIR Set the awareness directory 47 TASK.STacK Stack usage coverage 48 TASK.STacK.ADD Add stack space coverage 48 TASK.STacK.DIRection Define stack growth direction 50 TASK.STacK.Init Initialize unused stack space 50 TASK.STacK.PATtern Define stack check pattern 51 TASK.STacK.PATternGAP Define check pattern gap 52 TASK.STacK.ReMove Remove stack space coverage 52 TASK.STacK.RESet Reset stack coverage 53 TASK.STacK.view Open stack space coverage 54 TCB ........................................................................................................................................... 56 TCB Trace control block 56 TCB.AllBranches Broadcast all branches 57 TCB.CPU Broadcast information for specified CPU only 57 TCB.CycleAccurate Cycle accurate tracing 58 TCB.DataTrace Broadcast specified address and data information 59 TCB.EX Broadcast exception level information 60 TCB.FCR Broadcast function call-return information 60 TCB.IM Broadcast instruction cache miss information 60 TCB.InstructionCompletionSizeBits Specify size of completion message 61 TCB.KE Broadcast kernel mode information 61 TCB.LSM Broadcast load store data cache information 62 TCB.OFF Switch TCB off 62 TCB.ON Switch TCB on 62 TCB.PCTrace Broadcast program counter trace 63 TCB.PortMode Specify trace clock ratio 64 TCB.PortWidth Specify trace port width 64 TCB.Register Display TCB control register 65 TCB.RESet Reset TCB setup to default 66 TCB.SourceSizeBits Specify number of bit for core information in trace 66 TCB.SRC Control selective trace 66 TCB.STALL Stall CPU for complete trace 67 ©1989-2021 Lauterbach GmbH General Commands Reference Guide T 2 TCB.state Display TCB setup 67 TCB.SV Broadcast supervisor mode information 68 TCB.SyncPeriod Specify TCB sync period 68 TCB.TC Broadcast information for specified HW thread 69 TCB.ThreadSizeBits Specify number of bit for thread information in trace 69 TCB.Type Specify TCB type 70 TCB.UM Broadcast user mode information 70 TCB.Version Specify trace cell version 71 TERM ........................................................................................................................................ 72 TERM Terminal emulation 72 Overview TERM 72 Interface Routines 72 Interface Routines (EPROM Simulator) 73 Interface Routines (Single Character Modes) 74 Interface Routines (Buffered Modes) 74 Interface Routines (Serial Line Debugger) 74 Interface Routines (Special Hardware, JTAG) 74 Functions 75 Fast Data Write 75 Interface Routines 75 TERM.CLEAR Clear terminal window 76 TERM.CLOSE Close files 76 TERM.CMDLINE Specify a command line 76 TERM.GATE Terminal with virtual hosting 77 TERM.HARDCOPY Print terminal window contents 77 TERM.HEAPINFO Define memory heap parameters 78 TERM.LocalEcho Enables/disables local echo for new terminal windows 78 TERM.METHOD Select terminal protocol 79 TERM.METHOD2 Select additional terminal protocol 82 TERM.Mode Define terminal type 84 TERM.Out Send data to virtual terminal 85 TERM.OutBREAK Send serial break 85 TERM.PIPE Connect terminal to named pipe 86 TERM.PipeREAD Connect terminal input to named pipe 86 TERM.PipeWRITE Connect terminal output to named pipe 86 TERM.Protocol Select terminal protocol 87 TERM.PULSE Enable pulse generator for transfers 87 TERM.Rate Define polling rate 87 TERM.READ Get terminal input from file 88 TERM.RESet Reset terminal parameters 88 TERM.SCROLL Enable automatic scrolling for terminal window 88 TERM.SIZE Define size of terminal window 89 TERM.STDIN Get terminal input from file 89 ©1989-2021 Lauterbach GmbH General Commands Reference Guide T 3 TERM.TCP Route terminal input/output to TCP port 90 TERM.TELNET Open TELNET terminal window 90 TERM.TRIGGER Trigger on string in terminal window 91 TERM.Vector Define interrupt vectors 92 TERM.view Terminal display 93 TERM.WRITE Write terminal output to file 94 TPIU .......................................................................................................................................... 95 TPIU Trace Port Interface Unit (TPIU) 95 Overview TPIU 95 TPIU.CLEAR Re-write the TPIU registers 96 TPIU.IGNOREZEROS Workaround for a special chip 96 TPIU.NOFLUSH Workaround for a chip bug affecting TPIU flush 96 TPIU.PortClock Inform debugger about HSSTP trace frequency 97 TPIU.PortMode Select the operation mode of the TPIU 98 TPIU.PortSize Select interface type and port size of the TPIU 99 TPIU.RefClock Set up reference clock for HSSTP 100 TPIU.Register Display TPIU registers 101 TPIU.RESet Reset TPIU settings 101 TPIU.state Display TPIU configuration window 102 TPIU.SWVPrescaler Set up SWV prescaler 102 TPIU.SWVZEROS Workaround for a chip bug 103 TPIU.SyncPeriod Set period of sync packet injection 104 TPU ........................................................................................................................................... 105 TPU.BASE Base address 105 TPU.Break Break TPU 105 TPU.Dump Memory display 105 TPU.Go Start TPU 105 TPU.List View microcode 105 TPU.ListEntry Table display 105 TPU.Register.ALL Register operation mode 105 TPU.Register.NEWSTEP New debugging mode 106 TPU.Register.Set Register modification 106 TPU.Register.view Register display 106 TPU.RESet Disable TPU debugger 106 TPU.SCAN Scanning TPU 106 TPU.SELect Select TPU for debugging 106 TPU.Step Single step TPU 106 TPU.view View TPU channels 106 Trace ......................................................................................................................................... 107 Trace Trace configuration and display 107 Overview Trace 108 About the Command Placeholder <trace> 109 ©1989-2021 Lauterbach GmbH General Commands Reference Guide T 4 What to know about the TRACE32 default settings for Trace.METHOD 109 Types of Replacements for <trace> 111 Replacing <trace> with a Trace Method - Examples 111 Replacing <trace> with a Trace Evaluation - Example 112 Replacing <trace> with RTS for Real-time Profiling - Example 113 Replacing <trace> with Trace Source and Trace Method - Examples 114 How to access the trace sources in TRACE32 116 List of <trace> Command Groups consisting of <trace_source><trace_method> 117 Related Trace Command Groups 120 <trace>.ACCESS Define access path to program code for trace decoding 121 <trace>.Arm Arm the trace 123 <trace>.AutoArm Arm automatically 124 <trace>.AutoFocus Calibrate AUTOFOCUS preprocessor 124 Preprocessor with AUTOFOCUS Technology 127 <trace>.AutoInit Automatic initialization 129 <trace>.AutoStart Automatic start 129 <trace>.AutoTEST Continuous measurement 130 <trace>.BookMark Set a bookmark in trace listing 130 <trace>.BookMarkToggle Toggles a single trace bookmark 132 <trace>.Chart Display trace contents graphically 133 Parameters 133 Options 134 Drag and Drop 137 <trace>.Chart.Address Time between program events as a chart 142 <trace>.Chart.AddressGROUP Address group time chart 144 <trace>.Chart.ChildTREE Display callee context of a function as chart 145 <trace>.Chart.DatasYmbol