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.151, mailfrom: chasel.chiu@intel.com) Received: from mga17.intel.com (mga17.intel.com [192.55.52.151]) by groups.io with SMTP; Mon, 20 May 2019 20:22:21 -0700 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by fmsmga107.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 20 May 2019 20:22:21 -0700 X-ExtLoop1: 1 Received: from pgsmsx101.gar.corp.intel.com ([10.221.44.78]) by fmsmga004.fm.intel.com with ESMTP; 20 May 2019 20:22:20 -0700 Received: from pgsmsx111.gar.corp.intel.com ([169.254.2.3]) by PGSMSX101.gar.corp.intel.com ([169.254.1.143]) with mapi id 14.03.0415.000; Tue, 21 May 2019 11:20:21 +0800 From: "Chiu, Chasel" To: "Agyeman, Prince" , "devel@edk2.groups.io" Subject: Re: [edk2-platforms] [PATCH v2 5/5] Intel/Readme.md: Updated readme with linux build instructions Thread-Topic: [edk2-platforms] [PATCH v2 5/5] Intel/Readme.md: Updated readme with linux build instructions Thread-Index: AQHVD4J5rw45B5Qs+kyJhBXnRLF8j6Z06Q2g Date: Tue, 21 May 2019 03:20:21 +0000 Message-ID: <3C3EFB470A303B4AB093197B6777CCEC503232B4@PGSMSX111.gar.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.0.600.7 dlp-reaction: no-action x-titus-metadata-40: eyJDYXRlZ29yeUxhYmVscyI6IiIsIk1ldGFkYXRhIjp7Im5zIjoiaHR0cDpcL1wvd3d3LnRpdHVzLmNvbVwvbnNcL0ludGVsMyIsImlkIjoiNmJlOTc1YjktYTU2Zi00OTEyLTkwYmYtMDAxMWI5ZmYzYWJjIiwicHJvcHMiOlt7Im4iOiJDVFBDbGFzc2lmaWNhdGlvbiIsInZhbHMiOlt7InZhbHVlIjoiQ1RQX05UIn1dfV19LCJTdWJqZWN0TGFiZWxzIjpbXSwiVE1DVmVyc2lvbiI6IjE3LjEwLjE4MDQuNDkiLCJUcnVzdGVkTGFiZWxIYXNoIjoiSmVnc2Y1S0Q5SG82WGhxT2xOajhGNEFuYnZOVVpYaTIwb3BoMG5EM29sc1VYeis4UktcL001VFVDajBidjlURWYifQ== x-ctpclassification: CTP_NT x-originating-ip: [172.30.20.206] MIME-Version: 1.0 Content-Language: en-US Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Reviewed-by: Chasel Chiu > -----Original Message----- > From: Agyeman, Prince > Sent: Tuesday, May 21, 2019 11:08 AM > To: devel@edk2.groups.io > Cc: Chiu, Chasel ; Agyeman, Prince > > Subject: [edk2-platforms] [PATCH v2 5/5] Intel/Readme.md: Updated readme > with linux build instructions >=20 > From: Prince Agyeman >=20 > Signed-off-by: Prince Agyeman > --- > Platform/Intel/Readme.md | 42 ++++++++++++++++++++++++------------------ > 1 file changed, 24 insertions(+), 18 deletions(-) >=20 > diff --git a/Platform/Intel/Readme.md b/Platform/Intel/Readme.md index > 1da5d0a..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 > +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 > +edk2-platforms/Platform/Intel 4. Type "python build_bios.py -p > +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`` > [cross-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 > + 16.04.5 LTS > + * See [cross-platform limitations](#Known-limitations) >=20 > * Configuration Files > - * ``The edk2-platforms\Platform\Intel\build.cfg file contains the defa= ult > 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-platforms\Platform\Intel\build.cfg settings`` > - * ``An example of a board specific settings:`` > - * > ``edk2-platforms\Platform\Intel\KabylakeOpenBoardPkg\KabylakeRvp3\build_ > config.cfg`` > + * The edk2-platforms\Platform\Intel\build.cfg file contains the > + 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 > + edk2-platforms\Platform\Intel\build.cfg settings > + * An example of a board specific settings: > + * > + > 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
> configuration below.
> -  * Cross-platform build support is work-in-progress.
> -
>  **KabylakeOpenBoardPkg**
>  1. This firmware project has only been tested on the Intel KabylakeRvp3 =
board.
>  2. This firmware project has only been tested booting to Microsoft Windo=
ws 10
> x64 with AHCI mode and Integrated Graphic
>    Device.
> -3. This firmware project build has only been tested using the Microsoft =
Visual
> Studio 2015 compiler.
> +3. The Windows build was tested on Windows 10 with Microsoft Visual Stud=
io
> 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
> highest area of the flash re
>=20
>  **ClevoOpenBoardPkg**
>  1. Currently, support is only being added for the N1xxWU series of board=
s.
> -2. The firmware project build has only been tested using the Microsoft V=
isual
> Studio 2015 compiler.
> -3. The firmware project has not been tested on an actual board, it *shou=
ld not*
> be expected to boot.
> -4. The firmware project applies to all Clevo supported board configurati=
ons but
> is only being tested on System 76 Galago
> +2. The Windows build was tested on Windows 10 with Microsoft Visual Stud=
io
> 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 *shou=
ld not*
> be expected to boot.
> +6. The firmware project applies to all Clevo supported board
> +configurations but is only being tested on System 76 Galago
>    Pro devices.
>=20
>  ### **Planned Activities**
> --
> 2.7.4