BeagleBoardPkg: remove outdated build scripts and instructions

Now that we can build the Beagleboard NOR image without the custom
build scripts, let's remove them since they are outdated and out of
sync with each other.

Remove readme.txt as well: it is also outdated, and mostly covers
QEMU and how to build Linaro SD images, which may not be relevant to
most users.

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Ard Biesheuvel <ard.biesheuvel@linaro.org>
Reviewed-by: Leif Lindholm <leif.lindholm@linaro.org>
git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@18211 6f19259b-4bc3-4df7-8a09-765794883524

diff --git a/BeagleBoardPkg/b.bat b/BeagleBoardPkg/b.bat
deleted file mode 100755 (executable)
index 76ddea6..0000000
--- a/BeagleBoardPkg/b.bat
+++ /dev/null
@@ -1,68 +0,0 @@
-@REM Copyright (c) 2008 - 2010, Apple Inc. All rights reserved.<BR>\r
-@REM This program and the accompanying materials\r
-@REM are licensed and made available under the terms and conditions of the BSD License\r
-@REM which accompanies this distribution.  The full text of the license may be found at\r
-@REM http://opensource.org/licenses/bsd-license.php\r
-@REM\r
-@REM THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
-@REM WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
-@REM\r
-\r
-@REM Example usage of this script. default is a DEBUG build\r
-@REM b\r
-@REM b clean\r
-@REM b release \r
-@REM b release clean\r
-@REM b -v -y build.log\r
-\r
-ECHO OFF\r
-@REM Setup Build environment. Sets WORKSPACE and puts build in path\r
-CALL ..\edksetup.bat\r
-\r
-@REM Set for tools chain. Currently RVCT\r
-SET TARGET_TOOLS=RVCT\r
-SET TARGET=DEBUG\r
-\r
-@if /I "%1"=="RELEASE" (\r
-  @REM If 1st argument is release set TARGET to RELEASE and shift arguments to remove it \r
-  SET TARGET=RELEASE\r
-  shift /1\r
-)\r
-\r
-SET BUILD_ROOT=%WORKSPACE%\Build\BeagleBoard\%TARGET%_%TARGET_TOOLS%\r
-\r
-@REM Build the Beagle Board firmware and creat an FD (FLASH Device) Image.\r
-CALL build -p BeagleBoardPkg\BeagleBoardPkg.dsc -a ARM -t %TARGET_TOOLS% -b %TARGET% %1 %2 %3 %4 %5 %6 %7 %8\r
-@if ERRORLEVEL 1 goto Exit\r
-\r
-@if /I "%1"=="CLEAN" goto Clean\r
-\r
-@REM\r
-@REM Ram starts at 0x80000000\r
-@REM OMAP 3530 TRM defines 0x80008208 as the entry point\r
-@REM The reset vector is caught by the mask ROM in the OMAP 3530 so that is why this entry \r
-@REM point looks so strange. \r
-@REM OMAP 3430 TRM section 26.4.8 has Image header information. (missing in OMAP 3530 TRM)\r
-@REM\r
-@cd Tools\r
-\r
-ECHO Building tools...\r
-CALL nmake \r
-\r
-ECHO Patching image with ConfigurationHeader.dat\r
-CALL GenerateImage -D ..\ConfigurationHeader.dat -E 0x80008208 -I %BUILD_ROOT%\FV\BEAGLEBOARD_EFI.fd -O %BUILD_ROOT%\FV\BeagleBoard_EFI_flashboot.fd\r
-\r
-ECHO Patching ..\Debugger_scripts ...\r
-SET DEBUGGER_SCRIPT=..\Debugger_scripts\r
-@for /f %%a IN ('dir /b %DEBUGGER_SCRIPT%\*.inc %DEBUGGER_SCRIPT%\*.cmm') do (\r
-  @CALL replace %DEBUGGER_SCRIPT%\%%a %BUILD_ROOT%\%%a ZZZZZZ %BUILD_ROOT% WWWWWW  %WORKSPACE%\r
-)\r
-\r
-cd ..\r
-:Exit\r
-EXIT /B\r
-\r
-:Clean\r
-cd Tools\r
-CALL nmake clean\r
-cd ..\r

diff --git a/BeagleBoardPkg/ba.bat b/BeagleBoardPkg/ba.bat
deleted file mode 100755 (executable)
index 24a60e4..0000000
--- a/BeagleBoardPkg/ba.bat
+++ /dev/null
@@ -1,68 +0,0 @@
-@REM Copyright (c) 2008 - 2010, Apple Inc. All rights reserved.<BR>\r
-@REM This program and the accompanying materials\r
-@REM are licensed and made available under the terms and conditions of the BSD License\r
-@REM which accompanies this distribution.  The full text of the license may be found at\r
-@REM http://opensource.org/licenses/bsd-license.php\r
-@REM\r
-@REM THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
-@REM WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
-@REM\r
-\r
-@REM Example usage of this script. default is a DEBUG build\r
-@REM b\r
-@REM b clean\r
-@REM b release \r
-@REM b release clean\r
-@REM b -v -y build.log\r
-\r
-ECHO OFF\r
-@REM Setup Build environment. Sets WORKSPACE and puts build in path\r
-CALL ..\edksetup.bat\r
-\r
-@REM Set for tools chain. Currently ARMGCC\r
-SET TARGET_TOOLS=ARMGCC\r
-SET TARGET=DEBUG\r
-\r
-@if /I "%1"=="RELEASE" (\r
-  @REM If 1st argument is release set TARGET to RELEASE and shift arguments to remove it \r
-  SET TARGET=RELEASE\r
-  shift /1\r
-)\r
-\r
-SET BUILD_ROOT=%WORKSPACE%\Build\BeagleBoard\%TARGET%_%TARGET_TOOLS%\r
-\r
-@REM Build the Beagle Board firmware and creat an FD (FLASH Device) Image.\r
-CALL build -p BeagleBoardPkg\BeagleBoardPkg.dsc -a ARM -t %TARGET_TOOLS% -b %TARGET% %1 %2 %3 %4 %5 %6 %7 %8\r
-@if ERRORLEVEL 1 goto Exit\r
-\r
-@if /I "%1"=="CLEAN" goto Clean\r
-\r
-@REM\r
-@REM Ram starts at 0x80000000\r
-@REM OMAP 3530 TRM defines 0x80008208 as the entry point\r
-@REM The reset vector is caught by the mask ROM in the OMAP 3530 so that is why this entry \r
-@REM point looks so strange. \r
-@REM OMAP 3430 TRM section 26.4.8 has Image header information. (missing in OMAP 3530 TRM)\r
-@REM\r
-@cd Tools\r
-\r
-ECHO Building tools...\r
-CALL nmake \r
-\r
-ECHO Patching image with ConfigurationHeader.dat\r
-CALL GenerateImage -D ..\ConfigurationHeader.dat -E 0x80008208 -I %BUILD_ROOT%\FV\BEAGLEBOARD_EFI.fd -O %BUILD_ROOT%\FV\BeagleBoard_EFI_flashboot.fd\r
-\r
-ECHO Patching ..\Debugger_scripts ...\r
-SET DEBUGGER_SCRIPT=..\Debugger_scripts\r
-@for /f %%a IN ('dir /b %DEBUGGER_SCRIPT%\*.inc %DEBUGGER_SCRIPT%\*.cmm') do (\r
-  @CALL replace %DEBUGGER_SCRIPT%\%%a %BUILD_ROOT%\%%a ZZZZZZ %BUILD_ROOT% WWWWWW  %WORKSPACE%\r
-)\r
-\r
-cd ..\r
-:Exit\r
-EXIT /B\r
-\r
-:Clean\r
-cd Tools\r
-CALL nmake clean\r
-cd ..\r

diff --git a/BeagleBoardPkg/build.sh b/BeagleBoardPkg/build.sh
deleted file mode 100755 (executable)
index ad8e69f..0000000
--- a/BeagleBoardPkg/build.sh
+++ /dev/null
@@ -1,150 +0,0 @@
-#!/bin/bash
-# Copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
-# This program and the accompanying materials
-# are licensed and made available under the terms and conditions of the BSD License
-# which accompanies this distribution.  The full text of the license may be found at
-# http://opensource.org/licenses/bsd-license.php
-#
-# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
-# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-#
-
-set -e
-shopt -s nocasematch
-
-function process_debug_scripts {
-  if [[ -d $1 ]]; then
-    for filename in `ls $1`
-    do
-      sed -e "s@ZZZZZZ@$BUILD_ROOT@g" -e "s@WWWWWW@$WORKSPACE@g" \
-            "$1/$filename" \
-            > "$BUILD_ROOT/$filename"
-
-      #For ARMCYGWIN, we have to change /cygdrive/c to c:
-      if [[ $TARGET_TOOLS == RVCT31CYGWIN ]]
-      then
-        mv "$BUILD_ROOT/$filename" "$BUILD_ROOT/$filename"_temp
-        sed -e "s@/cygdrive/\(.\)@\1:@g" \
-              "$BUILD_ROOT/$filename"_temp \
-              > "$BUILD_ROOT/$filename"
-        rm -f "$BUILD_ROOT/$filename"_temp
-      fi
-    done
-  fi
-}
-
-
-#
-# Setup workspace if it is not set
-#
-if [ -z "${WORKSPACE:-}" ]
-then
-  echo Initializing workspace
-  cd ..
-# Uses an external BaseTools project 
-#  export EDK_TOOLS_PATH=`pwd`/../BaseTools
-# Uses the BaseTools in edk2
-  export EDK_TOOLS_PATH=`pwd`/BaseTools
-  source edksetup.sh BaseTools
-else
-  echo Building from: $WORKSPACE
-fi
-
-#
-# Pick a default tool type for a given OS if no toolchain already defined
-#
-if [ -z "${TARGET_TOOLS:-}" ]
-then
-  case `uname` in
-    CYGWIN*) 
-      TARGET_TOOLS=RVCT31CYGWIN 
-      ;;
-    Linux*)  
-      if [[ ! -z `locate arm-linux-gnueabi-gcc` ]]; then
-        TARGET_TOOLS=ARMLINUXGCC
-      else 
-        TARGET_TOOLS=ARMGCC 
-      fi
-      ;;
-    Darwin*) 
-      Major=$(uname -r | cut -f 1 -d '.')
-      if [[ $Major == 9 ]]
-      then
-        # Not supported by this open source project
-        TARGET_TOOLS=XCODE31
-      else 
-        TARGET_TOOLS=XCODE32
-      fi  
-      ;;
-  esac
-fi
-
-TARGET=DEBUG
-for arg in "$@"
-do
-  if [[ $arg == RELEASE ]]; 
-  then
-    TARGET=RELEASE
-  fi
-done
-
-BUILD_ROOT=$WORKSPACE/Build/BeagleBoard/"$TARGET"_"$TARGET_TOOLS"
-GENERATE_IMAGE=$WORKSPACE/BeagleBoardPkg/Tools/generate_image
-FLASH_BOOT=$BUILD_ROOT/FV/BeagleBoard_EFI_flashboot.fd
-
-if  [[ ! -e $EDK_TOOLS_PATH/Source/C/bin ]];
-then
-  # build the tools if they don't yet exist
-  echo Building tools: $EDK_TOOLS_PATH
-  make -C $EDK_TOOLS_PATH
-else
-  echo using prebuilt tools
-fi
-
-#
-# Build the edk2 BeagleBoard code
-#
-if [[ $TARGET == RELEASE ]]; then
-  build -p $WORKSPACE/BeagleBoardPkg/BeagleBoardPkg.dsc -a ARM -t $TARGET_TOOLS -b $TARGET -D DEBUG_TARGET=RELEASE ${2:-} ${3:-} ${4:-} ${5:-} ${6:-} ${7:-} ${8:-}
-else
-  build -p ${WORKSPACE:-}/BeagleBoardPkg/BeagleBoardPkg.dsc -a ARM -t $TARGET_TOOLS -b $TARGET ${1:-} ${2:-} ${3:-} ${4:-} ${5:-} ${6:-} ${7:-} ${8:-}
-fi
-
-
-for arg in "$@"
-do
-  if [[ $arg == clean ]]; then
-    # no need to post process if we are doing a clean
-    exit
-  elif [[ $arg == cleanall ]]; then
-    make -C $EDK_TOOLS_PATH clean
-    make -C $WORKSPACE/BeagleBoardPkg/Tools clean
-    exit
-    
-  fi
-done
-
-
-#
-#  Build the tool used to patch the FLASH image to work with the Beagle board ROM
-#
-if [[ ! -e $GENERATE_IMAGE ]];
-then
-  make -C $WORKSPACE/BeagleBoardPkg/Tools
-fi
-
-echo Patching FD to work with BeagleBoard ROM
-rm -f $FLASH_BOOT
-
-#
-# Ram starts at 0x80000000
-# OMAP 3530 TRM defines 0x80008000 as the entry point
-# The reset vector is caught by the mask ROM in the OMAP 3530 so that is why this entry 
-# point looks so strange. 
-# OMAP 3430 TRM section 26.4.8 has Image header information. (missing in OMAP 3530 TRM)
-#
-$GENERATE_IMAGE -D $WORKSPACE/BeagleBoardPkg/ConfigurationHeader.dat -E 0x80008000 -I $BUILD_ROOT/FV/BEAGLEBOARD_EFI.fd -O $FLASH_BOOT
-
-echo Creating debugger scripts
-process_debug_scripts $WORKSPACE/BeagleBoardPkg/Debugger_scripts
-

diff --git a/BeagleBoardPkg/readme.txt b/BeagleBoardPkg/readme.txt
deleted file mode 100644 (file)
index 702b77b..0000000
--- a/BeagleBoardPkg/readme.txt
+++ /dev/null
@@ -1,78 +0,0 @@
-On Ubuntu 10.04, in your $(WORKROOT) directory (eg: ~/dev/)\r
-\r
-Build UEFI for the BeagleBoard :\r
-================================\r
-# Requirements\r
-sudo apt-get install uuid-dev\r
-\r
-# Get the arm-none-eabi Toolchain:\r
-cd $(WORKROOT)\r
-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\r
-tar xjf arm-2010.09-51-arm-none-eabi-i686-pc-linux-gnu.tar.bz2\r
-Add the arm-none-eabi toolchain to your path\r
-\r
-# Build UEFI\r
-svn co https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2 edk2 --username guest\r
-cd $(WORKROOT)/edk2\r
-svn co https://edk2-fatdriver2.svn.sourceforge.net/svnroot/edk2-fatdriver2/trunk/FatPkg FatPkg --username guest\r
-patch -p1 < ArmPlatformPkg/Documentation/patches/BaseTools-Pending-Patches.patch\r
-cd BeagleBoardPkg/\r
-./build.sh\r
-\r
-# To Build a Release verion of UEFI\r
-./build.sh RELEASE\r
-\r
-\r
-Test UEFI on qEmu :\r
-===================\r
-\r
-Installing Linaro qEmu:\r
------------------------\r
-cd $(WORKROOT)\r
-git clone git://git.linaro.org/qemu/qemu-linaro.git\r
-cd $(WORKROOT)/qemu-linaro\r
-./configure --target-list=arm-softmmu,arm-linux-user,armeb-linux-user\r
-make\r
-\r
-Installing Linaro image Creator:\r
---------------------------------\r
-wget http://launchpad.net/linaro-image-tools/trunk/0.4.8/+download/linaro-image-tools-0.4.8.tar.gz\r
-tar xzf linaro-image-tools-0.4.8.tar.gz\r
-cd $(WORKROOT)/linaro-image-tools-0.4.8/\r
-sudo apt-get install parted dosfstools uboot-mkimage python-argparse python-dbus python-debian python-parted qemu-arm-static btrfs-tools command-not-found\r
-\r
-Creating u-boot + Linux Linaro image:\r
--------------------------------------\r
-mkdir $(WORKROOT)/beagle_image && cd $(WORKROOT)/beagle_image\r
-wget http://releases.linaro.org/platform/linaro-m/hwpacks/final/hwpack_linaro-omap3_20101109-1_armel_supported.tar.gz\r
-wget http://releases.linaro.org/platform/linaro-m/headless/release-candidate/linaro-m-headless-tar-20101101-0.tar.gz\r
-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\r
-sudo chmod a+rw beagle_sd.img\r
-\r
-Test u-boot + Linux Linaro image on qEmu:\r
------------------------------------------\r
-$(WORKROOT)/qemu-linaro/arm-softmmu/qemu-system-arm -M beagle -sd $(WORKROOT)/beagle_image/beagle_sd.img -serial stdio -clock unix\r
-# in u-boot:\r
-boot\r
-\r
-Start UEFI from NOR Flash :\r
----------------------------\r
-# Adding zImage to beagle_sd.img\r
-mkdir /tmp/beagle_img1\r
-sudo mount -o loop,offset=$[63*512] $(WORKROOT)/beagle_image/beagle_sd.img /tmp/beagle_img1\r
-cp zImage /tmp/beagle_img1\r
-sudo umount /tmp/beagle_img1\r
-\r
-./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\r
-\r
-Start UEFI from SD card :\r
--------------------------\r
-# To replace u-boot by uefi in the SD card\r
-1) Build the BeagleBoard UEFI firmware without the OMAP353x header\r
-cd $(WORKROOT)/edk2/BeagleBoardPkg/\r
-./build.sh -D EDK2_SECOND_STAGE_BOOTOLADER=1\r
-\r
-2) Replace u-boot by UEFI\r
-sudo mount -o loop,offset=$[63*512] $(WORKROOT)/beagle_image/beagle_sd.img /tmp/beagle_img1\r
-sudo cp ../Build/BeagleBoard/DEBUG_ARMGCC/FV/BEAGLEBOARD_EFI.fd /tmp/beagle_img1/u-boot.bin\r
-sudo umount /tmp/beagle_img1\r