kumquat-buildroot/board/raspberrypi/readme.txt
mathieu benoit 094d8ec896 configs: rename rpi_defconfig for consistency
We name all of our boards and defconfig files based on the boards
fullname, not a nickname or a shortname.

'rpi' is short for Raspberry Pi, so name all our Raspberry Pi ressource
with 'raspberrypi' instead of 'rpi'.

This should also help Buildroot-newcomers to recognise Raspberry Pi
related files (defconfig and board doc).

Signed-off-by: Mathieu Benoit <mathieu.benoit@savoirfairelinux.com>
[yann.morin.1998@free.fr: reverse the rename]
Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr>
Cc: Ryan Barnett <rjbarnet@rockwellcollins.com>
Cc: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
2013-11-10 22:18:52 +01:00

129 lines
3.4 KiB
Plaintext

RaspberryPi
Intro
=====
To be able to use your RaspberryPi board with the images generated by
Buildroot, you have to choose whether you will use:
* Volatile rootfs in RAM (the rootfs is an initramfs) or
* Persistent rootfs on the SDCard
Also, a good source of information is http://elinux.org/R-Pi_Hub
How to build it
===============
Configure Buildroot
-------------------
The raspberrypi_defconfig configuration is a minimal configuration with
all that is required to bring the Raspberry Pi. You should base your
work on this defconfig:
$ make raspberrypi_defconfig
If you want to use a persistent rootfs, skip to "Build the rootfs", below.
For a volatile rootfs, you have to slightly adjust the configuration:
$ make menuconfig
* Select "Filesystem images"
* Select "initial RAM filesystem linked into linux kernel"
You may also deselect "tar the root filesystem".
Build the rootfs
----------------
Note: you will need to have access to the network, since Buildroot will
download the packages' sources.
You may now build your rootfs with:
$ make
(This may take a while; consider getting yourself a coffee ;-) )
Result of the build
-------------------
After building, you should obtain this tree:
output/images/
+-- rootfs.tar
+-- rpi-firmware
| +-- bootcode.bin
| +-- config.txt
| +-- fixup_cd.dat
| +-- fixup.dat
| +-- start_cd.elf
| `-- start.elf
`-- zImage
Note for Volatile: rootfs.tar will only be there if you kept
"tar the root filesystem" option selected in "Filesystem images".
Prepare you SDCard
==================
For more information, visit
http://elinux.org/RPi_Advanced_Setup#Advanced_SD_card_setup
In summary, your SDCard must have first partition in fat32 and marked bootable.
Create the required partitions:
- for a persistent rootfs, 10MiB is enough memory for the boot fat32
partition, and a second partition is required for the root filesystem
- for a volatile rootfs, 50MiB is required for the boot fat32 partition
Note: You can create any number of partitions you desire, the only requirement
is that the first partition must be using fat32 and be bootable.
Mount the partitions (adjust 'sdX' to match your SDcard device):
$ sudo mount /dev/sdX1 /mnt/mountpointboot
$ sudo mount /dev/sdX2 /mnt/mountpointroot (only for persistent rootfs)
Install the binaries to the SDCard
----------------------------------
At the root of the boot partition, the RaspberryPi must find the following
files:
* bootcode.bin
* config.txt
* fixup.dat
* start.elf
* zImage
For example:
$ cp output/images/rpi-firmware/* /mnt/mountpointboot
$ cp output/images/zImage /mnt/mountpointboot/zImage.img
Note: The default name is kernel.img.
Actually, the name is zImage and it's define in the file config.txt like:
kernel=zImage
If you use a volatile rootfs, Skip to "Finish", below. For a persistent
rootfs, there are further steps to do.
Extract (as root!) the contents of the rootfs.tar archive into the second
partition you created above:
$ sudo tar xf rootfs.tar -C /mnt/mountpointroot
Finish
======
Unmount all the partitions:
$ sudo umount /mnt/mountpointboot
$ sudo umount /mnt/mountpointroot (only for persistent rootfs)
And eject your SDcard from your computer SDcard reader.
Insert the SDcard into your Raspberry Pi, and power it up. Your new system
should come up, now.