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>
This commit is contained in:
parent
5da38d224e
commit
0ca738448f
|
@ -26,6 +26,7 @@ The following boards are supported by Poky:
|
||||||
* Marvell PXA3xx Zylonite (zylonite)
|
* Marvell PXA3xx Zylonite (zylonite)
|
||||||
* Logic iMX31 Lite Kit (mx31litekit)
|
* Logic iMX31 Lite Kit (mx31litekit)
|
||||||
* Phytec phyCORE-iMX31 (mx31phy)
|
* Phytec phyCORE-iMX31 (mx31phy)
|
||||||
|
* Texas Instruments Beagleboard (beagleboard)
|
||||||
|
|
||||||
For more information see board's section below. The Poky MACHINE setting
|
For more information see board's section below. The Poky MACHINE setting
|
||||||
corresponding to the board is given in brackets.
|
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:
|
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
|
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
|
||||||
|
|
Loading…
Reference in New Issue