Skip to content

Latest commit

 

History

History
61 lines (47 loc) · 2.65 KB

README.md

File metadata and controls

61 lines (47 loc) · 2.65 KB
Raw

KAS configuration for DH electronics platforms

This repository provides KAS configuration for DH electronics platforms.

Building OE image

The KAS tool downloads select OE layers, emits matching bblayers.conf and local.conf, sets up required OE build variables and even executes the build. The tool also provides menu-based build configuration.

A good starting point for setting up the build using KAS is the KAS documentation, namely Introduction, User Guide, Command line usage and Environment variables.

First, install KAS to current user local bin directory:

# Debian 12 and newer (recommended)
$ pipx install kas --system-site-packages

# Note: Debian 11 does not contain pipx by default, however, pipx can be
installed from bullseye-backports, which is highly recommended. If this
is not an option, use pip3 with debian 11:
$ pip3 install kas

Second, clone this metalayer git repository into a location accessible to the build system.

$ git clone https://github.com/dh-electronics/kas-dhsom.git -b main

Third, configure the build parameters, especially the work directory where the build stores all the data. This directory must have sufficient amount of space, around 25 GiB for basic build and 100 GiB for build with all examples.

The kas menu command displays an ncurses-based menu, which offers selection of one of MACHINEs supported by this metalayer and the option to perform full build including meta-dhsom-extras example and demonstration layer. Select suitable MACHINE (use SPACEBAR to change the selection), optionally enable full build (takes longer and requires extra disk space), and use either Save & Build or Save & Exit button to save changes and exit the menu (use TAB key to navigate the buttons).

$ export KAS_WORK_DIR=/path/to/work/directory/
$ cd kas-dhsom/
$ PATH=${PATH}:~/.local/bin kas menu

The *** Inferred and expert settings *** section does not need to be changed.

The Save & Build button stores the build configuration in ${KAS_WORK_DIR}/.config.yaml and immediately triggers default build target for the selected configuration. The Save & Exit button stores the build configuration and exits, the KAS build can then be resumed using KAS build command, kas build.