Image specs for the raspi build.
Go to file
Andres Salomon 0304a4e5b9 pi4: remove wget hack needed for the wifi driver
This nvram file is now included in firmware-brcm80211 as of 20200421-1
(which is in both unstable and testing).
2020-07-22 17:35:27 -04:00
debos Add debos recipe for raspberrypi ARM64-based boards 2019-11-25 12:21:06 +01:00
.gitignore gitignore: Add raspi_4.yaml 2020-07-01 04:21:57 +09:00
.gitmodules The images build with Buster's vmdb2 - no need to include it as a submodule anymore 2019-07-18 12:57:20 -03:00
LICENSE Initial commit 2017-10-08 22:48:29 +02:00
Makefile pi4: remove wget hack needed for the wifi driver 2020-07-22 17:35:27 -04:00
README.md fix minor typo in documentation 2020-07-06 00:03:39 -04:00
compress.sh Switch to xz compression 2018-01-08 22:47:43 +01:00
eth0 Merge remote-tracking branch 'dilinger/raspi4' 2020-06-30 18:05:50 +09:00
fstab FAT labels should be uppercase 2018-12-04 18:39:03 -06:00
raspi1_b0rken.yaml Fix remaining references to rpi3 (instead of rpi) 2019-07-19 09:50:16 -03:00
raspi1_uboot_b0rken.yaml Fix remaining references to rpi3 (instead of rpi) 2019-07-19 09:50:16 -03:00
raspi_master.yaml Merge branch 'liw/shquote' into 'master' 2020-05-24 21:55:02 +00:00
rpi-generate-ssh-host-keys.service Change references from rpi3-* to rpi-* 2019-07-18 21:18:59 -03:00
rpi-resizerootfs Update rpi-resizerootfs 2020-06-20 11:28:24 +00:00
rpi-resizerootfs.service Change references from rpi3-* to rpi-* 2019-07-18 21:18:59 -03:00
rpi-set-sysconf Regenerate sysconf.txt once it has been processed 2019-07-19 22:40:14 -03:00
rpi-set-sysconf.service Regenerate sysconf.txt once it has been processed 2019-07-19 22:40:14 -03:00
sysconf.txt Regenerate sysconf.txt once it has been processed 2019-07-19 22:40:14 -03:00

README.md

Raspberry Pi image specs

This repository contains the files with which the images referenced at https://wiki.debian.org/RaspberryPiImages have been built.

Option 1: Downloading an image

See https://wiki.debian.org/RaspberryPiImages for where to obtain the latest pre-built image.

Option 2: Building your own image

If you prefer, you can build a Debian buster Raspberry Pi image yourself. If you are reading this document online, you should first clone this repository:

git clone --recursive https://salsa.debian.org/raspi-team/image-specs.git
cd image-specs

For this you will first need to install the vmdb2 package, on a Debian Buster or higher system.

This repository includes a master YAML recipe (which is basically a configuration file) for all of the generated images, diverting as little as possible in a parametrized way. The master recipe is raspi_master.yaml.

A Makefile is supplied to drive the build of the recipes into images — raspi_0w (for the Raspberry Pi 0, 0w and 1, models A and B), raspi_2 (for the Raspberry Pi 2, models A and B) and raspi_3 (models A, B, B+). That is, if you want to build the default image for a Raspberry Pi 3B+, you can just issue:

   make raspi_3.img

You might also want to edit them to customize the built image. If you want to start from the platform-specific recipe, you can issue:

   make raspi_3.yaml

The recipe drives vmdb2, the successor to vmdebootstrap. Please refer to its documentation for further details; it is quite an easy format to understand.

Copy the generated file to a name descriptive enough for you (say, my_raspi.yaml). Once you have edited the recipe for your specific needs, you can generate the image by issuing the following (as root):

    vmdb2 --rootfs-tarball=my_raspi.tar.gz --output \
	my_raspi.img my_raspi.yaml --log my_raspi.log

This is, just follow what is done by the _build_img target of the Makefile.

Installing the image onto the Raspberry Pi

Plug an SD card which you would like to entirely overwrite into your SD card reader.

Assuming your SD card reader provides the device /dev/mmcblk0 (Beware If you choose the wrong device, you might overwrite important parts of your system. Double check it's the correct device!), copy the image onto the SD card:

sudo dd if=raspi_3.img of=/dev/mmcblk0 bs=64k oflag=dsync status=progress

Then, plug the SD card into the Raspberry Pi, and power it up.

The image uses the hostname rpi0w, rpi2 or rpi3 depending on the target build. The provided image will allow you to log in with the root account with no password set, but only logging in at the physical console (be it serial or by USB keyboard and HDMI monitor).