RDK Resources
[*RDK Preferred*]
Code Management Facility
RDK Forums
[RDK Conferences]
RDK Support
Archives
Papers & Presentations Archive
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 Title | RDK Emulator Users Guide |
Version | |
Date | 18/11/2021 |
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 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
Known Issues
The following table describes the acronyms and abbreviations used in this document
Abbreviation/Acronym | Description |
RDK | Reference Development Kit |
VM | Virtual Machine |
VBox | Virtual Box |
RDK-B Emulator runs RDK-B stack on PC platform, validated through the virtual box based virtualization platform .
Hardware Abstraction Layer supporting Ethernet and Wi-Fi functionalities are introduced to adopt the PC platform.
Wi-Fi Hotspot support through external wireless adapter.USB to Ethernet Adapter is used for Ethernet LAN connections.
Support of advance configurations like firewall, parental control, WAN Manager and remote management etc ...
Build Types | RDK Components Involved | Features/Applications Supported | Final Image Name | Startup Application |
rdk-generic-broadband-image |
|
| rdk-generic-broadband-image-qemux86broadband.wic.vmdk | WebUI configuration |
How to Build#SettinguptheHostEnvironment
RDK-B Emulator Dunfell Build Instructions
Host Requirements
Requirement | Remarks |
---|---|
Linux | 32/64 bit Ubuntu 16.04 operating system |
Free HDD Space | Minimum 100GB Free Memory |
Oracle Virtual Box | 4.3.18 or higher |
Install Virtual Box and follow the following steps to bring up RDK Emulator on Virtual Box:
In the following steps, it is recommended to review the description and screenshot completely before proceeding with steps.
Open Virtualbox
Select New [A popup will come up]
Select Type as ‘Linux’
Select Version as ‘Other Linux (32 Bit)’
Click on “Next”
Once you have the IP address you may SSH into your VM from your linux shell console. Use root as the ssh user.
$ ssh root@<erouter0 ip> |
---|
root@qemux86broadband:/# ifconfig br106 Link encap:Ethernet HWaddr E6:B3:27:79:E4:79 inet addr:192.168.106.1 Bcast:192.168.106.255 Mask:255.255.255.0 inet6 addr: fe80::e4b3:27ff:fe79:e479/64 Scope:Link UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:0 errors:0 dropped:0 overruns:0 frame:0 TX packets:14 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:0 (0.0 B) TX bytes:1124 (1.0 KiB) br403 Link encap:Ethernet HWaddr 3E:7D:94:CE:18:42 inet addr:192.168.245.1 Bcast:192.168.245.255 Mask:255.255.255.0 inet6 addr: fe80::3c7d:94ff:fece:1842/64 Scope:Link UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:0 errors:0 dropped:0 overruns:0 frame:0 TX packets:14 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:0 (0.0 B) TX bytes:1124 (1.0 KiB) brebhaul Link encap:Ethernet HWaddr DA:B4:09:16:BD:69 inet addr:169.254.85.1 Bcast:169.254.85.255 Mask:255.255.255.0 inet6 addr: fe80::d8b4:9ff:fe16:bd69/64 Scope:Link UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:0 errors:0 dropped:0 overruns:0 frame:0 TX packets:14 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:0 (0.0 B) TX bytes:1124 (1.0 KiB) brlan0 Link encap:Ethernet HWaddr 42:39:B8:18:9B:F3 inet addr:10.0.0.1 Bcast:10.0.0.255 Mask:255.255.255.0 inet6 addr: fe80::4039:b8ff:fe18:9bf3/64 Scope:Link UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:0 errors:0 dropped:0 overruns:0 frame:0 TX packets:12 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:0 (0.0 B) TX bytes:1320 (1.2 KiB) erouter0 Link encap:Ethernet HWaddr 08:00:27:B4:EB:E3 inet addr:192.168.1.49 Bcast:192.168.1.255 Mask:255.255.255.0 inet6 addr: fe80::a00:27ff:feb4:ebe3/64 Scope:Link UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:223 errors:0 dropped:0 overruns:0 frame:0 TX packets:52 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:17548 (17.1 KiB) TX bytes:9684 (9.4 KiB) gre0 Link encap:UNSPEC HWaddr 00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00 UP RUNNING NOARP MTU:1476 Metric:1 RX packets:0 errors:0 dropped:0 overruns:0 frame:0 TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:0 (0.0 B) TX bytes:0 (0.0 B) lo Link encap:Local Loopback inet addr:127.0.0.1 Mask:255.0.0.0 inet6 addr: ::1/128 Scope:Host UP LOOPBACK RUNNING MTU:65536 Metric:1 RX packets:14866 errors:0 dropped:0 overruns:0 frame:0 TX packets:14866 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:763416 (745.5 KiB) TX bytes:763416 (745.5 KiB) sit0 Link encap:IPv6-in-IPv4 inet6 addr: ::127.0.0.1/96 Scope:Unknown UP RUNNING NOARP MTU:1480 Metric:1 RX packets:0 errors:0 dropped:0 overruns:0 frame:0 TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)
16 Comments
moon
Could you share the RDK-B Emulator flash image, I want to study and test it, thanks
Priyankaa K V B
Hi moon ,
Link for Emulator build : RDK-B Emulator Dunfell Build Instructions
We recommend to create a build rather than sharing the image . The ready to use image is available only for Rpi at https://rdkcentral.com/download-instructions/?caller=broadband
Emulator releases are now not actively made, so dunfell build for emulator should work.
Please try and let us know if you are facing any issues.
Regards,
Priyankaa KVB
Z-Jack The Ripper
Why i always get login error "Incorrect password for admin!"
I used admin/password
sipra samantray
Hi Z-Jack The Ripper ,
Could you Reset the admin password first then try again with admin/password ( dmcli eRT setv Device.UserInterface.PasswordReset bool true ).
Z-Jack The Ripper
Thank you, now it's working
Z-Arthur Huang
I follow instructions to build the image and set up VM, but I always get login error "Incorrect password for admin!" even if reset the admin password
Deepika Ganapathi Bhat
Hi Z-Arthur Huang
Once you launch the VM using Emulator vmdk image, provide “root” to login.
For WebUi login, "password" is the default password , it should work after Reset also.( dmcli eRT setv Device.UserInterface.PasswordReset bool true)
if still the issue present , please reset to default factory settings or reboot the vm once and try.
Z-Arthur Huang
Hi Deepika Ganapathi Bhat
It still show "Incorrect password for admin!" for web login after reset( dmcli eRT setv Device.UserInterface.PasswordReset bool true) and reboot.
Deepika Ganapathi Bhat
Hi Z-Arthur Huang
the login issue seen in dunfell build and the issue still needs to be fixed. At present ,the stable release for emulator is available in release branch . Could you please try with with release branch, Morty version for emulator.
Z-Arthur Huang
Hi Deepika Ganapathi Bhat
I try to build morty branch, but get some errors after "
repo
sync
-j4 --no-clone-bundle
"fatal: Couldn't find remote ref refs/heads/master
rdkb/components/opensource/ccsp/webui-bwg:
fatal: Couldn't find remote ref refs/heads/master
rdkb/components/opensource/ccsp/webui-bwg: sleeping 4.0 seconds before retrying
fatal: Couldn't find remote ref refs/heads/master
rdkb/components/opensource/ccsp/webui-bwg:
fatal: Couldn't find remote ref refs/heads/master
error: Cannot fetch rdkb/components/opensource/ccsp/webui-bwg from https://code.rdkcentral.com/r/a/rdkb/components/opensource/ccsp/webui-bwg
fatal: Couldn't find remote ref refs/heads/master
rdkb/devices/emulator/hal:
fatal: Couldn't find remote ref refs/heads/master
rdkb/devices/emulator/hal: sleeping 4.0 seconds before retrying
fatal: Couldn't find remote ref refs/heads/master
rdkb/devices/emulator/hal:
fatal: Couldn't find remote ref refs/heads/master
error: Cannot fetch rdkb/devices/emulator/hal from https://code.rdkcentral.com/r/a/rdkb/devices/emulator/hal
fatal: Couldn't find remote ref refs/heads/master
rdkb/tools/tdkb:
fatal: Couldn't find remote ref refs/heads/master
rdkb/tools/tdkb: sleeping 4.0 seconds before retrying
fatal: Couldn't find remote ref refs/heads/master
rdkb/tools/tdkb:
fatal: Couldn't find remote ref refs/heads/master
error: Cannot fetch rdkb/tools/tdkb from https://code.rdkcentral.com/r/a/rdkb/tools/tdkb
fatal: Couldn't find remote ref refs/heads/master
rdkb/devices/raspberrypi/tdkb:
fatal: Couldn't find remote ref refs/heads/master
rdkb/devices/raspberrypi/tdkb: sleeping 4.0 seconds before retrying
fatal: Couldn't find remote ref refs/heads/master
rdkb/devices/raspberrypi/tdkb:
fatal: Couldn't find remote ref refs/heads/master
error: Cannot fetch rdkb/devices/raspberrypi/tdkb from https://code.rdkcentral.com/r/a/rdkb/devices/raspberrypi/tdkb
Fetching: 100% (4/4), done in 28.579s
Garbage collecting: 100% (4/4), done in 0.007s
error: Cannot checkout rdkb/components/opensource/ccsp/webui-bwg: ManifestInvalidRevisionError: revision master in rdkb/components/opensource/ccsp/webui-bwg not found
error: in `sync -j4 --no-clone-bundle`: revision master in rdkb/components/opensource/ccsp/webui-bwg not found
-------------------------------------------------------------------------------------------------------------------------------------
Here is my environment
OS: Ubuntu 18.04
repo command: repo init -u https://code.rdkcentral.com/r/manifests -m rdkc-extsrc.xml -b morty
Deepika Ganapathi Bhat
Hi Z-Arthur Huang
Please refer https://wiki.rdkcentral.com/display/RDK/RDK-B+Emulator+Build+Instructions for build instructions and host setup.
The last stable release for emulator is https://wiki.rdkcentral.com/display/CMF/RDK-B_2021q1
Z-Arthur Huang
Hi Deepika Ganapathi Bhat
I am getting fetch error, "code.rdkcentral.com/r/rdk/devices/intel-x86-pc/emulator/iarmmgrs" seems to be not found.
ERROR: ExpansionError during parsing /home/arthur/test/meta-rdk-bsp-emulator/recipes-extended/iarmmgrs/iarmmgrs-hal-emulator_git.bb | ETA: --:--:--
Traceback (most recent call last):
File "/home/arthur/test/openembedded-core/bitbake/lib/bb/data_smart.py", line 386, in DataSmart.expandWithRefs(s='${RDK_RELEASE}+git${SRCPV}', varname='PV'):
try:
> s = __expand_var_regexp__.sub(varparse.var_sub, s)
try:
File "/home/arthur/test/openembedded-core/bitbake/lib/bb/data_smart.py", line 111, in VariableParse.var_sub(match=<_sre.SRE_Match object; span=(18, 26), match='${SRCPV}'>):
else:
> var = self.d.getVarFlag(key, "_content", True)
self.references.add(key)
File "/home/arthur/test/openembedded-core/bitbake/lib/bb/data_smart.py", line 737, in DataSmart.getVarFlag(var='SRCPV', flag='_content', expand=True, noweakdefault=False, parsing=False):
cachename = var + "[" + flag + "]"
> value = self.expand(value, cachename)
File "/home/arthur/test/openembedded-core/bitbake/lib/bb/data_smart.py", line 410, in DataSmart.expand(s='${@bb.fetch2.get_srcrev(d)}', varname='SRCPV'):
def expand(self, s, varname = None):
> return self.expandWithRefs(s, varname).value
File "/home/arthur/test/openembedded-core/bitbake/lib/bb/data_smart.py", line 400, in DataSmart.expandWithRefs(s='${@bb.fetch2.get_srcrev(d)}', varname='SRCPV'):
except Exception as exc:
> raise ExpansionError(varname, s, exc) from exc
bb.data_smart.ExpansionError: Failure expanding variable SRCPV, expression was ${@bb.fetch2.get_srcrev(d)} which triggered exception FetchError: Fetcher failure: Unable to resolve 'rdkb-2021q1' in upstream git repository in git ls-remote output for code.rdkcentral.com/r/rdk/devices/intel-x86-pc/emulator/iarmmgrs
Deepika Ganapathi Bhat
Hi Z-Arthur Huang
We verified with platform team .
At present ,The Emulator Build is successful only for dunfel release, the webui login and some known issues are present and still need to be fixed .
rdkzhang
Hi Deepika Ganapathi Bhat
I always get login error "Incorrect password for admin!". Where the password exists?
Reset displays the following error. What should I do?
root@qemux86broadband:/# dmcli eRT setv Device.UserInterface.PasswordReset bool true
CR component name is: eRT.com.cisco.spvtg.ccsp.CR
subsystem_prefix eRT.
Can't find destination component.
root@qemux86broadband:/#
jianchun zhu
It seems the login issue seen in dunfell build still exists.
I still got the incorrect password after reset.
Would you please share the method to solve it?
When this problem can be solved?
Deepika Ganapathi Bhat
Hi jianchun zhu
It is a known issue which is being fixed .quick fix for this issue is not available at this time.
however for dunfell release, command line interface we can proceed.
For webUI,
The last stable release for emulator is https://wiki.rdkcentral.com/display/CMF/RDK-B_2021q1
NOTE: With 2021q1 , if you are facing below error , please port https://code.rdkcentral.com/r/c/components/asp/rdk-oe/meta-rdk-bsp-emulator/+/55550/1/recipes-connectivity/obexpushd/obexpushd_0.11.3.bb and check the build
ERROR: obexpushd-0.11.3-r0 do_fetch: Fetcher failure for URL: 'https://gitlab.com/obexpushd/mainline/repository/0.11.3/archive.tar.gz'. Unable to fetch URL from any source.ERROR: obexpushd-0.11.3-r0 do_fetch: Function failed: base_do_fetch