summaryrefslogtreecommitdiff
path: root/README
blob: 3c3cd8aebeb803fcd026dfc911a4645e7954c37e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
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/

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.

One builds the image by running the following commands:

$ podman run -it --rm --userns=keep-id -e USER_ID=$UID -e GROUP_ID=$GID -w $PWD/.. -v $PWD/..:$PWD/..:rw,Z --tmpfs /tmp ghcr.io/siemens/kas/kas:2.6.2 build meta-theobroma-systems-bsp/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.