From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received-SPF: Pass (sender SPF authorized) identity=mailfrom; client-ip=134.134.136.65; helo=mga03.intel.com; envelope-from=mang.guo@intel.com; receiver=edk2-devel@lists.01.org Received: from mga03.intel.com (mga03.intel.com [134.134.136.65]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id 5AFF2202E5E55 for ; Mon, 6 Nov 2017 02:11:55 -0800 (PST) Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by orsmga103.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 06 Nov 2017 02:15:53 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.44,352,1505804400"; d="dat'59?scan'59,208,59";a="171977552" Received: from fmsmsx105.amr.corp.intel.com ([10.18.124.203]) by fmsmga005.fm.intel.com with ESMTP; 06 Nov 2017 02:15:53 -0800 Received: from fmsmsx125.amr.corp.intel.com (10.18.125.40) by FMSMSX105.amr.corp.intel.com (10.18.124.203) with Microsoft SMTP Server (TLS) id 14.3.319.2; Mon, 6 Nov 2017 02:15:52 -0800 Received: from shsmsx151.ccr.corp.intel.com (10.239.6.50) by FMSMSX125.amr.corp.intel.com (10.18.125.40) with Microsoft SMTP Server (TLS) id 14.3.319.2; Mon, 6 Nov 2017 02:15:52 -0800 Received: from shsmsx103.ccr.corp.intel.com ([169.254.4.213]) by SHSMSX151.ccr.corp.intel.com ([169.254.3.218]) with mapi id 14.03.0319.002; Mon, 6 Nov 2017 18:15:50 +0800 From: "Guo, Mang" To: "edk2-devel@lists.01.org" CC: "Wei, David" Thread-Topic: [Patch][edk2-platforms/devel-MinnowBoard3-UDK2017] Update ReadMe.MD Thread-Index: AdNW6DfWcbAI271gR9OgKbVT2/lBng== Date: Mon, 6 Nov 2017 10:15:49 +0000 Message-ID: <22D2C85ED001C54AA20BFE3B0E4751D152576AAA@SHSMSX103.ccr.corp.intel.com> Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: <22D2C85ED001C54AA20BFE3B0E4751D152576AAA@SHSMSX103.ccr.corp.intel.com> x-originating-ip: [10.239.127.40] MIME-Version: 1.0 X-Content-Filtered-By: Mailman/MimeDel 2.1.22 Subject: [Patch][edk2-platforms/devel-MinnowBoard3-UDK2017] Update ReadMe.MD X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 06 Nov 2017 10:11:56 -0000 Content-Language: en-US Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Guo Mang --- ReadMe.MD | 114 ++++++++++++++++++++++++++++++++++++++++------------------= ---- 1 file changed, 74 insertions(+), 40 deletions(-) diff --git a/ReadMe.MD b/ReadMe.MD index ae1556b..f5cbc7c 100644 --- a/ReadMe.MD +++ b/ReadMe.MD @@ -24,56 +24,45 @@ This code base is based on UDK2017 core packages. under the "C:\MyWorkspace\edk2-platforms" directory. =20 3. Get the BaseTools binary and copy them to BaseTools binary folder. - 1. Enter folder BaseTools\Bin - 2. `git clone https://github.com/tianocore/edk2-BaseTools-win32.git Win= 32` - 3. Enter folder Win32 - 4. `git checkout 7b52b1a9bf853b5c498ea61d0a4f17083f543be4` + 1. `git clone https://github.com/tianocore/edk2-BaseTools-win32.git Win= 32` + 2. Enter folder Win32 + 3. `git checkout 0e088c19ab31fccd1d2f55d9e4fe0314b57c0097` + 4. Copy Win32 to the BaseTools Binary folder. + (C:\MyWorkspace\edk2-platforms\BaseTools\Bin\) =20 4. Get the Intel(R) Firmware Support Package(Intel FSP). 1. Run `git clone -b ApolloLake https://github.com/IntelFsp/FSP.git` to= download FSP 2. Enter folder FSP - 3. Run `git checkout 08b5af471a0caea79724ca3eb4794e6a0a7a31aa` + 3. Run `git checkout de67689ef6261c1a0ecee01b7312bd635e3435e7` 4. Copy the ApolloLakeFspBinPkg to the folder "C:\MyWorkspace\edk2-platforms\Silicon\BroxtonSoC\BroxtonFspPkg" =20 5. Install UEFI UNDI driver: - 1. Download PREBOOT.EXE Version 21.1 from the "Intel=C2=AE Ethernet Con= nections + Download PREBOOT.EXE Version 21.1 from the "Intel=C2=AE Ethernet Con= nections Boot Utility, Preboot Images, and EFI Drivers" page. https://downloadcenter.intel.com/download/19186/Intel-Ethernet-Conne= ctions-Boot-Utility-Preboot-Images-and-EFI-Drivers - 2. Install PREBOOT.EXE into the default folder (C:\Intel21.1). - 3. Copy the UEFI x64 PCI-E gigabit driver (C:\Intel21.1\APPS\EFI\EFIx64= \EnnnnX3.EFI, - where "nnnn" is the driver version number) to the platform package d= irectory below, create the folder if it does not exist: + Windows user: + 1. Install PREBOOT.EXE into the default folder (C:\Intel21.1). + 2. Copy the UEFI x64 PCI-E gigabit driver (C:\Intel21.1\APPS\EFI\EFIx64= \E7320X3.EFI)=20 + to the platform package directory below, create the folder if it doe= s not exist: "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\Bi= naries\UNDI\I210PcieUndiDxe" - 4. Open the file "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatfor= mPkg\PlatformPkg.fdf" - and change the UNDI driver file name reference with the one that was= downloaded: - SECTION PE32 =3D BroxtonPlatformPkg/Common/Binaries/UNDI/I210Pcie= UndiDxe/E7006X3.EFI - -6. Install the NASM assembly language compiler: - 1. Download NASM 2.12.02 binaries: - * http://www.nasm.us/pub/nasm/releasebuilds/2.12.02/win32/nasm-2.12.= 02-win32.zip - * http://www.nasm.us/pub/nasm/releasebuilds/2.12.02/win64/nasm-2.12.= 02-win64.zip - 2. Unzip the 32-bit & 64-bit versions of nasm.exe to the directories li= sted below, - respectively, and create the folders if they do not exist: - * "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\= Tools\nasm\Win32" - * "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\= Tools\nasm\Win64" - -7. Install the ACPI Source Language (ASL) compiler: - 1. Install the IASL 2016-09-30 compiler from acpica.org: - https://acpica.org/sites/acpica/files/iasl-win-20160930.zip - 2. Unzip the "iasl.exe" file into the directory below, and create the f= older + Linux user: + 1. Use command "unzip PREBOOT.EXE" to extract UEFI x64 PCI-E gigabit dr= iver + (preboot/APPS/EFI/EFIx64/E7320X3.EFI) + 2. Copy E7320X3.EFI to platform package directory below, create the fol= der if it does not exist: - * "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\= Tools\Iasl" + * "~/src/MyWorkspace/edk2-platforms/Platform/BroxtonPlatformPkg/Common= /Binaries/UNDI/I210PcieUndiDxe" =20 -8. Follow the instructions found in the "Patch-HOWTO.txt" file located in = the Workspace +6. Follow the instructions found in the "Patch-HOWTO.txt" file located in = the Workspace (e.g. "C:\MyWorkspace\edk2-platforms\Core\CryptoPkg\Library\OpensslLib\= Patch-HOWTO.txt") to install the OpenSSL source code and enable the CryptoPkg module. =20 -9. Download MinnowBoard v3 Binary Object Modules +7. Download MinnowBoard v3 Binary Object Modules 1. Download the "MinnowBoard_v3-0.63-Binary.Objects.zip" from the proje= ct page: * https://firmware.intel.com/projects/minnowboardv3 - 2. Unzip and copy the two folders (A_Stepping, B_Stepping) into + 2. Unzip and copy the two folders (FAB_A, FAB_B) into the directory below, and create the folder if it does not exist: - * "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\= Binaries\IFWI" + * "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\= Binaries\IFWI\MinnowBoard3" =20 ## 2. HOW TO BUILD (WINDOWS ENVIRONMENT) =20 @@ -84,23 +73,39 @@ Windows System Configuration: =20 1. Install Visual Studio 2013/2015 on the build machine. =20 - 2. Install the latest Python 2 Release from: https://www.python.org/dow= nloads/windows/ + 2. Install version Python 2.7.10 from: https://www.python.org/downloads= /release/python-2710/ * Make sure that a file with the extension of ".py" will be opened b= y Python.exe. =20 + 3. Install the NASM assembly language compiler: + a. Download NASM 2.12.02 binaries: + * http://www.nasm.us/pub/nasm/releasebuilds/2.12.02/win32/nasm-2.1= 2.02-win32.zip + * http://www.nasm.us/pub/nasm/releasebuilds/2.12.02/win64/nasm-2.1= 2.02-win64.zip + b. Unzip the 32-bit & 64-bit versions of nasm.exe to the directories= listed below, + respectively, and create the folders if they do not exist: + * "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Commo= n\Tools\nasm\Win32" + * "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Commo= n\Tools\nasm\Win64" + + 4. Install the ACPI Source Language (ASL) compiler: + a. Install the IASL 2016-09-30 compiler from acpica.org: + https://acpica.org/sites/acpica/files/iasl-win-20160930.zip + b. Unzip the "iasl.exe" file into the directory below, and create th= e folder + if it does not exist: + * "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Comm= on\Tools\Iasl" + 2. Build =20 2a. Build Steps (32-bit) 1. To build a 32-bit release version * Open a command prompt of Microsoft Visual Studio, such as "Develop= er Command Prompt for VS2013"; * Type the command: `cd C:\MyWorkspace\edk2-platforms` - * Type the command: `BuildBIOS.bat /VS13 /IA32 Broxton Release` to b= uild a release version. - (Please use "VS15" flag for Visual Studio 2015 build) + * Type the command: `BuildBIOS.bat /B /VS13 /IA32 Broxton Release` t= o build a release version. + (Please use "/VS15" flag for Visual Studio 2015 build; Replace "/B= " with "/A" flag for MinnowBoard 3 FAB A board) =20 2. To build a 32-bit debug version * Open a command prompt of Microsoft Visual Studio, such as "Develop= er Command Prompt for VS2013"; * Type the command: `cd C:\MyWorkspace\edk2-platforms` - * Type the command: `BuildBIOS.bat /VS13 /IA32 Broxton Debug` to bui= ld a debug version. - (Please use "VS15" flag for Visual Studio 2015 build) + * Type the command: `BuildBIOS.bat /B /VS13 /IA32 Broxton Debug` to = build a debug version. + (Please use "/VS15" flag for Visual Studio 2015 build; Replace "/B= " with "/A" flag for MinnowBoard 3 FAB A board) =20 3. After the build successfully completes, the 8MB firmware binary ima= ge will be located in the following location on your local hard drive: @@ -111,20 +116,49 @@ Windows System Configuration: 1. To build a 64-bit release version * Open a command prompt of Microsoft Visual Studio, such as "Develop= er Command Prompt for VS2013"; * Type the command: `cd C:\MyWorkspace\edk2-platforms` - * Type the command: `BuildBIOS.bat /VS13 /x64 Broxton Release` to bu= ild a release version. - (Please use "VS15" flag for Visual Studio 2015 build) + * Type the command: `BuildBIOS.bat /B /VS13 /x64 Broxton Release` to= build a release version. + (Please use "/VS15" flag for Visual Studio 2015 build; Replace "/B= " with "/A" flag for MinnowBoard 3 FAB A board) =20 2. To build a 64-bit debug version * Open a command prompt of Microsoft Visual Studio, such as "Develop= er Command Prompt for VS2013"; * Type the command: `cd C:\MyWorkspace\edk2-platforms` - * Type the command: `BuildBIOS.bat /VS13 /x64 Broxton Debug` to buil= d a debug version. - (Please use "VS15" flag for Visual Studio 2015 build) + * Type the command: `BuildBIOS.bat /B /VS13 /x64 Broxton Debug` to b= uild a debug version. + (Please use "/VS15" flag for Visual Studio 2015 build; Replace "/B= " with "/A" flag for MinnowBoard 3 FAB A board) =20 3. After the build successfully completes, the 8MB firmware binary ima= ge will be located in the following location on your local hard drive: =20 "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\To= ols\Stitch" =20 +## 3. HOW TO BUILD (LINUX ENVIRONMENT) + +Linux System Configuration: + Ubuntu 16.04 64-bit + bash shell + gcc version 5 or above + +1. Setup Build Environment + Use below command to install required packages: + # sudo apt-get update + # sudo apt-get install nasm + # sudo apt-get install iasl + # sudo apt-get install build-essential + # sudo apt-get install uuid-dev + +2. Build Steps (64-bit) + 1. To build a 64-bit release version + * Open a command prompt, type command: "cd ~/src/MyWorkspace/edk2-pl= atforms"; + * For MinnowBoard 3 FAB B, type the command:"./BuildBIOS.sh /B Relea= se" to build a release version. + (Replace "/B" with "/A" for MinnowBoard 3 FAB A board) + 2. To build a 64-bit debug version=20 + * Open a command prompt, type command: "cd ~/src/MyWorkspace/edk2-pl= atforms"; + * For MinnowBoard 3 FAB B, type the command:"./BuildBIOS.sh /B Debug= " to build a debug version. + (Replace "/B" with "/A" for MinnowBoard 3 FAB A board) + 3. After the build successfully completes, the 8MB firmware binary ima= ge will be located in the + following location on your local hard drive: + + "~/src/MyWorkspace/edk2-platforms/Platform/BroxtonPlatformPkg/Common= /Tools/Stitch/" + ## MAINTAINERS =20 * david.wei@intel.com --=20 2.10.1.windows.1