Intel® Pentium®/Celeron® Processor N3000 Family, Intel® Atom™ X5-E8000 Processor

Board Info

Cherry Hill Platform
Processor: Intel x86-64
Organization: Intel Corporation

BSP INFO

You can either clone with Git or download the tarball.

Clone with Git (preferred)

git://git.yoctoproject.org/meta-intel -b 8.1-rocko-2.4.2

Download

Built with: Yocto Project 2.4 – Rocko
Compatible with: Rocko 2.4.2
Release Date: April 2018
MD5 sum: 68cf8adbfb5e02f8605a39ee2184443c

RELEASE NOTES

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.

The Cherry Hill platform is supported by Intel Common Core BSP.

Building Common Core BSP layer for Cherry Hill Platform:
=======================================================
Download the Poky build system to your development machine.
$ git clone -b rocko git://git.yoctoproject.org/poky.git

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 8.1-rocko-2.4.2

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

Extract the downloaded BSP tarball into meta-intel folder
$ tar -xvjf meta-intel-8.1-rocko-2.4.2.tar.bz2

Rename the folder of the extracted BSP tarball to meta-intel.
Note: Ignore this step if there is already a folder with the same name.
$ mv meta-intel-8.1-rocko-2.4.2 meta-intel

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 Cherry Hill by adding the location of meta-intel layer to conf/bblayers.conf, e.g.:
BBLAYERS ?= ” \
/path/poky/meta \
/path/poky/meta-yocto \
/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”

To build image with specified 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

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 the Sato graphical desktop. The root
password is empty on the Poky reference distribution images.

Follow these steps to install an image onto an on-board eMMC*:
NOTE: You need a live bootable USB thumb drive in order to install the image onto an on-board eMMC.
1. Prepare the USB thumb drive and copy the image to the USB using the “dd” command.
2. Assume your USB is mounted as /dev/sdc on your Linux host machine.
$ dd if=core-image-sato-intel-corei7-64.hddimg of=/dev/sdc && sync
3. Plug the USB stick into a Cherry Hill platform and choose to boot off the USB device.
4. When you reach the Grub menu, choose the “Install” option. Follow the command prompt to choose the correct partition to install your image.
NOTE: eMMC should be detected as /dev/mmcblk0.
5. Once the installation is complete, remove the USB and press “ENTER” to reboot

Best Known Configuration:
========================
Supported platform: Cherry Hill Fab. E (Build 1 and 2) Customer Reference Board
CPU: Intel® Pentium®/Celeron® Processor N3000 Family C0 Step & D1 Step, Intel® Atom™ x5-E8000 Processor
BIOS/Firmware Version: Cherry Hill CRB BIOS v103
GOP: Cherry Hill CRB v8.0.1037
TXE: Intel® Trusted Execution Engine FW v2.0.5.3118
NOTE: There are no TXE drivers available for Yocto Project Linux.

Features supported in this release:
===================================
Kernel feature list:
– Linux kernel version 4.14.18
– Support integrated graphics (i915)
– Legacy drivers: SATA 2.0 and 3.0, USB Host 2.0 and 3.0, HD Audio
– LPSS I/O devices: UART(Debug), HSUART(COM), I2C*, Pinctrl (GPIO*), SDHCI, SMBus
– Cherry Hill platform on-board ethernet driver: Realtek* GBE
– USB, SATA and eMMC boot with UEFI enabled
– CPU idle states support up to C6
– S3, S4 power management

Graphics driver (i915) feature list:
– 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.1)
– Support HW Media acceleration (H.264, HEVC (H.265), MPEG2, MJPEG, VC1, WMV, VP8, VP9)
– Support HW Media encoding (H.264, MPEG2, VP8)
– Support Media Players (GStreamer-VAAPI)