aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 2da222be5a5d8ddddf8b84b0b6bc8e7f00b96d13 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# Building a small Raspberry Pi System from Scratch

What you are looking at right now is a collection of instructions on how to
bootstrap a tiny system for a Raspberry Pi 3 board.

We will bootstrap the system by building our own cross compiler toolchain
and then using it to cross compile everything we need for a working Linux
based OS.

In contrast to similar guides, I try to explain why we are doing the things
the way we are doing them, instead of just throwing a bunch of copy-paste
command lines around (I'm looking at you, LFS).

This guide is divided into the following parts:

* [Basic Setup](00_setup.md). Lists some tools that you should have
  installed and walks through the steps of setting up the directory tree that
  we work in, as well as a few handy environment variables.
* [Building a cross compiler toolchain](01_crosscc.md).
* [Cross compiling a statically linked BusyBox and the kernel](02_kernel.md).
  The BusyBox is packaged into a small initramfs. We will make it boot on the
  Rapsberry Pi and explore some parts of the Linux boot process.
* [Building a more sophisticated userland](userland.md). Mostly a
  Linux-From-Scratch-Style "lets build some packages". The userland will be
  packed into a SquashFS image. The BusyBox based initrd is modified to mount
  it and switch into it.