Building the Filesystem¶

1. Prerequisites 2. Building the FPGA and Bootloader 3. Building the Filesystem 4. Building the SD Card

Introduction¶

The filesystem is built through Yocto. The Yocto version is scarthgap and should be compiled using Ubuntu 22.04.

The meta-layers for the Yocto build are as follows.

Repository	URL	Branch
poky	https://git.yoctoproject.org/poky	scarthgap
meta-openembedded	https://github.com/openembedded/meta-openembedded	scarthgap
meta-mitysom	https://support.criticallink.com/git/meta-mitysom.git	scarthgap

It is recommended to use Docker for the Yocto build. Instructions for installing Docker can be found here: Docker Installation Guide
The recommended Docker container can be fetched using the command below.

docker pull crops/poky:ubuntu-22.04

Setting up Yocto¶

Yocto is made up of multiple meta layers, these layers are stored in git repositories. To get everything set up to build, these repositories will need to be cloned and a few config files will need to be copied over.

Clone the Yocto layers¶

git clone -b scarthgap https://git.yoctoproject.org/poky
cd poky
git clone -b scarthgap https://github.com/openembedded/meta-openembedded
git clone -b scarthgap https://support.criticallink.com/git/meta-mitysom.git

Launch the Docker container¶

docker run --rm -it -v `pwd`:/work --workdir=/work crops/poky:ubuntu-22.04 /bin/bash

Source the Yocto environment¶

. ./oe-init-build-env

Copy the example configuration files¶

cp ../meta-mitysom/conf/bblayers.conf.sample conf/bblayers.conf
cp ../meta-mitysom/conf/local.conf.sample conf/local.conf

Performing the Yocto build¶

Launch the Docker container¶

docker run --rm -it -v `pwd`:/work --workdir=/work crops/poky:ubuntu-22.04 /bin/bash

Source the Yocto environment¶

. ./oe-init-build-env

Build the filesystem¶

MACHINE=mitysom-agilex5 bitbake mitysom-image-base

Outputs¶

Description	Location
Filesystem Tarball	<Yocto Directory>/build/tmp/deploy/images/mitysom-agilex5/mitysom-image-base-mitysom-agilex5.tar.gz

Build the SDK¶

Launch the Docker container¶

docker run --rm -it -v `pwd`:/work --workdir=/work crops/poky:ubuntu-22.04 /bin/bash

Source the Yocto environment¶

. ./oe-init-build-env

Build the SDK¶

MACHINE=mitysom-agilex5 bitbake mitysom-image-base -c populate_sdk

Outputs¶

Description	Location
SDK Script	<Yocto Directory>/build/tmp/deploy/sdk/mitysom-*mitysom-image-base-*.sh

1. Prerequisites 2. Building the FPGA and Bootloader 3. Building the Filesystem 4. Building the SD Card