From 1907f16942da8ac10b3b597fccf90c2774816cdc Mon Sep 17 00:00:00 2001
From: Sangho Park The main features of the Emulator are: The main features of the Emulator are: You can refer to supported features in detail.
To run applications on the Emulator: 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 start-up options. 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 virtual machines. The VM list contains all VM versions. <Profile><VERSION> refers to the image version. The list under the mobile-custom or wearable-custom group depends on the profile but not the version. When you create a new VM by clicking Create New VM or Create New in the list, the VM is added under the current group. You can modify and delete the VMs you have added. In order to start Emulator quickly, Figure: Emulator Manager Figure: Emulator Manager
To start the Emulator Manager: You can use all the Emulator functions through the command line interface commands.
+Using the Emulator
-
Emulator Manager
-
+
-
+
+
-
-
-
-To start the Emulator Manager, type the following command in the Emulator installation directory at the command line (<TIZEN_SDK>/tools/emulator):
-
+
-
-
-$./bin/em-cli
bin\em-cli.exe
+
+ Note
+
+
+
+ In order to run App faster, it is recommended that CPU VT and GPU are turned on. If CPU VT is disabled, please check the Using Hardware Virtualization. If GPU is disabled, it is recommended to install latest vendor-provided graphic driver.
+
Figure: Emulator Manager command line
- - - +You can also create a new VM by Emulator Manager CLI. -
To stop the Emulator, right-click the Emulator and select Close.
+The created VM is added under the current tab. The name of tab, <Profile><VERSION>, refers to the image version. You can create a VM by using custom image in the mobile-custom or wearable-custom tabs.
+You can also export a base image of VM and manipulate VM: +
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.
@@ -111,14 +119,6 @@ To start the Emulator Manager, type the following command in the Emulator instal -On the Emulator Manager:
-You can set the following VM details:
You can share a directory between the host PC and the Emulator. If you want to use this feature, set the value to ON and define the input directory to share in the directory field. For more information, see File Sharing.
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 Using Hardware Virtualization.
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 Using Hardware Virtualization.
The Emulator supports hardware OpenGL® acceleration. If the host graphic card driver supports hardware acceleration and you select ON, 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.
@@ -227,9 +227,90 @@ To start the Emulator Manager, type the following command in the Emulator instalYou can create, modify, delete, and list your VMs through the command line interface commands. The CLI binary is located at: +
<TIZEN_SDK>/tools/emulator/bin/em-cli
<TIZEN_SDK>\tools\emulator\bin\em-cli.bat
Please refer to CLI's help messages for detailed information.
+ +Figure: Emulator Manager command line
+ + +In order to run App faster, the Tizen x86 Emulator exploits KVM (Kernel-based Virtual Machine in Linux) or HAX (Hardware Accelerated eXecution in Windows® and Mac OS® X) with HW virtualization support.
+If the CPU VT is disabled in Detail View on Emulator Manager, you should check the following prerequisites and may install KVM or HAX
+ +To use HW virtualization, you need:
+ +To use KVM, you need a processor that supports HW virtualization. Both Intel and AMD have developed those extensions for their processors (Intel VT-x/AMD-V). Check whether the CPU supports HW virtualization with the following command:
++$egrep -c '(vmx|svm)' /proc/cpuinfo+ +
If the output of the command is 0, the CPU does not support HW virtualization. Otherwise, it does.
+The HW virtualization feature can also be disabled on the BIOS setting; check the setting and enable it if you need the feature.
To use HAX, you need Intel VT-x-supported CPU, and you must enable the NX-related setting in the PC BIOS.
To use HAX, install EFI-related updates on your Intel-based Mac system. For more information, see EFI and SMC firmware updates for Intel-based Macs.
To install KVM or HAX:
+ +No installation is required for KVM.
+The HAXM driver is installed during the Tizen SDK installation. See the installation manual on the Tizen developer site.
+Note | +
---|
+ If the installation fails with a VT-related message, check the CPU feature and BIOS settings. If the installation fails with an NX-related message, enable NX (or PAE and DEP) related item in the BIOS. In addition, make sure that the operating system supports the NX feature (for more information, see MSDN). + |
+
No configuration is required for KVM or HAX.
+ + +To run the Emulator with HW virtualization support in the Emulator Manager, turn the CPU VT field to ON. The field is disabled if your system cannot support HW virtualization.
+You can also run the Emulator with HW virtualization support from the command line, by including the -enable-kvm (in Linux) or -enable-hax (in Windows® and Mac OS® X) option in the start-up command.
+The Tizen Emulator provides a variety of control keys and menus.
+ +The profile-specific skin has a real device-shaped image frame, and its hardware keys are on the main window skin. You can configure the profile-specific skin.
+ + +Figure: Profile-specific skin Emulator
+ ++ +
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 profile-specific skin, the layout of the general purpose skin is not configurable.
@@ -250,34 +331,6 @@ To start the Emulator Manager, type the following command in the Emulator instalFigure: General purpose skin Emulator
-
The profile-specific skin has a real device-shaped image frame, and its hardware keys are on the main window skin. You can configure the profile-specific skin.
- - -Figure: Profile-specific skin Emulator
- -- - - - -
Note | -
---|
In Ubuntu, you need to change a global GNOME setting to view the menu icons:
-
|
-
The following keys are available on the Emulator:
When you tap, it opens a list of options available for the current screen.
If you long press the Home key, the Task switcher application appears as in a real device. - If you double-click the Home key, the Search application appears as in a real device.
+If you long press the Home key, the Task switcher application appears as in a real device.
When you tap, it returns to the previous screen.
@@ -345,28 +397,28 @@ To start the Emulator Manager, type the following command in the Emulator instalCapture a screenshot of the Emulator.
Display the Emulator version, build time, and Git version.
Display the Emulator version, build time, and git version.
Force the Emulator to exit. Since force stopping the Emulator can cause problems, use the Close option to exit the Emulator. Use Force Close only when absolutely necessary.
The Emulator Control Panel (ECP) is a tool to control and monitor the state of the Emulator dynamically.
- -To access the ECP:
- -The main features of ECP:
-ECP CLI provides functional tools for controlling the Tizen Emulator without using the ECP UI application.
- -The CLI is located in the <TIZEN_SDK>/tools/emulator/bin directory.
- -The main features of the CLI are:
- -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 exit command.
This mode is used for one-time message handling.
In both shell and session mode, the auto completion is used with the TAB button.
Figure: Session and shell modes
-- -
Note | -
---|
The ECP CLI supports all the functionalities of the ECP UI application. | -
The following tables list the supported commands of the ECP CLI.
- -Commands | -Syntax | -Description | -
---|---|---|
help | -help [device] | -To get help, type the command as help. For more a specific device help, use the device parameter. | -
keycode | -keycode <key-code> [period|press|release] | -To enter a key code for a mobile device:
-
|
-
hmp | -hmp <hmp command> | -Access the QEMU human monitor protocol commands. For a list of provided commands, enter the ecp-cli hmp help command. | -
qmp | -qmp <qmp command> | -Access the QEMU monitoring protocol. The commands are handled in the JSON format, and do not require { "execute": "qmp_capabilities" } to be in the control mode.
- 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. |
-
hds | -hds mount <path> | -Enable the host directory sharing feature with the specified host path to /mnt/hosts in the Emulator. The specified path must be a folder, not a file. | -
hds unmount | -Unmount the mounted host directory sharing path. | -|
hds status | -Show the current host directory sharing status. | -
Device | -Command | -Mobile | -Wearable | -Syntax | -
---|---|---|---|---|
call | -dial | -Yes | -No | -call dial <number> | -
hidden-dial | -call hidden-dial <number> | -|||
connect | -call connect | -|||
disconnect | -call disconnect <call id> | -|||
status | -call status | -|||
sms | -send | -Yes | -No | -sms send <number> <text> | -
set status | -sms set <available | unavailable> | -|||
status | -sms status | -|||
mms_status | -sms mms_status | -|||
location | -set | -Yes | -Yes | -location set <longitude> <latitude> | -
status | -location status | -|||
stop | -location stop | -|||
file | -location file <file-path> | -|||
battery | -level | -Yes | -Yes | -battery level <percent> | -
charger | -battery charger <on | off> | -|||
status | -battery status | -|||
earjack | -set | -Yes | -No | -earjack set <3wire | 4wire | off> | -
status | -earjack status | -|||
usb | -set | -Yes | -Yes | -usb set <on | off> | -
status | -usb status | -|||
rssi | -set | -Yes | -No | -rssi set <0~4> | -
status | -rssi status | -|||
sdcard | -mount | -Yes | -No | -sdcard mount <sdcard_ext4_[ 4 | 8 | 16 | 32 ]G> | -
unmount | -sdcard unmount | -|||
status | -sdcard status | -|||
sensor | -accelerometer | -Yes | -Yes | -sensor accelerometer <x> <y> <z> | -
gyroscope | -sensor gyroscope <x> <y> <z> | -|||
magnetic | -sensor magnetic <x> <y> <z> | -|||
proximity | -sensor proximity <value> | -|||
light | -sensor light <value> | -|||
pressure | -sensor pressure <level> | -|||
uv | -sensor uv <level> | -|||
hrm | -sensor hrm <level> | -|||
status | -sensor status [sensor] | -|||
file | -sensor file <sensor> <path> | -
Note | +
---|
In Ubuntu, you need to change a global GNOME setting to view the menu icons:
+
|
+
You can execute the ECP by selecting Control Panel on the Context Menu after the Emulator was successfully launched. You can control and monitor the state of the Emulator dynamically.
+The main features of ECP:
+The following table lists the Device Manager features and their availability on different profiles.
@@ -783,7 +582,7 @@ To start the Emulator Manager, type the following command in the Emulator instalThe following table lists the Event Injector features and their availability on different profiles.
+The following table lists the Event Injector features and their availability on different profiles.
Commands | +Syntax | +Description | +
---|---|---|
help | +help [device] | +To get help, type the command as help. For more a specific device help, use the device parameter. | +
keycode | +keycode <key-code> [period|press|release] | +To enter a key code for a mobile device:
+
|
+
hmp | +hmp <hmp command> | +Access the QEMU human monitor protocol commands. For a list of provided commands, enter the ecp-cli hmp help command. | +
qmp | +qmp <qmp command> | +Access the QEMU monitoring protocol. The commands are handled in the JSON format, and do not require { "execute": "qmp_capabilities" } to be in the control mode.
+ 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. |
+
hds | +hds mount <path> | +Enable the host directory sharing feature with the specified host path to /mnt/hosts in the Emulator. The specified path must be a folder, not a file. | +
hds unmount | +Unmount the mounted host directory sharing path. | +|
hds status | +Show the current host directory sharing status. | +
Device | +Command | +Mobile | +Wearable | +Syntax | +
---|---|---|---|---|
call | +dial | +Yes | +No | +call dial <number> | +
hidden-dial | +call hidden-dial <number> | +|||
connect | +call connect | +|||
disconnect | +call disconnect <call id> | +|||
status | +call status | +|||
sms | +send | +Yes | +No | +sms send <number> <text> | +
set status | +sms set <available | unavailable> | +|||
status | +sms status | +|||
mms_status | +sms mms_status | +|||
location | +set | +Yes | +Yes | +location set <longitude> <latitude> | +
status | +location status | +|||
stop | +location stop | +|||
file | +location file <file-path> | +|||
battery | +level | +Yes | +Yes | +battery level <percent> | +
charger | +battery charger <on | off> | +|||
status | +battery status | +|||
earjack | +set | +Yes | +No | +earjack set <3wire | 4wire | off> | +
status | +earjack status | +|||
usb | +set | +Yes | +Yes | +usb set <on | off> | +
status | +usb status | +|||
rssi | +set | +Yes | +No | +rssi set <0~4> | +
status | +rssi status | +|||
sdcard | +mount | +Yes | +No | +sdcard mount <sdcard_ext4_[ 4 | 8 | 16 | 32 ]G> | +
unmount | +sdcard unmount | +|||
status | +sdcard status | +|||
sensor | +accelerometer | +Yes | +Yes | +sensor accelerometer <x> <y> <z> | +
gyroscope | +sensor gyroscope <x> <y> <z> | +|||
magnetic | +sensor magnetic <x> <y> <z> | +|||
proximity | +sensor proximity <value> | +|||
light | +sensor light <value> | +|||
pressure | +sensor pressure <level> | +|||
uv | +sensor uv <level> | +|||
hrm | +sensor hrm <level> | +|||
status | +sensor status [sensor] | +|||
file | +sensor file <sensor> <path> | +
The Emulator provides support to various media formats and codecs and OpenGL® ES acceleration. The Emulator, however, has some limitations and differences compared to physical target devices.
+The Emulator provides various virtual H/W, media formats, codecs and OpenGL® ES acceleration. For better performance of OpenGL® ES support, the Tizen Emulator exploits the latest feature of graphic driver so that it is recommended to install latest vendor-provided graphic driver. The Emulator, however, has some limitations and differences compared to physical target devices.
The following table lists the basic features supported in the Emulator.
The performance of the Tizen x86 Emulator on which the x86-compiled binaries are run can be enhanced by using KVM (Kernel-based Virtual Machine in Linux) or HAX (Hardware Accelerated eXecution in Windows® and Mac OS® X) with HW virtualization support.
- - -To use HW virtualization, you need:
- -To use KVM, you need a processor that supports HW virtualization. Both Intel and AMD have developed those extensions for their processors (Intel VT-x/AMD-V). Check whether the CPU supports HW virtualization with the following command:
--$egrep -c '(vmx|svm)' /proc/cpuinfo- -
If the output of the command is 0, the CPU does not support HW virtualization. Otherwise, it does.
-The HW virtualization feature can also be disabled on the BIOS setting; check the setting and enable it if you need the feature.
To use HAX, you need Intel VT-x-supported CPU, and you must enable the NX-related setting in the PC BIOS.
To use HAX, install EFI-related updates on your Intel-based Mac system. For more information, see EFI and SMC firmware updates for Intel-based Macs.
To install KVM or HAX:
- -No installation is required for KVM.
-The HAXM driver is installed during the Tizen SDK installation. See the installation manual on the Tizen developer site.
-Note | -
---|
- If the installation fails with a VT-related message, check the CPU feature and BIOS settings. If the installation fails with an NX-related message, enable NX (or PAE and DEP) related item in the BIOS. In addition, make sure that the operating system supports the NX feature (for more information, see MSDN). - |
-
No configuration is required for KVM or HAX.
- - -To run the Emulator with HW virtualization support in the Emulator Manager, set the HW Virtualization field to Supported. The field is disabled if your system cannot support HW virtualization.
-You can also run the Emulator with HW virtualization support from the command line, by including the -enable-kvm (in Linux) or -enable-hax (in Windows® and Mac OS® X) option in the start-up command.
-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.
-- 2.7.4