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

tangzhi1996/debos-radxa