Intel Atom® and Intel® Core™ Processor Build Environment Setup for Yocto Project*-based BSP

1.0 Introduction

This Getting Started Guide provides guideline to prepare the Yocto Project*- based board support package (BSP) build environment. This guide targets users who need to build, customize, and configure their build environment specifically for Yocto Project*-based BSP.

1.1 Terminology

1.2 Reference Documents

1.3 Known Issues

2.0 Pre-requisites

This section lists out pre-requisites for preparing the build system for some of the Intel platforms. For the platform not listed here, refer to respective BSP release note or getting started guide for more information.

2.1 Apollo Lake-I Yocto Project*-based BSP

Prepare a build system (computer) with the recommended minimum hardware requirement:

• Intel® Core™ i7 processor (4 cores with Intel® Hyper-Threading Technology)
• Minimum of 16 GB Random Access Memory (RAM)
• Minimum of 500 GB disk space
• High-speed network connectivity
• Linux* OS for Yocto Project* BSP: Ubuntu* v14.04 LTS

2.2 Whiskey Lake-U / Coffee Lake-R/ Comet Lake-S Yocto Project*-based BSP

Prepare a build system (computer) with the recommended minimum hardware requirement:

• Intel® Core™ i7 processor (4 cores with Intel® Hyper-Threading Technology)
• Minimum of 32 GB Random Access Memory (RAM)
• Minimum of 500 GB disk space
• High-speed network connectivity
• Linux* OS for Yocto Project*-based BSP: Ubuntu* v16.04 LTS

3.0 Setting Up the Build System

This section describes the steps required to setup proxy (if your build system is behind a corporate firewall), necessary toolchain and SSH configuration, so that the system can have Git operate and access world wide web through a firewall.

The steps are based on a newly installed Ubuntu* system. If you are using an existing system that has default configuration (include proxy), that may potentially create a conflict. Please work with your IT department to resolve the issues.

You may download step-by-step guided video ("How-to Video: Setting Up Build Environment in the Host System for Yocto* Project" RDC Doc#608732) along with this document.

NOTE: It is required to reboot your system once at the end of this section so that all configurations will take effect.

Step 1: Corporate Firewall Proxy Setup

Perform this step ONLY if your build system is behind a corporate firewall.

1.a Add proxy settings to /etc/environment

$ sudo gedit /etc/environment
export SOCKS_SERVER=socks://<proxy server IP or DNS>:<socks port number>
export HTTP_PROXY=http://<proxy server IP or DNS>:<http port number>
export HTTPS_PROXY=https://<proxy server IP or DNS>:<https port number>
export FTP_PROXY=http://<proxy server IP or DNS>:<ftp port number>

1.b Edit the .bashrc file

Append to the proxy settings using the following:

$gedit ~/.bashrc
# Insert the below lines in ~/.bashrc
export SOCKS_SERVER=socks://<proxy server IP or DNS>:<socks port number>
export HTTP_PROXY=http://<proxy server IP or DNS>:<http port number>
export HTTPS_PROXY=https://<proxy server IP or DNS>:<https port number>
export FTP_PROXY=http://<proxy server IP or DNS>:<ftp port number>

1.c Reload the bash environment

$source ~/.bashrc

1.d Set up proxy for apt-get

Edit apt.conf using the following:

$ sudo gedit /etc/apt/apt.conf
Acquire::http::proxy "http://<proxy server IP or DNS>:<http port>/";
Acquire::https::proxy "https://<proxy server IP or DNS>:<https port>/";
Acquire::ftp::proxy "ftp://<proxy server IP or DNS>:<ftp port>/";
Acquire::socks::proxy "socks://<proxy server IP or DNS>:<socks proxy>/";

Step 2: Install Necessary Tools

$ sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib build-essential chrpath socat
$ sudo apt-get install libsdl1.2-dev xterm
$ sudo apt-get install make xsltproc docbook-utils fop dblatex xmlto
$ sudo apt-get install autoconf automake libtool libglib2.0-dev
$ sudo apt-get install xutils-dev nfs-common

Step 3: Git Configuration

Create and add the following configuration under /home/<username>/.gitconfig:

[user]
    email = <your.name>@<your_domain>.com
    name = <Your Name>
[sendemail]
    smtpserver = <Your organization's SMTP server address>
    signedoffcc = false
    suppresscc = all
    chainreplyto = false
    assume8bitEncoding = utf-8
    from = <Your Name> <your.name@your_domain.com>
    confirm = always
[color "grep"]
    match = red
[color]
    diff = auto
    ui = auto
    interactive = auto
    grep = always
[alias]
    co = checkout
    br = branch
    ci = commit
    st = status
    ol = log -oneline
[core]
    editor = gedit OR vi
#uncomment the gitproxy variable
#if behind corporate firewall
#gitproxy = /home/<username>/bin/gitproxy

Step 4: Gitproxy File for Corporate Firewall

If your build machine is behind a corporate firewall, create the /home/<username>/bin/gitproxy file and insert the SOCKS proxy configuration using the following:

$ gedit /home/<username>/bin/gitproxy
#!/bin/bash
exec socat stdio SOCKS:<proxy server IP or DNS>:$1:$2
#Make gitproxy executable
$ chmod +x /home/<username>/bin/gitproxy

Step 5: Generate SSH Key for GitHub

Generate an SSH key and add the key to your GitHub* account. Go to this link and follow the instructions on each subsection on the webpage:

• Checking for existing SSH keys
• Generating a new SSH key and adding it to the ssh-agent
• Adding a new SSH key to your GitHub* account
• Testing your SSH connection

Step 6: SSH Configuration

Create and add the following lines in ~/.ssh/config:

host github.com
    user git
    hostname ssh.github.com
    identityfile ~/.ssh/id_rsa
    port 443
    proxycommand /bin/nc -X connect -x <proxy server IP or DNS>:<http port number> %h %p
    tcpkeepalive yes
    compression yes
    connectionattempts 3

Step 7: Reboot System

Reboot the build system so that all configurations will take effect.

Step 8: Ready to Build

Once the system is rebooted, you are now ready to build Yocto Project*-based Image. Refer to the respective platform's release note for the respective software release information and getting started guide for the steps to build the image.