summaryrefslogtreecommitdiffstats
path: root/meta-fri2/README
diff options
context:
space:
mode:
authorTom Zanussi <tom.zanussi@intel.com>2012-01-24 11:44:58 -0600
committerTom Zanussi <tom.zanussi@intel.com>2012-01-30 14:58:54 -0600
commit5d5821e2e924cbd692b60350eb0ef4c7d941891e (patch)
treeb4feb9433e5f09e78faa0db43c323633ec47020a /meta-fri2/README
parentfd14750345ef7e4a543b9da18000de9a18e3439a (diff)
downloadmeta-intel-5d5821e2e924cbd692b60350eb0ef4c7d941891e.tar.gz
meta-fri2: update README
The new emgd-driver-bin_1.10 recipe no longer requires manually extracting and installing emgd binaries, so remove the section that deals with that. It does require a new LICENSE_FLAGS_WHITELIST entry in local.conf, so add instructions detailing that. Signed-off-by: Tom Zanussi <tom.zanussi@intel.com>
Diffstat (limited to 'meta-fri2/README')
-rw-r--r--meta-fri2/README86
1 files changed, 12 insertions, 74 deletions
diff --git a/meta-fri2/README b/meta-fri2/README
index 2f8a5a4f..df2fa87a 100644
--- a/meta-fri2/README
+++ b/meta-fri2/README
@@ -8,7 +8,7 @@ processor, plus the Intel EG20T Platform Controller Hub (Tunnel Creek
8and various other machine-to-machine (m2m) capabilities. 8and various other machine-to-machine (m2m) capabilities.
9 9
10It also supports the E6xx embedded on-chip graphics via the Intel 10It also supports the E6xx embedded on-chip graphics via the Intel
11Embedded Media and Graphics Driver (EMGD) 1.8 Driver. 11Embedded Media and Graphics Driver (EMGD) 1.10 Driver.
12 12
13 13
14Dependencies 14Dependencies
@@ -43,8 +43,7 @@ Table of Contents
43================= 43=================
44 44
45 I. Building the meta-fri2 BSP layer 45 I. Building the meta-fri2 BSP layer
46 II. Special notes for building the meta-fri2 BSP layer 46 II. Booting the images in /binary
47III. Booting the images in /binary
48 47
49 48
50I. Building the meta-fri2 BSP layer 49I. Building the meta-fri2 BSP layer
@@ -66,7 +65,7 @@ between BSPs) e.g.:
66The meta-fri2 layer contains support for two different machine 65The meta-fri2 layer contains support for two different machine
67configurations. These configurations are identical except for the fact 66configurations. These configurations are identical except for the fact
68that the one prefixed with 'fri2' makes use of the Intel-proprietary 67that the one prefixed with 'fri2' makes use of the Intel-proprietary
69EMGD 1.8 graphics driver, while the one prefixed with 'fri2-noemgd' 68EMGD 1.10 graphics driver, while the one prefixed with 'fri2-noemgd'
70does not. 69does not.
71 70
72If you want to enable the layer that supports EMGD graphics add the 71If you want to enable the layer that supports EMGD graphics add the
@@ -74,6 +73,13 @@ following to the local.conf file:
74 73
75 MACHINE ?= "fri2" 74 MACHINE ?= "fri2"
76 75
76The 'fri2' machine includes the emgd-driver-bin package, which has a
77proprietary license that must be whitelisted by adding the string
78"license_emgd-driver-bin_1.10" to the LICENSE_FLAGS_WHITELIST variable
79in your local.conf. For example:
80
81 LICENSE_FLAGS_WHITELIST = "license_emgd-driver-bin_1.10"
82
77If you want to enable the layer that does not support EMGD graphics 83If you want to enable the layer that does not support EMGD graphics
78add the following to the local.conf file: 84add the following to the local.conf file:
79 85
@@ -99,76 +105,8 @@ equivalently check out the appropriate branch from the meta-intel
99repository at the same location. 105repository at the same location.
100 106
101 107
102II. Special notes for building the meta-fri2 BSP layer 108II. Booting the images in /binary
103====================================================== 109=================================
104
105The meta-fri2 layer makes use of the proprietary Intel EMGD userspace
106drivers when building the "fri2" machine (but not when building the
107"fri2-noemgd" machine). If you got the BSP from the 'BSP Downloads'
108section of the Yocto website, the EMGD binaries needed to perform the
109build will already be present in the BSP, located in the
110meta-intel/common/recipes-graphics/xorg-xserver/emgd-driver-bin-1.8
111directory, and you can ignore the rest of this section.
112
113If you didn't get the BSP from the 'BSP Downloads' section of the
114Yocto website, you can download a tarball containing an rpm that
115contains the binaries and extract the binaries from that, and copy
116them to the proper location in the meta-fri2 layer.
117
118The following subsection describes that process in detail.
119
120
121Downloading and extracting the binaries using the EMGD Linux tarball
122--------------------------------------------------------------------
123
124The first step of the process is to download the EMGD 1.8 Driver.
125Here is the current link to the URL from which it can be downloaded:
126
127http://edc.intel.com/Software/Downloads/EMGD/
128
129In the Download Now tab, select:
130
131IntelĀ® architecture-based product: Linux Tar Ball
132Operating System: MeeGo* 1.2 IVI Linux* (kernel 2.6.37, X.server 1.9, Mesa 7.9)
133
134That will give you a large .tgz file:
135
136Lin_EMGD_1_8_RC_2032.tgz
137
138Extract the files in the tar file, which will in turn give you a
139directory named IEMGD_HEAD_Linux.
140
141The binaries are contained in an rpm file; you can extract the
142binaries from the rpm file using rpm2cpio and cpio:
143
144$ cd IEMGD_HEAD_Linux/MeeGo1.2
145$ rpm2cpio emgd-bin-2032-1.6.i586.rpm > emgd-bin-2032-1.6.i586.cpio
146$ mkdir extracted; cd extracted
147$ cpio -idv < ../emgd-bin-2032-1.6.i586.cpio
148
149Finally, you can copy the xorg-xserver binaries to the
150emgd-driver-bin-1.8 directory in meta-intel/common:
151
152$ cp -a usr/lib meta-intel/common/recipes-graphics/xorg-xserver/emgd-driver-bin-1.8
153
154You also need to copy the IEMGD License.txt file to the same directory:
155
156$ cp IEMGD_HEAD_Linux/License/License.txt meta-intel/common/recipes/xorg-xserver/emgd-driver-bin-1.8
157
158Additionally, you should remove the following unused file from the
159emgd binaries in order to avoid a packaging error at build-time:
160
161$ rm meta-intel/common/recipes-graphics/xorg-xserver/emgd-driver-bin-1.8/lib/dri/emgd_drv_video.so
162
163Finally, you need to remove the following file:
164
165$ rm meta-intel/common/recipes-graphics/xorg-xserver/emgd-driver-bin-1.8/lib/dri/emgd_drv_video.so
166
167At this point, you should be able to build meta-fri2 images as usual.
168
169
170III. Booting the images in /binary
171==================================
172 110
173This BSP contains bootable live images, which can be used to directly 111This BSP contains bootable live images, which can be used to directly
174boot Yocto off of a USB flash drive. 112boot Yocto off of a USB flash drive.