vidal/rpiGenImage
Public Access
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge branch 'main' of https://depot.tremplin.ens-lyon.fr/vidal/rpiGenImage

Browse Source
This commit is contained in:
g-vidal
2025-10-28 14:06:40 +01:00
parent d626e903c8 d77b2c6b5f
commit 698e9d4398
1 changed files with 7 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
README.md
View File

@@ -1,15 +1,15 @@
# rpi23-gen-image
# rpiGenImage
## Introduction
`rpi23-gen-image.sh` is an advanced Debian Linux bootstrapping shell script for generating Debian OS images for all Raspberry Pi computers. The script at this time supports the bootstrapping of the Debian (armhf/armel) releases `stretch` and `buster`. Raspberry Pi 0/1/2/3/4 images are generated for 32-bit mode only. Raspberry Pi 3 supports 64-bit images that can be generated using custom configuration parameters (```templates/rpi3-stretch-arm64-4.14.y```).
`rpiGenImage.sh` is a Debian Linux bootstrapping shell script for generating Debian OS images for all Raspberry Pi computers. The script at this time supports the bootstrapping of the Debian (armhf/armel) releases `bookworm`, `trixie` and `forky`. Raspberry Pi 0/1/2/3/4 images are generated for 32-bit and 64_bit. Some configurations only are available Raspberry Pi 3 supports 64-bit images that can be generated using custom configuration parameters (```templates/rpi3-stretch-arm64-4.14.y```), contribute if you have written valid template.
## Build dependencies
The following list of Debian packages must be installed on the build system because they are essentially required for the bootstrapping process. The script will check if all required packages are installed and missing packages will be installed automatically if confirmed by the user.
```debootstrap debian-archive-keyring qemu-user-static binfmt-support dosfstools rsync bmap-tools whois git bc psmisc dbus sudo```
It is recommended to configure the `rpi23-gen-image.sh` script to build and install the latest Raspberry Pi Linux kernel. For the Raspberry 3 this is mandatory. Kernel compilation and linking will be performed on the build system using an ARM (armhf/armel/aarch64) cross-compiler toolchain.
It is recommended to configure the `rpGenImage.sh` script to build and install the latest Raspberry Pi Linux kernel. Kernel compilation and linking will be performed on the build system using an ARM (armhf/armel/aarch64) cross-compiler toolchain.
The script has been tested using the default `crossbuild-essential-armhf` and `crossbuild-essential-armel` toolchain meta packages on Debian Linux `stretch` build systems. Please check the [Debian CrossToolchains Wiki](https://wiki.debian.org/CrossToolchains) for further information.
The script has been tested using the default `crossbuild-essential-armhf` and `crossbuild-essential-armel` toolchain meta packages on Debian Linux `trixie` build systems. Please check the [Debian CrossToolchains Wiki](https://wiki.debian.org/CrossToolchains) for further information.
## Command-line parameters
The script accepts certain command-line parameters to enable or disable specific OS features, services and configuration settings. These parameters are passed to the `rpi23-gen-image.sh` script via (simple) shell-variables. Unlike environment shell-variables (simple) shell-variables are defined at the beginning of the command-line call of the `rpi23-gen-image.sh` script.
@@ -36,8 +36,8 @@ To avoid long lists of command-line parameters and to help to store the favourit
##### Command-line examples:
```shell
CONFIG_TEMPLATE=rpi3stretch ./rpi23-gen-image.sh
CONFIG_TEMPLATE=rpi2stretch ./rpi23-gen-image.sh
CONFIG_TEMPLATE=rpi3stretch ./rpGenImage.sh
CONFIG_TEMPLATE=rpi2stretch ./rpiGenImage.sh
```
## Working with the your template:
@@ -47,7 +47,7 @@ CONFIG_TEMPLATE=rpi2stretch ./rpi23-gen-image.sh
* **If it's not working as expected, search your option in all the files in this repository (With e.g.grep or notepad++).**
* **Check if your missing a required option while looking at the code**
## Supported parameters and settings
## Supported parameters and settings (this chapter requires review)
#### APT settings:
|Option|Value|default value|value format|desciption|