Adding Layers to Yocto
==============================

Adding layers to a Yocto BSP allows customers to expand the capabilities of that BSP.

Hereafter an example for the rocko branch of the meta-karo BSP using Qt5.

A list of known layers for Yocto - in general - can be found `here <http://layers.openembedded.org/layerindex/branch/master/layers/>`_.

* Add meta-qt5 to the sources:

.. code-block:: shell

	cd karo-yocto-rocko/sources
	git clone -b rocko https://github.com/meta-qt5/meta-qt5.git

* Add the meta-qt5 layer to ``<build-directory>/conf/bblayers.conf``:

.. code-block:: shell

	${BSPDIR}/sources/meta-qt5 \

* Change the DISTRO and add the list of images to ``<build-directory>/conf/local.conf``:

.. code-block:: text

	DISTRO ?= 'karo-x11'
	IMAGE_INSTALL_append = " \
  		qtbase-plugins \
  		cinematicexperience \
  		"

* Build the images:

.. code-block:: shell

	bitbake karo-image-x11

After building the image and after being installed and booted on the TX module, start the demo as follows:

.. code-block:: shell

	Qt5_CinematicExperience -platform eglfs

.. note:: Note that Qt has both a commercial and open source license options. Make the decision about which license to use before starting work on custom Qt applications. Once custom Qt applications are started with an open source Qt license the work can not be used with a commercial Qt license. Work with a legal representative to understand the differences between each license.  Default builds use an open source Qt license.