Disclaimer:
——————————
You may not use or facilitate the use of this document in connection with any infringement or other legal analysis concerning Intel products described herein.
You agree to grant Intel a non-exclusive, royalty-free license to any patent claim thereafter drafted which includes subject matter disclosed herein.
No license (express or implied, by estoppel or otherwise) to any intellectual property rights is granted by this document.
All information provided here is subject to change without notice. Contact your Intel representative to obtain the latest Intel product specifications and roadmaps.
The products described may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current
characterized errata are available on request.
Copies of documents which have an order number and are referenced in this document may be obtained by calling 1-800-548-4725 or by
visiting: http://www.intel.com/design/literature.htm
Intel technologies’ features and benefits depend on system configuration and may require enabled hardware, software or service activation. Learn more
at http://www.intel.com/ or from the OEM or retailer.
No computer system can be absolutely secure.
Intel and the Intel logo are trademarks of Intel Corporation in the U.S. and/or other countries.
*Other names and brands may be claimed as the property of others.
Copyright ©2018, Intel Corporation. All rights reserved.

Saddle Brook (Sky Lake) Platform is supported by Intel Common Core BSP.

Building Common Core BSP layer for Saddle Brook Platform:
========================================================
Please download the Poky build system to your development machine.

Option 1: git clone git://git.yoctoproject.org/poky.git -b sumo-19.0.1

Option 2: Download Poky build tarball from http://downloads.yoctoproject.org/releases/yocto/yocto-2.5.1/poky-sumo-19.0.1.tar.bz2

Get the BSP layer either by cloning with Git or downloading the BSP tarball.

Option 1: git clone git://git.yoctoproject.org/meta-intel -b 9.1-sumo-2.5.1

Option 2: Download the corresponding BSP tarball from this ‘Board Support Package (BSP) Downloads’ page of the Yocto Project website.

Create a build folder at the same level of “poky” directory.
$ mkdir yocto_build
$ cd yocto_build

Assuming that you have downloaded the BSP tarball and extracted the content at top level of your development build tree, you
need to prepare the build environment using “source” command.
$ source ../poky/oe-init-build-env .

Build an image for Sky Lake platform by adding the location of meta-intel layer to conf/bblayers.conf, e.g.:
BBLAYERS ?= ” \
/path/poky/meta \
/path/poky/meta-poky \
/path/poky/meta-yocto-bsp \
/path/meta-intel \
”

To build 64-bit image, add “intel-corei7-64” MACHINE to local.conf:
MACHINE = “intel-corei7-64”

Build with Standard Kernel:
——————————————————————————

To build image with Standard kernel version of linux-intel (Eg. linux-intel 4.14), add these parameters to local.conf:

PREFERRED_PROVIDER_virtual/kernel = “linux-intel”
PREFERRED_VERSION_linux-intel = “4.14%”

Suggested settings for better graphic driver support:

meta-intel contains support for the i915 graphics driver.
However, to have a minimum setup of video components, gstreamer plugins need to be installed.
These gstreamer plugins require license flags in order to be included in the build.
Add “commercial” in the LICENSE_FLAGS_WHITELIST in local.conf.

For example:
LICENSE_FLAGS_WHITELIST = “commercial”

Note: By adding LICENSE_FLAGS_WHITELIST = “commercial”, it signifies that you understand the legal
requirements imposed by all of those included software ingredients.

To enable full hardware acceleration for video decode support, GStreamer 1.x base
and GStreamer-VAAPI packages need to be included as part of the Yocto Project build output
image. This can be done by adding the meta-intel as part of the bblayers.conf (as mentioned above).
The default GStreamer packages do not come with full codecs support; some additional
plugins need to be added manually in local.conf to support certain playback:
IMAGE_INSTALL_append =+ ” gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-vaapi”

For those who required to execute a 32-bit standalone application on Yocto,
the multilib environment need to be turned on in yocto_build/conf/local.conf as the configuration below:

require conf/multilib.conf
DEFAULTTUNE = “corei7-64”
MULTILIBS = “multilib:lib32”
DEFAULTTUNE_virtclass-multilib-lib32 = “corei7-32”

Once the configurations are added, kick start the image building process by using bitbake command.
To build an image with sato graphical interface :
$ bitbake core-image-sato

For building an image with the development tools, type the following command:
$ bitbake core-image-sato-sdk

A bootable image will be generated in yocto_build/tmp/deploy/images/intel-corei7-64/ once the
compilation successful.
File name that will be generated:
core-image-sato-intel-corei7-64.hddimg
OR
core-image-sato-sdk-intel-corei7-64.hddimg

Build with Preempt-RT Kernel:
————————————————————————————

To build image with Preempt-RT kernel version of linux-intel (Eg. linux-intel 4.14), add these parameters to local.conf:

PREFERRED_PROVIDER_virtual/kernel = “linux-intel-rt”
PREFERRED_VERSION_linux-intel-rt = “4.14%”

To install the rt related packages into the image for running the rt-tests on targeted machine add below:
IMAGE_INSTALL_append += ” rt-tests hwlatdetect rt-tests-ptest”

For those who required to execute a 32-bit standalone application on Yocto,
the multilib environment need to be turned on in yocto_build/conf/local.conf as the configuration below:

require conf/multilib.conf
DEFAULTTUNE = “corei7-64”
MULTILIBS = “multilib:lib32”
DEFAULTTUNE_virtclass-multilib-lib32 = “corei7-32”

Once the configurations are added, kick start the image building process by using bitbake command.
To build small image just capable of allowing a device to boot plus a real-time test suite and tools appropriate for real-time use:
$ bitbake core-image-rt

For building Small image capable of booting a device with a test suite and tools for real-time use and it includes the full meta-toolchain,
development headers and libraries to form a standalone SDK, type the following command:
$ bitbake core-image-rt-sdk

A bootable image will be generated in yocto_build/tmp/deploy/images/intel-corei7-64/ once the
compilation successful.
File name that will be generated:
core-image-rt-intel-corei7-64.hddimg
OR
core-image-rt-sdk-intel-corei7-64.hddimg

Booting Image:
==============
At the end of a successful build, you should have a live image that can be used to directly
boot Yocto off of a USB flash drive.

Under Linux host machine, insert a USB flash drive. Assuming the USB flash drive
takes device /dev/sdf, use dd to copy the live image to it. For
example:
# dd if=core-image-sato-intel-corei7-64.hddimg of=/dev/sdf bs=4M
# sync
# eject /dev/sdf

This should give you a bootable USB flash device. Insert the device into a bootable
USB socket on the platform, and power on. This should result in a system booted to:
Sato graphical desktop (using core-image-sato-intel-corei7-64.hddimg or core-image-sato-sdk-intel-corei7-64.hddimg)
OR
Command line desktop (using core-image-rt-intel-corei7-64.hddimg or core-image-rt-sdk-intel-corei7-64.hddimg)
The root password is empty on the Poky reference distribution images.

================================================================================

Best Known Configuration:
========================
Supported platform: Saddle Brook(Sky Lake) platform
CPU: 6th Generation Intel® Core™ Mobile Processor
PCH: SKL PCH-H D1 stepping
BIOS/Firmware Version: SKLSDBK1.R00.G007.B00.1610280147

Features supported in this release:
===================================
Standard kernel:
———————————————
Kernel feature list:
– Linux kernel version v4.14.68
– Support integrated graphics (i915)
– Support I/O devices – SATA, USB Host v2.0&3.0, HD Audio, SMBus, DMA
– Support RTC, HPET, WDT, Thermal
– Support Saddle Brook platform in-chip Ethernet driver: e1000e
– Support single displays (HDMI or DP)
– Support resolution for DP & HDMI (3840×2160@30Hz,4096×2160@24Hz)
– Support 2 Independent Displays (HDMI & DP)
– Support 2D HW acceleration (xf86-video-intel)
– Support 3D HW acceleration (GL4.5 and GLES3.2)
– Support HW Media acceleration (H.264, HEVC (H.265), MPEG2, MJPEG, VC1, WMV, VP8, VP9)
– Support HW Media encoding (H.264, HEVC (H.265), MPEG2, VP8)
– Support Media Players (GStreamer-VAAPI)

Preempt-RT kernel:
—————————————————

Kernel feature list:
– Linux kernel version v4.14.68
– Support I/O devices – SATA, USB Host v2.0&3.0,SMBus,DMA
– Support RTC, HPET, WDT, Thermal
– Support Saddle Brook platform in-chip Ethernet driver: e1000e
– Support single displays (HDMI or DP)
– Support resolution for DP & HDMI (3840×2160@30Hz,4096×2160@24Hz)
– Support 2 Independent Displays (HDMI & DP)
– Support Real Time Preemption test cases – this is applicable for BSP configured with Preempt-RT kernel only.

Important Notes:
================
Intel encourages using latest poky and meta-intel layer to build BSP layers with below command:

It provides the latest source, which will contain fixes or new feature.