|
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
|
2 <html> |
|
3 <head> |
|
4 <meta http-equiv="content-type" content="text/html; charset=iso-8859-1"> |
|
5 <title>Release Notes</title> |
|
6 <link href="../book.css" rel="stylesheet" type="text/css"> |
|
7 </head> |
|
8 |
|
9 <body bgcolor="#FFFFFF"> |
|
10 <h2>Release Notes</h2> |
|
11 |
|
12 <h4>TraceViewer – Version 2.6.0</h4> |
|
13 |
|
14 <p>Released 20th June 2010</p> |
|
15 <ul> |
|
16 <li><a href="#description">Product description</a></li> |
|
17 <li><a href="#features">Main features</a></li> |
|
18 <li><a href="#newfeatures">What's new</a></li> |
|
19 <li><a href="#installation">Installation notes</a></li> |
|
20 <li><a href="#requirements">System requirements</a></li> |
|
21 <li><a href="#compissues">Compatibility issues</a></li> |
|
22 <li><a href="#issues">Known issues</a></li> |
|
23 </ul> |
|
24 |
|
25 <h3><a name="description"></a>Product description</h3> |
|
26 |
|
27 <p>TraceViewer is a tool for tracing a target device. The device can be |
|
28 connected to a PC via USB connection. TraceViewer gathers the trace data |
|
29 directly to the host side for further manipulation.</p> |
|
30 |
|
31 <p>The TraceViewer tool can be started either by selecting the <b>Carbide > |
|
32 TraceViewer</b> menu item or via <b>Window > Show View > Other...</b> |
|
33 under <b>Carbide Extensions</b> category. </p> |
|
34 |
|
35 <h3><a name="features"></a>Main features</h3> |
|
36 <ul> |
|
37 <li>UI for displaying traces received from the connected device. </li> |
|
38 <li>Search and filter traces from the view. </li> |
|
39 <li>Write traces to an ASCII or binary log file.</li> |
|
40 <li>Color and count the traces.</li> |
|
41 <li>Trace variable values shown in the traces.</li> |
|
42 <li>Activate Open System Traces (OST) from the device during run-time.</li> |
|
43 <li>Saving trace configurations in a file. </li> |
|
44 </ul> |
|
45 |
|
46 <h3><a name="newfeatures"></a>What's new</h3> |
|
47 <ul> |
|
48 <li>New: Added max ASCII line length (10000 characters) check to prevent |
|
49 possible freeze up in case of too much data.</li> |
|
50 <li>New: Opened log file name is shown in the TraceViewer name tab.</li> |
|
51 <li>Bug fix: Sometimes, other DataReader was left alive to background when |
|
52 changing Data Format.</li> |
|
53 <li>Bug fix: TraceViewer didn't save connection settings over Carbide.c++ |
|
54 reboot.</li> |
|
55 <li>Bug fix: Reloading of the Dictionaries were not always reliable.</li> |
|
56 <li>Changed: Fixed some FindBugs warnings.</li> |
|
57 <li>Changed: TraceViewer is now released under EPL license.</li> |
|
58 </ul> |
|
59 |
|
60 <h3><a name="installation"></a>Installation notes</h3> |
|
61 |
|
62 <p>To install the tool, do the following:</p> |
|
63 <ul> |
|
64 <li>The tool already comes in SymSEE installation of Carbide.c++</li> |
|
65 <li>To upgrade to newer version:</li> |
|
66 <li>Unzip everything inside the zip into Carbide "dropins" folder. If you |
|
67 already had old TraceViewer go to "Help - About Carbide.c++ - Installation |
|
68 details - TraceViewer" and click "Update...</li> |
|
69 </ul> |
|
70 |
|
71 <h3><a name="requirements"></a>System requirements</h3> |
|
72 |
|
73 <p>Basic requirements:</p> |
|
74 <ul> |
|
75 <li>Windows XP</li> |
|
76 <li>Carbide.c++ 2.5.0 or newer.</li> |
|
77 </ul> |
|
78 |
|
79 <p>Additional requirements:</p> |
|
80 <ul> |
|
81 <li>Connection to a target device using USB.</li> |
|
82 </ul> |
|
83 <!-- |
|
84 <h5>How to upgrade from older versions</h5> |
|
85 |
|
86 <p>The new version of the extension comes with updated versions of common utility plug-ins. Once |
|
87 you have installed the new set of plug-ins, do the following: </p><ol> |
|
88 <li>Open the command prompt. </li> |
|
89 <li>Go to the Carbide.c++ installation directory on your PC (for example, <code>C:\Program Files\Nokia\Carbide.c++ v1.2</code>).</li> |
|
90 <li>Enter the following command to start Carbide.c++: <code>"Carbide.c++.exe"-clean</code></li> |
|
91 </ol> |
|
92 <p>Starting up Carbide.c++ with the <code>clean</code> option ensures that the latest versions of the plug-ins are loaded. </p> |
|
93 --> |
|
94 |
|
95 <h3><a name="compissues"></a>Compatibility issues</h3> |
|
96 <ul> |
|
97 <li>N/A</li> |
|
98 </ul> |
|
99 |
|
100 <h3><a name="issues"></a>Known issues</h3> |
|
101 <ul> |
|
102 <li>N/A</li> |
|
103 </ul> |
|
104 |
|
105 <h3>Version history</h3> |
|
106 |
|
107 <h5>Version 2.5.3 – 9th April 2010</h5> |
|
108 <ul> |
|
109 <li>New: Dropped traces notification is now added before the timestamp of the |
|
110 trace.</li> |
|
111 <li>New: Support for formatting to length in trace parameters (e.g. "My var = |
|
112 %02x").</li> |
|
113 <li>New: Added possibility to create shortcut keys to some TraceViewer |
|
114 actions. This can be done from "Keys" preference page in Carbide.c++.</li> |
|
115 <li>New: Possibility to create Activation trigger so that when a specific |
|
116 trace is received, activation is sent to the device.</li> |
|
117 </ul> |
|
118 |
|
119 <h5>Version 2.4.12 – 16th February 2010</h5> |
|
120 <ul> |
|
121 <li>Requires Carbide.c++ 2.5.0 or newer to work!</li> |
|
122 <li>New: New connection preference option called "Current connection". If |
|
123 this is selected, user can change the currently active connection easily |
|
124 either from Remote Connection view or from a new Trim widget showing the |
|
125 current connection.</li> |
|
126 <li>New: Support for some XTIv3 tracebox control messages.</li> |
|
127 <li>New: Possibility to add comments to traces when taking log file. This |
|
128 will result in a separate .meta file when the log file is closed. Both |
|
129 files are needed to see the comments when opening the log file again.</li> |
|
130 <li>New: Added "Deactivate rule" actions for line count and variable tracing |
|
131 rules in Property View.</li> |
|
132 <li>New: Support for Ctrl+Home and Ctrl+End keys. Ctrl+Home jumps to the |
|
133 first trace and Ctrl+End to the last one.</li> |
|
134 <li>New: Support for searching again with F3.</li> |
|
135 <li>Changed: Cleaned up the code.</li> |
|
136 <li>Bug fix: Setting trigger when in pause state sets wrong pause mode icon |
|
137 to toolbar.</li> |
|
138 <li>Bug fix: Line count and variable tracing rules were count again even no |
|
139 changes were done.</li> |
|
140 <li>Bug fix: Triggering didn't work with filtering on.</li> |
|
141 <li>Bug fix: Regression: Copying data from the view didn't work.</li> |
|
142 <li>Bug fix: One trace too much was copied to clipboard in some cases.</li> |
|
143 <li>Bug fix: Regression: Trace text was missing when there is Thread ID but |
|
144 no CPU ID.</li> |
|
145 <li>Bug fix: Sometimes, trace offset went wrong by one which caused view to |
|
146 look weird and coloring not to work properly.</li> |
|
147 <li>Bug fix: Sometimes, the "Traces selected X. Time difference: X" text |
|
148 could not fit in to the Trim.</li> |
|
149 </ul> |
|
150 |
|
151 <h5>Version 2.3.8 – 8th December 2009</h5> |
|
152 <ul> |
|
153 <li>New: Option to not to show component and group name in OST traces.</li> |
|
154 <li>New: API function to get trace name with component, group and trace |
|
155 ID.</li> |
|
156 <li>New: Line count and variable tracing rules can now be added and edited |
|
157 with right mouse button from Trace Property View.</li> |
|
158 <li>New: Option to save currently visible traces to a ASCII log file.</li> |
|
159 <li>New: Combined option to hide Thread ID to option to hide CPU ID from the |
|
160 OST traces.</li> |
|
161 <li>New: Support for XTIv3 messages containing multipart OST messages inside |
|
162 them.</li> |
|
163 <li>Changed: TraceProperties.timeFromPreviousTrace now contains milliseconds |
|
164 passed from previous trace. TraceProperties.timestampString doesn't contain |
|
165 that information anymore but only the actual timestamp.</li> |
|
166 <li>Bug fix: Drag and Drop of rules in various dialogs didn't work.</li> |
|
167 <li>Bug fix: Progressbar didn't advance from 0% when saving current traces to |
|
168 ASCII log.</li> |
|
169 <li>Bug fix: CPU ID was not shown correctly on real SMP HW if it was |
|
170 something else than CPU 0.</li> |
|
171 </ul> |
|
172 |
|
173 <h5>Version 2.2.17 – 13th October 2009</h5> |
|
174 <ul> |
|
175 <li>Requires Carbide.c++ 2.0.4 or newer to work!</li> |
|
176 <li>New: Option to turn off displaying Thread ID in OST traces.</li> |
|
177 <li>New: Added BTrace variables into info dialog.</li> |
|
178 <li>New: Added new alternative client API (TraceViewerAPI2 class). The client |
|
179 of the API gets notifications when connection status or connection |
|
180 preferences are changed.</li> |
|
181 <li>New: Support for multipart BTrace traces.</li> |
|
182 <li>New: Color headers and data parts of multipart BTraces in info dialog. |
|
183 </li> |
|
184 <li>Changed: Reworked some help files.</li> |
|
185 <li>Changed: When using OST protocol, OST TraceCore protocol header is added |
|
186 to outgoing messages.</li> |
|
187 <li>Changed: Modified older client API implementation (TraceViewerAPI class) |
|
188 to not disconnect active connection in case there are currently registered |
|
189 TraceViewerAPI2 using the connection.</li> |
|
190 <li>Bug fix: Copy to clipboard didn't always work as it should.</li> |
|
191 <li>Bug fix: Retake machine readable log button didn't disappear |
|
192 correctly.</li> |
|
193 <li>Bug fix: More than one ZIP was offered for reload in certain |
|
194 circumstances.</li> |
|
195 <li>Bug fix: It was possible to crash Filter dialog so that it didn't open |
|
196 anymore.</li> |
|
197 <li>Bug fix: It was possible to freeze TraceViewer by opening specific ASCII |
|
198 log.</li> |
|
199 <li>Bug fix: When connection settings are set through the API, empty selected |
|
200 connection from UI.</li> |
|
201 <li>Bug fix: Possible extended length bytes were not read properly.</li> |
|
202 <li>Bug fix: Double-clicking group table in Activation dialog removed group |
|
203 filtering.</li> |
|
204 <li>Bug fix: Connecting with no Remote Connection set will now pop up a |
|
205 preferences dialog.</li> |
|
206 <li>Bug fix: Opening a trace information dialog when another trace |
|
207 information dialog was open caused coloring of the hex string not to |
|
208 work.</li> |
|
209 </ul> |
|
210 |
|
211 <h5>Version 2.1.12</h5> |
|
212 <ul> |
|
213 <li>Requires Carbide.c++ 2.0.2 to work!</li> |
|
214 <li>New: Double-clicking a trace opens the trace location in source file |
|
215 (only for OST traces).</li> |
|
216 <li>New: syncToTrace() and syncToTimestamp() methods open the trace location |
|
217 in source file.</li> |
|
218 <li>New: New button to easily close and retake machine readable ASCII |
|
219 log.</li> |
|
220 <li>New: Support for OST v0.5.</li> |
|
221 <li>Changed everything to Symbian Foundation compatible.</li> |
|
222 <li>Changed: Send deactivation message of visible component if group states |
|
223 were not changed at all.</li> |
|
224 <li>Changed: Add event to Trace Events view when reloading changed |
|
225 Dictionaries.</li> |
|
226 <li>Changed: Send activation messages of all selected components in |
|
227 Activation dialog.</li> |
|
228 <li>Changed: In trace information dialog, header and data parts is now |
|
229 colored with different colors.</li> |
|
230 <li>Bug fix: Dictionary ZIP could not be reloaded when restarting |
|
231 TraceViewer.</li> |
|
232 <li>Bug fix: Double- or triple-clicking did not show Trim information.</li> |
|
233 <li>Bug fix: Canceling filtering could make view pause to wrong position.</li> |
|
234 </ul> |
|
235 |
|
236 <h5>Version 2.0.27</h5> |
|
237 <ul> |
|
238 <li>Switched to own branch for Carbide 2.0.</li> |
|
239 <li>New: Use Remote Connections UI from Carbide.</li> |
|
240 <li>New: Connection Settings button in Menu bar.</li> |
|
241 <li>New: TraceViewer now requires Carbide.c++ Trace license to work.</li> |
|
242 <li>New: Use OVERWRITE activation messages. Will now only send one activation |
|
243 message per component.</li> |
|
244 <li>New: Uses EPOCroot drive path from active project when trying to jump to |
|
245 source code line.</li> |
|
246 <li>New: Option to write machine readable ASCII log.</li> |
|
247 <li>New: Trace number is now a member variable of TraceProperties class.</li> |
|
248 <li>New: New API functions: syncToTraceNumber, syncToTimestamp.</li> |
|
249 <li>New: New API functions: saveCurrentTracesToLog, openLogFile, |
|
250 getDictionaryComponents.</li> |
|
251 <li>New: Automatically reload changed Dictionaries option.</li> |
|
252 <li>New: API function getDictionaryComponents() now also returns trace |
|
253 list.</li> |
|
254 <li>Changed: Speed up clearing the view.</li> |
|
255 <li>Changed: TraceViewerAPI.getDictionaryComponents() doesn't return null |
|
256 anymore.</li> |
|
257 <li>Updated: Help files.</li> |
|
258 <li>Bug fix: Sometimes, the view contained one trace too much.</li> |
|
259 <li>Bug fix: Remote Connections UI was not updated when connecting.</li> |
|
260 <li>Bug fix: Color rules were lost if there was Groups defined.</li> |
|
261 <li>Bug fix: Log dialog gave access to plain log options even when not |
|
262 writing plain log.</li> |
|
263 <li>Bug fix: It was possible to freeze TraceViewer with simultaneous async |
|
264 commands.</li> |
|
265 <li>Bug fix: Canceling filtering didn't work very well.</li> |
|
266 <li>Bug fix: Filters were not marked after switching to advanced filter |
|
267 view.</li> |
|
268 <li>Bug fix: Thread ID was not written separately to machine readable ASCII |
|
269 log.</li> |
|
270 <li>Bug fix: Added coprocessors went to wrong offset if TraceViewer view was |
|
271 not yet initialized.</li> |
|
272 <li>Bug fix: TraceViewer didn't ask about changing Data Format with USB in |
|
273 certain case.</li> |
|
274 <li>Bug fix: Variable tracing history didn't always show up correctly.</li> |
|
275 <li>Bug fix: API function connect() should not pop up error message.</li> |
|
276 <li>Bug fix: Open previously opened Dictionaries dialog offered also removed |
|
277 Dictionaries.</li> |
|
278 <li>Bug fix: Traces are not decoded after closing and reopening |
|
279 TraceViewer.</li> |
|
280 <li>Bug fix: Missed notification about number of selected traces if using |
|
281 CTRL + A.</li> |
|
282 </ul> |
|
283 |
|
284 <h5>Version 1.0.21</h5> |
|
285 <ul> |
|
286 <li>Made changes for releasing to Carbide 2.0.</li> |
|
287 <li>Made changes to be able to release into SymSEE.</li> |
|
288 <li>Made to work with TraceCommon feature.</li> |
|
289 <li>New: TraceViewer API functions: getTraceComponentName and |
|
290 getTraceGroupName.</li> |
|
291 <li>New: TraceViewer can now open ZIP files containing Dictionary decode |
|
292 files.</li> |
|
293 <li>New: TraceViewer will now show a warning icon in a toolbar if decode file |
|
294 is changed after loading.</li> |
|
295 <li>Updated: TraceViewer help files to follow Carbide help guidelines.</li> |
|
296 <li>Updated: Loading of Dictionary files is now much faster.</li> |
|
297 <li>Updated: Added preference option to show class name and function name |
|
298 before the trace text.</li> |
|
299 <li>Changed: Don't disable apply button from activation dialog when apply is |
|
300 clicked.</li> |
|
301 <li>Changed: Activation dialog now shows components sorted by the name.</li> |
|
302 <li>Changed: Removed Configurations preference page. Importing and exporting |
|
303 configuration can bow be done from File - Import / Export in Eclipse |
|
304 menu.</li> |
|
305 <li>Changed: Changed default binary log extension from .log to .bin.</li> |
|
306 <li>Bug fix: Saving and loading configuration XML files did not work if |
|
307 workspace path contains spaces.</li> |
|
308 <li>Bug fix: If loaded lots of Dictionaries, "open previous files" dialog was |
|
309 too big.</li> |
|
310 <li>Bug fix: Confusing text "defaultActivations.xml" under the configurations |
|
311 tag.</li> |
|
312 <li>Bug fix: Trace EventView doesn't open if there is error when loading |
|
313 Dictionary.</li> |
|
314 <li>Bug fix: Parameters were not correctly decoded when using OST traces with |
|
315 USB connection.</li> |
|
316 <li>Bug fix: Activation information of groups doesn't anymore disappear when |
|
317 appending more decode files.</li> |
|
318 <li>Bug fix: Configurations in Activation dialog now shows the file path and |
|
319 only allows file to be changed using the "Change file" button.</li> |
|
320 <li>Bug fix: Rule text was replicated from rule name when editing a old |
|
321 rule.</li> |
|
322 <li>Bug fix: Wrong text copied to search window after clicking twice on |
|
323 trace.</li> |
|
324 <li>Bug fix: Wrong help in search dialog.</li> |
|
325 <li>Bug fix: When using loadDecodeFile API function, Trace Activation dialog |
|
326 was not updated.</li> |
|
327 </ul> |
|
328 |
|
329 <div id="footer"> |
|
330 <p>Copyright © 2007-2010 Nokia Corporation and/or its subsidiary(-ies).<br> |
|
331 All rights reserved. <br> |
|
332 This component and the accompanying materials are made available <br> |
|
333 under the terms of "Eclipse Public License v1.0" <br> |
|
334 which accompanies this distribution and is available <br> |
|
335 at the URL <a |
|
336 href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>. |
|
337 <br> |
|
338 <br> |
|
339 Initial Contributors:<br> |
|
340 Nokia Corporation - initial contribution <br> |
|
341 <br> |
|
342 Contributors:<br> |
|
343 Description:</p> |
|
344 |
|
345 <p></p> |
|
346 </div> |
|
347 </body> |
|
348 </html> |