From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga07.intel.com (mga07.intel.com [134.134.136.100]) (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 654EE21A6F107 for ; Mon, 8 May 2017 03:40:26 -0700 (PDT) Received: from orsmga004.jf.intel.com ([10.7.209.38]) by orsmga105.jf.intel.com with ESMTP; 08 May 2017 03:40:26 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.38,309,1491289200"; d="dat'59?scan'59,208,59";a="84859605" Received: from fmsmsx106.amr.corp.intel.com ([10.18.124.204]) by orsmga004.jf.intel.com with ESMTP; 08 May 2017 03:40:25 -0700 Received: from fmsmsx101.amr.corp.intel.com (10.18.124.199) by FMSMSX106.amr.corp.intel.com (10.18.124.204) with Microsoft SMTP Server (TLS) id 14.3.319.2; Mon, 8 May 2017 03:40:25 -0700 Received: from shsmsx102.ccr.corp.intel.com (10.239.4.154) by fmsmsx101.amr.corp.intel.com (10.18.124.199) with Microsoft SMTP Server (TLS) id 14.3.319.2; Mon, 8 May 2017 03:40:24 -0700 Received: from shsmsx103.ccr.corp.intel.com ([169.254.4.117]) by shsmsx102.ccr.corp.intel.com ([169.254.2.246]) with mapi id 14.03.0319.002; Mon, 8 May 2017 18:40:21 +0800 From: "Guo, Mang" To: "edk2-devel@lists.01.org" CC: "Wei, David" , "Gao, Liming" , "Lu, ShifeiX A" Thread-Topic: [Patch][edk2-platforms/devel-MinnowBoard3] Add ReadMe.MD Thread-Index: AdLH5321Vg7ZGxDlSeyLNAQ9qjGnyg== Date: Mon, 8 May 2017 10:40:21 +0000 Message-ID: <22D2C85ED001C54AA20BFE3B0E4751D152506906@SHSMSX103.ccr.corp.intel.com> Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: <22D2C85ED001C54AA20BFE3B0E4751D152506906@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] Add 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, 08 May 2017 10:40:26 -0000 Content-Language: en-US Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable 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 based 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-2017 https://github.com/tianocore/ed= k2-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