From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) (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 CEB9D21A0BABD for ; Mon, 8 May 2017 21:56:01 -0700 (PDT) Received: from fmsmga002.fm.intel.com ([10.253.24.26]) by fmsmga105.fm.intel.com with ESMTP; 08 May 2017 21:56:01 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.38,312,1491289200"; d="scan'208";a="1166520821" Received: from fmsmsx106.amr.corp.intel.com ([10.18.124.204]) by fmsmga002.fm.intel.com with ESMTP; 08 May 2017 21:56:01 -0700 Received: from fmsmsx154.amr.corp.intel.com (10.18.116.70) by FMSMSX106.amr.corp.intel.com (10.18.124.204) with Microsoft SMTP Server (TLS) id 14.3.319.2; Mon, 8 May 2017 21:56:01 -0700 Received: from shsmsx102.ccr.corp.intel.com (10.239.4.154) by FMSMSX154.amr.corp.intel.com (10.18.116.70) with Microsoft SMTP Server (TLS) id 14.3.319.2; Mon, 8 May 2017 21:56:00 -0700 Received: from shsmsx101.ccr.corp.intel.com ([169.254.1.193]) by shsmsx102.ccr.corp.intel.com ([169.254.2.246]) with mapi id 14.03.0319.002; Tue, 9 May 2017 12:55:57 +0800 From: "Wei, David" To: "Guo, Mang" , "edk2-devel@lists.01.org" Thread-Topic: [Patch][edk2-platforms/devel-MinnowBoard3-UDK2017] Add new platform branch devel-MinnowBoard3-UDK2017 Thread-Index: AdLIf9AD29erIbzHQku0zmyR30LAUAAAK1ZA Date: Tue, 9 May 2017 04:55:57 +0000 Message-ID: <89954A0B46707A448411A627AD4EEE3468F2E6C1@SHSMSX101.ccr.corp.intel.com> References: <22D2C85ED001C54AA20BFE3B0E4751D152506AB8@SHSMSX103.ccr.corp.intel.com> In-Reply-To: <22D2C85ED001C54AA20BFE3B0E4751D152506AB8@SHSMSX103.ccr.corp.intel.com> Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-originating-ip: [10.239.127.40] MIME-Version: 1.0 Subject: Re: [Patch][edk2-platforms/devel-MinnowBoard3-UDK2017] Add new platform branch devel-MinnowBoard3-UDK2017 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: Tue, 09 May 2017 04:56:02 -0000 Content-Language: en-US Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable Reviewed-by: zwei4 =20 Thanks, David Wei =20 -----Original Message----- From: Guo, Mang=20 Sent: Tuesday, May 09, 2017 12:51 PM To: edk2-devel@lists.01.org Cc: Wei, David Subject: [Patch][edk2-platforms/devel-MinnowBoard3-UDK2017] Add new platfor= m branch devel-MinnowBoard3-UDK2017 Create a new branch (devel-MinnowBoard3-UDK2017) on edk2-platforms for Minn= owBoard3. This code base is based on UDK2017 core packages. The branch devel-MinnowBoard3 is based on UDK2015. Code is ready in https://github.com/mangguo321/edk2-platforms/tree/devel-Mi= nnowBoard3-UDK2017 Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Guo Mang --- ReadMe.MD | 135 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++= ++++ 1 file changed, 135 insertions(+) create mode 100644 ReadMe.MD diff --git a/ReadMe.MD b/ReadMe.MD new file mode 100644 index 0000000..e6482df --- /dev/null +++ b/ReadMe.MD @@ -0,0 +1,135 @@ +=EF=BB=BF +This code base is designed for the MinnowBoard v3 platform using the Intel= (R) Atom(tm) Processor E3900 Series. +This code base is base on UDK2017 core packages. + +# INDEX + +1. HOW TO CREATE A FULL SOURCE TREE +2. HOW TO BUILD (WINDOWS ENVIRONMENT) +3. MAINTAINERS + +## 1. HOW TO CREATE A FULL SOURCE TREE + +1. Create a new folder (directory) on the root of your local development m= achine + for use as your work space (this example uses "C:\MyWorkspace"). + + NOTE: Some code paths are very long, and placing the working directory = too + deep below the ROOT directory may cause the path to be longer tha= n the + operating system or file system's maximum path length. + +2. Get MinnowBoard v3 branch from GitHub with the following command. + * `git clone -b devel-MinnowBoard3-UDK2017 https://github.com/tianocore= /edk2-platforms.git` + + Once the download completes, all EDK II packages and files will be foun= d + under the "C:\MyWorkspace\edk2-platforms" directory. + +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` + +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` + 4. Copy the ApolloLakeFspBinPkg to the folder + "C:\MyWorkspace\edk2-platforms\Silicon\BroxtonSoC\BroxtonFspPkg" + +5. Install UEFI UNDI driver: + 1. 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: + "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 + if it does not exist: + * "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\= Tools\Iasl" + +8. 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. + +9. 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 + the directory below, and create the folder if it does nto exist: + * "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\= Binaries\IFWI" + +## 2. HOW TO BUILD (WINDOWS ENVIRONMENT) + +Windows System Configuration: + Microsoft Windows 7 Ultimate 64-bit* + +1. Setup Build Environment + + 1. Install Visual Studio 2013/2015 on the build machine. + + 2. Install the latest Python 2 Release from: https://www.python.org/dow= nloads/windows/ + * Make sure that a file with the extension of ".py" will be opened b= y Python.exe. + +2. Build + + 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) + + 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) + + 3. After the build successfully completes, the 8MB firmware binary ima= ge will be located in the + following location on your local hard drive: + + "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\To= ols\Stitch" + + 2b. Build Steps (64-bit) + 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) + + 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) + + 3. After the build successfully completes, the 8MB firmware binary ima= ge will be located in the + following location on your local hard drive: + + "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\To= ols\Stitch" + +## MAINTAINERS + +* david.wei@intel.com +* mang.guo@intel.com +* vincent.zimmer@intel.com +* mike.wu@intel.com +* shifeix.a.lu@intel.com + --=20 2.10.1.windows.1