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