From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: mx.groups.io; dkim=missing; spf=pass (domain: intel.com, ip: 192.55.52.120, mailfrom: nathaniel.l.desimone@intel.com) Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) by groups.io with SMTP; Wed, 22 May 2019 12:12:03 -0700 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga003.fm.intel.com ([10.253.24.29]) by fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 22 May 2019 12:12:03 -0700 X-ExtLoop1: 1 Received: from orsmsx110.amr.corp.intel.com ([10.22.240.8]) by FMSMGA003.fm.intel.com with ESMTP; 22 May 2019 12:12:03 -0700 Received: from orsmsx114.amr.corp.intel.com ([169.254.8.116]) by ORSMSX110.amr.corp.intel.com ([169.254.10.7]) with mapi id 14.03.0415.000; Wed, 22 May 2019 12:12:03 -0700 From: "Nate DeSimone" To: "devel@edk2.groups.io" , "Agyeman, Prince" CC: "Chiu, Chasel" Subject: Re: [edk2-devel] [edk2-platforms] [PATCH v2 5/5] Intel/Readme.md: Updated readme with linux build instructions Thread-Topic: [edk2-devel] [edk2-platforms] [PATCH v2 5/5] Intel/Readme.md: Updated readme with linux build instructions Thread-Index: AQHVD4JzwbPdJyJYK0SCfxyCJY+2r6Z3hT8Q Date: Wed, 22 May 2019 19:12:03 +0000 Message-ID: <02A34F284D1DA44BB705E61F7180EF0AAEB47B95@ORSMSX114.amr.corp.intel.com> References: <3793b1cdad9c68d23ec1378f35f5fef9e4d42ced.1558406058.git.prince.agyeman@intel.com> In-Reply-To: <3793b1cdad9c68d23ec1378f35f5fef9e4d42ced.1558406058.git.prince.agyeman@intel.com> Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: dlp-product: dlpe-windows dlp-version: 11.2.0.6 dlp-reaction: no-action x-titus-metadata-40: eyJDYXRlZ29yeUxhYmVscyI6IiIsIk1ldGFkYXRhIjp7Im5zIjoiaHR0cDpcL1wvd3d3LnRpdHVzLmNvbVwvbnNcL0ludGVsMyIsImlkIjoiMTU1NTE0MWYtMDgzYi00MjgyLTg4YjUtYzRjOGNjNjIyZmNlIiwicHJvcHMiOlt7Im4iOiJDVFBDbGFzc2lmaWNhdGlvbiIsInZhbHMiOlt7InZhbHVlIjoiQ1RQX05UIn1dfV19LCJTdWJqZWN0TGFiZWxzIjpbXSwiVE1DVmVyc2lvbiI6IjE3LjEwLjE4MDQuNDkiLCJUcnVzdGVkTGFiZWxIYXNoIjoibW5ubkpNN0g4cnRnQjA0XC84KzlkY0FZMWpjU01QdU1xRjE0YmlRUzR2U0dhWForenYzYWpUTWk0cHJHNmJGWUIifQ== x-ctpclassification: CTP_NT x-originating-ip: [10.22.254.139] MIME-Version: 1.0 Content-Language: en-US Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Reviewed-by: Nate DeSimone -----Original Message----- From: devel@edk2.groups.io On Behalf Of Agyeman, Pr= ince Sent: Monday, May 20, 2019 8:08 PM To: devel@edk2.groups.io Cc: Chiu, Chasel ; Agyeman, Prince Subject: [edk2-devel] [edk2-platforms] [PATCH v2 5/5] Intel/Readme.md: Upd= ated readme with linux build instructions From: Prince Agyeman Signed-off-by: Prince Agyeman --- Platform/Intel/Readme.md | 42 ++++++++++++++++++++++++------------------ 1 file changed, 24 insertions(+), 18 deletions(-) diff --git a/Platform/Intel/Readme.md b/Platform/Intel/Readme.md index 1da= 5d0a..443fb40 100644 --- a/Platform/Intel/Readme.md +++ b/Platform/Intel/Readme.md @@ -107,9 +107,13 @@ return back to the minimum platform caller. =20 **Building with the python script** =20 -1. Open command window, go to the workspace directory, e.g. c:\Kabylake. -2. Type "cd edk2-platforms\Platform\Intel -3. Type "python build_bios.py = -p REPLACE_WITH_BOARD_NAME" +1. Open command window, go to the workspace directory, e.g. c:\Kabylake= =20 +or ~/Kabylake in the case of a linux OS 2. If using a linux OS + * Type "cd edk2" + * Type "source edksetup.sh" + * Type "cd ../" to go back to the workspace directory 3. Type "cd=20 +edk2-platforms/Platform/Intel 4. Type "python build_bios.py -p=20 +REPLACE_WITH_BOARD_NAME" =20 * build_bios.py arguments: =20 @@ -132,18 +136,19 @@ return back to the minimum platform caller. | | =20 * For more information on build options - * ``Type "python build_bios.py -h"`` + * Type "python build_bios.py -h" =20 * Note - * ``Python 2.7.16 and Python 3.7.3 compatible`` - * ``These python build scripts have been tested on Windows due to`` [cr= oss-platform limitations](#Known-limitations) + * Python 2.7.16 and Python 3.7.3 compatible + * This python build script has been tested on Windows 10 and Ubuntu=20 + 16.04.5 LTS + * See [cross-platform limitations](#Known-limitations) =20 * Configuration Files - * ``The edk2-platforms\Platform\Intel\build.cfg file contains the defau= lt settings used by build_bios.py`` - * ``The default settings are under the DEFAULT_CONFIG section`` - * ``Each board can have a settings file that will override the edk2-pla= tforms\Platform\Intel\build.cfg settings`` - * ``An example of a board specific settings:`` - * ``edk2-platforms\Platform\Intel\KabylakeOpenBoardPkg\KabylakeRvp3\b= uild_config.cfg`` + * The edk2-platforms\Platform\Intel\build.cfg file contains the=20 + default settings used by build_bios.py + * The default settings are under the DEFAULT_CONFIG section + * Each board can have a settings file that will override the=20 + edk2-platforms\Platform\Intel\build.cfg settings + * An example of a board specific settings: + *=20 + edk2-platforms\Platform\Intel\KabylakeOpenBoardPkg\KabylakeRvp3\build_ + config.cfg =20 * Workspace view of the build scripts * 
@@ -212,14 +217,13 @@ Users can also flash the UEFI firmware image to the =
highest area of the flash re
=20
 ### **Known limitations**
=20
-* All firmware projects can only build on Windows with the validated conf=
iguration below.
-  * Cross-platform build support is work-in-progress.
-
 **KabylakeOpenBoardPkg**
 1. This firmware project has only been tested on the Intel KabylakeRvp3 b=
oard.
 2. This firmware project has only been tested booting to Microsoft Window=
s 10 x64 with AHCI mode and Integrated Graphic
   Device.
-3. This firmware project build has only been tested using the Microsoft V=
isual Studio 2015 compiler.
+3. The Windows build was tested on Windows 10 with Microsoft Visual Studi=
o 2015.
+4. The Linux build was tested on Ubuntu 16.04.5 LTS with GCC version 5.4.=
0.
+5. The build was tested with NASM version 2.11.08.
=20
 **PurleyOpenBoardPkg**
 1. This firmware project has only been tested on the Microsoft MtOlympus =
board.
@@ -228,9 +232,11 @@ Users can also flash the UEFI firmware image to the h=
ighest area of the flash re
=20
 **ClevoOpenBoardPkg**
 1. Currently, support is only being added for the N1xxWU series of boards=
.
-2. The firmware project build has only been tested using the Microsoft Vi=
sual Studio 2015 compiler.
-3. The firmware project has not been tested on an actual board, it *shoul=
d not* be expected to boot.
-4. The firmware project applies to all Clevo supported board configuratio=
ns but is only being tested on System 76 Galago
+2. The Windows build was tested on Windows 10 with Microsoft Visual Studi=
o 2015 compiler.
+3. The Linux build was tested on Ubuntu 16.04.5 LTS with GCC version 5.4.=
0.
+4. The build was tested with NASM version 2.11.08.
+5. The firmware project has not been tested on an actual board, it *shoul=
d not* be expected to boot.
+6. The firmware project applies to all Clevo supported board=20
+configurations but is only being tested on System 76 Galago
   Pro devices.
=20
 ### **Planned Activities**
--
2.7.4