BeagleBoard: Update documentation

- Update build instructions
- Add instructions to test UEFI on qEmu either using the NOR flash or the SD card



git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@11997 6f19259b-4bc3-4df7-8a09-765794883524

1 files changed, 76 insertions, 9 deletions

diff --git a/BeagleBoardPkg/readme.txt b/BeagleBoardPkg/readme.txt
index 8234fead73..702b77b174 100644
--- a/BeagleBoardPkg/readme.txt
+++ b/BeagleBoardPkg/readme.txt
@@ -1,11 +1,78 @@
-Build:

-======

-Build requires a bash script.

-./build.sh. 

+On Ubuntu 10.04, in your $(WORKROOT) directory (eg: ~/dev/)

 

-FAQ:

-====

-If you get a build error 000E: File/directory not found FatPkg/EnhancedFat/FatDxe/FatDxe.inf

+Build UEFI for the BeagleBoard :

+================================

+# Requirements

+sudo apt-get install uuid-dev

 

-cd $WORKSPACE

-svn checkout https://fat-driver2.tianocore.org/svn/fat-driver2/trunk/FatPkg FatPkg --username username
\ No newline at end of file
+# Get the arm-none-eabi Toolchain:

+cd $(WORKROOT)

+wget http://www.codesourcery.com/sgpp/lite/arm/portal/package7813/public/arm-none-eabi/arm-2010.09-51-arm-none-eabi-i686-pc-linux-gnu.tar.bz2

+tar xjf arm-2010.09-51-arm-none-eabi-i686-pc-linux-gnu.tar.bz2

+Add the arm-none-eabi toolchain to your path

+

+# Build UEFI

+svn co https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2 edk2 --username guest

+cd $(WORKROOT)/edk2

+svn co https://edk2-fatdriver2.svn.sourceforge.net/svnroot/edk2-fatdriver2/trunk/FatPkg FatPkg --username guest

+patch -p1 < ArmPlatformPkg/Documentation/patches/BaseTools-Pending-Patches.patch

+cd BeagleBoardPkg/

+./build.sh

+

+# To Build a Release verion of UEFI

+./build.sh RELEASE

+

+

+Test UEFI on qEmu :

+===================

+

+Installing Linaro qEmu:

+-----------------------

+cd $(WORKROOT)

+git clone git://git.linaro.org/qemu/qemu-linaro.git

+cd $(WORKROOT)/qemu-linaro

+./configure --target-list=arm-softmmu,arm-linux-user,armeb-linux-user

+make

+

+Installing Linaro image Creator:

+--------------------------------

+wget http://launchpad.net/linaro-image-tools/trunk/0.4.8/+download/linaro-image-tools-0.4.8.tar.gz

+tar xzf linaro-image-tools-0.4.8.tar.gz

+cd $(WORKROOT)/linaro-image-tools-0.4.8/

+sudo apt-get install parted dosfstools uboot-mkimage python-argparse python-dbus python-debian python-parted qemu-arm-static btrfs-tools command-not-found

+

+Creating u-boot + Linux Linaro image:

+-------------------------------------

+mkdir $(WORKROOT)/beagle_image && cd $(WORKROOT)/beagle_image

+wget http://releases.linaro.org/platform/linaro-m/hwpacks/final/hwpack_linaro-omap3_20101109-1_armel_supported.tar.gz

+wget http://releases.linaro.org/platform/linaro-m/headless/release-candidate/linaro-m-headless-tar-20101101-0.tar.gz

+sudo $(WORKROOT)/linaro-image-tools-0.4.8/linaro-media-create --image_file beagle_sd.img --dev beagle --binary linaro-m-headless-tar-20101101-0.tar.gz --hwpack hwpack_linaro-omap3_20101109-1_armel_supported.tar.gz

+sudo chmod a+rw beagle_sd.img

+

+Test u-boot + Linux Linaro image on qEmu:

+-----------------------------------------

+$(WORKROOT)/qemu-linaro/arm-softmmu/qemu-system-arm -M beagle -sd $(WORKROOT)/beagle_image/beagle_sd.img -serial stdio -clock unix

+# in u-boot:

+boot

+

+Start UEFI from NOR Flash :

+---------------------------

+# Adding zImage to beagle_sd.img

+mkdir /tmp/beagle_img1

+sudo mount -o loop,offset=$[63*512] $(WORKROOT)/beagle_image/beagle_sd.img /tmp/beagle_img1

+cp zImage /tmp/beagle_img1

+sudo umount /tmp/beagle_img1

+

+./qemu-system-arm -M beagle -mtdblock /work/tianocore/Build/BeagleBoard/DEBUG_ARMGCC/FV/BeagleBoard_EFI_flashboot.fd -serial stdio -sd /work/linaro-image-tools-0.4.8/beagle_sd.img

+

+Start UEFI from SD card :

+-------------------------

+# To replace u-boot by uefi in the SD card

+1) Build the BeagleBoard UEFI firmware without the OMAP353x header

+cd $(WORKROOT)/edk2/BeagleBoardPkg/

+./build.sh -D EDK2_SECOND_STAGE_BOOTOLADER=1

+

+2) Replace u-boot by UEFI

+sudo mount -o loop,offset=$[63*512] $(WORKROOT)/beagle_image/beagle_sd.img /tmp/beagle_img1

+sudo cp ../Build/BeagleBoard/DEBUG_ARMGCC/FV/BEAGLEBOARD_EFI.fd /tmp/beagle_img1/u-boot.bin

+sudo umount /tmp/beagle_img1