board/raspberrypi/readme.txt

   1 Raspberry Pi
   2
   3 Intro
   4 =====
   5
   6 These instructions apply to all models of the Raspberry Pi:
   7   - the original models A and B,
   8   - the "enhanced" models A+ and B+,
   9   - the model B2 (aka Raspberry Pi 2)
  10   - the model B3 (aka Raspberry Pi 3).
  11
  12 How to build it
  13 ===============
  14
  15 Configure Buildroot
  16 -------------------
  17
  18 There are two RaspberryPi defconfig files in Buildroot, one for each
  19 major variant, which you should base your work on:
  20
  21 For models A, B, A+ or B+:
  22
  23   $ make raspberrypi_defconfig
  24
  25 For model 2 B:
  26
  27   $ make raspberrypi2_defconfig
  28
  29 For model 3 B:
  30
  31   $ make raspberrypi3_defconfig
  32
  33 Build the rootfs
  34 ----------------
  35
  36 Note: you will need to have access to the network, since Buildroot will
  37 download the packages' sources.
  38
  39 You may now build your rootfs with:
  40
  41   $ make
  42
  43 (This may take a while, consider getting yourself a coffee ;-) )
  44
  45 Result of the build
  46 -------------------
  47
  48 After building, you should obtain this tree:
  49
  50     output/images/
  51     +-- bcm2708-rpi-b.dtb           [1]
  52     +-- bcm2708-rpi-b-plus.dtb      [1]
  53     +-- bcm2709-rpi-2-b.dtb         [1]
  54     +-- bcm2710-rpi-3-b.dtb         [1]
  55     +-- boot.vfat
  56     +-- kernel-marked/zImage        [2]
  57     +-- rootfs.ext4
  58     +-- rpi-firmware/
  59     |   +-- bootcode.bin
  60     |   +-- cmdline.txt
  61     |   +-- config.txt
  62     |   +-- fixup.dat
  63     |   +-- start.elf
  64     |   `-- overlays/               [3]
  65     +-- sdcard.img
  66     `-- zImage
  67
  68 [1] Not all of them will be present, depending on the RaspberryPi
  69     model you are using.
  70
  71 [2] This is the mkknlimg DT-marked kernel.
  72
  73 [3] Only for the Raspberry Pi 3 Model (overlay pi3-miniuart-bt is needed
  74     to enable the RPi3 serial console otherwise occupied by the bluetooth
  75     chip). Alternative would be to disable the serial console in cmdline.txt
  76     and /etc/inittab.
  77
  78 How to write the SD card
  79 ========================
  80
  81 Once the build process is finished you will have an image called "sdcard.img"
  82 in the output/images/ directory.
  83
  84 Copy the bootable "sdcard.img" onto an SD card with "dd":
  85
  86   $ sudo dd if=output/images/sdcard.img of=/dev/sdX
  87
  88 Insert the SDcard into your Raspberry Pi, and power it up. Your new system
  89 should come up now and start two consoles: one on the serial port on
  90 the P1 header, one on the HDMI output where you can login using a USB
  91 keyboard.