The integration of the new target device support to Boot to Qt is done in a new meta layer. The new meta layer needs to contain information of all BSP (Board Support Package) meta layers that provide Yocto support for the selected devices. Also, the meta layer can provide required recipes and configurations that support running the Boot to Qt Software Stack on a target device. You can use the same layer for adding the new target device support and for customizing the Boot to Qt Software Stack as instructed in Using Custom Meta Layer.

To create a new blank layer, you can use the bitbake-layers command or you can use an existing Boot to Qt BSP layer as a template. As an example, see Boot to Qt BSP layer for Renesas boards.

bblayers.conf.sample File

All the meta layers need to be included in the bitbake build. Therefore a new BSP layer should define a bblayers.conf.sample file that consist of all the meta layers used in the build.

For all the Renesas boards, the conf/bblayers.conf.sample file is as follows:

POKY_BBLAYERS_CONF_VERSION = "2"
BBPATH = "${TOPDIR}"
BBFILES ?= ""
BSPDIR := "${@os.path.abspath(os.path.dirname(d.getVar('FILE')) + '/../..')}"
BBLAYERS ?= " \
    ${BSPDIR}/sources/poky/meta \
    ${BSPDIR}/sources/poky/meta-poky \
    ${BSPDIR}/sources/meta-renesas/meta-rcar-gen3 \
    ${BSPDIR}/sources/meta-openembedded/meta-oe \
    ${BSPDIR}/sources/meta-openembedded/meta-python \
    ${BSPDIR}/sources/meta-openembedded/meta-networking \
    ${BSPDIR}/sources/meta-openembedded/meta-initramfs \
    ${BSPDIR}/sources/meta-openembedded/meta-multimedia \
    ${BSPDIR}/sources/meta-boot2qt/meta-boot2qt \
    ${BSPDIR}/sources/meta-boot2qt/meta-boot2qt-distro \
    ${BSPDIR}/sources/meta-boot2qt-renesas \
    ${BSPDIR}/sources/meta-mingw \
    ${BSPDIR}/sources/meta-qt6 \
"

Hardware Specific Configurations

The new Yocto meta layer may require some hardware specific configurations. The configurations can be defined to affect all the devices that are built with the layer or they can be targeted to a specific device. The configuration file in conf/distro/include/b2qt.inc can be used to define configurations that are needed by all the device variants supported by the layer. The conf/distro/include/{MACHINE}.conf files can be used to define configurations that are specific to a selected device.

Typically, a hardware specific configuration file defines boot configurations, adaptations of the BSP layer to Boot to Qt, and other configurations that might be required.

For example, the Renesas meta layer defines the device names for the QBSP installer in conf/distro/include/b2qt.inc file:

DEPLOY_CONF_NAME_ebisu      = "Renesas R-Car-E3 Ebisu 4D"
DEPLOY_CONF_NAME_m3ulcb     = "Renesas R-Car-M3 Starter Kit Pro"
DEPLOY_CONF_NAME_h3ulcb     = "Renesas R-Car-H3 Starter Kit Premier"
DEPLOY_CONF_NAME_salvator-x = "Renesas R-Car H3 M3 Salvator-X(S)"

Recipes

As any other Yocto meta layer, the new Boot to Qt BSP layer can contain new recipes and .bbappend files to existing recipes.