Buildroot Setup for Kumquat

Introduction

This section guides you through the process of cloning the Buildroot Git repository and creating your first custom Linux image for the Kumquat board. By following these steps, you can build, customize, and generate an SD card image tailored to your Kumquat hardware.

This guide is intended for developers and advanced users who are comfortable working in a Linux environment and building embedded Linux systems from source.

Prerequisites

Before proceeding, ensure you have:

  • A host system running:
  • A Debian-based Linux distribution or
  • Windows Subsystem for Linux 2 (WSL2) with a Debian-based distro
  • The required build dependencies installed via apt:
sudo apt update
sudo apt install -y \
  sed make binutils build-essential diffutils gcc g++ bash patch \
  gzip bzip2 perl tar cpio unzip rsync file bc findutils wget git
````

⚠️ Buildroot builds can take a significant amount of time and disk space, depending on system performance.

---

## Step 1: Clone the Buildroot Repository

1. Open a terminal on your host system.
2. Clone the NetCube Systems Buildroot repository:

```shell
git clone https://gitlab.com/netcube-systems-austria/buildroot.git

Clone Repository

Step 2: Configure the Build

  1. Change into the cloned repository directory:
cd buildroot
  1. Configure Buildroot for the Kumquat board by running:
make netcube_kumquat_defconfig

This selects the default configuration for the Kumquat board, including the appropriate bootloader, kernel, and root filesystem settings.

Select Configuration

Step 3: Build the Image

  1. Start the build process:
make
  1. The build may take anywhere from several minutes to a few hours depending on your system’s performance. Progress will be displayed in the terminal.

Step 4: Obtain the Built Image

  1. After the build completes, navigate to the output images directory:
output/images/

  1. You will find a file named:

  2. sdcard.img

This file is your custom-built Linux image for the Kumquat board and can be written directly to an SD card.

Built Image

Step 5: Customize the Build (Optional)

  1. To customize the Buildroot configuration, run:
make menuconfig

Buildroot Menuconfig

  1. Adjust the configuration as desired (packages, kernel options, filesystem layout, etc.).
  2. Save your changes and rebuild the image:
make

A new sdcard.img will be generated reflecting your changes.

Conclusion

You have successfully cloned the Buildroot repository, configured it for the Kumquat board, and built a custom Linux image. From here, you can continue iterating on your configuration, integrate your own software, and adapt the system to your project’s requirements.

For detailed information on Buildroot configuration and advanced usage, refer to the official Buildroot documentation: https://buildroot.org/downloads/manual/manual.html