Intel N3700, N3000, N3050, N3150 Mobile and Embedded Processors

Board Info

Cherry Hill BSP (Braswell)
Processor Family: Intel x86-64
Organization: Intel Corporation

Download

Built with: Yocto Project 1.8 – Fido
Compatible with: Fido 1.8.x
Release Date: 06/19/2015
MD5 sum: b959c199cdd4658730227e1611598ae9

Clone with Git (preferred)

git://git.yoctoproject.org/meta-intel -b fido

Release Notes

Cherry Hill (Braswell) BSP is supported by Intel Common Core BSP.

Building Common Core BSP layer for Cherry Hill:
Please download the Poky build system to your development machine.
$ git clone -b fido git://git.yoctoproject.org/poky.git

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 oe-init-build-env

You can build an image for Cherry Hill by adding the location of meta-intel layer to 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”

Suggested settings for better graphics driver support:

meta-intel contains support for i915 graphics driver.
However, they are dependent on gstreamer plugins and ffmpeg plugins.
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”

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

To execute 64-bit standalone applications, you need to enable multilib environment in your image.
The configurations below is needed in build/local.conf.
require conf/multilib.conf
DEFAULTTUNE = “corei7-64”
MULTILIBS = “multilib:lib32”
DEFAULTTUNE_virtclass-multilib-lib32 = “corei7-32”

You should then be able to build an image as such:
$ bitbake core-image-sato

At the end of a successful build, you should have a live image that you can boot from a USB flash drive.
You can deploy the hddimg image to a USB or SATA device. You will need to know the device name on your
host as well as the device name on the target. Be careful with this step as using the wrong host device
can result in overwriting data on your own host machine.

Under Linux, USB and SATA devices typically appears as /dev/sdb, /dev/sdc, etc.
Watching your system messages as you connect the device will tell you exactly which device name
is assigned to the device.
On the Cherry Hill platform, assuming only one storage device is attached at boot, a USB or SATA device
will be /dev/sda.

After inserting the boot media into your host machine and determining your host and target device, create the
image using the mkefidisk.sh script, provided by poky under scripts/contrib/.
Note that root privileges are required.
For example, using an USB device which appears as /dev/sdc on the host:
$ sudo ./mkefidisk.sh /dev/sdc core-image-sato-intel-corei7-64.hddimg /dev/sda

Follow the prompts on the screen to confirm the action.

Insert the device into the Cherry Hill 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.

Steps to install image into on-board eMMC:
You need a live bootable USB thunb drive in order to install image into on-board eMMC.
First, prepare the USB thumb drive and copy the image into USB using “dd” command.
Assume your USB mounted as /dev/sdc on your Linux host machine.
$ dd if=core-image-sato-intel-corei7-64.hddimg of=/dev/sdc && sync
Plug the USB stick into Cherry Hill platform and choose to boot off USB device.
When you reach the Grub menu, choose “Install” option.
Follow the command prompt to choose the correct partition to install your image.
Note: eMMC should be detected as /dev/mmcblk0.
Once the installation is complete, remove your USB and press “ENTER” to reboot.
———-
Best Known Configuration:

Supported platform: Cherry Hill Fab. E (Build Number: H31663-500) Customer Reference Board
CPU: Braswell C0 Step
BIOS/Firmware Version: BSW BIOS v73
BSW GOP v8.0.1031
TXE: Intel® Trusted Execution Engine FW v2.0.0.2060
Note: There is no TXE drivers available for Yocto Project Linux.

For more details, please refer to our configuration documentation posted at Intel Business Link:
Intel Business Link

Features supported in this release:

Kernel feature list:
– 64-bit Yocto Project Linux Kernel version 3.19
– Legacy drivers: SATA 2.0 & 3.0, USB Host 2.0 & 3.0, HD Audio, HDMI Audio
– LPSS I/O devices: UART(Debug), HSUART(COM), I2C Designware, 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 power management

Graphics driver (i915) feature list:
– Support DP Port DDI2/DP Port DD1/HDMI (supported extended/clone for dual/triple display)
– Support display rotation
– Support 4K display
– Support Mesa 10.4.4 (OpenGL 3.3, OpenGLES 2.0, OpenGLES 3.0)
– Support Intel-VAAPI 1.5.0, libVA-1.5.0
– Support decoding on H264, MPEG2, VC1, MJPEG & VP8
– Support the following encoding formats:
raw YUY420 to H264 i420 30 fps
raw to MPEG2 i420 30 fps
1920×1080 USB raw YUY2 to camera input to H264
1920×1080 USB raw YUY2 camera input to MPEG2
– Support video scaling
– Support transcoding “H264 to MPEG2” and “MPEG2 to H264”
– Support Graphic burst mode (turbo auto-throttling)
– Support S3 (Suspend to RAM) & DPMS

Additional features:
– Support MVC encode
– Support VP8 encode
– Support JPEG decode/encode

Known Issues:
– Display is blank when booting up eDP on Braswell RVP.
– Blank screen is observed on the hotplugged port under hotplug operation.
– Multiple time stamping artifact observed on certain video clips when playing video decoding using
gstreamer-VAAPI.
Workaround: Play video decode in full screen mode.
– Display will go blank (Power saving mode) during installation from USB into eMMC.
Workaround: Press any key to get the display back.