MAPIO builder repository

This repository is used to build the yocto Linux distribution for Mapio. The project documentation can be found here: https://mapio-docs.readthedocs.io/en/latest/

Pre-requisites

This documentation supports Ubuntu 22.04 LTS version. However command listed below should work with any recent debian-like Linux distribution.

git

From https://git-scm.com/: Git is a free and open source distributed version control system designed to handle everything from small to very large projects with speed and efficiency.

To install git:

  $ sudo apt install git

For more informations: https://git-scm.com/

Docker

From https://docs.docker.com/get-started/overview/: Docker is an open platform for developing, shipping, and running applications.

To install docker:

  $ sudo apt install docker.io

For more informations: https://www.docker.com/

cqfd

From https://github.com/savoirfairelinux/cqfd: cqfd provides a quick and convenient way to run commands in the current directory, but within a Docker container defined in a per-project config file.

To install cqfd:

  $ git clone git@github.com:savoirfairelinux/cqfd.git
  $ cd cqfd/
  $ sudo make install

For more information: https://github.com/savoirfairelinux/cqfd

Get the project

  $ git clone git@github.com:iotheque/yocto-build.git

Build cqfd docker image

This has to be done only once unless the Dockerfile is modified:

  $ cqfd init

Build project

To build MAPIO project for MAPIO board:

  $ cqfd

Advanced build setup

Launch kas shell cqfd container

To help developing a shell kas with all bitbake environment can be start:

  $ cqfd run kas shell project.yml

Flash project on target

The generated image is named 'mapio-image-mapio-cm4-64.wic.bz2' It is generated in build directory:

  build/tmp/deploy/images/mapio-cm4-64/mapio-image-mapio-cm4-64.wic.bz2

You can flash the board using a dd command or using graphical tool as Balena Etcher (https://www.balena.io/etcher/)