How to Build Yocto

The Yocto Project (YP) is an open source collaboration project that helps developers create custom Linux-based systems regardless of the hardware architecture. This procedure will help you build Yocto image for I-Pi SMARC IMX8M Plus

1. Set up a build host environment:

Recommended Hardware for the host

  • Intel Core-i7 Processor (>= 4 cores)
  • at least 8GB Memory
  • at least 500GB Disk space
  • Ubuntu 18.04 LTS 64bit or later version for Yocto Project Build
  • High speed network connectivity

 Essential host Packages required to be installed in your host :

$ sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib \
build-essential chrpath socat cpio python python3 python3-pip python3-pexpect \
xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev \
pylint3 xterm


Please Don’t use the root account to build Yocto. It might cause unpredictable errors.

“Google repo” packages required to be installed in your host :

$ mkdir ~/bin (this step may not be needed if the bin folder already exists)
$ curl > ~/bin/repo
$ chmod a+x ~/bin/repo
$ export PATH=${PATH}:~/bin

Before starting to build the source, make sure that git is set up properly with the commands below:

$ git config --global "Your Name"
$ git config --global "Your Email"
$ git config --list

2. Fetch the source from the git location as below:

Create the working directory as we have to create “imx-yocto-bsp”

$ mkdir imx-yocto-bsp 
$ cd imx-yocto-bsp

**Start to download the source **

$ repo init -u -b lec-imx-yocto-zeus -m adlink-lec-imx8mp-yocto-zeus_1v1.xml
$ repo sync
$ MACHINE=lec-imx8mp DISTRO=fslc-xwayland BUILD=build source

3. Build the Image

Choose the Image recipe with the supported hardware

Module name Yocto branch bitbake command
lec-imx8mp + Wayland desktop (GUI) zeus $ bitbake imx-image-multimedia
lec-imx8mp + console (CLI) zeus $ bitbake core-image-minimal

After the build is complete, disk images will be located at work-dir/build-dir/tmp/deploy/image/lec-imx8mp/

Image is generated as wic.bz2, use below command to unzip

$ bunzip2 -dk -f <image_name>.wic.bz2