Reviewed-by: Chasel Chiu <chasel.c...@intel.com>
> -----Original Message----- > From: devel@edk2.groups.io [mailto:devel@edk2.groups.io] On Behalf Of > Kubacki, Michael A > Sent: Tuesday, August 20, 2019 10:03 AM > To: devel@edk2.groups.io > Cc: Chaganty, Rangasai V <rangasai.v.chaga...@intel.com>; Chiu, Chasel > <chasel.c...@intel.com>; Gao, Liming <liming....@intel.com>; Desimone, > Nathaniel L <nathaniel.l.desim...@intel.com>; Kinney, Michael D > <michael.d.kin...@intel.com>; Sinha, Ankit <ankit.si...@intel.com> > Subject: [edk2-devel] [edk2-platforms][PATCH V1 1/1] > Platform/Intel/Readme.md: Content update > > This change makes the following updates: > 1. Indicate that build via batch scripts is no longer allowed. > 2. Remove ClevoOpenBoardPkg batch build instructions since > the batch build scripts no longer exist in the package. > 3. Move firmware image flashing instructions to a clearly labeled > section. > 4. Elaborate the firmware image flashing instructions. > > Cc: Sai Chaganty <rangasai.v.chaga...@intel.com> > Cc: Chasel Chiu <chasel.c...@intel.com> > Cc: Liming Gao <liming....@intel.com> > Cc: Nate DeSimone <nathaniel.l.desim...@intel.com> > Cc: Michael D Kinney <michael.d.kin...@intel.com> > Cc: Ankit Sinha <ankit.si...@intel.com> > Signed-off-by: Michael Kubacki <michael.a.kuba...@intel.com> > --- > Platform/Intel/Readme.md | 28 ++++++++++---------- > 1 file changed, 14 insertions(+), 14 deletions(-) > > diff --git a/Platform/Intel/Readme.md b/Platform/Intel/Readme.md index > aaf6ef4d3e..3caf362983 100644 > --- a/Platform/Intel/Readme.md > +++ b/Platform/Intel/Readme.md > @@ -1,4 +1,4 @@ > -# **EDK II Minimum Platform Firmware for Intel(R) Platforms** > +# **EDK II Minimum Platform Firmware for Intel® Platforms** > > The Minimum Platform is a software architecture that guides uniform delivery > of Intel platforms enabling firmware solutions for basic boot functionality > with extensibility built-in. Please see the @@ -200,7 +200,8 @@ return back to > the minimum platform caller. > </pre> > > **Building with the batch scripts** > -KabylakeOpenBoardPkg does not support batch scripts, please use > build_bios.py. > +Only PurleyOpenBoardPkg still supports batch script build. Future board > +packages must only use the Python build infrastructure. > > For PurleyOpenBoardPkg > 1. Open command window, go to the workspace directory, e.g. c:\Purley. > @@ -214,18 +215,6 @@ For PurleyOpenBoardPkg The validated version of > iasl compiler that can build MinPurley is 20180629. Older version may generate > ACPI build errors. > > -For ClevoOpenBoardPkg > -1. Open command window, go to the workspace directory, e.g. c:\Clevo. > -2. Type "cd edk2-platforms\Platform\Intel\ClevoOpenBoardPkg\N1xxWU". > -3. Type "GitEdk2Clevo.bat" to setup GIT environment. > -4. Type "bld" to build Clevo UEFI firmware image, "bld release" for release > build, "bld clean" to remove intermediate -files. > - > -Users with access to the Intel proprietary FITC tool and ME ingredients can > build full images for flash (BIOS + ME + -DESC). > - > -Users can also flash the UEFI firmware image to the highest area of the flash > region directly. > - > ### **Known limitations** > > **ClevoOpenBoardPkg** > @@ -258,6 +247,17 @@ Users can also flash the UEFI firmware image to the > highest area of the flash re 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. > > +### **Firmware Image Flashing** > + > +The full Intel firmware image on a flash device is called the > +Integrated Firmware Image (IFWI). Users with access to the Intel proprietary > FITC tool and ME ingredients can build full IFWI images that may be flashed > (Descriptor, UEFI FW, ME FW, etc.). > + > +Users without such access can directly flash a custom built UEFI FW image > over the highest area of the flash region directly. > +It is always recommended to have a hardware flash programmer accessible > +to recover the firmware image. The original full flash image should > +always be backed up so it may be flashed again for recovery. Please be > +aware that if a system supports a technology that authenticates the initial > firmware boot image such as Boot Guard, it will fail to boot with a custom > firmware image that is not signed properly. > + > ### **Planned Activities** > * Replace the batch build scripts with cross-platform Python build scripts. > * Publish a Minimum Platform specification to describe the architecture and > interfaces in more detail. > -- > 2.16.2.windows.1 > > > -=-=-=-=-=-=-=-=-=-=-=- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#46073): https://edk2.groups.io/g/devel/message/46073 Mute This Topic: https://groups.io/mt/32963085/21656 Group Owner: devel+ow...@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [arch...@mail-archive.com] -=-=-=-=-=-=-=-=-=-=-=-