Angstrom development environment setup using Android repo tool
Latest commit e16875f Oct 29, 2016 @kraj kraj Set DISTRO with ?=
Make way for Iota distro

Change-Id: Icc5b27c32d5c2f5386658e956a2d025767d3749d
Signed-off-by: Khem Raj <>


Ångström Repo manifest repository

These are the setup scripts for the Ångström buildsystem. If you want to (re)build packages or images for Ångström, this is the thing to use. The Ångström buildsystem is using various components from the Yocto Project, most importantly the Openembedded buildsystem, the bitbake task executor and various application and BSP layers.

To configure the scripts and download the build metadata, do:

$ mkdir ~/bin
$ PATH=~/bin:$PATH

$ curl > ~/bin/repo
$ chmod a+x ~/bin/repo

Please note that repo requires python2, some distributions which default to python3 might need below fix

sed -i "s%/usr/bin/env python$%/usr/bin/env python2%" ~/bin/repo

you might have to re-run this command everytime repo tool is updated in ~/bin/repo

Run repo init to bring down the latest version of Repo with all its most recent bug fixes. You must specify a URL for the manifest, which specifies where the various repositories included in the Android source will be placed within your working directory.

$ repo init -u git://

To check out a branch other than "master", specify it with -b:

$ repo init -u git:// -b angstrom-v2015.06-yocto1.8

When prompted, configure Repo with your real name and email address.

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.

To pull down the metadata layers to your working directory from the repositories as specified in the default manifest, run

$ repo sync

When downloading from behind a proxy (which is common in some corporate environments), it might be necessary to explicitly specify the proxy that is then used by repo:

$ export HTTP_PROXY=http://<proxy_user_id>:<proxy_password>@<proxy_server>:<proxy_port>
$ export HTTPS_PROXY=http://<proxy_user_id>:<proxy_password>@<proxy_server>:<proxy_port>

More rarely, Linux clients experience connectivity issues, getting stuck in the middle of downloads (typically during "Receiving objects"). It has been reported that tweaking the settings of the TCP/IP stack and using non-parallel commands can improve the situation. You need root access to modify the TCP setting:

$ sudo sysctl -w net.ipv4.tcp_window_scaling=0
$ repo sync -j1

Setup Environment

$ . ./setup-environment

$ MACHINE=<machine> bitbake <image>
e.g. MACHINE=beaglebone bitbake systemd-image

Creating a local topic branch

Setup will already create a branch called $USER/work but if you need to create local branches for all repos which then can be done e.g.

$ repo start myangstrom --all

Where 'myangstrom' is the name of branch you choose

Updating the sandbox

Setup will do this as well but in between if you need to bring changes from upstream then use following commands

$ repo sync

Rease your local committed changes

$ repo rebase

If you find any bugs please report them here

If you have questions or feedback, please subscribe to

Ångström Distribution maintainers