summaryrefslogtreecommitdiffstats
path: root/meta-sugarbay/README
diff options
context:
space:
mode:
Diffstat (limited to 'meta-sugarbay/README')
-rw-r--r--meta-sugarbay/README158
1 files changed, 0 insertions, 158 deletions
diff --git a/meta-sugarbay/README b/meta-sugarbay/README
deleted file mode 100644
index 52835196..00000000
--- a/meta-sugarbay/README
+++ /dev/null
@@ -1,158 +0,0 @@
1This README file contains information on building the meta-sugarbay
2BSP layer, and booting the images contained in the /binary directory.
3Please see the corresponding sections below for details.
4
5The 'Sugar Bay' platform consists of the Intel Sandy Bridge processor,
6plus the Cougar Point PCH (Q67 Express or B65 Express chipsets). This
7BSP assumes that the Sandy Bridge integrated graphics are being used.
8
9Further information on the platforms supported by this BSP can be
10found here:
11
12 http://www.intel.com/p/en_US/embedded/hwsw/hardware/core-q67-b65/overview
13
14And information on all IntelĀ® embedded platforms can be found here:
15
16 http://www.intel.com/p/en_US/embedded/hwsw/hardware
17
18
19Yocto Project Compatible
20========================
21
22This BSP is compatible with the Yocto Project as per the requirements
23listed here:
24
25 https://www.yoctoproject.org/webform/yocto-project-compatible-registration
26
27
28Dependencies
29============
30
31This layer depends on:
32
33 URI: git://git.openembedded.org/bitbake
34 branch: master
35
36 URI: git://git.openembedded.org/openembedded-core
37 layers: meta
38 branch: master
39
40 URI: git://git.yoctoproject.org/meta-intel
41 layers: intel
42 branch: master
43
44
45Patches
46=======
47
48Please submit any patches against this BSP to the meta-intel mailing list
49(meta-intel@yoctoproject.org) and cc: the maintainer:
50
51Maintainer: Saul Wold <sgw@linux.intel.com>
52
53Please see the meta-intel/MAINTAINERS file for more details.
54
55
56Table of Contents
57=================
58
59 I. Building the meta-sugarbay BSP layer
60 II. Booting the images in /binary
61
62
63I. Building the meta-sugarbay BSP layer
64=======================================
65
66In order to build an image with BSP support for a given release, you
67need to download the corresponding BSP tarball from the 'Board Support
68Package (BSP) Downloads' page of the Yocto Project website.
69
70Having done that, and assuming you extracted the BSP tarball contents
71at the top-level of your yocto build tree, you can build a sugarbay
72image by adding the location of the meta-sugarbay layer to
73bblayers.conf, along with the meta-intel layer itself (to access
74common metadata shared between BSPs) e.g.:
75
76 yocto/meta-intel \
77 yocto/meta-intel/meta-sugarbay \
78
79To enable the sugarbay layer, add the sugarbay MACHINE to local.conf:
80
81 MACHINE ?= "sugarbay"
82
83You should then be able to build a sugarbay image as such:
84
85 $ source oe-init-build-env
86 $ bitbake core-image-sato
87
88At the end of a successful build, you should have a live image that
89you can boot from a USB flash drive (see instructions on how to do
90that below, in the section 'Booting the images from /binary').
91
92NOTE: The 'sugarbay' machine will include support for hardware video
93acceleration via gstreamer if and only if the "commercial" string is
94added to the the LICENSE_FLAGS_WHITELIST variable in your local.conf.
95
96For example:
97
98 LICENSE_FLAGS_WHITELIST = "commercial"
99
100The reason this is needed is to prevent the image from including
101anything that might violate the license terms of the packages used to
102implement the the video acceleration feature, such as gst-ffmpeg and
103ffmpeg. As always, please consult the licenses included in the
104specific packages for details if you use packages that require
105particular LICENSE_FLAGS.
106
107The xf86-video-intel recipe depends on Xorg's dri and glx modules,
108which are built only when 'opengl' is listed in DISTRO_FEATURES. So
109if the distro doesn't list 'opengl' in the DISTRO_FEATURES, then you
110would need this additional line in your local.conf:
111
112 DISTRO_FEATURES_append = " opengl"
113
114As an alternative to downloading the BSP tarball, you can also work
115directly from the meta-intel git repository. For each BSP in the
116'meta-intel' repository, there are multiple branches, one
117corresponding to each major release starting with 'laverne' (0.90), in
118addition to the latest code which tracks the current master (note that
119not all BSPs are present in every release). Instead of extracting a
120BSP tarball at the top level of your yocto build tree, you can
121equivalently check out the appropriate branch from the meta-intel
122repository at the same location.
123
124
125II. Booting the images in /binary
126=================================
127
128This BSP contains bootable live images, which can be used to directly
129boot Yocto off of a USB flash drive.
130
131Under Linux, insert a USB flash drive. Assuming the USB flash drive
132takes device /dev/sdf, use dd to copy the live image to it. For
133example:
134
135# dd if=core-image-sato-sugarbay.hddimg of=/dev/sdf
136# sync
137# eject /dev/sdf
138
139This should give you a bootable USB flash device. Insert the device
140into a bootable USB socket on the target, and power on. This should
141result in a system booted to the Sato graphical desktop.
142
143If you want a terminal, use the arrows at the top of the UI to move to
144different pages of available applications, one of which is named
145'Terminal'. Clicking that should give you a root terminal.
146
147If you want to ssh into the system, you can use the root terminal to
148ifconfig the IP address and use that to ssh in. The root password is
149empty, so to log in type 'root' for the user name and hit 'Enter' at
150the Password prompt: and you should be in.
151
152----
153
154If you find you're getting corrupt images on the USB (it doesn't show
155the syslinux boot: prompt, or the boot: prompt contains strange
156characters), try doing this first:
157
158# dd if=/dev/zero of=/dev/sdf bs=1M count=512