The aim of this page is to provide the details and guide Operators on how to adopt RDK and what MSO has to do to get an RDK based Platform up and running.
Background Color |
---|
|
Before You Begin |
RDK License
SoC vendors at email if This section will detail the recommended
This page provides the details and guidance to the Operators on how to adopt RDK. The step by step procedure
of adopting RDK by a MSO.for an operator to get an RDK based Platform up and running is also described in detail.
Excerpt Include |
---|
| DOC:RDK-V Hardware Porting Guide-Old page |
---|
| DOC:RDK-V Hardware Porting Guide-Old page |
---|
nopanel | true |
---|
|
Background Color |
---|
|
Product Specifications |
The first step to get a fully functional product is
the to define the product features and see if they meet the standard requirements.
A list of expected features from an IP based Set-top box are listed at Product Specifications. MSO can cross check the expected features/specifications with the capabilities of the OEM device being used and can finalize the features supported by the product.See here to know what are all the features available in RDK-V and can implement based on your requirement. Operator can use this as a guide while engineering the RDK Operator platform.
Background Color |
---|
|
Device Firmware |
Info |
---|
For details of product specifications, please refer: Product Specifications
|
Operators can make use of the details available at MSO Platform Firmware below to start developing a Yocto build to do the final additions of MSO Operator specific changes to the device. This will help MSO Operator to add their own final product features as well as MSO Operator specific patches/changes.
Info |
---|
For details, please refer: Link to New Window |
---|
page | https://wiki.rdkcentral.com/display/RDK/MSO+Platform+Firmware |
---|
link-text | MSO Platform firmware |
---|
|
|
Yocto Manifests
Yocto based RDK builds are flexible enough to easily accommodate SoC / OEM / Operator / third party changes. The starting point for the Yocto builds are a manifest file. The manifest file is an xml file that contains details of the different open embedded Yocto build layers, meta layers , rdk as well as open source components that needs to be fetched during initial stages ( than during bitbake time ) as well as the URL locations from where the data can be pulled. A set of sample manifests that can be used as a template for developing Operator specific manifests are given below
Expand |
---|
title | Click here for more details on Yocto Manifests |
---|
|
# | File | Remarks |
---|
1 | Device Specific Manifest | This is the starting point of the build and is specific to a device/board . If the SoC/OEM has only one target device /board, still it is recommended to maintain a different manifest for SoC/OEM for keeping it future-proof. Usually it contains references to other manifest files which will be having specific set of repos | 2 | SoC Manifest | This manifest contains meta layer details of SoC and , optionally, some SoC specific repos | 3 | OEM Manifest | This manifest contains meta layer details of OEM and , optionally, some OEM specific repos | 4 | Operator Manifest | This manifest contains meta layer details for operators and , optionally, some operator specific layers. | 5 | OE layers Manifest | This manifest has details of the basic Yocto Open Embedded layers | 6 | RDK-V Manifest | This manifest can contain meta layers specific to RDK & RDK-V and , for EXTERNALSRC cases, the RDK & RDK-V component repo details too. It might be supplemented with a conf file too | 7 | Third party Apps manifest | This manifest can contain meta layers related to premium streaming applications which are chosen by Operator |
The default manifest repo in RDKM Git is at https://code.rdkcentral.com/r/#/c/manifests/ . Operator need to have their own manifest file in this location which will be mentioned in the 'Device specific manifest' - which is the starting point of builds for a particular target device
|
To match the layered structure of Yocto builds, a Operator specific layer is used to include Operator changes and additions. Use the yocto-layer create sub-command to create a new general layer.
Code Block |
---|
|
$ yocto-layer create mylayer |
There shall be separate device (machine) configuration file (.conf) for each device for the particular chip family for which the layer is intended for. The general naming terminology for Operator layer is meta-rdk-<soc name>
The device (machine) configuration file shall include corresponding include (.inc) file to get machine configuration details.
Adding the Machine Configuration File for the new Operator
Each meta-* layer should have a conf folder containing the machine configuration we can select during 'source setup-environment' . Optionally it can also have a class/classes folder for keeping information that is useful to share between metadata files.
To add a machine configuration, you need to add a .conf file with details of the device being added to the conf/machine/ file. In the machine conf file the basic machine configuration should be defined.
Once the conf files are in place, the layer details need to be added to the corresponding package group file. Based on platform, the package group file will be grouped into multiple files with one bitbake fiile and multiple append files. Operator can add the Operator layer details to required package group append files applicable to the target device build to get the features into the final build
Background Color |
---|
|
Operator Specific Apps |
Operators will be having a range of Operator
MSO Specific Apps
MSOs will be having a range of MSO specific applications from simple generic device information apps to MSO Operator specific content applications. RDK's Yocto based layered structure allows MSOs Operators to easily integrate, upgrade and maintain their apps in their RDK based IP Set-top devices. For more details on App support in RDK, please refer Applications(only for RDK licensee) as well as MSO Operator Platform Firmwarefor the engineering details.
Info |
---|
For details of MSO Specific Apps, please refer: Link to New Window |
---|
page | https://wiki.rdkcentral.com/display/RDK/RDK+Video+Accelerator+-+Applications |
---|
link-text | MSO Specific Apps |
---|
|
|
MSO Specific
Background Color |
---|
|
Operator Specific UI |
RDK supports usage of multiple User Interface in the RDK IP Set-top devices. MSOs Operators can choose from among the already available UIs that are available with RDK as well as develop and use their own UI. For more information on UI support in RDK, please refer User Interface
Follow the below steps to get Lightning UI running in devices:
Expand |
---|
title | Steps to deploy lightning UI |
---|
|
Clone and Build InstructionsThis section details about how to customize the current UI source code and develop further. Follow the commands to run the application on you laptop. |
- The RDK Accelerator Home UI version 3 is the latest version (3.7) of the RDK reference UI which provides a full featured UI with a modern minimalistic design using a dark theme.
- New Feature: UIv3.7 Added multi-profile support.
- This single UI currently supports IP-STB, Hybrid-STB and TV profile RDK stacks. UI uses DTV Plugin and HDMIInput plugins to distinguish the platform profile; UI will consider the platform as TV if stack has HDMIInput plugin support, Hybrid STB if DTV plugin is present else the default IP-STB.
- The UI uses Lightning SDK Plugins such as Language, Router, Storage and supports Premium apps such as Amazon, YouTube, Xumo along with a selection of Lightning apps from the Metrological App Store. It also includes a wide section of settings which allow a user to take full advantage of the device features such as Audio, Video, Network, Language and more.
- To use and to know more about RDK Accelerator Home UI please refer Accelerator Home UI - v3 .
- Based on resident app reference implementation Operator need to bring up the UI.
What operators need to do if they plan to use Accelerator UI as such ( or with minimal changes )?
- ( Optional ): Create an offline and online version of the UI.
- Offline can have minimal things ( like pair the remote, settings to connect to WiFi etc ) which is available even if device is not connected to Internet.
- Online will be the full fledged UI and will be fetched from a server with latest version
- Host their UI in their own production server and make RDK use it. For this , operator need to change the URL in this line https://code.rdkcentral.com/r/plugins/gitiles/rdk/components/generic/appmanager/+/refs/heads/rdk-next/residentapp/residentApp.sh#165
What operators need to do if they plan to use a different UI?
- Operator can develop their own UI either using Html or Lightning. Below section stall describe how a Lightning UI can be deployed.
- ResidentApp service serves the offline pages from DOCROOT of webserver(lighttpd) running on device. Operator need to install the UI assets in the DOCROOT and that will be launched by the https://code.rdkcentral.com/r/plugins/gitiles/rdk/components/generic/appmanager/+/refs/heads/rdk-next/residentapp/residentApp.sh#166 when the device starts up.
- To make the device start always with offline UI pages; remove or comment out https://code.rdkcentral.com/r/plugins/gitiles/rdk/components/generic/appmanager/+/refs/heads/rdk-next/residentapp/residentApp.sh#230.
Background Color |
---|
|
Info |
---|
For details of UI support in RDK IP Set-top devices, please refer : Link to New Window |
---|
page | https://wiki.rdkcentral.com/display/RDK/RDK+Video+Accelerator+-+User+Interface |
---|
link-text | User Interface | App Support |
Along with the MSO Operator specific apps, MSO Operator can support a lot of generic apps in RDK IP Set-top devices by taking advantage of RDK Support for Native as well as Web Apps in IP based Set-top platforms. MSO Operator can easily port native apps in their platforms (for some third party apps, MSO Operator need to obtain certification from those third party) or can host their own app store and then use Web Apps to show content. For more information on App support in RDK, please refer Applications (only for RDK licensee).
Background Color |
---|
|
Factory Test App |
The Factory Test App is a special standalone application used for production line testing at the TV assembly factory of the OEM manufacturer. It is embedded directly in the firmware image that gets flashed onto the boards on the TV production line.
<ToDo>
Background Color |
---|
|
Provisioning Support |
Operator
Info |
---|
For details of App support in RDK IP based Set-top devices, please refer: Link to New Window |
---|
page | https://wiki.rdkcentral.com/display/RDK/RDK+Video+Accelerator+-+Applications |
---|
link-text | Applications in RDK |
---|
|
|
Provisioning Support
MSO needs to add provisioning support in device so that Device provisioning can be done once deployed at customer premise. The steps for this varies based on platform as well as MSO Operator type.
Provisioning support refers to the scenario such as when you launch Sample app on your mobile it takes to login page and so you have to login there, account there i.e. actually the app has to authenticate your login.
Background Color |
---|
|
Disaster Recovery |
Disaster recovery is an inevitable part of the CPE life cycle. MSOOperator, based on their disaster recovery strategy, could add support for this in the device. While there are some generic guidelines followed across industry, there is no single step that works for all. MSOs Operators could easily add their business logic to RDK as part of MSO Operator firmware engineering as described in MSO Operator Platform Firmware.
As an operator they have to handle crashes/disaster happens and support any factory reset like OTA upgrade.
Background Color |
---|
|
Test & Certification of devices |
Once the device engineering is completed from MSO Operator side, the device can be test and verified easily by the Certification support provided by RDKM. Details of coverage as well as major cases are explained here .
Info |
---|
For details on test & certification of devices, please refer: Link to New Window |
---|
page | https://wiki.rdkcentral.com/display/TDK/RDK+Video+Accelerator+Certification |
---|
link-text | Test & Certification of devices |
---|
|
|
(only for RDK licensee) .
Certification suite is available at RDK IP Set-top Product Certification (only for RDK licensee) and for TDK test app please refer TDK-V Documentation.
In short, to get an RDK based device to field, Operators need to get
To start with RDK, MSO needs
- RDK license
- Operator has to get a RDK license and then any premium apps porting operators should have a project agreed with the corresponding premium app like for youtube it is google to access premium app/any app's plugin or code implementation for app.
- There In case Operator is planning to include third party apps ( like Netflix , Amazon Prime etc. to name a few ) there should be a Commercial License Agreement between operators and premium apps.
- Project agreement with OEM's
- UI integration with RDKServices and UI Specific customizations
- Operator specific task on RDK are customization of UI to adopt RDKServices so as part of customization of UI they can refer the resident app implementation. As part of customisation of UI,OTA upgrade is one of the first main point .As an operator they need to get the OTA backend server . Xconf is the RDK recommended OTA method.It is not mandatory this can be optional(Like the firmware update plugin is available there readily they can directly use that infrastructure otherwise they need to configure their headend with the xconf server.)
- Operator specific requirements has to be implemented by operator eg.frontpanel related or any customisation of UI and any such requirements.
Things available in RDK
What Operators get from RDK:
- Pre-certified stack for third party apps is available in RDK as a Common Port Architecture. For details see Common Port for Native Apps.
- RDKServices are available to customize RDKService plugin plugout components for all the stacks mainly Bluetooth, Wifi and front panel, power manager, device settings etc, pre-set apps and basic architecture of OTA are available.
Things MSO need to do
What Operators need to
get is do:
- As a an Operator, the certification for the operators device has to be done by them(eg: for premium apps).
- Customization of boot loader for operator specific , operator specific UI, Operator specific any customization on the stack such as Power manager(Power specifications to Set-top box to consume only specified power)
- Some Customization of remote and operator specific operations such as other configurations settings and their persistent areas(like premium app logo size on operator device).
- UI integration with RDKServices and UI Specific customizations
- Operator specific task on RDK are customization of UI to adopt RDKServices so as part of customization of UI they can refer the resident app implementation. As part of customisation of UI,OTA upgrade is one of the first main point .As an operator they need to get the OTA backend server . Xconf is the RDK recommended OTA method.It is not mandatory this can be optional(Like the firmware update plugin is available there readily they can directly use that infrastructure otherwise they need to configure their headend with the xconf server.)
- Operator specific requirements has to be implemented by operator ( eg.frontpanel related or any customisation of UI and any such requirements )