OpenEmbedded BSP layer for Theobroma Systems boards

About
=====

The purpose of this layer is to provide OpenEmbedded BSP support for
boards manufactured by Theobroma Systems.

Dependencies
============

  URI: git://git.openembedded.org/openembedded-core
  layers: meta
  branch: matched branch (e.g. honister)

  URI: git://git.yoctoproject.org/meta-rockchip
  branch: matched branch (e.g. honister)

Status of supported boards
==========================

builds and boots wic image:
	puma-haikou
		https://www.theobroma-systems.com/evaluationkit/haikou-q7-dev-kit/
		https://www.theobroma-systems.com/som-product/rk3399-q7/
	ringneck-haikou
		https://www.theobroma-systems.com/evaluationkit/haikou-q7-dev-kit/
		https://www.theobroma-systems.com/som-product/px30-uq7/
	jaguar
		https://www.theobroma-systems.com/product/jaguar-sbc-rk3588
	tiger-haikou
		https://www.theobroma-systems.com/evaluationkit/haikou-q7-dev-kit/
		https://www.theobroma-systems.com/product/tiger-som-rk3588-q7/

Maintainer
==========

Quentin Schulz <quentin.schulz@theobroma-systems.com>

Adding the meta-theobroma-systems-bsp layer to your build
=========================================================

Run 'bitbake-layers add-layer meta-theobroma-systems-bsp'

Building minimal image
======================

kas-theobroma.yml is a configuration file to be used by kas
(https://github.com/siemens/kas) which sets up everything one needs to build the
minimal BSP image that can run on the supported boards listed above.

It is recommended to install the kas package through the distro manager:

	apt-get install -y kas

or via pip:

	python3 -m pip install kas

The image can then be built with:

	KAS_IMAGE_VERSION="4.0" kas-container build kas-theobroma.yml

Once the build has finished, the artifacts will be available in
build/tmp/deploy/images/puma-haikou/ directory.

One can directly flash the .wic image on an SD card with the following command:

$ dd if=core-image-minimal-puma-haikou.wic of=/dev/sdX

(sdX should be replaced with the device associated with one's SD card)

bmap-tools can also be used to flash the image on the SD card faster:

$ bmaptool copy core-image-minimal-puma-haikou.wic /dev/sdX

(sdX should be replaced with the device associated with one's SD card)

The freshly flashed SD card can then be inserted into the board's SD card reader
and the board booted.