From c040831cf95e05d2c5f2d87a5f435ed63cb7f7a3 Mon Sep 17 00:00:00 2001 From: Michael Kubacki Date: Mon, 29 Jun 2020 15:54:01 -0700 Subject: PrmPkg: Add PlatformGuid Adds a "platform GUID" field to the PRM ACPI table. This field is used by a platform to uniquely identify itself such that it can be targeted by runtime PRM module updates for that platform. Platforms using PRM are currently required to set a unique value for gPrmPkgTokenSpaceGuid.PcdPrmPlatformGuid in their platform DSC. Cc: Andrew Fish Cc: Kang Gao Cc: Michael D Kinney Cc: Michael Kubacki Cc: Leif Lindholm Cc: Benjamin You Cc: Liu Yun Cc: Ankit Sinha Cc: Nate DeSimone Signed-off-by: Michael Kubacki Acked-by: Michael D Kinney Acked-by: Liming Gao Acked-by: Leif Lindholm Reviewed-by: Ankit Sinha --- PrmPkg/Readme.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) (limited to 'PrmPkg/Readme.md') diff --git a/PrmPkg/Readme.md b/PrmPkg/Readme.md index 2a8a40c924..40df8f00a0 100644 --- a/PrmPkg/Readme.md +++ b/PrmPkg/Readme.md @@ -74,6 +74,18 @@ The following list are the currently defined build flags (if any) that may be pa This structure is passed as the context buffer to PRM handlers. The structure actually passed to PRM handlers is allocated and populated by the OS where it gets all the information to populate the context buffer from other structures. +### PRM Platform GUID +**IMPORTANT** + +A configuration item that requires user attention is the PRM platform GUID. Each platform that uses PRM must be +uniquely identifiable so that various instances of a PRM module can target the correct platform in PRM module updates. + +To apply a unique platform GUID set the following PCD to a unique value in your platform DSC file. + ``gPrmPkgTokenSpaceGuid.PcdPrmPlatformGuid`` + +The default value assigned in [PrmPkg.dec](PrmPkg/PrmPkg.dec) is zero. By design, this is an invalid value that will +cause an ASSERT if it is not updated. + ## Overview At a high-level, PRM can be viewed from three levels of granularity: -- cgit v1.2.3