diff options
author | Rebecca Chang Swee Fun <rebecca.swee.fun.chang@intel.com> | 2014-05-10 01:58:32 +0800 |
---|---|---|
committer | Tom Zanussi <tom.zanussi@intel.com> | 2014-05-09 11:27:01 -0500 |
commit | 3038ba05555ded1e68692ca7c214de896b51e18e (patch) | |
tree | 2e96b4b0c85f32af2e64ad04b21246319b412007 /meta-isg/meta-valleyisland | |
parent | 81bae8476a49da7552a67ad924065885c676a245 (diff) | |
download | meta-intel-3038ba05555ded1e68692ca7c214de896b51e18e.tar.gz |
meta-valleyisland: new BSP layer for Intel Atom E38XX Processor
This layer provides support for Intel Atom E38XX Processor
product line.
Signed-off-by: Chan Wei Sern <wei.sern.chan@intel.com>
Signed-off-by: Rebecca Chang Swee Fun <rebecca.swee.fun.chang@intel.com>
Acked-By: Nitin A Kamble <nitin.a.kamble@intel.com>
Diffstat (limited to 'meta-isg/meta-valleyisland')
-rw-r--r-- | meta-isg/meta-valleyisland/COPYING.MIT | 17 | ||||
-rw-r--r-- | meta-isg/meta-valleyisland/README | 218 | ||||
-rw-r--r-- | meta-isg/meta-valleyisland/README.sources | 18 | ||||
-rw-r--r-- | meta-isg/meta-valleyisland/conf/layer.conf | 14 |
4 files changed, 267 insertions, 0 deletions
diff --git a/meta-isg/meta-valleyisland/COPYING.MIT b/meta-isg/meta-valleyisland/COPYING.MIT new file mode 100644 index 00000000..89de3547 --- /dev/null +++ b/meta-isg/meta-valleyisland/COPYING.MIT | |||
@@ -0,0 +1,17 @@ | |||
1 | Permission is hereby granted, free of charge, to any person obtaining a copy | ||
2 | of this software and associated documentation files (the "Software"), to deal | ||
3 | in the Software without restriction, including without limitation the rights | ||
4 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | ||
5 | copies of the Software, and to permit persons to whom the Software is | ||
6 | furnished to do so, subject to the following conditions: | ||
7 | |||
8 | The above copyright notice and this permission notice shall be included in | ||
9 | all copies or substantial portions of the Software. | ||
10 | |||
11 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | ||
12 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | ||
13 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | ||
14 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | ||
15 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | ||
16 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN | ||
17 | THE SOFTWARE. | ||
diff --git a/meta-isg/meta-valleyisland/README b/meta-isg/meta-valleyisland/README new file mode 100644 index 00000000..99cba0d1 --- /dev/null +++ b/meta-isg/meta-valleyisland/README | |||
@@ -0,0 +1,218 @@ | |||
1 | This README file contains information on building the meta-valleyisland | ||
2 | BSP layer, and booting the images contained in the /binary directory. | ||
3 | Please see the corresponding sections below for details. | ||
4 | |||
5 | The Valley Island BSP consists of two versions: | ||
6 | 1. 32-bit Valley Island | ||
7 | 2. 64-bit Valley Island | ||
8 | |||
9 | The BSP is made specifically for Intel Atom E38XX Processor E38XX | ||
10 | Development Kit (formerly known as Valley Island). This BSP integrates | ||
11 | Intel Graphics for Linux driver as the integrated graphics. | ||
12 | |||
13 | Valley Island BSP is meant to support Valley Island Development | ||
14 | Kit, "Bayley Bay" CRB and "Bakersport" CRB. | ||
15 | |||
16 | Further information on the platforms supported by this BSP can be | ||
17 | found here: | ||
18 | |||
19 | http://www.intel.com/content/www/us/en/intelligent-systems/bay-trail/atom-processor-e3800-family-overview.html | ||
20 | |||
21 | Information on all IntelĀ® embedded platforms can be found here: | ||
22 | |||
23 | http://www.intel.com/p/en_US/embedded/hwsw/hardware | ||
24 | |||
25 | Yocto Project Compatible | ||
26 | ======================== | ||
27 | |||
28 | This BSP is compatible with the Yocto Project as per the requirements | ||
29 | listed here: | ||
30 | |||
31 | https://www.yoctoproject.org/webform/yocto-project-compatible-registration | ||
32 | |||
33 | Dependencies | ||
34 | ============ | ||
35 | |||
36 | This layer depends on: | ||
37 | |||
38 | URI: git://git.openembedded.org/bitbake | ||
39 | branch: master | ||
40 | |||
41 | URI: git://git.openembedded.org/openembedded-core | ||
42 | layers: meta | ||
43 | branch: master | ||
44 | |||
45 | URI: git://git.yoctoproject.org/meta-intel | ||
46 | layers: intel | ||
47 | branch: master | ||
48 | |||
49 | Patches | ||
50 | ======= | ||
51 | |||
52 | Please submit any patches against this BSP to the Meta-Intel Yocto mailing list | ||
53 | (meta-intel@yoctoproject.org) and cc: the maintainer: | ||
54 | |||
55 | Maintainer: Chang Rebecca Swee Fun <rebecca.swee.fun.chang@intel.com> | ||
56 | |||
57 | Please see the meta-isg/MAINTAINERS file for more details. | ||
58 | |||
59 | Table of Contents | ||
60 | ================= | ||
61 | |||
62 | I. Building the meta-valleyisland BSP layer | ||
63 | II. Booting the images in /binary | ||
64 | III. Device Notes | ||
65 | a. Boot Loader | ||
66 | b. I/O drivers | ||
67 | c. LPIO ACPI enumeration support | ||
68 | IV. Known Issues | ||
69 | a. I/O drivers | ||
70 | |||
71 | |||
72 | I. Building the meta-valleyisland BSP layer | ||
73 | =========================================== | ||
74 | |||
75 | In order to build an image with BSP support for a given release, you | ||
76 | need to download the corresponding BSP tarball from the 'Board Support | ||
77 | Package (BSP) Downloads' page of the Yocto Project website. | ||
78 | |||
79 | Having that done, and assuming you have extracted the BSP tarball contents | ||
80 | at the top-level of your Yocto build tree, you can build a valleyisland | ||
81 | image by adding the location of the meta-valleyisland layer to | ||
82 | bblayers.conf, along with the meta-intel layer itself (to access | ||
83 | common metadata shared between BSPs) e.g.: | ||
84 | |||
85 | yocto/meta-intel \ | ||
86 | yocto/meta-intel/meta-isg/meta-valleyisland \ | ||
87 | |||
88 | To enable the 32-bit Valley Island layer, add the valleyisland-32 MACHINE to local.conf: | ||
89 | |||
90 | MACHINE ?= "valleyisland-32" | ||
91 | |||
92 | To enable the 64-bit Valley Island layer, add the valleyisland-64 MACHINE to local.conf: | ||
93 | |||
94 | MACHINE ?= "valleyisland-64" | ||
95 | |||
96 | The meta-valleyisland contains support for Intel HD Audio. However, HD Audio | ||
97 | driver is dependent on gstreamer plugins and ffmpeg plugins to work properly. | ||
98 | These gstreamer plugins require license flags in order to be included in the build. | ||
99 | |||
100 | Add "commercial" in the LICENSE_FLAGS_WHITELIST in local.conf. For example: | ||
101 | |||
102 | LICENSE_FLAGS_WHITELIST = "commercial" | ||
103 | |||
104 | You should then be able to build a valleyisland image as such: | ||
105 | |||
106 | $ source oe-init-build-env | ||
107 | $ bitbake core-image-sato | ||
108 | |||
109 | At the end of a successful build, you should have a live image that | ||
110 | you can boot from a USB flash drive (see instructions on how to do | ||
111 | that below, in the section 'Booting the images from /binary'). | ||
112 | |||
113 | As an alternative to downloading the BSP tarball, you can also work | ||
114 | directly from the meta-intel git repository. For each BSP in the | ||
115 | 'meta-intel' repository, there are multiple branches, one | ||
116 | corresponding to each major release starting with 'laverne' (0.90), in | ||
117 | addition to the latest code which tracks the current master (note that | ||
118 | not all BSPs are present in every release). Instead of extracting a | ||
119 | BSP tarball at the top level of your yocto build tree, you can | ||
120 | equivalently check out the appropriate branch from the meta-intel | ||
121 | repository at the same location. | ||
122 | |||
123 | II. Booting the images in /binary | ||
124 | ================================= | ||
125 | |||
126 | This BSP contains (or builds) live images which must be converted to a | ||
127 | partitioned image format in order to boot them on the Valley Island | ||
128 | Development Kit, Bayley Bay CRB and Bakersport CRB. | ||
129 | |||
130 | You can deploy the hddimg image to a USB or SATA device. You will | ||
131 | need to know the device name on your host as well as the device name on | ||
132 | the target. Be careful with this step as using the wrong host device can | ||
133 | result in overwriting data on your host machine. | ||
134 | |||
135 | Under Linux, USB and SATA devices typically appears as /dev/sdb, | ||
136 | /dev/sdc, etc. Watching your system messages as you connect the device | ||
137 | will tell you exactly which device name is assigned to the device. | ||
138 | On the Valley Island platform, assuming only one storage device is | ||
139 | attached at boot, a USB or SATA device will be /dev/sda. | ||
140 | |||
141 | After inserting the boot media into your host machine and determining | ||
142 | your host and target device, create the image using the mkefidisk.sh | ||
143 | script, provided by poky under scripts/contrib/. Note that root | ||
144 | privileges are required. For example, using an USB device which appears | ||
145 | as /dev/sdc on the host: | ||
146 | |||
147 | $ sudo ./mkefidisk.sh /dev/sdc core-image-sato-valleyisland-32.hddimg /dev/sda | ||
148 | |||
149 | Follow the prompts on the screen to confirm the action. | ||
150 | |||
151 | Insert the device into the Valley Island platform and power on. This | ||
152 | should result in a system booted to the Sato graphical desktop. | ||
153 | |||
154 | The root password is empty on the Poky reference distribution images. | ||
155 | |||
156 | |||
157 | III. Device Notes | ||
158 | ================= | ||
159 | a. Boot Loader | ||
160 | -------------- | ||
161 | BIOS : Bayley Bay 072_011 | ||
162 | EC : KSC v3.10 for Bayley Bay/Bakersport CRB Fab3 | ||
163 | |||
164 | Required settings in BIOS | ||
165 | |||
166 | Turn off Secure-boot: | ||
167 | Device Manager -> System Setup -> Boot -> Security Boot -> Disable | ||
168 | |||
169 | Turn off LPE Audio Support: | ||
170 | Device Manager -> System Setup -> South Cluster Configuration -> | ||
171 | Audio Configuration -> LPE Audio Support -> Disable | ||
172 | |||
173 | Please use EFI mode for all boot medium types, i.e. USB disk and Hard Disk. | ||
174 | Setting in BIOS: | ||
175 | |||
176 | Choose boot medium: | ||
177 | Boot Manager -> EFI (Hard Drive/USB Device) | ||
178 | |||
179 | Save settings: | ||
180 | Boot Maintenance Manager -> Boot Options -> Change Boot Order -> | ||
181 | Change the order -> Commmit Changes and Exit | ||
182 | |||
183 | |||
184 | b. I/O drivers | ||
185 | -------------- | ||
186 | The I2C controller driver supports fast mode by default. | ||
187 | To enable standard mode, appends the arguments to kernel command line. | ||
188 | |||
189 | "i2c-designware-pci.force_std_mode=1" (PCI mode) | ||
190 | "i2c-designware-platform.force_std_mode=1" (ACPI mode) | ||
191 | |||
192 | |||
193 | c. LPIO ACPI enumeration support | ||
194 | -------------------------------- | ||
195 | Required settings in BIOS | ||
196 | |||
197 | Turn on ACPI mode | ||
198 | Device Manager -> System Setup -> South Cluster Configuration -> | ||
199 | LPSS & SCC Configuration -> LPSS & SCC Device Mode -> ACPI mode | ||
200 | |||
201 | Some LPSS devices are hidden in ACPI mode to support Windows. To enable | ||
202 | these devices, toggle the following in the BIOS Menu. | ||
203 | |||
204 | Device Manager -> System Setup -> South Cluster Configuration -> Miscellaneous | ||
205 | Configuration -> Unsupported LPSS Device and select "Unhide" | ||
206 | |||
207 | |||
208 | IV. Known Limitations | ||
209 | ===================== | ||
210 | a. I/O drivers | ||
211 | -------------- | ||
212 | HSUART: | ||
213 | |||
214 | When runninig PCI mode HSUART at baud rate 2M and above, you may observe | ||
215 | kernel message "serial8250: too much work for irq...". Most of the time it | ||
216 | won't disrupt the transfer and able to complete without data corruption. | ||
217 | However, occasionally your transfer may halt when that kernel message appear. | ||
218 | In this case, you would need to re-open the HSUART port. | ||
diff --git a/meta-isg/meta-valleyisland/README.sources b/meta-isg/meta-valleyisland/README.sources new file mode 100644 index 00000000..eef58fec --- /dev/null +++ b/meta-isg/meta-valleyisland/README.sources | |||
@@ -0,0 +1,18 @@ | |||
1 | The sources for the packages comprising the images shipped with this | ||
2 | BSP can be found at the following location: | ||
3 | |||
4 | http://downloads.yoctoproject.org/mirror/sources/ | ||
5 | |||
6 | The metadata used to generate the images shipped with this BSP, in | ||
7 | addition to the code contained in this BSP, can be found at the | ||
8 | following location: | ||
9 | |||
10 | http://downloads.yoctoproject.org/releases/yocto/yocto-1.5/poky-dora-10.0.0.tar.bz2 | ||
11 | |||
12 | The metadata used to generate the images shipped with this BSP, in | ||
13 | addition to the code contained in this BSP, can also be found at the | ||
14 | following locations: | ||
15 | |||
16 | git://git.yoctoproject.org/poky.git | ||
17 | |||
18 | git://git.yoctoproject.org/meta-intel | ||
diff --git a/meta-isg/meta-valleyisland/conf/layer.conf b/meta-isg/meta-valleyisland/conf/layer.conf new file mode 100644 index 00000000..00eea9cd --- /dev/null +++ b/meta-isg/meta-valleyisland/conf/layer.conf | |||
@@ -0,0 +1,14 @@ | |||
1 | #We have a conf and classes directory, add to BBPATH | ||
2 | BBPATH .= ":${LAYERDIR}" | ||
3 | |||
4 | # We have a recipes directory, add to BBFILES | ||
5 | BBFILES += "${LAYERDIR}/recipes-*/*/*.bb \ | ||
6 | ${LAYERDIR}/recipes-*/*/*.bbappend" | ||
7 | |||
8 | BBFILE_COLLECTIONS += "valleyisland" | ||
9 | BBFILE_PATTERN_valleyisland := "^${LAYERDIR}/" | ||
10 | BBFILE_PRIORITY_valleyisland = "6" | ||
11 | |||
12 | LAYERDEPENDS_valleyisland = "intel" | ||
13 | |||
14 | LICENSE_PATH += "${LAYERDIR}/custom-licenses" | ||