cirros-testvm/src-cirros/buildroot-2015.05/board/atmel/xplained/readme.txt

   1 Atmel SAMA5D3 Xplained board
   2 ============================
   3
   4 This document explains how to set up a basic Buildroot system on the
   5 Atmel SAMA5D3 Xplained board, whose main site is
   6 http://www.atmel.com/tools/ATSAMA5D3-XPLD.aspx. Additional details can
   7 also be found on the http://www.at91.com/linux4sam/bin/view/Linux4SAM/
   8 web site.
   9
  10 Note that the default Buildroot configuration is prepared to boot from
  11 an SD card: the first stage bootloader, second stage bootloader,
  12 kernel image and root filesystem are all located on the SD card. Some
  13 adjustements in the bootloader configuration will be needed to boot
  14 from NAND flash.
  15
  16 Configuring and building Buildroot
  17 ----------------------------------
  18
  19   make atmel_xplained_defconfig
  20   make
  21
  22 Preparing the SD card
  23 ---------------------
  24
  25 The SD card must be partitionned with at least two partitions: one
  26 FAT16 partition for the bootloaders, kernel image and Device Tree
  27 blob, and one ext4 partition for the root filesystem. To partition the
  28 SD card:
  29
  30 sudo sfdisk -uM /dev/mmcblk0 <<EOF
  31 ,64,6
  32 ;
  33 EOF
  34
  35 This creates a 64 MB partition for the FAT16 filesystem (type 6) and
  36 uses the rest for the ext4 filesystem used for the root filesystem.
  37
  38 Then, format both partitions:
  39
  40 sudo mkfs.msdos -n boot /dev/mmcblk0p1
  41 sudo mkfs.ext4 -L rootfs -O ^huge_file /dev/mmcblk0p2
  42
  43  Note: the -O ^huge_file option is needed to avoid enabling the huge
  44  files features of ext4 (to support files larges than 2 TB), which
  45  needs the kernel option CONFIG_LBDAF to be enabled.
  46
  47 Mount both partitions (if not done automatically by your system):
  48
  49 sudo mount /dev/mmcblk0p1 /media/boot
  50 sudo mount /dev/mmcblk0p2 /media/rootfs
  51
  52 Copy the bootloaders, kernel image and Device Tree blob to the first
  53 partition:
  54
  55 cp output/images/uboot-spl.bin /media/boot/boot.bin
  56 cp output/images/u-boot.img /media/boot/u-boot.img
  57 cp output/images/zImage /media/boot/zImage
  58 cp output/images/at91-sama5d3_xplained.dtb /media/boot/at91-sama5d3_xplained.dtb
  59
  60 Extract the root filesystem to the second partition:
  61
  62 sudo tar -C /media/rootfs -xf output/images/rootfs.tar
  63
  64 Unmount both partitions:
  65
  66 sudo umount /media/boot
  67 sudo umount /media/rootfs
  68
  69 Insert your SD card in your Xplained board, and enjoy. The default
  70 U-Boot environment will properly load the kernel and Device Tree blob
  71 from the first partition of the SD card, so everything works
  72 automatically.
  73