summaryrefslogtreecommitdiffstats
path: root/README.hardware
diff options
context:
space:
mode:
authorDarren Hart <dvhart@linux.intel.com>2011-01-19 11:25:43 -0800
committerRichard Purdie <richard.purdie@linuxfoundation.org>2011-01-21 11:18:36 +0000
commit0ca738448f9ea167cd8931d75a3ab39a22a47260 (patch)
tree26138156b1363d05ce6b9da900ff196773325f52 /README.hardware
parent5da38d224ee25dc14070ec4f6a63c7219b1d7ac6 (diff)
downloadpoky-0ca738448f9ea167cd8931d75a3ab39a22a47260.tar.gz
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 <dvhart@linux.intel.com> CC: Tom Zanussi <tom.zanussi@intel.com> CC: Bruce Ashfield <bruce.ashfield@windriver.com> CC: Scott Rifenbark <scott.m.rifenbark@intel.com>
Diffstat (limited to 'README.hardware')
-rw-r--r--README.hardware71
1 files changed, 71 insertions, 0 deletions
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:
26 * Marvell PXA3xx Zylonite (zylonite) 26 * Marvell PXA3xx Zylonite (zylonite)
27 * Logic iMX31 Lite Kit (mx31litekit) 27 * Logic iMX31 Lite Kit (mx31litekit)
28 * Phytec phyCORE-iMX31 (mx31phy) 28 * Phytec phyCORE-iMX31 (mx31phy)
29 * Texas Instruments Beagleboard (beagleboard)
29 30
30For more information see board's section below. The Poky MACHINE setting 31For more information see board's section below. The Poky MACHINE setting
31corresponding to the board is given in brackets. 32corresponding to the board is given in brackets.
@@ -509,3 +510,73 @@ USB Device:
509 510
510 For more details on the USB-ZIP scenario, see the syslinux documentation: 511 For more details on the USB-ZIP scenario, see the syslinux documentation:
511 http://git.kernel.org/?p=boot/syslinux/syslinux.git;a=blob_plain;f=doc/usbkey.txt;hb=HEAD 512 http://git.kernel.org/?p=boot/syslinux/syslinux.git;a=blob_plain;f=doc/usbkey.txt;hb=HEAD
513
514
515Texas Instruments Beagleboard (beagleboard)
516===========================================
517
518The Beagleboard is an ARM Cortex-A8 development board with USB, DVI-D, S-Video,
5192D/3D accelerated graphics, audio, serial, JTAG, and SD/MMC. The xM adds a
520faster CPU, more RAM, an ethernet port, more USB ports, microSD, and removes
521the NAND flash. The beagleboard MACHINE is tested on the following platforms:
522
523 o Beagleboard xM
524
525TODO: need someone with a Beagleboard C4 to verify these instructions.
526
527Due to the lack of NAND on the xM, the install and boot process varies a bit
528between boards. The C4 can run the x-loader and u-boot binaries from NAND or
529the SD, while the xM can only run them from the SD. The following instructions
530apply to both the C4 and the xM, but te C4 can skip step 2 (as noted below),
531and may require modification of the NAND environment.
532
533 1. Partition and format an SD card:
534 # fdisk -lu /dev/mmcblk0
535
536 Disk /dev/mmcblk0: 3951 MB, 3951034368 bytes
537 255 heads, 63 sectors/track, 480 cylinders, total 7716864 sectors
538 Units = sectors of 1 * 512 = 512 bytes
539
540 Device Boot Start End Blocks Id System
541 /dev/mmcblk0p1 * 63 144584 72261 c Win95 FAT32 (LBA)
542 /dev/mmcblk0p2 144585 465884 160650 83 Linux
543
544 # mkfs.vfat -F 16 -n "boot" /dev/mmcblk0p1
545 # mke2fs -j -L "root" /dev/mmcblk0p2
546
547 The following assumes the SD card partition 1 and 2 are mounted at
548 /media/boot and /media/root respectively. The files referenced here
549 are made available after the build in build/tmp/deploy/images.
550
551 2. Install the boot loaders
552 This step can be omitted for the C4 as it can have the x-loader and
553 u-boot installed in NAND.
554
555 # cp MLO-beagleboard /media/boot/MLO
556 # cp u-boot-beagleboard.bin /media/boot/u-boot.bin
557
558 3. Install the root filesystem
559 # tar x -C /media/root -f poky-image-$IMAGE_TYPE-beagleboard.tar.bz2
560 # tar x -C /media/root -f modules-$KERNEL_VERSION-beagleboard.tgz
561
562 4. Install the kernel uImage
563 # cp uImage-beagleboard.bin /media/boot/uImage
564
565 5. Prepare a u-boot script to simplify the boot process
566 The Beagleboard can be made to boot at this point from the u-boot command
567 shell. To automate this process, generate a user.scr script as follows.
568
569 Install uboot-mkimage (from uboot-mkimage on Ubuntu or uboot-tools on Fedora).
570
571 Prepare a script config:
572
573 # (cat << EOF
574 setenv bootcmd 'mmc init; fatload mmc 0:1 0x80300000 uImage; bootm 0x80300000'
575 setenv bootargs 'console=tty0 console=ttyS2,115200n8 root=/dev/mmcblk0p2 rootwait rootfstype=ext3 ro'
576 boot
577 EOF
578 ) > serial-boot.cmd
579 # mkimage -A arm -O linux -T script -C none -a 0 -e 0 -n "Poky Minimal" -d ./serial-boot.cmd ./user.scr
580 # cp user.scr /media/boot
581
582 6. Unmount the SD partitions and boot the Beagleboard