+ +

T-trace

+ +

The T-trace is a profiling tool that allows you to optimize application performance by measuring and visualizing instrumented function calls in the Tizen platform. It helps you to understand what the system is doing while your application is running.

+ + + + + + + + + + +

Note
To operate the T-trace, you must first install Python (2.7.x) and Google Chrome™ on your computer.

+ +

T-trace Dialog

+ +

The following figure illustrates the T-trace dialog elements.

+ +

Figure: T-trace dialog

T-trace dialog

+ +

Tags +
You can define which categories to trace. Currently, the T-trace provides several Tizen platform-specific categories, and a few low level system information categories. The Linux kernel and Tizen platform modules (such as EFL, xorg, and mmfw) support the categories.
+
To enable the categories you want, select the applicable check boxes.
Bootup +
Select the check box to reboot the target and start tracing for the platform boot. When tracing is finished, the result can be displayed on a viewer.
Reset +
Select the check box to return all tags and options in the T-trace dialog to their default values.
Time(secs) +
Set the time period to be used for tracing. You can select a predefined value of 10, 30, 60, or 120 seconds, enter a value of your own, or select manual (which means that no specific tracing time is set and you stop tracing when you want).
Buffer(kb) +
Set the target buffer size. You can select a predefined value of 1024, 2048, 4096, or 10240 kb. If the set buffer size is insufficient, the oldest trace data is overwritten to accommodate new data.
Main button +
The main button allows you to control the tracing process based on the current operation state:
+
- Ready to trace +
  When the Ready to trace button is displayed, click it to start tracing based on the selected tags and settings.
- No Connection +
  When the No Connection button is displayed, you cannot perform any trace operations. Connect a target device to the computer to see the Ready to trace button.
- Waiting +
  When the Waiting button is displayed, the T-trace is working on the target and you must wait for it to finish.
- Stop +
  When the Stop button is displayed, click it to stop the tracing process. This button is displayed when the trace operation is started with the time period set to manual.
- Show result +
  When the Show result button is displayed, the tracing process is finished. Click the button to run the viewer.

+ + +

Running the T-trace

+ +

When you run the T-trace, the tracing process gathers traces during a specified time period. After tracing is finished, the T-trace processes the traces and creates a trace report in the HTML format.

+ +

To run the T-trace in the Tizen IDE:

Set up the target device for the debugging mode and connect it to your computer with a USB cable.
Install your application on the target device.
In the Project Explorer view, right-click the project and select Profile as > Profile With T-trace. +
The T-trace for TizenSDK dialog opens.
+
In the dialog, set the tracing options and click Ready to trace.

+ +

You can also run the T-trace from the command line. The T-trace script is located in the <TIZEN_SDK>/tools/ttrace directory, and it requires that Python (2.7.x) or later to be installed on your computer.

+ +

To run the T-trace from the command line:

Open command prompt and move to the T-trace script directory: +
```
+$ cd TIZEN_SDK_HOME/tools/ttrace
```
+
Run the T-trace script with applicable options: +
```
+$ python ttrace.py â-time=10 â-buf-size=10240 âo output_filename.html
```
+
For more information on the command options, access the help:
+
```
+$ python ttrace.py --help
```
+

+ + +

Viewing the Tracing Result

+ +

The results are stored in the <TIZEN_SDK>/tools/ttrace/trace directory. Both a .text binary-format trace file and a .html result report file are generated. The files are named with a timestamp (YYYYMMDDHHMMSS).

+ +

You can view the results using the Google Chrome™ browser as a viewer. The viewer is launched with the result report when you click Show result in the T-trace dialog. If you run the T-trace from the command line, open the result report manually in the viewer.

+ +

Figure: T-trace viewer

T-trace viewer

+ +

The following table lists the keyboard shortcuts available in the viewer.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Table: Viewer keyboard shortcuts
Key	Description
w	Zoom into the trace timeline.
s	Zoom out of the trace timeline.
a	Pan left on the trace timeline.
d	Pan right on the trace timeline.
e	Center the trace timeline on the current mouse location.
g	Show the grid at the start of the currently selected task.
Shift+g	Show the grid at the end of the currently selected task.
Right arrow	Select the next event on the currently selected timeline.
Left arrow	Select the previous event on the currently selected timeline.
Double-click	Zoom into the trace timeline.
Shift+Double-click	Zoom out of the trace timeline.

+ +

Result Report

+ +

The result report allows you to analyze various performance aspects of your application. The report shows how your application interacts with the Tizen framework, according to category tags you selected for tracing. The following table shows the kind of information each tag provides.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Table: Tag-specific information
Tag	Description
Application manager	Shows how the application life-cycle management works.
Camera	Shows the workflow of the camera module.
Input	Shows how to process user input events from, for example, touch and keyboard.
Video	Shows the workflow of the video and radio system.
Web	Shows the workflow of the Web Runtime and Web Engine.
Window manager	Shows the state changes of the window system, such as show, hide, resize, and rotation.
Image	Shows information on image processing, such as rotation, resize, and encoding.

+ +

Application life-cycle analysis example:

+ +

You can analyze your application life-cycle using the T-trace in both native and Web applications. The following figure illustrates the various states of a Tizen application. The T-trace shows you the state changes as well as how much time is consumed at each state while the application is launching, running, and terminating.

+ +

Figure: Application life-cycle

Application life-cycle

+ +

To analyze the application life-cycle, run the T-trace with the Application manager tag. For Web applications, enable the Web tag too. When the tracing process is finished, the T-trace generates a report, as shown in the following figure.

+ +

Figure: Application life-cycle report

Application life-cycle report

+ +

In the section for Kernel and application processes, you can see your application state changes and system information, such as the CPU frequency and kernel task scheduling on a common timeline. With this information, you can investigate in which state your application spends unnecessary time and then make changes to optimize the time usage.

+ + + + + +

Phonenumber-utils

Tizen enables you to parse and format phone numbers. The Phonenumber-utils APIs are implemented with the libphonenumber opensource library.

The main features of the Phonenumber-utils API include:

Retrieving the location information +

You can get the location based on the phone number, region, and language using the phone_number_get_location_from_number() function. If the function cannot provide the location with the passed language, it uses English.

+ +

Formatting the phone number +

You can format the phone number string based on the region using the dash ("-") and space (" ") characters using the phone_number_get_formatted_number() function.

Phonenumber-utils

Tizen enables you to parse and format phone numbers. The Phonenumber-utils APIs are implemented with the libphonenumber opensource library.

The main features of the Phonenumber-utils API include:

Retrieving the location information +

+ +

Formatting the phone number +

You can format the phone number string based on the region using the dash ("-") and space (" ") characters using the phone_number_get_formatted_number() function.

Getting the Location

To get the location from the phone number:

+ +

To use the functions and data types of the Phonenumber-utils API (in mobile and wearable applications), include the <phone_number.h> header file in your application:

+#include <phone_number.h>
+

To get the location, use the phone_number_get_location_from_number() function:

+ +

int ret;
+char *location = NULL;
+
+ret = phone_number_get_location_from_number("0222550114", PHONE_NUMBER_REGION_REPUBLIC_OF_KOREA, 
+                                            PHONE_NUMBER_LANG_ENGLISH, &location);
+if (PHONE_NUMBER_ERROR_NONE == ret) 
+{
+   // Use location
+   // location â "Seoul"
+   dlog_print(DLOG_DEBUG, LOG_TAG, "location=%s", location);
+}
+free(location);
+

+ +

Formatting the Number

To format the phone number:

+ +

To use the functions and data types of the Phonenumber-utils API (in mobile and wearable applications), include the <phone_number.h> header file in your application:

+#include <phone_number.h>
+

Use the region to format the phone number:

+ +

int ret;
+char *formatted_number = NULL;
+
+ret = phone_number_get_formatted_number("0222550114", PHONE_NUMBER_REGION_REPUBLIC_OF_KOREA, 
+                                        &formatted_number);
+if (PHONE_NUMBER_ERROR_NONE == ret) 
+{
+   // Use formatted_number
+   // formatted_number - "02-2255-0114"
+   dlog_print(DLOG_DEBUG, LOG_TAG, "formatted_number=%s", formatted_number);
+}
+free(formatted_number);
+

+ +

T-trace

T-trace Dialog

Running the T-trace

Viewing the Tracing Result

Result Report

Phonenumber-utils

Phonenumber-utils

Phonenumber-utils: Parsing and Formatting Phone Numbers

Warm-up

Getting the Location

Formatting the Number