|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
|
2 <html> |
|
3 <head> |
|
4 <title>Adding parameters to existing traces</title> |
|
5 <link href="../../book.css" type="text/css" rel="stylesheet"></head> |
|
6 <body> |
|
7 |
|
8 <h2>Adding parameters to existing traces</h2> |
|
9 <p>Parameters can be used to associate data to traces: integers, strings and enumerations. A parameter |
|
10 specifies the format in which the parameter is shown in the viewer and text |
|
11 label associated with the parameter. </p><p>To add parameters to existing |
|
12 traces, do the following: </p> |
|
13 <ol> |
|
14 <li>Select an existing trace from either of the following places: |
|
15 <ul> |
|
16 <li>from the source code</li> |
|
17 <li>from the TraceBuilder tree view. </li> |
|
18 </ul> |
|
19 </li> |
|
20 <li>Click the TraceBuilder menu and select <b>Add New Parameter</b>.</li> |
|
21 <li>In the <b>Parameter Name</b> field, enter the variable name you want to |
|
22 add to your trace.</li> |
|
23 <li>In the <b>Parameter Type</b> field, enter the type for your parameter.<p> |
|
24 The type defines how the parameter should be determined, for example:</p> |
|
25 <ul> |
|
26 <li><i>Signed</i> means signed integer and <i>Unsigned</i> means unsigned integer.</li> |
|
27 <li><i>Hex</i> means that the parameter is an integer, but should be shown as hexadecimal number.</li> |
|
28 <li>Also possible Enumerations are shown in the end of this list.</li> |
|
29 </ul> |
|
30 </li> |
|
31 <li>(Optional) Select a <b>Template</b> for your parameter.<br> |
|
32 The template defines pre-defined parameters that have special properties. |
|
33 <p><img src="images/add_parameter.png"></p></li> |
|
34 <li>Click <b>OK</b>. You should get this kind of change to your trace:<br><br> |
|
35 <img src="images/ost_code_2.png"></li> |
|
36 </ol> |
|
37 <p>Note that you can always edit the trace text also manually.<p> |
|
38 <p>Now you can go on to <a href="setprojectandcompile.htm">compiling your source code</a>.</p> |
|
39 |
|
40 <h5>Related tasks</h5> |
|
41 <ul> |
|
42 <li><a href="enumerations.htm">Adding and parsing Enumerations</a></li> |
|
43 <li><a href="instrumenting.htm">Instrumenting traces</a></li> |
|
44 </ul> |
|
45 |
|
46 <div id="footer">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. |
|
47 License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>.</div> |
|
48 </body> |
|
49 </html> |