Skip to content

Latest commit

 

History

History
130 lines (77 loc) · 3.1 KB

README.md

File metadata and controls

130 lines (77 loc) · 3.1 KB
Raw

Linux From scratch build scripts

This repository contains my build system to cross-compile and build a complete embedded Linux system from sources. I use it for differents projects and targets : Router, Firewall, Set-top box, "Proof of concept" with differents evaluation boards... Various targets are currently supported : ARM, PowerPC, x86, FPGA SOC...

Requirement

A Linux machine with the "build-essential" package installed.

As example here are the commands to prepare and build a system for the Raspberry Pi Zero W on a freshly installed Linux Mint 20.1 machine :

# Install some missing build tools (C++ compiler,...)
sudo apt install build-essential

# Git is needed to checkout LinuxFromScratch
sudo apt install git

# Checkout LinuxFromScratch
git clone https://github.com/jfdelnero/LinuxFromScratch.git

# Select the Raspberry Pi Zero W target

cd LinuxFromScratch
./set_env.sh rpi_zero_w

# Build the system !
sysbuild.sh

Usage

To setup the build environnement run from the repository root folder

./set_env.sh [TARGET_NAME]

To see the available targets just run :

./set_env.sh

Once done you can build the target with this command :

sysbuild.sh

This will build the cross-compiler, glibc, kernel and all the target root file system... The whole process can take from 15 minutes to some hours depending of your setup.

Once done you can find the root-fs in the folder "targets/TARGET_NAME/root-fs".

To generate the disk image you can use the init_sd.sh script :

init_sd.sh

The boot and root partitions are then formatted and all files copied to the image. Please note that all binaries are stripped during the copy to the media. If you want to keep the debug informations, use the NOSTRIP argument:

init_sd.sh NOSTRIP

To clean up a target :

clean.sh

Folders description

/scripts : Contains the common build scripts.

/targets : Contains all targets

/targets/common/config : Contains the common/default configuration files.

/targets/[TARGET_NAME] : Target home directory.

/targets/[TARGET_NAME]/config : Target configuration.

/targets/[TARGET_NAME]/download (1) : Downloaded source archives.

/targets/[TARGET_NAME]/cross-tools (2) : Cross-compiler binaries.

/targets/[TARGET_NAME]/build (2) : Build folder.

/targets/[TARGET_NAME]/sources (2) : Unpacked sources.

/targets/[TARGET_NAME]/root-fs (2) : target root-fs.

/targets/[TARGET_NAME]/fs_mirror (2) : target root-fs stripped folder generated during the deployment (init_sd.sh).

/targets/[TARGET_NAME]/mount_point (2) : target flash media/disk mount point used during the deployment (init_sd.sh).

(1) Folders created during the build.

(2) Folders created during the build and deleted by the "clean.sh" command.

Some targets examples successfully tested

  • Altera/Intel Cyclone V DE10-Nano board.

  • Atmel Sama5D2 Xplained.

  • Raspberry PI 1/2/3/Zero (W).

  • Banana Pi R2.

  • BeagleBone Black.

  • NVidia Jetson TX2.

  • NXP P2020 Reference Design Board (PowerPC P2020).

  • OCEDO G50w (PowerPC P1020).

  • PC 486, PC 686, PC104 boards... (x86/x64)

  • Solid-run ClearFog.

(c) 2004-2023 Jean-François DEL NERO