Deprecation Warning QEMUx86 Emulator for Linux is no longer actively maintained, so it is strongly recommended that you use VirtualBox Emulator instead.
webOS Open Source Edition (OSE) provides an emulator that enables you to test the webOS application and platform on a virtual environment. With the emulator, you can test major features of webOS on your PC without the need of a physical device such as Raspberry Pi.
The emulator is based on the open source QEMU project.
Currently, the emulator only supports the x86 (x86_64) machine architecture and Linux Ubuntu operating system as a host.
Key characteristics of the emulator are as follows:
QEMUx86 virtual machine based emulator
Provides graphics performance with host PC’s GPU H/W acceleration
Emulates major features of webOS OSE platform on PC without Raspberry Pi 3 target device
Provides emulator run script with JSON configuration file for easy use
Supports webOS OSE CLI tool for application and platform development
The emulator is optimized for the following host environment.
16.04 (32-bit and 64-bit)
14.04 (32-bit and 64-bit)
18.04 (64-bit) (not fully tested)
Processor: Intel® Pentium® 4 2.0 GHz or faster
Memory: 3 GB or more RAM
Display: 1920 x 1080 or higher screen resolution
Graphics card: 256 MB or more video memory with OpenGL 3.0 support
qemu 2.7.0 or higher version
virglrenderer 0.6.0 or higher version (0.6.0 tag version is recommended)
libsdl2-2.0-0 or higher version
OpenGL 3.0 or higher version
Downloading the Emulator
The emulator is provided as a pre-built package in GitHub. Clone or download the pre-built emulator package from the GitHub repository.
Note Depending on the version of your Ubuntu or required libraries, you may have trouble running the pre-built emulator package. In that case, you need to build a custom package as described in Building a Custom Emulator Package.
Caution The emulator does not support running on Xming. If you use Xming, you will encounter an X server error. Therefore, we strongly recommend that you run the emulator directly on a Linux PC.
Running the Emulator
Create a JSON configuration file.
By default, the emulator package includes a template for configuration file, webos-config-sample.json. You can create your own configuration file webos-config.json from the template by modifying the option values according to your environment.
Create a configuration file from the template, and edit the file.
$ cd <emulator directory path>
$ mv webos-config-sample.json webos-config.json
$ vi webos-config.json
Change the option values to the ones suitable for your environment. Especially, vmdk_file_path must be set to the file path of the built .vmdk image. For example, if build-webos is under your home directory, the path must be set to ~/build-webos/BUILD/deploy/images/qemux86/webos-image-qemux86.vmdk.
For detailed description of all the options in the JSON file, refer to the README file inside the package.
Run the emulator.
Use the run script (emulator) to launch the emulator.
$ ./emulator webos-config.json
Note In case of Ubuntu 18.04, you need to launch the script with sudo command, because of KVM permission.
Connecting to the Emulator
On the host machine, you can connect to the emulator using one of the two options:
Connect from the Shell
To connect to the emulator on a Linux shell, use the command below. The port number must match the value set in the portforwarding.SSH option (default: 6622) of JSON configuration file.
To connect to the emulator using Web Inspector, connect to localhost:<PortNumber> on a web browser (for example, Chrome). The port number must match the value set in the portforwarding.inspector option (default: 9998) of JSON configuration file.
Building a Custom Emulator Package
To build a custom emulator package, you need to build virglrenderer and QEMU, and copy the results to the pre-built emulator package.
virglrenderer is a library that allows graphics rendering by using the host GPU.
Before you begin, upgrade all the installed packages to the latest version and install the dependency packages.
If you encounter the error message “qemu_gl_create_compile_shader: compile vertex error: GLSL ES 3.00 is not supported. …” when you run the emulator, that means the OpenGL/Mesa of your host PC doesn’t support OpenGL 3.0.