From nobody Sat May 4 02:34:55 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 1526539150858697.3274661128731; Wed, 16 May 2018 23:39:10 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id 69594203BBBA6; Wed, 16 May 2018 23:39:09 -0700 (PDT) Received: from mga18.intel.com (mga18.intel.com [134.134.136.126]) (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 1B628203B992C for ; Wed, 16 May 2018 23:39:07 -0700 (PDT) Received: from fmsmga008.fm.intel.com ([10.253.24.58]) by orsmga106.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 16 May 2018 23:39:06 -0700 Received: from fmsmsx107.amr.corp.intel.com ([10.18.124.205]) by fmsmga008.fm.intel.com with ESMTP; 16 May 2018 23:39:06 -0700 Received: from fmsmsx155.amr.corp.intel.com (10.18.116.71) by fmsmsx107.amr.corp.intel.com (10.18.124.205) with Microsoft SMTP Server (TLS) id 14.3.319.2; Wed, 16 May 2018 23:38:49 -0700 Received: from shsmsx152.ccr.corp.intel.com (10.239.6.52) by FMSMSX155.amr.corp.intel.com (10.18.116.71) with Microsoft SMTP Server (TLS) id 14.3.319.2; Wed, 16 May 2018 23:38:45 -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; Thu, 17 May 2018 14:38:44 +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.126; helo=mga18.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,409,1520924400"; d="dat'59?scan'59,208,59";a="40601550" From: "Guo, Mang" To: "edk2-devel@lists.01.org" Thread-Topic: [Patch][edk2-platforms/devel-IntelAtomProcessorE3900] Change ReadMe.MD Thread-Index: AdPtqa9ZwapZsksbS9q81hIf0yVbYw== Date: Thu, 17 May 2018 06:38:44 +0000 Message-ID: <22D2C85ED001C54AA20BFE3B0E4751D15260E2D4@SHSMSX103.ccr.corp.intel.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: <22D2C85ED001C54AA20BFE3B0E4751D15260E2D4@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] Change 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 | 133 +++++--------------------------------------------= ---- ReadMe.MD | 8 +--- 2 files changed, 13 insertions(+), 128 deletions(-) diff --git a/Platform/ReadMe.MD b/Platform/ReadMe.MD index 024e5b7..9f5ae85 100644 --- a/Platform/ReadMe.MD +++ b/Platform/ReadMe.MD @@ -1,130 +1,19 @@ -=C3=AF=C2=BB=C2=BF=C3=AF=C2=BB=C2=BF# UEFI Firmware Project for Intel Atom= (R) Processor E3900 Series platforms +# Intel Atom(R) Processor E3900 Series Platforms =20 -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 +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). =20 -## Download Official Releases +Contributions to this open source project are covered by the +[TianoCore Contribution Agreement 1.1](Contributions.txt) =20 -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 +The majority of the content in the this open source project uses a +[BSD 2-Clause License](License.txt). =20 -## Download the Latest Source Code +The maintainers are listed in [Maintainers.txt](Maintainers.txt). =20 -Official source releases are recommended since they have passed stability = testing. Use the directions below to download the latest code. -``` -1. Create a new directory for use as your WORKSPACE (e.g. "C:\MyWorkspace"= ). +# Resources =20 -2. Download the following repositories and required files to the WORKSPACE: +* [devel-IntelAtomProcessorE3900](Platform/ReadMe.MD) -- Instructions =20 -edk2 repository - git clone -b vUDK2018 https://github.com/tianocore/edk2.git - -edk2-platforms repository - git clone https://github.com/tianocore/edk2-platforms.git -b devel-Int= elAtomProcessorE3900 - -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". - -3. Download 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.7.0.zip from http://www.asix.com.tw/Fr= ootAttach/driver/AX88179_178A_UEFI_V2.7.0.zip. - b. Unzip AX88179_178A_UEFI_V2.7.0.zip to get AX88179_178A_UEFI_V2.7.0_X= 64.efi and AX88179_178A_UEFI_V2.7.0_IA32.efi. - C. Copy AX88179_178A_UEFI_V2.7.0_X64.efi and AX88179_178A_UEFI_V2.7.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/" - -4. Follow the instructions found in the "OpenSSL-HOWTO.txt" file located i= n the Workspace - (e.g. "C:\MyWorkspace\edk2-platforms\Core\CryptoPkg\Library\OpensslLib\= OpenSSL-HOWTO.txt") - to install the OpenSSL* source code and enable the CryptoPkg module. =20 - -5. Download Platform Binary Object Modules - a. Download the "MinnowBoard_v3-0.69-Binary.Objects.zip" from the proje= ct page: - https://firmware.intel.com/projects/minnowboard3 - - b. Unzip and copy the two folders (MinnowBoard3, MinnowBoard3Next) 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 command window, goto the workspace dir, e.g. c:\MyWorkspace. -2. Type "cd edk2-platforms". -3. Build - ``` - Examples: =20 - To build release version 32-bit BIOS for Minnowboard 3 FAB B with V= S2013, - BuildBIOS.bat /vs13 /B /IA32 Broxton Release - =20 - To build release version 64-bit BIOS for Minnowboard 3 FAB B with V= S2013, - BuildBIOS.bat /vs13 /B /x64 Broxton Release - ``` -## **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, goto the platform package "MyWorkspace/edk2-plat= forms". -2. Build - ``` - - Type "./BuildBIOS.sh /B Broxton Release" to build a release version. - - Type "./BuildBIOS.sh /B Broxton Debug" to build a debug version. - ``` - =20 -## **Related Materials** - =20 - http://minnowboard.org/ -- Open Source Hardware Project - - https://firmware.intel.com/projects/minnowboard3 -- Release notes, pre-= built release/debug binaries, build instructions, and binary objects requir= ed to compile firmware. +* http://minnowboard.org/ -- Platform Information. =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 diff --git a/ReadMe.MD b/ReadMe.MD index 80f6657..9f5ae85 100644 --- a/ReadMe.MD +++ b/ReadMe.MD @@ -14,10 +14,6 @@ The maintainers are listed in [Maintainers.txt](Maintain= ers.txt). =20 * [devel-IntelAtomProcessorE3900](Platform/ReadMe.MD) -- Instructions =20 -### Projects Supported by this codebase +* http://minnowboard.org/ -- Platform Information. =20 - (1) MinnowBoard 3 open hardware project: - - * http://minnowboard.org/ -- Platform Information. - - * https://firmware.intel.com/projects/minnowboard3 -- Release notes, pr= e-built release/debug binaries, build instructions, and binary objects requ= ired to compile firmware. \ No newline at end of file +* 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