Yocto build guide with docker - Revision history

Jneuhauser: Update to /path/to/kas-dhsom #2

2022-11-24T14:54:46Z

Update to /path/to/kas-dhsom #2

← Older revision		Revision as of 16:54, 24 November 2022
Line 63:		Line 63:
	Usage:		Usage:
	<syntaxhighlight lang="shell">		<syntaxhighlight lang="shell">
	cd /path/to/~~meta~~-dhsom~~-stm32-bsp/kas~~		cd /path/to/kas-dhsom
	kas menu		kas menu
	kas build		kas build

Jneuhauser: Update to /path/to/kas-dhsom

2022-11-24T14:54:12Z

Update to /path/to/kas-dhsom

← Older revision		Revision as of 16:54, 24 November 2022
Line 46:		Line 46:
	sudo chown $(id –u):$(id –g) "${KAS_WORK_DIR}" "${KAS_BUILD_DIR}"		sudo chown $(id –u):$(id –g) "${KAS_WORK_DIR}" "${KAS_BUILD_DIR}"

	cd /path/to/~~meta~~-dhsom~~-stm32-bsp~~		cd /path/to/kas-dhsom

	docker run --rm --interactive --tty --init \		docker run --rm --interactive --tty --init \
Line 78:		Line 78:
	Usage:		Usage:
	<syntaxhighlight lang="shell">		<syntaxhighlight lang="shell">
	cd /path/to/~~meta~~-dhsom~~-stm32-bsp/kas~~		cd /path/to/kas-dhsom
	/path/to/kas-container menu		/path/to/kas-container menu
	/path/to/kas-container build		/path/to/kas-container build
	</syntaxhighlight>		</syntaxhighlight>

Jneuhauser: /* Docker container based bash shell */ Update dir creation for KAS_WORK_DIR and KAS_BUILD_DIR

2022-11-24T14:42:07Z

Docker container based bash shell: Update dir creation for KAS_WORK_DIR and KAS_BUILD_DIR

← Older revision		Revision as of 16:42, 24 November 2022
Line 43:		Line 43:
	export KAS_BUILD_DIR=/mnt/build/yocto		export KAS_BUILD_DIR=/mnt/build/yocto

	mkdir -p "${KAS_WORK_DIR}" "${KAS_BUILD_DIR}"		sudo mkdir -p "${KAS_WORK_DIR}" "${KAS_BUILD_DIR}"
			sudo chown $(id –u):$(id –g) "${KAS_WORK_DIR}" "${KAS_BUILD_DIR}"

	cd /path/to/meta-dhsom-stm32-bsp		cd /path/to/meta-dhsom-stm32-bsp

Jneuhauser: Initial minimal version

2022-07-22T11:02:41Z

Initial minimal version

New page

<div class="toclimit-3">__TOC__</div>

= Requirements =

To build Yocto images you need a powerfull build machine and a lot of time.

== Hardware ==

* CPU: four cores or more
* RAM: 16 GB or more
* HDD/SSD: from 25 GB to 100 GB free space (depends on included features)

== Software ==

* Linux OS
* Docker

= Start your build environment =

The following two examples show how to create yocto images using the <syntaxhighlight lang="shell" inline>kas</syntaxhighlight> container or the <syntaxhighlight lang="shell" inline>kas-container</syntaxhighlight> script.

In the following examples, we use the meta-dhsom-stm32-bsp layer as the top layer for creating images for the STM32MP15 DHSOM family with our baseboards.
If you have your own layer on top because you have a custom DHSOM baseboard, then you must replace meta-dhsom-stm32-bsp with your own layer in all commands.

See the documentation for how to use the <syntaxhighlight lang="shell" inline>kas</syntaxhighlight> tool:
* https://kas.readthedocs.io/en/latest/userguide.html
* https://kas.readthedocs.io/en/latest/command-line.html

== Docker container based bash shell ==

Preparation:
<syntaxhighlight lang="shell">
export KAS_WORK_DIR=/mnt/work/yocto
export KAS_BUILD_DIR=/mnt/build/yocto

mkdir -p "${KAS_WORK_DIR}" "${KAS_BUILD_DIR}"

cd /path/to/meta-dhsom-stm32-bsp

docker run --rm --interactive --tty --init \
--env TERM="xterm-256color" \
--env USER_ID="$(id -u)" --env GROUP_ID="$(id -g)" \
--volume "${KAS_BUILD_DIR}":"${KAS_BUILD_DIR}":rw \
--env KAS_BUILD_DIR="${KAS_BUILD_DIR}" \
--volume "${KAS_WORK_DIR}":"${KAS_WORK_DIR}":rw \
--env KAS_WORK_DIR="${KAS_WORK_DIR}" \
--volume "${PWD}":"${PWD}":rw \
--workdir="${PWD}" \
ghcr.io/siemens/kas/kas:latest-release \
/bin/bash
</syntaxhighlight>

Usage:
<syntaxhighlight lang="shell">
cd /path/to/meta-dhsom-stm32-bsp/kas
kas menu
kas build
</syntaxhighlight>

== Docker container based kas tool ==

Preparation:
<syntaxhighlight lang="shell">
wget -O kas-container https://github.com/siemens/kas/raw/master/kas-container
chmod +x kas-container
</syntaxhighlight>

Usage:
<syntaxhighlight lang="shell">
cd /path/to/meta-dhsom-stm32-bsp/kas
/path/to/kas-container menu
/path/to/kas-container build
</syntaxhighlight>