Extender Profile: Yocto Build Instructions

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

The OpenEmbedded build system should be able to run on any modern distribution with the following versions for Git, tar, and Python.

• Git 1.7.8 or greater.

• tar 1.24 or greater.

• Python 2.7.3 or greater excluding Python 3.x, which is not supported.

Note: You should also have about 50 Gbytes of free disk space for building images.

Ubuntu and Debian

The essential packages you need for a supported Ubuntu or Debian distribution are shown in the following command

$ sudo apt-get install make gcc g++ diffstat texinfo chrpath gcc-multilib git gawk build-essential autoconf libtool libncurses-dev gettext gperf lib32z1 libc6-i386 g++-multilib python-git

Building

In order to use Yocto build system, the repo tool must be properly installed on the machine.

Repo setup

In order to install Repo make sure you have a /bin directory in your home directory and that it is included in your path

$ mkdir ~/bin

$ PATH=~/bin:$PATH

Download the repo tool and ensure that it is executable

$ curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/bin/repo

$ chmod a+x ~/bin/repo

Note: it is also recommended to put credentials in .netrc when interacting with repo.

A sample .netrc file is illustrated below

machine code.rdkcentral.com

login YOUR_USERNAME

password YOUR_PASSWORD

Initilaizing the Build Environment

To build, follow below instructions

$ mkdir <workspace dir> ###GUIDELINE: Make sure "$ readlink -f  <workspace dir>" is not exceeding 60 characters to avert potential build issue with python3-kconfig

$ cd <workspace dir>

Building image with no external source

repo init -u https://code.rdkcentral.com/r/manifests -m rdkb-turris-pod-nosrc.xml -b rdk-next
repo sync -j4 --no-clone-bundle
MACHINE=turris-extender source meta-turris/setup-environment build-turris-ext
bitbake rdk-generic-extender-image

Building image with external source

repo init -u https://code.rdkcentral.com/r/manifests -m rdkb-turris-pod-extsrc.xml -b rdk-next
repo sync -j4 --no-clone-bundle
MACHINE=turris-extender source meta-turris/setup-environment build-turris-ext
bitbake rdk-generic-extender-image

Note. The kernel Image and root filesystem will be placed under <workspace dir>/build-turris-ext/tmp/deploy/images/turris-extender directory