<p class="toc-title">Content</p>
<ul class="toc">
<li><a href="#features">Using the Emulator</a></li>
- <li><a href="#startup">Emulator Start-up Options</a></li>
- <li><a href="#support">Supported Features</a></li>
<li><a href="#manager">Emulator Manager</a></li>
<li><a href="#controls">Emulator Control Keys and Menu</a></li>
- <li><a href="#dir">Emulator Directory Structure</a></li>
<li><a href="#ecp">Emulator Control Panel</a></li>
+ <li><a href="#support">Supported Features</a></li>
</ul>
</div></div>
</div>
<ol>
<li>Start the Emulator.
-<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="#startup">start-up options</a>.</p></li>
+<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>
</ol>
-<h2 id="startup" name="startup">Emulator Start-up Options</h2>
-<p>You can launch the Emulator with specific settings by defining start-up options in the command line:</p>
-<pre class="prettyprint">
-# ./emulator-x86 --skin-args <skin options> --qemu-args <QEMU options>
-</pre>
-
-<p>The Emulator binaries are located in the <span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>/tools/emulator/bin</span> directory. The Tizen Emulator provides 2 types of start-up options that you can set: skin options (such as width and height) and QEMU options (such as network and memory).</p>
-
-
-<p>The following tables list the available options.</p>
-<table style="width: 100%" border="1">
- <caption>Table: Emulator skin options</caption>
- <tbody>
- <tr>
- <th>Category</th>
- <th>Option</th>
- <th>Mandatory</th>
- <th>Description</th>
-</tr>
-<tr>
-<td rowspan="2">Resolution</td>
-<td><span style="font-family: Courier New,Courier,monospace">width=x</span></td>
-<td>Yes</td>
-<td>This option makes the Emulator use a specific skin image width. The width value must be one of the video resolutions that the Emulator can support. </td>
-</tr>
-<tr>
-<td><span style="font-family: Courier New,Courier,monospace">height=x</span></td>
-<td>Yes</td>
-<td>This option makes the Emulator use a specific skin image height. The height value must be one of the video resolutions that the Emulator can support.
-</td>
-</tr>
+<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>
-<tr>
-<td>Heartbeat</td>
-<td><span style="font-family: Courier New,Courier,monospace">hb.ignore=x</span></td>
-<td>No</td>
-<td>This option is used to activate the Emulator debugging mode. Generally, a skin process for the Emulator periodically checks the heartbeat that an Emulator process sends.<br/>
-When the Emulator is in the debugging mode using gdb, the skin process is terminated automatically, because the Emulator cannot send a heartbeat to the skin process. In that case, you can set the <span style="font-family: Courier New,Courier,monospace">hb.ignore</span> option as <span style="font-family: Courier New,Courier,monospace">true</span> to debug the Emulator.<br/>
-If this option is <span style="font-family: Courier New,Courier,monospace">true</span>, the skin process does not check the heartbeat that the Emulator sends. The default value of this option is <span style="font-family: Courier New,Courier,monospace">false</span>.
-</td>
-</tr>
-<tr>
-<td>Skin image file path</td>
-<td><span style="font-family: Courier New,Courier,monospace">skin.path=xxx</span></td>
-<td>Yes</td>
-<td>Emulator loads the skin image files in this path. If this option is omitted, the Emulator finds the image files in the installed 'skins' directory.</td>
-</tr>
-</tbody>
-</table>
+<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>
-<table style="width: 100%" border="1">
- <caption>Table: Emulator QEMU options</caption>
- <tbody>
- <tr>
- <th>Category</th>
- <th>Option</th>
- <th>Description</th>
-</tr>
- <tr>
-<td rowspan="1">File system image</td>
-<td><span style="font-family: Courier New,Courier,monospace">-drive file=<IMAGE_PATH>/emulimg.x86</span></td>
-<td>Sets an image path to the file to be used as a drive image.</td>
-</tr>
-<tr>
-<td rowspan="1">Swap file system image</td>
-<td><span style="font-family: Courier New,Courier,monospace">-drive file=<SWAP_IMAGE_PATH>/swap.img</span></td>
-<td>Sets a swap image path to the file to be used as a swap image.</td>
-</tr>
-<tr>
-<td rowspan="2">Network</td>
-<td><span style="font-family: Courier New,Courier,monospace">-net user</span></td>
-<td>Uses the user mode network stack, which requires no administrator privilege to run.</td>
-</tr>
-<tr>
-<td><span style="font-family: Courier New,Courier,monospace">-net nic,model=virtio,macaddr=<MAC_ADDRESS>
-</span></td>
-<td>Creates a new network interface card and connects it to VIRTIO. <MAC_ADDRESS> is recorded in <span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK_DATA>/emulator/vms/.tizen-em-info</span>. For example: <span style="font-family: Courier New,Courier,monospace">E8:11:32:33:38:81</span>
-</td>
-</tr>
-<tr>
-<td>USB</td>
-<td><span style="font-family: Courier New,Courier,monospace">-usb</span></td>
-<td>Enables the USB driver.</td>
-</tr>
-<tr>
-<td>TouchScreen</td>
-<td><span style="font-family: Courier New,Courier,monospace">-device virtio-touchscreen-pci</span></td>
-<td>Uses the Maru Touchscreen device for display.</td>
-</tr>
-<tr>
-<td>Kernel</td>
-<td><span style="font-family: Courier New,Courier,monospace">-kernel <KERNEL_PATH></span></td>
-<td>Uses bzImage as the kernel image.</td>
-</tr>
-<tr>
-<td rowspan="2">BIOS</td>
-<td><span style="font-family: Courier New,Courier,monospace">-vga none</span></td>
-<td>Sets the VGA card.</td>
-</tr>
-<tr>
-<td><span style="font-family: Courier New,Courier,monospace">-L <BIOS_PATH></span></td>
-<td>Sets the directory for the BIOS, VGA BIOS, and key maps.</td>
-</tr>
-<tr>
-<td>Time</td>
-<td><span style="font-family: Courier New,Courier,monospace">-rtc base=utc</span></td>
-<td>Sets the real time clock with UTC.</td>
-</tr>
-<tr>
-<td>KVM (in Ubuntu®)</td>
-<td><span style="font-family: Courier New,Courier,monospace">-enable-kvm</span></td>
-<td>Enables KVM (hardware virtualization support).</td>
-</tr>
-<tr>
-<td>HAX (in Windows® or Mac OS® X)</td>
-<td><span style="font-family: Courier New,Courier,monospace">-enable-hax</span></td>
-<td>Enables HAX (hardware virtualization support).</td>
-</tr>
-<tr>
-<td>SMP</td>
-<td><span style="font-family: Courier New,Courier,monospace">-smp <NUMBER OF CPUs></span></td>
-<td>Sets the number of CPUs.</td>
-</tr>
-<tr>
-<td>Boot order</td>
-<td><span style="font-family: Courier New,Courier,monospace">-boot c</span></td>
-<td>Sets the boot order of the Emulator. The letter c indicates a hard disk.</td>
-</tr>
-<tr>
-<td>Kernel parameters </td>
-<td><span style="font-family: Courier New,Courier,monospace">-append<parameters></span></td>
-<td>Sets the kernel command line parameters from the Emulator to the kernel.</td>
-</tr>
-<tr>
-<td>Kernel log</td>
-<td><span style="font-family: Courier New,Courier,monospace">-serial file:<LOG_PATH>/emulator.klog</span></td>
-<td>Writes the kernel log into the <span style="font-family: Courier New,Courier,monospace"><LOG_PATH>/emulator.klog</span> file.</td>
-</tr>
-<tr>
-<td>Memory</td>
-<td><span style="font-family: Courier New,Courier,monospace">-m <MEMORY_SIZE></span></td>
-<td>Sets the memory size in the Tizen platform to, for example, 512 or 1024.</td>
-</tr>
-<tr>
-<td>Board</td>
-<td><span style="font-family: Courier New,Courier,monospace">-M maru-x86-machine</span></td>
-<td>Sets the Emulator machine as <span style="font-family: Courier New,Courier,monospace">maru-x86-machine</span>.</td>
-</tr>
-<tr>
-<td rowspan="2">Video card</td>
-<td><span style="font-family: Courier New,Courier,monospace">-enable-vigs</span></td>
-<td>Enables VIGS (Virtualized Graphics System) as the video card.</td>
-</tr>
-<tr>
-<td><span style="font-family: Courier New,Courier,monospace">-vigs-backend <VIGS_BACKEND></span></td>
-<td>Sets the back end as <span style="font-family: Courier New,Courier,monospace">sw</span> or <span style="font-family: Courier New,Courier,monospace">gl</span> (software or OpenGL®).</td>
-</tr>
-<tr>
-<td rowspan="2">GPU support</td>
-<td><span style="font-family: Courier New,Courier,monospace">-enable-yagl</span></td>
-<td>Enables host GL acceleration.</td>
-</tr>
-<tr>
-<td><span style="font-family: Courier New,Courier,monospace">-yagl-backend <YAGL_BACKEND>
-</span></td>
-<td>Sets the back end as vigs or offscreen.</td>
-</tr>
-<tr>
-<td>Sound</td>
-<td><span style="font-family: Courier New,Courier,monospace">-soundhw all</span></td>
-<td>Enables all sound cards.</td>
-</tr>
-<tr>
-<td>Display booting status</td>
-<td><span style="font-family: Courier New,Courier,monospace">-device virtio-esm-pci</span></td>
-<td>Sets the display booting status of the Emulator.</td>
-</tr>
-<tr>
-<td>Codec</td>
-<td><span style="font-family: Courier New,Courier,monospace">-device codec-pci</span></td>
-<td>Enables codec devices.</td>
-</tr>
+<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>
-<tr>
-<td>Hardware key</td>
-<td><span style="font-family: Courier New,Courier,monospace">-device virtio-hwkey-pci</span></td>
-<td>Enables hardware keys.</td>
-</tr>
+<p class="figure">Figure: Emulator Manager</p>
-<tr>
-<td>Host keyboard</td>
-<td><span style="font-family: Courier New,Courier,monospace">-device virtio-keyboard-pci</span></td>
-<td>Enables host keyboards.</td>
-</tr>
+<p style="text-align:center;"><img alt="Emulator Manager"
+src="../images/emulator_manager.png" /></p>
-<tr>
-<td>Rotary</td>
-<td><span style="font-family: Courier New,Courier,monospace">-device virtio-rotary-pci</span></td>
-<td>Enables a rotary device.</td>
-</tr>
+<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:
-<tr>
-<td>Brightness</td>
-<td><span style="font-family: Courier New,Courier,monospace">-device maru-brightness</span></td>
-<td>Enables the brightness control.</td>
-</tr>
+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>
-<tr>
-<td>Camera</td>
-<td><span style="font-family: Courier New,Courier,monospace">-device maru-camera</span></td>
-<td>Enables the host Webcam support.</td>
-</tr>
+<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>
-<tr>
-<td>Power</td>
-<td><span style="font-family: Courier New,Courier,monospace">-device virtio-power-pci</span></td>
-<td>Enables the battery.</td>
-</tr>
+<p>To stop the Emulator, right-click the Emulator and select <strong>Close</strong>.</p>
-<tr>
-<td>Jack</td>
-<td><span style="font-family: Courier New,Courier,monospace">-device virtio-jack-pci,jacks=<Jack types></span></td>
-<td>Enables jack devices. Supported jacks are USB, ear jack, ear key, HDMI, and charger. The ampersand ('&') symbol is used for multiple jacks. </td>
-</tr>
-<tr>
-<td>Emulator virtual device interface</td>
-<td><span style="font-family: Courier New,Courier,monospace">-device virtio-evdi-pci</span></td>
-<td>Enables the common interface between the Emulator daemon on the guest side and the Emulator on the host side.
-<p>To use the Emulator Control Panel, this option is required.</p></td>
-</tr>
+<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">
-<tr>
-<td>Sensors</td>
-<td><span style="font-family: Courier New,Courier,monospace">-device virtio-sensor-pci,sensors=<Sensor types></span></td>
-<td>Enables sensor devices. Supported sensors are accelerometer, gyroscope, geomagnetic, light, proximity, haptic, pressure, ultraviolet, and heart rate monitor.
-<p>The names of sensor types are accel, gyro, geo, light, proxy, haptic, press, uv, and hrm, respectively. The ampersand ('&') symbol is used for multiple sensor support.</p></td>
-</tr>
+ <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>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>
-<tr>
-<td>Vmodem</td>
-<td><span style="font-family: Courier New,Courier,monospace">-device virtio-vmodem-pci</span></td>
-<td>Enables the Virtual Modem.</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>
-<p>The following command is an example of using the Emulator start-up options:</p>
+<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
-<pre class="prettyprint"><TIZEN_SDK>/tools/emulator/bin/emulator-x86.exe --skin-args width=480 height=800 skin.path=
-<TIZEN_SDK>/platforms/<PROFILE_NAME>/emulator-resources/skins/<SKIN_NAME> --qemu-args -drive file=
-<TIZEN_SDK_DATA>/emulator/vms/<VM_NAME>/emulimg-<VM_NAME>.x86,if=virtio,index=1 -boot c -append "console=ttyS0 video=LVDS-1:480x800-32@60 dpi=2330 ip=10.0.2.16::10.0.2.2:255.255.255.0::eth0:none vm_name=<VM_NAME>" -serial file:
-<TIZEN_SDK_ DATA >/emulator/vms/<VM_NAME>/logs/emulator.klog -m 512 -M maru-x86-machine -net nic,model=virtio,macaddr=<MAC_ADDRESS> -soundhw all -usb -vga none -enable-vigs -L
-<TIZEN_SDK>/tools/emulator/data/bios -kernel
-<TIZEN_SDK>/tools/emulator/data/kernel/bzImage.x86 -net user,dhcpstart=10.0.2.16 -rtc base=utc -drive file=
-<TIZEN_SDK_DATA>/emulator/vms/<VM_NAME>/swap-<VM_NAME>.img,if=virtio,
-index=2 -enable-hax -vigs-backend gl -enable-yagl -yagl-backend vigs -device virtio-esm-pci -device virtio-hwkey-pci -device
-virtio-keyboard-pci -device virtio-evdi-pci -device virtio-sensor-pci,sensors=accel&geo&gyro&light&proxi&
-haptic&press&uv&hrm -device virtio-power-pci -device
-virtio-jack-pci,jacks=earjack&charger&usb -device codec-pci -device
-maru-brightness -device virtio-vmodem-pci -device maru-camera -device virtio-touchscreen-pci,max_point=10</pre>
- </li>
+ <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>306 (720 x 1280)</li>
+ </ul></li>
<li>Wearable
-<pre class="prettyprint"><TIZEN_SDK>/tools/emulator/bin/emulator-x86.exe --skin-args width=360 height=360 skin.path=
-<TIZEN_SDK>/platforms/<PROFILE_NAME>/emulator-resources/skins/<SKIN_NAME> --qemu-args -drive file=
-<TIZEN_SDK_DATA>/emulator/vms/
-<VM_NAME>/emulimg-<VM_NAME>.x86,if=virtio,index=1 -boot c -append &quot;console=ttyS0 video=LVDS-1:360x360-32@60 dpi=302 ip=10.0.2.16::10.0.2.2:255.255.255.0::eth0:none vm_name=<VM_NAME>&quot; -serial file:
-<TIZEN_SDK_DATA>/emulator/vms/<VM_NAME>/logs/emulator.klog -m 512 -M maru-x86-machine -net nic,model=virtio,macaddr=<MAC_ADDRESS> -soundhw all -usb -vga none -enable-vigs -L
-<TIZEN_SDK>/tools/emulator/data/bios -kernel <TIZEN_SDK>/tools/emulator/data/kernel/bzImage.x86 -net user,dhcpstart=10.0.2.16 -rtc base=utc -drive file=
-<TIZEN_SDK_DATA>/emulator/vms/<VM_NAME>/swap-<VM_NAME>.img,if=virtio,index=2 -enable-hax -vigs-backend gl -enable-yagl -yagl-backend vigs -device
-virtio-esm-pci -device virtio-hwkey-pci -device virtio-evdi-pci -device virtio-sensor-pci,
-sensors=accel&geo&gyro&light&proxi&haptic&press&uv&hrm -device
-virtio-power-pci -device virtio-jack-pci,jacks=charger&usb -device codec-pci -device
-maru-brightness -device virtio-vmodem-pci -device maru-camera -device virtio-touchscreen-pci,max_point=2 -device virtio-rotary-pci</pre>
- </li>
-
+ <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>
-<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>
+<li>Processors
+<p>The number of CPUs.</p></li>
-<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>
+
+<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>
-<tr>
-<td>Skin</td>
-<td><p>Skins are fitted to the screen resolution:</p>
<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>
+<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">File Sharing</a>.</p></li>
-<p>4 orientation modes are supported:</p>
-<ul>
-<li>Portrait (default), landscape, reverse portrait, and reverse landscape</li></ul>
+<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>
-</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 touchscreen 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>
+<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>
-<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>
+<li>Advanced Option
+<p>You can attach and detach devices.</p>
+<ul>
+ <li>Mobile
+ <ul>
+ <li>Sensor: accelerometer, gyroscope, geo-magnetic, proximity, light, haptic, pressure, ultraviolet, heartbeat rate meter</li>
+ <li>Device: camera, battery</li>
+ <li>Jack: ear jack, charger, USB</li>
+ </ul></li>
+ <li>Wearable
+ <ul>
+ <li>Sensor: accelerometer, gyroscope, geomagnetic, proximity, light, haptic, pressure, ultraviolet, heartbeat rate meter</li>
+ <li>Device: camera, battery</li>
+ <li>Jack: charger, USB</li>
+ </ul></li>
+</ul>
+</li>
+</ul>
-<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>
+<h2 id="controls" name="controls">Emulator Control Keys and Menu</h2>
-<li>On Windows® 7, inject the microphone into the host machine before starting the Emulator.</li> </ul>
+<p>The Tizen Emulator provides a variety of control keys and menus.</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>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>
+<li>Key window
+<p>The key window displays an independent hardware key input window, which can be moved to any position on the screen or docked to the left or right side of the main window. If the key window is docked with the main window, both windows can be moved together on the screen.</p>
+</li>
+<li>Toggle button
+<p>Use the toggle button to show or hide the key window.</p>
+</li>
+<li>Pair tag
+<p>The pair tag indicates that the Emulator main window and key window are in a pair. This tag is activated when the key window is open. The pair tag color changes every time the Emulator boot occurs.</p>
+</li>
+</ul>
-<tr>
-<td>Network connection</td>
-<td>Virtio</td>
-<td>Supported</td>
-<td>Raw socket protocol, such as ICMP, is not supported.</td>
-</tr>
+<p>The following figure illustrates the general purpose skin Emulator.</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>
-<tr>
-<td>Emulator Control Panel</td>
-<td>The Emulator Control Panel (ECP) supports different features depending on the deice 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, Ear Jack, 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>
+<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>
-</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>
+<p class="figure">Figure: Profile-specific skin Emulator</p>
-<tr>
-<td>Camera</td>
-<td><p>Virtual camera device connecting a host machine's Webcam</p>
-<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, VC-1 for both encoding and decoding, and H.264 for only 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>
+<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>
-<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 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="opengl" name="opengl">OpenGL® ES Acceleration Support</h3>
-
-<p>For the Emulator to support OpenGL® ES acceleration, you need: </p>
+<h3 id="controlkeys" name="controlkeys">Control Keys</h3>
+<p>The following keys are available on the Emulator:</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>
+ <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 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>
+ </li>
+ <li><strong>Back</strong> (mobile only)
+ <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>
-<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>
+<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>
-<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>
-
+<li>Emulator name (the top row in the menu)
+<p>Display the <strong>Detail Info</strong> window, showing the following information.</p>
<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>
+ <caption>Table: Emulator details</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</td>
+ <td>CPU architecture</td>
+ </tr>
+
+ <tr>
+ <td>RAM Size</td>
+ <td>RAM size (MB)</td>
+ </tr>
+
+ <tr>
+ <td>Display Resolution</td>
+ <td>Target display resolution</td>
+ </tr>
+
+ <tr>
+ <td>Display Density</td>
+ <td>DPI (dots per inch)</td>
+ </tr>
+
+
+ <tr>
+ <td>File Sharing</td>
+ <td>Whether host file sharing is supported</td>
+ </tr>
+
+ <tr>
+ <td>File Shared Path</td>
+ <td>Path to the shared host file</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>Image Path 1</td>
+ <td>Target image path</td>
+ </tr>
+
+ <tr>
+ <td>Image Path 2</td>
+ <td>Swap image path</td>
+ </tr>
+
+ <tr>
+ <td>Log Path</td>
+ <td>Emulator 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>
+
+<table class="note">
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </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>
+ <td class="note">The <strong>Always On Top</strong> feature is not supported in Mac OS® X.</td>
</tr>
-</tbody>
+ </tbody>
</table>
+</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>
-<h4 id="input" name="input">Input System </h4>
+<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>
-<table border="1">
- <caption>Table: Input differences</caption>
+<li><strong>Key Window</strong>
+<p>Show or hide the key window.</p>
+<table class="note">
<tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">The <strong>Key Window</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>
- <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>
+<li><strong>Advanced > About</strong>
+<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>
- <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>
+<li><strong>Shell</strong>
+<p>Open a Smart Development Bridge (SDB) shell command window.</p></li>
-<h4 id="graphics" name="graphics">Graphics and display</h4>
+<li><strong>Control Panel</strong>
+<p>Help to control or monitor the state of the Emulator dynamically. </p></li>
-
- <table border="1">
- <caption>Table: Graphics and display differences</caption>
- <tbody>
+<li><strong>Close</strong>
+<p>Exit the Emulator.</p></li>
- <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>
+</ul>
-
- <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>
+<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>
- <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 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>
+<p>To access the ECP:</p>
- <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>
+<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>
-<h4 id="codec" name="codec">Supported Media Formats and Codecs</h4>
+ <li>Command line interface (CLI)
+ <p>ECP CLI provides functional tools for controlling the Tizen Emulator without using the ECP UI application.</p>
- <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>
- <tr>
- <td>Encoder</td>
- <td>H.264</td>
- <td>Supported</td>
- <td>Not supported</td>
- </tr>
- </tbody>
- </table>
+<p>The CLI is located in the <span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>/tools/emulator/bin</span> directory.</p>
-<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 main features of the CLI are:</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>
+<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>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 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 class="figure">Figure: Emulator Manager</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 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:
+<p>The following tables list the supported commands of the ECP CLI.</p>
-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>
-
-<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>
+<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>
-<p>To stop the Emulator, right-click the Emulator and select <strong>Close</strong>.</p>
+<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>
+ <li>Device Manager
+ <p>The following table lists the Device Manager features and their availability on different profiles.</p>
-<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">
+ <table border="1">
+ <caption>Table: Device Manager features</caption>
+ <tbody>
- <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>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>
-<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>
+ <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>
-<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>306 (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>
+ <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 <a href="event_injec.htm">Event Injector</a> features and their availability on different profiles.</p>
+
+ <table border="1">
+ <caption>Table: Event Injector features</caption>
+ <tbody>
-<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>
-
+ <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, gyroscope 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>
-<li>RAM Size
-<p>The RAM size.</p>
+ <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>
-<table class="note">
+ <tr>
+ <td colspan = "2"><a href="event_injec.htm#device">Ear Jack</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">SDCard</a></td>
+ <td>Yes</td>
+ <td>No</td>
+ <td>You can inject 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 value via map. Also you can inject these manually. Log file as well.</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/receive a call via Call tab. Also you can send/receive SMS via SMS tab.</td>
+ </tr>
+
+ </tbody>
+ </table>
+</li>
+</ul>
- <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>
-
+<p>The ECP supports the following shortcuts:</p>
<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">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>
-
-<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>Advanced Option
-<p>You can attach and detach devices.</p>
-<ul>
- <li>Mobile
- <ul>
- <li>Sensor: accelerometer, gyroscope, geo-magnetic, proximity, light, haptic, pressure, ultraviolet, heartbeat rate meter</li>
- <li>Device: camera, battery</li>
- <li>Jack: ear jack, charger, USB</li>
- </ul></li>
- <li>Wearable
- <ul>
- <li>Sensor: accelerometer, gyroscope, geomagnetic, proximity, light, haptic, pressure, ultraviolet, heartbeat rate meter</li>
- <li>Device: camera, battery</li>
- <li>Jack: charger, USB</li>
- </ul></li>
-</ul>
-</li>
-
-</ul>
-
-<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="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>
-
-<ul>
-<li>Key window
-<p>The key window displays an independent hardware key input window, which can be moved to any position on the screen or docked to the left or right side of the main window. If the key window is docked with the main window, both windows can be moved together on the screen.</p>
-</li>
-<li>Toggle button
-<p>Use the toggle button to show or hide the key window.</p>
-</li>
-<li>Pair tag
-<p>The pair tag indicates that the Emulator main window and key window are in a pair. This tag is activated when the key window is open. The pair tag color changes every time the Emulator boot occurs.</p>
-</li>
-</ul>
-
-<p>The following figure illustrates the general purpose skin Emulator.</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>
- <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 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>
- </li>
- <li><strong>Back</strong> (mobile only)
- <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>Detail Info</strong> window, showing the following information.</p>
-<table border="1">
- <caption>Table: Emulator details</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</td>
- <td>CPU architecture</td>
- </tr>
-
- <tr>
- <td>RAM Size</td>
- <td>RAM size (MB)</td>
- </tr>
-
- <tr>
- <td>Display Resolution</td>
- <td>Target display resolution</td>
- </tr>
-
- <tr>
- <td>Display Density</td>
- <td>DPI (dots per inch)</td>
- </tr>
-
-
- <tr>
- <td>File Sharing</td>
- <td>Whether host file sharing is supported</td>
- </tr>
-
- <tr>
- <td>File Shared Path</td>
- <td>Path to the shared host file</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>Image Path 1</td>
- <td>Target image path</td>
- </tr>
-
- <tr>
- <td>Image Path 2</td>
- <td>Swap image path</td>
- </tr>
-
- <tr>
- <td>Log Path</td>
- <td>Emulator log file path</td>
- </tr>
+ <li>Key shortcuts for Windows® and Ubuntu® (Alt + <Key>)
+ <table border="1">
+ <tbody>
+ <tr align="center">
+ <th colspan="2">Common</th>
+ <th colspan="2">Mobile</th>
+ <th colspan="2">Wearable</th>
+ </tr>
+ <tr align="center">
+ <th>Key</th>
+ <th>Device</th>
+ <th>Key</th>
+ <th>Device</th>
+ <th>Key</th>
+ <th>Device</th>
+ </tr>
+ <tr align="center">
+ <td>D</td>
+ <td>Device Tree</td>
+ <td>B</td>
+ <td>Battery</td>
+ <td>B</td>
+ <td>Battery</td>
+ </tr>
+ <tr align="center">
+ <td>N</td>
+ <td>Network</td>
+ <td>R</td>
+ <td>RSSI</td>
+ <td>A</td>
+ <td>3-Axis sensor</td>
+ </tr>
+ <tr align="center">
+ <td>U</td>
+ <td>Uninstaller</td>
+ <td>A</td>
+ <td>3-Axis sensor</td>
+ <td>I</td>
+ <td>Light</td>
+ </tr>
+ <tr align="center">
+ <td>H</td>
+ <td>HDS (Host Directory Sharing)</td>
+ <td>I</td>
+ <td>Light</td>
+ <td>X</td>
+ <td>Proximity</td>
+ </tr>
+ <tr align="center">
+ <td></td>
+ <td></td>
+ <td>X</td>
+ <td>Proximity</td>
+ <td>E</td>
+ <td>Pressure</td>
+ </tr>
+ <tr align="center">
+ <td></td>
+ <td></td>
+ <td>E</td>
+ <td>Pressure</td>
+ <td>V</td>
+ <td>Ultraviolet</td>
+ </tr>
+ <tr align="center">
+ <td></td>
+ <td></td>
+ <td>V</td>
+ <td>Ultraviolet</td>
+ <td>M</td>
+ <td>Heart Rate Monitor</td>
+ </tr>
+ <tr align="center">
+ <td></td>
+ <td></td>
+ <td>M</td>
+ <td>Heart Rate Monitor</td>
+ <td>G</td>
+ <td>Touch gesture</td>
+ </tr>
+ <tr align="center">
+ <td></td>
+ <td></td>
+ <td>K</td>
+ <td>Ear Jack</td>
+ <td>S</td>
+ <td>USB</td>
+ </tr>
+ <tr align="center">
+ <td></td>
+ <td></td>
+ <td>S</td>
+ <td>USB</td>
+ <td></td>
+ <td></td>
+ </tr>
+ <tr align="center">
+ <td></td>
+ <td></td>
+ <td>D</td>
+ <td>SD Card</td>
+ <td></td>
+ <td></td>
+ </tr>
+ <tr align="center">
+ <td></td>
+ <td></td>
+ <td>L</td>
+ <td>Location</td>
+ <td></td>
+ <td></td>
+ </tr>
+ <tr align="center">
+ <td></td>
+ <td></td>
+ <td>T</td>
+ <td>Telephony</td>
+ <td></td>
+ <td></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>
-
-<table class="note">
- <tbody>
- <tr>
- <th class="note">Note</th>
- </tr>
- <tr>
- <td class="note">The <strong>Always On Top</strong> feature is not supported in Mac OS® X.</td>
- </tr>
- </tbody>
-</table>
-</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>Key Window</strong>
-<p>Show or hide the key window.</p>
-<table class="note">
- <tbody>
- <tr>
- <th class="note">Note</th>
- </tr>
- <tr>
- <td class="note">The <strong>Key Window</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, 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>
-
-<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>
-
+ </table>
+ </li>
+ <li>Arrows and tabs in the menu
+ <table border="1">
+ <tbody>
+ <tr align="center">
+ <th>Key</th>
+ <th>Action</th>
+ </tr>
+ <tr align="center">
+ <td>Up Arrow</td>
+ <td>Upper menu focus movement</td>
+ </tr>
+ <tr align="center">
+ <td>Down Arrow</td>
+ <td>Underneath menu focus movement</td>
+ </tr>
+ <tr align="center">
+ <td>Left Arrow</td>
+ <td>Collapse tree menu</td>
+ </tr>
+ <tr align="center">
+ <td>Right Arrow</td>
+ <td>Expand tree menu</td>
+ </tr>
+ <tr align="center">
+ <td>Tab</td>
+ <td>Move focus to next control</td>
+ </tr>
+ <tr align="center">
+ <td>Shift + Tab</td>
+ <td>Move focus to previous control</td>
+ </tr>
+ <tr align="center">
+ <td>Enter</td>
+ <td>Menu selection</td>
+ </tr>
+ </tbody>
+ </table>
+ </li>
</ul>
+
+<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>
- <h2 id="dir" name="dir">Emulator Directory Structure</h2>
-
-<p>The following table describes the content of the Emulator directory, located in the <span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>/tools/emulator</span> folder.</p>
-
- <table border="1">
- <caption>Table: Emulator directory content</caption>
- <tbody>
- <tr>
- <th>Folder or file</th>
- <th>Description</th>
- </tr>
-
- <tr>
- <td><span style="font-family: Courier New, Courier, monospace">bin/</span></td>
- <td>Binary files</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New, Courier, monospace">bin/emulator-control-panel.jar</span></td>
- <td>Emulator Control Panel</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New, Courier, monospace">bin/emulator-control-panel-cli.jar</span></td>
- <td>Emulator Control Panel CLI (Command Line Interface)</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New, Courier, monospace">bin/emulator-manager</span></td>
- <td>Emulator manager binary to launch the <span style="font-family: Courier New, Courier, monospace">emulator-manager.jar</span> file
- </td>
- </tr>
-
-
- <tr>
- <td><span style="font-family: Courier New, Courier, monospace">bin/emulator-manager.jar</span></td>
- <td>Emulator manager jar, which can also launch the
- Emulator with the <a href="#manager">Emulator
- Manager</a>.
- </td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New, Courier, monospace">bin/em-cli</span></td>
- <td>Emulator manager CLI (Command Line Interface)</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New, Courier, monospace">bin/emulator-skin.jar</span></td>
- <td>Emulator skin</td>
- </tr>
-
-
- <tr>
- <td><span style="font-family: Courier New, Courier, monospace">bin/emulator-x86</span></td>
- <td>x86 Emulator binary, including QEMU</td>
- </tr>
+<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><p>Skins are fitted to the screen resolution:</p>
+<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>
- <tr>
- <td><span style="font-family: Courier New, Courier, monospace">bin/protobuf.jar</span></td>
- <td>Protocol buffer library</td>
- </tr>
+<p>4 orientation modes are supported:</p>
+<ul>
+<li>Portrait (default), landscape, reverse portrait, and reverse landscape</li></ul>
- <tr>
- <td><span style="font-family: Courier New, Courier, monospace">bin/libecp.jar</span></td>
- <td>profile independent library for ECP</td>
- </tr>
-
- <tr>
- <td><span style="font-family: Courier New, Courier, monospace">bin/swt.jar</span></td>
- <td>SWT library</td>
- </tr>
-
- <tr>
- <td><span style="font-family: Courier New, Courier, monospace">bin/jna-<version>.jar</span></td>
- <td>JNA library</td>
- </tr>
+</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 touchscreen device</td>
+<td>Supported</td>
+<td>Multi-touch is supported.</td>
+</tr>
- <tr>
- <td><span style="font-family: Courier New, Courier, monospace">data/bios/</span></td>
- <td><span style="font-family: Courier New, Courier, monospace">.bin</span>
- files for initializing the guest OS</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New, Courier, monospace">data/kernel/</span></td>
- <td>Kernel image for the guest Linux OS</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New, Courier, monospace">storages/sdcard/sdcard_xxx.img</span></td>
- <td><span style="font-family: Courier New, Courier, monospace">.img</span>
- files (base sdcard images) specific to the data size used by the
- Emulator Manager</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New, Courier, monospace">storages/swap/swap.img</span></td>
- <td>Disk image for swap</td>
- </tr>
- </tbody>
- </table>
- <p>The following table describes the platform directories that are located in the <span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>/platform/<Profile>-<VERSION>/emulator-images</span> folder.</p>
-
-
- <table border="1">
- <caption>Table: Platform image directory content</caption>
- <tbody>
- <tr>
- <th>Name</th>
- <th>Description</th>
- </tr>
-
<tr>
- <td><span style="font-family: Courier New,Courier,monospace">x86-standard/</span></td>
- <td>Platform directory</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">x86-standard/emuling-<VERSION>.x86</span></td>
- <td>Base image, which represents an Emulator root file system for x86 in the guest OS view</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">x86-standard/info.ini</span></td>
- <td>File for specifying information of the Emulator disk image</td>
- </tr>
- </tbody>
-</table>
-
-<p>The following table describes the platform directories that are located in the <span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>/platforms/<Profile>-<VERSION>/emulator-resources</span> folder.</p>
-<table border="1">
- <caption>Table: Platform directory resource content</caption>
- <tbody>
- <tr>
- <th>Name</th>
- <th>Description</th>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">plugins/</span></td>
- <td>Plugins for profile</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">plugins/ecp-plugin.jar</span></td>
- <td>Plugin for the Emulator Control Panel</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">plugins/ecp-plugin.xml</span></td>
- <td>XML file for the <span style="font-family: Courier New,Courier,monospace">ecp-plugin.jar</span> file configuration</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">plugins/em-plugin.jar</span></td>
- <td>Plugin for the Emulator Manager</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">skins/</span></td>
- <td>Emulator skin images specific to the Emulator resolution, and icons for the Emulator option button and shortcut</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">skins/<skin name>/default.dbi</span></td>
- <td>Metafile for the Emulator skin layout</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">skins/<skin name>/info.ini</span></td>
- <td>File for specifying Emulator skin information</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">template/<image name>.xml</span></td>
- <td>XML file for default configuration of the virtual machine created by the Emulator Manage</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">template/<image name>-template.xml</span></td>
- <td>XML file for the template of the virtual machine created by the Emulator Manager</td>
- </tr>
-</tbody>
-</table>
+<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>
-
-<p>The following table describes the directory structure of the user-specific files that are located in the <span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK_DATA>/emulator/vms</span> folder.</p>
-
-
- <table border="1">
- <caption>Table: User directory content</caption>
- <tbody>
- <tr>
- <th>Name</th>
- <th>Description</th>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">emulator-manager.log</span></td>
- <td>Emulator Manager log file</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">last-created_<PROFILE>-<VERSION>_<image name>.xml</span></td>
- <td>This file saves properties of VM that user created last. And when user create new VM next time, properties in this file is displayed as default</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">.em.lock</span></td>
- <td>This lock file is used for synchronization between VM operation like modify, delete, launch</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">.tizen-em-info</span></td>
- <td>Configuration file for Emulator Manager</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace"><image name>/</span></td>
- <td>Target-specific images</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace"><image name>/.skin.properties</span></td>
- <td>Hidden data for the Emulator skin</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace"><image name>/emulimg-<image name>.x86</span></td>
- <td>Writable <span style="font-family: Courier New,Courier,monospace"><image name></span> image file</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace"><image name>/swap-<image name>.img</span></td>
- <td>Swap image file</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace"><image name>/vm_config.xml</span></td>
- <td>Hardware configuration (for more information, see <a href="#vm">Virtual Machine</a>)</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace"><image name>/${USER}.lock</span></td>
- <td>This lock file is used for synchronization between VM and Emulator Control Panel to set/get operations</td>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace"><image name>/logs/</span></td>
- <td>Log files (Emulator, kernel, emulator-skin log)</td>
- </tr>
- </tbody>
-</table>
-
-<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>
+<tr>
+<td>Display</td>
+<td>VGA card with 100 levels of brightness control</td>
+<td>Supported</td>
+<td>-</td>
+</tr>
-<p>To access the ECP:</p>
+<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>
-<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>
+<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>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>
+<li>On Windows® 7, inject the microphone into the host machine before starting the Emulator.</li> </ul>
-<p>The main features of the CLI are:</p>
+<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>
-<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>
+<tr>
+<td>Network connection</td>
+<td>Virtio</td>
+<td>Supported</td>
+<td>Raw socket protocol, such as ICMP, is not supported.</td>
+</tr>
-<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>
+<tr>
+<td>Emulator Control Panel</td>
+<td>The Emulator Control Panel (ECP) supports different features depending on the deice 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, Ear Jack, 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>
-<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>
+<td>Camera</td>
+<td><p>Virtual camera device connecting a host machine's Webcam</p>
+<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, VC-1 for both encoding and decoding, and H.264 for only 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><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>
+<td>Bluetooth</td>
+<td>-</td>
+<td>Not supported</td>
+<td>-</td>
</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>
- <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>
+<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>
- </tr>
- </tbody></table>
- </li>
- <li>Device Manager
- <p>The following table lists the Device Manager features and their availability on different profiles.</p>
+</tbody>
+</table>
- <table border="1">
- <caption>Table: Device Manager features</caption>
- <tbody>
+<h3 id="opengl" name="opengl">OpenGL® ES Acceleration Support</h3>
- <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>
+<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>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>
+ <tr>
+ <td>Target connection</td>
+ <td>USB</td>
+ <td>IPC (TCP/UDP)</td>
+ </tr>
- </tbody>
- </table> </li>
-
- <li>App Manager
- <p>The following table lists the App Manager features and their availability on different profiles.</p>
+ <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>
- <table border="1">
- <caption>Table: App Manager features</caption>
- <tbody>
+ <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>
- <th>Feature</th>
- <th>Mobile</th>
- <th>Wearable</th>
- <th>Description</th>
- </tr>
+ <tr>
+ <td>Bluetooth</td>
+ <td>Fully supported</td>
+ <td>Not supported</td>
+ </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>
+ <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>
+
- <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>
-
- <table border="1">
- <caption>Table: Event Injector features</caption>
- <tbody>
+<table border="1">
+ <caption>Table: Virtual sensor differences</caption>
+ <tbody>
- <tr>
- <th colspan = "2">Feature</th>
- <th>Mobile</th>
- <th>Wearable</th>
- <th>Description</th>
- </tr>
+ <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 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, gyroscope 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">Ear Jack</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">SDCard</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 a latitude and longitude value using the map. Also you can inject these manually. Log file as well.</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 using the Call tab. Also you can send and receive SMS using the SMS 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>
+
+ <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 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>
-
- </tbody>
- </table>
-</li>
-</ul>
-<p>The ECP supports the following shortcuts:</p>
-<ul>
- <li>Key shortcuts for Windows® and Ubuntu® (Alt + <Key>)
- <table border="1">
- <tbody>
- <tr align="center">
- <th colspan="2">Common</th>
- <th colspan="2">Mobile</th>
- <th colspan="2">Wearable</th>
- </tr>
- <tr align="center">
- <th>Key</th>
- <th>Device</th>
- <th>Key</th>
- <th>Device</th>
- <th>Key</th>
- <th>Device</th>
- </tr>
- <tr align="center">
- <td>D</td>
- <td>Device Tree</td>
- <td>B</td>
- <td>Battery</td>
- <td>B</td>
- <td>Battery</td>
- </tr>
- <tr align="center">
- <td>N</td>
- <td>Network</td>
- <td>R</td>
- <td>RSSI</td>
- <td>A</td>
- <td>3-Axis sensor</td>
- </tr>
- <tr align="center">
- <td>U</td>
- <td>Uninstaller</td>
- <td>A</td>
- <td>3-Axis sensor</td>
- <td>I</td>
- <td>Light</td>
- </tr>
- <tr align="center">
- <td>H</td>
- <td>HDS (Host Directory Sharing)</td>
- <td>I</td>
- <td>Light</td>
- <td>X</td>
- <td>Proximity</td>
- </tr>
- <tr align="center">
- <td></td>
- <td></td>
- <td>X</td>
- <td>Proximity</td>
- <td>E</td>
- <td>Pressure</td>
- </tr>
- <tr align="center">
- <td></td>
- <td></td>
- <td>E</td>
- <td>Pressure</td>
- <td>V</td>
- <td>Ultraviolet</td>
- </tr>
- <tr align="center">
- <td></td>
- <td></td>
- <td>V</td>
- <td>Ultraviolet</td>
- <td>M</td>
- <td>Heart Rate Monitor</td>
- </tr>
- <tr align="center">
- <td></td>
- <td></td>
- <td>M</td>
- <td>Heart Rate Monitor</td>
- <td>G</td>
- <td>Touch gesture</td>
- </tr>
- <tr align="center">
- <td></td>
- <td></td>
- <td>K</td>
- <td>Ear Jack</td>
- <td>S</td>
- <td>USB</td>
- </tr>
- <tr align="center">
- <td></td>
- <td></td>
- <td>S</td>
- <td>USB</td>
- <td>O</td>
- <td>Memory</td>
- </tr>
- <tr align="center">
- <td></td>
- <td></td>
- <td>D</td>
- <td>SD Card</td>
- <td></td>
- <td></td>
- </tr>
- <tr align="center">
- <td></td>
- <td></td>
- <td>L</td>
- <td>Location</td>
- <td></td>
- <td></td>
- </tr>
- <tr align="center">
- <td></td>
- <td></td>
- <td>T</td>
- <td>Telephony</td>
- <td></td>
- <td></td>
- </tr>
- <tr align="center">
- <td></td>
- <td></td>
- <td>O</td>
- <td>Memory</td>
- <td></td>
- <td></td>
- </tr>
+<h4 id="telephony" name="telephony">Telephony</h4>
- </tbody>
- </table>
- </li>
- <li>Arrows and tabs in the menu
- <table border="1">
- <tbody>
- <tr align="center">
- <th>Key</th>
- <th>Action</th>
- </tr>
- <tr align="center">
- <td>Up Arrow</td>
- <td>Upper menu focus movement</td>
- </tr>
- <tr align="center">
- <td>Down Arrow</td>
- <td>Underneath menu focus movement</td>
- </tr>
- <tr align="center">
- <td>Left Arrow</td>
- <td>Collapse tree menu</td>
- </tr>
- <tr align="center">
- <td>Right Arrow</td>
- <td>Expand tree menu</td>
- </tr>
- <tr align="center">
- <td>Tab</td>
- <td>Move focus to next control</td>
- </tr>
- <tr align="center">
- <td>Shift + Tab</td>
- <td>Move focus to previous control</td>
- </tr>
- <tr align="center">
- <td>Enter</td>
- <td>Menu selection</td>
- </tr>
- </tbody>
- </table>
- </li>
-</ul>
+ <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>
+ <tr>
+ <td>Encoder</td>
+ <td>H.264</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>
<body onload="prettyPrint()" style="overflow: auto;">
-<div id="navigation">
+<div id="toc-navigation">
<div id="profile">
- <p><img alt="Mobile Web" src="../images/mw_icon.png"/> <img alt="Wearable Web" src="../images/ww_icon.png"/> <img alt="Mobile native" src="../images/mn_icon.png"/></p>
+ <p><img alt="Mobile Web" src="../images/mw_icon.png"/> <img alt="Wearable Web" src="../images/ww_icon.png"/> <img alt="Mobile native" src="../images/mn_icon.png"/> <img alt="Wearable native" src="../images/wn_icon.png"/></p>
</div>
<div id="toc_border"><div id="toc">
<p class="toc-title">Content</p>
<li><a href="#file">File Sharing</a></li>
<li><a href="#hw">Using Hardware Virtualization</a></li>
<li><a href="#eventcast">Using EventCast</a></li>
+ <li><a href="#startup">Emulator Start-up Options</a></li>
+ <li><a href="#dir">Emulator Directory Structure</a></li>
</ul>
</div></div>
</div>
<li><a href="#file">Share files</a></li>
<li><a href="#hw">Use hardware virtualization</a></li>
<li><a href="#eventcast">Use EventCast</a></li>
+<li><a href="#startup">Emulator Start-up Options</a></li>
+<li><a href="#dir">Emulator Directory Structure</a></li>
</ul>
<h2 id="multi" name="multi">Using Multi-point Touch</h2>
<li>Click <strong>Show Event</strong>. You can now inject a sensor or touch value to the Emulator.</li>
</ol></li></ul>
+<h2 id="startup" name="startup">Emulator Start-up Options</h2>
+<p>You can launch the Emulator with specific settings by defining start-up options in the command line:</p>
+<pre class="prettyprint">
+# ./emulator-x86 --skin-args <skin options> --qemu-args <QEMU options>
+</pre>
+
+<p>The Emulator binaries are located in the <span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>/tools/emulator/bin</span> directory. The Tizen Emulator provides 2 types of start-up options that you can set: skin options (such as width and height) and QEMU options (such as network and memory).</p>
+
+
+<p>The following tables list the available options.</p>
+<table style="width: 100%" border="1">
+ <caption>Table: Emulator skin options</caption>
+ <tbody>
+ <tr>
+ <th>Category</th>
+ <th>Option</th>
+ <th>Mandatory</th>
+ <th>Description</th>
+</tr>
+<tr>
+<td rowspan="2">Resolution</td>
+<td><span style="font-family: Courier New,Courier,monospace">width=x</span></td>
+<td>Yes</td>
+<td>This option makes the Emulator use a specific skin image width. The width value must be one of the video resolutions that the Emulator can support. </td>
+</tr>
+<tr>
+<td><span style="font-family: Courier New,Courier,monospace">height=x</span></td>
+<td>Yes</td>
+<td>This option makes the Emulator use a specific skin image height. The height value must be one of the video resolutions that the Emulator can support.
+</td>
+</tr>
+
+<tr>
+<td>Heartbeat</td>
+<td><span style="font-family: Courier New,Courier,monospace">hb.ignore=x</span></td>
+<td>No</td>
+<td>This option is used to activate the Emulator debugging mode. Generally, a skin process for the Emulator periodically checks the heartbeat that an Emulator process sends.<br/>
+When the Emulator is in the debugging mode using gdb, the skin process is terminated automatically, because the Emulator cannot send a heartbeat to the skin process. In that case, you can set the <span style="font-family: Courier New,Courier,monospace">hb.ignore</span> option as <span style="font-family: Courier New,Courier,monospace">true</span> to debug the Emulator.<br/>
+If this option is <span style="font-family: Courier New,Courier,monospace">true</span>, the skin process does not check the heartbeat that the Emulator sends. The default value of this option is <span style="font-family: Courier New,Courier,monospace">false</span>.
+</td>
+</tr>
+<tr>
+<td>Skin image file path</td>
+<td><span style="font-family: Courier New,Courier,monospace">skin.path=xxx</span></td>
+<td>Yes</td>
+<td>Emulator loads the skin image files in this path. If this option is omitted, the Emulator finds the image files in the installed 'skins' directory.</td>
+</tr>
+</tbody>
+</table>
+
+<table style="width: 100%" border="1">
+ <caption>Table: Emulator QEMU options</caption>
+ <tbody>
+ <tr>
+ <th>Category</th>
+ <th>Option</th>
+ <th>Description</th>
+</tr>
+ <tr>
+<td rowspan="1">File system image</td>
+<td><span style="font-family: Courier New,Courier,monospace">-drive file=<IMAGE_PATH>/emulimg.x86</span></td>
+<td>Sets an image path to the file to be used as a drive image.</td>
+</tr>
+<tr>
+<td rowspan="1">Swap file system image</td>
+<td><span style="font-family: Courier New,Courier,monospace">-drive file=<SWAP_IMAGE_PATH>/swap.img</span></td>
+<td>Sets a swap image path to the file to be used as a swap image.</td>
+</tr>
+<tr>
+<td rowspan="2">Network</td>
+<td><span style="font-family: Courier New,Courier,monospace">-net user</span></td>
+<td>Uses the user mode network stack, which requires no administrator privilege to run.</td>
+</tr>
+<tr>
+<td><span style="font-family: Courier New,Courier,monospace">-net nic,model=virtio,macaddr=<MAC_ADDRESS>
+</span></td>
+<td>Creates a new network interface card and connects it to VIRTIO. <MAC_ADDRESS> is recorded in <span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK_DATA>/emulator/vms/.tizen-em-info</span>. For example: <span style="font-family: Courier New,Courier,monospace">E8:11:32:33:38:81</span>
+</td>
+</tr>
+<tr>
+<td>USB</td>
+<td><span style="font-family: Courier New,Courier,monospace">-usb</span></td>
+<td>Enables the USB driver.</td>
+</tr>
+<tr>
+<td>TouchScreen</td>
+<td><span style="font-family: Courier New,Courier,monospace">-device virtio-touchscreen-pci</span></td>
+<td>Uses the Maru Touchscreen device for display.</td>
+</tr>
+<tr>
+<td>Kernel</td>
+<td><span style="font-family: Courier New,Courier,monospace">-kernel <KERNEL_PATH></span></td>
+<td>Uses bzImage as the kernel image.</td>
+</tr>
+<tr>
+<td rowspan="2">BIOS</td>
+<td><span style="font-family: Courier New,Courier,monospace">-vga none</span></td>
+<td>Sets the VGA card.</td>
+</tr>
+<tr>
+<td><span style="font-family: Courier New,Courier,monospace">-L <BIOS_PATH></span></td>
+<td>Sets the directory for the BIOS, VGA BIOS, and key maps.</td>
+</tr>
+<tr>
+<td>Time</td>
+<td><span style="font-family: Courier New,Courier,monospace">-rtc base=utc</span></td>
+<td>Sets the real time clock with UTC.</td>
+</tr>
+<tr>
+<td>KVM (in Ubuntu®)</td>
+<td><span style="font-family: Courier New,Courier,monospace">-enable-kvm</span></td>
+<td>Enables KVM (hardware virtualization support).</td>
+</tr>
+<tr>
+<td>HAX (in Windows® or Mac OS® X)</td>
+<td><span style="font-family: Courier New,Courier,monospace">-enable-hax</span></td>
+<td>Enables HAX (hardware virtualization support).</td>
+</tr>
+<tr>
+<td>SMP</td>
+<td><span style="font-family: Courier New,Courier,monospace">-smp <NUMBER OF CPUs></span></td>
+<td>Sets the number of CPUs.</td>
+</tr>
+<tr>
+<td>Boot order</td>
+<td><span style="font-family: Courier New,Courier,monospace">-boot c</span></td>
+<td>Sets the boot order of the Emulator. The letter c indicates a hard disk.</td>
+</tr>
+<tr>
+<td>Kernel parameters </td>
+<td><span style="font-family: Courier New,Courier,monospace">-append<parameters></span></td>
+<td>Sets the kernel command line parameters from the Emulator to the kernel.</td>
+</tr>
+<tr>
+<td>Kernel log</td>
+<td><span style="font-family: Courier New,Courier,monospace">-serial file:<LOG_PATH>/emulator.klog</span></td>
+<td>Writes the kernel log into the <span style="font-family: Courier New,Courier,monospace"><LOG_PATH>/emulator.klog</span> file.</td>
+</tr>
+<tr>
+<td>Memory</td>
+<td><span style="font-family: Courier New,Courier,monospace">-m <MEMORY_SIZE></span></td>
+<td>Sets the memory size in the Tizen platform to, for example, 512 or 1024.</td>
+</tr>
+<tr>
+<td>Board</td>
+<td><span style="font-family: Courier New,Courier,monospace">-M maru-x86-machine</span></td>
+<td>Sets the Emulator machine as <span style="font-family: Courier New,Courier,monospace">maru-x86-machine</span>.</td>
+</tr>
+<tr>
+<td rowspan="2">Video card</td>
+<td><span style="font-family: Courier New,Courier,monospace">-enable-vigs</span></td>
+<td>Enables VIGS (Virtualized Graphics System) as the video card.</td>
+</tr>
+<tr>
+<td><span style="font-family: Courier New,Courier,monospace">-vigs-backend <VIGS_BACKEND></span></td>
+<td>Sets the back end as <span style="font-family: Courier New,Courier,monospace">sw</span> or <span style="font-family: Courier New,Courier,monospace">gl</span> (software or OpenGL®).</td>
+</tr>
+<tr>
+<td rowspan="2">GPU support</td>
+<td><span style="font-family: Courier New,Courier,monospace">-enable-yagl</span></td>
+<td>Enables host GL acceleration.</td>
+</tr>
+<tr>
+<td><span style="font-family: Courier New,Courier,monospace">-yagl-backend <YAGL_BACKEND>
+</span></td>
+<td>Sets the back end as vigs or offscreen.</td>
+</tr>
+<tr>
+<td>Sound</td>
+<td><span style="font-family: Courier New,Courier,monospace">-soundhw all</span></td>
+<td>Enables all sound cards.</td>
+</tr>
+<tr>
+<td>Display booting status</td>
+<td><span style="font-family: Courier New,Courier,monospace">-device virtio-esm-pci</span></td>
+<td>Sets the display booting status of the Emulator.</td>
+</tr>
+<tr>
+<td>Codec</td>
+<td><span style="font-family: Courier New,Courier,monospace">-device codec-pci</span></td>
+<td>Enables codec devices.</td>
+</tr>
+
+<tr>
+<td>Hardware key</td>
+<td><span style="font-family: Courier New,Courier,monospace">-device virtio-hwkey-pci</span></td>
+<td>Enables hardware keys.</td>
+</tr>
+
+<tr>
+<td>Host keyboard</td>
+<td><span style="font-family: Courier New,Courier,monospace">-device virtio-keyboard-pci</span></td>
+<td>Enables host keyboards.</td>
+</tr>
+
+<tr>
+<td>Rotary</td>
+<td><span style="font-family: Courier New,Courier,monospace">-device virtio-rotary-pci</span></td>
+<td>Enables a rotary device.</td>
+</tr>
+
+<tr>
+<td>Brightness</td>
+<td><span style="font-family: Courier New,Courier,monospace">-device maru-brightness</span></td>
+<td>Enables the brightness control.</td>
+</tr>
+
+<tr>
+<td>Camera</td>
+<td><span style="font-family: Courier New,Courier,monospace">-device maru-camera</span></td>
+<td>Enables the host Webcam support.</td>
+</tr>
+
+<tr>
+<td>Power</td>
+<td><span style="font-family: Courier New,Courier,monospace">-device virtio-power-pci</span></td>
+<td>Enables the battery.</td>
+</tr>
+
+<tr>
+<td>Jack</td>
+<td><span style="font-family: Courier New,Courier,monospace">-device virtio-jack-pci,jacks=<Jack types></span></td>
+<td>Enables jack devices. Supported jacks are USB, ear jack, ear key, HDMI, and charger. The ampersand ('&') symbol is used for multiple jacks. </td>
+</tr>
+
+<tr>
+<td>Emulator virtual device interface</td>
+<td><span style="font-family: Courier New,Courier,monospace">-device virtio-evdi-pci</span></td>
+<td>Enables the common interface between the Emulator daemon on the guest side and the Emulator on the host side.
+<p>To use the Emulator Control Panel, this option is required.</p></td>
+</tr>
+
+<tr>
+<td>Sensors</td>
+<td><span style="font-family: Courier New,Courier,monospace">-device virtio-sensor-pci,sensors=<Sensor types></span></td>
+<td>Enables sensor devices. Supported sensors are accelerometer, gyroscope, geomagnetic, light, proximity, haptic, pressure, ultraviolet, and heart rate monitor.
+<p>The names of sensor types are accel, gyro, geo, light, proxy, haptic, press, uv, and hrm, respectively. The ampersand ('&') symbol is used for multiple sensor support.</p></td>
+</tr>
+
+<tr>
+<td>Vmodem</td>
+<td><span style="font-family: Courier New,Courier,monospace">-device virtio-vmodem-pci</span></td>
+<td>Enables the Virtual Modem.</td>
+</tr>
+</tbody>
+</table>
+
+<p>The following command is an example of using the Emulator start-up options:</p>
+
+<ul>
+ <li>Mobile
+<pre class="prettyprint"><TIZEN_SDK>/tools/emulator/bin/emulator-x86.exe --skin-args width=480 height=800 skin.path=
+<TIZEN_SDK>/platforms/<PROFILE_NAME>/emulator-resources/skins/<SKIN_NAME> --qemu-args -drive file=
+<TIZEN_SDK_DATA>/emulator/vms/<VM_NAME>/emulimg-<VM_NAME>.x86,if=virtio,index=1 -boot c -append "console=ttyS0 video=LVDS-1:480x800-32@60 dpi=2330 ip=10.0.2.16::10.0.2.2:255.255.255.0::eth0:none vm_name=<VM_NAME>" -serial file:
+<TIZEN_SDK_ DATA >/emulator/vms/<VM_NAME>/logs/emulator.klog -m 512 -M maru-x86-machine -net nic,model=virtio,macaddr=<MAC_ADDRESS> -soundhw all -usb -vga none -enable-vigs -L
+<TIZEN_SDK>/tools/emulator/data/bios -kernel
+<TIZEN_SDK>/tools/emulator/data/kernel/bzImage.x86 -net user,dhcpstart=10.0.2.16 -rtc base=utc -drive file=
+<TIZEN_SDK_DATA>/emulator/vms/<VM_NAME>/swap-<VM_NAME>.img,if=virtio,
+index=2 -enable-hax -vigs-backend gl -enable-yagl -yagl-backend vigs -device virtio-esm-pci -device virtio-hwkey-pci -device
+virtio-keyboard-pci -device virtio-evdi-pci -device virtio-sensor-pci,sensors=accel&geo&gyro&light&proxi&
+haptic&press&uv&hrm -device virtio-power-pci -device
+virtio-jack-pci,jacks=earjack&charger&usb -device codec-pci -device
+maru-brightness -device virtio-vmodem-pci -device maru-camera -device virtio-touchscreen-pci,max_point=10</pre>
+ </li>
+
+ <li>Wearable
+<pre class="prettyprint"><TIZEN_SDK>/tools/emulator/bin/emulator-x86.exe --skin-args width=360 height=360 skin.path=
+<TIZEN_SDK>/platforms/<PROFILE_NAME>/emulator-resources/skins/<SKIN_NAME> --qemu-args -drive file=
+<TIZEN_SDK_DATA>/emulator/vms/
+<VM_NAME>/emulimg-<VM_NAME>.x86,if=virtio,index=1 -boot c -append &quot;console=ttyS0 video=LVDS-1:360x360-32@60 dpi=302 ip=10.0.2.16::10.0.2.2:255.255.255.0::eth0:none vm_name=<VM_NAME>&quot; -serial file:
+<TIZEN_SDK_DATA>/emulator/vms/<VM_NAME>/logs/emulator.klog -m 512 -M maru-x86-machine -net nic,model=virtio,macaddr=<MAC_ADDRESS> -soundhw all -usb -vga none -enable-vigs -L
+<TIZEN_SDK>/tools/emulator/data/bios -kernel <TIZEN_SDK>/tools/emulator/data/kernel/bzImage.x86 -net user,dhcpstart=10.0.2.16 -rtc base=utc -drive file=
+<TIZEN_SDK_DATA>/emulator/vms/<VM_NAME>/swap-<VM_NAME>.img,if=virtio,index=2 -enable-hax -vigs-backend gl -enable-yagl -yagl-backend vigs -device
+virtio-esm-pci -device virtio-hwkey-pci -device virtio-evdi-pci -device virtio-sensor-pci,
+sensors=accel&geo&gyro&light&proxi&haptic&press&uv&hrm -device
+virtio-power-pci -device virtio-jack-pci,jacks=charger&usb -device codec-pci -device
+maru-brightness -device virtio-vmodem-pci -device maru-camera -device virtio-touchscreen-pci,max_point=2 -device virtio-rotary-pci</pre>
+ </li>
+
+</ul>
+
+<h2 id="dir" name="dir">Emulator Directory Structure</h2>
+
+<p>The following table describes the content of the Emulator directory, located in the <span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>/tools/emulator</span> folder.</p>
+
+ <table border="1">
+ <caption>Table: Emulator directory content</caption>
+ <tbody>
+ <tr>
+ <th>Folder or file</th>
+ <th>Description</th>
+ </tr>
+
+ <tr>
+ <td><span style="font-family: Courier New, Courier, monospace">bin/</span></td>
+ <td>Binary files</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New, Courier, monospace">bin/emulator-control-panel.jar</span></td>
+ <td>Emulator Control Panel</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New, Courier, monospace">bin/emulator-control-panel-cli.jar</span></td>
+ <td>Emulator Control Panel CLI (Command Line Interface)</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New, Courier, monospace">bin/emulator-manager</span></td>
+ <td>Emulator manager binary to launch the <span style="font-family: Courier New, Courier, monospace">emulator-manager.jar</span> file
+ </td>
+ </tr>
+
+
+ <tr>
+ <td><span style="font-family: Courier New, Courier, monospace">bin/emulator-manager.jar</span></td>
+ <td>Emulator manager jar, which can also launch the
+ Emulator with the <a href="#manager">Emulator
+ Manager</a>.
+ </td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New, Courier, monospace">bin/em-cli</span></td>
+ <td>Emulator manager CLI (Command Line Interface)</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New, Courier, monospace">bin/emulator-skin.jar</span></td>
+ <td>Emulator skin</td>
+ </tr>
+
+
+ <tr>
+ <td><span style="font-family: Courier New, Courier, monospace">bin/emulator-x86</span></td>
+ <td>x86 Emulator binary, including QEMU</td>
+ </tr>
+
+
+ <tr>
+ <td><span style="font-family: Courier New, Courier, monospace">bin/protobuf.jar</span></td>
+ <td>Protocol buffer library</td>
+ </tr>
+
+ <tr>
+ <td><span style="font-family: Courier New, Courier, monospace">bin/libecp.jar</span></td>
+ <td>profile independent library for ECP</td>
+ </tr>
+
+ <tr>
+ <td><span style="font-family: Courier New, Courier, monospace">bin/swt.jar</span></td>
+ <td>SWT library</td>
+ </tr>
+
+ <tr>
+ <td><span style="font-family: Courier New, Courier, monospace">bin/jna-<version>.jar</span></td>
+ <td>JNA library</td>
+ </tr>
+
+ <tr>
+ <td><span style="font-family: Courier New, Courier, monospace">data/bios/</span></td>
+ <td><span style="font-family: Courier New, Courier, monospace">.bin</span>
+ files for initializing the guest OS</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New, Courier, monospace">data/kernel/</span></td>
+ <td>Kernel image for the guest Linux OS</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New, Courier, monospace">storages/sdcard/sdcard_xxx.img</span></td>
+ <td><span style="font-family: Courier New, Courier, monospace">.img</span>
+ files (base sdcard images) specific to the data size used by the
+ Emulator Manager</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New, Courier, monospace">storages/swap/swap.img</span></td>
+ <td>Disk image for swap</td>
+ </tr>
+ </tbody>
+ </table>
+
+ <p>The following table describes the platform directories that are located in the <span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>/platform/<Profile>-<VERSION>/emulator-images</span> folder.</p>
+
+
+ <table border="1">
+ <caption>Table: Platform image directory content</caption>
+ <tbody>
+ <tr>
+ <th>Name</th>
+ <th>Description</th>
+ </tr>
+
+<tr>
+ <td><span style="font-family: Courier New,Courier,monospace">x86-standard/</span></td>
+ <td>Platform directory</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">x86-standard/emuling-<VERSION>.x86</span></td>
+ <td>Base image, which represents an Emulator root file system for x86 in the guest OS view</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">x86-standard/info.ini</span></td>
+ <td>File for specifying information of the Emulator disk image</td>
+ </tr>
+ </tbody>
+</table>
+
+<p>The following table describes the platform directories that are located in the <span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK>/platforms/<Profile>-<VERSION>/emulator-resources</span> folder.</p>
+<table border="1">
+ <caption>Table: Platform directory resource content</caption>
+ <tbody>
+ <tr>
+ <th>Name</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">plugins/</span></td>
+ <td>Plugins for profile</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">plugins/ecp-plugin.jar</span></td>
+ <td>Plugin for the Emulator Control Panel</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">plugins/ecp-plugin.xml</span></td>
+ <td>XML file for the <span style="font-family: Courier New,Courier,monospace">ecp-plugin.jar</span> file configuration</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">plugins/em-plugin.jar</span></td>
+ <td>Plugin for the Emulator Manager</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">skins/</span></td>
+ <td>Emulator skin images specific to the Emulator resolution, and icons for the Emulator option button and shortcut</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">skins/<skin name>/default.dbi</span></td>
+ <td>Metafile for the Emulator skin layout</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">skins/<skin name>/info.ini</span></td>
+ <td>File for specifying Emulator skin information</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">template/<image name>.xml</span></td>
+ <td>XML file for default configuration of the virtual machine created by the Emulator Manage</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">template/<image name>-template.xml</span></td>
+ <td>XML file for the template of the virtual machine created by the Emulator Manager</td>
+ </tr>
+</tbody>
+</table>
+
+
+<p>The following table describes the directory structure of the user-specific files that are located in the <span style="font-family: Courier New,Courier,monospace"><TIZEN_SDK_DATA>/emulator/vms</span> folder.</p>
+
+
+ <table border="1">
+ <caption>Table: User directory content</caption>
+ <tbody>
+ <tr>
+ <th>Name</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">emulator-manager.log</span></td>
+ <td>Emulator Manager log file</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">last-created_<PROFILE>-<VERSION>_<image name>.xml</span></td>
+ <td>This file saves properties of VM that user created last. And when user create new VM next time, properties in this file is displayed as default</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">.em.lock</span></td>
+ <td>This lock file is used for synchronization between VM operation like modify, delete, launch</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">.tizen-em-info</span></td>
+ <td>Configuration file for Emulator Manager</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace"><image name>/</span></td>
+ <td>Target-specific images</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace"><image name>/.skin.properties</span></td>
+ <td>Hidden data for the Emulator skin</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace"><image name>/emulimg-<image name>.x86</span></td>
+ <td>Writable <span style="font-family: Courier New,Courier,monospace"><image name></span> image file</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace"><image name>/swap-<image name>.img</span></td>
+ <td>Swap image file</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace"><image name>/vm_config.xml</span></td>
+ <td>Hardware configuration (for more information, see <a href="#vm">Virtual Machine</a>)</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace"><image name>/${USER}.lock</span></td>
+ <td>This lock file is used for synchronization between VM and Emulator Control Panel to set/get operations</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace"><image name>/logs/</span></td>
+ <td>Log files (Emulator, kernel, emulator-skin log)</td>
+ </tr>
+ </tbody>
+</table>
+
+
+
<script type="text/javascript" src="../scripts/jquery.zclip.min.js"></script>
<script type="text/javascript" src="../scripts/showhide.js"></script>
</script>
</body>
-</html>
\ No newline at end of file
+</html>
projects / sdk / online-doc.git / commitdiff