summaryrefslogtreecommitdiffstats
path: root/meta-cedartrail/README
diff options
context:
space:
mode:
Diffstat (limited to 'meta-cedartrail/README')
-rwxr-xr-xmeta-cedartrail/README199
1 files changed, 0 insertions, 199 deletions
diff --git a/meta-cedartrail/README b/meta-cedartrail/README
deleted file mode 100755
index fe84c2de..00000000
--- a/meta-cedartrail/README
+++ /dev/null
@@ -1,199 +0,0 @@
1This README file contains information on building the meta-cedartrail
2BSP layer, and booting the images contained in the /binary directory.
3Please see the corresponding sections below for details.
4
5The 'Cedar Trail' platform consists of the Intel® Atom™
6N2600/N2800/D2550 processor, plus the Intel® NM10 Express Chispset
7(Cedarview + Tiger Point).
8
9It also supports on-chip SGX545 graphics and media accelerator
10via the Cedar Trail Power VR (PVR) graphics driver.
11
12Further information about the platforms supported by this BSP can be
13found here:
14
15 http://www.intel.com/p/en_US/embedded/hwsw/hardware/atom-n2000-d2000/overview
16
17Information on all Intel® embedded platforms can be found here:
18
19 http://www.intel.com/p/en_US/embedded/hwsw/hardware
20
21
22Compliance
23==========
24
25This BSP is compliant with the Yocto Project as per the requirements
26listed here:
27
28 https://www.yoctoproject.org/webform/yocto-project-compatible-registration
29
30
31Dependencies
32============
33
34This layer depends on:
35
36 URI: git://git.openembedded.org/bitbake
37 branch: master
38
39 URI: git://git.openembedded.org/openembedded-core
40 layers: meta
41 branch: master
42
43 URI: git://git.yoctoproject.org/meta-intel
44 layers: intel
45 branch: master
46
47
48Patches
49=======
50
51Please submit any patches against this BSP to the Yocto mailing list
52(yocto@yoctoproject.org) and cc: the maintainer:
53
54Maintainer: Kishore Bodke <kishore.k.bodke@intel.com>
55
56Please see the meta-intel/MAINTAINERS file for more details.
57
58Table of Contents
59=================
60
61 I. Building the meta-cedartrail BSP layer
62II. Booting the images in /binary
63
64
65I. Building the meta-cedartrail BSP layer
66=========================================
67
68In order to build an image with BSP support for a given release, you
69need to download the corresponding BSP tarball from the 'Board Support
70Package (BSP) Downloads' page of the Yocto Project website.
71
72Having done that, and assuming you extracted the BSP tarball contents
73at the top-level of your yocto build tree, you can build a cedartrail
74image by adding the location of the meta-cedartrail layer to
75bblayers.conf, along with the meta-intel layer itself (to access
76common metadata shared between BSPs) e.g.:
77
78 yocto/meta-intel \
79 yocto/meta-intel/meta-cedartrail \
80
81To enable the cedartrail layer that supports Power VR graphics,
82add the cedartrail MACHINE to local.conf:
83
84 MACHINE ?= "cedartrail"
85
86Power VR Graphics user-space driver binaries are covered by a
87"Intel Free Distribution Binary License". The build of this driver
88can be enabled by adding the following line to the local.conf file:
89
90LICENSE_FLAGS_WHITELIST += "license_cdv-pvr-driver_1.0.3"
91
92To enable the layer that does not support Power VR graphics
93add the following to the local.conf file:
94
95 MACHINE ?= "cedartrail-nopvr"
96
97
98You should then be able to build a cedartrail image as such:
99
100 $ source oe-init-build-env
101 $ bitbake core-image-sato
102
103The above image will not give you the webkit feature and will not
104have the Audio and Video media samples in the image.
105
106If you want the webkit feature and Audio , Video media samples built
107into the image by default, You should build the custom image by
108doing the following:
109
110 $ source oe-init-build-env
111 $ bitbake core-image-cdv-media
112
113At the end of a successful build, you should have a live image that
114you can boot from a USB flash drive (see instructions on how to do
115that below, in the section 'Booting the images from /binary').
116
117NOTE: The 'cedartrail' machine will include support for hardware video
118acceleration via gstreamer if and only if the "commercial" string is
119added to the the LICENSE_FLAGS_WHITELIST variable in your local.conf.
120
121For example:
122
123 LICENSE_FLAGS_WHITELIST = "license_cdv-pvr-driver_1.0.3 commercial"
124
125The reason this is needed is to prevent the image from including
126anything that might violate the license terms of the packages used to
127implement the the video acceleration feature, such as gst-ffmpeg and
128ffmpeg. As always, please consult the licenses included in the
129specific packages for details if you use packages that require
130particular LICENSE_FLAGS.
131
132As an alternative to downloading the BSP tarball, you can also work
133directly from the meta-intel git repository. For each BSP in the
134'meta-intel' repository, there are multiple branches, one
135corresponding to each major release starting with 'laverne' (0.90), in
136addition to the latest code which tracks the current master. Instead
137of extracting a BSP tarball at the top level of your yocto build tree,
138you can equivalently check out the appropriate branch from the
139meta-intel repository at the same location.
140
141
142II. Booting the images in /binary
143==================================
144
145This BSP contains bootable live images, which can be used to directly
146boot Yocto off of a USB flash drive.
147
148Under Linux, insert a USB flash drive. Assuming the USB flash drive
149takes device /dev/sdf, use dd to copy the live image to it. For
150example:
151
152# dd if=core-image-sato-cedartrail-20120105232035.hddimg of=/dev/sdf
153# sync
154# eject /dev/sdf
155
156This should give you a bootable USB flash device. Insert the device
157into a bootable USB socket on the target, and power on. This should
158result in a system booted to the Sato graphical desktop.
159
160If you want a terminal, use the arrows at the top of the UI to move to
161different pages of available applications, one of which is named
162'Terminal'. Clicking that should give you a root terminal.
163
164If you want to ssh into the system, you can use the root terminal to
165ifconfig the IP address and use that to ssh in. The root password is
166empty, so to log in type 'root' for the user name and hit 'Enter' at
167the Password prompt: and you should be in.
168
169----
170
171If you find you're getting corrupt images on the USB (it doesn't show
172the syslinux boot: prompt, or the boot: prompt contains strange
173characters), try doing this first:
174
175# dd if=/dev/zero of=/dev/sdf bs=1M count=512
176
177Miscellaneous Notes
178====================
179
180Video and Music Samples
181-----------------------
182This BSP includes recipes to download Ogg format video and
183music files that can be played-back with the Video and music players
184included in the sato images. The sample files are installed in
185/home/Music and /home/Videos directories.
186
187
188Adding Glxgears to image
189-------------------------
190Glxgears can be added to the generated image by adding "tools-testapps"
191option to the extra image features variable in the default local.conf
192before building the BSP.
193
194e.g. to add Glxgears, locate the following line in local.conf
195EXTRA_IMAGE_FEATURES = "debug-tweaks"
196
197and change above line to..
198
199EXTRA_IMAGE_FEATURES = "debug-tweaks tools-testapps"