From 0ca738448f9ea167cd8931d75a3ab39a22a47260 Mon Sep 17 00:00:00 2001 From: Darren Hart Date: Wed, 19 Jan 2011 11:25:43 -0800 Subject: README.hardware: add beagleboard documentation Document the install and boot process for the Beagleboard xM with provisions for the C4. I need someone with a C4 board to validate the steps. Signed-off-by: Darren Hart CC: Tom Zanussi CC: Bruce Ashfield CC: Scott Rifenbark --- README.hardware | 71 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 71 insertions(+) (limited to 'README.hardware') diff --git a/README.hardware b/README.hardware index fe384b37d2..46984419ad 100644 --- a/README.hardware +++ b/README.hardware @@ -26,6 +26,7 @@ The following boards are supported by Poky: * Marvell PXA3xx Zylonite (zylonite) * Logic iMX31 Lite Kit (mx31litekit) * Phytec phyCORE-iMX31 (mx31phy) + * Texas Instruments Beagleboard (beagleboard) For more information see board's section below. The Poky MACHINE setting corresponding to the board is given in brackets. @@ -509,3 +510,73 @@ USB Device: For more details on the USB-ZIP scenario, see the syslinux documentation: http://git.kernel.org/?p=boot/syslinux/syslinux.git;a=blob_plain;f=doc/usbkey.txt;hb=HEAD + + +Texas Instruments Beagleboard (beagleboard) +=========================================== + +The Beagleboard is an ARM Cortex-A8 development board with USB, DVI-D, S-Video, +2D/3D accelerated graphics, audio, serial, JTAG, and SD/MMC. The xM adds a +faster CPU, more RAM, an ethernet port, more USB ports, microSD, and removes +the NAND flash. The beagleboard MACHINE is tested on the following platforms: + + o Beagleboard xM + +TODO: need someone with a Beagleboard C4 to verify these instructions. + +Due to the lack of NAND on the xM, the install and boot process varies a bit +between boards. The C4 can run the x-loader and u-boot binaries from NAND or +the SD, while the xM can only run them from the SD. The following instructions +apply to both the C4 and the xM, but te C4 can skip step 2 (as noted below), +and may require modification of the NAND environment. + + 1. Partition and format an SD card: + # fdisk -lu /dev/mmcblk0 + + Disk /dev/mmcblk0: 3951 MB, 3951034368 bytes + 255 heads, 63 sectors/track, 480 cylinders, total 7716864 sectors + Units = sectors of 1 * 512 = 512 bytes + + Device Boot Start End Blocks Id System + /dev/mmcblk0p1 * 63 144584 72261 c Win95 FAT32 (LBA) + /dev/mmcblk0p2 144585 465884 160650 83 Linux + + # mkfs.vfat -F 16 -n "boot" /dev/mmcblk0p1 + # mke2fs -j -L "root" /dev/mmcblk0p2 + + The following assumes the SD card partition 1 and 2 are mounted at + /media/boot and /media/root respectively. The files referenced here + are made available after the build in build/tmp/deploy/images. + + 2. Install the boot loaders + This step can be omitted for the C4 as it can have the x-loader and + u-boot installed in NAND. + + # cp MLO-beagleboard /media/boot/MLO + # cp u-boot-beagleboard.bin /media/boot/u-boot.bin + + 3. Install the root filesystem + # tar x -C /media/root -f poky-image-$IMAGE_TYPE-beagleboard.tar.bz2 + # tar x -C /media/root -f modules-$KERNEL_VERSION-beagleboard.tgz + + 4. Install the kernel uImage + # cp uImage-beagleboard.bin /media/boot/uImage + + 5. Prepare a u-boot script to simplify the boot process + The Beagleboard can be made to boot at this point from the u-boot command + shell. To automate this process, generate a user.scr script as follows. + + Install uboot-mkimage (from uboot-mkimage on Ubuntu or uboot-tools on Fedora). + + Prepare a script config: + + # (cat << EOF + setenv bootcmd 'mmc init; fatload mmc 0:1 0x80300000 uImage; bootm 0x80300000' + setenv bootargs 'console=tty0 console=ttyS2,115200n8 root=/dev/mmcblk0p2 rootwait rootfstype=ext3 ro' + boot + EOF + ) > serial-boot.cmd + # mkimage -A arm -O linux -T script -C none -a 0 -e 0 -n "Poky Minimal" -d ./serial-boot.cmd ./user.scr + # cp user.scr /media/boot + + 6. Unmount the SD partitions and boot the Beagleboard -- cgit v1.2.3-54-g00ecf