summaryrefslogtreecommitdiff
path: root/board/atmel
diff options
context:
space:
mode:
authorThomas Petazzoni <thomas.petazzoni@free-electrons.com>2014-06-15 15:33:49 +0200
committerThomas Petazzoni <thomas.petazzoni@free-electrons.com>2014-06-29 10:54:29 +0200
commit54a653f649d131f8a038fc1314383b60294ad351 (patch)
tree4029ce9893c89b6b012535998573ff733d2bd4e2 /board/atmel
parent23a94e9d67bc9e347378548076fa7f9a6dcc0b52 (diff)
configs: add defconfig for the Atmel SAMA5D3 Xplained board
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
Diffstat (limited to 'board/atmel')
-rw-r--r--board/atmel/xplained/readme.txt73
1 files changed, 73 insertions, 0 deletions
diff --git a/board/atmel/xplained/readme.txt b/board/atmel/xplained/readme.txt
new file mode 100644
index 000000000..e29a11688
--- /dev/null
+++ b/board/atmel/xplained/readme.txt
@@ -0,0 +1,73 @@
+Atmel SAMA5D3 Xplained board
+============================
+
+This document explains how to set up a basic Buildroot system on the
+Atmel SAMA5D3 Xplained board, whose main site is
+http://www.atmel.com/tools/ATSAMA5D3-XPLD.aspx. Additional details can
+also be found on the http://www.at91.com/linux4sam/bin/view/Linux4SAM/
+web site.
+
+Note that the default Buildroot configuration is prepared to boot from
+an SD card: the first stage bootloader, second stage bootloader,
+kernel image and root filesystem are all located on the SD card. Some
+adjustements in the bootloader configuration will be needed to boot
+from NAND flash.
+
+Configuring and building Buildroot
+----------------------------------
+
+ make atmel_xplained_defconfig
+ make
+
+Preparing the SD card
+---------------------
+
+The SD card must be partitionned with at least two partitions: one
+FAT16 partition for the bootloaders, kernel image and Device Tree
+blob, and one ext4 partition for the root filesystem. To partition the
+SD card:
+
+sudo sfdisk -uM /dev/mmcblk0 <<EOF
+,64,6
+;
+EOF
+
+This creates a 64 MB partition for the FAT16 filesystem (type 6) and
+uses the rest for the ext4 filesystem used for the root filesystem.
+
+Then, format both partitions:
+
+sudo mkfs.msdos -n boot /dev/mmcblk0p1
+sudo mkfs.ext4 -L rootfs -O ^huge_file /dev/mmcblk0p2
+
+ Note: the -O ^huge_file option is needed to avoid enabling the huge
+ files features of ext4 (to support files larges than 2 TB), which
+ needs the kernel option CONFIG_LBDAF to be enabled.
+
+Mount both partitions (if not done automatically by your system):
+
+sudo mount /dev/mmcblk0p1 /media/boot
+sudo mount /dev/mmcblk0p2 /media/rootfs
+
+Copy the bootloaders, kernel image and Device Tree blob to the first
+partition:
+
+cp output/images/sama5d3_xplained-sdcardboot-uboot-3.6.2.bin /media/boot/boot.bin
+cp output/images/u-boot.bin /media/boot/u-boot.bin
+cp output/images/zImage /media/boot/zImage
+cp output/images/at91-sama5d3_xplained.dtb /media/boot/at91-sama5d3_xplained.dtb
+
+Extract the root filesystem to the second partition:
+
+sudo tar -C /media/rootfs -xf output/images/rootfs.tar
+
+Unmount both partitions:
+
+sudo umount /media/boot
+sudo umount /media/rootfs
+
+Insert your SD card in your Xplained board, and enjoy. The default
+U-Boot environment will properly load the kernel and Device Tree blob
+from the first partition of the SD card, so everything works
+automatically.
+