View source for Transclusion: CL-SOM-iMX7: Yocto Linux: Building

= Overview =
The Yocto Project is an open-source collaboration focused on embedded Linux development.<br>
The purpose of this article is to show how to get Yocto Image with CL-SOM-iMX7 system-on-module (SoM) support, which includes following derived devices built around the CL-SOM-iMX7 SoM:
* SBC-iMX7 Single Board Computer
* SBC-IOT-iMX7 Internet of Things Single Board Computer
* IOT-GATE-iMX7 Internet of Things Gateway

[https://www.yoctoproject.org/docs/ Learn more about Yocto]

= Yocto Environment Setup =
Yocto host requirements are listed [https://www.yoctoproject.org/docs/2.6/brief-yoctoprojectqs/brief-yoctoprojectqs.html#brief-build-system-packages on the Yocto official site]

In order to get NXP Yocto BSP building environment please follow [https://source.codeaurora.org/external/imx/meta-fsl-bsp-release/tree/imx/README?h=rocko-4.9.88-2.0.0_ga#n52 the NXP readme file]

Next step is getting Compulab BSP meta-layer.
<pre>
git clone -b master https://github.com/compulab-yokneam/meta-compulab-bsp.git sources/meta-compulab-bsp
</pre>
The Compulab meta-layer consists of {{filename|meta-compulab-bsp}} directory, that provides support for CL-SOM-iMX7 and other Compulab i.MX based machines and contains recipes for U-boot and Linux kernel.

= Image Build =
This section provides the detailed information about building CL-SOM-iMX7 images.

== Setting up build configuration ==
The NXP Yocto Project BSP Release directory includes a {{filename|sources}} directory which contains the various build recipes and a set of scripts used to set up the environment. The recommended script {{filename|fsl-setup-release.sh}} simplifies the setup for i.MX machines. To use the script, it is necessary to specify the name of the machine to be built and the required graphical backend. The script sets up a directory and the configuration files for the specified machine and backend.
:* Select the required backend:
::Graphical backend is defined by the {{parameter|DISTRO}} parameter.<br>
::Available {{parameter|DISTRO}} values for CL-SOM-iMX7:
::*{{parameter|fsl-imx-x11}} - building X11
::*{{parameter|fsl-imx-fb}} - building Frame Buffer
::*{{parameter|fsl-imx-xwayland}} - building XWayland
::*{{parameter|fsl-imx-wayland}} - building Wayland-Weston
::*{{parameter|imx-wayland-ivi}} - building Wayland with IVI extension
:: For example:
::<pre>export DISTRO=fsl-imx-x11</pre>
:* Select the machine:
::<pre>export MACHINE=cl-som-imx7</pre>
:* Select the build directory:
::Select a different build directory for each distro. For example:
::<pre>BUILD_DIR=build-x11</pre>
:* Issue the '''NXP''' Setup Script:
::<pre>source fsl-setup-release.sh -b ${BUILD_DIR}</pre>
:* Issue '''Compulab''' Setup Script:
::<pre>source ../sources/meta-compulab-bsp/tools/setup-compulab-env</pre>

== Building images ==
The Yocto Project build uses the {{parameter|bitbake}} command.
:* Select one of the the following image recipes
::* fsl-image-validation-imx - provides a gui image without Qt.
::* fsl-image-qt5-validation-imx - provides a Qt5 image
::<pre>IMAGE_RECIPES=fsl-image-qt5-validation-imx</pre>
:: Issue the bitbake build command:
::<pre>bitbake ${IMAGE_RECIPES}</pre>