Giters

jishnair / yp-repo

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Eurotech Repo Manifests for Yocto Build System

This repository provides Repo manifests to setup the Yocto build system for the Eurotech products.

Yocto allows the creation of custom linux distributions for embedded systems including Eurotech-based systems. It is a collection of git repositories known as layers each of which provides recipes to build software packages as well as configuration information.

Repo is a tool that enables the management of many git repositories given a single manifest file. Tell repo to fetch a manifest from this repository and it will fetch the git repositories specified in the manifest and, by doing so, setup a Yocto build environment for you!

Getting Started

  1. Install Repo.

    Download the Repo script.

    $ curl https://dl-ssl.google.com/dl/googlesource/git-repo/repo > repo

    Make it executable.

    $ chmod a+x repo

    Move it on to your system path.

    $ sudo mv repo /usr/local/bin/

  2. Initialize a Repo client.

    Create an empty directory to hold your working files.

    $ mkdir yocto
$ cd yocto

    Tell Repo where to find the manifest

    $ repo init -u git://github.com/gosborne/yp-repo.git

    A successful initialization will end with a message stating that Repo is initialized in your working directory. Your client directory should now contain a .repo directory where files such as the manifest will be kept.

    Note You can use the -b switch to specify the branch of the repository to use. We develop on the guaranteed-to-break dev branch. The master branch should at least compile.

    The -m switch selects the manifest file (default is default.xml). Our default.xml on master is designed to be stable as it pins particular commits.

    To test out the bleeding edge, type:

    $ repo init -u git://github.com/gosborne/yp-repo.git -b dev

    To get back to the known stable version, type:

    $ repo init -u git://github.com/gosborne/yp-repo.git -b master

    To learn more about repo, look at http://source.android.com/source/version-control.html

  3. Fetch all the repositories.

    $ repo sync

    This can take a while, depending on the size of the manifest and your connection.

  4. Initialize the Yocto Environment.

    $ TEMPLATECONF=meta-eurotech/conf source ./poky/oe-init-build-env

    This copies default configuration information into the poky/build/conf directory and sets up some environment variables for Yocto. You may wish to edit the configuration options at this point.

  5. Build an image.

    This process downloads several gigabytes of source code and then proceeds to do an awful lot of compilation so make sure you have plenty of space (25GB minimum), and expect a day or so of build time depending on your network connection. Don't worry---it is just the first build that takes a while.

    $ bitbake zeus-default-image

    If everything goes well, you should have a compressed root filesystem tarball as well as kernel and bootloader binaries available in your work/deploy directory. If you run into problems, the most likely candidate is missing packages. Check out http://www.yoctoproject.org/docs/current/yocto-project-qs/yocto-project-qs.html#resources for the list of required packagaes for operating system. Also, take a look to be sure your operating system is supported: https://wiki.yoctoproject.org/wiki/Distribution_Support

Staying Up to Date

To pick up the latest changes for all source repositories, run:

$ repo sync

Enter the Yocto environment:

$ source poky/oe-init-build-env

If you forget to setup these environment variables prior to bitbaking,
your OS will complain that it can't find bitbake on the path.  Don't try
to install bitbake using a package manager, just run the command.

You can then rebuild as before:

$ bitbake zeus-default-image

Starting from Fresh

So it is borked. You're not really sure why. But it doesn't work any more.

There are several degrees of starting fresh.

  1. clean a package: bitbake -c cleansstate
  2. re-download package: bitbake -c cleanall
  3. destroy everything but downloads: rm -rf build (or whereever your sstate and work directories are)
  4. destroy it all (not recommended): rm -rf build && rm -rf sources There are several degrees of starting fresh.

Customize

Sooner or later, you'll want to customize some aspect of the image either adding more packages, picking up some upstream patches, or tweaking your kernel. To this, you'll want to customize the Repo manifest to point at different repositories and branches or pull in additional meta-layers.

Clone this repository (or fork it on github):

$ git clone git://github.com/gosborne/yp-repo.git

Make your changes (and contribute them back if they are generally useful :) ), and then re-initialize your repo client

$ repo init -u <file:///path/to/your/git/repository.git>

About