<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>
-<p>The main <a href="#support">features</a> of the Emulator are:</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> You can refer to <a href="#support">supported features</a> in detail.
<h2 id="features" name="features">Using the Emulator</h2>
<p>To run applications on the Emulator:</p>
<ol>
-<li>Start the Emulator.
+<li>Start the Emulator via <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> to control the Emulator. You can use <a href="emulator_features.htm">extended features</a> while running applications, such as multi-point touch and a Webcam.</li>
+<li>While running the Emulator, you can use <a href="#controls">the control keys and context menu</a> or <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 shared directory, multi-point touch, a Webcam, and et. al.</li>
</ol>
<h2 id="manager" name="manager">Emulator Manager</h2>
-<p>The Emulator Manager enables you to define certain hardware aspects of your own emulated device, such as screen resolution and RAM size, and to create multiple images, which is useful for testing multiple environments. With the Emulator Manager, you can also control and customize <a href="#vm">virtual machines</a>.</p>
-<p>The VM list contains all VM versions. <span style="font-family: Courier New,Courier,monospace"><Profile><VERSION></span> refers to the image version. The list under the <strong>mobile-custom</strong> or <strong>wearable-custom</strong> group depends on the profile but not the version.</p>
-
-<p>When you create a new VM by clicking <strong>Create New VM</strong> or <strong>Create New</strong> in the list, the VM is added under the current group. You can modify and delete the VMs you have added.</p>
+<p>In order to start Emulator quickly,</p>
+<ol>
+<li>Start the Emulator Manager by using the Desktop or Start menu:
+<ul>
+ <li>In Linux: <strong>Desktop > Applications > Tizen SDK > Emulator Manager</strong></li>
+ <li>In Windows®: <strong>Start > All Programs > Tizen SDK > Emulator Manager</strong></li>
+</ul>
+</li>
+<li> Select your prefered profile tab, such as mobile-2.3 or wearable 2.3.</li>
+<li> Select <strong>Create New</strong> and then click <strong>Confirm</strong>.</li>
+<li> Click the <strong>Launch</strong> button (<img alt="launch" src="../images/launch.png" />) or press the <strong>Enter</strong> keyboard key.</li>
+<li> To stop the Emulator, right-click the Emulator and select <strong>Close</strong>.</li>
+</ol>
-<p class="figure">Figure: Emulator Manager</p>
+<p class="figure">Figure: Emulator Manager
<p style="text-align:center;"><img alt="Emulator Manager"
src="../images/emulator_manager.png" /></p>
-<p>To start the Emulator Manager:</p>
-<ul>
-<li>Using the Desktop or Start menu:
- <ul>
- <li>In Linux: <strong>Desktop > Applications > Tizen SDK > Emulator Manager</strong></li>
- <li>In Windows®: <strong>Start > All Programs > Tizen SDK > Emulator Manager</strong></li>
- </ul>
-</li>
-<li>Using the command line:
+<table class="note">
-To start the Emulator Manager, type the following command in the Emulator installation directory at the command line (<span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>/tools/emulator</span>):
- <ul>
- <li>In Linux:
- <pre class="prettyprint">$./bin/em-cli</pre></li>
- <li>In Windows®:
- <pre class="prettyprint">bin\em-cli.exe</pre></li>
- </ul>
-</li>
-<li>Using the command line with arguments:
-<p>You can use all the Emulator functions through the command line interface commands.</p>
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">In order to run App faster, it is recommended that <strong>CPU VT</strong> and <strong>GPU</strong> are turned on. If <strong>CPU VT</strong> is disabled, please check the <a href="#hw">Using Hardware Virtualization</a>. If <strong>GPU</strong> is disabled, it is recommended to <a href="https://developer.tizen.org/downloads/sdk/installing-sdk/prerequisites-tizen-sdk" target="_blank">install latest vendor-provided graphic driver</a>.</td>
+ </tr>
+ </tbody>
+ </table>
+</p>
-<p class="figure">Figure: Emulator Manager command line</p>
-<p style="text-align:center;"><img alt="Emulator Manager command line" src="../images/emulator_cli.png" /></p>
-</li>
-</ul>
+<p>You can also create a new VM by <a href="#manager-cli">Emulator Manager CLI</a>.
-<p>To stop the Emulator, right-click the Emulator and select <strong>Close</strong>.</p>
+<p>The created VM is added under the current tab. The name of tab, <span style="font-family: Courier New,Courier,monospace"><Profile><VERSION></span>, refers to the image version. You can create a VM by using custom image in the <strong>mobile-custom</strong> or <strong>wearable-custom</strong> tabs.</p>
+<p>You can also export a base image of VM and manipulate VM:
+<ul>
+<li>To create a VM, select <strong>Create New</strong> and then click <strong>Confirm</strong>.</li>
+<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>
+<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>
+<li>To delete a VM, click <strong>Delete</strong> or press the <strong>Delete</strong> keyboard key (<strong>fn + Delete</strong> in Mac OS® X).</li>
+<li>To launch a VM, click the <strong>Launch</strong> button (<img alt="launch" src="../images/launch.png" />) or press the <strong>Enter</strong> 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>
</tr>
</tbody>
</table>
-<p>On the Emulator Manager:</p>
-<ul>
-<li>To create a VM, select <strong>Create New</strong> and then click <strong>Confirm</strong>.</li>
-<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>
-<li>To delete a VM, click <strong>Delete</strong> or press the <strong>Delete</strong> keyboard key (<strong>fn + Delete</strong> in Mac OS® X).</li>
-<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>
-<li>To launch a VM, click the <strong>Launch</strong> button (<img alt="launch" src="../images/launch.png" />) or press the <strong>Enter</strong> keyboard key.</li>
-</ul>
<p>You can set the following VM details:</p>
<ul>
<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">File Sharing</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="emulator_features.htm#hw">Using Hardware Virtualization</a>.</p></li>
+<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>
</ul>
+<h3 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 at:
+ <ul>
+ <li>In Linux:
+ <pre class="prettyprint"><span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>/tools/emulator</span>/bin/em-cli</pre></li>
+ <li>In Windows®:
+ <pre class="prettyprint"><span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>\tools\emulator</span>\bin\em-cli.bat</pre></li>
+ </ul></p>
+
+<p>Please refer to CLI's help messages for detailed information.</p>
+
+<p class="figure">Figure: Emulator Manager command line</p>
+<p style="text-align:center;"><img alt="Emulator Manager command line" src="../images/emulator_cli.png" /></p>
+
+<h2 id="hw" name="hw">Using Hardware Virtualization</h2>
+<p>In order to run App 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 <strong>Detail View</strong> on <strong>Emulator Manager</strong>, you should check the following prerequisites and may install KVM or HAX</p>
+
+<h3 id="prerequisite" name="prerequisite">Prerequisites</h3>
+
+<p>To use HW virtualization, you need:</p>
+
+<ul>
+<li>In Linux:
+<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 Linux:
+<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, turn 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 Linux) 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 style="text-align:center;"><img alt="Profile-specific skin Emulator Wearable" src="../images/emulator_controls_wearable.png" /> <img alt="Profile-specific skin Emulator Wearable" src="../images/emulator_controls_wearable_o.png" /></p>
+<p style="text-align:center;"><img alt="Profile-specific skin Emulator Mobile" src="../images/emulator_controls_mobile.png" /></p>
+
<h3 id="general" name="general">General Purpose Skin</h3>
<p>The image of the general purpose skin is generated by nine-patch image processing. The Emulator skin frame has the same appearance on every state of resolution, scale, or rotation. Unlike the <a href="#phone">profile-specific skin</a>, the layout of the general purpose skin is not configurable.</p>
<p class="figure">Figure: General purpose skin Emulator</p>
<p style="text-align:center;"><img alt="General purpose skin Emulator Wearable" src="../images/skin_emulator_wearable.png" /> <img alt="General purpose skin Emulator Mobile" src="../images/skin_emulator_mobile.png" /></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 style="text-align:center;"><img alt="Profile-specific skin Emulator Wearable" src="../images/emulator_controls_wearable.png" /> <img alt="Profile-specific skin Emulator Wearable" src="../images/emulator_controls_wearable_o.png" /></p>
-<p style="text-align:center;"><img alt="Profile-specific skin Emulator Mobile" src="../images/emulator_controls_mobile.png" /></p>
-
-
-
-<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>
-
<h3 id="controlkeys" name="controlkeys">Control Keys</h3>
<p>The following keys are available on the Emulator:</p>
<ul>
<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 appears as in a real device.
- If you double-click the <strong>Home</strong> key, the Search application appears as in a real device.</p>
+ <p>If you long press the <strong>Home</strong> key, the Task switcher application appears as in a real device.</p>
</li>
<li><strong>Back</strong> (mobile only)
<p>When you tap, it returns to the previous screen.</p>
<tr>
<td>Display Density</td>
- <td>DPI (dots per inch)</td>
+ <td>DPI (Dots Per Inch)</td>
</tr>
<tr>
<td>File Sharing</td>
- <td>Whether host file sharing is supported</td>
+ <td>Whether host directory sharing is used or not</td>
</tr>
<tr>
<td>File Shared Path</td>
- <td>Path to the shared host file</td>
+ <td>Path to the shared host directory</td>
</tr>
<tr>
<td>CPU Virtualization</td>
- <td>Whether hardware virtualization is supported</td>
+ <td>Whether hardware virtualization is supported or not</td>
</tr>
<tr>
<td>GPU Virtualization</td>
- <td>Whether GPU virtualization is supported</td>
+ <td>Whether GPU virtualization is supported or not</td>
</tr>
<tr>
<p>Capture a screenshot of the Emulator.</p></li>
<li><strong>Advanced > About</strong>
-<p>Display the Emulator version, build time, and Git version.</p></li>
+<p>Display the Emulator version, build time, and git version.</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>
</ul>
-<h2 id="ecp" name="ecp">Emulator Control Panel</h2>
-<p>The Emulator Control Panel (ECP) is a tool to control and monitor the state of the Emulator dynamically.</p>
-
-<p>To access the ECP:</p>
-
-<ol>
-<li>Start the Emulator.</li>
-<li>Right-click the Emulator and select <strong>Control Panel</strong>.</li>
-</ol>
-
-<p>The main features of ECP:</p>
-<ul>
-
- <li>Command line interface (CLI)
- <p>ECP CLI provides functional tools for controlling the Tizen Emulator without using the ECP UI application.</p>
-
-<p>The CLI is located in the <span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>/tools/emulator/bin</span> directory.</p>
-
-<p>The main features of the CLI are:</p>
-
-<ul><li>Mode:
-<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></li>
-<li>Bash completion in Linux:
-<p>In both shell and session mode, the auto completion is used with the TAB button.</p></li></ul>
-
-<p class="figure">Figure: Session and shell modes</p>
-<p style="text-align: center;"> <img alt="Session and shell modes" src="../images/ecp_cli_modes.png" /> </p>
-
- <table class="note">
- <tbody>
- <tr>
- <th class="note">Note</th>
- </tr>
- <tr>
- <td class="note">The ECP CLI supports all the functionalities of the ECP UI application.</td>
- </tr>
- </tbody>
- </table>
-
-
-
-<p>The following tables list the supported commands of the ECP CLI.</p>
-
-<table>
-<caption>Table: CLI Common commands</caption>
-<tbody>
-<tr>
- <th>Commands</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>189: 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 <path></span></td>
- <td>Enable the host directory sharing feature with the specified host path to <span style="font-family: Courier New,Courier,monospace">/mnt/hosts</span> in the Emulator. The specified path must be a folder, not a file.</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">hds unmount</span></td>
- <td>Unmount the mounted host directory sharing path.</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">sdcard</td>
- <td><span style="font-family: Courier New,Courier,monospace">mount</span></td>
- <td rowspan="3">Yes</td>
- <td rowspan="3">No</td>
- <td><span style="font-family: Courier New,Courier,monospace">sdcard mount <sdcard_ext4_[ 4 | 8 | 16 | 32 ]G></span></td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">unmount</span></td>
- <td><span style="font-family: Courier New,Courier,monospace">sdcard unmount</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>
- </tbody></table>
- </li>
+<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 ECP by selecting <strong>Control Panel</strong> on the <a href="#name">Context Menu</a> after the Emulator was 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>
<li>Event Injector
- <p>The following table lists the <a href="event_injec.htm">Event Injector</a> features and their availability on different profiles.</p>
+ <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>
</li>
</ul>
+<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:
+ <ul>
+ <li>In Linux:
+ <pre class="prettyprint"><span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>/tools/emulator</span>/bin/ecp-cli</pre></li>
+ <li>In Windows®:
+ <pre class="prettyprint"><span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>\tools\emulator</span>\bin\ecp-cli.bat</pre></li>
+ </ul></p>
+
+<p>You can use the CLI by session mode or shell mode:
+<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></li>
+<p class="figure">Figure: Session and shell modes</p>
+<p style="text-align: center;"> <img alt="Session and shell modes" src="../images/ecp_cli_modes.png" /> </p></p>
+
+<p>In Linux, 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>Commands</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>189: 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 <path></span></td>
+ <td>Enable the host directory sharing feature with the specified host path to <span style="font-family: Courier New,Courier,monospace">/mnt/hosts</span> in the Emulator. The specified path must be a folder, not a file.</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">hds unmount</span></td>
+ <td>Unmount the mounted host directory sharing path.</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">sdcard</td>
+ <td><span style="font-family: Courier New,Courier,monospace">mount</span></td>
+ <td rowspan="3">Yes</td>
+ <td rowspan="3">No</td>
+ <td><span style="font-family: Courier New,Courier,monospace">sdcard mount <sdcard_ext4_[ 4 | 8 | 16 | 32 ]G></span></td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">unmount</span></td>
+ <td><span style="font-family: Courier New,Courier,monospace">sdcard unmount</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>
+ </tbody></table>
+ </li>
+
+
<h2 id="support" name="support">Supported Features </h2>
-<p>The Emulator provides
support to various media formats and codecs and <a href="#opengl">OpenGL® ES acceleration</a>. The Emulator, however, has some limitations and <a href="#target">differences compared to physical target devices</a>.</p>
+<p>The Emulator provides
various virtual H/W, media formats, codecs and <a href="#opengl">OpenGL® ES acceleration</a>. For better performance of OpenGL® ES support, the Tizen Emulator exploits the latest feature of graphic driver so that it is recommended to <a href="https://developer.tizen.org/downloads/sdk/installing-sdk/prerequisites-tizen-sdk" target="_blank">install 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">
projects / sdk / online-doc.git / commitdiff