Versions Compared

Key

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

In progress

Info
iconfalse

Before You Begin

RDK License

Vendors are advised to get into an agreement with RDK Management LLC to obtain the free license to use the complete RDK Code base in their platform. More details about license are available at https://rdkcentral.com/licenses/ . Please email info@rdkcentral.com if you have additional questions about licenses or membership.

Infoiconfalse

Table of Contents
maxLevel1

This document helps vendors understand how to create a successful port of RDK on their platform with the help of the HAL API Specification for different RDK Components, as well as how the port can be successfully certified. Depending on the device profile ( IP STB or IP TV ), vendors may choose the relevant components and perform the port by implementing the HAL layer. 

Details of how to port third-party software stacks or applications to a SoC platform are out of the scope of this porting guide.


Version details

RDK Version

Vendor Porting Kit Version

Applicability

83.1.4.50IP STB, IP TV profiles

Prerequisites

The vendor is expected to have certain prerequisites before proceeding to the porting process, which include:

  • RDK

    RDK device profile:

    • Decide on the profile by referring to the available RDK profiles ( IP STB or IP TV ) and have a platform with the expected capabilities for the chosen profile. Depending on the device profile selected, the components that are required to be ported are available in the HAL table below.

    HAL API Source code access:

    • The RDK source code is distributed across multiple source code repositories which are available

    • in
    • in RDK Central GitHub.

  • Platform-specific Kernel:

    • It is highly recommended to use ACK for the target platform as RDK8 is recommended to run on top of ACK 56.15 1 64-bit version

Porting

The Hardware Porting Kit( HPK ) provide both Hardware Abstraction Layer (API) Header files, and software tests to ensure compatibility with the RDK Middleware Stack. HPK enables vendor to implement the required interfaces that will enable them to bring RDK on top of their platform. Once the HAL layer for each component is implemented, vendors can use the respective test component to certify their portThe elaborated documentation on HAL APIs, the test suites and how to build and execute them are all available at the HPK Documentation portal


For an exhaustive list of component versions, as well as test suite version for each of the HAL component, please refer below table



No changeNo changeNo changeNo change411431093109No change4.0No change210231.0No change0.00
#Component NameHAL Interface Version  HAL Testing Suite Version  
  CurrentChange Info

Previous (RDK7)

CurrentChange InfoPrevious (RDK7)
1Deep Sleep Manager
1.0.5

1.0.4...1.0.5

1.0.4

1.4.3

1.3.0...1.4.3

1.3.0

2Power Manager
1.0.41.0.3...1.0.41.0.3
1.5.41.4.0...1.5.41.4.0
3Device Settings

6.0.1

4.1.2

.

.

.6.0.1

4.1.2

6.0.13.5.0...6.0.1
No change
3.5.0
4HDMI CEC

1.

4.

0

1.3.

10...1.

4.

0

1.3.
10

1.

5RMF Audio CaptureNo change1.0.5

6.1

1.4.0
6RDK-V TVSettingsNo change
.
.
No change
.1.
7RDK-V WiFiNo change2.0.0No change
6.11.4
.0
8LibDRM
5RMF Audio Capture

1.0.

NYA9AvSyncNo change

6

1.0

NYA10V4L2No change

.5...1.0.

NYA
Modified table:

6

1
#Component NameHAL Interface Version  HAL Testing Suite Version    CurrentChange InfoPreviousCurrentChange InfoPrevious1Deep Sleep Manager1
.0.5

1.

0

5.4

No change
1.
3
4.0
2Power Manager1.0.4
...1.
0
5.
3
4
No change
1.4.0
3Device Settings

6.0.1

4.1.1...4.1.2
6RDK-V WiFiNo change


2.0.0
4.1.1

No change

3

1.
5
0.0
4
7
HDMI CEC
LibDRM1.
4
0.
0
1

1.

3

0.

9

0...1.

3

0.

10

1

1.
3.9
0.0

Not yet available



8AvSyncNo change


1.
4
0.0
media-utils

Not yet available



9V4L21.0.
6iarmmgrs
1

1.0.

1.10iarmbus

0...1.0.1

ctrlm
1.
12.0.2
0.0
rdk-gstreamer

Not yet available





Certification

While the test suite associated with the vendor porting kit helps to certify the port is working as expected, RDK certification program facilitates users to get their product certified as an RDK compliance device.

RDKM provides the RDK Certification suite to verify the compliance of the RDK Video Accelerator device. The certification program includes testing that validates the RDK  stack on the user platform with a defined test suite called as RDK Certification Test Suite.  It is mandatory to go through this program in order to brand the user’s platform as an RDK-compliant product.