board/atmel: merge and update documentation
There were two readme files (one for flashing on NAND and one to create a SD card) in different places. Merge them and update the SD card generation part since all Xplained boards are supported and the -u option of sfdisk is obsolete on latest versions. Signed-off-by: Ludovic Desroches <ludovic.desroches@atmel.com> [Thomas: adjust the explanations, move the SD card section after the NAND flash section.] Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
This commit is contained in:
ludovic.desroches@atmel.com
Thomas Petazzoni
parent
dc3e4377e7
commit
358013d699
board/atmel
@ -1,10 +1,6 @@
|
||||
Flashing the NAND using SAM-BA
|
||||
==============================
|
||||
|
||||
This document explains how to flash a basic Buildroot system on various
|
||||
Atmel boards. Additional details can
|
||||
also be found on the Linux4SAM website, in particular here:
|
||||
http://www.at91.com/linux4sam/bin/view/Linux4SAM/GettingStarted
|
||||
This document explains how to set up a basic Buildroot system on various
|
||||
Atmel boards. Additional details can also be found on the Linux4SAM website:
|
||||
http://www.at91.com/linux4sam/bin/view/Linux4SAM/
|
||||
|
||||
This guide covers the following configurations:
|
||||
- at91sam9g45m10ek_defconfig
|
||||
@ -14,20 +10,35 @@ This guide covers the following configurations:
|
||||
- atmel_sama5d3xek_defconfig (sama5d31, sama5d33, sama5d34, sama5d35,
|
||||
sama5d36)
|
||||
- atmel_sama5d3_xplained_defconfig
|
||||
- atmel_sama5d3_xplained_mmc_defconfig
|
||||
- atmel_sama5d4ek_defconfig
|
||||
- atmel_sama5d4_xplained_defconfig
|
||||
- atmel_sama5d4_xplained_mmc_defconfig
|
||||
- atmel_sama5d2_xplained_mmc_defconfig
|
||||
|
||||
These configurations will use AT91Bootstrap, u-boot and a linux kernel from
|
||||
the git trees maintained by Atmel. They also build u-boot SPL when
|
||||
available, it can replace AT91Bootstrap.
|
||||
|
||||
the git trees maintained by Atmel.
|
||||
|
||||
Configuring and building Buildroot
|
||||
----------------------------------
|
||||
==================================
|
||||
|
||||
For most configurations listed above, the Buildroot configuration
|
||||
assumes the system will be flashed on NAND. In this case, after
|
||||
building Buildroot, follow the instructions in the "Flashing the NAND
|
||||
using SAM-BA" section below.
|
||||
|
||||
For the Xplained boards, an alternative Buildroot configuration is
|
||||
provided to boot from an SD card. Those configurations are labeled as
|
||||
'mmc'. In this case, after building Buildroot, follow the instructions
|
||||
in the "Preparting the SD card" sction.
|
||||
|
||||
To configure and build Buildroot, run:
|
||||
|
||||
make <board>_defconfig
|
||||
make
|
||||
|
||||
Flashing the NAND using SAM-BA
|
||||
==============================
|
||||
|
||||
Flashing the board
|
||||
------------------
|
||||
@ -105,3 +116,54 @@ board/atmel/flasher.sh /tmp/atmel_sama5d3_xplained/ /dev/ttyACM0 sama5d3_xplaine
|
||||
|
||||
Reboot, the system should boot up to the buildroot login invite.
|
||||
|
||||
Preparing the SD card
|
||||
=====================
|
||||
|
||||
The SD card must be partitioned 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 /dev/mmcblk0 <<EOF
|
||||
,64MiB,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/boot.bin /media/boot/
|
||||
cp output/images/u-boot.bin /media/boot/
|
||||
cp output/images/zImage /media/boot/
|
||||
cp output/images/at91-sama5d2_xplained.dtb /media/boot/
|
||||
|
||||
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.
|
||||
|
||||
@ -1,73 +0,0 @@
|
||||
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
|
||||
adjustments in the bootloader configuration will be needed to boot
|
||||
from NAND flash, see board/atmel/readme.txt
|
||||
|
||||
Configuring and building Buildroot
|
||||
----------------------------------
|
||||
|
||||
make atmel_sama5d3_xplained_mmc_defconfig
|
||||
make
|
||||
|
||||
Preparing the SD card
|
||||
---------------------
|
||||
|
||||
The SD card must be partitioned 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/u-boot-spl.bin /media/boot/boot.bin
|
||||
cp output/images/u-boot.img /media/boot/u-boot.img
|
||||
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.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user