meta-maaxboard

A meta-layer for Embest MaaXBoard.

How to

Install Host Yocto Development Env

You should have a linux machine, below instructions show how to setup the env on a Ubuntu:18.04 machine.

$ sudo apt-get update && sudo apt-get install -y \
        gawk \
        wget \
        git-core \
        diffstat \
        unzip \
        texinfo \
        gcc-multilib \
        build-essential \
        chrpath \
        socat \
        libsdl1.2-dev \
        xterm \
        sed \
        cvs \
        subversion \
        coreutils \
        texi2html \
        docbook-utils \
        python-pysqlite2 \
        help2man \
        make \
        gcc \
        g++ \
        desktop-file-utils \
        libgl1-mesa-dev \
        libglu1-mesa-dev \
        mercurial \
        autoconf \
        automake \
        groff \
        curl \
        lzop \
        asciidoc \
        u-boot-tools \
        cpio \
        sudo \
        locales

Install repo

sudo curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > /usr/bin/repo
sudo chmod a+x /usr/bin/repo

Fetch the source

Download meta layers from NXP

mkdir imx-yocto-bsp
$ cd imx-yocto-bsp
$ repo init -u https://source.codeaurora.org/external/imx/imx-manifest -b imx-linux-sumo -m imx-4.14.98-2.2.0.xml
$ repo sync

Clone this repo

$ cd sources
$ git clone http://192.168.2.149/imx8m/meta-maaxboard.git

Do patch

NXP do some hook / patch according different machine / distro when init a new build. We need do this first.

If you're going to build MaaXBoard

$ cd imx-yocto-bsp
$ mkdir imx8mqevk
$ DISTRO=fsl-imx-wayland MACHINE=imx8mqevk source fsl-setup-release.sh -b imx8mqevk
$ rm -rf imx8mqevk

Or if you're going to build MaaXBoard Mini

$ cd imx-yocto-bsp
$ mkdir imx8mmevk
$ DISTRO=fsl-imx-wayland MACHINE=imx8mmevk source fsl-setup-release.sh -b imx8mmevk
$ rm -rf imx8mmevk

Build configure

$ cd imx-yocto-bsp
# Create the build directory
$ mkdir -p maaxboard/build
# Create the default build conf in maaxboard/build
$ source sources/poky/oe-init-build-env maaxboard/build

Upate local conf

You should update 2 conf file in the build directory(maaxboard/build/conf/):

local.conf
bblayers.conf

We provide a sample under /meta-maaxboard/conf:

local.conf.sample
bblayers.conf.sample

NOTE: variable 'BSPDIR' in bblayer.conf should be defined, the value should be the repo init directory. It is imx-yocto-bsp directory in above example

If you're going to build MaaXBoard Mini, you should change the Machine(in local.conf) to:

MACHINE ??= 'maaxboard-mini-ddr4-2g-sdcard'

Build

$ cd /path/to/bsp_dir/
$ source sources/poky/oe-init-build-env maaxboard/build

$ bitbake lite-image

Flash sdcard

# This image will be generated under: /path/to/build/tmp/deploy/images/maaxboard-ddr4-2g-sdcard/lite-image-maaxboard-ddr4-2g-sdcard-20200515065319.rootfs.sdcard.bz2
# unzip the bz2 file
$ bunzip2 lite-image-maaxboard-*.rootfs.sdcard.bz2
## dd
$ sudo dd if=lite-image-maaxboard-ddr4-2g-sdcard-20200515065319.rootfs.sdcard of=/dev/sda bs=10M conv=fsync
$ sync

Power On

The default login is user 'root' with the password 'avnet'

Configuration

Distor: 'fsl-imx-wayland-lite'
- meta-maaxboard/conf/distro/fsl-imx-wayland-lite.conf
Image: "lite-image"
- meta-maaxboard/images/lite-image.bb
Machine:
- MaaXBoard: maaxboard-ddr4-2g-sdcard
- MaaXBoard Mini: maaxboard-mini-ddr4-2g-sdcard

Customization

You could add more packages in the image recipe: meta-maaxboard/images/lite-image.bb
Distro features: meta-maaxboard/conf/distro/fsl-imx-wayland-lite.conf
Machine features: meta-maaxboard/conf/machine/maaxboard-ddr4-2g-sdcard.conf

Setup a Debian Repository

Here we want to show you how to setup a Debian Repository. In this way, you could use apt-get install to install packages that you built in Yocto.

Host Setup

This is the host machine that you build the Yocto images. If you want to setup a Debian repository, you should also install a web server here.

$ sudo apt install nginx

Build Packages

Before using apt-get install a package, you should first build it. Let's take nano for example.

$ cd /path/to/bsp_dir/
$ source sources/poky/oe-init-build-env maaxboard/build

$ bitbake nano

Generate Packages index files

After build the packages, you should generate the package index files for apt-get to search.

First, change to the deb directory:

$ cd /home/build/maaxboard/maaxboard-yocto/maaxboard/build/tmp/deploy/deb
$ ls
aarch64  aarch64-mx8m  all   maaxboard_ddr4_2g_sdcard

Add a script called dpkg-scan.sh

$ nano dpkg-scan.sh

Add

#!/bin/bash

ls -d */  | sed 's/\///' | cat | while IFS=' ' read -r item
do
echo "[$item] - Scan Packages and generate Packages.gz"
dpkg-scanpackages ${item} | gzip > ${item}/Packages.gz
done

$ sudo chmod +x ./dpkg-scan.sh

Exec ./dpkg-scan.sh everytime you build a new package:

./dpkg-scan.sh

Config web server

sudo nano /etc/nginx/sites-available/deb

Add

server {
    listen 80 default_server;
    server_name yocto_deb_packages;
    root /home/build/maaxboard/maaxboard-yocto/maaxboard/build/tmp/deploy/deb/;

    location / {
        autoindex on;
    }
}

Enable website

# Disable the nginx default site
$ sudo rm /etc/nginx/sites-enabled/default
$ sudo ln -s /etc/nginx/sites-available/deb /etc/nginx/sites-enabled/deb

Start / Stop nginx

$ sudo systemctl restart nginx

In your client web browser, check the website:

http://192.168.2.58/

MaaXBoard Config

Add Sources List

$ sudo nano /etc/apt/sources.list

Add

deb http://192.168.2.58/ aarch64/
deb http://192.168.2.58/ aarch64-mx8m/
deb http://192.168.2.58/ maaxboard_ddr4_2g_sdcard/
deb http://192.168.2.58/ all/

apt-get update

$ sudo rm -rf /var/lib/apt/lists/*
$ sudo apt-get update

Install packages

sudo apt-get install nano

ahnniu/meta-maaxboard