From nobody Sat May 4 22:37:07 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 Return-Path: Received: from ml01.01.org (ml01.01.org [198.145.21.10]) by mx.zohomail.com with SMTPS id 1510022272448789.9784789054972; Mon, 6 Nov 2017 18:37:52 -0800 (PST) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id B99EE2035D11E; Mon, 6 Nov 2017 18:33:51 -0800 (PST) Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) (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 C5FE0202E5E59 for ; Mon, 6 Nov 2017 18:33:50 -0800 (PST) Received: from fmsmga002.fm.intel.com ([10.253.24.26]) by orsmga101.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 06 Nov 2017 18:37:49 -0800 Received: from fmsmsx107.amr.corp.intel.com ([10.18.124.205]) by fmsmga002.fm.intel.com with ESMTP; 06 Nov 2017 18:37:49 -0800 Received: from fmsmsx123.amr.corp.intel.com (10.18.125.38) by fmsmsx107.amr.corp.intel.com (10.18.124.205) with Microsoft SMTP Server (TLS) id 14.3.319.2; Mon, 6 Nov 2017 18:37:49 -0800 Received: from shsmsx102.ccr.corp.intel.com (10.239.4.154) by fmsmsx123.amr.corp.intel.com (10.18.125.38) with Microsoft SMTP Server (TLS) id 14.3.319.2; Mon, 6 Nov 2017 18:37:48 -0800 Received: from shsmsx103.ccr.corp.intel.com ([169.254.4.213]) by shsmsx102.ccr.corp.intel.com ([169.254.2.175]) with mapi id 14.03.0319.002; Tue, 7 Nov 2017 10:37:46 +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.20; helo=mga02.intel.com; envelope-from=mang.guo@intel.com; receiver=edk2-devel@lists.01.org X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.44,355,1505804400"; d="dat'59?scan'59,208,59";a="1240608696" From: "Guo, Mang" To: "edk2-devel@lists.01.org" Thread-Topic: [Patch][edk2-platforms/devel-MinnowBoard3-UDK2017] Change ReadMe format Thread-Index: AdNXcWSpRRkD2NLbQf62jXs1RQmqDw== Date: Tue, 7 Nov 2017 02:37:45 +0000 Message-ID: <22D2C85ED001C54AA20BFE3B0E4751D152576CC6@SHSMSX103.ccr.corp.intel.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: <22D2C85ED001C54AA20BFE3B0E4751D152576CC6@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: [edk2] [Patch][edk2-platforms/devel-MinnowBoard3-UDK2017] Change ReadMe format 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: , 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 --- ReadMe.MD | 63 ++++++++++++++++++++++++++++++++++++-----------------------= ---- 1 file changed, 36 insertions(+), 27 deletions(-) diff --git a/ReadMe.MD b/ReadMe.MD index f5cbc7c..a42260e 100644 --- a/ReadMe.MD +++ b/ReadMe.MD @@ -41,17 +41,19 @@ This code base is based on UDK2017 core packages. Download PREBOOT.EXE Version 21.1 from the "Intel=C3=82=C2=AE Ethern= et Connections 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 - Windows user: - 1. Install PREBOOT.EXE into the default folder (C:\Intel21.1). - 2. Copy the UEFI x64 PCI-E gigabit driver (C:\Intel21.1\APPS\EFI\EFIx64= \E7320X3.EFI)=20 + + Windows user: + 1. Install PREBOOT.EXE into the default folder (C:\Intel21.1). + 2. Copy the UEFI x64 PCI-E gigabit driver (C:\Intel21.1\APPS\EFI\EFI= x64\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: - 1. Use command "unzip PREBOOT.EXE" to extract UEFI x64 PCI-E gigabit dr= iver + * "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Commo= n\Binaries\UNDI\I210PcieUndiDxe" + + Linux user: + 1. Use command "unzip PREBOOT.EXE" to extract UEFI x64 PCI-E gigabit= driver (preboot/APPS/EFI/EFIx64/E7320X3.EFI) - 2. Copy E7320X3.EFI to platform package directory below, create the fol= der + 2. Copy E7320X3.EFI to platform package directory below, create the = folder if it does not exist: - * "~/src/MyWorkspace/edk2-platforms/Platform/BroxtonPlatformPkg/Common= /Binaries/UNDI/I210PcieUndiDxe" + * "~/src/MyWorkspace/edk2-platforms/Platform/BroxtonPlatformPkg/Co= mmon/Binaries/UNDI/I210PcieUndiDxe" =20 6. 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") @@ -67,7 +69,7 @@ This code base is based on UDK2017 core packages. ## 2. HOW TO BUILD (WINDOWS ENVIRONMENT) =20 Windows System Configuration: - Microsoft Windows 7 Ultimate 64-bit* + - Microsoft Windows 7 Ultimate 64-bit* =20 1. Setup Build Environment =20 @@ -77,24 +79,29 @@ Windows System Configuration: * Make sure that a file with the extension of ".py" will be opened b= y Python.exe. =20 3. Install the NASM assembly language compiler: - a. Download NASM 2.12.02 binaries: + + a. Download NASM 2.12.02 binaries: * http://www.nasm.us/pub/nasm/releasebuilds/2.12.02/win32/nasm-2.1= 2.02-win32.zip * http://www.nasm.us/pub/nasm/releasebuilds/2.12.02/win64/nasm-2.1= 2.02-win64.zip - b. Unzip the 32-bit & 64-bit versions of nasm.exe to the directories= listed below, + + b. Unzip the 32-bit & 64-bit versions of nasm.exe to the directori= es listed below, respectively, and create the folders if they do not exist: * "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Commo= n\Tools\nasm\Win32" * "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Commo= n\Tools\nasm\Win64" =20 4. Install the ACPI Source Language (ASL) compiler: - a. Install the IASL 2016-09-30 compiler from acpica.org: + + 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 th= e folder + + b. Unzip the "iasl.exe" file into the directory below, and create = the folder if it does not exist: * "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Comm= on\Tools\Iasl" =20 2. Build =20 - 2a. Build Steps (32-bit) + 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` @@ -110,9 +117,10 @@ Windows System Configuration: 3. After the build successfully completes, the 8MB firmware binary ima= ge will be located in the following location on your local hard drive: =20 - "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\To= ols\Stitch" + * "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\= Tools\Stitch" + + 2b. Build Steps (64-bit) =20 - 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` @@ -128,36 +136,37 @@ Windows System Configuration: 3. After the build successfully completes, the 8MB firmware binary ima= ge will be located in the following location on your local hard drive: =20 - "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\To= ols\Stitch" + * "C:\MyWorkspace\edk2-platforms\Platform\BroxtonPlatformPkg\Common\T= ools\Stitch" =20 ## 3. HOW TO BUILD (LINUX ENVIRONMENT) =20 Linux System Configuration: - Ubuntu 16.04 64-bit - bash shell - gcc version 5 or above + - Ubuntu 16.04 64-bit + - bash shell + - gcc version 5 or above =20 1. Setup Build Environment - Use below command to install required packages: + Use below command to install required packages: + ``` # sudo apt-get update # sudo apt-get install nasm # sudo apt-get install iasl # sudo apt-get install build-essential # sudo apt-get install uuid-dev - + ``` 2. Build Steps (64-bit) 1. To build a 64-bit release version - * Open a command prompt, type command: "cd ~/src/MyWorkspace/edk2-pl= atforms"; - * For MinnowBoard 3 FAB B, type the command:"./BuildBIOS.sh /B Relea= se" to build a release version. + * Open a command prompt, type command: `cd ~/src/MyWorkspace/edk2-pl= atforms`; + * For MinnowBoard 3 FAB B, type the command:`./BuildBIOS.sh /B Relea= se` to build a release version. (Replace "/B" with "/A" for MinnowBoard 3 FAB A board) 2. To build a 64-bit debug version=20 - * Open a command prompt, type command: "cd ~/src/MyWorkspace/edk2-pl= atforms"; - * For MinnowBoard 3 FAB B, type the command:"./BuildBIOS.sh /B Debug= " to build a debug version. + * Open a command prompt, type command: `cd ~/src/MyWorkspace/edk2-pl= atforms`; + * For MinnowBoard 3 FAB B, type the command:`./BuildBIOS.sh /B Debug= ` to build a debug version. (Replace "/B" with "/A" for MinnowBoard 3 FAB A board) 3. After the build successfully completes, the 8MB firmware binary ima= ge will be located in the following location on your local hard drive: =20 - "~/src/MyWorkspace/edk2-platforms/Platform/BroxtonPlatformPkg/Common= /Tools/Stitch/" + * "~/src/MyWorkspace/edk2-platforms/Platform/BroxtonPlatformPkg/Commo= n/Tools/Stitch/" =20 ## MAINTAINERS =20 --=20 2.10.1.windows.1 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel