Meta-layer for Poky to build embedded Linux exvironments by Debian's source codes
Switch branches/tags
Clone or download
zuka0828 conf/distro/deby.conf: fetch CIP kernel from the official repository
linux-cip in github is just a mirror of the official repository,
and slowly updated than the official one.

Signed-off-by: Kazuhiro Hayashi <>
Latest commit fe1167e Dec 5, 2018

What is meta-debian?

meta-debian is a set of recipes (metadata) for the poky build system, which allows cross-building GNU/Linux images using Debian source packages. By enabling meta-debian, you can cross-build a small GNU/Linux image with Debian sources for multiple architectures.

The main purpose of meta-debian is to provide reference Linux distribution for embedded systems satisfying the following needs.

  • Long-term support
  • Stability
  • Wide embedded CPU support
  • Customizability

Currently, the following software versions are supported in meta-debian.

  • Source code: Debian GNU/Linux 8 (jessie)
  • Build system: Yocto Project 2.2 (morty)

Quick Start

Install essential packages poky requires into your host system according to

$ sudo apt-get install git tar python3
$ sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib build-essential chrpath socat

NOTE: The following three packages have version limitation

  • git: 1.7.8 or greater
  • tar: 1.24 or greater
  • python: 2.7.3 or greater not including Python 3.x

Setup repositories.

$ git clone -b morty git://
$ cd poky
$ git clone -b morty
$ cd ..

Setup build directory.

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

You can change the target machine by setting MACHINE variable in conf/local.conf to one of the following machines.

  • qemux86 (default)
  • qemux86-64
  • qemuarm
  • qemuarm64
  • qemuppc
  • qemumips

For example, the target machine is set to QEMU ARM by adding the following difinition to conf/local.conf.

MACHINE = "qemuarm"

Now, the build system is ready. Build Linux kernel and the minimal rootfs by the following command. It takes a while to complete (more than 30 minutes).

$ bitbake core-image-minimal

Run the built Linux on QEMU. Please replace ${MACHINE} by the target machine you selected in the above step. NOTE: Confirm that the tun module, which runqemu depends on, is correctly loaded in your system.

$ runqemu ${MACHINE} nographic

Only if MACHINE is qemuarm, the console should be set to the correct serial device.

$ runqemu qemuarm nographic bootparams="console=ttyAMA0"

After boot, you can login as root without password.

If you'd like to reduce the time of bitbake, please refer to


License of meta-debian is same as meta in poky i.e. All metadata is MIT licensed unless otherwise stated. Source code included in tree for individual recipes is under the LICENSE stated in the associated recipe (.bb file) unless otherwise stated.

See COPYING.MIT for more details about MIT license.

Community Resources

Project home

Mailing list

Mailing list subscription