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>
This commit is contained in:
Tom Zanussi 2011-06-01 14:36:41 -05:00
parent e9c7bbe061
commit 53f1184c09

View File

@ -6,7 +6,7 @@ The Crown Bay platform consists of the Intel Atom Z6xx processor,
plus the Intel EG20T Platform Controller Hub (Tunnel Creek + Topcliff). plus the Intel EG20T Platform Controller Hub (Tunnel Creek + Topcliff).
It also supports the E6xx embedded on-chip graphics via the Intel It also supports the E6xx embedded on-chip graphics via the Intel
Embedded Media and Graphics Driver (EMGD) 1.5 Gold Driver. Embedded Media and Graphics Driver (EMGD) 1.6 Gold Driver.
Table of Contents Table of Contents
================= =================
@ -33,7 +33,7 @@ bblayers.conf e.g.:
The meta-crownbay layer contains support for two different machine The meta-crownbay layer contains support for two different machine
configurations. These configurations are identical except for the fact configurations. These configurations are identical except for the fact
that the one prefixed with 'crownbay' makes use of the that the one prefixed with 'crownbay' makes use of the
Intel-proprietary EMGD 1.5 graphics driver, while the one prefixed Intel-proprietary EMGD 1.6 graphics driver, while the one prefixed
with 'crownbay-noemgd' does not. with 'crownbay-noemgd' does not.
If you want to enable the layer that supports EMGD graphics add If 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
building the "crownbay-noemgd" machine). If you got the BSP from the building the "crownbay-noemgd" machine). If you got the BSP from the
'BSP Downloads' section of the Yocto website, the EMGD binaries needed 'BSP Downloads' section of the Yocto website, the EMGD binaries needed
to perform the build will already be present in the BSP, located in to perform the build will already be present in the BSP, located in
the recipes-graphics/xorg-xserver/xserver-xf86-emgd-bin directory, and the recipes-graphics/xorg-xserver/emgd-driver-bin-1.6 directory, and
you can ignore the rest of this section. you can ignore the rest of this section.
If you didn't get the BSP from the 'BSP Downloads' section of the If you didn't get the BSP from the 'BSP Downloads' section of the
Yocto website, you'll need to download the a Windows executable from Yocto website, you have two choices:
the official EMGD website, extract the binaries from it, and copy them
to the proper location in the meta-crownbay layer. - You can download a tarball containing an rpm that contains the
binaries and extract the binaries from that, and copy them to the
proper location in the meta-crownbay layer.
- You can download a Windows executable from the official EMGD
website, extract the binaries from it, and copy them to the proper
location in the meta-crownbay layer.
The following subsections describe each option in detail.
IIa Downloading and extracting the binaries using the EMGD Linux tarball
------------------------------------------------------------------------
The first step of the process is to download the EMGD 1.6 Gold Driver.
Here is the current link to the URL which it can be downloaded from:
http://edc.intel.com/Software/Downloads/EMGD/
In the Download Now tab, select:
Intel® architecture-based product: Linux Tar Ball
Operating System: MeeGo 1.0 IVI Linux (kernel 2.6.33.3, X.server 1.8.0)
That will give you a large tar file:
Lin_EMGD_1_6_RC_1922.tar
Extract the files in the tar file, which will in turn give you a
directory named IEMGD_HEAD_Linux.
The binaries are contained in an rpm file; you can extract the
binaries from the rpm file using rpm2cpio and cpio:
$ cd IEMGD_HEAD_Linux/MeeGo1.2
$ rpm2cpio emgd-bin-1922-1.6.i586.rpm > emgd-bin-1922-1.6.i586.cpio
$ mkdir extracted; cd extracted
$ cpio -idv < ../poky-image-minimal-initramfs-emenlow.cpio
Finally, you can copy the xorg-xserver binaries to the
emgd-driver-bin-1.6 directory in the meta-crownbay layer:
$ cp -a usr/lib meta-crownbay/recipes-graphics/xorg-xserver/emgd-driver-bin-1.6
You also need to copy the IEMGD License.txt file to the same directory:
$ cp IEMGD_HEAD_Linux/License/License.txt meta-crownbay/recipes/xorg-xserver/emgd-driver-bin-1.6
At this point, you should be able to build meta-crownbay images as usual.
IIb Extracting the binaries using the graphical ced application
---------------------------------------------------------------
These steps require that you run a graphical application in Windows. These steps require that you run a graphical application in Windows.
Windows 7 was used for these instructions, but it shouldn't matter Windows 7 was used for these instructions, but it shouldn't matter
which version of Windows you use. which version of Windows you use.
The first step of the process is to download the EMGD 1.5 Gold Driver. The first step of the process is to download the EMGD 1.6 Gold Driver.
Here is the current link to the URL which it can be downloaded from: Here is the current link to the URL which it can be downloaded from:
http://edc.intel.com/Software/Downloads/EMGD/ http://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)
That will give you a large zip file: That will give you a large zip file:
IEMGD_1_5_GOLD_ALL_1742.zip IEMGD_1_6_GOLD_1922.zip
Extract the files in the zip file, which will in turn give you a large Extract the files in the zip file, which will in turn give you a large
.exe file: .exe file:
IEMGD_1_5_GOLD_ALL_1742.exe IEMGD_1_6_GOLD_ALL_1922.exe
Run IEMGD_1_5_GOLD_ALL_1742.exe to install, accept licenses, etc. Run IEMGD_1_6_GOLD_ALL_1922.exe to install, accept licenses, etc.
If it says to install watcom, follow the instructions to do that. If it says to install watcom, follow the instructions to do that.
@ -157,32 +209,39 @@ system, and uncompress/untar it:
$ tar cvfz IEMGD_HEAD_Linux.tgz $ tar cvfz IEMGD_HEAD_Linux.tgz
Finally, copy Xorg-xserver binaries in the Meego1.0 driver directory The binaries are contained in an rpm file; you can extract the
to the xserver-xf86-emgd-bin directory in the meta-crownbay layer: binaries from the rpm file using rpm2cpio and cpio:
$ cp IEMGD_HEAD_Linux/MeeGo1.0/driver/Xorg-xserver-1.7.99/* meta-crownbay/recipes-graphics/xorg-xserver/xserver-xf86-emgd-bin $ cd IEMGD_HEAD_Linux/MeeGo1.2
$ rpm2cpio emgd-bin-1922-1.6.i586.rpm > emgd-bin-1922-1.6.i586.cpio
$ mkdir extracted; cd extracted
$ cpio -idv < ../poky-image-minimal-initramfs-emenlow.cpio
Finally, you can copy the xorg-xserver binaries to the
emgd-driver-bin-1.6 directory in the meta-crownbay layer:
$ cp -a usr/lib meta-crownbay/recipes-graphics/xorg-xserver/emgd-driver-bin-1.6
You also need to copy the IEMGD License.txt file to the same directory: You also need to copy the IEMGD License.txt file to the same directory:
$ cp IEMGD_HEAD_Linux/License/License.txt meta-crownbay/recipes/xorg-xserver/xserver-xf86-emgd-bin $ cp IEMGD_HEAD_Linux/License/License.txt meta-crownbay/recipes/xorg-xserver/emgd-driver-bin-1.6
At this point, you should be able to build meta-crownbay images as usual. At this point, you should be able to build meta-crownbay images as usual.
---- ----
For reference, the EMGD Driver documentation is also available at the For reference, the EMGD Driver documentation is also available at the
above link (it's also part of the installation). above link.
The specific text of the document is: The specific text of the document is:
User Guide: Intel® Embedded Media and Graphics Driver, EFI Video User Guide: Intel® Embedded Media and Graphics Driver, EFI Video
Driver, EPOG, and Video BIOS v1.5 for Windows* XP and Linux* Provides Driver, EPOG, and Video BIOS v1.6 for Windows* XP and Linux* Provides
installation requirements/procedures & describes the vbios/firmware, installation requirements/procedures & describes the vbios/firmware,
configuration options, & functionality of Intel® EMGD under Windows* & configuration options, & functionality of Intel® EMGD under Windows* &
Linux*. Refer to guide for details. Linux*. Refer to guide for details.
File Type/Size: PDF 3,340KB April 2011
Version: 008 : October 2010
II. Booting the images in /binary II. Booting the images in /binary