Getting Started

Install dependencies

Debian 12 / Ubuntu 22.04

sudo apt update
sudo apt install -y git qemu-user-static binfmt-support

# Podman (recommended)
sudo apt install -y podman podman-docker
sudo touch /etc/containers/nodocker
# Docker
#sudo apt install docker.io

# Optional dependcies for minor features
sudo apt install -y systemd-container

Check out the code

bsp uses git submodules. As such, please check out the code with the following command:

git clone --recurse-submodules https://github.com/radxa-repo/bsp.git

Understand `bsp`'s usage

Once the repo is cloned on your machine, you can run bsp to check the built-in help:

Tip

The built-in help is intended as the first step to troubleshoot for bsp usage, while the documentation site covers more about high level applications and low level implementation details. As such, you are more likely to find your questions solved by an option listed in the built-in help.

It is strongly recommended to read the built-in help at once, if you want to do anything beyond the trival package rebuild.

cd bsp
./bsp

Build your first packages

bsp now supports building kernel and U-Boot in a single step, and specify them by product name instead of specific profiles. This should help new users to test their setup without much bsp knowledge:

# The following command will build linux-stable
# and u-boot-latest for radxa-zero
./bsp radxa-zero

Custom kernel/firmware developer should at least read the Development reference section to better understand the development workflow and the internal data sctructure for bsp.