general commands reference guide l - lauterbach · la.file load a file into the file trace buffer...
TRANSCRIPT
General Commands Reference Guide L
TRACE32 Online Help
TRACE32 Directory
TRACE32 Index
TRACE32 Documents ......................................................................................................................
General Commands ......................................................................................................................
General Commands Reference Guide L ................................................................................... 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
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 Plot trace data against time 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
General Commands Reference Guide L 1 ©1989-2019 Lauterbach GmbH
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
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
General Commands Reference Guide L 2 ©1989-2019 Lauterbach GmbH
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
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.Hll Export source listing 34
List.EXPORT.Mix Export source and disassembler listing 35
List.Hll Display source 37
List.Java Display Java byte code 38
List.Mix Disassembler and source 40
LOGGER ................................................................................................................................... 41
LOGGER tbd. 41
Trace Method LOGGER 41
LOGGER Trace Commands .................................................................................................... 43
LOGGER.ADDRESS Software trace address 43
LOGGER.Arm Arm the trace 43
LOGGER.AutoArm Arm automatically 43
LOGGER.AutoFocus Calibrate AUTOFOCUS preprocessor 43
LOGGER.AutoInit Automatic initialization 43
General Commands Reference Guide L 3 ©1989-2019 Lauterbach GmbH
LOGGER.BookMark Set a bookmark in trace listing 43
LOGGER.Chart Display trace contents graphically 44
LOGGER.Chart.DistriB Distribution display graphically 44
LOGGER.Chart.Func Function activity chart 44
LOGGER.Chart.GROUP Group activity chart 44
LOGGER.Chart.Line Graphical HLL lines analysis 44
LOGGER.Chart.sYmbol Symbol analysis 44
LOGGER.Chart.TASK Task activity chart 44
LOGGER.Chart.TASKFunc Task related function run-time analysis (legacy) 45
LOGGER.Chart.TASKSRV Service routine run-time analysis 45
LOGGER.Chart.TASKState Task state analysis 45
LOGGER.Chart.VarState Variable activity chart 45
LOGGER.ComPare Compare trace contents 45
LOGGER.DISable Disable the trace 45
LOGGER.DRAW Plot trace data against time 45
LOGGER.EXPORT Export trace data for processing in other applications 46
LOGGER.FILE Load a file into the file trace buffer 46
LOGGER.Find Find specified entry in trace 46
LOGGER.FindAll Find all specified entries in trace 46
LOGGER.FindChange Search for changes in trace flow 46
LOGGER.FLOWPROCESS Process flowtrace 46
LOGGER.FLOWSTART Restart flowtrace processing 46
LOGGER.GOTO Move cursor to specified trace record 47
LOGGER.Init Initialize trace 47
LOGGER.List List trace contents 47
LOGGER.ListNesting Analyze function nesting 47
LOGGER.ListVar List variable recorded to trace 47
LOGGER.LOAD Load trace file for offline processing 47
LOGGER.Mode Set the trace operation mode 47
LOGGER.OFF Switch off 47
LOGGER.PROfileChart Profile charts 48
LOGGER.PROfileChart.DIStance Time interval for a single event 48
LOGGER.PROfileChart.DURation Time between two events 48
LOGGER.PROfileChart.GROUP Group profile chart 48
LOGGER.PROfileChart.Rate Event frequency 48
LOGGER.PROTOcol Protocol analysis 48
LOGGER.PROTOcol.Chart Graphic display for user-defined protocol 48
LOGGER.PROTOcol.Draw Graphic display for user-defined protocol 49
LOGGER.PROTOcol.EXPORT Export trace buffer for user-defined protocol 49
LOGGER.PROTOcol.Find Find in trace buffer for user-defined protocol 49
LOGGER.PROTOcol.List Display trace buffer for user-defined protocol 49
LOGGER.PROTOcol.STATistic Display statistics for user-defined protocol 49
LOGGER.REF Set reference point for time measurement 49
General Commands Reference Guide L 4 ©1989-2019 Lauterbach GmbH
LOGGER.RESet Reset command 49
LOGGER.SAVE Save trace for postprocessing in TRACE32 50
LOGGER.SelfArm Automatic restart of trace recording 50
LOGGER.SIZE Define buffer size 50
LOGGER.SnapShot Restart trace capturing once 50
LOGGER.state Display trace configuration window 50
LOGGER.STATistic Statistic analysis 50
LOGGER.STATistic.BondOut Bondout mode 50
LOGGER.STATistic.DIStance Time interval for a single event 51
LOGGER.STATistic.DistriB Distribution analysis 51
LOGGER.STATistic.DURation Time between two events 51
LOGGER.STATistic.Func Nesting function runtime analysis 51
LOGGER.STATistic.GROUP Group run-time analysis 51
LOGGER.STATistic.Ignore Ignore false records in statistic 51
LOGGER.STATistic.InterruptIsFunction Statistics interrupt processing 51
LOGGER.STATistic.Line HLL-line analysis 52
LOGGER.STATistic.LINKage Per caller statistic of function 52
LOGGER.STATistic.Measure Analyze the performance of a single signal 52
LOGGER.STATistic.PreFetch Prefetch detection 52
LOGGER.STATistic.Sort Specify sorting criterion for statistic commands 52
LOGGER.STATistic.sYmbol Flat run-time analysis 52
LOGGER.STATistic.TASK Task activity statistic 52
LOGGER.STATistic.TASKFunc Task specific function run-time analysis 53
LOGGER.STATistic.TASKKernel Task analysis with kernel markers (flat) 53
LOGGER.STATistic.TASKSRV Analysis of time in OS service routines 53
LOGGER.STATistic.TASKState Performance analysis 53
LOGGER.STATistic.TASKTREE Tree display of task specific functions 53
LOGGER.STATistic.TREE Tree display of nesting function run-time analysis 53
LOGGER.STATistic.Use Use records 53
LOGGER.TimeStamp Configure timestamp usage of LOGGER trace 54
LOGGER.Timing Waveform of trace buffer 54
LOGGER.TRACK Set tracking record 54
LOGGER.View Display single record 54
LOGGER.ZERO Align timestamps of trace and timing analyzers 54
LUA ........................................................................................................................................... 55
LUA Support for the Lua script language 55
LUA.List List the current Lua scripts 55
LUA.LOAD Load a Lua script to debugger 56
LUA.RESet Reset the Lua context 56
LUA.RUN Execute a Lua script 57
LUA.SET Modify the Lua input buffer 58
LUA.ShowInput Show current content of the input buffer 58
LUA.ShowOutput Show current content of the output buffer 59
General Commands Reference Guide L 5 ©1989-2019 Lauterbach GmbH
LUA.UNLOAD Remove a Lua script from the debugger 59
Usage:
(B) command only available for ICD(E) command only available for ICE(F) command only available for FIRE
General Commands Reference Guide L 6 ©1989-2019 Lauterbach GmbH
General Commands Reference Guide L
Version 06-Nov-2019
General Commands Reference Guide L 7 ©1989-2019 Lauterbach GmbH
LA
LA Logic analyzer
tbd.
See also
■ Trace.METHOD
▲ ’LA - Trace Commands’ in ’General Commands Reference Guide L’▲ ’Release Information’ in ’Release History’
Trace Method LA
The trace method LA is used for remote control of logic analyzer systems.
General Commands Reference Guide L 8 ©1989-2019 Lauterbach GmbH
LA - Trace Commands
LA.ACCESS Define access path to source code for trace decoding
See command <trace>.ACCESS in 'General Commands Reference Guide T' (general_ref_t.pdf, page 122).
LA.Arm Arm the trace
See command <trace>.Arm in 'General Commands Reference Guide T' (general_ref_t.pdf, page 125).
LA.AutoArm Arm automatically
See command <trace>.AutoArm in 'General Commands Reference Guide T' (general_ref_t.pdf, page 126).
LA.AutoFocus Calibrate AUTOFOCUS preprocessor
See command <trace>.AutoFocus in 'General Commands Reference Guide T' (general_ref_t.pdf, page 126).
LA.AutoInit Automatic initialization
See command <trace>.AutoInit in 'General Commands Reference Guide T' (general_ref_t.pdf, page 131).
LA.AutoTEST Continuous measurement
See command <trace>.AutoTEST in 'General Commands Reference Guide T' (general_ref_t.pdf, page 132).
General Commands Reference Guide L 9 ©1989-2019 Lauterbach GmbH
LA.BookMark Set a bookmark in trace listing
See command <trace>.BookMark in 'General Commands Reference Guide T' (general_ref_t.pdf, page 134).
LA.Chart Display trace contents graphically
See command <trace>.Chart in 'General Commands Reference Guide T' (general_ref_t.pdf, page 138).
LA.Chart.Func Function activity chart
See command <trace>.Chart.Func in 'General Commands Reference Guide T' (general_ref_t.pdf, page 151).
LA.Chart.GROUP Group activity chart
See command <trace>.Chart.GROUP in 'General Commands Reference Guide T' (general_ref_t.pdf, page 152).
LA.Chart.Line Graphical HLL lines analysis
See command <trace>.Chart.Line in 'General Commands Reference Guide T' (general_ref_t.pdf, page 154).
LA.Chart.sYmbol Symbol analysis
See command <trace>.Chart.sYmbol in 'General Commands Reference Guide T' (general_ref_t.pdf, page 156).
LA.Chart.TASK Task activity chart
See command <trace>.Chart.TASK in 'General Commands Reference Guide T' (general_ref_t.pdf, page 160).
General Commands Reference Guide L 10 ©1989-2019 Lauterbach GmbH
LA.Chart.TASKFunc Task related function run-time analysis (legacy)
See command <trace>.Chart.TASKFunc in 'General Commands Reference Guide T' (general_ref_t.pdf, page 161).
LA.Chart.TASKSRV Service routine run-time analysis
See command <trace>.Chart.TASKSRV in 'General Commands Reference Guide T' (general_ref_t.pdf, page 163).
LA.Chart.TASKState Task state analysis
See command <trace>.Chart.TASKState in 'General Commands Reference Guide T' (general_ref_t.pdf, page 164).
LA.Chart.VarState Variable activity chart
See command <trace>.Chart.VarState in 'General Commands Reference Guide T' (general_ref_t.pdf, page 167).
LA.ComPare Compare trace contents
See command <trace>.ComPare in 'General Commands Reference Guide T' (general_ref_t.pdf, page 171).
LA.DISable Disable the trace
See command <trace>.DISable in 'General Commands Reference Guide T' (general_ref_t.pdf, page 176).
LA.DRAW Plot trace data against time
See command <trace>.DRAW in 'General Commands Reference Guide T' (general_ref_t.pdf, page 180).
General Commands Reference Guide L 11 ©1989-2019 Lauterbach GmbH
LA.EXPORT Export trace data for processing in other applications
See command <trace>.EXPORT in 'General Commands Reference Guide T' (general_ref_t.pdf, page 191).
LA.FILE Load a file into the file trace buffer
See command <trace>.FILE in 'General Commands Reference Guide T' (general_ref_t.pdf, page 205).
LA.Find Find specified entry in trace
See command <trace>.Find in 'General Commands Reference Guide T' (general_ref_t.pdf, page 207).
LA.FindAll Find all specified entries in trace
See command <trace>.FindAll in 'General Commands Reference Guide T' (general_ref_t.pdf, page 211).
LA.FindChange Search for changes in trace flow
See command <trace>.FindChange in 'General Commands Reference Guide T' (general_ref_t.pdf, page 212).
LA.FLOWPROCESS Process flowtrace
See command <trace>.FLOWPROCESS in 'General Commands Reference Guide T' (general_ref_t.pdf, page 213).
LA.FLOWSTART Restart flowtrace processing
See command <trace>.FLOWSTART in 'General Commands Reference Guide T' (general_ref_t.pdf, page 213).
General Commands Reference Guide L 12 ©1989-2019 Lauterbach GmbH
LA.GOTO Move cursor to specified trace record
See command <trace>.GOTO in 'General Commands Reference Guide T' (general_ref_t.pdf, page 216).
LA.IMPORT Import trace information
See command <trace>.IMPORT in 'General Commands Reference Guide T' (general_ref_t.pdf, page 218).
LA.IMPORT.CoreByteStream Import pure single core trace data
See command <trace>.IMPORT.CoreByteStream in 'General Commands Reference Guide T' (general_ref_t.pdf, page 220).
LA.IMPORT.ETB Import on-chip trace data
See command <trace>.IMPORT.ETB in 'General Commands Reference Guide T' (general_ref_t.pdf, page 221).
LA.IMPORT.flow Import bus trace data
See command <trace>.IMPORT.flow in 'General Commands Reference Guide T' (general_ref_t.pdf, page 221).
LA.IMPORT.GUESSWRAP Guess wrap pointer
See command <trace>.IMPORT.GUESSWRAP in 'General Commands Reference Guide T' (general_ref_t.pdf, page 222).
LA.IMPORT.STP Import STP recording from file (nibble)
See command <trace>.IMPORT.STP in 'General Commands Reference Guide T' (general_ref_t.pdf, page 222).
General Commands Reference Guide L 13 ©1989-2019 Lauterbach GmbH
LA.IMPORT.STPByteStream Import STP recording from file (byte)
See command <trace>.IMPORT.STPByteStream in 'General Commands Reference Guide T' (general_ref_t.pdf, page 223).
LA.IMPORT.TraceFile Import trace data where processing has failed
See command <trace>.IMPORT.TraceFile in 'General Commands Reference Guide T' (general_ref_t.pdf, page 223).
LA.IMPORT.TracePort Import off-chip trace data
See command <trace>.IMPORT.TracePort in 'General Commands Reference Guide T' (general_ref_t.pdf, page 224).
LA.IMPORT.VCD Import recorded signals in VCD file format
See command <trace>.IMPORT.VCD in 'General Commands Reference Guide T' (general_ref_t.pdf, page 224).
LA.IMPORT.WRAP Define wrap pointer
See command <trace>.IMPORT.WRAP in 'General Commands Reference Guide T' (general_ref_t.pdf, page 225).
LA.Init Initialize trace
See command <trace>.Init in 'General Commands Reference Guide T' (general_ref_t.pdf, page 226).
LA.List List trace contents
See command <trace>.List in 'General Commands Reference Guide T' (general_ref_t.pdf, page 230).
General Commands Reference Guide L 14 ©1989-2019 Lauterbach GmbH
LA.ListNesting Analyze function nesting
See command <trace>.ListNesting in 'General Commands Reference Guide T' (general_ref_t.pdf, page 242).
LA.ListVar List variable recorded to trace
See command <trace>.ListVar in 'General Commands Reference Guide T' (general_ref_t.pdf, page 245).
LA.LOAD Load trace file for offline processing
See command <trace>.LOAD in 'General Commands Reference Guide T' (general_ref_t.pdf, page 248).
LA.Mode Set the trace operation mode
See command <trace>.Mode in 'General Commands Reference Guide T' (general_ref_t.pdf, page 253).
LA.OFF Switch off
See command <trace>.OFF in 'General Commands Reference Guide T' (general_ref_t.pdf, page 257).
LA.PROfileChart Profile charts
See command <trace>.PROfileChart in 'General Commands Reference Guide T' (general_ref_t.pdf, page 265).
LA.PROfileChart.DIStance Time interval for a single event
See command <trace>.PROfileChart.DIStance in 'General Commands Reference Guide T' (general_ref_t.pdf, page 267).
General Commands Reference Guide L 15 ©1989-2019 Lauterbach GmbH
LA.PROfileChart.GROUP Group profile chart
See command <trace>.PROfileChart.GROUP in 'General Commands Reference Guide T' (general_ref_t.pdf, page 274).
LA.PROfileChart.Rate Event frequency
See command <trace>.PROfileChart.Rate in 'General Commands Reference Guide T' (general_ref_t.pdf, page 275).
LA.PROTOcol Protocol analysis
See command <trace>.PROTOcol in 'General Commands Reference Guide T' (general_ref_t.pdf, page 285).
LA.PROTOcol.Chart Graphic display for user-defined protocol
See command <trace>.PROTOcol.Chart in 'General Commands Reference Guide T' (general_ref_t.pdf, page 285).
LA.PROTOcol.Draw Graphic display for user-defined protocol
See command <trace>.PROTOcol.Draw in 'General Commands Reference Guide T' (general_ref_t.pdf, page 287).
LA.PROTOcol.EXPORT Export trace buffer for user-defined protocol
See command <trace>.PROTOcol.EXPORT in 'General Commands Reference Guide T' (general_ref_t.pdf, page 288).
LA.PROTOcol.Find Find in trace buffer for user-defined protocol
See command <trace>.PROTOcol.Find in 'General Commands Reference Guide T' (general_ref_t.pdf, page 289).
General Commands Reference Guide L 16 ©1989-2019 Lauterbach GmbH
LA.PROTOcol.List Display trace buffer for user-defined protocol
See command <trace>.PROTOcol.List in 'General Commands Reference Guide T' (general_ref_t.pdf, page 290).
LA.PROTOcol.STATistic Display statistics for user-defined protocol
See command <trace>.PROTOcol.STATistic in 'General Commands Reference Guide T' (general_ref_t.pdf, page 293).
LA.REF Set reference point for time measurement
See command <trace>.REF in 'General Commands Reference Guide T' (general_ref_t.pdf, page 299).
LA.RESet Reset command
See command <trace>.RESet in 'General Commands Reference Guide T' (general_ref_t.pdf, page 300).
LA.SAVE Save trace for postprocessing in TRACE32
See command <trace>.SAVE in 'General Commands Reference Guide T' (general_ref_t.pdf, page 302).
LA.SelfArm Automatic restart of trace recording
See command <trace>.SelfArm in 'General Commands Reference Guide T' (general_ref_t.pdf, page 306).
LA.SIZE Define buffer size
See command <trace>.SIZE in 'General Commands Reference Guide T' (general_ref_t.pdf, page 317).
General Commands Reference Guide L 17 ©1989-2019 Lauterbach GmbH
LA.SnapShot Restart trace capturing once
See command <trace>.SnapShot in 'General Commands Reference Guide T' (general_ref_t.pdf, page 319).
LA.state Display trace configuration window
See command <trace>.state in 'General Commands Reference Guide T' (general_ref_t.pdf, page 321).
LA.STATistic Statistic analysis
See command <trace>.STATistic in 'General Commands Reference Guide T' (general_ref_t.pdf, page 324).
LA.STATistic.BondOut Bondout mode
See command <trace>.STATistic.BondOut in 'General Commands Reference Guide T' (general_ref_t.pdf, page 329).
LA.STATistic.DIStance Time interval for a single event
See command <trace>.STATistic.DIStance in 'General Commands Reference Guide T' (general_ref_t.pdf, page 335).
LA.STATistic.DistriB Distribution analysis
See command <trace>.STATistic.DistriB in 'General Commands Reference Guide T' (general_ref_t.pdf, page 338).
LA.STATistic.DURation Time between two events
See command <trace>.STATistic.DURation in 'General Commands Reference Guide T' (general_ref_t.pdf, page 341).
General Commands Reference Guide L 18 ©1989-2019 Lauterbach GmbH
LA.STATistic.Func Nesting function runtime analysis
See command <trace>.STATistic.Func in 'General Commands Reference Guide T' (general_ref_t.pdf, page 346).
LA.STATistic.GROUP Group run-time analysis
See command <trace>.STATistic.GROUP in 'General Commands Reference Guide T' (general_ref_t.pdf, page 373).
LA.STATistic.Ignore Ignore false records in statistic
See command <trace>.STATistic.Ignore in 'General Commands Reference Guide T' (general_ref_t.pdf, page 374).
LA.STATistic.InterruptIsFunction Statistics interrupt processing
See command <trace>.STATistic.InterruptIsFunction in 'General Commands Reference Guide T' (general_ref_t.pdf, page 376).
LA.STATistic.Line HLL-line analysis
See command <trace>.STATistic.Line in 'General Commands Reference Guide T' (general_ref_t.pdf, page 380).
LA.STATistic.LINKage Per caller statistic of function
See command <trace>.STATistic.LINKage in 'General Commands Reference Guide T' (general_ref_t.pdf, page 383).
LA.STATistic.Measure Analyze the performance of a single signal
See command <trace>.STATistic.Measure in 'General Commands Reference Guide T' (general_ref_t.pdf, page 385).
General Commands Reference Guide L 19 ©1989-2019 Lauterbach GmbH
LA.STATistic.PreFetch Prefetch detection
See command <trace>.STATistic.PreFetch in 'General Commands Reference Guide T' (general_ref_t.pdf, page 390).
LA.STATistic.Sort Specify sorting criterion for statistic commands
See command <trace>.STATistic.Sort in 'General Commands Reference Guide T' (general_ref_t.pdf, page 393).
LA.STATistic.sYmbol Flat run-time analysis
See command <trace>.STATistic.sYmbol in 'General Commands Reference Guide T' (general_ref_t.pdf, page 401).
LA.STATistic.TASK Task activity statistic
See command <trace>.STATistic.TASK in 'General Commands Reference Guide T' (general_ref_t.pdf, page 406).
LA.STATistic.TASKFunc Task specific function run-time analysis
See command <trace>.STATistic.TASKFunc in 'General Commands Reference Guide T' (general_ref_t.pdf, page 413).
LA.STATistic.TASKKernel Task analysis with kernel markers (flat)
See command <trace>.STATistic.TASKKernel in 'General Commands Reference Guide T' (general_ref_t.pdf, page 421).
LA.STATistic.TASKSRV Analysis of time in OS service routines
See command <trace>.STATistic.TASKSRV in 'General Commands Reference Guide T' (general_ref_t.pdf, page 424).
General Commands Reference Guide L 20 ©1989-2019 Lauterbach GmbH
LA.STATistic.TASKState Performance analysis
See command <trace>.STATistic.TASKState in 'General Commands Reference Guide T' (general_ref_t.pdf, page 425).
LA.STATistic.TASKTREE Tree display of task specific functions
See command <trace>.STATistic.TASKTREE in 'General Commands Reference Guide T' (general_ref_t.pdf, page 429).
LA.STATistic.TREE Tree display of nesting function run-time analysis
See command <trace>.STATistic.TREE in 'General Commands Reference Guide T' (general_ref_t.pdf, page 431).
LA.STATistic.Use Use records
See command <trace>.STATistic.Use in 'General Commands Reference Guide T' (general_ref_t.pdf, page 432).
LA.Timing Waveform of trace buffer
See command <trace>.Timing in 'General Commands Reference Guide T' (general_ref_t.pdf, page 448).
LA.TRACK Set tracking record
See command <trace>.TRACK in 'General Commands Reference Guide T' (general_ref_t.pdf, page 453).
LA.View Display single record
See command <trace>.View in 'General Commands Reference Guide T' (general_ref_t.pdf, page 457).
General Commands Reference Guide L 21 ©1989-2019 Lauterbach GmbH
LA.ZERO Align timestamps of trace and timing analyzers
See command <trace>.ZERO in 'General Commands Reference Guide T' (general_ref_t.pdf, page 459).
General Commands Reference Guide L 22 ©1989-2019 Lauterbach GmbH
List
List Display modes for programs
The List command group supports the following display modes for programs:
• HLL (High Level Language) and disassembled format in the List.Mix window
• Disassembled format in the List.Asm window
• HLL format in the List.Hll window
• Java byte code in the List.Java window
In addition, source and disassembler listings can be exported with List.EXPORT.
See also
■ List.Asm ■ List.auto ■ List.EXPORT ■ List.Hll ■ List.Java ■ List.Mix ■ Break ■ Data.dump ■ Data.LOAD ■ Go ■ SETUP.DIS ■ SETUP.FLIST ■ SETUP.LISTCLICK ■ SETUP.sYmbol ■ SETUP.TIMEOUT ■ Step ■ WinOverlay ❏ ADDRESS.isPHYSICAL() ❏ ADDRESS.OFFSET() ❏ ADDRESS.SEGMENT() ❏ ADDRESS.STRACCESS() ❏ ADDRESS.WIDTH() ❏ sYmbol.END() ❏ sYmbol.EXIT()
▲ ’ADDRESS Functions’ in ’General Function Reference’▲ ’sYmbol Functions’ in ’General Function Reference’▲ ’Release Information’ in ’Release History’
General Commands Reference Guide L 23 ©1989-2019 Lauterbach GmbH
List.auto Display source listing[Options] [Examples]
The display format (assembler, mixed or HLL) of the List.auto window is selected dynamically, depending on the current debug mode. You can change the debug mode by clicking the Mode button in the toolbar of a List.* window or by using the Mode command.
If no address is specified, the window tracks the value of the program counter (PC). The window is only scrolled, if the bar moves outside of a predefined subwindow. The display format may be specified with the SETUP.DIS command.
Format: List.auto [<address> | <range>] [/<option>]Data.List (as an alternative)
<option>: Mark <break>Flag <flag> (EF)DIVERGECOVerageCACHETrackTOrder | SOrderISTAT [<parameter>]
<flag>: Read | Write | NoRead | NoWrite
<break>: Program | Hll | Spot | Read | Write | Alpha | Beta | Charly | Delta | Echo
<parameter>: DEFault | ALL | CLOCKS | TCLOCKS | SAMPLES | COVerage
General Commands Reference Guide L 24 ©1989-2019 Lauterbach GmbH
If the source listing is displayed in HLL mode, some code lines may be marked with a drill-down button. This drill-down button indicates that the compiler generated assembler code at more than one address location for this source code line. This is very common for for-while loops as well as for code compiled with a high optimization level.
If you want to inspect this in detail, the following commands might be helpful:
Data.ListHll ; display the source code in HLL; mode (source order)
Data.ListMix /Track ; display the source code in Mixed; mode (target line order)
Drill-down button
Assembler code at two address locations is generated for the HLL line number 683--684
General Commands Reference Guide L 25 ©1989-2019 Lauterbach GmbH
If you push the drill-down button to get detailed information, a duplicate of the original HLL line is generated for each assembler code address location.
If you now select one of the duplicates, the cursor in the Data.ListMix window points automatically to the corresponding assembler code. This feature is enabled by the /Track option.
Shaded lines indicate that the source information is not on disk or in the wrong directory. See command sYmbol.SPATH. For an example of shaded lines in a List window, see screenshot in List.Mix.
General Commands Reference Guide L 26 ©1989-2019 Lauterbach GmbH
Options of the List.* Commands[Back]
Mark The Mark option highlights individual lines, depending on the breakpoint type.
MarkPC The MarkPC option highlights all HLL source lines belonging to the current PC.See example.
Flag Mark a line with specific flag memory contents, e.g. Read
DIVERGE This option is mainly intended for internal diagnostic purposes: It attaches tags to executed and not executed ASM and HLL lines. The tags are displayed in the scale area of the List.* windows. You can open the scale area by dragging the slider control to the right.• For information about the tags, see example.• See also Step.Diverge.
COVerage Displays trace based code coverage information. The COVerage option highlights all code lines that have not been fully covered. For more information, see COVerage.
CACHE Displays cache hit information and marks currently cached code.
Track Tracks the window to the reference position of other windows. The window tries first to track to the PROGRAM reference, and if this reference is not valid, it tracks to the DATA reference.
TOrder List source lines in target line order, i.e. in the order they appear in the binary program. This is the default for assembly and mixed displays.
SOrder List source lines in source line order, i.e. in the order of the original program. This is the default for source level displays. If the compiler rearranged the lines during the optimization, the file must be loaded with the Puzzled option of e.g. Data.LOAD.COFF. The Puzzled option is only available for certain file types such as COFF files.
ISTAT [<parameter>] Display source listing together with the information provided by the instruction trace database (ISTATistic.ListFunc).Instructions that have not been executed are highlighted in yellow.• For a description of the <parameters>, see table below.• ISTAT used without parameter, see example.• ISTAT used with the COVerage parameter, see example.
General Commands Reference Guide L 27 ©1989-2019 Lauterbach GmbH
Parameters for the ISTAT Option
[Back]
Examples
Example for the ISTAT option - without <parameter>
[Back]
DEFault Display the default information provided by the ISTAT database.
ALL Display all information provided by the ISTAT database.
CLOCK Display the clock and CPI information provided by the ISTAT database.
TCLOCK (only for special purposes)
SAMPLES tbd.
COVerage Display the code coverage information provided by the ISTAT database.
Data.ListAsm func13 /ISTAT ; list instruction run-time; statistic
count Total number of instruction executions
clocks Total number of clocks for the instruction
cpi Average clocks per instruction
General Commands Reference Guide L 28 ©1989-2019 Lauterbach GmbH
Example for the ISTAT option - with the COVerage <parameter>
[Back]
If exec or/and notexec is 0 for an instruction with condition, the instruction is bold-printed on a yellow background. All other instruction are bold-printed on a yellow background if they were not executed.
List func11 /ISTAT COVerage ; list instruction coverage
exec conditional instructions: number of times the instruction was executed because the condition was true.
other instructions: number of times the instruction was executed
notexec conditional instructions: number of times the instruction wasn’t executed because the condition was false.
coverage Instruction coverage
Data.List ; display source listing around the; current PC
Data.List /Mark Program
Data.List /Mark
; display source listing, bold print ; all instructions / HLL lines on a; yellow background if a program; breakpoint is set
; remove bold printing on yellow; background
General Commands Reference Guide L 29 ©1989-2019 Lauterbach GmbH
Example for the DIVERGE option
[Back]
Data.List /Track ; track the window to a reference, e.g. ; analyzer
Data.List Register(a0) ; follow the register A0 of the CPU
PRINT D.L(d:0x200) ; prints the memory contents of addresses; D:0x200..0x203; Do not mix up the command Data.List; with the function Data.Long()
; Short form of the command is D.L; Short form of the function is D.L()
Tags in the columns s, state, and i
h Line in HLL mode (Mode.Hll).
a Address in ASM mode (Mode.Asm).
stop Reached by a breakpoint.
done An executed line or address.
hit A reached line or address that has not yet been executed, e.g. in a linear code sequence.
target This line or address is a possible target of the next Step.Diverge. Once reached, target is replaced with hit.
i Indirect branch instruction.
General Commands Reference Guide L 30 ©1989-2019 Lauterbach GmbH
Example for the MarkPC option
[Back]
Additional example for the TRACE32-ICE and TRACE32-FIRE:
See also
■ List ■ List.Asm ■ List.EXPORT ■ List.Hll ■ List.Java ■ List.Mix ■ SETUP.DIS ■ SETUP.FLIST ■ SETUP.LISTCLICK ■ SETUP.sYmbol ■ SETUP.TIMEOUT ❏ ADDRESS.isPHYSICAL() ❏ ADDRESS.OFFSET() ❏ ADDRESS.SEGMENT() ❏ ADDRESS.STRACCESS() ❏ ADDRESS.WIDTH() ❏ sYmbol.END() ❏ sYmbol.EXIT()
▲ ’sYmbol Functions’ in ’General Function Reference’▲ ’Release Information’ in ’Release History’
Register.Set PC main ; set the Program Counter to the label mainList.auto main /MarkPC ; highlight all instructions related to the ; current HLL line
Data.List e: ; display the program around the current PC,; but use dual-port access
MarkPC
E::Data.List e: /TrackwrCBAWRSHP addr/line code label mnemonic cr H 565 if ( flags[ i ] )r H ESP:000017AA 4A1B tst.b (a3)+r ESP:000017AC 671E beq $17CC
{r HP 567 prime = i + i + 3;r HP ESP:000017AE 2802 move.l d2,d4 ;r ESP:000017B0 D882 add.l d2,d4 ;r ESP:000017B2 5684 addq.l #3,d4 ;r H 568 k = i + prime;r H ESP:000017B4 2602 move.l d2,d3 ;r ESP:000017B6 D684 add.l d4,d3 ;
General Commands Reference Guide L 31 ©1989-2019 Lauterbach GmbH
List.Asm Display disassembler
Displays the program in disassembled format. The functionality is the same as the Data.List command.
See also
■ List ■ List.auto ■ List.Hll ■ List.Java ■ List.Mix ■ Mode ❏ DEBUGMODE()
Format: List.Asm [<address>] [/<option>] Data.ListAsm (as an alternative)
<option>: Mark <break>Flag <flag> (EF)COVerageCACHETrackMarkPC
TOrder | SOrderIgnoreSymbols
<option> For a description of the options, see List.auto command.
IgnoreSymbols Let the disassembler ignore any symbols for deciding at which byte of the machine code the disassembling should start. This option does normally only make sense on architectures with different instruction lengths.
General Commands Reference Guide L 32 ©1989-2019 Lauterbach GmbH
List.EXPORT Export a listing to an XML file
Using the List.EXPORT command group, you can export a source or disassembler listing or both listings to an XML file.
In addition, TRACE32 provides an XSL transformation template for formatting the XML file. The formatting is automatically applied to the XML file when it is opened in an external browser window. Prerequisite: The XSL file is placed in the same folder as the XML file.
For demo scripts, see List.EXPORT.Mix.
See also
■ List.EXPORT.Asm ■ List.EXPORT.auto ■ List.EXPORT.Hll ■ List.EXPORT.Mix ■ List ■ List.auto ■ COVerage.EXPORT ■ ISTATistic.EXPORT
▲ ’Trace-based Code Coverage’ in ’Nexus Training’
List.EXPORT.Asm Export disassembler listing
Creates an XML file containing the disassembler listing. For an example and a description of the options, see List.EXPORT.Mix.
See also
■ List.EXPORT
Format: List.EXPORT.Asm <file> <range> [/<option>]Data.ListEXPORTAsm (as an alternative)
<option>: COVerage | ISTATistic Append | NoData
General Commands Reference Guide L 33 ©1989-2019 Lauterbach GmbH
List.EXPORT.auto Export source and disassembler listing
Creates an XML file containing the source listing and the disassembler listing - same as List.EXPORT.Mix. For an example and a description of the options, see List.EXPORT.Mix.
See also
■ List.EXPORT
List.EXPORT.Hll Export source listing
Creates an XML file containing just the source listing. For an example and a description of the options, see List.EXPORT.Mix.
See also
■ List.EXPORT
Format: List.EXPORT.auto <file> <range> [/<option>]Data.ListEXPORT (as an alternative)
<option>: COVerage | ISTATistic | TOrder | SOrder Append | NoData
Format: List.EXPORT.Hll <file> <range> [/<option>]Data.ListEXPORTHll (as an alternative)
<option>: COVerage | ISTATistic | Append | NoData
General Commands Reference Guide L 34 ©1989-2019 Lauterbach GmbH
List.EXPORT.Mix Export source and disassembler listing[Example]
Creates an XML file containing the source listing and the disassembler listing.
Format: List.EXPORT.Mix <file> <range> [/<option>] Data.ListEXPORTMix (as an alternative)
<option>: COVerage | ISTATistic | SOrder | TOrder | Append | NoData
<file> Name of the XML file that stores a listing of the source and disassembler code. The file extension *.xml can be omitted.
<range> Address filter for exporting the specified range.
Append Appends the listing to an existing XML file - without overwriting the current file contents.
COVerage Listing additionally contains code coverage information.
ISTATistic Listing additionally contains information provided by the ISTATistics module.
NoData Excludes data-only sections from the XML output.
SOrder Exports the full source file sorted by ascending line numbers.
TOrder Exports the source listing sorted by ascending memory addresses.
General Commands Reference Guide L 35 ©1989-2019 Lauterbach GmbH
Example 1: The prerequisites for the following example are that the debug symbols have already been loaded, the address bookmarks have been created, and trace data has been recorded.
The tildes ~~ expand to your TRACE32 system directory, by default c:\t32.
Example 2: A more complex demo script is included in your TRACE32 installation. To access the script, run this command:B::CD.PSTEP ~~/demo/coverage/example.cmm
See also
■ List.EXPORT
COVerage.ADD ;update the coverage databaseData.List /COVerage /Track ;display source listingCOVerage.ListFunc ;display coverage for HLL functions
;export all bookmarksBookMark.EXPORT "~~/list.xml"
;export the source listing of the functions “main” and “sieve”List.EXPORT.Mix "~~/list.xml" main /COVerage /AppendList.EXPORT.Mix "~~/list.xml" sieve /COVerage /Append
;for demo purposes: let's open the unformatted result in TRACE32EDIT "~~/list.xml"
;place the transformation template in the same folder as the XML fileCOPY "~~/demo/coverage/single_file_report/t32transform.xsl" \ "~~/t32transform.xsl"
;you can now open the formatted result in an external browser windowOS.Command start iexplore.exe "file:///C:/t32/list.xml"
General Commands Reference Guide L 36 ©1989-2019 Lauterbach GmbH
List.Hll Display source
Displays the program in source format. The functionality is the same as the Data.List command. If the starting address in not an HLL (High Level Language) line, assembler code is displayed to the next HLL line found in the code segment.
Shaded lines indicate that the source information is not on disk or in the wrong directory. See command sYmbol.SPATH.
See also
■ List ■ List.Asm ■ List.auto ■ List.Java ■ List.Mix ■ Mode ❏ DEBUGMODE()
Format: List.Hll [<address>] [/<option>] Data.ListHll (as an alternative)
<option>: Mark <break>Flag <flag> (EF)COVerageCACHETrackMarkPCTOrder | SOrder
<option> For a description of the options, see List.auto.
Program counter (PC)
Shaded lines
General Commands Reference Guide L 37 ©1989-2019 Lauterbach GmbH
List.Java Display Java byte code[Example]
Displays the program in Java byte code format. The functionality is the same as the Data.List command.
This command is NOT required when an address range is specified as Java byte code area with the Java byte code debugger or when the processor implements a special byte code mode (e.g. ARM Jazelle).
Format: List.Java [<address>] [/<option>] Data.ListJava (as an alternative)
<option>: Mark <break>Flag <flag>(EF)COVerageCACHETrackTOrder | SOrder
<option> For a description of the options, see List.auto.
General Commands Reference Guide L 38 ©1989-2019 Lauterbach GmbH
Android is used in this example:
See also
■ List ■ List.Asm ■ List.auto ■ List.Hll ■ List.Mix
▲ ’Java’ in ’General Commands Reference Guide J’
;list all running tasks by magic number, task name, task ID, etc.TASK.List.tasks
;change view to a task by specifying the magic number, task name or ID Frame.TASK 0xEFD29700
;display a source listing at this address for the task specified aboveList.Java J:0x0690:0x583A3D14
;alternatively, use the label to display the same source listing.List.Java `<clinit>()` ;enclose the label in backticks `...`
Java file name:Click to open the symbol browser.
Access class J for Java
Thread ID
Address
General Commands Reference Guide L 39 ©1989-2019 Lauterbach GmbH
List.Mix Disassembler and source
The code is displayed in HLL (High Level Language) and additionally disassembled from the memory. The functionality is the same as the Data.List command.
Shaded lines indicate that the source information is not on disk or in the wrong directory. See the command sYmbol.SPATH.
See also
■ List ■ List.Asm ■ List.auto ■ List.Hll ■ List.Java ■ Mode ❏ DEBUGMODE()
Format: List.Mix [<address>] [/<option>] Data.ListMix (as an alternative)
<option>: Mark <break>Flag <flag> (EF)COVerageCACHETrackMarkPCTOrder | SOrder
<option> For a description of the options, see List.auto command.
Program counter (PC)
Shaded lines
General Commands Reference Guide L 40 ©1989-2019 Lauterbach GmbH
LOGGER
LOGGER tbd.
tbd.
See also
■ Trace.METHOD
▲ ’Software Trace’ in ’ICD Debugger User’s Guide’
Trace Method LOGGER
The trace method LOGGER is mainly used for TRACE32-ICD without a trace extension.
Problem description: A TRACE32-ICD debugger is used to test and integrate an application program on the target. Now a problem occurs that could easily be solved if more information about the program history would be available.
Usually a TRACE32-ICD trace extension can be used to get more information about the program history. But not all targets allow the operation of such a trace. For these targets, TRACE32 offers a software trace. The software trace however needs RAM from the target and is influencing the real-time behavior.
To operate a software trace, TRACE32 provides:
• A general trace format for a software trace located in the target RAM.
• Configuration and display commands for the software trace in the TRACE32 software(command group: LOGGER).
• Predefined algorithms to operate the software trace from the target program.
To use the software trace basic knowledge of the target hardware and the processor architecture is required.
Implementation of the trace memory
The user reserves a part of the target RAM, that can be used for the trace information.
Max. trace size Any desired.
Sampling The trace memory is filled either by an algorithm predefined by LAUTERBACH or by a user-defined algorithm.The algorithm can either be called by an interrupt or the code has to be instrumented.
Influence on the real-time behavior
Yes, how much depends on the implementation of the sampling algorithm.
Selective tracing Possible by the sampling algorithm.
General Commands Reference Guide L 41 ©1989-2019 Lauterbach GmbH
Fastest sampling rate
Depends on the sampling algorithm.
General Commands Reference Guide L 42 ©1989-2019 Lauterbach GmbH
LOGGER Trace Commands
LOGGER.ADDRESS Software trace address
See command <trace>.ADDRESS in 'General Commands Reference Guide T' (general_ref_t.pdf, page 124).
LOGGER.Arm Arm the trace
See command <trace>.Arm in 'General Commands Reference Guide T' (general_ref_t.pdf, page 125).
LOGGER.AutoArm Arm automatically
See command <trace>.AutoArm in 'General Commands Reference Guide T' (general_ref_t.pdf, page 126).
LOGGER.AutoFocus Calibrate AUTOFOCUS preprocessor
See command <trace>.AutoFocus in 'General Commands Reference Guide T' (general_ref_t.pdf, page 126).
LOGGER.AutoInit Automatic initialization
See command <trace>.AutoInit in 'General Commands Reference Guide T' (general_ref_t.pdf, page 131).
LOGGER.BookMark Set a bookmark in trace listing
See command <trace>.BookMark in 'General Commands Reference Guide T' (general_ref_t.pdf, page 134).
General Commands Reference Guide L 43 ©1989-2019 Lauterbach GmbH
LOGGER.Chart Display trace contents graphically
See command <trace>.Chart in 'General Commands Reference Guide T' (general_ref_t.pdf, page 138).
LOGGER.Chart.DistriB Distribution display graphically
See command <trace>.Chart.DistriB in 'General Commands Reference Guide T' (general_ref_t.pdf, page 149).
LOGGER.Chart.Func Function activity chart
See command <trace>.Chart.Func in 'General Commands Reference Guide T' (general_ref_t.pdf, page 151).
LOGGER.Chart.GROUP Group activity chart
See command <trace>.Chart.GROUP in 'General Commands Reference Guide T' (general_ref_t.pdf, page 152).
LOGGER.Chart.Line Graphical HLL lines analysis
See command <trace>.Chart.Line in 'General Commands Reference Guide T' (general_ref_t.pdf, page 154).
LOGGER.Chart.sYmbol Symbol analysis
See command <trace>.Chart.sYmbol in 'General Commands Reference Guide T' (general_ref_t.pdf, page 156).
LOGGER.Chart.TASK Task activity chart
See command <trace>.Chart.TASK in 'General Commands Reference Guide T' (general_ref_t.pdf, page 160).
General Commands Reference Guide L 44 ©1989-2019 Lauterbach GmbH
LOGGER.Chart.TASKFunc Task related function run-time analysis (legacy)
See command <trace>.Chart.TASKFunc in 'General Commands Reference Guide T' (general_ref_t.pdf, page 161).
LOGGER.Chart.TASKSRV Service routine run-time analysis
See command <trace>.Chart.TASKSRV in 'General Commands Reference Guide T' (general_ref_t.pdf, page 163).
LOGGER.Chart.TASKState Task state analysis
See command <trace>.Chart.TASKState in 'General Commands Reference Guide T' (general_ref_t.pdf, page 164).
LOGGER.Chart.VarState Variable activity chart
See command <trace>.Chart.VarState in 'General Commands Reference Guide T' (general_ref_t.pdf, page 167).
LOGGER.ComPare Compare trace contents
See command <trace>.ComPare in 'General Commands Reference Guide T' (general_ref_t.pdf, page 171).
LOGGER.DISable Disable the trace
See command <trace>.DISable in 'General Commands Reference Guide T' (general_ref_t.pdf, page 176).
LOGGER.DRAW Plot trace data against time
See command <trace>.DRAW in 'General Commands Reference Guide T' (general_ref_t.pdf, page 180).
General Commands Reference Guide L 45 ©1989-2019 Lauterbach GmbH
LOGGER.EXPORT Export trace data for processing in other applications
See command <trace>.EXPORT in 'General Commands Reference Guide T' (general_ref_t.pdf, page 191).
LOGGER.FILE Load a file into the file trace buffer
See command <trace>.FILE in 'General Commands Reference Guide T' (general_ref_t.pdf, page 205).
LOGGER.Find Find specified entry in trace
See command <trace>.Find in 'General Commands Reference Guide T' (general_ref_t.pdf, page 207).
LOGGER.FindAll Find all specified entries in trace
See command <trace>.FindAll in 'General Commands Reference Guide T' (general_ref_t.pdf, page 211).
LOGGER.FindChange Search for changes in trace flow
See command <trace>.FindChange in 'General Commands Reference Guide T' (general_ref_t.pdf, page 212).
LOGGER.FLOWPROCESS Process flowtrace
See command <trace>.FLOWPROCESS in 'General Commands Reference Guide T' (general_ref_t.pdf, page 213).
LOGGER.FLOWSTART Restart flowtrace processing
See command <trace>.FLOWSTART in 'General Commands Reference Guide T' (general_ref_t.pdf, page 213).
General Commands Reference Guide L 46 ©1989-2019 Lauterbach GmbH
LOGGER.GOTO Move cursor to specified trace record
See command <trace>.GOTO in 'General Commands Reference Guide T' (general_ref_t.pdf, page 216).
LOGGER.Init Initialize trace
See command <trace>.Init in 'General Commands Reference Guide T' (general_ref_t.pdf, page 226).
LOGGER.List List trace contents
See command <trace>.List in 'General Commands Reference Guide T' (general_ref_t.pdf, page 230).
LOGGER.ListNesting Analyze function nesting
See command <trace>.ListNesting in 'General Commands Reference Guide T' (general_ref_t.pdf, page 242).
LOGGER.ListVar List variable recorded to trace
See command <trace>.ListVar in 'General Commands Reference Guide T' (general_ref_t.pdf, page 245).
LOGGER.LOAD Load trace file for offline processing
See command <trace>.LOAD in 'General Commands Reference Guide T' (general_ref_t.pdf, page 248).
LOGGER.Mode Set the trace operation mode
See command <trace>.Mode in 'General Commands Reference Guide T' (general_ref_t.pdf, page 253).
LOGGER.OFF Switch off
See command <trace>.OFF in 'General Commands Reference Guide T' (general_ref_t.pdf, page 257).
General Commands Reference Guide L 47 ©1989-2019 Lauterbach GmbH
LOGGER.PROfileChart Profile charts
See command <trace>.PROfileChart in 'General Commands Reference Guide T' (general_ref_t.pdf, page 265).
LOGGER.PROfileChart.DIStance Time interval for a single event
See command <trace>.PROfileChart.DIStance in 'General Commands Reference Guide T' (general_ref_t.pdf, page 267).
LOGGER.PROfileChart.DURation Time between two events
See command <trace>.PROfileChart.DURation in 'General Commands Reference Guide T' (general_ref_t.pdf, page 270).
LOGGER.PROfileChart.GROUP Group profile chart
See command <trace>.PROfileChart.GROUP in 'General Commands Reference Guide T' (general_ref_t.pdf, page 274).
LOGGER.PROfileChart.Rate Event frequency
See command <trace>.PROfileChart.Rate in 'General Commands Reference Guide T' (general_ref_t.pdf, page 275).
LOGGER.PROTOcol Protocol analysis
See command <trace>.PROTOcol in 'General Commands Reference Guide T' (general_ref_t.pdf, page 285).
LOGGER.PROTOcol.Chart Graphic display for user-defined protocol
See command <trace>.PROTOcol.Chart in 'General Commands Reference Guide T' (general_ref_t.pdf, page 285).
General Commands Reference Guide L 48 ©1989-2019 Lauterbach GmbH
LOGGER.PROTOcol.Draw Graphic display for user-defined protocol
See command <trace>.PROTOcol.Draw in 'General Commands Reference Guide T' (general_ref_t.pdf, page 287).
LOGGER.PROTOcol.EXPORT Export trace buffer for user-defined protocol
See command <trace>.PROTOcol.EXPORT in 'General Commands Reference Guide T' (general_ref_t.pdf, page 288).
LOGGER.PROTOcol.Find Find in trace buffer for user-defined protocol
See command <trace>.PROTOcol.Find in 'General Commands Reference Guide T' (general_ref_t.pdf, page 289).
LOGGER.PROTOcol.List Display trace buffer for user-defined protocol
See command <trace>.PROTOcol.List in 'General Commands Reference Guide T' (general_ref_t.pdf, page 290).
LOGGER.PROTOcol.STATistic Display statistics for user-defined protocol
See command <trace>.PROTOcol.STATistic in 'General Commands Reference Guide T' (general_ref_t.pdf, page 293).
LOGGER.REF Set reference point for time measurement
See command <trace>.REF in 'General Commands Reference Guide T' (general_ref_t.pdf, page 299).
LOGGER.RESet Reset command
See command <trace>.RESet in 'General Commands Reference Guide T' (general_ref_t.pdf, page 300).
General Commands Reference Guide L 49 ©1989-2019 Lauterbach GmbH
LOGGER.SAVE Save trace for postprocessing in TRACE32
See command <trace>.SAVE in 'General Commands Reference Guide T' (general_ref_t.pdf, page 302).
LOGGER.SelfArm Automatic restart of trace recording
See command <trace>.SelfArm in 'General Commands Reference Guide T' (general_ref_t.pdf, page 306).
LOGGER.SIZE Define buffer size
See command <trace>.SIZE in 'General Commands Reference Guide T' (general_ref_t.pdf, page 317).
LOGGER.SnapShot Restart trace capturing once
See command <trace>.SnapShot in 'General Commands Reference Guide T' (general_ref_t.pdf, page 319).
LOGGER.state Display trace configuration window
See command <trace>.state in 'General Commands Reference Guide T' (general_ref_t.pdf, page 321).
LOGGER.STATistic Statistic analysis
See command <trace>.STATistic in 'General Commands Reference Guide T' (general_ref_t.pdf, page 324).
LOGGER.STATistic.BondOut Bondout mode
See command <trace>.STATistic.BondOut in 'General Commands Reference Guide T' (general_ref_t.pdf, page 329).
General Commands Reference Guide L 50 ©1989-2019 Lauterbach GmbH
LOGGER.STATistic.DIStance Time interval for a single event
See command <trace>.STATistic.DIStance in 'General Commands Reference Guide T' (general_ref_t.pdf, page 335).
LOGGER.STATistic.DistriB Distribution analysis
See command <trace>.STATistic.DistriB in 'General Commands Reference Guide T' (general_ref_t.pdf, page 338).
LOGGER.STATistic.DURation Time between two events
See command <trace>.STATistic.DURation in 'General Commands Reference Guide T' (general_ref_t.pdf, page 341).
LOGGER.STATistic.Func Nesting function runtime analysis
See command <trace>.STATistic.Func in 'General Commands Reference Guide T' (general_ref_t.pdf, page 346).
LOGGER.STATistic.GROUP Group run-time analysis
See command <trace>.STATistic.GROUP in 'General Commands Reference Guide T' (general_ref_t.pdf, page 373).
LOGGER.STATistic.Ignore Ignore false records in statistic
See command <trace>.STATistic.Ignore in 'General Commands Reference Guide T' (general_ref_t.pdf, page 374).
LOGGER.STATistic.InterruptIsFunction Statistics interrupt processing
See command <trace>.STATistic.InterruptIsFunction in 'General Commands Reference Guide T' (general_ref_t.pdf, page 376).
General Commands Reference Guide L 51 ©1989-2019 Lauterbach GmbH
LOGGER.STATistic.Line HLL-line analysis
See command <trace>.STATistic.Line in 'General Commands Reference Guide T' (general_ref_t.pdf, page 380).
LOGGER.STATistic.LINKage Per caller statistic of function
See command <trace>.STATistic.LINKage in 'General Commands Reference Guide T' (general_ref_t.pdf, page 383).
LOGGER.STATistic.Measure Analyze the performance of a single signal
See command <trace>.STATistic.Measure in 'General Commands Reference Guide T' (general_ref_t.pdf, page 385).
LOGGER.STATistic.PreFetch Prefetch detection
See command <trace>.STATistic.PreFetch in 'General Commands Reference Guide T' (general_ref_t.pdf, page 390).
LOGGER.STATistic.Sort Specify sorting criterion for statistic commands
See command <trace>.STATistic.Sort in 'General Commands Reference Guide T' (general_ref_t.pdf, page 393).
LOGGER.STATistic.sYmbol Flat run-time analysis
See command <trace>.STATistic.sYmbol in 'General Commands Reference Guide T' (general_ref_t.pdf, page 401).
LOGGER.STATistic.TASK Task activity statistic
See command <trace>.STATistic.TASK in 'General Commands Reference Guide T' (general_ref_t.pdf, page 406).
General Commands Reference Guide L 52 ©1989-2019 Lauterbach GmbH
LOGGER.STATistic.TASKFunc Task specific function run-time analysis
See command <trace>.STATistic.TASKFunc in 'General Commands Reference Guide T' (general_ref_t.pdf, page 413).
LOGGER.STATistic.TASKKernel Task analysis with kernel markers (flat)
See command <trace>.STATistic.TASKKernel in 'General Commands Reference Guide T' (general_ref_t.pdf, page 421).
LOGGER.STATistic.TASKSRV Analysis of time in OS service routines
See command <trace>.STATistic.TASKSRV in 'General Commands Reference Guide T' (general_ref_t.pdf, page 424).
LOGGER.STATistic.TASKState Performance analysis
See command <trace>.STATistic.TASKState in 'General Commands Reference Guide T' (general_ref_t.pdf, page 425).
LOGGER.STATistic.TASKTREE Tree display of task specific functions
See command <trace>.STATistic.TASKTREE in 'General Commands Reference Guide T' (general_ref_t.pdf, page 429).
LOGGER.STATistic.TREE Tree display of nesting function run-time analysis
See command <trace>.STATistic.TREE in 'General Commands Reference Guide T' (general_ref_t.pdf, page 431).
LOGGER.STATistic.Use Use records
See command <trace>.STATistic.Use in 'General Commands Reference Guide T' (general_ref_t.pdf, page 432).
General Commands Reference Guide L 53 ©1989-2019 Lauterbach GmbH
LOGGER.TimeStamp Configure timestamp usage of LOGGER trace
See command <trace>.TimeStamp in 'General Commands Reference Guide T' (general_ref_t.pdf, page 447).
LOGGER.Timing Waveform of trace buffer
See command <trace>.Timing in 'General Commands Reference Guide T' (general_ref_t.pdf, page 448).
LOGGER.TRACK Set tracking record
See command <trace>.TRACK in 'General Commands Reference Guide T' (general_ref_t.pdf, page 453).
LOGGER.View Display single record
See command <trace>.View in 'General Commands Reference Guide T' (general_ref_t.pdf, page 457).
LOGGER.ZERO Align timestamps of trace and timing analyzers
See command <trace>.ZERO in 'General Commands Reference Guide T' (general_ref_t.pdf, page 459).
General Commands Reference Guide L 54 ©1989-2019 Lauterbach GmbH
LUA
LUA Support for the Lua script language
The TRACE32 Lua API allows the user to load and execute Lua scripts directly in the debugger. This feature can be used to accelerate execution of certain debug commands by avoiding the interaction between the TRACE32 host software and the debug driver. A Lua interpreter is built into the debug box, supporting the complete Lua language. Please refer to the official website of Lua www.lua.org for documentation.
In addition to the standard language elements, Lauterbach has extended Lua with a set of TRACE32 specific libraries. This allows you to, for example, use the JTAG shift functions directly in the Lua script. For a description of the TRACE32 specific libraries, refer to “TRACE32 Lua Library” (lua_library.pdf).
The Lua API can be used both as TRACE32 commands and through the remote C API. The LUA command group is described in the following sections and the C API is introduced in chapter Remote Lua API.
See also
■ LUA.List ■ LUA.LOAD ■ LUA.RESet ■ LUA.RUN ■ LUA.SET ■ LUA.ShowInput ■ LUA.ShowOutput ■ LUA.UNLOAD
▲ ’TRACE32 Lua Library’ in ’TRACE32 Lua Library’
LUA.List List the current Lua scripts
Lists the Lua scripts that have been loaded into the debugger. The output is redirected to the AREA window and has the following format: <id> : <label>, <attribute>, <file>. See example.
See also
■ LUA.LOAD ■ LUA ■ LUA.RESet ■ LUA.RUN ■ LUA.SET ■ LUA.ShowInput ■ LUA.ShowOutput ■ LUA.UNLOAD
Format: LUA.List
ID An auto-generated sequential index of the current Lua scripts. Note that the ID of a certain script may change after loading/unloading another script.
label A unique string to identify a Lua script.
attribute EXE: an executable script.LIB: a library script.See LUA.LOAD for more details.
filename Path to the Lua file.
General Commands Reference Guide L 55 ©1989-2019 Lauterbach GmbH
LUA.LOAD Load a Lua script to debugger
Loads the given Lua script to the debugger without executing it. The script is uniquely identified by its label. See example here.
See also
■ LUA.List ■ LUA
LUA.RESet Reset the Lua context
Resets the Lua context, unloads all scripts from the debugger and clears all input and output buffers.
See also
■ LUA ■ LUA.List
Format: LUA.LOAD <file> [<label>] [/<options>]
<option>: Program | Library
<file> Path and file name of the Lua script to be loaded.
<label> A unique string to identify the Lua script. If not specified, a default label will be generated.
Program The Lua script is loaded as an executable script. This is the default option.
Library The Lua script is loaded as a library script. The Lua functions in a library script will be made available to all other Lua scripts. Although marked as a library, the script itself can still be executed normally. However, we recommend to develop separate Lua scripts for libraries and executables.
Format: LUA.RESet
General Commands Reference Guide L 56 ©1989-2019 Lauterbach GmbH
LUA.RUN Execute a Lua script
Executes the Lua script with given index or label. Use LUA.List to check IDs and labels of the Lua scripts that are currently available in the debugger.
The TRACE32 host software maintains an input buffer with size 0x1000 bytes to store input parameters for the Lua script. While sending the command to execute a certain Lua script, TRACE32 also packs and sends the input buffer to the debugger. Use LUA.SET to manipulate the input buffer and LUA.ShowInput to view the current content in the input buffer. From within the Lua scripts, the data in the input buffer can be retrieved using functions from the “TRACE32 Lua Library” (lua_library.pdf).
The TRACE32 host software blocks until the Lua script returns. Inside the Lua script, functions from the “TRACE32 Lua Library” (lua_library.pdf) can be used to store output data into an output buffer (again 0x1000 bytes). The output buffer will be automatically sent back to the TRACE32. Use LUA.ShowOutput to view the output data.
See example.
See also
■ LUA ■ LUA.List
Format: LUA.RUN <id> | <label>
General Commands Reference Guide L 57 ©1989-2019 Lauterbach GmbH
LUA.SET Modify the Lua input buffer
Writes byte-wise data to the input buffer. Use LUA.ShowInput to view the current content of the input buffer. The input buffer will be sent to the debugger upon executing a LUA.RUN command.
See also
■ LUA ■ LUA.List
LUA.ShowInput Show current content of the input buffer
Displays the current content of the input buffer in the AREA window.
See also
■ LUA ■ LUA.List
Format: LUA.SET <index> %<format> <value>
<format>: Byte | Word | Long | Quad | TByte | HByte | PByte | SByte BE | LE
<index> The byte position of the input buffer to be written.
Byte, Word, … Data size.• Byte (8-bit accesses) Word (16-bit accesses)• TByte (24-bit accesses) Long (32-bit accesses)• PByte (40-bit accesses) HByte (48-bit accesses)• SByte (56-bit accesses) Quad (64-bit accesses)
BE, LE Define byte endianness: big endian or little endian.
<value> The value to be written to the buffer.
Format: LUA.ShowInput
General Commands Reference Guide L 58 ©1989-2019 Lauterbach GmbH
LUA.ShowOutput Show current content of the output buffer
Displays the current content of the output buffer in the AREA window.The output buffer contains the return values from the Lua script. Inside the Lua script, functions from the “TRACE32 Lua Library” (lua_library.pdf) can be used to write to the output buffer.
See also
■ LUA ■ LUA.List
LUA.UNLOAD Remove a Lua script from the debugger
Removes a previously loaded Lua script from the debugger. Use LUA.List to see the current set of scripts available.
Format: LUA.ShowOutput
Format: LUA.UNLOAD <id> | <label>
General Commands Reference Guide L 59 ©1989-2019 Lauterbach GmbH
Example
See also
■ LUA ■ LUA.List
; load the Lua script lib.lua as a libraryLUA.LOAD c:\lua\lib.lua "mylib" /Library; load the Lua script jtag.lua as an executable; use default option "/Program" and default labelLUA.LOAD c:\lua\jtag.lua
; see the current list of Lua scriptsLUA.List; you should see the following:; 0 : mylib, LIB, C:\lua\lib.lua; 1 : jtag.lua, EXE, C:\lua\jtag.lua
; set input parameterLUA.SET 0x0 %l 0x12345678LUA.ShowInput
; execute the Lua script jtag.lua using its indexLUA.RUN 1; execute the Lua script jtag.lua using its labelLUA.RUN "jtag.lua"
; view the output bufferLUA.ShowOutput
; remove a Lua scriptLUA.UNLOAD 0; Note that now the Lua script with index 0 (lib.lua) is removed; and the indexing has changedLUA.List; now you should see the following; 0 : jtag.lua, EXE, C:\lua\jtag.lua; the Lua script jtag.lua now has the index 0LUA.UNLOAD "jtag.lua"
; clear the contextLUA.RESet
General Commands Reference Guide L 60 ©1989-2019 Lauterbach GmbH