NetCube-Systems-Austria/kumquat-readthedocs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
0812061eb1
kumquat-readthedocs/docs/buildroot-setup.md
Lukas Schmid 0812061eb1 Add py3-requirements
2024-04-25 09:49:09 +02:00

2.4 KiB
Raw Blame History

Buildroot Setup

Introduction

In this section, we'll guide you through the process of cloning the Git repository containing the source for Buildroot and creating your first build for the Kumquat board. Follow these steps to customize and build your own Linux image for your Kumquat board.

Prerequisites

Before proceeding, ensure that you have:

  • A computer running a Debian-based distribution or Windows Subsystem for Linux 2 (WSL2) with a Debian-based distro.
  • Installed the following packages using 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

Step 1: Clone Buildroot Repository

  1. Open a terminal on your computer.
  2. Clone the Buildroot repository by running the following command:
git clone https://git.netcubesystems.at/NetCube-Systems-Austria/kumquat-buildroot.git

Clone Repository

Step 2: Configure the Build

  1. Change directory into the newly cloned Git folder:
cd kumquat-buildroot
  1. Configure the Buildroot project for the Kumquat board by running:
make netcube_kumquat_defconfig

Select Configuration

Step 3: Build the Image

  1. Start the build process by running:
make
  1. The build process will take some time (could be a few hours depending on your system's performance). Monitor the progress in the terminal.

Step 4: Obtain the Built Image

  1. Once the build finishes, navigate to the output/images folder within the Buildroot directory.
  2. You will find a new file named "sdcard.img". This is your custom-built Linux image for the Kumquat board.

Built Image

Step 5: Customize the Build (Optional)

  1. If you wish to customize the Buildroot installation, run:
make menuconfig

Buildroot Menuconfig

  1. Make your desired changes in the configuration menu.
  2. After making changes, save the configuration and run make again to create a new "sdcard.img".

Conclusion

Congratulations! You have successfully cloned the Buildroot repository, configured your first build for the Kumquat board, and created a custom Linux image. Feel free to explore further customization options using Buildroot's documentation available at Buildroot Manual.