</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>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">Directory 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="#hw">Using Hardware Virtualization</a>.</p></li>
<p>Please refer to CLI's help messages for detailed information.</p>
-<p class="figure">Figure: Emulator Manager command line</p>
-<p style="text-align:center;"><img alt="Emulator Manager command line" src="../images/emulator_cli.png" /></p>
+<p class="figure">Figure: Emulator Manager command line</p>
+<p style="text-align:center;"><img alt="Emulator Manager command line" src="../images/emulator_cli.png" /></p>
<h2 id="hw" name="hw">Using Hardware Virtualization</h2>
<p>In order to run App faster, the Tizen x86 Emulator exploits <a href="http://www.linux-kvm.org/page/Main_Page" target="_blank">KVM</a> (Kernel-based Virtual Machine in Linux) or <a href="https://developer.tizen.org/sdk/haxm" target="_blank">HAX</a> (Hardware Accelerated eXecution in Windows® and Mac OS® X) with HW virtualization support.</p>
<ul>
<li>In Linux:
-<p>No installation is required for KVM.</p>
+<p>No installation is required for KVM.</p>
</li>
<li>In Windows® and Mac OS® X:
<p>The HAXM driver is installed during the Tizen SDK installation. See the installation manual on the <a href="https://developer.tizen.org/sdk/haxm" target="_blank">Tizen developer site</a>.</p>
</tr>
</tbody>
</table></li></ul>
-
+
<p>No configuration is required for KVM or HAX.</p>
<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.</p>
+ <p>If you long press the <strong>Home</strong> key, the Task switcher application appears as in a real device.</p>
</li>
<li><strong>Back</strong> (mobile only)
<p>When you tap, it returns to the previous screen.</p>
<tr>
- <td>File Sharing</td>
+ <td>Directory Sharing</td>
<td>Whether host directory sharing is used or not</td>
</tr>
<h2 id="ecp" name="ecp">Emulator Control Panel</h2>
<p>You can execute the ECP by selecting <strong>Control Panel</strong> on the <a href="#name">Context Menu</a> after the Emulator was successfully launched. You can control and monitor the state of the Emulator dynamically.</p>
-<p>The main features of ECP:</p>
+<p>The main features of ECP:</p>
<ul>
<li>Device Manager
<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>
+
+ </tbody>
+ </table>
</li>
-
-
+
+
<li>Event Injector
<p>The following table lists the Event Injector features and their availability on different profiles.</p>
<tr>
<th colspan = "2">Feature</th>
- <th>Mobile</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.
+ <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>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>
-
+ <td>You can inject user acceleration, magnetic, gyroscope using slider bars or text input.</td>
+ </tr>
+
<tr>
- <td>Light</td>
+ <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>
+ <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>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>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>
+
+ </tbody>
+ </table>
</li>
</ul>
</table>
</li>
</ul>
-
+
<h3 name="ecp-cli">Emulator Control Panel CLI</h3>
<p>You can control and monitor the Tizen Emulator by using ECP CLI instead of the ECP UI tool. The ECP CLI supports all the functionalities of the ECP UI. The CLI binary is located at:
<p>You can access this mode by running the binary without any parameters. The mode keeps a session until it is exited. You can exit by entering the <span style="font-family: Courier New,Courier,monospace">exit</span> command.</p></li>
<li>Shell mode
<p>This mode is used for one-time message handling.</p></li></ul></li>
-<p class="figure">Figure: Session and shell modes</p>
+<p class="figure">Figure: Session and shell modes</p>
<p style="text-align: center;"> <img alt="Session and shell modes" src="../images/ecp_cli_modes.png" /> </p></p>
<p>In Linux, the bash-based auto-completion is used with the TAB button.</p>
<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>
+ </tbody></table>
<table>
<caption>Table: CLI profile commands</caption>
<th>Command</th>
<th>Mobile</th>
<th>Wearable</th>
- <th>Syntax</th>
+ <th>Syntax</th>
</tr>
<tr>
- <td rowspan="5">call</td>
+ <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 rowspan="5">No</td>
<td><span style="font-family: Courier New,Courier,monospace">call dial <number></span></td>
</tr>
<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>
<tr>
- <td rowspan="4">sms</td>
+ <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 rowspan="4">No</td>
<td><span style="font-family: Courier New,Courier,monospace">sms send <number> <text></span></td>
</tr>
<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>
<tr>
- <td rowspan="4">location</td>
+ <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 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">location file <file-path></span></td>
</tr>
<tr>
- <td rowspan="3">battery</td>
+ <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 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">battery status</span></td>
</tr>
<tr>
- <td rowspan="2">earjack</td>
+ <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 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">earjack status</span></td>
</tr>
<tr>
- <td rowspan="2">usb</td>
+ <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 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">usb status</span></td>
</tr>
<tr>
- <td rowspan="2">rssi</td>
+ <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 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">rssi status</span></td>
</tr>
<tr>
- <td rowspan="3">sdcard</td>
+ <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 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">sdcard status</span></td>
</tr>
<tr>
- <td rowspan="10">sensor</td>
+ <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 rowspan="10">Yes</td>
<td><span style="font-family: Courier New,Courier,monospace">sensor accelerometer <x> <y> <z></span></td>
- </tr>
+ </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>
<td>Skin</td>
-<td><p>Skins are fitted to the screen resolution:</p>
+<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>
<li>Wearable
<ul><li>320 x 320</li>
<li>360 x 360 (default)</li>
<li>360 x 480</li>
</ul>
</li>
-</ul>
+</ul>
-<p>4 orientation modes are supported:</p>
+<p>4 orientation modes are supported:</p>
<ul>
<li>Portrait (default), landscape, reverse portrait, and reverse landscape</li></ul>
<td>Sound</td>
<td>AC97 device</td>
<td>Supported</td>
-<td>Audio in:
+<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>Make sure that the input volume of the microphone is enough to record your voice or songs on the host machine.</li>
<li>On Windows® 7, inject the microphone into the host machine before starting the Emulator.</li> </ul>
-<p>Audio out:</p>
+<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>On Windows® 7, enable at least 1 audio out device before starting the Emulator. Make sure that the volume icon in the tray is not disabled.</li>
<li>While the Emulator is running, do not disable the audio out device, as it can lock the audio system of the guest platform.</li></ul>
</td>
</tr>
<tr>
<td>Camera</td>
-<td><p>Virtual camera device connecting a host machine's Webcam</p>
+<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>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>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>
<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;">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>
<td>Not supported</td>
<td>Supported</td>
</tr>
-
+
<tr>
<td rowspan ="10">Portability</td>
<td>Screen resolution</td>
<td>Bluetooth</td>
<td>Fully supported</td>
<td>Not supported</td>
- </tr>
-
+ </tr>
+
<tr>
- <td rowspan ="3">Performance</td>
+ <td rowspan ="3">Performance</td>
<td>CPU performance</td>
<td>Mobile CPU</td>
<td>Desktop CPU (with hardware virtualization)</td>
<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;">Physical target</th>
<th style="text-align:center;margin-left:auto;margin-right:auto;">Emulator</th>
</tr>
<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>
<p class="toc-title">Content</p>
<ul class="toc">
<li><a href="#multi">Using Multi-point Touch</a></li>
+ <li><a href="#file">Sharing directory</a></li>
<li><a href="#webcam">Using a Webcam</a></li>
<li><a href="#net">Using Emulator in a Network</a></li>
<li><a href="#skin">Using Custom Skin Layout</a></li>
- <li><a href="#file">File Sharing</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>
<h1>Using the Extended Emulator Features</h1>
<p>The Emulator features can be extended in many ways. With the Emulator, you can:</p>
<ul>
-<li><a href="#multi">Use multi-point touch</a></li>
-<li><a href="#webcam">Use a Webcam</a></li>
-<li><a href="#net">Use network features</a></li>
-<li><a href="#skin">Use custom skin layout</a></li>
-<li><a href="#file">Share files</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>
+<li><a href="#multi">Using multi-point touch</a></li>
+<li><a href="#file">Sharing directory</a></li>
+<li><a href="#webcam">Using a webcam</a></li>
+<li><a href="#net">Using network features</a></li>
+<li><a href="#skin">Using custom skin layout</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>
<h2 id="multi" name="multi">Using Multi-point Touch</h2>
src="../images/multitouch_invalidate.png"
style="display: block; text-align: center; margin-left: auto; margin-right: auto"/></p>
+<h2 id="file" name="file">Sharing directory</h2>
+
+<p>You are able to share a directory between Emulator and your computer. The host machine's directory is shown as <span style="font-family: Courier New,Courier,monospace">/mnt/host</span> in the Emulator.</p>
+
+<ol>
+<li>Run the Emulator Manager and click <strong>Create New</strong> or <strong>Modify</strong>.</li>
+<li>In the <strong>File Sharing</strong> section of the VM property, enable the <strong>Sharing</strong> button and select a directory to share.</li>
+<li>Start the Emulator.
+</li>
+</ol>
+
+<p>You can also add a shared directory in the Emulator Control Panel:</p>
+
+<ol>
+<li>Start the Emulator.</li>
+<li>Right-click the Emulator and select <strong>Control Panel</strong> .</li>
+<li>Move to the <strong>Host Directory Sharing</strong> tab.</li>
+<li>Mount/unmount the host machine directory.
+</li>
+</ol>
+
+ <table class="note">
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">You must have a read/write permission for the directory you want to share. You can share only one directory.</td>
+ </tr>
+ </tbody>
+</table>
+
+
<h2 id="webcam" name="webcam">Using a Webcam</h2>
<p>With the Emulator, you can host a Webcam just like a device camera.</p>
</tbody>
</table>
-<h2 id="file" name="file">File Sharing</h2>
-
-<p>You are able to share a directory between Emulator and your computer. The host machine's directory is shown as <span style="font-family: Courier New,Courier,monospace">/mnt/host</span> in the Emulator.</p>
-
-<ol>
-<li>Run the Emulator Manager and click <strong>Create New</strong> or <strong>Modify</strong>.</li>
-<li>In the <strong>File Sharing</strong> section of the VM property, enable the <strong>Sharing</strong> button and select a directory to share.</li>
-<li>Start the Emulator.
-</li>
-</ol>
-
-<p>You can also add a shared directory in the Emulator Control Panel:</p>
-
-<ol>
-<li>Start the Emulator.</li>
-<li>Right-click the Emulator and select <strong>Control Panel</strong> .</li>
-<li>Move to the <strong>Host Directory Sharing</strong> tab.</li>
-<li>Mount/unmount the host machine directory.
-</li>
-</ol>
-
- <table class="note">
- <tbody>
- <tr>
- <th class="note">Note</th>
- </tr>
- <tr>
- <td class="note">You must have a read/write permission for the directory you want to share. You can share only one directory.</td>
- </tr>
- </tbody>
-</table>
-
-
<h2 id="eventcast" name="eventcast">Using EventCast</h2>
<p>The Emulator supports event injection using ECP (Emulator Control Panel). However, injecting sensor events using ECP is less intuitive and convenient. When you are injecting events, touching the Emulator screen simultaneously is impossible. EventCast enables you to inject sensor and touch events more intuitively using a real target device.</p>