User Tools

Site Tools


Download and Build AGL Source Code

The AGL source code and Yocto layers are maintained on the AGL gerrit server. For information on how to create accounts for gerrit see Getting Started with AGL.

Build instructions for supported hardware platforms available at AGL documentation site.

Prepare Repo Tool

AGL Uses the Repo tool for managing repositories. First you need to setup layers of AGL. You can use these commands.

Prepare Repo:

  $ mkdir ~/bin
  $ export PATH=~/bin:$PATH
  $ curl > ~/bin/repo
  $ chmod a+x ~/bin/repo

Download Master Branch

To download all code from master:

  $ repo init -u
  $ repo sync

Download Latest Stable Release

To download all layers for the latest stable release and more see the release notes

  $ repo init -b icefish [-m icefish_9.0.0.xml] -u
  $ repo sync

Download Latest on stable branch

To download all layers on the current ​release ​branch which may be in the midst of testing or changes prior to the next stable release:

  $ repo init -b icefish -u
  $ repo sync

Download previous stable releases

Set up Build Environment

Set up the development environment for the desired target hardware. AGL has created a set up script for defining the target build and desired optional features. To get a complete list of the options available run.

  $ source meta-agl/scripts/ -h

Once you run with your desired paramaters, you can build any target desired. Some examples follow.

Features supported by aglsetup

Here is the list of features for AGL that can be specified in the command line:

  • in meta-agl
    • agl-devel: activate development options (empty root password, debugger, strace, valgrind …)
    • agl-netboot: enable network boot support through TFTP and NBD (see meta-netboot layer)
    • agl-appfw-smack: enables Application Framework + SMACK + Cynara
    • agl-demo: enable layer meta-agl-demo and meta-qt5 - required to build agl-demo-platform
    • agl-localdev: add a local layer named “meta-localdev” in meta directory and a conf file if present
''CHECK OUT: source meta-agl/scripts/ -h''

For newer features or to get more details on a given feature, take a look at the configuration files stored for each feature and/or each machine in meta-agl/templates and meta-agl-*/templates.

Building the AGL Demo Platform for QEMU

To build the QEMU version of the AGL demo start use machine “qemux86-64” and feature “agl-demo”

  $ source meta-agl/scripts/ -m qemux86-64 agl-demo agl-netboot   
  $ bitbake agl-demo-platform

Building the kernel

To get kernel source tree, you have to build kernel once, to do that, you can use these commands,

  $ bitbake virtual/kernel

Then you can find kernel source tree at

  ls build/tmp/work*/*/linux-yocto/*/linux/


  ls build/tmp/work*/*/linux-*/*/git/

Detailed instructions for building AGL

More detailed instructions are maintained in the file located in meta-agl repository.

Developing Kernel Code for AGL

Here is a good manual for developing kernel code

You can choose from 2 ways to add code to AGL kernel.

  1. Writing a patch and writing recipe to apply it. See 2.2. Modifying an Existing Recipe
  2. Writing recipe to build modules out of tree See 2.5. Working with Out-of-Tree Modules

Building AGL for Other Targets

Follow the step by step instructions for building AGL for other supported targets:

agl-distro/source-code.txt · Last modified: 2022/09/12 16:22 by baigudin