From nobody Sat May 4 19:56:13 2024 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; spf=none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) smtp.mailfrom=edk2-devel-bounces@lists.01.org; dmarc=fail(p=none dis=none) header.from=intel.com Return-Path: Received: from ml01.01.org (ml01.01.org [198.145.21.10]) by mx.zohomail.com with SMTPS id 1526632337958232.27621004649836; Fri, 18 May 2018 01:32:17 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id 5124720961857; Fri, 18 May 2018 01:32:16 -0700 (PDT) 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 A014E207E4DFA for ; Fri, 18 May 2018 01:32:14 -0700 (PDT) Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by orsmga103.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 18 May 2018 01:32:13 -0700 Received: from fmsmsx104.amr.corp.intel.com ([10.18.124.202]) by fmsmga001.fm.intel.com with ESMTP; 18 May 2018 01:32:13 -0700 Received: from fmsmsx119.amr.corp.intel.com (10.18.124.207) by fmsmsx104.amr.corp.intel.com (10.18.124.202) with Microsoft SMTP Server (TLS) id 14.3.319.2; Fri, 18 May 2018 01:32:12 -0700 Received: from shsmsx152.ccr.corp.intel.com (10.239.6.52) by FMSMSX119.amr.corp.intel.com (10.18.124.207) with Microsoft SMTP Server (TLS) id 14.3.319.2; Fri, 18 May 2018 01:32:11 -0700 Received: from shsmsx103.ccr.corp.intel.com ([169.254.4.210]) by SHSMSX152.ccr.corp.intel.com ([169.254.6.6]) with mapi id 14.03.0319.002; Fri, 18 May 2018 16:32:10 +0800 X-Original-To: edk2-devel@lists.01.org Received-SPF: none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) client-ip=198.145.21.10; envelope-from=edk2-devel-bounces@lists.01.org; helo=ml01.01.org; 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 X-Amp-Result: UNSCANNABLE X-Amp-File-Uploaded: False X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.49,413,1520924400"; d="dat'59?scan'59,208,59";a="56381530" From: "Guo, Mang" To: "edk2-devel@lists.01.org" Thread-Topic: [Patch][edk2-platforms/devel-IntelAtomProcessorE3900] Platform/ReadMe.MD Thread-Index: AdPugrAo2tdOMNEqQJ+fbeySJNeczw== Date: Fri, 18 May 2018 08:32:09 +0000 Message-ID: <22D2C85ED001C54AA20BFE3B0E4751D15260E5B1@SHSMSX103.ccr.corp.intel.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: <22D2C85ED001C54AA20BFE3B0E4751D15260E5B1@SHSMSX103.ccr.corp.intel.com> x-originating-ip: [10.239.127.40] MIME-Version: 1.0 X-Content-Filtered-By: Mailman/MimeDel 2.1.26 Subject: [edk2] [Patch][edk2-platforms/devel-IntelAtomProcessorE3900] Platform/ReadMe.MD X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.26 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: "Wei, David" Content-Transfer-Encoding: quoted-printable Errors-To: edk2-devel-bounces@lists.01.org Sender: "edk2-devel" X-ZohoMail: RSF_4 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Guo Mang --- Platform/ReadMe.MD | 186 +++++++++++++++++++++++++++++++++++++++++++++++++= ---- 1 file changed, 175 insertions(+), 11 deletions(-) diff --git a/Platform/ReadMe.MD b/Platform/ReadMe.MD index 9f5ae85..5381de3 100644 --- a/Platform/ReadMe.MD +++ b/Platform/ReadMe.MD @@ -1,19 +1,183 @@ -# Intel Atom(R) Processor E3900 Series Platforms +=C3=AF=C2=BB=C2=BF=C3=AF=C2=BB=C2=BF# UEFI Firmware Project for Intel Atom= (R) Processor E3900 Series platforms =20 -This codebase is designed for Intel Atom(R) Processor E3900 Series platfor= ms.(https://www.intel.com/content/www/us/en/embedded/products/apollo-lake/o= verview.html) (formerly Apollo Lake). +This codebase is designed for Intel Atom(R) Processor E3900 Series platfor= ms (formerly Apollo Lake). https://www.intel.com/content/www/us/en/embedded= /products/apollo-lake/overview.html =20 -Contributions to this open source project are covered by the -[TianoCore Contribution Agreement 1.1](Contributions.txt) +## Download Official Releases =20 -The majority of the content in the this open source project uses a -[BSD 2-Clause License](License.txt). +Please refer to the release notes to download official releases (source co= de and binary images). Information is available at https://firmware.intel.c= om/projects/minnowboard3 =20 -The maintainers are listed in [Maintainers.txt](Maintainers.txt). +## Download the Latest Source Code =20 -# Resources +Official source releases are recommended since they have passed stability = testing. Use the directions below to download the latest code. +``` +1. Create a new folder (directory) on the root of your local development m= achine + for use as your workspace (this example uses "C:\MyWorkspace"). =20 -* [devel-IntelAtomProcessorE3900](Platform/ReadMe.MD) -- Instructions +2. Get devel-IntelAtomProcessorE3900 branch from GitHub* + git clone https://github.com/tianocore/edk2-platforms.git -b devel-Inte= lAtomProcessorE3900 =20 -* http://minnowboard.org/ -- Platform Information. +3. Get EDK II packages + git clone -b vUDK2018 https://github.com/tianocore/edk2.git + +4. Get the Intel(R) Firmware Support Package(Intel(R) FSP) + 1.git clone -b ApolloLake https://github.com/IntelFsp/FSP.git + 2.cd FSP + 3.git checkout a57c66616e78b471515a1e1862796bf61d3824d8 + 4.Copy the ApolloLakeFspBinPkg to the folder + "C:\MyWorkspace\edk2-platforms\Silicon\BroxtonSoC\BroxtonFspPkg". + +5. Install UEFI UNDI driver: + 1.Install UEFI UNDI driver for Intel i210 Ethernet Controller + Download PREBOOT.EXE Version 21.1 from the "Intel=C3=82=C2=AE Ethernet = Connections=20 + Boot Utility, Preboot Images, and EFI Drivers" page. + https://downloadcenter.intel.com/download/19186/Intel-Ethernet-Connec= tions-Boot-Utility-Preboot-Images-and-EFI-Drivers + + Windows user: + a. Install PREBOOT.EXE into the default folder (C:\Intel21.1). + b. 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" + + Linux user: + a. Use command "unzip PREBOOT.EXE" to extract UEFI x64 PCI-E gigabit dr= iver=20 + (preboot/APPS/EFI/EFIx64/E7320X3.EFI) + b. Copy E7320X3.EFI to platform package directory below, create the fol= der + if it does not exist: + "~/src/MyWorkspace/edk2-platforms/Platform/BroxtonPlatformPkg/Common= /Binaries/UNDI/I210PcieUndiDxe" + + 2.Install UNDI driver for AX88179 USB-to-LAN adapter + a. Download AX88179_178A_UEFI_V2.8.0.zip from http://www.asix.com.tw/Fr= ootAttach/driver/AX88179_178A_UEFI_V2.8.0.zip. + b. Unzip AX88179_178A_UEFI_V2.8.0.zip to get AX88179_178A_UEFI_V2.8.0_X= 64.efi and AX88179_178A_UEFI_V2.8.0_IA32.efi. + C. Copy AX88179_178A_UEFI_V2.8.0_X64.efi and AX88179_178A_UEFI_V2.8.0_I= A32.efi to below directory, create the folder + if it does not exist: + Windows user: "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatfor= mPkg\Common\Binaries\UNDI\AX88179\" + Linux user: "~/src/MyWorkspace/edk2-platforms/Platform/BroxtonPlatfo= rmPkg/Common/Binaries/UNDI/AX88179/" + +6. Follow the instructions found in the "OpenSSL-HOWTO.txt" file located i= n the Workspace + (e.g. "C:\MyWorkspace\edk2\CryptoPkg\Library\OpensslLib\OpenSSL-HOWTO.t= xt") + to install the OpenSSL* source code and enable the CryptoPkg module. =20 + +7. Download "IntelAtomE3900-0.70-Binary.Objects.zip" Binary Object Modules + a. Download the "IntelAtomE3900-0.70-Binary.Objects.zip" from the proje= ct page: + https://firmware.intel.com/projects/IntelAtomProcessorE3900 + + b. Unzip and copy the folders into the directory below, and create the = folder if it does not exist: + "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Board\" +``` + +## **Windows Build Instructions** + +### Pre-requisites + +* Microsoft Visual Studio + - Install C compiler (Visual Studio .NET* VS2013/VS2015) on the build ma= chine. +* ASL compiler: Available from http://www.acpica.org + - Unzip and copy ```iasl.exe``` into ```C:\MyWorkspace\edk2-platforms\Pl= atform\BroxtonPlatformPkg\Common\Tools\Iasl```. +* NASM assembler: Available from: http://www.nasm.us/ + - Unzip the 32-bit & 64-bit versions of nasm.exe to the directories list= ed below + ``` + C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\Tools\n= asm\Win32 + C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\Tools\n= asm\Win64 + ``` +* Python 2.7.10: Available from: https://www.python.org/downloads/release= /python-2710/ + - Install Python and make sure that a file with the extension of ".py" w= ill be opened by Python.exe. + +### Build + +1. Open a command prompt of Microsoft Visual Studio, such as "Developer Co= mmand Prompt for VS2013"; +2. Type the command: "cd C:\MyWorkspace\edk2-platforms" to enter your work= space; +3. Run below command to build: + ``` + Build Command Usage: BuildBIOS.bat [Build Options] + Build Options: + To Select Visual Studio Version: + /vs13 Set Compiler to vs2013 build (default) + /vs15 Set Compiler to vs2015 build + =20 + To Select CPU Arch supported by BIOS: + /x64 Set Arch to X64 (default) + /IA32 Set Arch to IA32=20 + =20 + To Select Board Supported by BIOS: + /MX MinnowBoard 3 Module + /LH Leaf Hill CRB + =20 + To Select FAB ID supported by BIOS: + /D Set FabId to D + =20 + PlatformName: Broxton + BuildTargets: Release or Debug + =20 + Examples: =20 + To build release version 32-bit BIOS for Minnowboard 3 Module Pre-p= roduction with VS2015, + BuildBIOS.bat /vs15 /MX /A /IA32 Broxton Release + + To build release version 64-bit BIOS for Minnowboard 3 Module Pre-p= roduction with VS2015, + BuildBIOS.bat /vs15 /MX /A /x64 Broxton Release =20 +=20 + To build release version 32-bit BIOS for Leaf Hill CRB with VS2015, + BuildBIOS.bat /vs15 /LH /D /IA32 Broxton Release + =20 + To build release version 64-bit BIOS for Leaf Hill CRB with VS2015, + BuildBIOS.bat /vs15 /LH /D /x64 Broxton Release =20 + + ``` +4. After the build successfully completes, the 8MB firmware binary image w= ill + be located in the following location on your local hard drive: + "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\Tools= \Stitch" + =20 +## **Linux Build Instructions** + +### Pre-requisites + +* Linux System Configuration + - Ubuntu 16.04 64-bit + - GCC version 5 +* Use below command to install required packages: + ``` + # sudo apt-get update + # sudo apt-get install nasm=20 + # sudo apt-get install iasl + # sudo apt-get install build-essential + # sudo apt-get install uuid-dev + ``` + +### Build + +1. Open a command prompt, type command: "cd ~/src/MyWorkspace/edk2-platfor= ms" + to enter your workspace directory; +2. Run below command to build: + ``` + Build Command Usage: BuildBIOS.bat [Build Options] + Build Options: + To Select Board Supported by BIOS: + /MX MinnowBoard 3 Module + /LH Leaf Hill CRB + + To Select FAB ID supported by BIOS: + /D Set FabId to D=20 + + PlatformName: Broxton + BuildTargets: Release or Debug + Examples: + To build release version 64-bit BIOS for MinnowBoard 3 Module, + ./BuildBIOS.sh /MX /A Broxton Release + + To build release version 64-bit BIOS for Leaf Hill CRB, + ./BuildBIOS.sh /LH /D Broxton Release + + To build debug version 64-bit BIOS for Leaf Hill CRB, + ./BuildBIOS.sh /LH /D Broxton Debug + + ``` +=20 +3. After the build successfully completes, the 8MB firmware binary image w= ill + be located in the following location on your local hard drive: + "~/src/MyWorkspace/edk2-platforms/Platform/BroxtonPlatformPkg/Common= /Tools/Stitch/" + +## **Related Materials** + =20 + http://minnowboard.org/ -- Open Source Hardware Project + + https://firmware.intel.com/projects/IntelAtomProcessorE3900 -- Release= notes, pre-built release/debug binaries, build instructions, and binary ob= jects required to compile firmware. =20 -* https://firmware.intel.com/projects/IntelAtomProcessorE3900 -- Release = notes, pre-built release/debug binaries, build instructions, and binary obj= ects required to compile firmware. \ No newline at end of file --=20 2.10.1.windows.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel