mirror of
https://github.com/pygos/build.git
synced 2024-11-25 12:20:42 +01:00
110 lines
3.9 KiB
Markdown
110 lines
3.9 KiB
Markdown
# Pygos GNU/Linux
|
|
|
|
## Overview
|
|
|
|
This directory contains the build system for Pygos GNU/Linux, a small, heavily
|
|
customizable operating system for embedded devices and other special purpose
|
|
systems.
|
|
|
|
The build system generates a compressed, read only root filesystem image, boot
|
|
loader, kernel binary and a setup script for installing the system on the target
|
|
board, all bundled up in a release tar ball.
|
|
|
|
An additional disk partition or UBI volume is created for mutable configuration
|
|
files with overlay mount points for directories like /etc or /var/lib.
|
|
|
|
For details on the Pygos file system layout, see
|
|
[docs/filesystem.md](docs/filesystem.md).
|
|
|
|
An automated firmware update mechanism is currently still in development.
|
|
For details, see [docs/update.md](docs/update.md).
|
|
|
|
The build system in this directory downloads the necessary source packages,
|
|
builds a cross compiler toolchain and compiles the entire system from scratch
|
|
for the intended target.
|
|
|
|
For details on how the build system works or how to add or configure packages,
|
|
see [docs/build.md](docs/build.md).
|
|
|
|
For an overview of the available documentation see [docs/index.md](docs/index.md).
|
|
|
|
By the way, before you ask: the default root password for the demo setup is
|
|
*reindeerflotilla*.
|
|
|
|
The wireless network is called *Pygos Demo Net* and the password
|
|
is *righteous*.
|
|
|
|
## Target configuration
|
|
|
|
The Pygos build system is driven by toolchain and package configurations
|
|
that are divided into two categories:
|
|
|
|
- Board specific settings
|
|
- Mostly board specific cross toolchain and kernel configuration
|
|
- Can specify a minimal set of packages required for minimal operation
|
|
of the board
|
|
- Product specific settings
|
|
- Specifies a list of boards for which the product can be built
|
|
- Specifies and configures extra packages needed
|
|
- Can override board settings and provide configuration files
|
|
specific to *that* product running on *that* board
|
|
|
|
### Demo configuration
|
|
|
|
The system currently contains configurations that allows it to run on the
|
|
following boards:
|
|
|
|
- Raspberry Pi 3 (ARM, 32 bit)
|
|
- pc-engines ALIX board (x86, 32 bit)
|
|
|
|
The following demo product configurations exist:
|
|
|
|
- "router" builds on all boards. On the Raspberry Pi 3, a wireless network
|
|
is created. A DHPC server serves IP addresses and configures the board as
|
|
default gateway and DNS server. DNS queries are resolved using a local
|
|
unbound resolver. The ethernet interface is configured via DHCP and packets
|
|
are NAT translated and forwarded. On the ALIX board, the DHCP server serves
|
|
on two interfaces and the third interface is used for upstream forwarding.
|
|
|
|
|
|
|
|
## How to build the system
|
|
|
|
The system can be built by running the mk.sh script as follows:
|
|
|
|
mk.sh <board> <product>
|
|
|
|
This will start to download and build the cross toolchain and system in the
|
|
current working directory. The command can (and should) be run from somewhere
|
|
outside the source tree.
|
|
|
|
Once the script is done, the final release package is stored in the following
|
|
location (relative to the build directory):
|
|
|
|
deploy/release-<board>/release-<board>.tar.gz
|
|
|
|
## Directory overview
|
|
|
|
The build system directory contains the following files and sub directories:
|
|
|
|
- board/
|
|
Contains the board specific configuration files. E.g. board/alix/ holds
|
|
files specific for the ALIX board.
|
|
- docs/
|
|
Contains further documentation that goes into more detailed aspects of
|
|
the build system and the final Pygos installation itself.
|
|
- pkg/
|
|
Contains package build scripts. Each package occupies a sub directory
|
|
with a script named "build" that is used to download, compile and
|
|
install the package.
|
|
- product/
|
|
Contains product specific configuration files. E.g. product/router/ holds
|
|
files for the "router" product.
|
|
- util/
|
|
Contains utility scripts used by mk.sh
|
|
- LICENSE
|
|
A copy of the GNU GPLv3
|
|
- mk.sh
|
|
The main build script that builds the entire system
|
|
- README.md
|
|
This file
|