From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga09.intel.com (mga09.intel.com [134.134.136.24]) (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 240A98190E for ; Mon, 26 Dec 2016 03:35:03 -0800 (PST) Received: from orsmga004.jf.intel.com ([10.7.209.38]) by orsmga102.jf.intel.com with ESMTP; 26 Dec 2016 03:35:02 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.33,404,1477983600"; d="dat'59?scan'59,208,59";a="43391467" Received: from fmsmsx104.amr.corp.intel.com ([10.18.124.202]) by orsmga004.jf.intel.com with ESMTP; 26 Dec 2016 03:35:02 -0800 Received: from fmsmsx117.amr.corp.intel.com (10.18.116.17) by fmsmsx104.amr.corp.intel.com (10.18.124.202) with Microsoft SMTP Server (TLS) id 14.3.248.2; Mon, 26 Dec 2016 03:35:02 -0800 Received: from shsmsx151.ccr.corp.intel.com (10.239.6.50) by fmsmsx117.amr.corp.intel.com (10.18.116.17) with Microsoft SMTP Server (TLS) id 14.3.248.2; Mon, 26 Dec 2016 03:35:01 -0800 Received: from shsmsx103.ccr.corp.intel.com ([169.254.4.20]) by SHSMSX151.ccr.corp.intel.com ([169.254.3.204]) with mapi id 14.03.0248.002; Mon, 26 Dec 2016 19:34:58 +0800 From: "Guo, Mang" To: "edk2-devel@lists.01.org" CC: "Wei, David" , "Gao, Liming" , "Wu, Mike" Thread-Topic: [PATCH][edk2-platforms/branch] Add new platform branch devel-MinnowBoard3 Thread-Index: AdJfa7d5imQ5cegGQkWDrDskeHtfSQ== Date: Mon, 26 Dec 2016 11:34:58 +0000 Message-ID: <22D2C85ED001C54AA20BFE3B0E4751D1524D02D2@SHSMSX103.ccr.corp.intel.com> Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: <22D2C85ED001C54AA20BFE3B0E4751D1524D02D2@SHSMSX103.ccr.corp.intel.com> x-originating-ip: [10.239.127.40] MIME-Version: 1.0 X-Content-Filtered-By: Mailman/MimeDel 2.1.21 Subject: [PATCH][edk2-platforms/branch] Add new platform branch devel-MinnowBoard3 X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 26 Dec 2016 11:35:03 -0000 Content-Language: en-US Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable Add new branch(devel-MinnowBoard3) on edk2-platforms. All codes are ready in https://github.com/mangguo321/edk2-platforms.git -b = devel-MinnowBoard3 Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Guo Mang --- ReadMe.MD | 138 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++= ++++ 1 file changed, 138 insertions(+) create mode 100644 ReadMe.MD diff --git a/ReadMe.MD b/ReadMe.MD new file mode 100644 index 0000000..ec55d65 --- /dev/null +++ b/ReadMe.MD @@ -0,0 +1,138 @@ +=EF=BB=BF +This code base is designed for the MinnowBoard v3 platform using the Intel= (R) Atom(tm) Processor E3900 Series. + +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D + INDEX=20 +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D +1. HOW TO CREATE A FULL SOURCE TREE +2. HOW TO BUILD (WINDOWS ENVIRONMENT) +3. MAINTAINERS + =20 +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D +1. HOW TO CREATE A FULL SOURCE TREE=20 +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D +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"). + =20 + 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=20 + operating system or file system's maximum path length. + +2) Get MinnowBoard v3 branch from GitHub with the following command. + a. git clone https://github.com/tianocore/edk2-platforms.git -b devel-M= innowBoard3 + =20 + 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. + a. git clone https://github.com/tianocore/edk2-BaseTools-win32.git + b. Enter folder edk2-BaseTools-win32 + b. git checkout f0c97b7716ce92f1fc657f87f29bcc9170e5eb1f + c. Rename folder name from "edk2-BaseTools-win32/" to "win32/" and copy + win32/ to the BaseTools Binary folder. + (C:\MyWorkspace\edk2-platforms\BaseTools\Bin\) + +4) Get the Intel(R) Firmware Support Package(Intel FSP) + a. Run "git clone -b ApolloLake https://github.com/IntelFsp/FSP.git" to= download FSP. + b. Copy the ApolloLakeFspBinPkg to the folder + "C:\MyWorkspace\edk2-platforms\Silicon\BroxtonSoC\BroxtonFspPkg". + =20 +5) Install UEFI UNDI driver: + a. Download PREBOOT.EXE Version 21.1 from the "Intel=C2=AE Ethernet Con= nections=20 + 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 + b. Install PREBOOT.EXE into the default folder (C:\Intel21.1). + c. 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" + d. 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 + =20 +6) Install the NASM assembly language compiler: = =20 + a. Download NASM 2.12.02 binaries:=20 + 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 + b. 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\To= ols\nasm\Win32" + "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\To= ols\nasm\Win64" + +7) 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 the f= older + if it does not exist: + "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\To= ols\Iasl" + =20 +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. =20 + +9) Download MinnowBoard v3 Binary Object Modules + a. Download the "MinnowBoard_v3-0.60-Binary.Objects.zip" from the proje= ct page: + https://firmware.intel.com/projects/minnowboardv3 + b. 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\Bi= naries\IFWI" + +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D +2. HOW TO BUILD (WINDOWS ENVIRONMENT) +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D +Windows System Configuration: + Microsoft Windows 7 Ultimate 64-bit* + =20 +1) Setup Build Environment + + 1) Install C compiler (Visual Studio .NET VS2013/VS2015) in the=20 + build machine. + =20 + 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 by = Python.exe. + =20 +2) Build + +2a) Build Steps (32-bit)=20 + 1) To build a 32-bit release version + Open a command prompt of Microsoft Visual Studio, such as "Developer= Command Prompt for VS2013"; + Type the command: "cd C:\MyWorkspace\edk2-platforms";=20 + Type the command: "BuildBIOS.bat /VS13 /IA32 Broxton Release" to bui= ld a release version. + (Please use "VS15" flag for Visual Studio 2015 build) + =20 + 2) To build a 32-bit debug version + Open a command prompt of Microsoft Visual Studio, such as "Developer= Command Prompt for VS2013"; + Type the command: "cd C:\MyWorkspace\edk2-platforms";=20 + Type the command: "BuildBIOS.bat /VS13 /IA32 Broxton Debug" to build= a debug version. + (Please use "VS15" flag for Visual Studio 2015 build) + =20 + 3) After the build successfully completes, the 8MB firmware binary imag= e will be located in the + following location on your local hard drive:=20 + =20 + "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\To= ols\Stitch" + +2b) Build Steps (64-bit)=20 + 1) To build a 64-bit release version + Open a command prompt of Microsoft Visual Studio, such as "Developer= Command Prompt for VS2013"; + Type the command: "cd C:\MyWorkspace\edk2-platforms";=20 + Type the command: "BuildBIOS.bat /VS13 /x64 Broxton Release" to buil= d a release version. + (Please use "VS15" flag for Visual Studio 2015 build) + =20 + 2) To build a 64-bit debug version + Open a command prompt of Microsoft Visual Studio, such as "Developer= Command Prompt for VS2013"; + Type the command: "cd C:\MyWorkspace\edk2-platforms";=20 + Type the command: "BuildBIOS.bat /VS13 /x64 Broxton Debug" to build = a debug version. + (Please use "VS15" flag for Visual Studio 2015 build) + =20 + 3) After the build successfully completes, the 8MB firmware binary imag= e will be located in the + following location on your local hard drive:=20 + =20 + "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\To= ols\Stitch" + +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D + MAINTAINERS +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D +david.wei@intel.com +mang.guo@intel.com +vincent.zimmer@intel.com +mike.wu@intel.com=20 +shifeix.a.lu@intel.com --=20 2.10.1.windows.1