Build Workstation Configuration

This section outlines key system and host environment configuration elements needed to build the reference operating system.

The following configuration and Yocto workflow is based on a workstation running Linux*. Examples provided have been tested with Ubuntu* 16.04 and should work on most modern distributions if adapted by a knowledgeable developer.

Environment Setup

Set Locale

It is recommended to set locale to common as there can be some sync issues with locale on compilation if time stamps are off:

user@linuxbox:~$ sudo locale-gen "en_US.UTF-8"
user@linuxbox:~$ sudo dpkg-reconfigure locales

Install dependencies

sudo apt-get update
sudo apt-get install socat subversion diffstat makeinfo chrpath texinfo
get gawk xsltproc

Subversion for configuration

After installing dependencies, the subversion needs be ran once for the settings part to have the basis to edit the ~/.subversion/.. files

This can be done by running subversion once to create the configurations to edit (below):

user@linuxbox:~$ mkdir /home/<user>/svn
user@linuxbox:~$ svnadmin create /home/<user>/svn
Subversion proxy is set in ~/.subversion/servers

System Configuration

Set Git Proxy:

Review the Yotco wikipage about working behind a corporate firewall or personal proxy server and adapt as needed for your situation.

SSH Keys

If you don't have the SSH keys, please follow these instructions.

Note: +ssh-dss needs to be added for SSH to use Gerrit (replace<your git server> and <username> below).

Host git-*.<your git server>.com
User <username>
HostkeyAlgorithms +ssh-dss


The development workstation is now configured to fetch required libraries and build the reference operating system.

See modifying the recipe for information on creating customer OS builds.

For more complete information about compiler optimizations, see our Optimization Notice.