View source for Building CL-SOM-iMX8 Yocto Linux images

= 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 build Yocto Image with support for the CL-SOM-iMX8 System-on-Module.

[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 issue the following commands. More detailed instructions can be found at [https://source.codeaurora.org/external/imx/meta-fsl-bsp-release/tree/imx/README?h=sumo-4.14.98-2.0.0_ga the NXP readme file]
<pre>repo init -u git://source.codeaurora.org/external/imx/imx-manifest.git -b imx-linux-sumo -m imx-4.14.98-2.0.0_ga.xml
repo sync
</pre>
Next step is getting the Compulab BSP meta-layer.
<pre>git clone -b master https://github.com/compulab-yokneam/meta-bsp-imx8mq.git sources/meta-bsp-imx8mq
git -C sources/meta-bsp-imx8mq checkout master
</pre>
The Compulab meta-layer consists of {{filename|meta-compulab}} directory, that provides support for CL-SOM-iMX8 and other Compulab i.MX based machines and contains recipes for U-boot and Linux kernel.

= Building the Image =

==Create Build Environment==
*Set the required machine, the required distribution, and the desired image
<pre>export MACHINE=cl-som-imx8
export DISTRO=fsl-imx-xwayland
export IMAGE=fsl-image-qt5-validation-imx</pre>
* Issue '''Compulab''' Setup Script:
<pre> source sources/meta-bsp-imx8mq/tools/setup-imx8mq-env -b build-${MACHINE}-${DISTRO}</pre>

== Building the images ==
The Yocto Project build uses the {{parameter|bitbake}} command.

* To build a full Compulab image with GUI use the command below:
<pre>bitbake -k ${IMAGE}</pre>
* To build a minimal Linux image use the command below:
<pre>bitbake -k core-image-full-cmdline</pre>

* To re-build only the Linux kernel use the command below:
<pre>source setup-environment ${IMAGE}
bitbake -c cleansstate linux-imx
bitbake -k linux-imx
</pre>
* To re-build only the u-boot bootloader and boot image use the command below:
<pre>source setup-environment ${IMAGE}
bitbake -c cleansstate imx-boot u-boot-imx
bitbake -k imx-boot u-boot-imx
</pre>

[[Category:Linux]]
[[Category:Yocto]]
[[Category:CL-SOM-iMX8]]