Copyright 2016 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.

Host Setup

Refer to the below link for Host Machine Setup

How to Build#SettinguptheHostEnvironment

Yocto Build Setup

All RPi based RDK images with the latest features are from the rdk-next branch

Initializing the Build Environment

To build RDK images from rdk-next branch, follow the below build procedure

mkdir workspace
cd workspace

# initialize the repo
# for Non-ASP
repo init -u https://code.rdkcentral.com/r/manifests -b rdk-next -m rdkv-nosrc.xml

repo sync -j `nproc` --no-clone-bundle --no-tags

mkdir workspace
cd workspace

# initialize the repo
# for ASP (applicable for TDK)
repo init -u https://code.rdkcentral.com/r/manifests -b rdk-next -m rdkv-extsrc.xml

repo sync -j `nproc` --no-clone-bundle --no-tags

# reboot info displaying fix for REFPLTV-655
(cd meta-cmf-raspberrypi; git fetch "https://code.rdkcentral.com/r/components/generic/rdk-oe/meta-cmf-raspberrypi" refs/changes/35/49835/1 && git cherry-pick FETCH_HEAD)

Image build

Link to check possible RDK images on RPi - https://code.rdkcentral.com/r/plugins/gitiles/components/generic/rdk-oe/meta-cmf-raspberrypi/+/refs/heads/rdk-next/recipes-core/images/

Generic Image

To build the image with the default compositor.

Choose hybrid machine configuration to build the image with default compositor

MACHINE=raspberrypi-rdk-hybrid source meta-cmf-raspberrypi/setup-environment

bitbake rdk-generic-hybrid-wpe-image

Choose the hybrid westeros machine configuration to build the image with westeros compositor

Image with Westeros compositor

MACHINE=raspberrypi-rdk-hybrid-westeros source meta-cmf-raspberrypi/setup-environment

bitbake rdk-generic-hybrid-westeros-wpe-image

Note: Westeros is now the default compositor, so both images behave in the same way

TDK Image

MACHINE=raspberrypi-rdk-hybrid source meta-cmf-raspberrypi/setup-environment

bitbake rdk-generic-hybrid-wpe-tdk-image

Note: The Kernel image and root filesystem will be created under build-raspberrypi-rdk-hybrid/tmp/deploy/images/raspberrypi-rdk-hybrid folder

Development Branch

To build the image from the development branch, the respective sprint month's development branch to be chosen and follow the below build procedure

For example to take development branch of September 2020, the rdk-dev-2009 branch to be used

mkdir workspace
cd workspace

# initialize the manifest with repo tool
repo init -u https://code.rdkcentral.com/r/manifests -b rdk-dev-2009 -m rdkv-nosrc.xml

repo sync -j `nproc` --no-clone-bundle --no-tags

Note: Follow the above section for images build on the development branch

Flashing Procedure

The image file will be generated under build-<MACHINE>/tmp/deploy/images/<MACHINE> directory

# Insert the micro SD card and mention the card's device file name
# input file (if) is the image file to flash and the output file (of) is the card's device file name
sudo dd if=rdk-generic-hybrid-wpe-image-raspberrypi-rdk-hybrid.rpi-sdimg of=/dev/<sd file> bs=4M