Yocto Reference Manual

Installation

You should at least set name and email in your Git configuration, otherwise Bitbake will complain on the first build. You can use the two commands to set them directly without editing ~/.gitconfig manually: git config ‐‐global user.email [email protected]  git config ‐‐global user.name "name surname" 

4.3 site.conf Setup

Before starting the Yocto build, it is advisable to configure the development setup. Two things are most important: the download directory and the cache directory. It is not a precondition to do this, but strongly recommended, as it will reduce the compile time of consequent builds.

The download directory is a place where Yocto stores all sources fetched from the internet.

It can contain tar.gz, Git mirror or anything else. It is very useful to set this to a common shared location on the machine. Create this directory with 777 access rights. To be able to share this directory between different users all files need to have group write access. This will most probably be in conflict with default umask settings. One possible solution would be to use ACLs for this directory: sudo apt‐get install  acl  sudo setfacl ‐R ‐d ‐m g::rwx <dl_dir> 

If you already created a download directory and want to fix the permissions afterwards, you can do so with: sudo find /home/share/  ‐perm /u=w ! ‐perm /g=w ‐exec chmod g+w \{\} \;  sudo find /home/share/  ‐perm /u=w ! ‐perm /g=w ‐exec chown g+w \{\} \;  sudo find /home/share/  ‐perm /u=r ! ‐perm /g=r ‐exec chmod g+r \{\} \; 

The cache directory stores all stages of the build process. Poky has quite an involved caching infrastructure. It is also advisable, to create a shared directory, as all builds can access this cache directory, called shared state cache.

Create the two directories on a drive where you have approximately 50 GB of space and assign the following two variables in your build/conf/local.conf.

DL_DIR ?= "<your_directory>/yocto_downloads" 

SSTATE_DIR ?= "<your_directory>/yocto_sstate" 

If you want to know more about configuring your build, have a look at the documented example settings: sources/poky/meta‐yocto/conf/local.conf.sample  sources/poky/meta‐yocto/conf/local.conf.sample.extended 

© PHYTEC Messtechnik GmbH 2015 L-813e_2 9