📄 comma105.htm
字号:
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<meta name="GENERATOR" content="Quadralay WebWorks Publisher Professional Edition 6.0.5">
<meta name="TEMPLATEBASE" content="book_html">
<meta name="LASTUPDATED" content="12/04/03 16:07:46">
<title>trace</title>
<STYLE TYPE="text/css">
<!--
span.Signal { text-transform: uppercase; font-family: Verdana }
-->
</STYLE>
</head>
<body link="#3366CC" vlink="#9999CC" text="#000000" alink="#0000CC" bgcolor="#FFFFFF"
background="images/backgrnd.gif">
<p><img src="images/stlogo.gif" width="106" height="83" align="left"
alt="logo here!"> </p>
<table width="331" border="0" align="right" cellpadding="0" cellspacing="0">
<tr>
<td><a href="a_refman.htm"><img src="images/navtoc.gif" width="84" height="23"
border="0" alt="TOC"> </a></td>
<td><a href="comma104.htm"><img src="images/navprev.gif" width="80" height="23"
border="0" alt="PREV"> </a></td>
<td><a href="comma106.htm"><img src="images/navnext.gif" width="83" height="23"
border="0" alt="NEXT"> </a></td>
<td><a href="a_refmaa.htm"><img src="images/navidx.gif" width="84" height="23"
border="0" alt="INDEX"> </a></td>
</tr>
</table>
<p><br clear="all">
</p>
<hr align="left">
<blockquote>
<h2>
<a name="1208871"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">trace</font>
</h2><hr>
<p>
<a name="1267822"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Control trace function</font>
</p>
<h3>
<a name="1208873"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Command type</font>
</h3>
<p>
<a name="1227076"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Trace</font>
</p>
<h3>
<a name="1208875"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Tool environment</font>
</h3>
<p>
<a name="1228166"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><strong>st20run</strong></font>
</p>
<h3>
<a name="1208876"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Synopsis</font>
</h3>
<a name="1208877"> </a><font size=2 face=Courier><strong>trace [<font size=2 face=Courier><strong><em>options</em></strong></font>]<br></strong></font>
<h3>
<a name="1208878"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Options</font>
</h3>
<p>
<a name="1230802"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>-on</strong></font></b></font>
<br>
<dl><dl> <dl>
<dt> <a name="1230804"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Switch tracing on.</font>
</dl>
</dl></dl>
<p>
<a name="1230806"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>-off</strong></font></b></font>
<br>
<dl><dl> <dl>
<dt> <a name="1230808"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Switch tracing off.</font>
</dl>
</dl></dl>
<p>
<a name="1270756"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>-clear</strong></font></b></font>
<br>
<dl><dl> <dl>
<dt> <a name="1270767"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Clear trace data on the host.</font>
</dl>
</dl></dl>
<p>
<a name="1275906"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>-filter </strong></font><font size=2 face=Courier><strong><em>expr</em></strong></font></b></font>
<br>
<dl><dl> <dl>
<dt> <a name="1275914"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Set a new trace filter expression. <font size=2 face=Courier><strong><em>expr</em></strong></font> is a string that contains a command language expression. Applies when <font size=2 face=Courier><strong>trace</strong></font> is used in conjunction with the <font size=2 face=Courier><strong>tracedump</strong></font> command.</font>
</dl>
</dl></dl>
<p>
<a name="1230810"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>-reset</strong></font></b></font>
<br>
<dl><dl> <dl>
<dt> <a name="1230812"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Clear all settings. Deconfigure the trace hardware and clear trace data on the host.</font>
</dl>
</dl></dl>
<p>
<a name="1270776"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>-download</strong></font></b></font>
<br>
<dl><dl> <dl>
<dt> <a name="1270788"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Force any trace data on the target to be downloaded to the host.</font>
</dl>
</dl></dl>
<p>
<a name="1276755"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>-nonintrusivedownload</strong></font></b></font>
<br>
<dl><dl> <dl>
<dt> <a name="1276756"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Do not stall the CPU when downloading trace data.</font>
<dt> <a name="1276757"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">By default, the CPU is stalled whilst trace data is downloaded.</font>
</dl>
</dl></dl>
<p>
<a name="1274397"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>-print</strong></font></b></font>
<br>
<dl><dl> <dl>
<dt> <a name="1264679"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Print trace data statistics.</font>
</dl>
</dl></dl>
<h3>
<a name="1208887"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Debugger context</font>
</h3>
<p>
<a name="1208888"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">The <font size=2 face=Courier><strong>spaceid</strong></font> from the debugger context specifies the address space on which tracing is set.</font>
</p>
<h3>
<a name="1208889"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Description</font>
</h3>
<p>
<a name="1208890"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Used to manually control trace and to view trace acquisition statistics.</font>
</p>
<p>
<a name="1275927"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">The <font size=2 face=Courier><strong>-print</strong></font> report details statistics and status of the trace data held on the host. It also returns the enable state of the trace hardware and the current trace filter string. Filter update pending is set to <font size=2 face=Courier><strong>yes</strong></font> if</font>
</p>
<ul>
<p> <font size=2 face="Verdana, Arial, Helvetica, sans-serif"><li ><a name="1275945"> </a>data has been uploaded to the host from the target, or</font></p>
<p> <font size=2 face="Verdana, Arial, Helvetica, sans-serif"><li ><a name="1275949"> </a>the trace filter string has been updated, since the last execution of the tracedump command without the tracedump option <font size=2 face=Courier><strong>-inhibittablegeneration</strong></font>.</font></p>
</ul>
<p>
<a name="1276903"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">The <font size=2 face=Courier><strong>-filter</strong></font> option may be used to reduce the output from the <font size=2 face=Courier><strong>tracedump</strong></font> command to only display records that match a selection criteria. For example, the <font size=2 face=Courier><strong>-filter</strong></font> option can be used to allow <font size=2 face=Courier><strong>tracedump</strong></font> to only display records that result from execution of a specific function, or to only display records that did not occur in a specific task name.</font>
</p>
<p>
<a name="1276915"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">The <font size=2 face=Courier><strong>-filter</strong></font> option is followed by a string <font size=2 face=Courier><strong><em>expr</em></strong></font>, that contains a command language expression. For each trace record (line) that <font size=2 face=Courier><strong>tracedump</strong></font> may output, each field in that record is first assigned to a command language variable. <font size=2 face=Courier><strong><em>expr</em></strong></font> is evaluated for that trace record, and this expression may use the trace field command language variable. If <font size=2 face=Courier><strong><em>expr</em></strong></font> evaluates as the value 0, then <font size=2 face=Courier><strong>tracedump</strong></font> does not output that record, otherwise it is a non-0 value and the record is output.</font>
</p>
<p>
<a name="1276938"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">The name of the trace field command language variable is derived from the name of the <font size=2 face=Courier><strong>tracedump</strong></font> field selection option by prefixing the option name with the symbol <font size=2 face=Courier><strong>_ST_trace_</strong></font>. </font>
</p>
<p>
<a name="1276984"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">For example, for the <font size=2 face=Courier><strong>tracedump</strong></font> field selection option <font size=2 face=Courier><strong>toiptrfunctionname</strong></font> the command language variable <font size=2 face=Courier><strong>_ST_trace_toiptrfunctionname</strong></font> contains the value of the <font size=2 face=Courier><strong>tracedump</strong></font> field output.</font>
</p>
<p>
<a name="1276901"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">The default value for <font size=2 face=Courier><strong><em>expr</em></strong></font> is "1" which always evaluates as a non-0 value and so all records are displayed.</font>
</p>
<p>
<a name="1276958"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">For example, to only display trace records between record index 4 and 14, do:</font>
</p>
<a name="1276956"> </a><font size=2 face=Courier><strong>trace -filter "_ST_trace_recordid >=4 && _ST_trace_recordid <= 14"<br></strong></font>
<p>
<a name="1276949"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">For more information see the <em>Trace and Profile</em> chapter of the <em>ST20 Embedded Toolset User Manual</em>.</font>
</p>
<h3>
<a name="1208891"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Example</font>
</h3>
<a name="1208892"> </a><font size=2 face=Courier><strong>trace -on⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -