Re: [edk2-platforms][PATCH V1 1/1] Platform/Intel/Readme.md: Content update


Chiu, Chasel
 

Reviewed-by: Chasel Chiu <chasel.chiu@...>

-----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.chaganty@...>; Chiu, Chasel
<chasel.chiu@...>; Gao, Liming <liming.gao@...>; Desimone,
Nathaniel L <@natedesimone>; Kinney, Michael D
<michael.d.kinney@...>; Sinha, Ankit <ankit.sinha@...>
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.chaganty@...>
Cc: Chasel Chiu <chasel.chiu@...>
Cc: Liming Gao <liming.gao@...>
Cc: Nate DeSimone <@natedesimone>
Cc: Michael D Kinney <michael.d.kinney@...>
Cc: Ankit Sinha <ankit.sinha@...>
Signed-off-by: Michael Kubacki <michael.a.kubacki@...>
---
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&reg; 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


Join devel@edk2.groups.io to automatically receive all group messages.