From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) (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 9C2392095D8EF for ; Sun, 16 Jul 2017 23:16:12 -0700 (PDT) Received: from orsmga003.jf.intel.com ([10.7.209.27]) by fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 16 Jul 2017 23:18:04 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.40,373,1496127600"; d="dat'59?scan'59,208,59";a="993752550" Received: from fmsmsx104.amr.corp.intel.com ([10.18.124.202]) by orsmga003.jf.intel.com with ESMTP; 16 Jul 2017 23:18:04 -0700 Received: from fmsmsx151.amr.corp.intel.com (10.18.125.4) by fmsmsx104.amr.corp.intel.com (10.18.124.202) with Microsoft SMTP Server (TLS) id 14.3.319.2; Sun, 16 Jul 2017 23:18:03 -0700 Received: from shsmsx152.ccr.corp.intel.com (10.239.6.52) by FMSMSX151.amr.corp.intel.com (10.18.125.4) with Microsoft SMTP Server (TLS) id 14.3.319.2; Sun, 16 Jul 2017 23:18:02 -0700 Received: from shsmsx103.ccr.corp.intel.com ([169.254.4.116]) by SHSMSX152.ccr.corp.intel.com ([169.254.6.122]) with mapi id 14.03.0319.002; Mon, 17 Jul 2017 14:18:01 +0800 From: "Guo, Mang" To: "edk2-devel@lists.01.org" CC: "Wei, David" , "Lu, ShifeiX A" Thread-Topic: [Patch][edk2-platforms/minnowboard-max-udk2015] Add ReadMe.MD Thread-Index: AdL+xG0MVjha148ITHGmCyei+nnN6w== Date: Mon, 17 Jul 2017 06:18:00 +0000 Message-ID: <22D2C85ED001C54AA20BFE3B0E4751D152520BCA@SHSMSX103.ccr.corp.intel.com> Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: <22D2C85ED001C54AA20BFE3B0E4751D152520BCA@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/minnowboard-max-udk2015] 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, 17 Jul 2017 06:16:12 -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 | 113 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++= ++++ 1 file changed, 113 insertions(+) create mode 100644 ReadMe.MD diff --git a/ReadMe.MD b/ReadMe.MD new file mode 100644 index 0000000..e5e7711 --- /dev/null +++ b/ReadMe.MD @@ -0,0 +1,113 @@ +=EF=BB=BF +This code base is designed for the MinnowBoard Max/Turbot platforms using = the Intel(R) Atom(tm) Processor E3800 Series. +This code base is based on UDK2015 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 Max branch from GitHub with the following command. + 1. Run `git clone -b minnowboard-max-udk2015 https://github.com/tianoco= re/edk2-platforms.git` + 2. Enter folder edk2-platforms + 3. Run `git checkout fd6510974d21282b9f8c1ff003c05b92a464bca6` + + 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 ea691aec89b06aa83474100df1de000a875b4ea0` + +4. Download MinnowBoard MAX 0.96 Binary Object Modules from http://firmwar= e.intel.com/projects/minnowboard-max. + The "MinnowBoard_MAX-0.96-Binary.Objects.zip" file contains three addit= ional + folders required for the full source tree. + =20 + IA32FamilyCpuPkg + =20 + Vlv2BinaryPkg + =20 + Vlv2MiscBinariesPkg + =20 + Unzip and copy the three folders to the workspace directory (e.g. "C:\M= yWorkspace\edk2-platforms"). + + +## 2. HOW TO BUILD (WINDOWS ENVIRONMENT) + +Windows System Configuration: + Microsoft Windows 7 Ultimate 64-bit* + +1. Setup Build Environment + + 1. Install Visual Studio 2008/2010/2012/2013 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. Extract Source Code + 1. Follow the instructions of "HOW TO CREATE A FULL SOURCE TREE" (step = 1 above) + to create a full source tree. + + 2. Follow the instructions found in the file "Patch-HOWTO.txt" located = in your + workspace (e.g. "C:\MyWorkspace\CryptoPkg\Library\OpensslLib\Patch-H= OWTO.txt")=20 + to install the Openssl source code. + +3. Install the iasl compiler by downloading iasl-win-20141107.zip from the= following + location: "https://acpica.org/downloads/version-20141107" and place the= unzipped + content ("iasl.exe") into the directory "C:\ASL" on your local hard dri= ve + (create the folder "C:\ASL" if it does not exist). + =20 +4a. 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\Vlv2TbltDevice= Pkg` + * Type the command: `Build_IFWI.bat /IA32 MNW2 Release` to build a r= elease version. + + 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\Vlv2TbltDevice= Pkg` + * Type the command: `Build_IFWI.bat /IA32 MNW2 Debug` to build a deb= ug version. + + 3. After the build successfully completes, the 8MB firmware binary imag= e will be located in the + following location on your local hard drive: + + "C:\MyWorkspace\edk2-platforms\Vlv2TbltDevicePkg\Stitch\" + +4b. 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\Vlv2TbltDevice= Pkg` + * Type the command: `Build_IFWI.bat MNW2 Release` to build a release= version. + + 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\Vlv2TbltDevice= Pkg` + * Type the command: `Build_IFWI.bat MNW2 Debug` to build a debug ver= sion. + + 3. After the build successfully completes, the 8MB firmware binary imag= e will be located in the + following location on your local hard drive: + + "C:\MyWorkspace\edk2-platforms\Vlv2TbltDevicePkg\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