Versions Compared

Key

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

...

Setting up the Host Environment

Pre-Requisites

Requirement

Remarks

Linux

32/64 bit Ubuntu 16.04 OS

Precise supported distributions and versions are here

Free Fee HDD Space

Minimum 100GB Free Memory

Oracle Virtual Box

5.0.40 or higher

Wireless Adapter

Brand Name: Tenda ralink & Model Number:W311MI

TP-Link Archer T4U AC 1200

USB to Ethernet Switch

To connect with Ethernet Switch & Multiple Clients

Host Tools version
  • Git 1.8.3.1 or greater

  • tar 1.24 or greater

  • Python 2.7.3

Install the following packages for setting up your host VM

The instructions provided below are meant to be executed via the command line on an Ubuntu machine:sudo apt-get install build-essential get text bison

Code Block
languagebash
themeRDark
# essential packages installation
# super user mode is required
sudo apt-get install build-essential get text bison libfile-slurp-perl gawk libncurses-dev autoconf flex doxygen libtool

...

 automake libpcre3-dev zlib1g-dev libbz2-dev subversion minicom putty libssl-dev rpm python-pexpect python-svn python-argparse vim tofrodos meld dos2unix cmake uuid-dev ruby transfig libglib2.0-dev xutils-dev lynx-cur gperf

...

 autopoint python-dulwich python-dev curl vim diffstat texinfo

...

 chrpath openjdk-7-jre

Configure bash as default command interpreter for shell scripts

...

On Ubuntu 16.04 LTS, if you are unable to upgrade your git version using apt-get, then follow the below steps in order to upgrade  sudo

Code Block
languagebash
themeRDark
sudo apt-get install python-software-properties

...


sudo add-apt-

...

repository ppa:git-core/ppa

...


sudo apt-get update

...


sudo apt-get install git

Once git is installed, configure your name and email using the below commands

...

Code Block
languagebash
themeRDark
# review your existing configuration
git config --list --show-origin

# configure user name and email address
git config 

...

--global user.

...

name "John Doe"
git config --global user

...

.email johndoe@example.com

Configure repo

In order to use Yocto build system, first you need to make sure that repo is properly installed on the machine:mkdir

Code Block
languagebash
themeRDark
# create a bin directory
mkdir ~/bin

...


export 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

Trivia Repo is a repository management tool that is built on top of Git. Its main purpose is to help manage projects that consist of many Git repositories, it can also be used to manage uploads to the CMF Gerrit instance and automate aspects of the development workflow.

...

Repo manages this for you by means of an XML based Manifest file. The Manifest file defines which repositories the project uses and links to appropriate revisions of each git repository, i.e where the upstream repositories reside and where they should be cloned locally. It is the manifest.xml (or default.xml) that determines which Git repositories and revisions repo will manage. This manifest.xml file is hosted in a Git repository along with all the other git repositories.

 Credential configuration

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

A sample .netrc file is illustrated below

machine code.rdkcentral.com

    login <YOUR_USERNAME>

    password <YOUR_PASSWORD>

Downloading Source Code & Building

...

repo init -u https://code.rdkcentral.com/r/manifests -m rdkb.xml -b morty


$ repo sync -j4 j`nproc` --no-clone-bundle

Note
  • Cloning the code before login once to code.rdkcentral.com, user would get the Authentication error, even though the account is in good standing and has all the required access.
  • Please login to code.rdkcentral.com before attempting to clone.

...