General Commands Reference Guide H

Transcription

1 General Commands Reference Guide H TRACE32 Online Help TRACE32 Directory TRACE32 Index TRACE32 Documents... General Commands... General Commands Reference Guide H... 1 HAnalyzer... 4 HAnalyzer tbd. 4 HAnalyzer-specific Trace Commands 4 HAnalyzer.state tbd. 4 HAnalyzer.UsbDEVice tbd. 4 Generic Trace Commands 5 HA.ACCESS Define access path to source code for trace decoding 5 HA.Arm Arm the trace 5 HA.BookMark Set a bookmark in trace listing 5 HA.BookMarkToggle Toggles a single trace bookmark 5 HA.Chart Display trace contents graphically 5 HA.CLOCK Clock to calculate time out of cycle count information 5 HA.ComPare Compare trace contents 6 HA.DISable Disable the trace 6 HA.DRAW Visualization of trace data 6 HA.EXPORT Export trace data for processing in other applications 6 HA.FILE Load a file into the file trace buffer 6 HA.Find Find specified entry in trace 6 HA.FindAll Find all specified entries in trace 6 HA.FindChange Search for changes in trace flow 6 HA.FLOWPROCESS Process flowtrace 7 HA.FLOWSTART Restart flowtrace processing 7 HA.Get Display input level 7 HA.GOTO Move cursor to specified trace record 7 HA.Init Initialize trace 7 HA.List List trace contents 7 HA.ListNesting Analyze function nesting 7 HA.LOAD Load trace file for off-line processing 7 HA.OFF Switch off 8 HA.PROfileChart Profile charts 8 HA.PROfileSTATistic Statistical analysis in a table versus time 8 HA.REF Set reference point for time measurement 8 General Commands Reference Guide H 1

2 HA.RESet Reset command 8 HA.SAVE Save trace for postprocessing in TRACE32 8 HA.STATistic Statistic analysis 8 HA.Timing Waveform of trace buffer 8 HA.TRACK Set tracking record 9 HA.View Display single record 9 HA.ZERO Align timestamps of trace and timing analyzers 9 HTM HTM CoreSight HTM (AHB Trace Macrocell) 10 HTM.AsicControl Set HTMASICCONTROL register 10 HTM.AuxTrace Auxiliary packet control 11 HTM.BusSelect Set HTMBUSSELECT register 11 HTM.BusTrigger Bus trigger definition 11 HTM.CLEAR Clear HTM.Set settings 12 HTM.CLOCK Core clock frequency 12 HTM.CycleAccurate Cycle accurate tracing 13 HTM.DataTrace Define broadcast of data accesses 14 HTM.ExtDisable Set EXTDISABLE bit 15 HTM.FifoLevel Define FIFO level 15 HTM.OFF Switch HTM off 15 HTM.ON Switch HTM on 16 HTM.Register Display HTM control registers 16 HTM.RESet Reset HTM settings 17 HTM.Set Program HTM manually 17 HTM.state Display HTM configuration window 18 HTM.SyncPeriod Set period of sync packet injection 19 HTM.Trace Trace packet control 19 HTM.TraceExclude No broadcast of data accesses within range 20 HTM.TraceID Set trace ID manually 20 HTM.TraceInclude Restrict broadcast of data accesses to range 21 HTM.TraceOFF HTM stops to emit trace information on event 21 HTM.TraceON HTM starts to emit trace information on event 22 HTM.TracePriority Set priority for the HTM manually 23 HTM.TraceTrigger Trace trigger definition 23 HTMAnalyzer HTMOnchip HTMRTS HVX HVX HVX registers (Hexagon Vector Extensions) 25 HVX.Init Initialize HVX registers 25 HVX.OFF Inhibit HVX accesses by the debugger 25 HVX.ON Permit HVX accesses by the debugger 26 General Commands Reference Guide H 2

3 HVX.Set Modify HVX registers 26 HVX.view Open HVX register window 26 Usage: (B) command only available for ICD (E) command only available for ICE (F) command only available for FIRE General Commands Reference Guide H 3

4 General Commands Reference Guide H Version 06-Nov-2017 HAnalyzer HAnalyzer tbd. HAnalyzer-specific Trace Commands HAnalyzer.state tbd. HAnalyzer.state tbd. HAnalyzer.UsbDEVice tbd. HAnalyzer.UsbDEVice tbd. General Commands Reference Guide H 4

5 Generic Trace Commands HA.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 101). HA.Arm Arm the trace See command <trace>.arm in 'General Commands Reference Guide T' (general_ref_t.pdf, page 104). HA.BookMark Set a bookmark in trace listing See command <trace>.bookmark in 'General Commands Reference Guide T' (general_ref_t.pdf, page 113). HA.BookMarkToggle Toggles a single trace bookmark See command <trace>.bookmarktoggle in 'General Commands Reference Guide T' (general_ref_t.pdf, page 115). HA.Chart Display trace contents graphically See command <trace>.chart in 'General Commands Reference Guide T' (general_ref_t.pdf, page 117). HA.CLOCK Clock to calculate time out of cycle count information See command <trace>.clock in 'General Commands Reference Guide T' (general_ref_t.pdf, page 148). General Commands Reference Guide H 5

6 HA.ComPare Compare trace contents See command <trace>.compare in 'General Commands Reference Guide T' (general_ref_t.pdf, page 149). HA.DISable Disable the trace See command <trace>.disable in 'General Commands Reference Guide T' (general_ref_t.pdf, page 151). HA.DRAW Visualization of trace data See command <trace>.draw in 'General Commands Reference Guide T' (general_ref_t.pdf, page 155). HA.EXPORT Export trace data for processing in other applications See command <trace>.export in 'General Commands Reference Guide T' (general_ref_t.pdf, page 175). HA.FILE Load a file into the file trace buffer See command <trace>.file in 'General Commands Reference Guide T' (general_ref_t.pdf, page 188). HA.Find Find specified entry in trace See command <trace>.find in 'General Commands Reference Guide T' (general_ref_t.pdf, page 190). HA.FindAll Find all specified entries in trace See command <trace>.findall in 'General Commands Reference Guide T' (general_ref_t.pdf, page 194). HA.FindChange Search for changes in trace flow See command <trace>.findchange in 'General Commands Reference Guide T' (general_ref_t.pdf, page 195). General Commands Reference Guide H 6

7 HA.FLOWPROCESS Process flowtrace See command <trace>.flowprocess in 'General Commands Reference Guide T' (general_ref_t.pdf, page 196). HA.FLOWSTART Restart flowtrace processing See command <trace>.flowstart in 'General Commands Reference Guide T' (general_ref_t.pdf, page 196). HA.Get Display input level See command <trace>.get in 'General Commands Reference Guide T' (general_ref_t.pdf, page 197). HA.GOTO Move cursor to specified trace record See command <trace>.goto in 'General Commands Reference Guide T' (general_ref_t.pdf, page 199). HA.Init Initialize trace See command <trace>.init in 'General Commands Reference Guide T' (general_ref_t.pdf, page 209). HA.List List trace contents See command <trace>.list in 'General Commands Reference Guide T' (general_ref_t.pdf, page 213). HA.ListNesting Analyze function nesting See command <trace>.listnesting in 'General Commands Reference Guide T' (general_ref_t.pdf, page 224). HA.LOAD Load trace file for off-line processing See command <trace>.load in 'General Commands Reference Guide T' (general_ref_t.pdf, page 228). General Commands Reference Guide H 7

8 HA.OFF Switch off See command <trace>.off in 'General Commands Reference Guide T' (general_ref_t.pdf, page 237). HA.PROfileChart Profile charts See command <trace>.profilechart in 'General Commands Reference Guide T' (general_ref_t.pdf, page 243). HA.PROfileSTATistic Statistical analysis in a table versus time See command <trace>.profilestatistic in 'General Commands Reference Guide T' (general_ref_t.pdf, page 259). HA.REF Set reference point for time measurement See command <trace>.ref in 'General Commands Reference Guide T' (general_ref_t.pdf, page 276). HA.RESet Reset command See command <trace>.reset in 'General Commands Reference Guide T' (general_ref_t.pdf, page 277). HA.SAVE Save trace for postprocessing in TRACE32 See command <trace>.save in 'General Commands Reference Guide T' (general_ref_t.pdf, page 279). HA.STATistic Statistic analysis See command <trace>.statistic in 'General Commands Reference Guide T' (general_ref_t.pdf, page 301). HA.Timing Waveform of trace buffer See command <trace>.timing in 'General Commands Reference Guide T' (general_ref_t.pdf, page 423). General Commands Reference Guide H 8

9 HA.TRACK Set tracking record See command <trace>.track in 'General Commands Reference Guide T' (general_ref_t.pdf, page 429). HA.View Display single record See command <trace>.view in 'General Commands Reference Guide T' (general_ref_t.pdf, page 434). HA.ZERO Align timestamps of trace and timing analyzers See command <trace>.zero in 'General Commands Reference Guide T' (general_ref_t.pdf, page 436). General Commands Reference Guide H 9

10 HTM HTM CoreSight HTM (AHB Trace Macrocell) CoreSight HTM (AHB Trace Macrocell) provides address and data trace information on AHB bus accesses. For configuration, use the TRACE32 command line, a PRACTICE script (*.cmm), or the HTM.state window. The following TRACE32 commands are available to configure the HTM..AsicControl.AuxTrace.BusSelect.BusTrigger.CLEAR.CLOCK.CycleAccurate.DataTrace.ExtDisable.FifoLevel.OFF.ON.Register.RESet.Set.state.SyncPeriod.Trace.TraceExclude.TraceID.TraceInclude.TraceOFF.TraceON.TracePriority.TraceTrigger HTM.AsicControl Set HTMASICCONTROL register HTM.AsicControl <code> Informs TRACE32 about the target settings of the HTMASICCONTROL register..state General Commands Reference Guide H 10

11 HTM.AuxTrace Auxiliary packet control HTM.AuxTrace OFF HML+HPROT0+HTRANS+HW+HRESP+WS HPROT01+HTRANS+HW+HRESP+WS Specifies signals for the auxiliary packets. Please refer to the HTM Technical Reference Manual for details..state HTM.BusSelect Set HTMBUSSELECT register HTM.BusSelect <bus> Informs TRACE32 about the target settings of the HTMBUSSELECT register..state HTM.BusTrigger Bus trigger definition HTM.BusTrigger <address> <range> <access> <access>: Fetch Access Read Write Any Generates a trigger on HTMEXTOUT0, if the specified event occurs. HTM.BusTrigger 0x1000 Write.state General Commands Reference Guide H 11

12 HTM.CLEAR Clear HTM.Set settings HTM.CLEAR Switches the HTM ON, clears the trace and all setting done by the command HTM.Set..state HTM.CLOCK Core clock frequency HTM.CLOCK <core_clock> Used to calculate absolute timings out of cycle count packets (HTM.CycleAccurate ON)..state General Commands Reference Guide H 12

13 HTM.CycleAccurate Cycle accurate tracing HTM.CycleAccurate [ON OFF] HTM.CycleTrace (deprecated) OFF ON Trace information is time-stamped by TRACE32. Cycle count packets are inserted into the trace stream. The calculation of the time stamps is based on: The cycle count information And the core clock specified with the command Trace.CLOCK <core_clock>. Trace.Clock 50.MHz HTM.CycleAccurate ON.state General Commands Reference Guide H 13

14 HTM.DataTrace Define broadcast of data accesses HTM.DataTrace ON OFF <data> <data>: Address ReadAddress WriteAddress Data Read Write Defines how data accesses are broadcast. OFF ON Address ReadAddress WriteAddress Data Read Write No information about data accesses is broadcast. The address and data information is broadcast for all data accesses. Only the address information for data accesses is broadcast. Only the address information for read accesses is broadcast. Only the address information for write accesses is broadcast. Only the data information for data accesses is broadcast. The address and data information is broadcast for read accesses. The address and data information is broadcast for write accesses. tbd. CorrelatedReadAddress CorrelatedWriteAddress CorrelatedAddress CorrelatedData CorrelatedRead CorrelatedWrite Correlated HTM.DataTrace Read.state General Commands Reference Guide H 14

15 HTM.ExtDisable Set EXTDISABLE bit HTM.ExtDisable [ON OFF] Informs TRACE32 about the target settings of the EXTDISABLE bit in HTMCONTROL register..state HTM.FifoLevel Define FIFO level HTM.FifoLevel <bytes> If the HTM FIFO is almost full (available free space smaller the FIFO level) data packets and auxiliary packets are not sent. Data suppressed packets are sent instead. HTM.FifoLevel 16..state HTM.OFF Switch HTM off HTM.OFF Disables HTM functionality..state General Commands Reference Guide H 15

16 HTM.ON Switch HTM on HTM.ON Enables HTM functionality..state HTM.Register Display HTM control registers HTM.Register [/<option>] <option>: SpotLight DualPort Track CORE <core_number> Displays the HTM control registers. The contents will vary with the HTM version. <option> For a description of the options, see PER.view..state General Commands Reference Guide H 16

17 HTM.RESet Reset HTM settings HTM.RESet Resets the settings in the HTM.state window to default and resets the HTM register..state HTM.Set Program HTM manually HTM.Set tbd..state General Commands Reference Guide H 17

18 HTM.state Display HTM configuration window HTM.state Displays the HTM configuration window. A A For descriptions of the commands in the HTM.state window, please refer to the HTM.* commands in this chapter. Example: For information about the TracePriority box, see HTM.TracePriority..AsicControl.AuxTrace.BusSelect.BusTrigger.CLEAR.CLOCK.CycleAccurate.DataTrace.ExtDisable.FifoLevel.OFF.ON.Register.RESet.Set.SyncPeriod.Trace.TraceExclude.TraceID.TraceInclude.TraceOFF.TraceON.TracePriority.TraceTrigger General Commands Reference Guide H 18

19 HTM.SyncPeriod Set period of sync packet injection HTM.SyncPeriod [<packets>] Sets the number of regular HTM packets which will be output to the trace stream between two synchronization packets. <packets> If omitted, then the default number of regular packets between synchronization packets is chosen by the debugger or the chip..state HTM.Trace Trace packet control HTM.Trace [ON OFF] ON (default) OFF Trace information is generated and triggers/external signals are activated as programmed. No trace packets are generated. Only triggers/external signals are activated as programmed..state General Commands Reference Guide H 19

20 HTM.TraceExclude No broadcast of data accesses within range HTM.TraceExclude <range> [<range>...] <access> <access>: Fetch Access Read Write Any This command can be used to exclude data accesses within the specified <address_range> from broadcasting. The number of exclude-ranges depends on the number of address comparator pairs provided by the HTM. HTM.TraceExclude 0x1d00--0x1dff.state HTM.TraceID Set trace ID manually HTM.TraceID <id> TRACE32 automatically assigns an appropriate source ID to the HTM. This command allows the user to specify his trace ID for the HTM..state General Commands Reference Guide H 20

21 HTM.TraceInclude Restrict broadcast of data accesses to range HTM.TraceInclude <range> [<range>...] <access> <access>: Fetch Access Read Write Any This command can be used to restrict the broadcasting of data accesses to the specified <address_range>. The number of include-ranges depends on the number of address comparator pair provided by the HTM. HTM.TraceInclude Write 0x4A x4B state HTM.TraceOFF HTM stops to emit trace information on event HTM.TraceOFF <address> <address_range> <access> <access>: Fetch Access Read Write Any Advises the HTM to stop emitting trace information when the specified event becomes true..state General Commands Reference Guide H 21

22 HTM.TraceON HTM starts to emit trace information on event HTM.TraceON <address> <address_range> <access> <access>: Fetch Access Read Write Any Advises the HTM to start emitting trace information when the specified event becomes true. HTM.TraceON flags Read HTM.TraceOFF V.RANGE(flags[3]) Read ; advise the HTM to start to ; emit trace information when ; the contents of the address ; flags is read ; advise the HTM to stop to ; emit trace information when ; the contents of the variable ; flags[3] is written... HTMAnalyzer.List ; display the trace contents.state General Commands Reference Guide H 22

23 HTM.TracePriority Set priority for the HTM manually HTM.TracePriority <priority> TRACE32 automatically assigns an appropriate priority to the HTM. This command allows the user to change the priority for the HTM trace information..state HTM.TraceTrigger Trace trigger definition HTM.TraceTrigger <address> <range> <access> <access>: Fetch Access Read Write Any Generates a trigger for the trace, if the specified event occurs. A trigger to the trace requires that the trigger output of the HTM is connected to the TPIU. The following options are possible: The trigger output of the HTM is hard-wired to the TPIU on the chip. The trigger output of the HTM can be connected to the TPIU via CTI (Cross-Trigger Interface). No connection between the trigger output and the TPIU can be established. HTM.TraceTrigger 0x1000 Write.state General Commands Reference Guide H 23

24 HTMAnalyzer The HTMAnalyzer command group allows to display and analyze the address and data tracing broadcast by the CoreSight AHB Trace Macrocell (HTM). The AHB address and data information is broadcast off-chip via the Trace Port Interface Unit (TPIU) and is recorded into the trace memory (Analyzer) of a TRACE32 trace tool (e.g. PowerTrace II). HTMOnchip The HTMOnchip command group allows to display and analyze the address and data tracing broadcast by the CoreSight AHB Trace Macrocell (HTM). The AHB address and data information is sent to the ETB onchip trace memory (Onchip). HTMRTS Real-time processing for HTM trace. General Commands Reference Guide H 24

25 HVX HVX Hexagon only HVX registers (Hexagon Vector Extensions) HVX.Init HVX.OFF HVX.ON HVX.Set HVX.view HVX() HVX Function in General Functions HVX.Init Hexagon only Initialize HVX registers HVX.Init HVX.RESet (deprecated) Sets all registers of the active HVX extension to zero. HVX HVX.view HVX.OFF Hexagon only Inhibit HVX accesses by the debugger HVX.OFF Inhibits accesses to the HVX by the debugger. Usually required until the HVX is on. HVX HVX.view General Commands Reference Guide H 25

26 HVX.ON Hexagon only Permit HVX accesses by the debugger HVX.ON Permits accesses to the HVX by the debugger (default). HVX HVX.view HVX.Set Hexagon only Modify HVX registers HVX.Set <register> <value> [/<option>] Modifies the HVX registers. For a description of the <options>, see Register.view. HVX HVX.view HVX.view Hexagon only Open HVX register window HVX.view [/<option>] Opens an HVX register window. For a description of the <options>, see Register.view. HVX HVX.Init HVX.OFF HVX.ON HVX.Set General Commands Reference Guide H 26