-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\r
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">\r
-<head>\r
- <meta http-equiv="content-type" content="text/html; charset=utf-8" />\r
- <meta http-equiv="X-UA-Compatible" content="IE=9" />\r
- <link rel="stylesheet" type="text/css" href="../css/styles.css" />\r
- <link rel="stylesheet" type="text/css" href="../css/snippet.css" />\r
- <script type="text/javascript" src="../scripts/snippet.js"></script> \r
- <script type="text/javascript" src="../scripts/jquery.util.js" charset="utf-8"></script>\r
- <script type="text/javascript" src="../scripts/common.js" charset="utf-8"></script>\r
- <script type="text/javascript" src="../scripts/core.js" charset="utf-8"></script>\r
- <script type="text/javascript" src="../scripts/search.js" charset="utf-8"></script>\r
-\r
- <title>Emulator</title> \r
-</head>\r
-\r
-<body onload="prettyPrint()" style="overflow: auto;">\r
-\r
-\r
-<div id="toc-navigation">\r
- <div id="profile">\r
- <p><img alt="Mobile" src="../images/mobile_s_wn.png"/> <img alt="Wearable" src="../images/wearable_s_wn.png"/></p>\r
- </div>\r
- <div id="toc_border"><div id="toc">\r
- <p class="toc-title">Content</p>\r
- <ul class="toc">\r
- <li><a href="#features">Using the Emulator</a></li> \r
- <li><a href="#manager">Emulator Manager</a></li>\r
- <li><a href="#hw">Using Hardware Virtualization</a></li>\r
- <li><a href="#controls">Emulator Control Keys and Menu</a></li>\r
- <li><a href="#ecp">Emulator Control Panel</a></li>\r
- <li><a href="#support">Supported Features</a></li>\r
- </ul>\r
- </div></div>\r
-</div>\r
-<div id="container"><div id="contents"><div class="content">\r
-\r
-<h1>Emulator</h1>\r
-\r
-<p>The Tizen SDK includes a virtual device Emulator. The Emulator provides the full stacks of the Tizen platform so that you can test Tizen applications before deploying them to the real target device. The Emulator is based on the open source QEMU project and comprises virtual CPU, memory, and various peripherals. Currently, the Tizen SDK only supports the x86 machine architecture for guest. You can use the <a href="#manager">Emulator Manager</a> to create and launch a Virtual Machine instance. You can communicate with the Emulator instance using the <a href="smart_dev_bridge.htm">Smart Development Bridge (SDB)</a>.</p>\r
-\r
-<p>The main features of the Emulator are:</p>\r
-<ul>\r
-<li>Providing full system emulation, including CPU, memory, and peripheral devices</li>\r
-<li>Simulating events with the <a href="#ecp">Emulator Control Panel</a></li>\r
-<li>Accelerating guest operations using host CPU or GPU</li>\r
-</ul>\r
-\r
-<p>For more information see <a href="#support">Supported Features</a>.</p>\r
-\r
-<h2 id="features" name="features">Using the Emulator</h2>\r
-\r
-<p>To run applications on the Emulator:</p>\r
-\r
-<ol>\r
-<li>Start the Emulator through the <a href="#manager">Emulator Manager</a>.\r
-<p>You can launch the Emulator from both the Emulator Manager and the command line. If you are using the command line, you can modify the <a href="emulator_features.htm#startup">start-up options</a>.</p></li>\r
-<li>While running the Emulator, you can use <a href="#controls">the control keys and context menu</a> or the <a href="#ecp">Emulator Control Panel</a> to control the Emulator. You can use <a href="emulator_features.htm">extended features</a> while running applications, such as a shared directory, multi-point touch, and a Webcam.</li>\r
-</ol>\r
-\r
-<h2 id="manager" name="manager">Emulator Manager</h2>\r
-\r
-<p>To start the Emulator quickly:</p>\r
-<ol>\r
-<li>Start the Emulator Manager:\r
-<ul>\r
- <li>By using the Desktop or Start menu, go to:\r
-\r
- <table>\r
- <caption>Table: Starting the Emulator Manager</caption>\r
- <tbody>\r
- <tr>\r
- <th style="text-align:center;margin-left:auto;margin-right:auto;">Ubuntu</th>\r
- <th style="text-align:center;margin-left:auto;margin-right:auto;">Windows®</th>\r
- <th style="text-align:center;margin-left:auto;margin-right:auto;">Mac OS®</th>\r
- </tr>\r
- <tr>\r
- <td><strong>Desktop > Applications > Emulator Manager</strong>:\r
- <p><img alt="Ubuntu shortcut" src="../images/emulator_manager_linux_shortcut.png"/></p></td>\r
- <td><strong>Start > All Programs > Tizen SDK > Emulator Manager</strong>:\r
- <p><img alt="Windows shortcut" src="../images/emulator_manager_win_shortcut.png"/></p></td>\r
- <td><strong>Finder > Applications > Tizen SDK > Emulator Manager</strong>:\r
- <p><img alt="Mac OS shortcut" src="../images/emulator_manager_mac_shortcut.png"/></p></td>\r
- </tr>\r
- </tbody>\r
- </table>\r
- </li>\r
- <li> By using the Tizen IDE, click the <strong>Emulator Manager</strong> icon in the <strong>Connection Explorer</strong> view:\r
- <p align="center"><img alt="Launch" src="../images/emulator_manager_ide.png"/></p>\r
- </li>\r
-</ul>\r
-</li>\r
-<li>Select your preferred profile tab, such as mobile or wearable.</li>\r
-<li>Select <strong>Create New</strong> and click <strong>Confirm</strong>.</li>\r
-<li>Click the <strong>Launch</strong> button ( <img alt="Launch" src="../images/launch.png" /> ) or press the ENTER keyboard key.</li>\r
-<li> To stop the Emulator, right-click the Emulator and select <strong>Close</strong>.</li>\r
-</ol>\r
-\r
-\r
-<p class="figure">Figure: Emulator Manager</p>\r
-<p align="center"><img alt="Emulator Manager" src="../images/emulator_manager.png" /></p>\r
-\r
-<table class="note">\r
-<tbody>\r
- <tr>\r
- <th class="note">Note</th>\r
- </tr>\r
- <tr>\r
- <td class="note">To run the application faster, switch on <strong>CPU VT</strong> and <strong>GPU</strong>. If <strong>CPU VT</strong> is disabled, check the <a href="#hw">Using Hardware Virtualization</a> section for more information. If <strong>GPU</strong> is disabled, <a href="https://developer.tizen.org/downloads/sdk/installing-sdk/prerequisites-tizen-sdk" target="_blank">install the latest vendor-provided graphic driver</a>.</td>\r
- </tr>\r
- </tbody>\r
- </table>\r
-\r
-<p>You can also create a new virtual machine (VM) with the <a href="#manager-cli">Emulator Manager CLI</a>.</p>\r
-\r
-<p>The created VM is added under the current tab. The name of tab, <span style="font-family: Courier New,Courier,monospace"><Profile></span>, refers to the image profile. You can create a VM by using a custom image in <strong>Base Image</strong> of the detail view. The background color of a custom VM is blue.</p>\r
- \r
-<p>You can also export a base image of the VM and manipulate the VM:</p>\r
-<ul>\r
-<li>To create a VM, select <strong>Create New</strong> and click <strong>Confirm</strong>.</li>\r
-<li>To create a base image of a VM, select the VM and <strong>Export as</strong>, and enter a name and location for the base image.</li>\r
-<li>To modify a VM, click the <strong>Modify</strong> icon ( <img alt="Modify icon" src="../images/mod_icon.png" /> ), make the appropriate changes, and click <strong>Confirm</strong>.</li>\r
-<li>To delete a VM, click <strong>Delete</strong> or press the DELETE keyboard key (<strong>fn + Delete</strong> in Mac OS® X).</li>\r
-<li>To launch a VM, click the <strong>Launch</strong> button ( <img alt="Launch" src="../images/launch.png" /> ) or press the ENTER keyboard key.</li>\r
-</ul>\r
-\r
-\r
-<h3 id="vm" name="vm">Virtual Machine</h3>\r
-<p>A virtual machine (VM) is a set of hardware options including the file system image. The Emulator Manager controls the virtual machines. When you launch the Emulator, you can specify the VM that you want to customize. Each VM has its own Emulator file system image. In other words, different VMs have different states of Emulators.</p>\r
-<table class="note">\r
-\r
- <tbody>\r
- <tr>\r
- <th class="note">Note</th>\r
- </tr>\r
- <tr>\r
- <td class="note">If you update the <span style="font-family: Courier New,Courier,monospace">EMULATOR_IMAGE</span> package on Tizen SDK Install Manager, existing VMs are not launched properly as the Base Image file is modified. To use the existing VMs after updating, the Emulator Manager provides the 'creating a base image' feature through the <strong>Export as</strong> button. With this functionality, you can keep the existing VMs in the new Base Image.</td>\r
- </tr>\r
- </tbody>\r
- </table>\r
-\r
-<p>You can set the following VM details:</p>\r
-<ul>\r
-<li>Name\r
-<p>The following rules apply for naming a VM:</p>\r
-<ul>\r
-<li>The length of the name must be at most 20 characters.</li>\r
-<li>Different VMs must not have the same name.</li>\r
-<li>Only the following characters are accepted: -, _, 0-9, a - z, and A - Z</li>\r
-</ul></li>\r
-\r
-<li>Base Image\r
-<p>You can use the default base image. You can also change the base image and choose another image when you create a VM by clicking <strong>Create New</strong> under the "mobile-custom/wearable-custom" tab folder. This new VM is added under the "each custom" group. The correct image file extension of the custom base image is <span style="font-family: Courier New,Courier,monospace">.x86</span>.</p></li>\r
-\r
-<li>Display Resolution\r
-<p>Note that the following resolution has its own default display density.</p>\r
-<ul>\r
- <li>Mobile\r
- <ul>\r
- <li>480 x 800 (WVGA)</li>\r
- <li>540 x 960 (qHD)</li>\r
- <li>720 x 1280 (HD)</li>\r
- </ul></li>\r
- <li>Wearable\r
- <ul>\r
- <li>320 x 320</li>\r
- <li>360 x 360</li>\r
- <li>360 x 480</li>\r
- </ul></li> \r
-</ul>\r
-</li>\r
-\r
-<li>Display Density\r
-<p>DPI (Dots Per Inch) value of the Emulator. The DPI depends on the display resolution.</p>\r
-<ul>\r
- <li>Mobile\r
- <ul>\r
- <li>233 (480 x 800)</li>\r
- <li>220 (540 x 960)</li>\r
- <li>294 (720 x 1280)</li>\r
- </ul></li>\r
- <li>Wearable\r
- <ul>\r
- <li>316 (320 x 320)</li>\r
- <li>302 (360 x 360)</li>\r
- <li>300 (360 x 480)</li>\r
- </ul></li>\r
-</ul>\r
-</li>\r
-\r
-<li>Skin\r
-<p>The VM UI style. Select 1 or more of the available skins. The skin depends on the display resolution.</p></li>\r
-\r
-<li>Processors\r
-<p>The number of CPUs.</p></li>\r
-\r
-\r
-<li>RAM Size\r
-<p>The RAM size.</p>\r
-\r
-<table class="note">\r
-\r
- <tbody>\r
- <tr>\r
- <th class="note">Note</th>\r
- </tr>\r
- <tr>\r
- <td class="note">In Windows®, only the 512 MB size is available.</td>\r
- </tr>\r
- </tbody>\r
- </table>\r
- \r
-<ul>\r
-<li>512 MB</li>\r
-<li>768 MB</li>\r
-<li>1024 MB</li>\r
-</ul></li>\r
-\r
-<li>File Sharing\r
-<p>You can share a directory between the host PC and the Emulator. If you want to use this feature, set the value to <strong>ON</strong> and define the input directory to share in the <strong>directory</strong> field. For more information, see <a href="emulator_features.htm#file">Sharing a Directory</a>.</p></li>\r
-\r
-<li>CPU VT\r
-<p>The Emulator supports hardware virtualization. It is kvm on Ubuntu and HAX on Windows®. If the host CPU supports hardware virtualization and a hardware virtualization module is installed, you can change this value. For more information, see <a href="#hw">Using Hardware Virtualization</a>.</p></li>\r
-\r
-<li>GPU\r
-<p>The Emulator supports hardware OpenGL® acceleration. If the host graphic card driver supports hardware acceleration and you select <strong>ON</strong>, the feature operates properly. Otherwise, do not try to make the Emulator support hardware acceleration. If the GPU option is enabled, the rendering performance of the video player or camera can degrade.</p>\r
-</li>\r
-\r
-<li>OpenGL® ES version\r
-<p>You can select the OpenGL® ES version you want to use in Mac OS®.</p>\r
-<ul>\r
- <li>v2.0 & v3.0</li>\r
- <li>v1.1 & v2.0</li>\r
-</ul>\r
-\r
-<table class="note">\r
- <tbody>\r
- <tr>\r
- <th class="note">Note</th>\r
- </tr>\r
- <tr>\r
- <td class="note">If GPU acceleration is set to <strong>OFF</strong> or <strong>Disable</strong>, this option is not available.</td>\r
- </tr>\r
- </tbody>\r
- </table>\r
-</li>\r
-\r
-<li>Advanced Option\r
-<p>You can attach and detach devices.</p>\r
-<ul>\r
- <li>Mobile\r
- <ul>\r
- <li>Camera: virtual, Webcam</li>\r
- <li>Sensor: accelerometer, gyroscope, geo-magnetic, proximity, light, haptic, pressure, ultraviolet, heartbeat rate meter</li>\r
- <li>Device: battery</li>\r
- <li>Jack: earjack, charger, USB</li>\r
- </ul></li>\r
- <li>Wearable\r
- <ul>\r
- <li>Camera: virtual, Webcam</li>\r
- <li>Sensor: accelerometer, gyroscope, geomagnetic, proximity, light, haptic, pressure, ultraviolet, heartbeat rate meter</li>\r
- <li>Device: battery</li>\r
- <li>Jack: charger, USB</li>\r
- </ul></li>\r
-</ul>\r
-</li>\r
-\r
-</ul>\r
-\r
-<h3 id="manager-cli" name="manager-cli">Emulator Manager CLI</h3>\r
-\r
-<p>You can create, modify, delete, and list your VMs through the command line interface commands. The CLI binary is located in:</p>\r
- <ul>\r
- <li>In Ubuntu:\r
- <p><span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>/tools/emulator/bin/em-cli</span></p></li>\r
- <li>In Windows®:\r
- <p><span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>\tools\emulator\bin\em-cli.bat</span></p></li>\r
- </ul>\r
-\r
-<p>For more information, see the CLI help messages.</p>\r
-\r
-<p class="figure">Figure: Emulator Manager command line</p> \r
-<p align="center"><img alt="Emulator Manager command line" src="../images/emulator_cli.png" /></p> \r
-\r
-\r
-<h2 id="hw" name="hw">Using Hardware Virtualization</h2>\r
-\r
-<p>To run the application faster, the Tizen x86 Emulator exploits <a href="http://www.linux-kvm.org/page/Main_Page" target="_blank">KVM</a> (Kernel-based Virtual Machine in Linux) or <a href="https://developer.tizen.org/sdk/haxm" target="_blank">HAX</a> (Hardware Accelerated eXecution in Windows® and Mac OS® X) with HW virtualization support.</p> \r
-<p>If the <strong>CPU VT</strong> is disabled in the <strong>Detail</strong> view on the Emulator Manager, check the following prerequisites and install KVM or HAX.</p>\r
-\r
-\r
-<h3 id="prerequisite" name="prerequisite">Prerequisites</h3>\r
-\r
-<p>To use HW virtualization, you need:</p>\r
-\r
-<ul>\r
-<li>In Ubuntu:\r
-<p>To use KVM, you need a processor that supports HW virtualization. Both Intel and AMD have developed those extensions for their processors (Intel VT-x/AMD-V). Check whether the CPU supports HW virtualization with the following command:</p> \r
-<pre class="prettyprint">\r
-$egrep -c '(vmx|svm)' /proc/cpuinfo</pre>\r
-\r
-<p>If the output of the command is <span style="font-family: Courier New,Courier,monospace">0</span>, the CPU does not support HW virtualization. Otherwise, it does. </p>\r
-<p>The HW virtualization feature can also be disabled on the BIOS setting; check the setting and enable it if you need the feature.</p></li>\r
-\r
-<li>In Windows®:\r
-<p>To use HAX, you need Intel VT-x-supported CPU, and you must enable the NX-related setting in the PC BIOS.</p> </li>\r
-\r
-<li>In Mac OS® X:\r
-<p>To use HAX, install EFI-related updates on your Intel-based Mac system. For more information, see <a href="http://support.apple.com/kb/HT1237" target="_blank">EFI and SMC firmware updates for Intel-based Macs</a>.</p> </li>\r
-</ul>\r
-\r
-\r
-<h3 id="install" name="install">Installing KVM or HAX</h3>\r
-\r
-<p>To install KVM or HAX:</p>\r
-\r
-<ul>\r
-<li>In Ubuntu:\r
-<p>No installation is required for KVM.</p> \r
-</li>\r
-<li>In Windows® and Mac OS® X:\r
-<p>The HAXM driver is installed during the Tizen SDK installation. See the installation manual on the <a href="https://developer.tizen.org/sdk/haxm" target="_blank">Tizen developer site</a>.</p>\r
-<table class="note">\r
-\r
- <tbody>\r
- <tr>\r
- <th class="note">Note</th>\r
- </tr>\r
- <tr>\r
- <td class="note">\r
- <p>If the installation fails with a VT-related message, check the CPU feature and BIOS settings. If the installation fails with an NX-related message, enable NX (or PAE and DEP) -related item in the BIOS. In addition, make sure that the operating system supports the NX feature (for more information, see <a href="http://msdn.microsoft.com/en-us/library/windows/hardware/ff542275%28v=vs.85%29.aspx" target="_blank">MSDN</a>).</p>\r
-</td>\r
- </tr>\r
- </tbody>\r
- </table></li></ul>\r
- \r
-<p>No configuration is required for KVM or HAX.</p>\r
-\r
-\r
-<h3 id="run" name="run">Running the Emulator</h3>\r
-<p>To run the Emulator with HW virtualization support in the Emulator Manager, set the <strong>CPU VT</strong> field to <strong>ON</strong>. The field is disabled if your system cannot support HW virtualization.</p>\r
-<p>You can also run the Emulator with HW virtualization support from the command line, by including the <span style="font-family: Courier New,Courier,monospace">-enable-kvm</span> (in Ubuntu) or <span style="font-family: Courier New,Courier,monospace">-enable-hax</span> (in Windows® and Mac OS® X) option in the start-up command.</p>\r
-\r
-\r
-<h2 id="controls" name="controls">Emulator Control Keys and Menu</h2>\r
-\r
-<p>The Tizen Emulator provides a variety of control keys and menus.</p>\r
-\r
-<h3 id="phone" name="phone">Profile-specific Skin</h3>\r
-<p>The profile-specific skin has a real device-shaped image frame, and its hardware keys are on the main window skin. You can <a href="emulator_features.htm#skin">configure the profile-specific skin</a>.</p>\r
-\r
-\r
-<p class="figure">Figure: Profile-specific skin Emulator</p>\r
-\r
-<p align="center"><img alt="Profile-specific skin Emulator Mobile" src="../images/emulator_profile_mobile.png" /> <img alt="Profile-specific skin Emulator Wearable O" src="../images/emulator_profile_wearable_o.png" /> <img alt="Profile-specific skin Emulator Wearable" src="../images/emulator_profile_wearable.png" /></p>\r
-\r
-<h3 id="general" name="general">General Purpose Skin</h3>\r
-\r
-<p>While <a href="#phone">profile-specific skin</a> provides a realistic skin and hardware keys, the general purpose skin shows a consistent frame on every state of resolution, scale, or rotation and enables you to change the Emulator display resolution to custom values. You can also see the key window.</p>\r
-\r
-<table class="note">\r
- <tbody>\r
- <tr>\r
- <th class="note">Note</th>\r
- </tr>\r
- <tr>\r
- <td class="note">The layout of the general purpose skin is not configurable like the profile-specific skin.</td>\r
- </tr>\r
- </tbody>\r
-</table>\r
-\r
-<ul>\r
-<li>Key window\r
-<p>The key window consists of virtual hardware keys, which are embedded in profile-specific skins. You can use it as a remote controller of its main Emulator window. You can move it to any position separate from the main window or dock it to the right side of the main window. If it is docked with the main window, both windows can be moved together on the screen.</p>\r
-<p>You can make the key window appear or disappear through the Context Menu or a <a href="keyboard_shortcuts.htm#emulator">shortcut key</a>.</p>\r
-\r
-</li>\r
-<li>Pair tag\r
-<p>The color of the pair tag indicates which main window is paired with the key window. The color changes every time the Emulator boots.</p>\r
-</li>\r
-</ul>\r
-\r
-<p>The following figure illustrates the general purpose skin Emulator.</p>\r
-\r
-<p class="figure">Figure: General purpose skin Emulator</p>\r
-<p align="center"><img alt="General purpose skin Emulator Mobile" src="../images/emulator_general_mobile.png" /> <img alt="General purpose skin Emulator Wearable" src="../images/emulator_general_wearable.png" /></p>\r
-\r
-<table class="note">\r
- <tbody>\r
- <tr>\r
- <th class="note">Note</th>\r
- </tr>\r
- <tr>\r
- <td class="note">You can create a custom resolution Emulator by using the <a href="#manager-cli">Emulator Manager CLI</a>, and launch it with the general purpose skin. It is not guaranteed that all the applications are correctly shown in the custom resolution.</td>\r
- </tr>\r
- </tbody>\r
-</table>\r
-\r
-<h3 id="controlkeys" name="controlkeys">Control Keys</h3>\r
-<p>The following hardware keys are available on the Emulator:</p>\r
-<ul>\r
- <li><strong>Menu</strong> (mobile only)\r
- <p>When you tap, it opens a list of options available for the current screen.</p>\r
- </li>\r
- <li><strong>Home</strong> (mobile only)\r
- <p>If you long-press the <strong>Home</strong> key, the Task switcher application opens as in a real device.</p>\r
- </li> \r
- <li><strong>Back</strong>\r
- <p>When you tap, it returns to the previous screen.</p>\r
- </li> \r
- <li><strong>Power</strong>\r
- <p>You can power off the display by clicking the <strong>Power</strong> key in most general situations. \r
- Sometimes, the display does not power off though you click the <strong>Power</strong> key. \r
- This is to guarantee the operation of a current application, such as the Stopwatch in the Clock App. \r
- If you click <strong>Power</strong> or <strong>Home</strong> key again, the display is powered on.</p>\r
- </li>\r
- <li><strong>Volume Up</strong> and <strong>Volume Down</strong> (mobile only)\r
- <p>You can control the volume with the <strong>Volume Up</strong> and <strong>Volume Down</strong> keys.</p>\r
- </li>\r
-</ul>\r
-\r
-\r
-\r
-<h3 id="menu" name="menu">Context Menu</h3>\r
-<p>You can access the context menu by right-clicking on the Emulator. In the menu, you can select:</p>\r
-\r
-<ul>\r
-<li>Emulator name (the top row in the menu)\r
-<p>Display the <strong>Detailed Info</strong> window, showing the <strong>Shortcut Info</strong> and <strong>VM Info</strong> tabs. The <strong>Shortcut Info</strong> tab lists the <a href="keyboard_shortcuts.htm#emulator">Emulator keyboard shortcuts</a> and the <strong>VM Info</strong> tab defines the virtual machine details.</p>\r
-<p>In Mac OS® X: To use Emulator keyboard shortcuts, open the Keyboard Setting dialog and switch your Mac function keys option to work as standard function keys.</p>\r
-<table border="1">\r
- <caption>Table: VM Info tab</caption>\r
- <tbody>\r
- <tr>\r
- <th style="text-align:center;margin-left:auto;margin-right:auto;">Feature</th>\r
- <th style="text-align:center;margin-left:auto;margin-right:auto;">Description</th> \r
- </tr>\r
-\r
- <tr>\r
- <td>VM Name</td>\r
- <td>VM name</td>\r
- </tr>\r
-\r
- <tr>\r
- <td>Skin Name</td>\r
- <td>Skin name</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>CPU Arch</td>\r
- <td>CPU architecture</td>\r
- </tr>\r
-\r
- <tr>\r
- <td>RAM Size</td>\r
- <td>RAM size (MiB)</td>\r
- </tr>\r
-\r
- <tr>\r
- <td>Display</td>\r
- <td>Target display resolution and PPI (pixels per inch)</td>\r
- </tr>\r
-\r
- <tr>\r
- <td>CPU Virtualization</td>\r
- <td>Whether hardware virtualization is supported</td>\r
- </tr>\r
-\r
- <tr>\r
- <td>GPU Virtualization</td>\r
- <td>Whether GPU virtualization is supported</td>\r
- </tr>\r
-\r
- <tr>\r
- <td>Directory Sharing</td>\r
- <td>Path to the shared host directory</td>\r
- </tr>\r
-\r
- <tr>\r
- <td>Image Version</td>\r
- <td>Platform image version</td>\r
- </tr>\r
-\r
- <tr>\r
- <td>Image File</td>\r
- <td>Platform image file path</td>\r
- </tr>\r
-\r
- <tr>\r
- <td>Swap Image File</td>\r
- <td>Swap image file path</td>\r
- </tr>\r
-\r
- <tr>\r
- <td>Kernel File</td>\r
- <td>Kernel file path</td>\r
- </tr>\r
-\r
- <tr>\r
- <td>Kernel Log File</td>\r
- <td>Kernel log file path</td>\r
- </tr>\r
-\r
- <tr>\r
- <td>Emulator Log File</td>\r
- <td>Emulator (Qemu) log file path</td>\r
- </tr>\r
- </tbody>\r
-</table>\r
-</li>\r
-\r
-<li><strong>Always On Top</strong>\r
-<p>Select this option to keep the Emulator window on top of other windows.</p>\r
-</li>\r
-<li><strong>Rotate</strong>\r
-<p>Select either <strong>Portrait</strong>, <strong>Landscape</strong>, <strong>Reverse Portrait</strong>, or <strong>Reverse Landscape</strong> as the orientation of the Emulator.</p></li>\r
-\r
-<li><strong>Scale</strong> (mobile only)\r
-<p>Scale the size of the Emulator between 1x, 1/2x (default), 3/4x, and 1/4x.</p></li>\r
-\r
-<li><strong>Advanced > Controller</strong>\r
-<p>Show or hide the controller window.</p>\r
-<table class="note">\r
- <tbody>\r
- <tr>\r
- <th class="note">Note</th>\r
- </tr>\r
- <tr>\r
- <td class="note">The <strong>Controller</strong> menu is not supported in the profile-specific skin.</td>\r
- </tr>\r
- </tbody>\r
-</table></li>\r
-<li><strong>Advanced > Screenshot</strong>\r
-<p>Capture a screenshot of the Emulator.</p></li>\r
-\r
-<li><strong>Advanced > About</strong>\r
-<p>Display the Emulator version and build time.</p></li>\r
-\r
-<li><strong>Advanced > Force Close</strong>\r
-<p>Force the Emulator to exit. Since force stopping the Emulator can cause problems, use the <strong>Close</strong> option to exit the Emulator. Use <strong>Force Close</strong> only when absolutely necessary.</p></li>\r
-\r
-<li><strong>Shell</strong>\r
-<p>Open a Smart Development Bridge (SDB) shell command window.</p></li>\r
-\r
-<li><strong>Control Panel</strong>\r
-<p>Help to control or monitor the state of the Emulator dynamically. </p></li>\r
-\r
-<li><strong>Close</strong>\r
-<p>Exit the Emulator.</p></li>\r
-\r
-</ul>\r
-\r
-<table class="note">\r
- <tbody>\r
- <tr>\r
- <th class="note">Note</th>\r
- </tr>\r
- <tr>\r
- <td class="note">In Ubuntu, you need to change a global GNOME setting to view the menu icons:\r
- <ol>\r
- <li>In the command console, execute the <span style="font-family: Courier New,Courier,monospace">gconf-editor</span> command.</li>\r
- <li>In the tree, navigate to <strong>desktop > gnome > interface</strong>.</li>\r
- <li>Enable the <strong>menus_have_icons</strong> option.</li>\r
- </ol>\r
- </td>\r
- </tr>\r
- </tbody>\r
-</table>\r
-\r
-\r
-<h2 id="ecp" name="ecp">Emulator Control Panel</h2>\r
-\r
-<p>You can execute the Emulator Control Panel (ECP) by selecting <strong>Control Panel</strong> on the <a href="#menu">Context Menu</a> after the Emulator is successfully launched. You can control and monitor the state of the Emulator dynamically.</p> \r
-<p>The main features of ECP:</p> \r
-<ul>\r
-\r
- <li>Device Manager\r
- <p>The following table lists the Device Manager features and their availability on different profiles.</p>\r
-\r
- <table border="1">\r
- <caption>Table: Device Manager features</caption>\r
- <tbody>\r
-\r
- <tr>\r
- <th>Feature</th>\r
- <th>Mobile</th> \r
- <th>Wearable</th>\r
- <th>Description</th>\r
- </tr>\r
- \r
- <tr>\r
- <td>Device Tree</td>\r
- <td>Yes</td>\r
- <td>No</td>\r
- <td>The Device Tree is a data structure for describing hardware. \r
- You can see the device information that actually loaded in the main system bus. \r
- It shows a simple tree structure of nodes and properties. Nodes are generally a device or another bus. \r
- Properties are key-value pairs where the value can either be empty or contain an arbitrary byte stream.</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Network</td>\r
- <td>Yes</td>\r
- <td>Yes</td>\r
- <td>You can view a network device list and control the user network. \r
- To forward a remote or local port to an inside port of the Emulator, click <strong>Add port–forwarding</strong>, \r
- enter values in text boxes, and click <strong>Apply port–forwarding</strong>.</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Host Directory Sharing</td>\r
- <td>Yes</td>\r
- <td>Yes</td>\r
- <td>The specified host directory is mounted to <span style="font-family: Courier New,Courier,monospace">/mnt/host</span> to share resources. Therefore, the file transfer is possible through the host directory sharing feature without using the sdb utility.</td>\r
- </tr>\r
- \r
- </tbody> \r
- </table> </li>\r
- \r
- <li>App Manager\r
- <p>The following table lists the App Manager features and their availability on different profiles.</p>\r
- \r
- <table border="1">\r
- <caption>Table: App Manager features</caption>\r
- <tbody>\r
-\r
- <tr>\r
- <th>Feature</th>\r
- <th>Mobile</th> \r
- <th>Wearable</th>\r
- <th>Description</th>\r
- </tr>\r
- \r
- <tr>\r
- <td>Uninstaller</td>\r
- <td>No</td>\r
- <td>Yes</td>\r
- <td>You can see user-installed applications and uninstall them.</td>\r
- </tr> \r
- \r
- </tbody> \r
- </table> \r
-</li>\r
- \r
- \r
- <li>Event Injector\r
- <p>The following table lists the Event Injector features and their availability on different profiles.</p>\r
- \r
- <table border="1">\r
- <caption>Table: Event Injector features</caption>\r
- <tbody>\r
-\r
- <tr>\r
- <th colspan = "2">Feature</th>\r
- <th>Mobile</th> \r
- <th>Wearable</th>\r
- <th>Description</th>\r
- </tr>\r
- \r
- <tr>\r
- <td colspan = "2"><a href="event_injec.htm#device">Battery</a></td>\r
- <td>Yes</td>\r
- <td>Yes</td>\r
- <td>You can set the battery level using the Level slider. \r
- To set the charger status to connected or disconnected, select the appropriate Charger radio button.</td>\r
- </tr>\r
- \r
- <tr>\r
- <td colspan = "2"><a href="event_injec.htm#device">RSSI</a></td>\r
- <td>Yes</td>\r
- <td>No</td>\r
- <td>You can set the remote signal strength using the level bar.</td>\r
- </tr> \r
- \r
- <tr>\r
- <td rowspan = "6"><a href="event_injec.htm#sensor">Sensor</a></td> \r
- <td>3-Axis Sensor</td> \r
- <td>Yes</td>\r
- <td>Yes</td>\r
- <td>You can inject user acceleration, magnetic, and gyroscope values using slider bars or text input.</td> \r
- </tr> \r
- \r
- <tr>\r
- <td>Light</td> \r
- <td>Yes</td>\r
- <td>Yes</td>\r
- <td>You can inject a lux value into light sensor. \r
- If you set brightness as auto, then display will be changed by injecting light value.</td> \r
- </tr>\r
-\r
- <tr>\r
- <td>Proximity</td>\r
- <td>Yes</td>\r
- <td>Yes</td>\r
- <td>You can inject the presence of nearby objects.</td> \r
- </tr>\r
- \r
- <tr>\r
- <td>Pressure</td>\r
- <td>Yes</td>\r
- <td>Yes</td>\r
- <td>You can inject a hPa value into the pressure sensor.</td> \r
- </tr>\r
- \r
- <tr>\r
- <td>Ultraviolet</td>\r
- <td>Yes</td>\r
- <td>Yes</td>\r
- <td>You can inject an ultraviolet index.</td> \r
- </tr>\r
- <tr>\r
- <td>Heart Rate Monitor</td>\r
- <td>Yes</td>\r
- <td>Yes</td>\r
- <td>You can inject the heart rate and peek-to-peek time in milliseconds.</td> \r
- </tr> \r
-\r
- <tr>\r
- <td colspan = "2"><a href="event_injec.htm#device">Earjack</a></td>\r
- <td>Yes</td>\r
- <td>No</td>\r
- <td> You can inject adding or removing headset.</td>\r
- </tr>\r
- \r
- <tr>\r
- <td colspan = "2">Gesture</td>\r
- <td>No</td>\r
- <td>Yes</td>\r
- <td>You can inject flick up (menu button) or flick down (back button) events in the wearable profile.</td>\r
- </tr>\r
- \r
- <tr>\r
- <td colspan = "2"><a href="event_injec.htm#device">USB</a></td>\r
- <td>Yes</td>\r
- <td>Yes</td>\r
- <td>You can add or remove a USB device by setting the USB device setting to the connected or disconnected state.</td>\r
- </tr>\r
- \r
- <tr>\r
- <td colspan = "2"><a href="event_injec.htm#device">SD Card</a></td>\r
- <td>Yes</td>\r
- <td>No</td>\r
- <td>You can inject a 4, 8, 16, or 32G SD card.</td>\r
- </tr>\r
- \r
- <tr>\r
- <td colspan = "2"><a href="event_injec.htm#location">Location</a></td>\r
- <td>Yes</td>\r
- <td>Yes</td>\r
- <td>You can inject latitude and longitude values using a map, manually, or from a log file.</td>\r
- </tr>\r
- \r
- <tr>\r
- <td colspan = "2"><a href="event_injec.htm#telephony">Telephony</a></td>\r
- <td>Yes</td>\r
- <td>Yes</td>\r
- <td>You can make and receive a call through the <strong>Call</strong> tab. You can also send and receive SMS messages through the <strong>SMS</strong> tab.</td>\r
- </tr>\r
- <tr>\r
- <td colspan = "2"><a href="event_injec.htm#memory">Memory</a></td>\r
- <td>Yes</td>\r
- <td>Yes</td>\r
- <td>You can set the low memory status using the radio buttons.</td>\r
- </tr>\r
- </tbody> \r
- </table> \r
-</li>\r
-</ul>\r
-\r
- <p>Various <a href="keyboard_shortcuts.htm#ecp">keyboard shortcuts</a> are available to execute ECP tasks.</p>\r
-\r
- \r
-<h3 name="ecp-cli">Emulator Control Panel CLI</h3>\r
-\r
-<p>You can control and monitor the Tizen Emulator by using ECP CLI instead of the ECP UI tool. The ECP CLI supports all the functionalities of the ECP UI. The CLI binary is located at:</p>\r
- <ul>\r
- <li>In Ubuntu:\r
- <p><span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>/tools/emulator/bin/ecp-cli</span></p></li>\r
- <li>In Windows®:\r
- <p><span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>\tools\emulator\bin\ecp-cli.bat</span></p></li>\r
- </ul>\r
-\r
-<p>You can use the CLI in a session mode or shell mode:</p>\r
-<ul><li>Session mode\r
-<p>You can access this mode by running the binary without any parameters. The mode keeps a session until it is exited. You can exit by entering the <span style="font-family: Courier New,Courier,monospace">exit</span> command.</p></li>\r
-<li>Shell mode\r
-<p>This mode is used for one-time message handling.</p></li></ul>\r
-<p class="figure">Figure: Session and shell modes</p> \r
-<p align="center"><img alt="Session and shell modes" src="../images/ecp_cli_modes.png" /></p>\r
-\r
-<p>In Ubuntu, the bash-based auto-completion is used with the TAB button.</p>\r
-\r
-<p>The following tables list the supported commands of the ECP CLI.</p>\r
-\r
-<table>\r
-<caption>Table: CLI common commands</caption>\r
-<tbody>\r
-<tr>\r
- <th>Command</th>\r
- <th>Syntax</th>\r
- <th>Description</th>\r
-</tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">help</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">help [device]</span></td>\r
- <td>To get help, type the command as <span style="font-family: Courier New,Courier,monospace">help</span>. For more a specific device help, use the device parameter.</td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">keycode</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">keycode <key-code> [period|press|release]</span></td>\r
- <td>To enter a key code for a mobile device:\r
- <ul><li>114: volume down</li>\r
-<li>115: volume up</li>\r
-<li>139: HOME</li>\r
-<li>158: BACK</li>\r
-<li>169: MENU</li></ul></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">hmp</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">hmp <hmp command></span></td>\r
- <td>Access the QEMU human monitor protocol commands. For a list of provided commands, enter the <span style="font-family: Courier New,Courier,monospace">ecp-cli hmp help</span> command.</td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">qmp</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">qmp <qmp command></span></td>\r
- <td>Access the QEMU monitoring protocol. The commands are handled in the JSON format, and do not require <span style="font-family: Courier New,Courier,monospace">{"execute": "qmp_capabilities"}</span> to be in the control mode.\r
- <p>In the shell mode, the shell does not support the double quotation mark (") as an argument. For the JSON arguments, use \" (back space + double quotation mark) instead.</p></td>\r
- </tr>\r
- <tr>\r
- <td rowspan="3"><span style="font-family: Courier New,Courier,monospace">hds</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">hds mount <host path> <guest path></span></td>\r
- <td>Enable the host directory sharing feature between the specified <host path> and the Emulator's <guest path>. The specified path must be a folder, not a file.</td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">hds unmount <id></span></td>\r
- <td>Unmount the mounted host directory sharing path. The <span style="font-family: Courier New,Courier,monospace">id</span> is the HDS ID and you can get it from the <span style="font-family: Courier New,Courier,monospace">hds status</span> command.</td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">hds status</span></td>\r
- <td>Show the current host directory sharing status.</td>\r
- </tr>\r
- </tbody></table> \r
-\r
-<table>\r
-<caption>Table: CLI profile commands</caption>\r
-<tbody>\r
-<tr>\r
- <th>Device</th>\r
- <th>Command</th>\r
- <th>Mobile</th>\r
- <th>Wearable</th>\r
- <th>Syntax</th> \r
-</tr>\r
-\r
- <tr>\r
- <td rowspan="5">call</td> \r
- <td><span style="font-family: Courier New,Courier,monospace">dial</span></td>\r
- <td rowspan="5">Yes</td>\r
- <td rowspan="5">No</td> \r
- <td><span style="font-family: Courier New,Courier,monospace">call dial <number></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">hidden-dial</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">call hidden-dial <number></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">connect</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">call connect</span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">disconnect</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">call disconnect <call id></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">status</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">call status</span></td>\r
- </tr> \r
- <tr>\r
- <td rowspan="4">sms</td> \r
- <td><span style="font-family: Courier New,Courier,monospace">send</span></td>\r
- <td rowspan="4">Yes</td>\r
- <td rowspan="4">No</td> \r
- <td><span style="font-family: Courier New,Courier,monospace">sms send <number> <text></span></td>\r
- </tr>\r
- <tr>\r
-<td><span style="font-family: Courier New,Courier,monospace">set status</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">sms set <available | unavailable></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">status</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">sms status</span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">mms_status</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">sms mms_status</span></td>\r
- </tr> \r
- <tr>\r
- <td rowspan="4">location</td> \r
- <td><span style="font-family: Courier New,Courier,monospace">set</span></td>\r
- <td rowspan="4">Yes</td>\r
- <td rowspan="4">Yes</td> \r
- <td><span style="font-family: Courier New,Courier,monospace">location set <longitude> <latitude></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">status</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">location status</span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">stop</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">location stop</span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">file</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">location file <file-path></span></td>\r
- </tr>\r
- <tr>\r
- <td rowspan="3">battery</td> \r
- <td><span style="font-family: Courier New,Courier,monospace">level</span></td>\r
- <td rowspan="3">Yes</td>\r
- <td rowspan="3">Yes</td> \r
- <td><span style="font-family: Courier New,Courier,monospace">battery level <percent></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">charger</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">battery charger <on | off></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">status</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">battery status</span></td>\r
- </tr>\r
- <tr>\r
- <td rowspan="2">earjack</td> \r
- <td><span style="font-family: Courier New,Courier,monospace">set</span></td>\r
- <td rowspan="2">Yes</td>\r
- <td rowspan="2">No</td> \r
- <td><span style="font-family: Courier New,Courier,monospace">earjack set <3wire | 4wire | off></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">status</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">earjack status</span></td>\r
- </tr>\r
- <tr>\r
- <td rowspan="2">usb</td> \r
- <td><span style="font-family: Courier New,Courier,monospace">set</span></td>\r
- <td rowspan="2">Yes</td>\r
- <td rowspan="2">Yes</td> \r
- <td><span style="font-family: Courier New,Courier,monospace">usb set <on | off></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">status</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">usb status</span></td>\r
- </tr>\r
- <tr>\r
- <td rowspan="2">rssi</td> \r
- <td><span style="font-family: Courier New,Courier,monospace">set</span></td>\r
- <td rowspan="2">Yes</td>\r
- <td rowspan="2">No</td> \r
- <td><span style="font-family: Courier New,Courier,monospace">rssi set <0~4></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">status</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">rssi status</span></td>\r
- </tr>\r
- <tr>\r
- <td rowspan="3">SD card</td> \r
- <td><span style="font-family: Courier New,Courier,monospace">attach</span></td>\r
- <td rowspan="3">Yes</td>\r
- <td rowspan="3">No</td>\r
- <td><span style="font-family: Courier New,Courier,monospace">sdcard attach <sdcard_[ 4 | 8 | 16 | 32 ]G></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">detach</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">sdcard detach <sdcard_[ 4 | 8 | 16 | 32 ]G></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">status</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">sdcard status</span></td>\r
- </tr>\r
- <tr>\r
- <td rowspan="10">sensor</td> \r
- <td><span style="font-family: Courier New,Courier,monospace">accelerometer</span></td>\r
- <td rowspan="10">Yes</td>\r
- <td rowspan="10">Yes</td> \r
- <td><span style="font-family: Courier New,Courier,monospace">sensor accelerometer <x> <y> <z></span></td>\r
- </tr> \r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">gyroscope</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">sensor gyroscope <x> <y> <z></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">magnetic</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">sensor magnetic <x> <y> <z></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">proximity</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">sensor proximity <value></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">light</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">sensor light <value></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">pressure</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">sensor pressure <level></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">uv</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">sensor uv <level></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">hrm</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">sensor hrm <level></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">status</span></td>\r
-<td><span style="font-family: Courier New,Courier,monospace">sensor status [sensor]</span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">file</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">sensor file <sensor> <path></span></td>\r
- </tr>\r
- <tr>\r
- <td rowspan="2">low_memory</td>\r
- <td><span style="font-family: Courier New,Courier,monospace">set</span></td>\r
- <td rowspan="2">Yes</td>\r
- <td rowspan="2">Yes</td>\r
- <td><span style="font-family: Courier New,Courier,monospace">low_memory set <hard-warning | soft-warning | normal></span></td>\r
- </tr>\r
- <tr>\r
- <td><span style="font-family: Courier New,Courier,monospace">status</span></td>\r
- <td><span style="font-family: Courier New,Courier,monospace">low_memory status</span></td>\r
-\r
- </tr>\r
-\r
- </tbody></table>\r
-\r
-\r
-<h2 id="support" name="support">Supported Features </h2>\r
-\r
-<p>The Emulator provides various virtual H/W, media formats, codecs and <a href="#opengl">OpenGL® ES acceleration</a>. For better performance of the OpenGL® ES support, the Tizen Emulator exploits the latest feature of the graphic driver, so always <a href="https://developer.tizen.org/downloads/sdk/installing-sdk/prerequisites-tizen-sdk" target="_blank">install the latest vendor-provided graphic driver</a>. The Emulator, however, has some limitations and <a href="#target">differences compared to physical target devices</a>.</p>\r
-\r
-<p>The following table lists the basic features supported in the Emulator.</p>\r
-<table style="width: 100%" border="1">\r
- <caption>Table: Supported Emulator features</caption>\r
- <tbody>\r
- <tr>\r
- <th>Feature</th> \r
- <th>Detail</th> \r
- <th>Status</th>\r
- <th>Notes</th>\r
- </tr>\r
- \r
-<tr>\r
-<td>Skin</td>\r
-<td>Skins are fitted to the screen resolution:\r
-<ul>\r
-<li>Mobile\r
- <ul><li>WVGA (480 x 800, default)</li>\r
- <li>qHD (540 x 960)</li>\r
- <li>HD (720 x 1280)</li>\r
- </ul>\r
- </li> \r
-<li>Wearable\r
- <ul><li>320 x 320</li>\r
- <li>360 x 360 (default)</li>\r
- <li>360 x 480</li>\r
- </ul>\r
- </li>\r
-</ul> \r
-\r
-\r
-<p>4 orientation modes are supported:</p> \r
-<ul>\r
-<li>Portrait (default), landscape, reverse portrait, and reverse landscape</li></ul>\r
-\r
-</td>\r
-<td>Supported</td>\r
-<td>2 skin layout types are supported:\r
-<ul>\r
- <li>Profile-specific skin</li>\r
- <li>General purpose skin</li>\r
-</ul></td>\r
-</tr>\r
-<tr>\r
-<td>Touch</td>\r
-<td>Maru touch screen device</td>\r
-<td>Supported</td>\r
-<td>Multi-touch is supported.</td>\r
-</tr>\r
-\r
-\r
-<tr>\r
-<td>Key</td>\r
-<td>HW keys, host keyboard, and SW keypad</td>\r
-<td>Supported</td>\r
-<td>The host keyboard is not supported for the Wearable Emulator.</td>\r
-</tr>\r
-<tr>\r
-<td>Rotary</td>\r
-<td>360 levels of clockwise or counter-clockwise rotation</td>\r
-<td>Supported</td>\r
-<td>-</td>\r
-</tr>\r
-\r
-\r
-<tr>\r
-<td>Display</td>\r
-<td>VGA card with 100 levels of brightness control</td>\r
-<td>Supported</td>\r
-<td>-</td>\r
-</tr>\r
-\r
-<tr>\r
-<td>OpenGL® ES</td>\r
-<td>Compatible with OpenGL® ES 1.1 and 2.0\r
-<p>OpenGL® ES API pass-through via PCI</p>\r
-</td>\r
-<td>Supported\r
-</td>\r
-<td>The OpenGL® ES 1.1 functionality is not guaranteed on the Emulator, unless the graphics hardware of your computer supports OpenGL® 1.5.\r
-<p>The OpenGL® ES 2.0 functionality is not guaranteed on the Emulator, unless the graphics hardware of your computer supports OpenGL® 2.1.</p>\r
-<p>The host machine must support OpenGL® 1.4.</p></td>\r
-</tr>\r
-\r
-\r
-<tr>\r
-<td>Sound</td>\r
-<td>AC97 device</td>\r
-<td>Supported</td>\r
-<td>Audio in: \r
-<ul>\r
-<li>Make sure that the input volume of the microphone is enough to record your voice or songs on the host machine.</li> \r
-\r
-<li>On Windows® 7, inject the microphone into the host machine before starting the Emulator.</li> </ul>\r
-\r
-<p>Audio out:</p> \r
-<ul>\r
-<li>On Windows® 7, enable at least 1 audio out device before starting the Emulator. Make sure that the volume icon in the tray is not disabled.</li> \r
-<li>While the Emulator is running, do not disable the audio out device, as it can lock the audio system of the guest platform.</li></ul>\r
-</td>\r
-</tr>\r
-\r
-<tr>\r
-<td>Network connection</td>\r
-<td>Virtio</td>\r
-<td>Supported</td>\r
-<td>Raw socket protocol, such as ICMP, is not supported.</td>\r
-</tr>\r
-\r
-\r
-<tr>\r
-<td>Emulator Control Panel</td>\r
-<td>The Emulator Control Panel (ECP) supports different features depending on the device profile:\r
-<ul>\r
- <li>Mobile\r
- <ul>\r
- <li>Device Manager: Device Tree, Network, Host Directory Sharing</li>\r
- <li>Event Injector: Battery, RSSI, 3-Axis Sensor, Light, Proximity, Pressure, Ultraviolet, Heart Rate Monitor, Motion, Earjack, USB, SDCard, Location, Telephony</li>\r
- </ul>\r
- </li>\r
- <li>Wearable\r
- <ul>\r
- <li>Device Manager: Network, Host Directory Sharing</li>\r
- <li>App Manager: Uninstaller</li>\r
- <li>Event Injector: Battery, 3-Axis Sensor, Light, Proximity, Pedometer, Pressure, Ultraviolet, Heart Rate Monitor, Gesture, USB</li>\r
- </ul>\r
- </li>\r
- </ul>\r
-\r
-</td>\r
-<td>Supported</td>\r
-<td>The Emulator Control Panel is a standalone tool, which replaces the Event Injector. It helps to control and monitor the Emulator features, and can be launched from the Emulator context menu.</td>\r
-</tr>\r
-\r
-\r
-<tr>\r
-<td>Camera</td>\r
-<td>Virtual camera device is available. It can be connected to a host machine's Webcam and import an animated GIF image file.\r
-<p>Support: preview, capture, and record</p>\r
-<p>Image format: YUYV, I420, and YV12</p>\r
-<p>Attributes: brightness and contrast </p>\r
-<p>Resolution: 160 x 120, 176 x 144, 320 x 240, 352 x 288, and 640 x 480</p>\r
-<p>Video resolution: 1280 x 720 for the WVGA, 320 x 240 for the WQVGA, and 640 x 480 for the HVGA devices.</p>\r
-<p>The supported video codecs are MPEG-4, H.263, H.264, and VC-1 for both encoding and decoding.</p>\r
-</td>\r
-<td>Supported</td>\r
-<td>While recording a video using the Emulator, an audio-video synchronization error can occur depending on your computer hardware and performance.</td>\r
-</tr>\r
-\r
-<tr>\r
-<td>Bluetooth</td>\r
-<td>-</td>\r
-<td>Not supported</td>\r
-<td>-</td>\r
-</tr>\r
-\r
-<tr>\r
-<td>Wi-Fi</td>\r
-<td>-</td>\r
-<td>Not supported</td>\r
-<td>-</td>\r
-</tr>\r
-<tr>\r
-<td>Wi-Fi Direct™</td>\r
-<td>-</td>\r
-<td>Not supported</td>\r
-<td>-</td>\r
-</tr>\r
-\r
-</tbody>\r
-</table>\r
-\r
-<h3 id="opengl" name="opengl">OpenGL® ES Acceleration Support</h3>\r
-\r
-<p>For the Emulator to support OpenGL® ES acceleration, you need: </p>\r
-<ul>\r
-<li>Graphics chipset driver that supports OpenGL® 1.4 installed on the host machine</li>\r
-<li>All chipset vendors and driver versions available to support the OpenGL® 1.4 standard</li>\r
-</ul>\r
-\r
-<table class="note">\r
-\r
- <tbody>\r
- <tr>\r
- <th class="note">Note</th>\r
- </tr>\r
- <tr>\r
- <td class="note">Emulator supports only ES 1.1, ES 2.0, and EGL™ 1.4 versions.</td>\r
-\r
- </tr>\r
- </tbody>\r
- </table>\r
-\r
-<h3 id="target" name="target">Differences Between the Emulator and Target</h3>\r
-\r
-<p>The following tables describe the differences between a real target device and the Emulator. For more detailed information, see the differences in:</p>\r
-<ul>\r
-<li><a href="#input">Input system</a></li>\r
-<li><a href="#graphics">Graphics and display</a></li>\r
-<li><a href="#sensor">Virtual sensor</a></li>\r
-<li><a href="#telephony">Telephony</a></li>\r
-<li><a href="#power">Power management</a></li>\r
-<li><a href="#codec">Supported media formats and codecs</a></li>\r
-</ul>\r
-\r
-<table border="1">\r
- <caption>Table: Comparison summary</caption>\r
- <tbody>\r
- <tr>\r
- <th style="text-align:center;margin-left:auto;margin-right:auto;">Category</th>\r
- <th style="text-align:center;margin-left:auto;margin-right:auto;">Subject</th> \r
- <th style="text-align:center;margin-left:auto;margin-right:auto;">Physical target</th>\r
- <th style="text-align:center;margin-left:auto;margin-right:auto;">Emulator</th>\r
- </tr>\r
- <tr>\r
- <td rowspan ="5">Development environment</td>\r
- <td>Target</td>\r
- <td>Buy a target device or reference board (by model)</td>\r
- <td>Download the SDK (multi-profile and multi-model support)</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Network</td>\r
- <td>Need Bluetooth</td>\r
- <td>Only the network environment</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Target connection</td>\r
- <td>USB</td>\r
- <td>IPC (TCP/UDP)</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Source and package management</td>\r
- <td>Source and package for target</td>\r
- <td>Source and package for the Emulator</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Host Directory Sharing</td>\r
- <td>Not supported</td>\r
- <td>Supported</td>\r
- </tr>\r
- \r
- <tr>\r
- <td rowspan ="10">Portability</td>\r
- <td>Screen resolution</td>\r
- <td>Fixed</td>\r
- <td>Configurable</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>RAM, storage size</td>\r
- <td>Fixed</td>\r
- <td>Configurable</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>2D and 3D acceleration API</td>\r
- <td>GPU-dependent</td>\r
- <td>GPU-independent (common set)</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>CP, telephony</td>\r
- <td>Fully supported</td>\r
- <td>Partially supported (only SMS and voice call)</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Wi-Fi</td>\r
- <td>Fully supported</td>\r
- <td>Partially supported (using ethernet)</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Sensor</td>\r
- <td>Fully supported</td>\r
- <td>Partially supported (using the Emulator Control Panel)</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>PnP, external connection</td>\r
- <td>Fully supported</td>\r
- <td>Partially supported (using the Emulator Control Panel)</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Camera</td>\r
- <td>Fully supported</td>\r
- <td>Partially supported (preview, capture, recording, contrast, and brightness)</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Vibration, haptic</td>\r
- <td>Fully supported</td>\r
- <td>Not supported</td>\r
- </tr>\r
-\r
- <tr>\r
- <td>Bluetooth</td>\r
- <td>Fully supported</td>\r
- <td>Not supported</td>\r
- </tr> \r
- \r
- <tr>\r
- <td rowspan ="3">Performance</td> \r
- <td>CPU performance</td>\r
- <td>Mobile CPU</td>\r
- <td>Desktop CPU (with hardware virtualization)</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>GPU performance</td>\r
- <td>Real GPU</td>\r
- <td>Desktop GPU (relatively slow)</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>I/O performance</td>\r
- <td>Real HW I/O</td>\r
- <td>Emulated I/O (relatively slow)</td>\r
- </tr>\r
-</tbody>\r
-</table>\r
-\r
-<h4 id="input" name="input">Input System </h4>\r
-\r
-<table border="1">\r
- <caption>Table: Input differences</caption>\r
- <tbody>\r
-\r
- <tr>\r
- <th style="text-align:center;margin-left:auto;margin-right:auto;">Category</th>\r
- <th style="text-align:center;margin-left:auto;margin-right:auto;">Physical target</th> \r
- <th style="text-align:center;margin-left:auto;margin-right:auto;">Emulator</th>\r
- </tr>\r
-\r
-\r
- <tr>\r
- <td>Touch screen panel</td>\r
- <td>Real device and driver</td>\r
- <td>Virtual (VirtIO) device and driver</td>\r
- </tr>\r
- \r
- \r
- <tr>\r
- <td>Host keyboard and hardware key</td>\r
- <td>Real device and driver</td>\r
- <td>Virtual (VirtIO) device and driver</td>\r
- </tr>\r
- </tbody> \r
-</table>\r
-\r
-<h4 id="graphics" name="graphics">Graphics and display</h4>\r
-\r
- \r
- <table border="1">\r
- <caption>Table: Graphics and display differences</caption>\r
- <tbody>\r
-\r
- <tr>\r
- <th style="text-align:center;margin-left:auto;margin-right:auto;">Category</th>\r
- <th style="text-align:center;margin-left:auto;margin-right:auto;">Physical target</th> \r
- <th style="text-align:center;margin-left:auto;margin-right:auto;">Emulator</th>\r
- </tr>\r
-\r
- \r
- <tr>\r
- <td>Framebuffer device</td>\r
- <td>Display controller in the processor</td>\r
- <td>Virtual VGA card</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Backlight control</td>\r
- <td>LDI (LCD Driver IC) command</td>\r
- <td>Additional virtual device and driver</td>\r
- </tr>\r
- \r
- </tbody> \r
-</table>\r
- \r
- <h4 id="sensor" name="sensor">Virtual Sensor (Emulator Control Panel)</h4>\r
- \r
- \r
-<table border="1">\r
- <caption>Table: Virtual sensor differences</caption>\r
- <tbody> \r
-\r
- <tr>\r
- <th colspan="2">Category</th>\r
- <th>Physical target</th>\r
- <th>Emulator</th>\r
- </tr>\r
- \r
- <tr>\r
- <td rowspan="8">Sensor</td>\r
- <td>Acceleration</td>\r
- <td>Receives the actual acceleration value of the device.</td>\r
- <td>Receives the virtual acceleration value through the Emulator Control Panel.\r
- <p>If the Emulator orientation is portrait, the acceleration values are approximately 0, -9.81, and 0 degrees.</p></td>\r
-</tr>\r
- \r
- \r
- <tr>\r
- <td>Gyro</td>\r
- <td>Receives the actual gyroscope value of the device.</td>\r
- <td>Receives the virtual gyroscope value through the Emulator Control Panel.</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Geomagnetic</td>\r
- <td>Receives the actual geomagnetic value of the device.</td>\r
- <td>Receives the virtual geomagnetic value through the Emulator Control Panel.\r
-<p>If the Emulator orientation is portrait, the y axis points to true north and the magnetic tesla values are 1, 0, and -10 degrees.</p></td>\r
- </tr>\r
- \r
- \r
- <tr>\r
- <td>Proximity</td>\r
- <td>Receives the actual proximity value of the device.</td>\r
- <td>Receives the virtual proximity value through the Emulator Control Panel.\r
- <p>You can register an event handler for the proximity sensor and test it with the Emulator Control Panel. However, the screen does not power off during the event because the Emulator does not connect to the power manager.</p>\r
- </td>\r
- </tr>\r
- \r
- \r
- <tr>\r
- <td>Light</td>\r
- <td>Receives the actual ambient light value of the device.</td>\r
- <td>Receives the virtual ambient light value through the Emulator Control Panel.\r
- <p>You can register an event handler for the light sensor and test it with the Emulator Control Panel. However, in order to test the screen brightness change, the brightness setting must be automatic in the setting application. </p>\r
- </td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Pressure</td>\r
- <td>Receives the actual pressure value of the device.</td>\r
- <td>Receives the virtual actual pressure value through the Emulator Control Panel.\r
- </td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Ultraviolet</td>\r
- <td>Receives the actual ultraviolet value of the device.</td>\r
- <td>Receives the virtual actual ultraviolet value through the Emulator Control Panel.\r
- </td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Heart Rate Monitor</td>\r
- <td>Receives the actual heart rate and peak-to-peak values of the device.</td>\r
- <td>Receives the virtual actual heart rate and peak-to-peak values through the Emulator Control Panel.\r
- </td>\r
- </tr>\r
- \r
- <tr>\r
- <td rowspan="4">Device</td>\r
- <td>Battery</td>\r
- <td>Receives the actual battery value of the device.</td>\r
- <td>Receives the virtual battery value through the Emulator Control Panel.\r
- <p>You can change the battery level and the charger connection status.</p> \r
- </td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Earjack</td>\r
- <td>Receives the actual earjack connection event of the device.</td>\r
- <td>Receives the earjack connection event through the Emulator Control Panel.\r
- <p>You can select a 3-wire or 4-wire connection, or set the earjack as disconnected.</p> \r
- </td>\r
- </tr>\r
- \r
- \r
- <tr>\r
- <td>USB</td>\r
- <td>Receives the actual USB connection event of the device.</td>\r
- <td>Receives the USB connection event through the Emulator Control Panel.</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>RSSI</td>\r
- <td>Receives the actual RSSI value of the device.</td>\r
- <td>Receives the virtual RSSI value through the Emulator Control Panel.</td>\r
- </tr>\r
- \r
- <tr>\r
- <td rowspan="4">Location</td>\r
- <td>Log</td>\r
- <td>Supported by lbsFW.</td>\r
- <td>Receives the virtual GPS log file through the Emulator Control Panel.\r
- <p>You can use a log file of the NMEA format.</p>\r
- </td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Manual</td>\r
- <td>Not supported.</td>\r
- <td>Receives the virtual longitude and latitude values through the Emulator Control Panel.</td>\r
- </tr>\r
- \r
- \r
- <tr>\r
- <td>Map</td>\r
- <td>Not supported.</td>\r
- <td>Receives the virtual longitude, latitude, altitude, and horizontal accuracy values through the Emulator Control Panel map.</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Auto</td>\r
- <td>Receives the actual GPS coordinates of the device.</td>\r
- <td>Not supported.</td>\r
- </tr>\r
- \r
- </tbody>\r
- </table>\r
-\r
-\r
-<h4 id="telephony" name="telephony">Telephony</h4>\r
-\r
- <table border="1">\r
- <caption>Table: Telephony differences</caption>\r
- <tbody> \r
- \r
- <tr>\r
- <th colspan="2">Category</th>\r
- <th>Physical target</th>\r
- <th>Emulator</th>\r
- </tr>\r
- <tr>\r
- <td rowspan="2">Telephony</td>\r
- <td>Call</td>\r
- <td>Calls and video calls are supported.</td>\r
- <td>Call waiting, outgoing call barring, and voice calls with the Emulator Control Panel are supported.\r
- <p>Video calls, call forwarding, incoming call barring, and Emulator-to-Emulator calls are not supported.</p></td>\r
- </tr>\r
- \r
- <tr>\r
- <td>SMS</td>\r
- <td>SMS messaging is supported.</td>\r
- <td>SMS messaging with the Emulator Control Panel is supported.\r
- <p>Sending Emulator-to-Emulator SMS messages is not supported.</p></td>\r
- </tr>\r
- </tbody>\r
- </table> \r
- \r
- \r
-<h4 id="power" name="power">Power Management</h4>\r
- \r
- <table border="1">\r
- <caption>Table: Power management differences</caption>\r
- <tbody> \r
- \r
- <tr>\r
- <th>Mode</th>\r
- <th>Physical target</th>\r
- <th>Emulator</th>\r
-</tr>\r
- \r
- \r
- <tr>\r
- <td>Display on/off</td>\r
- <td>Display controller in the processor</td>\r
- <td>Internal emulation</td>\r
- </tr>\r
- \r
- <tr>\r
- <td>Power off</td>\r
- <td>Power management in the processor</td>\r
- <td>ACPI (Advanced Configuration and Power Interface)</td>\r
- </tr>\r
-</tbody> \r
-</table>\r
-\r
-\r
-<h4 id="codec" name="codec">Supported Media Formats and Codecs</h4>\r
-\r
- <table border="1">\r
- <caption>Table: Media format and codec differences</caption>\r
- <tbody> \r
- \r
- <tr>\r
- <th colspan="2">Category</th>\r
- <th>Physical target</th>\r
- <th>Emulator</th>\r
-</tr>\r
- <tr>\r
- <td rowspan="1">Decoder</td>\r
- \r
- <td>FLAC</td>\r
- <td>Supported</td>\r
- <td>Not supported</td>\r
- </tr> \r
- </tbody>\r
- </table> \r
- \r
- \r
-<script type="text/javascript" src="../scripts/jquery.zclip.min.js"></script>\r
-<script type="text/javascript" src="../scripts/showhide.js"></script>\r
-\r
-</div></div></div>\r
-\r
-<a class="top sms" href="#"><img src="../images/btn_top.gif" alt="Go to top" /></a>\r
-\r
-<div id="footer">\r
-<p class="footer">Except as noted, this content - excluding the Code Examples - is licensed under <a href="http://creativecommons.org/licenses/by/3.0/legalcode" target="_blank">Creative Commons Attribution 3.0</a> and all of the Code Examples contained herein are licensed under <a href="https://www.tizen.org/bsd-3-clause-license" target="_blank">BSD-3-Clause</a>.<br/>For details, see the <a href="https://www.tizen.org/content-license" target="_blank">Content License</a>.</p>\r
-</div>\r
-\r
-<script type="text/javascript">\r
-var _gaq = _gaq || [];\r
-_gaq.push(['_setAccount', 'UA-25976949-1']);\r
-_gaq.push(['_trackPageview']);\r
-(function() {\r
-var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;\r
-ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';\r
-var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);\r
-})();\r
-</script>\r
-\r
-</body>\r
-</html>\r
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+ <meta http-equiv="content-type" content="text/html; charset=utf-8" />
+ <meta http-equiv="X-UA-Compatible" content="IE=9" />
+ <link rel="stylesheet" type="text/css" href="../css/styles.css" />
+ <link rel="stylesheet" type="text/css" href="../css/snippet.css" />
+ <script type="text/javascript" src="../scripts/snippet.js"></script>
+ <script type="text/javascript" src="../scripts/jquery.util.js" charset="utf-8"></script>
+ <script type="text/javascript" src="../scripts/common.js" charset="utf-8"></script>
+ <script type="text/javascript" src="../scripts/core.js" charset="utf-8"></script>
+ <script type="text/javascript" src="../scripts/search.js" charset="utf-8"></script>
+
+ <title>Emulator</title>
+</head>
+
+<body onload="prettyPrint()" style="overflow: auto;">
+
+
+<div id="toc-navigation">
+ <div id="profile">
+ <p><img alt="Mobile" src="../images/mobile_s_wn.png"/> <img alt="Wearable" src="../images/wearable_s_wn.png"/></p>
+ </div>
+ <div id="toc_border"><div id="toc">
+ <p class="toc-title">Content</p>
+ <ul class="toc">
+ <li><a href="#features">Using the Emulator</a></li>
+ <li><a href="#manager">Emulator Manager</a></li>
+ <li><a href="#hw">Using Hardware Virtualization</a></li>
+ <li><a href="#controls">Emulator Control Keys and Menu</a></li>
+ <li><a href="#ecp">Emulator Control Panel</a></li>
+ <li><a href="#support">Supported Features</a></li>
+ </ul>
+ </div></div>
+</div>
+<div id="container"><div id="contents"><div class="content">
+
+<h1>Emulator</h1>
+
+<p>The Tizen SDK includes a virtual device Emulator. The Emulator provides the full stacks of the Tizen platform so that you can test Tizen applications before deploying them to the real target device. The Emulator is based on the open source QEMU project and comprises virtual CPU, memory, and various peripherals. Currently, the Tizen SDK only supports the x86 machine architecture for guest. You can use the <a href="#manager">Emulator Manager</a> to create and launch a Virtual Machine instance. You can communicate with the Emulator instance using the <a href="smart_dev_bridge.htm">Smart Development Bridge (SDB)</a>.</p>
+
+<p>The main features of the Emulator are:</p>
+<ul>
+<li>Providing full system emulation, including CPU, memory, and peripheral devices</li>
+<li>Simulating events with the <a href="#ecp">Emulator Control Panel</a></li>
+<li>Accelerating guest operations using host CPU or GPU</li>
+</ul>
+
+<p>For more information see <a href="#support">Supported Features</a>.</p>
+
+<h2 id="features" name="features">Using the Emulator</h2>
+
+<p>To run applications on the Emulator:</p>
+
+<ol>
+<li>Start the Emulator through the <a href="#manager">Emulator Manager</a>.
+<p>You can launch the Emulator from both the Emulator Manager and the command line. If you are using the command line, you can modify the <a href="emulator_features.htm#startup">start-up options</a>.</p></li>
+<li>While running the Emulator, you can use <a href="#controls">the control keys and context menu</a> or the <a href="#ecp">Emulator Control Panel</a> to control the Emulator. You can use <a href="emulator_features.htm">extended features</a> while running applications, such as a shared directory, multi-point touch, and a Webcam.</li>
+</ol>
+
+<h2 id="manager" name="manager">Emulator Manager</h2>
+
+<p>To start the Emulator:</p>
+<ol>
+<li>First, start the Emulator Manager by one of the following ways:
+<ul>
+ <li>Using the Desktop or Start menu:
+
+ <table>
+ <caption>Table: Starting the Emulator Manager</caption>
+ <tbody>
+ <tr>
+ <th style="text-align:center;margin-left:auto;margin-right:auto;">Ubuntu</th>
+ <th style="text-align:center;margin-left:auto;margin-right:auto;">Windows®</th>
+ <th style="text-align:center;margin-left:auto;margin-right:auto;">Mac OS®</th>
+ </tr>
+ <tr>
+ <td><strong>Desktop > Applications > Emulator Manager</strong>:
+ <p><img alt="Ubuntu shortcut" src="../images/emulator_manager_linux_shortcut.png"/></p></td>
+ <td><strong>Start > All Programs > Tizen SDK > Emulator Manager</strong>:
+ <p><img alt="Windows shortcut" src="../images/emulator_manager_win_shortcut.png"/></p></td>
+ <td><strong>Finder > Applications > Tizen SDK > Emulator Manager</strong>:
+ <p><img alt="Mac OS shortcut" src="../images/emulator_manager_mac_shortcut.png"/></p></td>
+ </tr>
+ </tbody>
+ </table>
+ </li>
+ <li>In the Tizen IDE, click the <strong>Emulator Manager</strong> icon in the <strong>Connection Explorer</strong> view:
+ <p align="center"><img src="../images/emulator_manager_ide.png"/></p>
+ </li>
+</ul>
+</li>
+<li>In the main screen of the Emulator Manager, click <strong>Create New Emulator</strong>. And then <strong>Create New Emulator</strong> dialog box appears.
+<p align="center"><img src="../images/emulator_list.png"/></p>
+</li>
+<li>In <strong>Create New Emulator</strong> dialog box, click <strong>Confirm</strong>.
+<p align="center"><img src="../images/create_new_emulator.png"/></p>
+</li>
+<li>Click the <strong>Launch</strong> button ( <img alt="launch" src="../images/emulator_launch_button.png" /> ) or press the Enter keyboard key.</li>
+<li>To stop the Emulator, open the context menu, and then click <strong>Close</strong>.</li>
+</ol>
+
+<p class="figure">Figure: Emulator Manager</p>
+<p align="center"><img alt="Emulator Manager" src="../images/emulator_manager.png" /></p>
+
+<table class="note">
+<tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">To run the application faster, switch on <strong>CPU VT</strong> and <strong>GPU</strong>. If <strong>CPU VT</strong> is disabled, check the <a href="#hw">Using Hardware Virtualization</a> section for more information. If <strong>GPU</strong> is disabled, <a href="https://developer.tizen.org/downloads/sdk/installing-sdk/prerequisites-tizen-sdk" target="_blank">install the latest vendor-provided graphic driver</a>.</td>
+ </tr>
+ </tbody>
+ </table>
+
+<h3 id="me" name="me">Managing the Emulator</h3>
+
+<p>With the Emulator Manager, you can create an emulator instance for various Tizen devices and platforms. In the Emulator Manager, you can filter the emulator list by the profile </p>
+<p>button (<img alt="Launch" src="../images/emulator_manager_profile_button.png" /> ). And you can create, launch, modify and delete an emulator instance.</p>
+<p class="figure">Figure: Emulator instances list</p>
+<p align="center"><img alt="Emulator Manager" src="../images/emulator_list_in_emulator_manager.png" /></p>
+
+<p>To create an emulator instance, click <strong>Create New Emulator</strong>, select a platform and device template, and then click <strong>Confirm</strong>.</p> If you want to configure detailed settings, click the <strong>Advance</strong> button.</p>
+<p class="figure">Figure: Setting new emulator instance</p>
+<p align="center"><img alt="Emulator Manager" src="../images/create_new_emulator_setting.png" /></p>
+
+<p>If you want to create an emulator instance with a custom platform, click <strong>create</strong> icon (<img alt="create" src="../images/emulator_create_icon.png" />) and add a new platform. (How to create a new platform is described at <a href="#plf">Platforms</a> topic.) The new emulator instance appears in the emulator list. In the list, a blue icon means a standard platform emulator and a green icon means a custom platform emulator.</p>
+<ul>
+<li>To export a platform image of an emulator instance, select an emulator, open the context menu, select <strong>Export as</strong>, and then enter a path for a new platform image.</li>
+<li>To modify an emulator instance, click the <strong>modify</strong> icon (<img alt="modify" src="../images/emulator_modify_icon.png" />), make appropriate changes and click <strong>Confirm</strong>.</li>
+<li>To delete an emulator instance, click the <strong>delete</strong> icon (<img alt="trash" src="../images/emulator_trash_icon.png" />) or press the Delete keyboard key (fn + Delete in Mac OS® X).</li>
+<li>To launch an emulator instance, click the <strong>launch</strong> button (<img alt="launch" src="../images/emulator_launch_button.png" />) or press the Enter keyboard key.</li>
+</ul>
+
+<h3 id="vm" name="vm">Virtual Machine</h3>
+<p>A virtual machine (VM) is a set of hardware options including the file system image. The Emulator Manager controls the virtual machines. When you launch the Emulator, you can specify the VM that you want to customize. Each VM has its own Emulator file system image. In other words, different VMs have different states of Emulators.</p>
+<table class="note">
+
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">If you update the <span style="font-family: Courier New,Courier,monospace">EMULATOR_IMAGE</span> package on Tizen SDK Install Manager, existing VMs are not launched properly as the Base Image file is modified. To use the existing VMs after updating, the Emulator Manager provides the 'creating a base image' feature through the <strong>Export as</strong> button. With this functionality, you can keep the existing VMs in the new Base Image.</td>
+ </tr>
+ </tbody>
+ </table>
+
+<p>You can set the following VM details:</p>
+<ul>
+<li>Name
+<p>The following rules apply for naming a VM:</p>
+<ul>
+<li>The length of the name must be at most 20 characters.</li>
+<li>Different VMs must not have the same name.</li>
+<li>Only the following characters are accepted: -, _, 0-9, a - z, and A - Z</li>
+</ul></li>
+
+<li>Base Image
+<p>You can use the default base image. You can also change the base image and choose another image when you create a VM by clicking <strong>Create New</strong> under the "mobile-custom/wearable-custom" tab folder. This new VM is added under the "each custom" group. The correct image file extension of the custom base image is <span style="font-family: Courier New,Courier,monospace">.x86</span>.</p></li>
+
+<li>Display Resolution
+<p>Note that the following resolution has its own default display density.</p>
+<ul>
+ <li>Mobile
+ <ul>
+ <li>480 x 800 (WVGA)</li>
+ <li>540 x 960 (qHD)</li>
+ <li>720 x 1280 (HD)</li>
+ </ul></li>
+ <li>Wearable
+ <ul>
+ <li>320 x 320</li>
+ <li>360 x 360</li>
+ <li>360 x 480</li>
+ </ul></li>
+</ul>
+</li>
+
+<li>Display Density
+<p>DPI (Dots Per Inch) value of the Emulator. The DPI depends on the display resolution.</p>
+<ul>
+ <li>Mobile
+ <ul>
+ <li>233 (480 x 800)</li>
+ <li>220 (540 x 960)</li>
+ <li>294 (720 x 1280)</li>
+ </ul></li>
+ <li>Wearable
+ <ul>
+ <li>316 (320 x 320)</li>
+ <li>302 (360 x 360)</li>
+ <li>300 (360 x 480)</li>
+ </ul></li>
+</ul>
+</li>
+
+<li>Skin
+<p>The VM UI style. Select 1 or more of the available skins. The skin depends on the display resolution.</p></li>
+
+<li>Processors
+<p>The number of CPUs.</p></li>
+
+
+<li>RAM Size
+<p>The RAM size.</p>
+
+<table class="note">
+
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">In Windows®, only the 512 MB size is available.</td>
+ </tr>
+ </tbody>
+ </table>
+
+<ul>
+<li>512 MB</li>
+<li>768 MB</li>
+<li>1024 MB</li>
+</ul></li>
+
+<li>File Sharing
+<p>You can share a directory between the host PC and the Emulator. If you want to use this feature, set the value to <strong>ON</strong> and define the input directory to share in the <strong>directory</strong> field. For more information, see <a href="emulator_features.htm#file">Sharing a Directory</a>.</p></li>
+
+<li>CPU VT
+<p>The Emulator supports hardware virtualization. It is kvm on Ubuntu and HAX on Windows®. If the host CPU supports hardware virtualization and a hardware virtualization module is installed, you can change this value. For more information, see <a href="#hw">Using Hardware Virtualization</a>.</p></li>
+
+<li>GPU
+<p>The Emulator supports hardware OpenGL® acceleration. If the host graphic card driver supports hardware acceleration and you select <strong>ON</strong>, the feature operates properly. Otherwise, do not try to make the Emulator support hardware acceleration. If the GPU option is enabled, the rendering performance of the video player or camera can degrade.</p>
+</li>
+
+<li>OpenGL® ES version
+<p>You can select the OpenGL® ES version you want to use in Mac OS®.</p>
+<ul>
+ <li>v2.0 & v3.0</li>
+ <li>v1.1 & v2.0</li>
+</ul>
+
+<table class="note">
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">If GPU acceleration is set to <strong>OFF</strong> or <strong>Disable</strong>, this option is not available.</td>
+ </tr>
+ </tbody>
+ </table>
+</li>
+
+<li>Advanced Option
+<p>You can attach and detach devices.</p>
+<ul>
+ <li>Mobile
+ <ul>
+ <li>Camera: virtual, Webcam</li>
+ <li>Sensor: accelerometer, gyroscope, geo-magnetic, proximity, light, haptic, pressure, ultraviolet, heartbeat rate meter</li>
+ <li>Device: battery</li>
+ <li>Jack: earjack, charger, USB</li>
+ </ul></li>
+ <li>Wearable
+ <ul>
+ <li>Camera: virtual, Webcam</li>
+ <li>Sensor: accelerometer, gyroscope, geomagnetic, proximity, light, haptic, pressure, ultraviolet, heartbeat rate meter</li>
+ <li>Device: battery</li>
+ <li>Jack: charger, USB</li>
+ </ul></li>
+</ul>
+</li>
+
+</ul>
+
+<h3 id="dt" name="dt">Device Template</h3>
+
+<p>The Emulator Manager provides the pre-defined device template which enables creating/launching the emulator instance.</p>
+<p>Click the <strong>Templates</strong> button in the Emulator Manager, and then the <strong>Template</strong> panel appears. In the <strong>Template</strong> panel, you can create/modify/clone/delete a Device template, and see the generated templates.</p>
+<p class="figure">Figure: Device templates</p>
+<p align="center"><img alt="Emulator Manager" src="../images/emulator_device_templates.png" /></p>
+
+<p>To create a device template, click the <strong>create</strong> icon(<img alt="Launch" src="../images/emulator_create_icon.png" />), and then the <strong>New Template</strong> dialog box appears.</p>
+<p>After configuring the template, click <strong>Confirm</strong>. The new device template is added to the list and type icon is green.</p>
+<p>(A type icon for pre-defined device template is blue.)</p>
+<p class="figure">Figure: Creating new template</p>
+<p align="center"><img alt="Emulator Manager" src="../images/create_new_emulator_template.png" /></p>
+<ul>
+<li>To modify a device template, click the <strong>modify</strong> icon(<img alt="modify" src="../images/emulator_modify_icon.png" />) and make appropriate changes and click Confirm. You can modify only a custom device template you created.</li>
+<li>To clone a device tempalte, click the <strong>clone</strong> icon(<img alt="clone" src="../images/emulator_clone_icon.png" />) and make appropriate changes and click Confirm.</li>
+<li>To delete a device template, click the <strong>delete</strong> icon(<img alt="trash" src="../images/emulator_trash_icon.png" />). You can delete only a custom device template you created.</li>
+<li>To see a detailed information, select a device template, open context menu and click <strong>Detail</strong>.</li>
+</ul>
+
+<h3 id="plf" name="plf">Platforms</h3>
+<p>Click the <strong>Platforms</strong> button in the Emulator Manager, and then the <strong>Platforms</strong> panel appears. In the <strong>Platforms</strong> panel, you can create/modify/delete a custom platform, and see the generated platforms.</p>
+<p>(An application developer may not need a custom platform, but it can be useful for a platform developer).</p>
+<p class="figure">Figure: Platforms list</p>
+<p align="center"><img alt="Emulator Manager" src="../images/emulator_platforms_list.png" /></p>
+
+<p>To create a custom platform, click the <strong>create</strong> icon(<img alt="Launch" src="../images/emulator_create_icon.png" />).</p>
+<p>In <strong>New Platform</strong> dialog box, select a base platform and platform image file, and click <strong>Confirm</strong>. The newly created platform is added to the list and type icon is green.</p>
+<p class="figure">Figure: Creating new platform</p>
+<p align="center"><img alt="Emulator Manager" src="../images/create_new_emulator_platform.png" /></p>
+
+<ul>
+<li>To modify a custom platform, click the <strong>modify</strong> icon(<img alt="modify" src="../images/emulator_modify_icon.png" /> ) and make appropriate changes and click Confirm. You can modify only a custom platform you created.</li>
+<li>To delete custom base image, click the <strong>delete</strong> icon(<img alt="trash" src="../images/emulator_trash_icon.png" />). You can delete only a custom platform you created.</li>
+</ul>
+
+<h3 id="manager-cli" name="manager-cli">Emulator Manager CLI</h3>
+
+<p>You can create, modify, delete, and list your VMs through the command line interface commands. The CLI binary is located in:</p>
+ <ul>
+ <li>In Ubuntu:
+ <p><span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>/tools/emulator/bin/em-cli</span></p></li>
+ <li>In Windows®:
+ <p><span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>\tools\emulator\bin\em-cli.bat</span></p></li>
+ </ul>
+
+<p>For more information, see the CLI help messages.</p>
+
+<p class="figure">Figure: Emulator Manager command line</p>
+<p align="center"><img alt="Emulator Manager command line" src="../images/emulator_cli.png" /></p>
+
+
+<h2 id="hw" name="hw">Using Hardware Virtualization</h2>
+
+<p>To run the application faster, the Tizen x86 Emulator exploits <a href="http://www.linux-kvm.org/page/Main_Page" target="_blank">KVM</a> (Kernel-based Virtual Machine in Linux) or <a href="https://developer.tizen.org/sdk/haxm" target="_blank">HAX</a> (Hardware Accelerated eXecution in Windows® and Mac OS® X) with HW virtualization support.</p>
+<p>If the <strong>CPU VT</strong> is disabled in the <strong>Detail</strong> view on the Emulator Manager, check the following prerequisites and install KVM or HAX.</p>
+
+
+<h3 id="prerequisite" name="prerequisite">Prerequisites</h3>
+
+<p>To use HW virtualization, you need:</p>
+
+<ul>
+<li>In Ubuntu:
+<p>To use KVM, you need a processor that supports HW virtualization. Both Intel and AMD have developed those extensions for their processors (Intel VT-x/AMD-V). Check whether the CPU supports HW virtualization with the following command:</p>
+<pre class="prettyprint">
+$egrep -c '(vmx|svm)' /proc/cpuinfo</pre>
+
+<p>If the output of the command is <span style="font-family: Courier New,Courier,monospace">0</span>, the CPU does not support HW virtualization. Otherwise, it does. </p>
+<p>The HW virtualization feature can also be disabled on the BIOS setting; check the setting and enable it if you need the feature.</p></li>
+
+<li>In Windows®:
+<p>To use HAX, you need Intel VT-x-supported CPU, and you must enable the NX-related setting in the PC BIOS.</p> </li>
+
+<li>In Mac OS® X:
+<p>To use HAX, install EFI-related updates on your Intel-based Mac system. For more information, see <a href="http://support.apple.com/kb/HT1237" target="_blank">EFI and SMC firmware updates for Intel-based Macs</a>.</p> </li>
+</ul>
+
+
+<h3 id="install" name="install">Installing KVM or HAX</h3>
+
+<p>To install KVM or HAX:</p>
+
+<ul>
+<li>In Ubuntu:
+<p>No installation is required for KVM.</p>
+</li>
+<li>In Windows® and Mac OS® X:
+<p>The HAXM driver is installed during the Tizen SDK installation. See the installation manual on the <a href="https://developer.tizen.org/sdk/haxm" target="_blank">Tizen developer site</a>.</p>
+<table class="note">
+
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">
+ <p>If the installation fails with a VT-related message, check the CPU feature and BIOS settings. If the installation fails with an NX-related message, enable NX (or PAE and DEP) -related item in the BIOS. In addition, make sure that the operating system supports the NX feature (for more information, see <a href="http://msdn.microsoft.com/en-us/library/windows/hardware/ff542275%28v=vs.85%29.aspx" target="_blank">MSDN</a>).</p>
+</td>
+ </tr>
+ </tbody>
+ </table></li></ul>
+
+<p>No configuration is required for KVM or HAX.</p>
+
+
+<h3 id="run" name="run">Running the Emulator</h3>
+<p>To run the Emulator with HW virtualization support in the Emulator Manager, set the <strong>CPU VT</strong> field to <strong>ON</strong>. The field is disabled if your system cannot support HW virtualization.</p>
+<p>You can also run the Emulator with HW virtualization support from the command line, by including the <span style="font-family: Courier New,Courier,monospace">-enable-kvm</span> (in Ubuntu) or <span style="font-family: Courier New,Courier,monospace">-enable-hax</span> (in Windows® and Mac OS® X) option in the start-up command.</p>
+
+
+<h2 id="controls" name="controls">Emulator Control Keys and Menu</h2>
+
+<p>The Tizen Emulator provides a variety of control keys and menus.</p>
+
+<h3 id="phone" name="phone">Profile-specific Skin</h3>
+<p>The profile-specific skin has a real device-shaped image frame, and its hardware keys are on the main window skin. You can <a href="emulator_features.htm#skin">configure the profile-specific skin</a>.</p>
+
+
+<p class="figure">Figure: Profile-specific skin Emulator</p>
+
+<p align="center"><img alt="Profile-specific skin Emulator Mobile" src="../images/emulator_profile_mobile.png" /> <img alt="Profile-specific skin Emulator Wearable O" src="../images/emulator_profile_wearable_o.png" /> <img alt="Profile-specific skin Emulator Wearable" src="../images/emulator_profile_wearable.png" /></p>
+
+<h3 id="general" name="general">General Purpose Skin</h3>
+
+<p>While <a href="#phone">profile-specific skin</a> provides a realistic skin and hardware keys, the general purpose skin shows a consistent frame on every state of resolution, scale, or rotation and enables you to change the Emulator display resolution to custom values. You can also see the key window.</p>
+
+<table class="note">
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">The layout of the general purpose skin is not configurable like the profile-specific skin.</td>
+ </tr>
+ </tbody>
+</table>
+
+<ul>
+<li>Key window
+<p>The key window consists of virtual hardware keys, which are embedded in profile-specific skins. You can use it as a remote controller of its main Emulator window. You can move it to any position separate from the main window or dock it to the right side of the main window. If it is docked with the main window, both windows can be moved together on the screen.</p>
+<p>You can make the key window appear or disappear through the Context Menu or a <a href="keyboard_shortcuts.htm#emulator">shortcut key</a>.</p>
+
+</li>
+<li>Pair tag
+<p>The color of the pair tag indicates which main window is paired with the key window. The color changes every time the Emulator boots.</p>
+</li>
+</ul>
+
+<p>The following figure illustrates the general purpose skin Emulator.</p>
+
+<p class="figure">Figure: General purpose skin Emulator</p>
+<p align="center"><img alt="General purpose skin Emulator Mobile" src="../images/emulator_general_mobile.png" /> <img alt="General purpose skin Emulator Wearable" src="../images/emulator_general_wearable.png" /></p>
+
+<table class="note">
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">You can create a custom resolution Emulator by using the <a href="#manager-cli">Emulator Manager CLI</a>, and launch it with the general purpose skin. It is not guaranteed that all the applications are correctly shown in the custom resolution.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="controlkeys" name="controlkeys">Control Keys</h3>
+<p>The following hardware keys are available on the Emulator:</p>
+<ul>
+ <li><strong>Menu</strong> (mobile only)
+ <p>When you tap, it opens a list of options available for the current screen.</p>
+ </li>
+ <li><strong>Home</strong> (mobile only)
+ <p>If you long-press the <strong>Home</strong> key, the Task switcher application opens as in a real device.</p>
+ </li>
+ <li><strong>Back</strong>
+ <p>When you tap, it returns to the previous screen.</p>
+ </li>
+ <li><strong>Power</strong>
+ <p>You can power off the display by clicking the <strong>Power</strong> key in most general situations.
+ Sometimes, the display does not power off though you click the <strong>Power</strong> key.
+ This is to guarantee the operation of a current application, such as the Stopwatch in the Clock App.
+ If you click <strong>Power</strong> or <strong>Home</strong> key again, the display is powered on.</p>
+ </li>
+ <li><strong>Volume Up</strong> and <strong>Volume Down</strong> (mobile only)
+ <p>You can control the volume with the <strong>Volume Up</strong> and <strong>Volume Down</strong> keys.</p>
+ </li>
+</ul>
+
+
+
+<h3 id="menu" name="menu">Context Menu</h3>
+<p>You can access the context menu by right-clicking on the Emulator. In the menu, you can select:</p>
+
+<ul>
+<li>Emulator name (the top row in the menu)
+<p>Display the <strong>Detailed Info</strong> window, showing the <strong>Shortcut Info</strong> and <strong>VM Info</strong> tabs. The <strong>Shortcut Info</strong> tab lists the <a href="keyboard_shortcuts.htm#emulator">Emulator keyboard shortcuts</a> and the <strong>VM Info</strong> tab defines the virtual machine details.</p>
+<p>In Mac OS® X: To use Emulator keyboard shortcuts, open the Keyboard Setting dialog and switch your Mac function keys option to work as standard function keys.</p>
+<table border="1">
+ <caption>Table: VM Info tab</caption>
+ <tbody>
+ <tr>
+ <th style="text-align:center;margin-left:auto;margin-right:auto;">Feature</th>
+ <th style="text-align:center;margin-left:auto;margin-right:auto;">Description</th>
+ </tr>
+
+ <tr>
+ <td>VM Name</td>
+ <td>VM name</td>
+ </tr>
+
+ <tr>
+ <td>Skin Name</td>
+ <td>Skin name</td>
+ </tr>
+
+ <tr>
+ <td>CPU Arch</td>
+ <td>CPU architecture</td>
+ </tr>
+
+ <tr>
+ <td>RAM Size</td>
+ <td>RAM size (MiB)</td>
+ </tr>
+
+ <tr>
+ <td>Display</td>
+ <td>Target display resolution and PPI (pixels per inch)</td>
+ </tr>
+
+ <tr>
+ <td>CPU Virtualization</td>
+ <td>Whether hardware virtualization is supported</td>
+ </tr>
+
+ <tr>
+ <td>GPU Virtualization</td>
+ <td>Whether GPU virtualization is supported</td>
+ </tr>
+
+ <tr>
+ <td>Directory Sharing</td>
+ <td>Path to the shared host directory</td>
+ </tr>
+
+ <tr>
+ <td>Image Version</td>
+ <td>Platform image version</td>
+ </tr>
+
+ <tr>
+ <td>Image File</td>
+ <td>Platform image file path</td>
+ </tr>
+
+ <tr>
+ <td>Swap Image File</td>
+ <td>Swap image file path</td>
+ </tr>
+
+ <tr>
+ <td>Kernel File</td>
+ <td>Kernel file path</td>
+ </tr>
+
+ <tr>
+ <td>Kernel Log File</td>
+ <td>Kernel log file path</td>
+ </tr>
+
+ <tr>
+ <td>Emulator Log File</td>
+ <td>Emulator (Qemu) log file path</td>
+ </tr>
+ </tbody>
+</table>
+</li>
+
+<li><strong>Always On Top</strong>
+<p>Select this option to keep the Emulator window on top of other windows.</p>
+</li>
+<li><strong>Rotate</strong>
+<p>Select either <strong>Portrait</strong>, <strong>Landscape</strong>, <strong>Reverse Portrait</strong>, or <strong>Reverse Landscape</strong> as the orientation of the Emulator.</p></li>
+
+<li><strong>Scale</strong> (mobile only)
+<p>Scale the size of the Emulator between 1x, 1/2x (default), 3/4x, and 1/4x.</p></li>
+
+<li><strong>Advanced > Controller</strong>
+<p>Show or hide the controller window.</p>
+<table class="note">
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">The <strong>Controller</strong> menu is not supported in the profile-specific skin.</td>
+ </tr>
+ </tbody>
+</table></li>
+<li><strong>Advanced > Screenshot</strong>
+<p>Capture a screenshot of the Emulator.</p></li>
+
+<li><strong>Advanced > About</strong>
+<p>Display the Emulator version and build time.</p></li>
+
+<li><strong>Advanced > Force Close</strong>
+<p>Force the Emulator to exit. Since force stopping the Emulator can cause problems, use the <strong>Close</strong> option to exit the Emulator. Use <strong>Force Close</strong> only when absolutely necessary.</p></li>
+
+<li><strong>Shell</strong>
+<p>Open a Smart Development Bridge (SDB) shell command window.</p></li>
+
+<li><strong>Control Panel</strong>
+<p>Help to control or monitor the state of the Emulator dynamically. </p></li>
+
+<li><strong>Close</strong>
+<p>Exit the Emulator.</p></li>
+
+</ul>
+
+<table class="note">
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">In Ubuntu, you need to change a global GNOME setting to view the menu icons:
+ <ol>
+ <li>In the command console, execute the <span style="font-family: Courier New,Courier,monospace">gconf-editor</span> command.</li>
+ <li>In the tree, navigate to <strong>desktop > gnome > interface</strong>.</li>
+ <li>Enable the <strong>menus_have_icons</strong> option.</li>
+ </ol>
+ </td>
+ </tr>
+ </tbody>
+</table>
+
+
+<h2 id="ecp" name="ecp">Emulator Control Panel</h2>
+
+<p>You can execute the Emulator Control Panel (ECP) by selecting <strong>Control Panel</strong> on the <a href="#menu">Context Menu</a> after the Emulator is successfully launched. You can control and monitor the state of the Emulator dynamically.</p>
+<p>The main features of ECP:</p>
+<ul>
+
+ <li>Device Manager
+ <p>The following table lists the Device Manager features and their availability on different profiles.</p>
+
+ <table border="1">
+ <caption>Table: Device Manager features</caption>
+ <tbody>
+
+ <tr>
+ <th>Feature</th>
+ <th>Mobile</th>
+ <th>Wearable</th>
+ <th>Description</th>
+ </tr>
+
+ <tr>
+ <td>Device Tree</td>
+ <td>Yes</td>
+ <td>No</td>
+ <td>The Device Tree is a data structure for describing hardware.
+ You can see the device information that actually loaded in the main system bus.
+ It shows a simple tree structure of nodes and properties. Nodes are generally a device or another bus.
+ Properties are key-value pairs where the value can either be empty or contain an arbitrary byte stream.</td>
+ </tr>
+
+ <tr>
+ <td>Network</td>
+ <td>Yes</td>
+ <td>Yes</td>
+ <td>You can view a network device list and control the user network.
+ To forward a remote or local port to an inside port of the Emulator, click <strong>Add port–forwarding</strong>,
+ enter values in text boxes, and click <strong>Apply port–forwarding</strong>.</td>
+ </tr>
+
+ <tr>
+ <td>Host Directory Sharing</td>
+ <td>Yes</td>
+ <td>Yes</td>
+ <td>The specified host directory is mounted to <span style="font-family: Courier New,Courier,monospace">/mnt/host</span> to share resources. Therefore, the file transfer is possible through the host directory sharing feature without using the sdb utility.</td>
+ </tr>
+
+ </tbody>
+ </table> </li>
+
+ <li>App Manager
+ <p>The following table lists the App Manager features and their availability on different profiles.</p>
+
+ <table border="1">
+ <caption>Table: App Manager features</caption>
+ <tbody>
+
+ <tr>
+ <th>Feature</th>
+ <th>Mobile</th>
+ <th>Wearable</th>
+ <th>Description</th>
+ </tr>
+
+ <tr>
+ <td>Uninstaller</td>
+ <td>No</td>
+ <td>Yes</td>
+ <td>You can see user-installed applications and uninstall them.</td>
+ </tr>
+
+ </tbody>
+ </table>
+</li>
+
+
+ <li>Event Injector
+ <p>The following table lists the Event Injector features and their availability on different profiles.</p>
+
+ <table border="1">
+ <caption>Table: Event Injector features</caption>
+ <tbody>
+
+ <tr>
+ <th colspan = "2">Feature</th>
+ <th>Mobile</th>
+ <th>Wearable</th>
+ <th>Description</th>
+ </tr>
+
+ <tr>
+ <td colspan = "2"><a href="event_injec.htm#device">Battery</a></td>
+ <td>Yes</td>
+ <td>Yes</td>
+ <td>You can set the battery level using the Level slider.
+ To set the charger status to connected or disconnected, select the appropriate Charger radio button.</td>
+ </tr>
+
+ <tr>
+ <td colspan = "2"><a href="event_injec.htm#device">RSSI</a></td>
+ <td>Yes</td>
+ <td>No</td>
+ <td>You can set the remote signal strength using the level bar.</td>
+ </tr>
+
+ <tr>
+ <td rowspan = "6"><a href="event_injec.htm#sensor">Sensor</a></td>
+ <td>3-Axis Sensor</td>
+ <td>Yes</td>
+ <td>Yes</td>
+ <td>You can inject user acceleration, magnetic, and gyroscope values using slider bars or text input.</td>
+ </tr>
+
+ <tr>
+ <td>Light</td>
+ <td>Yes</td>
+ <td>Yes</td>
+ <td>You can inject a lux value into light sensor.
+ If you set brightness as auto, then display will be changed by injecting light value.</td>
+ </tr>
+
+ <tr>
+ <td>Proximity</td>
+ <td>Yes</td>
+ <td>Yes</td>
+ <td>You can inject the presence of nearby objects.</td>
+ </tr>
+
+ <tr>
+ <td>Pressure</td>
+ <td>Yes</td>
+ <td>Yes</td>
+ <td>You can inject a hPa value into the pressure sensor.</td>
+ </tr>
+
+ <tr>
+ <td>Ultraviolet</td>
+ <td>Yes</td>
+ <td>Yes</td>
+ <td>You can inject an ultraviolet index.</td>
+ </tr>
+ <tr>
+ <td>Heart Rate Monitor</td>
+ <td>Yes</td>
+ <td>Yes</td>
+ <td>You can inject the heart rate and peek-to-peek time in milliseconds.</td>
+ </tr>
+
+ <tr>
+ <td colspan = "2"><a href="event_injec.htm#device">Earjack</a></td>
+ <td>Yes</td>
+ <td>No</td>
+ <td> You can inject adding or removing headset.</td>
+ </tr>
+
+ <tr>
+ <td colspan = "2">Gesture</td>
+ <td>No</td>
+ <td>Yes</td>
+ <td>You can inject flick up (menu button) or flick down (back button) events in the wearable profile.</td>
+ </tr>
+
+ <tr>
+ <td colspan = "2"><a href="event_injec.htm#device">USB</a></td>
+ <td>Yes</td>
+ <td>Yes</td>
+ <td>You can add or remove a USB device by setting the USB device setting to the connected or disconnected state.</td>
+ </tr>
+
+ <tr>
+ <td colspan = "2"><a href="event_injec.htm#device">SD Card</a></td>
+ <td>Yes</td>
+ <td>No</td>
+ <td>You can inject a 4, 8, 16, or 32G SD card.</td>
+ </tr>
+
+ <tr>
+ <td colspan = "2"><a href="event_injec.htm#location">Location</a></td>
+ <td>Yes</td>
+ <td>Yes</td>
+ <td>You can inject latitude and longitude values using a map, manually, or from a log file.</td>
+ </tr>
+
+ <tr>
+ <td colspan = "2"><a href="event_injec.htm#telephony">Telephony</a></td>
+ <td>Yes</td>
+ <td>Yes</td>
+ <td>You can make and receive a call through the <strong>Call</strong> tab. You can also send and receive SMS messages through the <strong>SMS</strong> tab.</td>
+ </tr>
+ <tr>
+ <td colspan = "2"><a href="event_injec.htm#memory">Memory</a></td>
+ <td>Yes</td>
+ <td>Yes</td>
+ <td>You can set the low memory status using the radio buttons.</td>
+ </tr>
+ </tbody>
+ </table>
+</li>
+</ul>
+
+ <p>Various <a href="keyboard_shortcuts.htm#ecp">keyboard shortcuts</a> are available to execute ECP tasks.</p>
+
+
+<h3 name="ecp-cli">Emulator Control Panel CLI</h3>
+
+<p>You can control and monitor the Tizen Emulator by using ECP CLI instead of the ECP UI tool. The ECP CLI supports all the functionalities of the ECP UI. The CLI binary is located at:</p>
+ <ul>
+ <li>In Ubuntu:
+ <p><span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>/tools/emulator/bin/ecp-cli</span></p></li>
+ <li>In Windows®:
+ <p><span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>\tools\emulator\bin\ecp-cli.bat</span></p></li>
+ </ul>
+
+<p>You can use the CLI in a session mode or shell mode:</p>
+<ul><li>Session mode
+<p>You can access this mode by running the binary without any parameters. The mode keeps a session until it is exited. You can exit by entering the <span style="font-family: Courier New,Courier,monospace">exit</span> command.</p></li>
+<li>Shell mode
+<p>This mode is used for one-time message handling.</p></li></ul>
+<p class="figure">Figure: Session and shell modes</p>
+<p align="center"><img alt="Session and shell modes" src="../images/ecp_cli_modes.png" /></p>
+
+<p>In Ubuntu, the bash-based auto-completion is used with the TAB button.</p>
+
+<p>The following tables list the supported commands of the ECP CLI.</p>
+
+<table>
+<caption>Table: CLI common commands</caption>
+<tbody>
+<tr>
+ <th>Command</th>
+ <th>Syntax</th>
+ <th>Description</th>
+</tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">help</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">help [device]</span></td>
+ <td>To get help, type the command as <span style="font-family: Courier New,Courier,monospace">help</span>. For more a specific device help, use the device parameter.</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">keycode</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">keycode <key-code> [period|press|release]</span></td>
+ <td>To enter a key code for a mobile device:
+ <ul><li>114: volume down</li>
+<li>115: volume up</li>
+<li>139: HOME</li>
+<li>158: BACK</li>
+<li>169: MENU</li></ul></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">hmp</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">hmp <hmp command></span></td>
+ <td>Access the QEMU human monitor protocol commands. For a list of provided commands, enter the <span style="font-family: Courier New,Courier,monospace">ecp-cli hmp help</span> command.</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">qmp</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">qmp <qmp command></span></td>
+ <td>Access the QEMU monitoring protocol. The commands are handled in the JSON format, and do not require <span style="font-family: Courier New,Courier,monospace">{"execute": "qmp_capabilities"}</span> to be in the control mode.
+ <p>In the shell mode, the shell does not support the double quotation mark (") as an argument. For the JSON arguments, use \" (back space + double quotation mark) instead.</p></td>
+ </tr>
+ <tr>
+ <td rowspan="3"><span style="font-family: Courier New,Courier,monospace">hds</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">hds mount <host path> <guest path></span></td>
+ <td>Enable the host directory sharing feature between the specified <host path> and the Emulator's <guest path>. The specified path must be a folder, not a file.</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">hds unmount <id></span></td>
+ <td>Unmount the mounted host directory sharing path. The <span style="font-family: Courier New,Courier,monospace">id</span> is the HDS ID and you can get it from the <span style="font-family: Courier New,Courier,monospace">hds status</span> command.</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">hds status</span></td>
+ <td>Show the current host directory sharing status.</td>
+ </tr>
+ </tbody></table>
+
+<table>
+<caption>Table: CLI profile commands</caption>
+<tbody>
+<tr>
+ <th>Device</th>
+ <th>Command</th>
+ <th>Mobile</th>
+ <th>Wearable</th>
+ <th>Syntax</th>
+</tr>
+
+ <tr>
+ <td rowspan="5">call</td>
+ <td><span style="font-family: Courier New,Courier,monospace">dial</span></td>
+ <td rowspan="5">Yes</td>
+ <td rowspan="5">No</td>
+ <td><span style="font-family: Courier New,Courier,monospace">call dial <number></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">hidden-dial</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">call hidden-dial <number></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">connect</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">call connect</span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">disconnect</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">call disconnect <call id></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">status</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">call status</span></td>
+ </tr>
+ <tr>
+ <td rowspan="4">sms</td>
+ <td><span style="font-family: Courier New,Courier,monospace">send</span></td>
+ <td rowspan="4">Yes</td>
+ <td rowspan="4">No</td>
+ <td><span style="font-family: Courier New,Courier,monospace">sms send <number> <text></span></td>
+ </tr>
+ <tr>
+<td><span style="font-family: Courier New,Courier,monospace">set status</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">sms set <available | unavailable></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">status</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">sms status</span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">mms_status</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">sms mms_status</span></td>
+ </tr>
+ <tr>
+ <td rowspan="4">location</td>
+ <td><span style="font-family: Courier New,Courier,monospace">set</span></td>
+ <td rowspan="4">Yes</td>
+ <td rowspan="4">Yes</td>
+ <td><span style="font-family: Courier New,Courier,monospace">location set <longitude> <latitude></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">status</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">location status</span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">stop</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">location stop</span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">file</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">location file <file-path></span></td>
+ </tr>
+ <tr>
+ <td rowspan="3">battery</td>
+ <td><span style="font-family: Courier New,Courier,monospace">level</span></td>
+ <td rowspan="3">Yes</td>
+ <td rowspan="3">Yes</td>
+ <td><span style="font-family: Courier New,Courier,monospace">battery level <percent></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">charger</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">battery charger <on | off></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">status</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">battery status</span></td>
+ </tr>
+ <tr>
+ <td rowspan="2">earjack</td>
+ <td><span style="font-family: Courier New,Courier,monospace">set</span></td>
+ <td rowspan="2">Yes</td>
+ <td rowspan="2">No</td>
+ <td><span style="font-family: Courier New,Courier,monospace">earjack set <3wire | 4wire | off></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">status</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">earjack status</span></td>
+ </tr>
+ <tr>
+ <td rowspan="2">usb</td>
+ <td><span style="font-family: Courier New,Courier,monospace">set</span></td>
+ <td rowspan="2">Yes</td>
+ <td rowspan="2">Yes</td>
+ <td><span style="font-family: Courier New,Courier,monospace">usb set <on | off></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">status</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">usb status</span></td>
+ </tr>
+ <tr>
+ <td rowspan="2">rssi</td>
+ <td><span style="font-family: Courier New,Courier,monospace">set</span></td>
+ <td rowspan="2">Yes</td>
+ <td rowspan="2">No</td>
+ <td><span style="font-family: Courier New,Courier,monospace">rssi set <0~4></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">status</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">rssi status</span></td>
+ </tr>
+ <tr>
+ <td rowspan="3">SD card</td>
+ <td><span style="font-family: Courier New,Courier,monospace">attach</span></td>
+ <td rowspan="3">Yes</td>
+ <td rowspan="3">No</td>
+ <td><span style="font-family: Courier New,Courier,monospace">sdcard attach <sdcard_[ 4 | 8 | 16 | 32 ]G></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">detach</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">sdcard detach <sdcard_[ 4 | 8 | 16 | 32 ]G></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">status</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">sdcard status</span></td>
+ </tr>
+ <tr>
+ <td rowspan="10">sensor</td>
+ <td><span style="font-family: Courier New,Courier,monospace">accelerometer</span></td>
+ <td rowspan="10">Yes</td>
+ <td rowspan="10">Yes</td>
+ <td><span style="font-family: Courier New,Courier,monospace">sensor accelerometer <x> <y> <z></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">gyroscope</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">sensor gyroscope <x> <y> <z></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">magnetic</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">sensor magnetic <x> <y> <z></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">proximity</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">sensor proximity <value></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">light</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">sensor light <value></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">pressure</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">sensor pressure <level></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">uv</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">sensor uv <level></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">hrm</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">sensor hrm <level></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">status</span></td>
+<td><span style="font-family: Courier New,Courier,monospace">sensor status [sensor]</span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">file</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">sensor file <sensor> <path></span></td>
+ </tr>
+ <tr>
+ <td rowspan="2">low_memory</td>
+ <td><span style="font-family: Courier New,Courier,monospace">set</span></td>
+ <td rowspan="2">Yes</td>
+ <td rowspan="2">Yes</td>
+ <td><span style="font-family: Courier New,Courier,monospace">low_memory set <hard-warning | soft-warning | normal></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">status</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">low_memory status</span></td>
+
+ </tr>
+
+ </tbody></table>
+
+
+<h2 id="support" name="support">Supported Features </h2>
+
+<p>The Emulator provides various virtual H/W, media formats, codecs and <a href="#opengl">OpenGL® ES acceleration</a>. For better performance of the OpenGL® ES support, the Tizen Emulator exploits the latest feature of the graphic driver, so always <a href="https://developer.tizen.org/downloads/sdk/installing-sdk/prerequisites-tizen-sdk" target="_blank">install the latest vendor-provided graphic driver</a>. The Emulator, however, has some limitations and <a href="#target">differences compared to physical target devices</a>.</p>
+
+<p>The following table lists the basic features supported in the Emulator.</p>
+<table style="width: 100%" border="1">
+ <caption>Table: Supported Emulator features</caption>
+ <tbody>
+ <tr>
+ <th>Feature</th>
+ <th>Detail</th>
+ <th>Status</th>
+ <th>Notes</th>
+ </tr>
+
+<tr>
+<td>Skin</td>
+<td>Skins are fitted to the screen resolution:
+<ul>
+<li>Mobile
+ <ul><li>WVGA (480 x 800, default)</li>
+ <li>qHD (540 x 960)</li>
+ <li>HD (720 x 1280)</li>
+ </ul>
+ </li>
+<li>Wearable
+ <ul><li>320 x 320</li>
+ <li>360 x 360 (default)</li>
+ <li>360 x 480</li>
+ </ul>
+ </li>
+</ul>
+
+
+<p>4 orientation modes are supported:</p>
+<ul>
+<li>Portrait (default), landscape, reverse portrait, and reverse landscape</li></ul>
+
+</td>
+<td>Supported</td>
+<td>2 skin layout types are supported:
+<ul>
+ <li>Profile-specific skin</li>
+ <li>General purpose skin</li>
+</ul></td>
+</tr>
+<tr>
+<td>Touch</td>
+<td>Maru touch screen device</td>
+<td>Supported</td>
+<td>Multi-touch is supported.</td>
+</tr>
+
+
+<tr>
+<td>Key</td>
+<td>HW keys, host keyboard, and SW keypad</td>
+<td>Supported</td>
+<td>The host keyboard is not supported for the Wearable Emulator.</td>
+</tr>
+<tr>
+<td>Rotary</td>
+<td>360 levels of clockwise or counter-clockwise rotation</td>
+<td>Supported</td>
+<td>-</td>
+</tr>
+
+
+<tr>
+<td>Display</td>
+<td>VGA card with 100 levels of brightness control</td>
+<td>Supported</td>
+<td>-</td>
+</tr>
+
+<tr>
+<td>OpenGL® ES</td>
+<td>Compatible with OpenGL® ES 1.1 and 2.0
+<p>OpenGL® ES API pass-through via PCI</p>
+</td>
+<td>Supported
+</td>
+<td>The OpenGL® ES 1.1 functionality is not guaranteed on the Emulator, unless the graphics hardware of your computer supports OpenGL® 1.5.
+<p>The OpenGL® ES 2.0 functionality is not guaranteed on the Emulator, unless the graphics hardware of your computer supports OpenGL® 2.1.</p>
+<p>The host machine must support OpenGL® 1.4.</p></td>
+</tr>
+
+
+<tr>
+<td>Sound</td>
+<td>AC97 device</td>
+<td>Supported</td>
+<td>Audio in:
+<ul>
+<li>Make sure that the input volume of the microphone is enough to record your voice or songs on the host machine.</li>
+
+<li>On Windows® 7, inject the microphone into the host machine before starting the Emulator.</li> </ul>
+
+<p>Audio out:</p>
+<ul>
+<li>On Windows® 7, enable at least 1 audio out device before starting the Emulator. Make sure that the volume icon in the tray is not disabled.</li>
+<li>While the Emulator is running, do not disable the audio out device, as it can lock the audio system of the guest platform.</li></ul>
+</td>
+</tr>
+
+<tr>
+<td>Network connection</td>
+<td>Virtio</td>
+<td>Supported</td>
+<td>Raw socket protocol, such as ICMP, is not supported.</td>
+</tr>
+
+
+<tr>
+<td>Emulator Control Panel</td>
+<td>The Emulator Control Panel (ECP) supports different features depending on the device profile:
+<ul>
+ <li>Mobile
+ <ul>
+ <li>Device Manager: Device Tree, Network, Host Directory Sharing</li>
+ <li>Event Injector: Battery, RSSI, 3-Axis Sensor, Light, Proximity, Pressure, Ultraviolet, Heart Rate Monitor, Motion, Earjack, USB, SDCard, Location, Telephony</li>
+ </ul>
+ </li>
+ <li>Wearable
+ <ul>
+ <li>Device Manager: Network, Host Directory Sharing</li>
+ <li>App Manager: Uninstaller</li>
+ <li>Event Injector: Battery, 3-Axis Sensor, Light, Proximity, Pedometer, Pressure, Ultraviolet, Heart Rate Monitor, Gesture, USB</li>
+ </ul>
+ </li>
+ </ul>
+
+</td>
+<td>Supported</td>
+<td>The Emulator Control Panel is a standalone tool, which replaces the Event Injector. It helps to control and monitor the Emulator features, and can be launched from the Emulator context menu.</td>
+</tr>
+
+
+<tr>
+<td>Camera</td>
+<td>Virtual camera device is available. It can be connected to a host machine's Webcam and import an animated GIF image file.
+<p>Support: preview, capture, and record</p>
+<p>Image format: YUYV, I420, and YV12</p>
+<p>Attributes: brightness and contrast </p>
+<p>Resolution: 160 x 120, 176 x 144, 320 x 240, 352 x 288, and 640 x 480</p>
+<p>Video resolution: 1280 x 720 for the WVGA, 320 x 240 for the WQVGA, and 640 x 480 for the HVGA devices.</p>
+<p>The supported video codecs are MPEG-4, H.263, H.264, and VC-1 for both encoding and decoding.</p>
+</td>
+<td>Supported</td>
+<td>While recording a video using the Emulator, an audio-video synchronization error can occur depending on your computer hardware and performance.</td>
+</tr>
+
+<tr>
+<td>Bluetooth</td>
+<td>-</td>
+<td>Not supported</td>
+<td>-</td>
+</tr>
+
+<tr>
+<td>Wi-Fi</td>
+<td>-</td>
+<td>Not supported</td>
+<td>-</td>
+</tr>
+<tr>
+<td>Wi-Fi Direct™</td>
+<td>-</td>
+<td>Not supported</td>
+<td>-</td>
+</tr>
+
+</tbody>
+</table>
+
+<h3 id="opengl" name="opengl">OpenGL® ES Acceleration Support</h3>
+
+<p>For the Emulator to support OpenGL® ES acceleration, you need: </p>
+<ul>
+<li>Graphics chipset driver that supports OpenGL® 1.4 installed on the host machine</li>
+<li>All chipset vendors and driver versions available to support the OpenGL® 1.4 standard</li>
+</ul>
+
+<table class="note">
+
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">Emulator supports only ES 1.1, ES 2.0, and EGL™ 1.4 versions.</td>
+
+ </tr>
+ </tbody>
+ </table>
+
+<h3 id="target" name="target">Differences Between the Emulator and Target</h3>
+
+<p>The following tables describe the differences between a real target device and the Emulator. For more detailed information, see the differences in:</p>
+<ul>
+<li><a href="#input">Input system</a></li>
+<li><a href="#graphics">Graphics and display</a></li>
+<li><a href="#sensor">Virtual sensor</a></li>
+<li><a href="#telephony">Telephony</a></li>
+<li><a href="#power">Power management</a></li>
+<li><a href="#codec">Supported media formats and codecs</a></li>
+</ul>
+
+<table border="1">
+ <caption>Table: Comparison summary</caption>
+ <tbody>
+ <tr>
+ <th style="text-align:center;margin-left:auto;margin-right:auto;">Category</th>
+ <th style="text-align:center;margin-left:auto;margin-right:auto;">Subject</th>
+ <th style="text-align:center;margin-left:auto;margin-right:auto;">Physical target</th>
+ <th style="text-align:center;margin-left:auto;margin-right:auto;">Emulator</th>
+ </tr>
+ <tr>
+ <td rowspan ="5">Development environment</td>
+ <td>Target</td>
+ <td>Buy a target device or reference board (by model)</td>
+ <td>Download the SDK (multi-profile and multi-model support)</td>
+ </tr>
+
+ <tr>
+ <td>Network</td>
+ <td>Need Bluetooth</td>
+ <td>Only the network environment</td>
+ </tr>
+
+ <tr>
+ <td>Target connection</td>
+ <td>USB</td>
+ <td>IPC (TCP/UDP)</td>
+ </tr>
+
+ <tr>
+ <td>Source and package management</td>
+ <td>Source and package for target</td>
+ <td>Source and package for the Emulator</td>
+ </tr>
+
+ <tr>
+ <td>Host Directory Sharing</td>
+ <td>Not supported</td>
+ <td>Supported</td>
+ </tr>
+
+ <tr>
+ <td rowspan ="10">Portability</td>
+ <td>Screen resolution</td>
+ <td>Fixed</td>
+ <td>Configurable</td>
+ </tr>
+
+ <tr>
+ <td>RAM, storage size</td>
+ <td>Fixed</td>
+ <td>Configurable</td>
+ </tr>
+
+ <tr>
+ <td>2D and 3D acceleration API</td>
+ <td>GPU-dependent</td>
+ <td>GPU-independent (common set)</td>
+ </tr>
+
+ <tr>
+ <td>CP, telephony</td>
+ <td>Fully supported</td>
+ <td>Partially supported (only SMS and voice call)</td>
+ </tr>
+
+ <tr>
+ <td>Wi-Fi</td>
+ <td>Fully supported</td>
+ <td>Partially supported (using ethernet)</td>
+ </tr>
+
+ <tr>
+ <td>Sensor</td>
+ <td>Fully supported</td>
+ <td>Partially supported (using the Emulator Control Panel)</td>
+ </tr>
+
+ <tr>
+ <td>PnP, external connection</td>
+ <td>Fully supported</td>
+ <td>Partially supported (using the Emulator Control Panel)</td>
+ </tr>
+
+ <tr>
+ <td>Camera</td>
+ <td>Fully supported</td>
+ <td>Partially supported (preview, capture, recording, contrast, and brightness)</td>
+ </tr>
+
+ <tr>
+ <td>Vibration, haptic</td>
+ <td>Fully supported</td>
+ <td>Not supported</td>
+ </tr>
+
+ <tr>
+ <td>Bluetooth</td>
+ <td>Fully supported</td>
+ <td>Not supported</td>
+ </tr>
+
+ <tr>
+ <td rowspan ="3">Performance</td>
+ <td>CPU performance</td>
+ <td>Mobile CPU</td>
+ <td>Desktop CPU (with hardware virtualization)</td>
+ </tr>
+
+ <tr>
+ <td>GPU performance</td>
+ <td>Real GPU</td>
+ <td>Desktop GPU (relatively slow)</td>
+ </tr>
+
+ <tr>
+ <td>I/O performance</td>
+ <td>Real HW I/O</td>
+ <td>Emulated I/O (relatively slow)</td>
+ </tr>
+</tbody>
+</table>
+
+<h4 id="input" name="input">Input System </h4>
+
+<table border="1">
+ <caption>Table: Input differences</caption>
+ <tbody>
+
+ <tr>
+ <th style="text-align:center;margin-left:auto;margin-right:auto;">Category</th>
+ <th style="text-align:center;margin-left:auto;margin-right:auto;">Physical target</th>
+ <th style="text-align:center;margin-left:auto;margin-right:auto;">Emulator</th>
+ </tr>
+
+
+ <tr>
+ <td>Touch screen panel</td>
+ <td>Real device and driver</td>
+ <td>Virtual (VirtIO) device and driver</td>
+ </tr>
+
+
+ <tr>
+ <td>Host keyboard and hardware key</td>
+ <td>Real device and driver</td>
+ <td>Virtual (VirtIO) device and driver</td>
+ </tr>
+ </tbody>
+</table>
+
+<h4 id="graphics" name="graphics">Graphics and display</h4>
+
+
+ <table border="1">
+ <caption>Table: Graphics and display differences</caption>
+ <tbody>
+
+ <tr>
+ <th style="text-align:center;margin-left:auto;margin-right:auto;">Category</th>
+ <th style="text-align:center;margin-left:auto;margin-right:auto;">Physical target</th>
+ <th style="text-align:center;margin-left:auto;margin-right:auto;">Emulator</th>
+ </tr>
+
+
+ <tr>
+ <td>Framebuffer device</td>
+ <td>Display controller in the processor</td>
+ <td>Virtual VGA card</td>
+ </tr>
+
+ <tr>
+ <td>Backlight control</td>
+ <td>LDI (LCD Driver IC) command</td>
+ <td>Additional virtual device and driver</td>
+ </tr>
+
+ </tbody>
+</table>
+
+ <h4 id="sensor" name="sensor">Virtual Sensor (Emulator Control Panel)</h4>
+
+
+<table border="1">
+ <caption>Table: Virtual sensor differences</caption>
+ <tbody>
+
+ <tr>
+ <th colspan="2">Category</th>
+ <th>Physical target</th>
+ <th>Emulator</th>
+ </tr>
+
+ <tr>
+ <td rowspan="8">Sensor</td>
+ <td>Acceleration</td>
+ <td>Receives the actual acceleration value of the device.</td>
+ <td>Receives the virtual acceleration value through the Emulator Control Panel.
+ <p>If the Emulator orientation is portrait, the acceleration values are approximately 0, -9.81, and 0 degrees.</p></td>
+</tr>
+
+
+ <tr>
+ <td>Gyro</td>
+ <td>Receives the actual gyroscope value of the device.</td>
+ <td>Receives the virtual gyroscope value through the Emulator Control Panel.</td>
+ </tr>
+
+ <tr>
+ <td>Geomagnetic</td>
+ <td>Receives the actual geomagnetic value of the device.</td>
+ <td>Receives the virtual geomagnetic value through the Emulator Control Panel.
+<p>If the Emulator orientation is portrait, the y axis points to true north and the magnetic tesla values are 1, 0, and -10 degrees.</p></td>
+ </tr>
+
+
+ <tr>
+ <td>Proximity</td>
+ <td>Receives the actual proximity value of the device.</td>
+ <td>Receives the virtual proximity value through the Emulator Control Panel.
+ <p>You can register an event handler for the proximity sensor and test it with the Emulator Control Panel. However, the screen does not power off during the event because the Emulator does not connect to the power manager.</p>
+ </td>
+ </tr>
+
+
+ <tr>
+ <td>Light</td>
+ <td>Receives the actual ambient light value of the device.</td>
+ <td>Receives the virtual ambient light value through the Emulator Control Panel.
+ <p>You can register an event handler for the light sensor and test it with the Emulator Control Panel. However, in order to test the screen brightness change, the brightness setting must be automatic in the setting application. </p>
+ </td>
+ </tr>
+
+ <tr>
+ <td>Pressure</td>
+ <td>Receives the actual pressure value of the device.</td>
+ <td>Receives the virtual actual pressure value through the Emulator Control Panel.
+ </td>
+ </tr>
+
+ <tr>
+ <td>Ultraviolet</td>
+ <td>Receives the actual ultraviolet value of the device.</td>
+ <td>Receives the virtual actual ultraviolet value through the Emulator Control Panel.
+ </td>
+ </tr>
+
+ <tr>
+ <td>Heart Rate Monitor</td>
+ <td>Receives the actual heart rate and peak-to-peak values of the device.</td>
+ <td>Receives the virtual actual heart rate and peak-to-peak values through the Emulator Control Panel.
+ </td>
+ </tr>
+
+ <tr>
+ <td rowspan="4">Device</td>
+ <td>Battery</td>
+ <td>Receives the actual battery value of the device.</td>
+ <td>Receives the virtual battery value through the Emulator Control Panel.
+ <p>You can change the battery level and the charger connection status.</p>
+ </td>
+ </tr>
+
+ <tr>
+ <td>Earjack</td>
+ <td>Receives the actual earjack connection event of the device.</td>
+ <td>Receives the earjack connection event through the Emulator Control Panel.
+ <p>You can select a 3-wire or 4-wire connection, or set the earjack as disconnected.</p>
+ </td>
+ </tr>
+
+
+ <tr>
+ <td>USB</td>
+ <td>Receives the actual USB connection event of the device.</td>
+ <td>Receives the USB connection event through the Emulator Control Panel.</td>
+ </tr>
+
+ <tr>
+ <td>RSSI</td>
+ <td>Receives the actual RSSI value of the device.</td>
+ <td>Receives the virtual RSSI value through the Emulator Control Panel.</td>
+ </tr>
+
+ <tr>
+ <td rowspan="4">Location</td>
+ <td>Log</td>
+ <td>Supported by lbsFW.</td>
+ <td>Receives the virtual GPS log file through the Emulator Control Panel.
+ <p>You can use a log file of the NMEA format.</p>
+ </td>
+ </tr>
+
+ <tr>
+ <td>Manual</td>
+ <td>Not supported.</td>
+ <td>Receives the virtual longitude and latitude values through the Emulator Control Panel.</td>
+ </tr>
+
+
+ <tr>
+ <td>Map</td>
+ <td>Not supported.</td>
+ <td>Receives the virtual longitude, latitude, altitude, and horizontal accuracy values through the Emulator Control Panel map.</td>
+ </tr>
+
+ <tr>
+ <td>Auto</td>
+ <td>Receives the actual GPS coordinates of the device.</td>
+ <td>Not supported.</td>
+ </tr>
+
+ </tbody>
+ </table>
+
+
+<h4 id="telephony" name="telephony">Telephony</h4>
+
+ <table border="1">
+ <caption>Table: Telephony differences</caption>
+ <tbody>
+
+ <tr>
+ <th colspan="2">Category</th>
+ <th>Physical target</th>
+ <th>Emulator</th>
+ </tr>
+ <tr>
+ <td rowspan="2">Telephony</td>
+ <td>Call</td>
+ <td>Calls and video calls are supported.</td>
+ <td>Call waiting, outgoing call barring, and voice calls with the Emulator Control Panel are supported.
+ <p>Video calls, call forwarding, incoming call barring, and Emulator-to-Emulator calls are not supported.</p></td>
+ </tr>
+
+ <tr>
+ <td>SMS</td>
+ <td>SMS messaging is supported.</td>
+ <td>SMS messaging with the Emulator Control Panel is supported.
+ <p>Sending Emulator-to-Emulator SMS messages is not supported.</p></td>
+ </tr>
+ </tbody>
+ </table>
+
+
+<h4 id="power" name="power">Power Management</h4>
+
+ <table border="1">
+ <caption>Table: Power management differences</caption>
+ <tbody>
+
+ <tr>
+ <th>Mode</th>
+ <th>Physical target</th>
+ <th>Emulator</th>
+</tr>
+
+
+ <tr>
+ <td>Display on/off</td>
+ <td>Display controller in the processor</td>
+ <td>Internal emulation</td>
+ </tr>
+
+ <tr>
+ <td>Power off</td>
+ <td>Power management in the processor</td>
+ <td>ACPI (Advanced Configuration and Power Interface)</td>
+ </tr>
+</tbody>
+</table>
+
+
+<h4 id="codec" name="codec">Supported Media Formats and Codecs</h4>
+
+ <table border="1">
+ <caption>Table: Media format and codec differences</caption>
+ <tbody>
+
+ <tr>
+ <th colspan="2">Category</th>
+ <th>Physical target</th>
+ <th>Emulator</th>
+</tr>
+ <tr>
+ <td rowspan="1">Decoder</td>
+
+ <td>FLAC</td>
+ <td>Supported</td>
+ <td>Not supported</td>
+ </tr>
+ </tbody>
+ </table>
+
+
+<script type="text/javascript" src="../scripts/jquery.zclip.min.js"></script>
+<script type="text/javascript" src="../scripts/showhide.js"></script>
+
+</div></div></div>
+
+<a class="top sms" href="#"><img src="../images/btn_top.gif" alt="Go to top" /></a>
+
+<div id="footer">
+<p class="footer">Except as noted, this content - excluding the Code Examples - is licensed under <a href="http://creativecommons.org/licenses/by/3.0/legalcode" target="_blank">Creative Commons Attribution 3.0</a> and all of the Code Examples contained herein are licensed under <a href="https://www.tizen.org/bsd-3-clause-license" target="_blank">BSD-3-Clause</a>.<br/>For details, see the <a href="https://www.tizen.org/content-license" target="_blank">Content License</a>.</p>
+</div>
+
+<script type="text/javascript">
+var _gaq = _gaq || [];
+_gaq.push(['_setAccount', 'UA-25976949-1']);
+_gaq.push(['_trackPageview']);
+(function() {
+var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+})();
+</script>
+
+</body>
+</html>
projects / sdk / online-doc.git / commitdiff
