debos-radxa

Introduction

This guide describes how to use debos-radxa, based on debos, to generate Debian/Ubuntu image for Radxa boards.

Please note that the release are auto generated builds without additional testing, if you have issues with the images, please submit an issue.

Supported boards and system images

• Radxa CM3 IO
• Radxa E23
• Radxa E25
• Radxa NX5
• Radxa Zero
• Radxa Zero 2
• ROCK 3A
• ROCK 3B
• ROCK 3C
• ROCK 5A
• ROCK 5B
• ROCK 4B
• ROCK 4C+

Auto generated build images: https://github.com/radxa/debos-radxa/releases/latest

Build Host PC

Required Packages for the Build Host PC

You must install essential host packages on your build host.

The following command installs the host packages on an Ubuntu distribution.

$ sudo apt-get install -y git

The following command installs the host packages on an Debian distribution.

$ sudo apt-get install -y git user-mode-linux libslirp-helper

Install Docker Engine on Ubuntu

See Docker Docs installing Docker Engine on Ubuntu.

Use Git to Clone debos-radxa

radxa@x86-64:~$ cd ~
radxa@x86-64:~$ git clone https://github.com/radxa/debos-radxa.git

Build Your Image

Get supported board system images

radxa@x86-64:~$ cd ~/debos-radxa/
radxa@x86-64:~/debos-radxa$ docker run --rm --interactive --tty --tmpfs /dev/shm:rw,nosuid,nodev,exec,size=4g --user $(id -u) --security-opt label=disable \
--workdir $PWD --mount "type=bind,source=$PWD,destination=$PWD" --entrypoint ./build-os.sh godebos/debos
TOP DIR = /build/stephen/debos-radxa
====USAGE: ./build-os.sh -b  -m  -v ====
Board list:
    radxa-cm3-io
    radxa-e23
    radxa-e25
    radxa-nx5
    radxa-zero
    radxa-zero2
    rockpi-4b
    rock-4c-plus
    rock-3a
    rock-3b
    rock-3c
    rock-5a
    rock-5b

Model list:
    debian
    ubuntu

Variant list:
    xfce4
    server

Build system image

Exanple: Build ROCK 5B Debian11 Xfce4 image

radxa@x86-64:~$ cd ~/debos-radxa/
radxa@x86-64:~/debos-radxa$
radxa@x86-64:~/debos-radxa$ docker run --rm --interactive --tty --tmpfs /dev/shm:rw,nosuid,nodev,exec,size=4g --user $(id -u) --security-opt label=disable \
--workdir $PWD --mount "type=bind,source=$PWD,destination=$PWD" --entrypoint ./build-os.sh godebos/debos -b rock-5b -m debian -v xfce4

Example: Build ROCK 3A Ubuntu20 server image

radxa@x86-64:~$ cd ~/debos-radxa/
radxa@x86-64:~/debos-radxa$
radxa@x86-64:~/debos-radxa$ docker run --rm --interactive --tty --tmpfs /dev/shm:rw,nosuid,nodev,exec,size=4g --user $(id -u) --security-opt label=disable \
--workdir $PWD --mount "type=bind,source=$PWD,destination=$PWD" --entrypoint ./build-os.sh godebos/debos -b rock-3a -m ubuntu -v server

The generated system images will be copied to ./output direcotry.

How to debug errors

Launch dev-shell to get a shell inside debos docker. You can then run build-os.sh to monitor the build status. debos mounts root partition at /scratch/mnt, and boot partition is mounted at /scratch/mnt/boot. You can also chroot /scratch/mnt to examine the file system.

Currently dev-shell uses a custom docker image to build, so your result might be different from GitHub build. If you want to reproduce GitHub build please use the command from Usage section.

Add support for new boards

./configs/boards are board-specific debos recipes.

./rootfs/packages contains additional packages.

Default settings

• Default non-root user: rock (password: rock)
• Automatically load Bluetooth firmware after startup
• The first boot will resize root filesystem to use all available disk space
• SSH installed by default
• Hostname: board_name