Tables of Contents

Yocto Build

Host Machine Setup

Hardware requirements:

• Ubuntu 18.04 desktop machine
• RAM - 8 GB or more
• Memory - a minimum of 100 GB free space

Refer to the link for host machine setup: Host Setup

Yocto workspace setup

Initialization:
$ repo init -u https://code.rdkcentral.com/r/manifests -m rdkc-nosrc.xml -b dunfell
                                ( or )
$ repo init -u https://code.rdkcentral.com/r/manifests -m rdkvrdkc-nosrcextsrc.xml -b dunfell

Download/Sync:
$ repo sync -j `nproc` --no-clone-bundle --no-tagstag

$ cd meta-rdk-camera
$ git fetch "https://code.rdkcentral.com/r/components/generic/rdk-oe/meta-rdk-camera" refs/changes/10/49510/2 && git cherry-pick FETCH_HEAD

$ cd meta-cmf-raspberrypi
git fetch "https://code.rdkcentral.com/r/components/generic/rdk-oe/meta-cmf-raspberrypi" refs/changes/51/51451/1 && git cherry-pick FETCH_HEAD

$ cd meta-rdk-video
$ git fetch "https://code.rdkcentral.com/r/components/generic/rdk-oe/meta-rdk-video" refs/changes/34/51434/1 && git cherry-pick FETCH_HEAD

$ cd meta-rdk
# fix to use eSDK from all supported images
(cd meta-rdk; git fetch "https://code.rdkcentral.com/r/components/generic/rdk-oe/meta-rdk" refs/changes/37/51037/1 && git cherry-pick FETCH_HEAD
git fetch "https://code.rdkcentral.com/r/components/generic/rdk-oe/meta-rdk" refs/changes/35/51435/1 && git cherry-pick FETCH_HEAD)

$ cd meta-cmf-raspberrypi
git fetch "https://code.rdkcentral.com/r/components/generic/rdk-oe/meta-cmf-raspberrypi" refs/changes/36/51436/1 && git cherry-pick FETCH_HEAD

Note: The above bug and eSDK fixes changes are temporary given as instructions. This is not required once the change is get merged into the appropriate layer.

Populate eSDK

...

...

eSDK

...

$ MACHINE=

raspberrypi

raspberrypi3-rdk-

mc

camera source meta-cmf-raspberrypi/setup-environment
$ bitbake rdk-generic-

mediaclient-wpe

camera-image -c populate_sdk_ext

Command to populate eSDK from hybrid image

Code Block
language bash
theme	RDark
title	image build
Card
label	Hybrid Gateway
title

While building, If you get any compile time error. we should follow "Repo Bug Fixes" and start the build.

The generated eSDK installer resides under the directory build-<MACHINE>/tmp/deploy/sdk/rdk-glibc-x86_64-arm-toolchain-ext-2.0.sh of the Yocto workspace.

Note: The generated eSDK installer script usually occupies 2 to 2.5 GB

Code Block
language bash title Apply repo bug fixes
$ cd build-raspberrypi3-rdk-camera/tmp/work/cortexa7t2hf-neon-vfpv4-rdk-linux-gnueabi/thumbnail/git-r0/git $ git fetch "https://code.rdkcentral.com/r/rdkc/components/opensource/thumbnail" refs/changes/31/49531/1 && git cherry-pick FETCH_HEAD
theme	RDark
title	image build
MACHINE=raspberrypi-rdk-hybrid source meta-cmf-raspberrypi/setup-environment bitbake rdk-generic-hybrid-wpe-image -c populate_sdk_ext

eSDK Installation

The installer can be done on any x86_64 Linux machines.

...

Installation

# run the installer script file
# installer asks for a directory to install (default directory ~/rdk_sdk)
# installer asks permission to proceed
./rdk-glibc-x86_64-arm-toolchain-ext-2.0.sh

Below is the result (terminal output) of the installation

Build from eSDK

This section covers how to use the eSDK for component build and image build

...

The installer can be run on any x86_64 Linux based machines.

# change directory to the installed path
cd ~/rdk_sdk
# setup the eSDK environemnt
source environment-setup-cortexa7t2hf-neon-vfpv4-rdk-linux-gnueabi

...

Add Component

# way 1
# add a new recipe with URL
devtool add <recipe_name> <source URL>

Example:
# eg. devtool add westerossctplib httpsgit://github.com/rdkcmfrdkcteam/westerosusrsctplib

# way 2
# add a new recipe with external source directory
devtool add <recipe_name> <absolute path>
# eg.
Example:
# devtool add westerossctplib /path/for/source/directory

...

# modify existing recipe's URL or srctree or to add patches
devtool modify <recipe_name> <new URL>
# eg. devtool modify westeros https://code.rdkcentral.com/r/rdk/components/generic/westeros

Edit Component's recipe

# modify recipe from an editor
devtool edit-recipe <recipe_name>

Example:
# eg. devtool edit-recipe westeros

Upgrade Component

# modify existing recipe's URL or srctree or to add patches
devtool upgrade --version <version number> <recipe_name>
# eg. devtool upgrade --version 1.0.21 westeros

sctplib

Build Components

# Pre-requisite: add a new recipe using devtool
devtool build <recipe_name>

Example:
# eg. devtool build westerossctplib

Deploy binaries

# Pre-requisite: add a new recipe using devtool
devtool deploy-target <recipe_name> <target_path>

Example:
# eg. devtool deploy-target westerossctplib root@192.168.xx.xx

Build Image

...

# devtool command to build image from eSDK
# <IMAGE> - rdk-generic-mediaclient-wpecamera-image
devtool or rdk-generic-hybrid-wpe-image
build-image <IMAGE>

Example:
# devtool build-image <IMAGE>rdk-generic-camera-image