summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorTom Zanussi <tom.zanussi@intel.com>2011-06-01 14:36:41 -0500
committerTom Zanussi <tom.zanussi@intel.com>2011-06-01 22:20:59 -0500
commit53f1184c0965512f1f8398a81bc69d8f5f8047a0 (patch)
tree6028b14c8e2cc38f6601a4d3be3479aeab40cbbb
parente9c7bbe061e2fb5a638de02994e94d35982672e6 (diff)
downloadmeta-intel-53f1184c0965512f1f8398a81bc69d8f5f8047a0.tar.gz
meta-crownbay: update README with new build instructions.
EMGD 1.6 added a new non-clickthrough Linux tarball download; this changes the README to make use of it and also updates new directory naming, etc. Signed-off-by: Tom Zanussi <tom.zanussi@intel.com> Acked-by: Darren Hart <dvhart@linux.intel.com>
-rw-r--r--meta-crownbay/README95
1 files changed, 77 insertions, 18 deletions
diff --git a/meta-crownbay/README b/meta-crownbay/README
index bb1e0c3f..89056ed9 100644
--- a/meta-crownbay/README
+++ b/meta-crownbay/README
@@ -6,7 +6,7 @@ The Crown Bay platform consists of the Intel Atom Z6xx processor,
6plus the Intel EG20T Platform Controller Hub (Tunnel Creek + Topcliff). 6plus the Intel EG20T Platform Controller Hub (Tunnel Creek + Topcliff).
7 7
8It also supports the E6xx embedded on-chip graphics via the Intel 8It also supports the E6xx embedded on-chip graphics via the Intel
9Embedded Media and Graphics Driver (EMGD) 1.5 Gold Driver. 9Embedded Media and Graphics Driver (EMGD) 1.6 Gold Driver.
10 10
11Table of Contents 11Table of Contents
12================= 12=================
@@ -33,7 +33,7 @@ bblayers.conf e.g.:
33The meta-crownbay layer contains support for two different machine 33The meta-crownbay layer contains support for two different machine
34configurations. These configurations are identical except for the fact 34configurations. These configurations are identical except for the fact
35that the one prefixed with 'crownbay' makes use of the 35that the one prefixed with 'crownbay' makes use of the
36Intel-proprietary EMGD 1.5 graphics driver, while the one prefixed 36Intel-proprietary EMGD 1.6 graphics driver, while the one prefixed
37with 'crownbay-noemgd' does not. 37with 'crownbay-noemgd' does not.
38 38
39If you want to enable the layer that supports EMGD graphics add 39If you want to enable the layer that supports EMGD graphics add
@@ -73,19 +73,71 @@ userspace drivers when building the "crownbay" machine (but not when
73building the "crownbay-noemgd" machine). If you got the BSP from the 73building the "crownbay-noemgd" machine). If you got the BSP from the
74'BSP Downloads' section of the Yocto website, the EMGD binaries needed 74'BSP Downloads' section of the Yocto website, the EMGD binaries needed
75to perform the build will already be present in the BSP, located in 75to perform the build will already be present in the BSP, located in
76the recipes-graphics/xorg-xserver/xserver-xf86-emgd-bin directory, and 76the recipes-graphics/xorg-xserver/emgd-driver-bin-1.6 directory, and
77you can ignore the rest of this section. 77you can ignore the rest of this section.
78 78
79If you didn't get the BSP from the 'BSP Downloads' section of the 79If you didn't get the BSP from the 'BSP Downloads' section of the
80Yocto website, you'll need to download the a Windows executable from 80Yocto website, you have two choices:
81the official EMGD website, extract the binaries from it, and copy them 81
82to the proper location in the meta-crownbay layer. 82- You can download a tarball containing an rpm that contains the
83 binaries and extract the binaries from that, and copy them to the
84 proper location in the meta-crownbay layer.
85
86- You can download a Windows executable from the official EMGD
87 website, extract the binaries from it, and copy them to the proper
88 location in the meta-crownbay layer.
89
90The following subsections describe each option in detail.
91
92
93IIa Downloading and extracting the binaries using the EMGD Linux tarball
94------------------------------------------------------------------------
95
96The first step of the process is to download the EMGD 1.6 Gold Driver.
97Here is the current link to the URL which it can be downloaded from:
98
99http://edc.intel.com/Software/Downloads/EMGD/
100
101In the Download Now tab, select:
102
103Intel® architecture-based product: Linux Tar Ball
104Operating System: MeeGo 1.0 IVI Linux (kernel 2.6.33.3, X.server 1.8.0)
105
106That will give you a large tar file:
107
108Lin_EMGD_1_6_RC_1922.tar
109
110Extract the files in the tar file, which will in turn give you a
111directory named IEMGD_HEAD_Linux.
112
113The binaries are contained in an rpm file; you can extract the
114binaries from the rpm file using rpm2cpio and cpio:
115
116$ cd IEMGD_HEAD_Linux/MeeGo1.2
117$ rpm2cpio emgd-bin-1922-1.6.i586.rpm > emgd-bin-1922-1.6.i586.cpio
118$ mkdir extracted; cd extracted
119$ cpio -idv < ../poky-image-minimal-initramfs-emenlow.cpio
120
121Finally, you can copy the xorg-xserver binaries to the
122emgd-driver-bin-1.6 directory in the meta-crownbay layer:
123
124$ cp -a usr/lib meta-crownbay/recipes-graphics/xorg-xserver/emgd-driver-bin-1.6
125
126You also need to copy the IEMGD License.txt file to the same directory:
127
128$ cp IEMGD_HEAD_Linux/License/License.txt meta-crownbay/recipes/xorg-xserver/emgd-driver-bin-1.6
129
130At this point, you should be able to build meta-crownbay images as usual.
131
132
133IIb Extracting the binaries using the graphical ced application
134---------------------------------------------------------------
83 135
84These steps require that you run a graphical application in Windows. 136These steps require that you run a graphical application in Windows.
85Windows 7 was used for these instructions, but it shouldn't matter 137Windows 7 was used for these instructions, but it shouldn't matter
86which version of Windows you use. 138which version of Windows you use.
87 139
88The first step of the process is to download the EMGD 1.5 Gold Driver. 140The first step of the process is to download the EMGD 1.6 Gold Driver.
89Here is the current link to the URL which it can be downloaded from: 141Here is the current link to the URL which it can be downloaded from:
90 142
91http://edc.intel.com/Software/Downloads/EMGD/ 143http://edc.intel.com/Software/Downloads/EMGD/
@@ -97,14 +149,14 @@ Operating System: MeeGo 1.0 IVI Linux (kernel 2.6.33.3, X.server 1.8.0)
97 149
98That will give you a large zip file: 150That will give you a large zip file:
99 151
100IEMGD_1_5_GOLD_ALL_1742.zip 152IEMGD_1_6_GOLD_1922.zip
101 153
102Extract the files in the zip file, which will in turn give you a large 154Extract the files in the zip file, which will in turn give you a large
103.exe file: 155.exe file:
104 156
105IEMGD_1_5_GOLD_ALL_1742.exe 157IEMGD_1_6_GOLD_ALL_1922.exe
106 158
107Run IEMGD_1_5_GOLD_ALL_1742.exe to install, accept licenses, etc. 159Run IEMGD_1_6_GOLD_ALL_1922.exe to install, accept licenses, etc.
108 160
109If it says to install watcom, follow the instructions to do that. 161If it says to install watcom, follow the instructions to do that.
110 162
@@ -157,32 +209,39 @@ system, and uncompress/untar it:
157 209
158$ tar cvfz IEMGD_HEAD_Linux.tgz 210$ tar cvfz IEMGD_HEAD_Linux.tgz
159 211
160Finally, copy Xorg-xserver binaries in the Meego1.0 driver directory 212The binaries are contained in an rpm file; you can extract the
161to the xserver-xf86-emgd-bin directory in the meta-crownbay layer: 213binaries from the rpm file using rpm2cpio and cpio:
214
215$ cd IEMGD_HEAD_Linux/MeeGo1.2
216$ rpm2cpio emgd-bin-1922-1.6.i586.rpm > emgd-bin-1922-1.6.i586.cpio
217$ mkdir extracted; cd extracted
218$ cpio -idv < ../poky-image-minimal-initramfs-emenlow.cpio
219
220Finally, you can copy the xorg-xserver binaries to the
221emgd-driver-bin-1.6 directory in the meta-crownbay layer:
162 222
163$ cp IEMGD_HEAD_Linux/MeeGo1.0/driver/Xorg-xserver-1.7.99/* meta-crownbay/recipes-graphics/xorg-xserver/xserver-xf86-emgd-bin 223$ cp -a usr/lib meta-crownbay/recipes-graphics/xorg-xserver/emgd-driver-bin-1.6
164 224
165You also need to copy the IEMGD License.txt file to the same directory: 225You also need to copy the IEMGD License.txt file to the same directory:
166 226
167$ cp IEMGD_HEAD_Linux/License/License.txt meta-crownbay/recipes/xorg-xserver/xserver-xf86-emgd-bin 227$ cp IEMGD_HEAD_Linux/License/License.txt meta-crownbay/recipes/xorg-xserver/emgd-driver-bin-1.6
168 228
169At this point, you should be able to build meta-crownbay images as usual. 229At this point, you should be able to build meta-crownbay images as usual.
170 230
171---- 231----
172 232
173For reference, the EMGD Driver documentation is also available at the 233For reference, the EMGD Driver documentation is also available at the
174above link (it's also part of the installation). 234above link.
175 235
176The specific text of the document is: 236The specific text of the document is:
177 237
178User Guide: Intel® Embedded Media and Graphics Driver, EFI Video 238User Guide: Intel® Embedded Media and Graphics Driver, EFI Video
179Driver, EPOG, and Video BIOS v1.5 for Windows* XP and Linux* Provides 239Driver, EPOG, and Video BIOS v1.6 for Windows* XP and Linux* Provides
180installation requirements/procedures & describes the vbios/firmware, 240installation requirements/procedures & describes the vbios/firmware,
181configuration options, & functionality of Intel® EMGD under Windows* & 241configuration options, & functionality of Intel® EMGD under Windows* &
182Linux*. Refer to guide for details. 242Linux*. Refer to guide for details.
183 243
184File Type/Size: PDF 3,340KB 244April 2011
185Version: 008 : October 2010
186 245
187 246
188II. Booting the images in /binary 247II. Booting the images in /binary