Yocto Dunfell

1 Yocto Dunfell
- 1.1 meta-guf-machine
  - 1.1.1 Description
2 Getting started
- 2.1 Preparing the host system
  - 2.1.1 Ubuntu 18.04.1
  - 2.1.2 Yocto related base software
  - 2.1.3 Development tools
  - 2.1.4 Install repo tool
  - 2.1.5 Gitlab access
  - 2.1.6 Local Git setup
3 Download yocto
- 3.1 Download source code
- 3.2 Build
- 3.3 Installation

Currently under Test/Development

The Seco Yocto Dunfell release is derived from the Garz & Fricke GIT-project.
As part of Garz & Fricke Group, we share GIT repositories between Garz & Fricke GmbH and Seco with their own branches,
which are synchronized on regular basis.

meta-guf-machine

This layer provides support for Garz & Fricke platforms to be used with Yocto.
This layer depends on:

	GIT	Branch

	GIT	Branch
openembedded	git://git.openembedded.org/meta-openembedded	dunfell
poky	git://git.yoctoproject.org/poky	dunfell
meta-qt5	git://code.qt.io/yocto/meta-qt5	dunfell

Description

These repositories contain all the source code and metadata to build images and packages for Garz & Fricke devices based on the imx6, imx6ull and imx8mm processor.

The build system is based on the yocto project, further information and documentation can be found at the following link.

The yocto project uses so called 'layers' containing the metadata to build all needed packages, while the packages sources are downloaded during the build.

The Garz & Fricke yocto is based on the base layers from poky and openembedded.

QT5 support is included the meta-qt5 layer. For the imx8m platform Tanaro the BSP from Freescale is included for GPU and VPU drivers and tools. For the imx6 based platforms (SANT*) GPU and VPU drivers the etnaviv driver is used, included in the mainline opensource layers.

This Garz & Fricke specific part comes as two parts layers:

meta-guf-machine

This part is intended to hold all recipes needed to build the BSP for Garz & Fricke Boards

meta-guf-distro

This part is intended to hold recipes that make up the Garz & Fricke distribution including the base image: guf-image.

The Garz & Fricke manifest repository contains the so called manifest (default.xml) for the repo tool.
The manifest file contains a list of all layers and there specific revisions needed to build the image for Garz&Fricke devices, the repo tool itself reads this manifest and handles the clone and directory setup for you.

Getting started

Preparing the host system

There are some requirements to the host system.

Ubuntu 18.04.1

Tested distribution is currently Ubuntu 18.04. LTS.
ISO-Installation-Image.
This should work as virtual machine (Virtual box …) or baremetal installation.

Yocto related base software

Needed tools are listed in the yocto documentation http://docs.yoctoproject.org/brief-yoctoprojectqs/brief-yoctoprojectqs.html#compatible-linux-distribution
Execute the following commands to install them:

sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib build-essential chrpath socat cpio python3 python3-pip python3-pexpect xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev pylint3 xterm python3-subunit mesa-common-dev

Additionally needed:

sudo apt install -y quilt curl flex bison libssl-dev

Development tools

sudo apt install git minicom gdb-multiarch crossbuild-essential-armhf meld gedit nano cscope quilt qtcreator

Install repo tool

If available the tool can also be installed from the distributions package manager.
This directly downloads the latest version from google.

mkdir ~/bin # once
curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/bin/repo # once
chmod a+x ~/bin/repo # once
echo "export PATH=${PATH}:~/bin" >> ~/.bashrc # once
source ~/.bashrc

Gitlab access

To download source code from gitlab the generation of a ssh key pair is needed.
SSH key for GitLab:

ssh-keygen -t ed25519 -C "name@provider.com" # use your email instead
cat ~/.ssh/id_ed25529.pub
(copy and add the key content to your GitLab Profile User Settings -> SSH keys)

Local Git setup

git config --global user.name "Surname Name" # use your name instead
git config --global user.email name.provider.com # use your email instead

Download yocto

The steps are to create a local build dir and use repo to download all needed files.
After that the build directory gets setup for one specific machine (imx6guf, imx6ullguf or imx8mguf) and distribution (guf-wayland)

Download source code

mkdir -p ~/projects/yocto-dunfell
cd ~/projects/yocto-dunfell
repo init -u ssh://git@gitlab.keith-koep.com:30001/yocto/manifest.git -b kuk_dunfell
repo sync

As an alternative you may also use the Garz & Fricke GmbH repository:

repo init -u ssh://git@gitlab.com/garz-fricke/yocto/manifest.git -b dunfell

The repo tool stores its meta data in a hidden subdirectory called .repo.
The manifest file is stored at .repo/manifests/default.xml and is used for the sync command which actually downloads the sources.

The selected branch is dunfell.

After the download the resulting directory structure should look like this:

yocto-dunfell$ tree -L 2 -a
.
├── .repo
│   ├── manifests
│   ├── manifests.git
│   ├── manifest.xml
│   ├── project.list
│   ├── project-objects
│   ├── projects
│   ├── repo
│   └── .repo_fetchtimes.json
├── setup-environment -> sources/meta-guf-distro/scripts/setup-environment
└── sources
    ├── meta-freescale
    ├── meta-freescale-distro
    ├── meta-guf-distro
    ├── meta-guf-machine
    ├── meta-openembedded
    ├── meta-qt5
    └── poky

Build

To get the build environment ready run

for Seco i.MX 8M platforms ( Trizeps VIII Mini, Myon II, SBCSOM):

MACHINE=imx8mkuk DISTRO=guf-wayland source ./setup-environment build

for Garz & Fricke i.MX6Q/DL platforms:

MACHINE=imx6guf DISTRO=guf-wayland source ./setup-environment build

for Garz & Fricke i.MX6ULL platforms:

MACHINE=imx6ullguf DISTRO=guf-wayland source ./setup-environment build

for Garz & Fricke i.MX 8M platforms (Tanaro):

MACHINE=imx8mguf DISTRO=guf-wayland source ./setup-environment build

Build the default Garz & Fricke image

bitbake guf-image