Build Ubuntu/Debian Images

Build Ubuntu/Debian images with Fenix.

Host Setup

1
2
3
$ sudo apt-get update
$ sudo apt-get upgrade
$ sudo apt-get install git make lsb-release qemu-user-static

Clone the Fenix Repository

Clone the Fenix repository to: ~/project

1
2
3
$ mkdir ~/project
$ cd ~/project/
$ git clone --depth 1 https://github.com/khadas/fenix

Setup the Build Environment

You should setup the build environment first.

For example: Board type, Linux version, distribution, etc.

1
2
$ cd ~/project/fenix
$ source env/setenv.sh

Build the Image

As root, build the image with Fenix.

1
$ make

Tip: If this is your first time building an image, the script will check your host’s environment and install some essential packages. In addition, repositories (U-Boot, Linux) will be cloned automatically from the Khadas GitHub.

Build U-Boot

1
$ make uboot

Build the U-Boot Debian Package

1
$ make uboot-deb

Build Linux

1
$ make kernel

Build the Linux Debian Package

1
$ make kernel-deb

Build the GPU Debian Package

1
$ make gpu-deb

Build the Board Debian Package

1
$ make board-deb

Build all Debian Packages

1
$ make debs

Build U-Boot Image

1
$ make uboot-image

Clean the Linux Source Tree

1
$ make kernel-clean

Show Linux Menuconfig

1
$ make kernel-config

Save the Linux Defconfig

1
$ make kernel-saveconfig

Clean U-Boot Source Tree

1
$ make uboot-clean

Help Messages

You can get help messages by executing make help:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
$ make help
Fenix scripts help messages:
  all                   - Create image according to environment.
  kernel                - Build linux kernel.
  kernel-clean          - Clean linux source tree.
  kernel-config         - Show linux menuconfig.
  kernel-saveconfig     - Save linux defconfig.
  uboot                 - Build u-boot.
  uboot-clean           - Clean u-boot source tree.
  uboot-deb             - Build u-boot debian package.
  uboot-image           - Build minimal image only with u-boot.
  kernel-deb            - Build linux debian package.
  board-deb             - Build board debian package.
  common-deb            - Build common debian package.
  desktop-deb           - Build desktop debian package.
  gpu-deb               - Build gpu debian package.
  debs                  - Build all debian packages.
  image                 - Pack update image.
  clean                 - Cleanup.
  info                  - Display current environment.
  get-make-params       - Get available make parameters.

Build Options

Options for building:

  • NO_CCACHE - ccache option

    • Enable ccache (default)
      • NO_CCACHE=no make
    • Disable ccache
      • NO_CCACHE=yes make

  • COMPRESS_IMAGE - compress build image option

    • Don’t compress (default)
      • COMPRESS_IMAGE=no make
    • Compress image with xz
      • COMPRESS_IMAGE=yes make

  • BUILD_TYPE - image build type option

    • Develop build
      • BUILD_TYPE=develop make
    • Release build
      • BUILD_TYPE=release make

Build Fenix in Docker

Fenix is supported by Docker. We provide a Ubuntu 20.04 build host, so you can build all images in Docker.

Install Docker

Please refer to Docker Documentation.

Add User to a Docker Group

1
$ sudo usermod -aG docker $USER

Note: You need to logout or reboot the system for changes to take effect.

Run Docker

1
$ docker run hello-world

If you see the following print-out, Docker has installed successfully:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
ca4f61b1923c: Pull complete
Digest: sha256:be0cd392e45be79ffeffa6b05338b98ebb16c87b255f48e297ec7f98e123905c
Status: Downloaded newer image for hello-world:latest

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
    (amd64)
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
 $ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:
 https://cloud.docker.com/

For more examples and ideas, visit:
 https://docs.docker.com/engine/userguide/

Run Fenix in Docker

Get Docker image:

1
2
$ cd ~/project/fenix
$ docker pull numbqq/fenix:latest

Build image in Docker:

1
2
3
4
5
6
7
$ docker run -it --name fenix -v $(pwd):/home/khadas/fenix \
             -v /etc/localtime:/etc/localtime:ro \
             -v /etc/timezone:/etc/timezone:ro \
             -v $HOME/.ccache:/home/khadas/.ccache --privileged \
             --device=/dev/loop-control:/dev/loop-control \
             --device=/dev/loop0:/dev/loop0 --cap-add SYS_ADMIN \
             numbqq/fenix

Start your build from inside the Docker container.

1
2
khadas@919cab43f66d:~/fenix$ source env/setenv.sh
khadas@919cab43f66d:~/fenix$ make

Restart the Docker container.

1
2
$ docker start fenix
$ docker exec -ti fenix bash

Get the Latest Nightly build

  • See Fenix(one-stop script)
  • Release Build, Test Build Ubuntu, Test Build Debian
    image
  • You can see the firmware page when you click on the latest workflow

See Also

Docker