diff options
| author | Darren Hart <dvhart@linux.intel.com> | 2012-01-23 15:46:07 -0800 |
|---|---|---|
| committer | Darren Hart <dvhart@linux.intel.com> | 2012-02-03 09:25:17 -0800 |
| commit | 6aad7407464ec9cc807916b71068fdae323bfcd1 (patch) | |
| tree | b2c72e5be10717494a98a9e6d59a64debf8f429b /meta-sys940x/README | |
| parent | c6d991cf83b3047419cc0076ea4ab1297b9cfb6d (diff) | |
| download | meta-intel-6aad7407464ec9cc807916b71068fdae323bfcd1.tar.gz | |
meta-intel: Add Inforce SYS940x BSP
The Inforce SYS940x-ECX Developer-Ready Reference Platform features:
o Intel Atom E6xx (0.6-1.6 GHz)
o Up to 1GB on-board DDR2
o Intel Platform Controller Hub EG20T
o VGA,LVDS
o HD Audio
o SD Card
o Dual SATA
o Mini-PCIe
http://www.inforcecomputing.com/SYS940X_ECX.html
Signed-off-by: Darren Hart <dvhart@linux.intel.com>
Diffstat (limited to 'meta-sys940x/README')
| -rw-r--r-- | meta-sys940x/README | 140 |
1 files changed, 140 insertions, 0 deletions
diff --git a/meta-sys940x/README b/meta-sys940x/README new file mode 100644 index 00000000..e349008f --- /dev/null +++ b/meta-sys940x/README | |||
| @@ -0,0 +1,140 @@ | |||
| 1 | This README file contains information on building the meta-sys940x BSP | ||
| 2 | layer, and booting the images contained in the /binary directory. | ||
| 3 | Please see the corresponding sections below for details. | ||
| 4 | |||
| 5 | The Inforce SYS940x platform consists of the Intel Atom E6xx | ||
| 6 | processor, plus the Intel EG20T Platform Controller Hub (Tunnel Creek | ||
| 7 | + Topcliff). | ||
| 8 | |||
| 9 | It also supports the E6xx embedded on-chip graphics via the Intel | ||
| 10 | Embedded Media and Graphics Driver (EMGD) 1.10 Driver. | ||
| 11 | |||
| 12 | |||
| 13 | Dependencies | ||
| 14 | ============ | ||
| 15 | |||
| 16 | This layer depends on: | ||
| 17 | |||
| 18 | URI: git://git.openembedded.org/bitbake | ||
| 19 | branch: master | ||
| 20 | |||
| 21 | URI: git://git.openembedded.org/openembedded-core | ||
| 22 | layers: meta | ||
| 23 | branch: master | ||
| 24 | |||
| 25 | URI: git://git.yoctoproject.org/meta-intel | ||
| 26 | layers: intel | ||
| 27 | branch: master | ||
| 28 | |||
| 29 | |||
| 30 | Patches | ||
| 31 | ======= | ||
| 32 | |||
| 33 | Please submit any patches against this BSP to the Yocto mailing list | ||
| 34 | (yocto@yoctoproject.org) and cc: the maintainer: | ||
| 35 | |||
| 36 | Maintainer: Darren Hart <dvhart@linux.intel.com> | ||
| 37 | |||
| 38 | Please see the meta-intel/MAINTAINERS file for more details. | ||
| 39 | |||
| 40 | |||
| 41 | Table of Contents | ||
| 42 | ================= | ||
| 43 | |||
| 44 | I. Building the meta-sys940x BSP layer | ||
| 45 | II. Booting the images in /binary | ||
| 46 | |||
| 47 | |||
| 48 | I. Building the meta-sys940x BSP layer | ||
| 49 | =================================== | ||
| 50 | |||
| 51 | In order to build an image with BSP support for a given release, you | ||
| 52 | need to download the corresponding BSP tarball from the 'Board Support | ||
| 53 | Package (BSP) Downloads' page of the Yocto Project website. | ||
| 54 | |||
| 55 | Having done that, and assuming you extracted the BSP tarball contents | ||
| 56 | at the top-level of your yocto build tree, you can build an sys940x image | ||
| 57 | by adding the location of the meta-sys940x layer to bblayers.conf, along | ||
| 58 | with the meta-intel layer itself (to access common metadata shared | ||
| 59 | between BSPs) e.g.: | ||
| 60 | |||
| 61 | yocto/meta-intel \ | ||
| 62 | yocto/meta-intel/meta-sys940x \ | ||
| 63 | |||
| 64 | The meta-sys940x layer contains support for two different machine | ||
| 65 | configurations. These configurations are identical except for the fact | ||
| 66 | that the one prefixed with 'sys940x' makes use of the Intel-proprietary | ||
| 67 | EMGD 1.10 graphics driver, while the one prefixed with 'sys940x-noemgd' | ||
| 68 | does not. | ||
| 69 | |||
| 70 | If you want to enable the layer that supports EMGD graphics add the | ||
| 71 | following to the local.conf file: | ||
| 72 | |||
| 73 | MACHINE ?= "sys940x" | ||
| 74 | |||
| 75 | The 'sys940x' machine includes the emgd-driver-bin package, which has a | ||
| 76 | proprietary license that must be whitelisted by adding the string | ||
| 77 | "license_emgd-driver-bin_1.10" to the LICENSE_FLAGS_WHITELIST variable | ||
| 78 | in your local.conf. For example: | ||
| 79 | |||
| 80 | LICENSE_FLAGS_WHITELIST = "license_emgd-driver-bin_1.10" | ||
| 81 | |||
| 82 | If you want to enable the layer that does not support EMGD graphics | ||
| 83 | add the following to the local.conf file: | ||
| 84 | |||
| 85 | MACHINE ?= "sys940x-noemgd" | ||
| 86 | |||
| 87 | You should then be able to build an sys940x image as such: | ||
| 88 | |||
| 89 | $ source oe-init-build-env | ||
| 90 | $ bitbake core-image-sato | ||
| 91 | |||
| 92 | At the end of a successful build, you should have a live image that | ||
| 93 | you can boot from a USB flash drive (see instructions on how to do | ||
| 94 | that below, in the section 'Booting the images from /binary'). | ||
| 95 | |||
| 96 | As an alternative to downloading the BSP tarball, you can also work | ||
| 97 | directly from the meta-intel git repository. For each BSP in the | ||
| 98 | 'meta-intel' repository, there are multiple branches, one | ||
| 99 | corresponding to each major release starting with 'laverne' (0.90), in | ||
| 100 | addition to the latest code which tracks the current master (note that | ||
| 101 | not all BSPs are present in every release). Instead of extracting a | ||
| 102 | BSP tarball at the top level of your yocto build tree, you can | ||
| 103 | equivalently check out the appropriate branch from the meta-intel | ||
| 104 | repository at the same location. | ||
| 105 | |||
| 106 | |||
| 107 | II. Booting the images in /binary | ||
| 108 | ================================= | ||
| 109 | |||
| 110 | This BSP contains bootable live images, which can be used to directly | ||
| 111 | boot Yocto off of a USB flash drive. | ||
| 112 | |||
| 113 | Under Linux, insert a USB flash drive. Assuming the USB flash drive | ||
| 114 | takes device /dev/sdf, use dd to copy the live image to it. For | ||
| 115 | example: | ||
| 116 | |||
| 117 | # dd if=core-image-sato-sys940x-20101207053738.hddimg of=/dev/sdf | ||
| 118 | # sync | ||
| 119 | # eject /dev/sdf | ||
| 120 | |||
| 121 | This should give you a bootable USB flash device. Insert the device | ||
| 122 | into a bootable USB socket on the target, and power on. This should | ||
| 123 | result in a system booted to the Sato graphical desktop. | ||
| 124 | |||
| 125 | If you want a terminal, use the arrows at the top of the UI to move to | ||
| 126 | different pages of available applications, one of which is named | ||
| 127 | 'Terminal'. Clicking that should give you a root terminal. | ||
| 128 | |||
| 129 | If you want to ssh into the system, you can use the root terminal to | ||
| 130 | ifconfig the IP address and use that to ssh in. The root password is | ||
| 131 | empty, so to log in type 'root' for the user name and hit 'Enter' at | ||
| 132 | the Password prompt: and you should be in. | ||
| 133 | |||
| 134 | ---- | ||
| 135 | |||
| 136 | If you find you're getting corrupt images on the USB (it doesn't show | ||
| 137 | the syslinux boot: prompt, or the boot: prompt contains strange | ||
| 138 | characters), try doing this first: | ||
| 139 | |||
| 140 | # dd if=/dev/zero of=/dev/sdf bs=1M count=512 | ||
