summaryrefslogtreecommitdiffstats
path: root/meta-fishriver/README
diff options
context:
space:
mode:
Diffstat (limited to 'meta-fishriver/README')
-rw-r--r--meta-fishriver/README114
1 files changed, 0 insertions, 114 deletions
diff --git a/meta-fishriver/README b/meta-fishriver/README
deleted file mode 100644
index 1dd0a4ce..00000000
--- a/meta-fishriver/README
+++ /dev/null
@@ -1,114 +0,0 @@
1This README file contains information on building the meta-fishriver
2BSP layer, and booting the images contained in the /binary directory.
3Please see the corresponding sections below for details.
4
5
6Dependencies
7============
8
9This layer depends on:
10
11 URI: git://git.openembedded.org/bitbake
12 branch: master
13
14 URI: git://git.openembedded.org/openembedded-core
15 layers: meta
16 branch: master
17
18 URI: git://git.yoctoproject.org/meta-intel
19 layers: intel
20 branch: master
21
22
23Patches
24=======
25
26Please submit any patches against this BSP to the Yocto mailing list
27(yocto@yoctoproject.org) and cc: the maintainer:
28
29Maintainer: Tom Zanussi <tom.zanussi@intel.com>
30
31Please see the meta-intel/MAINTAINERS file for more details.
32
33
34Table of Contents
35=================
36
37 I. Building the meta-fishriver BSP layer
38 II. Booting the images in /binary
39
40
41I. Building the meta-fishriver BSP layer
42========================================
43
44In order to build an image with BSP support for a given release, you
45need to download the corresponding BSP tarball from the 'Board Support
46Package (BSP) Downloads' page of the Yocto Project website.
47
48Having done that, and assuming you extracted the BSP tarball contents
49at the top-level of your yocto build tree, you can build a fishriver
50image by adding the location of the meta-fishriver layer to
51bblayers.conf, along with the meta-intel layer itself (to access
52common metadata shared between BSPs) e.g.:
53
54 yocto/meta-intel \
55 yocto/meta-intel/meta-fishriver \
56
57To enable the fishriver layer, add the fishriver MACHINE to local.conf:
58
59 MACHINE ?= "fishriver"
60
61You should then be able to build a fishriver image as such:
62
63 $ source oe-init-build-env
64 $ bitbake core-image-sato
65
66At the end of a successful build, you should have a live image that
67you can boot from a USB flash drive (see instructions on how to do
68that below, in the section 'Booting the images from /binary').
69
70As an alternative to downloading the BSP tarball, you can also work
71directly from the meta-intel git repository. For each BSP in the
72'meta-intel' repository, there are multiple branches, one
73corresponding to each major release starting with 'laverne' (0.90), in
74addition to the latest code which tracks the current master (note that
75not all BSPs are present in every release). Instead of extracting a
76BSP tarball at the top level of your yocto build tree, you can
77equivalently check out the appropriate branch from the meta-intel
78repository at the same location.
79
80
81II. Booting the images in /binary
82=================================
83
84This BSP contains bootable live images, which can be used to directly
85boot Yocto off of a USB flash drive.
86
87Under Linux, insert a USB flash drive. Assuming the USB flash drive
88takes device /dev/sdf, use dd to copy the live image to it. For
89example:
90
91# dd if=core-image-sato-fishriver-20101207053738.hddimg of=/dev/sdf
92# sync
93# eject /dev/sdf
94
95This should give you a bootable USB flash device. Insert the device
96into a bootable USB socket on the target, and power on. This should
97result in a system booted to the Sato graphical desktop.
98
99If you want a terminal, use the arrows at the top of the UI to move to
100different pages of available applications, one of which is named
101'Terminal'. Clicking that should give you a root terminal.
102
103If you want to ssh into the system, you can use the root terminal to
104ifconfig the IP address and use that to ssh in. The root password is
105empty, so to log in type 'root' for the user name and hit 'Enter' at
106the Password prompt: and you should be in.
107
108----
109
110If you find you're getting corrupt images on the USB (it doesn't show
111the syslinux boot: prompt, or the boot: prompt contains strange
112characters), try doing this first:
113
114# dd if=/dev/zero of=/dev/sdf bs=1M count=512