Skip to end of metadata
Go to start of metadata

RDK-V Emulator Build Instructions

Copyright 2015 RDK Management, LLC. All rights reserved.

The contents of this document are RDK Management, LLC Proprietary and Confidential and may not be distributed or otherwise disclosed without prior written permission of RDK Management, LLC.

Document Status 

Document Control Number


Document Title

RDK Emulator Users Guide






Issued (I)


RDK licensees & ASP Members

Document Status Codes

Work in Progress (WIP)

An incomplete document designed to guide discussion and generate feedback that may include several alternative requirements for consideration.

Draft (D)

A document in specification format considered largely complete, but lacking review. Drafts are susceptible to substantial change during the review process.

Pre-Issued (Pre I)

A revision of a document circulated for review or approval prior to release, but not approved for distribution

Issued (I)

A stable document, which has undergone rigorous review and is suitable for product design and development 
It will serve as a basis for testing requirements.

Legal Notices

This document is provided under the terms and conditions of the RDK License Agreement, License Agreement for Software Integration Kit, License Agreement for Set-top Box Software Integration Kit.

RDK Management LLC is not responsible for any liability of any nature whatsoever resulting from or arising out of any use or reliance upon this specification. This document is furnished on an "AS IS" basis, and RDK Management, LLC does not provide any representation or warranty, express or implied, regarding its accuracy, completeness, or fitness for a particular purpose."

Table of Contents


RDK (Reference Design Kit) is an integrated set of software components, tools and documentation that help in the development of the software stack for set-top box based on the standard Linux operating system which is designed to meet the requirements of the latest generation media servers and clients.

The RDK emulator is an x86 based implementation of the RDK software stack. It is primarily targeted towards the RDK development community (integrators, component developers and application developers) that attempts to simplify the process of working with the RDK software stack without the need for a reference hardware platform.  The key applications in the RDK Emulator are the rmfApp, Media streamer and the RDK-Browser. As RDK emulator runs on desktop computers, applications can be tested and debugged before trying to deploy them to real devices.

Purpose of this Document

The purpose of this document is to enable RDK users and developers to be able to bring up the RDK stack and emulator on the PC platform. The document also includes step-by-step procedures to setup & build RDK Emulator


The intended audience includes the MSO teams, developers and external vendors responsible for the development of firmware and applications for RDK-based Set Top Boxes 


Scope of this document includes understanding RDK Emulator and  functionalities, supported build types and to run and test in Virtual Box environment.


RDK Emulator does not support all components of RDK 2.0 stack .Currently RDK Emulator supports mediaframework, media-streamer, RDK-Browser and RDK-Logger, XRE components.

Known Issues

  • During video playback, performance issues are there due to video scaling.
  • Also In rmfApp , while playing video through hnsource or qamsource , application may crash once EOS is reached.
  • It has been seen that open source package mirror repos may go down temporarily or may be blocked by local corporate firewalls. Please try the build again at a later time or after resolving local firewall issues. One test would be to access the failing url on the web browser and see if the site is up. This can help isolate local issues.

Abbreviations and Acronyms

The following table describes the acronyms and abbreviations used in this document




Reference Design Kit


Virtual Machine


Virtual Box


Quadrature Amplitude Modulation


Set Top Box


Cross-Platform Runtime Environment


Hard Disk Drive


End of Stream


Single Program Transport Stream


Multi-Program Transport Stream


Universal Plug and Play

Overview of RDK Emulator

  • Executes on x86-based platforms including virtualization environments such as Virtual Box and QEMU.
  • Multiple build types - media client, hybrid etc
  • Supports the RDK Browser startup application.
  • Up to date with the RDK generic trunk and any x86-specific platform code.
  • Built using Yocto and RDK build frameworks

Key Features

  • RMF Support
  • RDK Browser as a start-up application supporting playback of local TS file.
  • Video/Audio playback using fbdevsink and autoaudiosink gstreamer elements.
  • Remote control - x86-based QT application that is useful for  navigation  in RDK Browser and XRE Applications
  • Support for X2 guide.

Supported Build Types

Build Types

RDK Components Involved

Features/Applications Supported

Final Image Name

Startup Application

 RDK Mediaclient

  1. rdklogger,
  2. mediaframework
  3. rdkbrowser2
  1. rmfApp (Hnsource,Mediaplayersink)
  2. rdkbrowser2



  RDK Hybrid

  1. rdklogger,
  2. mediaframework
  3. mediastreamer
  4. Rdkbrowser2
  1. rmfApp (Hnsource,qamsource,mediaplayersink)
  2. rdkbrowser2
  3. rmfStreamer ( Http+DLNA Server Support)



Build Setup Instructions

Setting up the Host Environment

How to Build#SettinguptheHostEnvironment

Yocto 2.2 (Morty) support in RDK Emulator

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

The following commands fetch the source code of the emulator using the Android repo tool

yocto workspace setup
mkdir emulator && cd emulator
repo init -u -b rdk-next -m rdkv-nosrc.xml
repo sync -j`nproc` --no-clone-bundle --no-tags

The above step configures and sets up your directory to start an appropriate build for hybrid or media client.

For Mediaclient:

mediaclient image
MACHINE=qemux86mc-morty source meta-cmf-bsp-emulator/setup-environment
bitbake rdk-generic-mediaclient-wpe-image

For Hybrid:

hybrid image
MACHINE=qemux86hyb-morty source meta-cmf-bsp-emulator/setup-environment
bitbake rdk-generic-hybrid-wpe-image

On Successful build, the image (in .vmdk format) would be available at the following reference location based on whether your build type was Hybrid (qemux86hyb-morty) or Media Client (qemux86mc-morty):

-       build-qemux86hyb-morty/tmp/deploy/images/qemux86hyb-morty or

-       build-qemux86mc-morty/tmp/deploy/images/qemux86mc -morty

To build TDK-images

For Mediaclient:

mediaclient image
MACHINE=qemux86mc-morty source meta-cmf-bsp-emulator/setup-environment
bitbake rdk-generic-mediaclient-wpe-tdk-image

For Hybrid:

hybrid image
MACHINE=qemux86hyb-morty source meta-cmf-bsp-emulator/setup-environment
bitbake rdk-generic-hybrid-wpe-tdk-image


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

  • No labels


  1. I'm using Ubuntu 16.04 32-bit (via VirtualBox) as recommended on this page. However I'm hitting a compilation error with libgpg-error-native:

    In file included from /home/justinware/emulator/build-qemux86hybdev/tmp/work/i686-linux/libgpg-error-native/1.12-r0/libgpg-error-1.12/src/mkerrcodes.c:26:0:

    ./mkerrcodes.h:9:5: error: expected expression before ',' token

       { , "GPG_ERR_E2BIG" },

    I'm using source code from tag " rdkv-2018q1" and option 3 when using

    I can see this particular compilation issue has occurred for other developers using gcc 4 & 5, and has since been patched in the gpg source. Should I expect 16.04 to work or should I be using 14.04 or 12 instead?

  2. Hi Justin Ware

      Please  Try compiling with latest repo URL repo init -u -b rdk-dev-1901 -m rdkv-extsrc.xml

  3. Hi Gayathri,

    thanks for the suggestion. I tried the version you suggested and chose entry 30 as the applicable one for the emulator but I got the following error while bitbake was setting up the build:

    NOTE: Resolving any missing task queue dependencies
    NOTE: preferred version 3.3.% of gnutls not available (for item gnutls)
    NOTE: versions of gnutls available: 2.12.24 3.5.3
    NOTE: preferred version 3.3.% of gnutls not available (for item gnutls-dev)
    NOTE: versions of gnutls available: 2.12.24 3.5.3
    NOTE: preferred version 1.0.1 of dibbler not available (for item dibbler-client)
    NOTE: versions of dibbler available: 1.0.0RC2
    NOTE: preferred version 1.4.45 of lighttpd not available (for item lighttpd)
    NOTE: versions of lighttpd available: 1.4.39 1.4.41 1.5
    ERROR: Nothing RPROVIDES 'dracut' (but /home/justinware/emulator/meta-openembedded/meta-oe/recipes-core/plymouth/ RDEPENDS on or otherwise requires it)
    NOTE: Runtime target 'dracut' is unbuildable, removing...
    Missing or unbuildable dependency chain was: ['dracut']
    NOTE: Runtime target 'plymouth' is unbuildable, removing...
    Missing or unbuildable dependency chain was: ['plymouth', 'dracut']
    ERROR: Required build target 'rdk-generic-hybrid-image' has no buildable providers.
    Missing or unbuildable dependency chain was: ['rdk-generic-hybrid-image', 'plymouth', 'dracut']

    Summary: There was 1 WARNING message shown.
    Summary: There were 2 ERROR messages shown, returning a non-zero exit code.

    I explicitly installed 'dracut' on the (virtual) machine but bitbake still gives the same error.

    Any clues on what I'm doing wrong?


  4. Hi Justin Ware

      Have you done these steps

    Install the following packages for setting up:

    $     sudo apt-get  install   build-essential gettext bison libfile-slurp-perl gawk libncurses-dev autoconf flex doxygen libtool automake  libpcre3-dev zlib1g-dev libbz2-dev subversion minicom putty libssl-dev rpm python-pexpect python-svn python-argparse vim tofrodos meld dos2unix cmake uuid-dev ruby transfig libglib2.0-dev xutils-dev lynx-cur gperf autopoint  python-dulwich  python-dev curl vim diffstat texinfo chrpath openjdk-7-jre

    Configure bash as default command interpreter for shell scripts:

    $     sudo dpkg-reconfigure dash

    Select “No”
    To choose bash, when the prompt asks if you want to use dash as the default system shell - select “No”

    Also install the below list of packages for Yocto build:

    $     sudo apt-get install sed wget cvs subversion git-core coreutils unzip texi2html texinfo libsdl1.2-dev docbook-utils gawk python-pysqlite2 diffstat help2man make gcc build-essential g++ desktop-file-utils chrpath libgl1-mesa-dev libglu1-mesa-dev mercurial autoconf automake groff

    Try out in Fresh workspace

  5. Hi Gayathri,

    if these are the instructions from above then I have. Please note that "openjdk-7-jre" is not in the repository for Ubuntu 16.04 32-bit. I substituted "openjdk-9.jre" instead.

    "Try out in Fresh workspace" - I'm not sure what you mean. I have wiped my repo, initialised and sync'd again. I have not recreated the virtual machine from scratch. I created the virtual machine purely for the purpose of building the rdk-v emulator so it has no unnecessary packages or configuration changes. I'm running 64-bit Ubuntu 16.04 on my host which is not suitable, so I created an Ubuntu 16.04 32-bit installed in VirtualBox to do the build.

    Thanks for your assistance,


  6. Ah, it doesn't have the missing runtime dependency on 'dracut' if I go for 'qemux86hyb-morty'. Does this mean 'qemux86hyb' is no longer supported?

    Kind regards,


    1. Justin Ware   qemux86hyb-morty configuration should be used for morty and rightnow rdk is migrated to morty (Yocto-2.2) version

  7. Hi,

    I have an error with "ctrlm-xraudio-hal" 
    "/usr/bin/python3: can't find '__main__' module in ''"

    any idea?

  8. Hi Z-Lotfi Ben Taleb 

    ctrlm-xraudio-hal - is related to Control Manager feature, as the feature is not functional fully, mask the recipe to avoid build error.

  9. Hi Sri Swati Varahagiri
    Thank you for your reply. When I masked the ctrlm recipe, I got a dependency issue as following:
    "Missing or unbuildable dependency chain was: ['packagegroup-rdk-media-common', 'ctrlm-main']"

  10. Hi Z-Lotfi Ben Taleb 

    ctrlm-main is related to control manager as well and since the feature is not yet functional completely, please remove the ctrlm-main feature from packagegroups. You can also remove the xr-atomic feature from package group which is also related to control manager.

  11. I'm using Ubuntu 16.04 32-bit (Host) as recommended on this page. However I'm hitting a compilation error

    Downloading Repo source from
    Traceback (most recent call last):
      File "/home/ubuntu/emulator/.repo/repo/", line 42, in <module>
        from git_config import RepoConfig
      File "/home/ubuntu/emulator/.repo/repo/", line 774
        self._Set(f'superproject.{key}', value)
    SyntaxError: invalid syntax

     i am using this  repo

    repo init -u -b rdk-next -m rdkv-nosrc.xml

  12. Please check whether the repo is used is same as below:

    curl > ~/bin/repo
    chmod a+x ~/bin/repo

    Also whether python version is updated in the build VM

  13. I meet an issue of sysint during building rdk-generic-mediaclient-wpe-image => Unable to get checksum for sysint SRC_URI entry xi-xconf-hosts_qemux86.list: file could not be found.
    This issue is happen in -m rdkv-extsrc.xml and -m rdkv-nosrc.xml
    How to fix it?

    The file xi-xconf-hosts_qemux86.list did not exist in the downloaded repo.

    The build of sysint of build-raspberrypi-rdk-mc is correct.



    $ repo init -u -b rdk-next -m rdkv-nosrc.xml
    $ repo sync -j`nproc` --no-clone-bundle --no-tags
    $ MACHINE=qemux86mc-morty source meta-cmf-bsp-emulator/setup-environment
    $ bitbake rdk-generic-mediaclient-wpe-image

    Parsing recipes...WARNING: /media/user/SSD960GB/RDK/repo/rdk-next_rdkv-nosrc/meta-rdk-video/recipes-extended/sysint/ Unable to get checksum for sysint SRC_URI entry xi-xconf-hosts_qemux86.list: file could not be found
    NOTE: Running task 1669 of 5577 (/media/user/SSD960GB/RDK/repo/rdk-next_rdkv-nosrc/meta-rdk-video/recipes-extended/sysint/
    NOTE: recipe sysint-1.99-r0: task do_fetch: Started
    WARNING: sysint-1.99-r0 do_fetch: Failed to fetch URL file://xi-xconf-hosts_qemux86.list, attempting MIRRORS if available
    ERROR: sysint-1.99-r0 do_fetch: Fetcher failure: Unable to find file file://xi-xconf-hosts_qemux86.list anywhere. The paths that were searched were:
    ERROR: sysint-1.99-r0 do_fetch: Fetcher failure for URL: 'file://xi-xconf-hosts_qemux86.list'. Unable to fetch URL from any source.
    ERROR: sysint-1.99-r0 do_fetch: Function failed: base_do_fetch
    ERROR: Logfile of failure stored in: /media/user/SSD960GB/RDK/repo/rdk-next_rdkv-nosrc/build-qemux86mc-morty/tmp/work/i586-rdk-linux/sysint/1.99-r0/temp/log.do_fetch.23182
    NOTE: recipe sysint-1.99-r0: task do_fetch: Failed
    ERROR: Task (/media/user/SSD960GB/RDK/repo/rdk-next_rdkv-nosrc/meta-rdk-video/recipes-extended/sysint/ failed with exit code '1'
    Summary: 1 task failed:
    Summary: There were 32 WARNING messages shown.
    Summary: There were 3 ERROR messages shown, returning a non-zero exit code.

    1. Hi Ken Yang , the file 'xi-xconf-hosts_qemux86.list' is present but with a different name in the below path:


      You have to rename the file in the above path from xconf-hosts_qemux86.list to xi-xconf-hosts_qemux86.list.