Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Document Control Number

D10-20141105

Document Title

RDK Emulator Users Guide

Version

D05

Date

2015/02/23

Status

Issued (I)

Distribution

RDK licensees & ASP Preferred Members

Document Status Codes

...

7)Checking closedcaptioning in recorded content. 

After recording the video using the method provided in the above link using rmfApp try to play the recorded content.

Ex: To view the recording list

rmfApp-> l

expected output : To show the list.

total Space: 1886208000 bytes

free Space: 358744064 bytes

number of recordings= 1

-------------------------------------

recording 0 id 30 title "Recording_tile"

-------------------------------------

Now play the recorded content as shown below.

RmfApp->launch -source dvrsource -sink mediaplayersink dvr://local/30

expected output: Recording content should play along with closedcaption rendering.

Note: To play the recorded content use dvr://local/id where id is the recordingid.

8) To exit from the rmfApp first kill the running proccess and then press q to quit

Ex: rmfApp->kill 1

rmfApp->q


Yocto 2.2 (morty) support in RDK Emulator


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-ASPPreferred:
$ repo init -u https://code.rdkcentral.com/r/manifests -b rdk-dev-1901 -m rdkv-extsrc.xml

for ASPPreferred:

$ 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

vmplayer &  or open using GUI

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

Code Block
languagenone
$ 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

2.Fancy.js



Gallery.js

Picturepile.js



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

Code Block
languagenone
$ 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


...