Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jfdelnero/LinuxFromScratch

Cross compiler + Linux system build scripts.
https://github.com/jfdelnero/LinuxFromScratch

cross-compiler-toolchain embedded-linux embedded-systems linux-from-scratch linux-router

Last synced: 7 days ago
JSON representation

Cross compiler + Linux system build scripts.

Host: GitHub
URL: https://github.com/jfdelnero/LinuxFromScratch
Owner: jfdelnero
Created: 2018-01-09T11:46:02.000Z (almost 7 years ago)
Default Branch: master
Last Pushed: 2024-04-18T15:48:30.000Z (7 months ago)
Last Synced: 2024-04-19T15:15:48.466Z (7 months ago)
Topics: cross-compiler-toolchain, embedded-linux, embedded-systems, linux-from-scratch, linux-router
Language: Shell
Size: 109 MB
Stars: 23
Watchers: 5
Forks: 13
Open Issues: 5
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# 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 :

```c
# 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

```c
./set_env.sh [TARGET_NAME]
```

To see the available targets just run :

```c
./set_env.sh
```

Once done you can build the target with this command :

```c
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 :

```c
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:

```c
init_sd.sh NOSTRIP
```

To clean up a target :

```c
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.