Downloading Source Code & Building (morty version of RDK-Emulator)

The following commands fetches the source code of emulator using repo tool

#Yocto-2.2 Build (morty builds)
 
$ mkdir emulator-morty && cd emulator-morty
 
 # Download code in yocto integration mode

$ repo init -u https://code.rdkcentral.com/r/manifests -b morty -m emulator.xml

$ repo sync
 
# To build the same for different build types, use the below command
  
# Mediaclient
MACHINE=qemux86mc-morty source meta-cmf/setup-environment
bitbake rdk-generic-mediaclient-wpe-image
  
#Hybrid
MACHINE=qemux86hyb-morty source meta-cmf/setup-environment
bitbake rdk-generic-hybrid-wpe-image
 
# Note
VMWare Player 6.X or less only supported to get wpe-webkit browser support
Host OS ubuntu 12.04 32-Bit

#Yocto-2.2 Build (RDK-DEV-1901 builds)

$ mkdir emulator-rdk-dev && cd emulator-rdk-dev

# Download code in yocto integration mode

for Non-ASP:

$ repo init -u https://code.rdkcentral.com/r/manifests -b rdk-dev-1901 -m rdkv-extsrc.xml

for ASP:

$ repo init -u https://code.rdkcentral.com/r/manifests -b rdk-dev-1901 -m rdkv-asp-extsrc.xml

$  repo sync

# To build the same for different build types, use the below command

# Mediaclient
MACHINE=qemux86mc-morty source meta-cmf/setup-environment
bitbake rdk-generic-mediaclient-wpe-image
  
#Hybrid
MACHINE=qemux86hyb-morty source meta-cmf/setup-environment
bitbake rdk-generic-hybrid-wpe-image

#To build TDK-images

# Mediaclient
MACHINE=qemux86mc-morty source meta-cmf/setup-environment
bitbake rdk-generic-mediaclient-wpe-tdk-image
  
#Hybrid
MACHINE=qemux86hyb-morty source meta-cmf/setup-environment
bitbake rdk-generic-hybrid-wpe-tdk-image

# Note
VMWare Player 6.X or less only supported to get wpe-webkit browser support
Host OS ubuntu 12.04 32-Bit

Bringing up the Emulator on VMWare Player

Install VMplayer in Host Machine

Use the below Link download to install VMware Player on host

https://my.vmware.com/web/vmware/free#desktop_end_user_computing/vmware_player/5_0|PLAYER-504|product_downloads

After downloading

sudo ./VMware-Player-<Version>.bundle (LInux OS)

Run  VMware-Player-<Version>.exe  (Windows OS)

Reason for VMplayer: in Mesa Higher versions EGL-PLATFORM fbdev is not available as it is deprecated so we tried using DRM (Direct Rendering Manager driver for graphics)

for DRM driver is available only in vmware only (vmwgfx so we have gone for VMware Player)
 

Steps to bring up RDK Emulator on VMware Player

1        Once VMware Player is installed, open the VMWare Player  using the command

2       Click File --> Create a New Virtual Machine --> Select  'i will install my operating system later' --> click Next

3       Select 'Linux' --> Version  'Other Linux 3.x kernel' --> Click Next --> Give name --> Click Next

4       Maximum Disk Size : 8 Gb --> Select 'Store Virtual Disk as a Single File' --> Click Next --> Memory for this Virtual Machine '512 Mb' --> Click 'Close'  --> Click  'Finish'

5       Click 'Edit virtual machine settings' --> select Hard Disk (IDE) --> Click 'Remove'   -->Click  'Add'  --> Select Hard Disk  --> Select  'Use existing Virtual Hard disk'

6       File browse and set the path to the *.vmdk  file --> Click Finish --> Click 'Keep Existing Format'

7       Network Adapter select Bridge Adapter  --> Click Save

8       Click Play Virtual Machine

         Cannot connect the virtual device ide1:0 because no corresponding device is available on the host.
         Do you want to try to connect this virtual device every time you power on the virtual machine? [YES] [NO]

          You select [NO]

9       This will bring the emulator up with the initial splash screen followed by RDK-Browser as startup application.

*** Note :  No support for Shared Folder.

step 1:

Step 2:

Step3:

Step 4:

Step 5:

Click 'Save'  --> Click  'Finish'

Click 'Edit virtual machine settings' --> select Hard Disk (IDE) --> Click 'Remove'   -->Click  'Add'  --> Select Hard Disk  --> Select  'Use existing Virtual Hard disk'

Step 6:

Step 7:

Step 8:

Step 9:

Step 10:

Step 11:

step 12:

Applications testing over westeros Compositor

WPELauncher  (wpewebkit default browing Application)

1) ssh login to the Emulator

   systemctl stop wpe-launcher ( this will stop the wpe-webkit browser

to launch any url through wpe launcher use this script sh startWPE.sh

ex:

sh startWPE.sh http://www.easyhtml5video.com

sh startWPE.sh http://www.google.com

Using rmfApp

for using rmfApp in morty builds need to follow the below steps

in ssh terminal of emulator type the following commands

1. systemctl stop westeros-startup ( to stop westeros-compositor)
2. rmmod vmwgfx

now you can see tty terminal console of emulator

from ssh terminal follow the normal rmfApp playback usage steps mentioned in this guide

Known Issues:

1. westeros Mouse click does not work.
2. DRM drivers does not work properly with virtualbox (virtualbox is unsupported for browser applications and graphics drivers)
3. VMware player supported Till 6.0.x version and lower versions only for RDK Emulator.

PXSCENE Support Test Procedure in Emulator

for using morty emulator WPE image we can validate pxscene examples in emulator

Pxscene works over the wayland compositor (westeros compositor)

Before launching pxscene examples need to export these parameters and run pxscene examples

$ export XDG_RUNTIME_DIR=/run/user/0/
$ export WAYLAND_DISPLAY=WPE
Example 1 :
$ ./pxscene ( will launch default browser.js)
Example 2 :
$ ./pxscene http://www.pxscene.org/examples/px-reference/gallery/fancy.js
Example 3 :
$ ./pxscene http://www.pxscene.org/examples/px-reference/gallery/gallery.js
Example 4 : 
$ ./pxscene http://www.pxscene.org/examples/px-reference/gallery/picturepile.js

Please find screen shots attached

1. Browser.js

Image Removed

2.Fancy.js

Image Removed

Gallery.js

Image Removed

Picturepile.js

Image Removed

RDKBROWSER2 Support Test Procedure in Emulator

for using morty emulator WPE image we can validate rdkbrowser2 examples in emulator

works over the wayland compositor (westeros compositor)

For testing rdkbrowser2

$ export XDG_RUNTIME_DIR=/run/user/0/
$ export WAYLAND_DISPLAY=WPE

 Example 1 :
$ ./rdkbrowser2 ( will launch http://www.example.com)
Example 2 :
$ ./rdkbrowser2 --url http://www.google.com
Example 3 :
$ ./rdkbrowser2 --url http://www.youtube.com/tv
Example 4 : 
$ ./rdkbrowser2 --url http://www.easyhtml5video.com

Note: Video performance is gittery in emulator with westerosink ( software of emulator
WEBBGL related urls not suported as graphics GPU available in the VMplayer is having limitation
with 3d graphics renderering

 

Cursor will work with rdkbrowser2

Ex: Picture-1 google.com

Ex 2: Youtube.com playback with westeros-sink

Ex 3 easyhtml5video.com