diff options
| author | Tom Zanussi <tom.zanussi@intel.com> | 2012-01-24 11:44:58 -0600 |
|---|---|---|
| committer | Tom Zanussi <tom.zanussi@intel.com> | 2012-01-30 14:58:54 -0600 |
| commit | 5d5821e2e924cbd692b60350eb0ef4c7d941891e (patch) | |
| tree | b4feb9433e5f09e78faa0db43c323633ec47020a /meta-fri2/README | |
| parent | fd14750345ef7e4a543b9da18000de9a18e3439a (diff) | |
| download | meta-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/README | 86 |
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 | |||
| 8 | and various other machine-to-machine (m2m) capabilities. | 8 | and various other machine-to-machine (m2m) capabilities. |
| 9 | 9 | ||
| 10 | It also supports the E6xx embedded on-chip graphics via the Intel | 10 | It also supports the E6xx embedded on-chip graphics via the Intel |
| 11 | Embedded Media and Graphics Driver (EMGD) 1.8 Driver. | 11 | Embedded Media and Graphics Driver (EMGD) 1.10 Driver. |
| 12 | 12 | ||
| 13 | 13 | ||
| 14 | Dependencies | 14 | Dependencies |
| @@ -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 |
| 47 | III. Booting the images in /binary | ||
| 48 | 47 | ||
| 49 | 48 | ||
| 50 | I. Building the meta-fri2 BSP layer | 49 | I. Building the meta-fri2 BSP layer |
| @@ -66,7 +65,7 @@ between BSPs) e.g.: | |||
| 66 | The meta-fri2 layer contains support for two different machine | 65 | The meta-fri2 layer contains support for two different machine |
| 67 | configurations. These configurations are identical except for the fact | 66 | configurations. These configurations are identical except for the fact |
| 68 | that the one prefixed with 'fri2' makes use of the Intel-proprietary | 67 | that the one prefixed with 'fri2' makes use of the Intel-proprietary |
| 69 | EMGD 1.8 graphics driver, while the one prefixed with 'fri2-noemgd' | 68 | EMGD 1.10 graphics driver, while the one prefixed with 'fri2-noemgd' |
| 70 | does not. | 69 | does not. |
| 71 | 70 | ||
| 72 | If you want to enable the layer that supports EMGD graphics add the | 71 | If 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 | ||
| 76 | The 'fri2' machine includes the emgd-driver-bin package, which has a | ||
| 77 | proprietary license that must be whitelisted by adding the string | ||
| 78 | "license_emgd-driver-bin_1.10" to the LICENSE_FLAGS_WHITELIST variable | ||
| 79 | in your local.conf. For example: | ||
| 80 | |||
| 81 | LICENSE_FLAGS_WHITELIST = "license_emgd-driver-bin_1.10" | ||
| 82 | |||
| 77 | If you want to enable the layer that does not support EMGD graphics | 83 | If you want to enable the layer that does not support EMGD graphics |
| 78 | add the following to the local.conf file: | 84 | add the following to the local.conf file: |
| 79 | 85 | ||
| @@ -99,76 +105,8 @@ equivalently check out the appropriate branch from the meta-intel | |||
| 99 | repository at the same location. | 105 | repository at the same location. |
| 100 | 106 | ||
| 101 | 107 | ||
| 102 | II. Special notes for building the meta-fri2 BSP layer | 108 | II. Booting the images in /binary |
| 103 | ====================================================== | 109 | ================================= |
| 104 | |||
| 105 | The meta-fri2 layer makes use of the proprietary Intel EMGD userspace | ||
| 106 | drivers when building the "fri2" machine (but not when building the | ||
| 107 | "fri2-noemgd" machine). If you got the BSP from the 'BSP Downloads' | ||
| 108 | section of the Yocto website, the EMGD binaries needed to perform the | ||
| 109 | build will already be present in the BSP, located in the | ||
| 110 | meta-intel/common/recipes-graphics/xorg-xserver/emgd-driver-bin-1.8 | ||
| 111 | directory, and you can ignore the rest of this section. | ||
| 112 | |||
| 113 | If you didn't get the BSP from the 'BSP Downloads' section of the | ||
| 114 | Yocto website, you can download a tarball containing an rpm that | ||
| 115 | contains the binaries and extract the binaries from that, and copy | ||
| 116 | them to the proper location in the meta-fri2 layer. | ||
| 117 | |||
| 118 | The following subsection describes that process in detail. | ||
| 119 | |||
| 120 | |||
| 121 | Downloading and extracting the binaries using the EMGD Linux tarball | ||
| 122 | -------------------------------------------------------------------- | ||
| 123 | |||
| 124 | The first step of the process is to download the EMGD 1.8 Driver. | ||
| 125 | Here is the current link to the URL from which it can be downloaded: | ||
| 126 | |||
| 127 | http://edc.intel.com/Software/Downloads/EMGD/ | ||
| 128 | |||
| 129 | In the Download Now tab, select: | ||
| 130 | |||
| 131 | IntelĀ® architecture-based product: Linux Tar Ball | ||
| 132 | Operating System: MeeGo* 1.2 IVI Linux* (kernel 2.6.37, X.server 1.9, Mesa 7.9) | ||
| 133 | |||
| 134 | That will give you a large .tgz file: | ||
| 135 | |||
| 136 | Lin_EMGD_1_8_RC_2032.tgz | ||
| 137 | |||
| 138 | Extract the files in the tar file, which will in turn give you a | ||
| 139 | directory named IEMGD_HEAD_Linux. | ||
| 140 | |||
| 141 | The binaries are contained in an rpm file; you can extract the | ||
| 142 | binaries 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 | |||
| 149 | Finally, you can copy the xorg-xserver binaries to the | ||
| 150 | emgd-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 | |||
| 154 | You 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 | |||
| 158 | Additionally, you should remove the following unused file from the | ||
| 159 | emgd 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 | |||
| 163 | Finally, 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 | |||
| 167 | At this point, you should be able to build meta-fri2 images as usual. | ||
| 168 | |||
| 169 | |||
| 170 | III. Booting the images in /binary | ||
| 171 | ================================== | ||
| 172 | 110 | ||
| 173 | This BSP contains bootable live images, which can be used to directly | 111 | This BSP contains bootable live images, which can be used to directly |
| 174 | boot Yocto off of a USB flash drive. | 112 | boot Yocto off of a USB flash drive. |
