UEFI Platform Initialization (PI) Specification

1 UEFI Platform Initialization (PI) Specification Version Errata A April 2020 Platform Initialization Specification , Version AUEFI Forum, Inc. April 2020iiThe material contained herein is not a license, either expressly or impliedly, to any intellectual property owned or controlled by any of the authors or developers of this material or to any contribution thereto. The material contained herein is provided on an "AS IS" basis and, to the maximum extent permitted by applicable law, this information is provided AS IS AND WITH ALL FAULTS, and the authors and developers of this material hereby disclaim all other warranties and conditions, either express, implied or statutory, including, but not limited to, any (if any)

2 Implied warranties, duties or conditions of merchantability, of fitness for a particular purpose, of accuracy or completeness of responses, of results, of workmanlike effort, of lack of viruses and of lack of negligence, all with regard to this material and any contribution thereto. Designers must not rely on the absence or characteristics of any features or instructions marked "reserved" or "undefined." The Unified EFI Forum, Inc. reserves any features or instructions so marked for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them.

3 ALSO, THERE IS NO WARRANTY OR CONDITION OF TITLE, QUIET ENJOYMENT, QUIET POSSESSION, CORRESPONDENCE TO DESCRIPTION OR NON-INFRINGEMENT WITH REGARD TO THE Specification AND ANY CONTRIBUTION THERETO. IN NO EVENT WILL ANY AUTHOR OR DEVELOPER OF THIS MATERIAL OR ANY CONTRIBUTION THERETO BE LIABLE TO ANY OTHER PARTY FOR THE COST OF PROCURING SUBSTITUTE GOODS OR SERVICES, LOST PROFITS, LOSS OF USE, LOSS OF DATA, OR ANY INCIDENTAL, CONSEQUENTIAL, DIRECT, INDIRECT, OR SPECIAL DAMAGES WHETHER UNDER CONTRACT, TORT, WARRANTY, OR OTHERWISE, ARISING IN ANY WAY OUT OF THIS OR ANY OTHER AGREEMENT RELATING TO THIS DOCUMENT, WHETHER OR NOT SUCH PARTY HAD ADVANCE NOTICE OF THE POSSIBILITY OF SUCH 2020.

4 Unified Extensible Firmware Interface (UEFI) Forum, Inc. All Rights Reserved. The UEFI Forum is the owner of all rights and title in and to this work, including all copyright rights that may exist, and all rights to use and reproduce this work. Further to such rights, permission is hereby granted to any person implementing this Specification to maintain an electronic version of this work accessible by its internal personnel, and to print a copy of this Specification in hard copy form, in whole or in part, in each case solely for use by that person in connection with the implementation of this Specification , provided no modification is made to the Initialization Specification , Version AUEFI Forum, Inc.

5 April 2020iiiSpecification OrganizationThe Platform Initialization Specification is divided into volumes to enable logical organization, future growth, and printing convenience. The current volumes are as follows: volume 1: Pre-EFI Initialization Core Interface volume 2: Driver Execution Environment Core Interface volume 3: Shared Architectural Elements volume 4: Management Mode Core Interface volume 5: Standards Each volume should be viewed in relation to all other volumes, and readers are strongly encouraged to consult the entire Specification when researching areas of interest.

6 Recent versions of this Specification are issued as a single document containing all five volumes, for easier searching of the complete content. Platform Initialization Specification , Version AUEFI Forum, Inc. April 2020ivRevision HistoryRevisionMantis ID / A 1663 SmmSxDispatch2->Register() is not clear 1736 Specification of EFI_BOOT_SCRIPT_WIDTH in Save State Write 1993 Allow MM CommBuffer to be passed as a VA 2017 should have type EFI_EVENT, not (EFI_EVENT*) 2039 PI Configuration Tables Errata 2040 EFI_SECTION_FREEFORM_SUBTYPE_GUID Errata 2060 Add missing EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_PCI_ADDR ESS definition 2063 Add Index to end of PI Spec 2071 Extended cpu topologyApril 1848 PEI Core PEIM Migration Support Change 1856 SecCore/PeiCore BFV Requirement Change 1860 MM MP Protocol issues 1885 Add extended data for EFI_SW_DXE_BS_EC_BOOT_OPTION_LOAD_ERROR 1889 New Status Codes 1891 PEI delayed dispatch 1892 new pi

7 Spec revision 1955 set (*Attributes) when EFI_PEI_GET_VARIABLE2 returns EFI_BUFFER_TOO_SMALL and Attributes is non-NULL 1967 New architectural PPI for PI PEI Core FV Location 1969 Incompatible Pci Ignore Option RomJanuary Errata A 1828 Add decorator 'OPTIONAL' for Attributes parameter of EFI_PEI_GET_VARIABLE2. 1849 Issues in PI Spec Vol. 5 Ch. 18 1857 Specifies how notifications are passed from SEC to PEI. 1884 Variadic API issue in S3 save API 1907 Clarification of the EFI_MM_COMMUNICATION_PROTOCOL 1940 Clarify EFI_MM_CONFIGURATION_PROTOCOL_GUIDD ecember 1567 Layered SPI bus 1648 PI Binding for RISC-V 1746 Add an FV Extended Header entry that contains the used size of the FV 1763 MM Handler state notification protocol 1764 Add additional alignment 1768 Update the PI Spec to 1777 Update Revision History 1778 Update front matterApril 2017 Platform Initialization

8 Specification , Version AUEFI Forum, Inc. April Errata A 1587 pre permanent memory page allocation 1665 Incorrect status code for an AP calling () 1734 Outdated EFI spec reference in Save State Write 1735 Several copy & paste errors in Save State Write 1747 Clarify that MM_ACCESS_PROTOCOL should cover all MMRAM region used by the platformApril 1315 SMM Environment to Support Newer Architecture/ Platform Designs 1317 additional I2C PPI's (vol5) 1321 ARM Extensions to volume 4 1330 Add PPI to allow SEC pass HOBs into PEI 1336 Provide For Pre-DXE Initialization Of The SM Foundation 1369 Handling PEI PPI descriptor notifications from SEC 1387 Variable services errors not consistent 1390 SM stand-alone infrastructure 1396 Update SEC HOB Capabilities of 1330 with additional guidance 1413 Communicate protocol enhancements 1506 New MP protocol 1513 Need a way to propagate PEI-phase FV verification status to DXE

9 1563 Update MM PPIs to match existing implementations 1566 - update the Specification revisions 1568 Add SD/MMC GUID to DiskInfo protocol 1592 Add EFI_FV_FILETYPE_SMM_CORE_STANDALONE file type 1593 coalesce language enhancements 1594 Pei GetVaiable M1387 issue 1595 M1568 Disk Info issue 1596 M1489 GCD issue 1603 Minor erratas in Vol4 PI draft related to ECR 0001506 1607 Update MM guid def'n to match edkII impl 1626 Add new Status Code for BDS Attempting UEFI BootOrder entries 1628 Minor feedback for PI Vol 4 SMM Draft 1666 Graphics Device Info Hob4/26/16 RevisionMantis ID / DescriptionDatePlatform Initialization Specification , Version AUEFI Forum, Inc.

10 April Errata A 1574 Fix artificial limitation in the support 1565 Update status code to include AArch64 exception error codes 1564 SMM Software Dispatch Protocol Errata 1562 Errata to remove statement from DXE vol about PEI dispatch behavior 1561 Errata to provide Equivalent of DXE-CIS Mantis 247 for the PEI-CIS 1532 Allow S3 Resume without having installed permanent memory (via InstallPeiMemory) 1530 errata on dxe report status code 1529 address space granularity errata 1525 PEI Services Table Retrieval for AArch64 1515 EFI_PEIM_NOT