summaryrefslogtreecommitdiffstats
path: root/meta-isg
diff options
context:
space:
mode:
authorWu Chia Chuan <chia.chuan.wu@intel.com>2015-10-02 11:28:37 (GMT)
committerSaul Wold <sgw@linux.intel.com>2015-10-02 15:15:43 (GMT)
commite5fcf9e76dca11394a731a5512187a3261897111 (patch)
tree7007717d932f033ba77cabff13f747b497a33660 /meta-isg
parent0d73402b4f350b8a11458c8b1e22ab927e0a015f (diff)
downloadmeta-intel-e5fcf9e76dca11394a731a5512187a3261897111.tar.gz
meta-crystalforest: relocate meta-crystalforest layer into meta-isg layer
This is in support of BSP consolidation of all Intel platforms in to meta-isg common layer. The "MAINTAINERS file" and "meta-isg/MAINTAINERS file" are updated to reflect the changed. Signed-off-by: Wu Chia Chuan <chia.chuan.wu@intel.com> Signed-off-by: Saul Wold <sgw@linux.intel.com>
Diffstat (limited to 'meta-isg')
-rw-r--r--meta-isg/MAINTAINERS4
-rw-r--r--meta-isg/meta-crystalforest/COPYING.MIT17
-rw-r--r--meta-isg/meta-crystalforest/README240
-rw-r--r--meta-isg/meta-crystalforest/README.sources17
-rw-r--r--meta-isg/meta-crystalforest/binary/.gitignore0
-rw-r--r--meta-isg/meta-crystalforest/conf/layer.conf12
-rw-r--r--meta-isg/meta-crystalforest/conf/machine/crystalforest.conf40
-rw-r--r--meta-isg/meta-crystalforest/recipes-bsp/formfactor/formfactor/crystalforest-gladden/machconfig3
-rw-r--r--meta-isg/meta-crystalforest/recipes-bsp/formfactor/formfactor/crystalforest-server/machconfig3
-rw-r--r--meta-isg/meta-crystalforest/recipes-bsp/formfactor/formfactor_0.0.bbappend1
10 files changed, 337 insertions, 0 deletions
diff --git a/meta-isg/MAINTAINERS b/meta-isg/MAINTAINERS
index 98b8a5e..36cef64 100644
--- a/meta-isg/MAINTAINERS
+++ b/meta-isg/MAINTAINERS
@@ -49,3 +49,7 @@ F: meta-mohonpeak/
49VALLEYISLAND 49VALLEYISLAND
50M: Chang Rebecca Swee Fun <rebecca.swee.fun.chang@intel.com> 50M: Chang Rebecca Swee Fun <rebecca.swee.fun.chang@intel.com>
51F: meta-valleyisland/ 51F: meta-valleyisland/
52
53CRYSTALFOREST
54M: Wu Chia Chuan <chia.chuan.wu@intel.com>
55F: meta-crystalforest/
diff --git a/meta-isg/meta-crystalforest/COPYING.MIT b/meta-isg/meta-crystalforest/COPYING.MIT
new file mode 100644
index 0000000..fb950dc
--- /dev/null
+++ b/meta-isg/meta-crystalforest/COPYING.MIT
@@ -0,0 +1,17 @@
1Permission is hereby granted, free of charge, to any person obtaining a copy
2of this software and associated documentation files (the "Software"), to deal
3in the Software without restriction, including without limitation the rights
4to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
5copies of the Software, and to permit persons to whom the Software is
6furnished to do so, subject to the following conditions:
7
8The above copyright notice and this permission notice shall be included in
9all copies or substantial portions of the Software.
10
11THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
12IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
13FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
14AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
15LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
16OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
17THE SOFTWARE.
diff --git a/meta-isg/meta-crystalforest/README b/meta-isg/meta-crystalforest/README
new file mode 100644
index 0000000..4878105
--- /dev/null
+++ b/meta-isg/meta-crystalforest/README
@@ -0,0 +1,240 @@
1This README file contains information on building the meta-crystalforest
2BSP layer, and booting the images contained in the /binary directory.
3Please see the corresponding sections below for details.
4
5Overview of Intel Communication Product Offering
6------------------------------------------------
7
8The following platforms are supported on meta-intel dizzy branch ONLY:
9
10Crystal Forest/Server - Shumway reference platform configurations:
11processor: Intel Xeon E5-2600/E5-2400 (Sandy Bridge-based) or
12 Intel Xeon E5-2600v2/E5-2400v2 (Ivy Bridge-based)
13chipset: Intel Communication Chipset 8900-8920 Series (Cave Creek)
14url: http://www.intel.com/p/en_US/embedded/hwsw/hardware/xeon-e5-89xx/overview
15
16Crystal Forest/Gladden - Stargo reference platform configurations:
17processor: Intel Xeon E3-1125C/E3-1105C (Sandy Bridge-based) or
18 Intel Xeon E3-1125v2/E3-1105v2 (Ivy Bridge-based)
19chipset: Intel Communication Chipset 8900-8920 Series (Cave Creek)
20url: http://www.intel.com/p/en_US/embedded/hwsw/hardware/xeon-core-pentium-celeron-89xx/overview
21
22Highland Forest (Crystal Forest/Server Refresh) - Shumway reference platform configurations:
23processor: Intel Xeon E5-2600v2/E5-2400v2 (Ivy Bridge-based)
24chipset: Intel Communication Chipset 8925-8955 Series (Coleto Creek)
25url: https://www-ssl.intel.com/content/www/us/en/intelligent-systems/crystal-forest-server/xeon-e5-v2-89xx-chipset-ibd.html
26
27The following platform is supported on meta-intel fido branch and beyond.
28
29River Forest - Long Brook reference platform configurations:
30processor: Intel Xeon E5-2600v3/E5-2400v3 (Haswell EP-based)
31chipset: Intel Communication Chipset 8925-8955 Series (Coleto Creek)
32url: https://www-ssl.intel.com/content/www/my/en/embedded/products/river-forest/overview.html?wapkw=coleto
33
34All above four platforms use PCIe-based Matrox graphics card for display.
35
36More Information on all IntelĀ® embedded platforms can be found here:
37
38 http://www.intel.com/p/en_US/embedded/hwsw/hardware
39
40
41Yocto Project Compatible
42========================
43
44This BSP is compatible with the Yocto Project as per the requirements
45listed here:
46
47 https://www.yoctoproject.org/webform/yocto-project-compatible-registration
48
49Dependencies
50============
51
52This layer depends on:
53
54 URI: git://git.openembedded.org/bitbake
55 branch: master
56
57 URI: git://git.openembedded.org/openembedded-core
58 layers: meta
59 branch: master
60
61 URI: git://git.yoctoproject.org/meta-intel
62 layers: intel
63 branch: master
64
65
66Patches
67=======
68
69Please submit any patches against this BSP to the meta-intel mailing
70list (meta-intel@yoctoproject.org) and cc: the maintainer:
71
72Maintainer: Wu Chia Chuan <chia.chuan.wu@intel.com>
73
74Please see the meta-isg/MAINTAINERS file for more details.
75
76
77Table of Contents
78=================
79
80 I. Building the meta-crystalforest BSP layer
81 II. Booting the images in /binary
82III. Device Notes
83 a. Boot Loader
84 b. I/O drivers
85IV. Enabling Intel DPDK and QuickAssist Technology
86
87I. Building the meta-crystalforest BSP layer
88=======================================
89
90In order to build an image with BSP support for a given release, you
91need to download the corresponding BSP tarball from the 'Board Support
92Package (BSP) Downloads' page of the Yocto Project website.
93
94Having done that, and assuming you extracted the BSP tarball contents
95at the top-level of your yocto build tree, you can build a crystalforest
96image by adding the location of the meta-crystalforest layer to
97bblayers.conf, along with the meta-intel layer itself (to access
98common metadata shared between BSPs) e.g.:
99
100 yocto/meta-intel \
101 yocto/meta-intel/meta-isg/meta-crystalforest \
102
103Crystal Forest layer is meant for building both Crystal Forest Gladden
104and Crystal Forest Server platforms. By enabling Crystal Forest layer,
105the image you build is able to boot on both supported platforms.
106
107To enable the Crystal Forest layer, add the Crystal Forest MACHINE to
108build/local.conf:
109
110 MACHINE ?= "crystalforest"
111
112You should then be able to build a crystalforest image as such:
113
114 $ source oe-init-build-env
115 $ bitbake core-image-sato
116
117At the end of a successful build, you should have a live image that
118you can boot from a USB flash drive (see instructions on how to do
119that below, in the section 'Booting the images from /binary').
120
121The live image is located within build/tmp/deploy/images/<machine> folder.
122
123As an alternative to downloading the BSP tarball, you can also work
124directly from the meta-intel git repository. For each BSP in the
125'meta-intel' repository, there are multiple branches, one
126corresponding to each major release starting with 'laverne' (0.90), in
127addition to the latest code which tracks the current master (note that
128not all BSPs are present in every release). Instead of extracting a
129BSP tarball at the top level of your yocto build tree, you can
130equivalently check out the appropriate branch from the meta-intel
131repository at the same location.
132
133
134II. Booting the images in /binary
135=================================
136
137This BSP contains bootable live images, which can be used to directly
138boot Yocto off of a USB flash drive.
139
140You can deploy the hddimg image to a USB or SATA device. You will
141need to know the device name on your host as well as the device name on
142the target. Be careful with this step as using the wrong host device can
143result in overwriting data on your host machine.
144
145Under Linux, USB and SATA devices typically appears as /dev/sdb,
146/dev/sdc, etc. Watching your system messages as you connect the device
147will tell you exactly which device name is assigned to the device.
148On the Valley Island platform, assuming only one storage device is
149attached at boot, a USB or SATA device will be /dev/sda.
150
151After inserting the boot media into your host machine and determining
152your host and target device, create the image using the mkefidisk.sh
153script, provided by poky under scripts/contrib/. Note that root
154privileges are required. For example, using an USB device which appears
155as /dev/sdc on the host:
156
157$ sudo ./mkefidisk.sh /dev/sdc core-image-sato-<machine>.hddimg /dev/sda
158
159Follow the prompts on the screen to confirm the action.
160
161This should give you a bootable USB flash device. Insert the device
162into a bootable USB socket on the target, and power on. This should
163result in a system booted to the Sato graphical desktop.
164
165If you want a terminal, use the arrows at the top of the UI to move to
166different pages of available applications, one of which is named
167'Terminal'. Clicking that should give you a root terminal.
168
169If you want to ssh into the system, you can use the root terminal to
170ifconfig the IP address and use that to ssh in. The root password is
171empty, so to log in type 'root' for the user name and hit 'Enter' at
172the Password prompt: and you should be in.
173
174III. Device Notes
175=================
176
177a. Boot Loader
178--------------
179- Support BIOS version at Shumway board (HighlandForest/CrystalForest-server):
180 CCFRCLC0.019
181
182- Support BIOS version at Stargo board ( CrystalForest-Gladden ):
183 CIVGCCK1.86C.0003.P00
184
185- Support BIOS version at Long Brook board (RiverForest)
186 GRNDCRB1.86B.0022.R01.i02.1405151000
187
188b. I/O drivers
189--------------
190-Support Matrox graphic card.
191-Support SATA, USB Host v2.0
192-Supported I/O devices (APIC, RTC, SPI, UART, I2C, LPS, SMBus i801,
193 WDT, and HPET)
194
195
196IV. Enabling Intel DPDK and QuickAssist Technology
197===================================================
198
199DPDK recipe: meta-intel/meta-isg/common/recipes-extended/dpdk
200QAT recipe: meta-intel/meta-isg/common/recipes-extended/qat
201QAT-enable zlib recipe: meta-intel/meta-isg/common/recipes-extended/zlib-qat
202
203Note:
204qat16 recipe is meant for platform with Coleto Creek chipset.
205qat15 recipe is meant for platform with Cave Creek chipset.
206
207conf/machine/crystalforest.conf is the common machine configuration
208to support Crystal Forest/server, Crystal Forest/gladden, Highland Forest and
209River Forest. In order to generate the right binary for these platforms which
210have different QAT technology, user could change the default config accordingly
211within crystalforest.conf as below:
212
213For Coleto Creek chipset:
214PREFERRED_PROVIDER_virtual/qat ?= "qat16"
215
216For Cave Creek chipset:
217PREFERRED_PROVIDER_virtual/qat ?= "qat15"
218
219Another option and preferred approach for above setting is to override
220configuration under build/conf/local.conf as follow:
221
222For Coleto Creek chipset:
223PREFERRED_PROVIDER_virtual/qat = "qat16"
224
225For Cave Creek chipset:
226PREFERRED_PROVIDER_virtual/qat = "qat15"
227
228By default, the machine configuration does not assume that the above
229ingredients are pre-installed onto the BSP. Developers are required
230to either use smart tool to install those software packages or
231configure IMAGE_INSTALL under build/conf/local.conf, for example.
232
233For Coleto Creek chipset:
234IMAGE_INSTALL += "dpdk qat16 zlib-qat"
235
236For Cavecreek Creek chipset:
237IMAGE_INSTALL += "dpdk qat15 zlib-qat"
238
239The list of packages can be searched under tmp/deploy/<package-type>
240folder.
diff --git a/meta-isg/meta-crystalforest/README.sources b/meta-isg/meta-crystalforest/README.sources
new file mode 100644
index 0000000..0d4d849
--- /dev/null
+++ b/meta-isg/meta-crystalforest/README.sources
@@ -0,0 +1,17 @@
1The sources for the packages comprising the images shipped with this
2BSP can be found at the following location:
3
4http://downloads.yoctoproject.org/mirror/sources/
5
6The metadata used to generate the images shipped with this BSP, in
7addition to the code contained in this BSP, can be found at the
8following location:
9
10http://downloads.yoctoproject.org/releases/yocto/yocto-1.3/poky-danny-8.0.tar.bz2
11
12The metadata used to generate the images shipped with this BSP, in
13addition to the code contained in this BSP, can also be found at the
14following locations:
15
16git://git.yoctoproject.org/poky.git
17git://git.yoctoproject.org/meta-intel
diff --git a/meta-isg/meta-crystalforest/binary/.gitignore b/meta-isg/meta-crystalforest/binary/.gitignore
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/meta-isg/meta-crystalforest/binary/.gitignore
diff --git a/meta-isg/meta-crystalforest/conf/layer.conf b/meta-isg/meta-crystalforest/conf/layer.conf
new file mode 100644
index 0000000..daa2ba7
--- /dev/null
+++ b/meta-isg/meta-crystalforest/conf/layer.conf
@@ -0,0 +1,12 @@
1# We have a conf and classes directory, add to BBPATH
2BBPATH .= ":${LAYERDIR}"
3
4# We have a recipes directory, add to BBFILES
5BBFILES += "${LAYERDIR}/recipes-*/*/*.bb \
6 ${LAYERDIR}/recipes-*/*/*.bbappend"
7
8BBFILE_COLLECTIONS += "crystalforest"
9BBFILE_PATTERN_crystalforest := "^${LAYERDIR}/"
10BBFILE_PRIORITY_crystalforest = "6"
11
12LAYERDEPENDS_crystalforest = "intel"
diff --git a/meta-isg/meta-crystalforest/conf/machine/crystalforest.conf b/meta-isg/meta-crystalforest/conf/machine/crystalforest.conf
new file mode 100644
index 0000000..7716e56
--- /dev/null
+++ b/meta-isg/meta-crystalforest/conf/machine/crystalforest.conf
@@ -0,0 +1,40 @@
1#@TYPE: Machine
2#@NAME: crystalforest
3
4#@WEBTITLE: Intel Xeon E3-1125C/E3-1105C (Formerly Sandy Bridge-Gladden)
5#Processors with Intel Communication Chipset 89xx (Crystal Forest Gladden Platform)
6
7#@DESCRIPTION: Machine configuration for Crystal Forest Gladden systems
8#for Smaller Form Factor Communication Infrastructure
9# i.e. Xeon E3-1125C/E3-1105C + Intel 89xx communication Chipset
10
11#@WEBTITLE: Intel Xeon E5-2600 and E5-2400 (Formerly Sandy Bridge-EP/EN)
12#Processors with Intel Communication Chipset 89xx (Crystal Forest Server Platform)
13
14#@DESCRIPTION: Machine configuration for Crystal Forest Server systems
15#for Large-Scale Communications Infrastructure
16# i.e. Xeon E5-2600 and E5-2400 + Intel 89xx Communication Chipsets
17
18PREFERRED_PROVIDER_virtual/kernel ?= "linux-yocto"
19PREFERRED_VERSION_linux-yocto ?= "3.14%"
20
21require conf/machine/include/intel-corei7-64-common.inc
22require conf/machine/include/intel-common-pkgarch.inc
23require conf/machine/include/meta-intel.inc
24
25XSERVER ?= "${XSERVER_X86_BASE} \
26 ${XSERVER_X86_EXT} \
27 ${XSERVER_X86_MATROX_MGA} \
28 "
29MACHINE_EXTRA_RRECOMMENDS += "calgary-corpus \
30 canterbury-corpus \
31 "
32#This Kernel Option is required for Intel Quick Assist Technology Software.
33APPEND += "acpi_enforce_resources=lax"
34
35#Uncomment the below Kernel Option if Virtualization is not needed.
36#APPEND += "intel_iommu=off"
37
38SYSLINUX_OPTS = "serial 0 115200"
39SERIAL_CONSOLE = "115200 ttyS0"
40APPEND += "console=ttyS0,115200 console=tty0"
diff --git a/meta-isg/meta-crystalforest/recipes-bsp/formfactor/formfactor/crystalforest-gladden/machconfig b/meta-isg/meta-crystalforest/recipes-bsp/formfactor/formfactor/crystalforest-gladden/machconfig
new file mode 100644
index 0000000..ffce012
--- /dev/null
+++ b/meta-isg/meta-crystalforest/recipes-bsp/formfactor/formfactor/crystalforest-gladden/machconfig
@@ -0,0 +1,3 @@
1# Assume a USB mouse and keyboard are connected
2HAVE_TOUCHSCREEN=0
3HAVE_KEYBOARD=1
diff --git a/meta-isg/meta-crystalforest/recipes-bsp/formfactor/formfactor/crystalforest-server/machconfig b/meta-isg/meta-crystalforest/recipes-bsp/formfactor/formfactor/crystalforest-server/machconfig
new file mode 100644
index 0000000..ffce012
--- /dev/null
+++ b/meta-isg/meta-crystalforest/recipes-bsp/formfactor/formfactor/crystalforest-server/machconfig
@@ -0,0 +1,3 @@
1# Assume a USB mouse and keyboard are connected
2HAVE_TOUCHSCREEN=0
3HAVE_KEYBOARD=1
diff --git a/meta-isg/meta-crystalforest/recipes-bsp/formfactor/formfactor_0.0.bbappend b/meta-isg/meta-crystalforest/recipes-bsp/formfactor/formfactor_0.0.bbappend
new file mode 100644
index 0000000..72d991c
--- /dev/null
+++ b/meta-isg/meta-crystalforest/recipes-bsp/formfactor/formfactor_0.0.bbappend
@@ -0,0 +1 @@
FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:"