From b59768ca63b215552c2af7261fd57be5d884bbb8 Mon Sep 17 00:00:00 2001 From: jchen20 Date: Thu, 9 Jul 2009 09:17:18 +0000 Subject: [PATCH] Add definition on SmmStatusCodeProtocol to comply the SMMCIS spec to fix the bug #202466 git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@8834 6f19259b-4bc3-4df7-8a09-765794883524 --- IntelFrameworkPkg/Include/Framework/Hob.h | 2 + IntelFrameworkPkg/Include/Framework/PeiCis.h | 4 +- .../Include/Protocol/SmmStatusCode.h | 83 +++++++++++++++++++ IntelFrameworkPkg/IntelFrameworkPkg.dec | 3 + 4 files changed, 90 insertions(+), 2 deletions(-) create mode 100644 IntelFrameworkPkg/Include/Protocol/SmmStatusCode.h diff --git a/IntelFrameworkPkg/Include/Framework/Hob.h b/IntelFrameworkPkg/Include/Framework/Hob.h index b26cb4ea28..c8e9914a7e 100644 --- a/IntelFrameworkPkg/Include/Framework/Hob.h +++ b/IntelFrameworkPkg/Include/Framework/Hob.h @@ -24,6 +24,8 @@ /// /// Capsule volume HOB -- identical to a firmware volume +/// This macro is defined to comply with hob Framework Spec. And the marco has been +/// retired in PI1.0 spec. /// #define EFI_HOB_TYPE_CV 0x0008 diff --git a/IntelFrameworkPkg/Include/Framework/PeiCis.h b/IntelFrameworkPkg/Include/Framework/PeiCis.h index 629800569f..5dc2f9c529 100644 --- a/IntelFrameworkPkg/Include/Framework/PeiCis.h +++ b/IntelFrameworkPkg/Include/Framework/PeiCis.h @@ -180,9 +180,9 @@ struct _FRAMEWORK_EFI_PEI_SERVICES { EFI_PEI_RESET_SYSTEM ResetSystem; /// /// Inconsistent with specification here: - /// In Framework Spec, PeiCis0.91, CpuIo and PciCfg is NOT pointers. it should be - /// a typo error in spec.. + /// In Framework Spec, PeiCis0.91, CpuIo and PciCfg is NOT pointers. /// + // // I/O Abstractions // diff --git a/IntelFrameworkPkg/Include/Protocol/SmmStatusCode.h b/IntelFrameworkPkg/Include/Protocol/SmmStatusCode.h new file mode 100644 index 0000000000..c2b9e70ddc --- /dev/null +++ b/IntelFrameworkPkg/Include/Protocol/SmmStatusCode.h @@ -0,0 +1,83 @@ +/** @file + Provides the parent dispatch service for a given SMI source generator. + The EFI_SMM_ICHN_DISPATCH_PROTOCOL provides the ability to install child handlers for + the given event types. + + Copyright (c) 2008 - 2009, Intel Corporation + All rights reserved. This program and the accompanying materials + are licensed and made available under the terms and conditions of the BSD License + which accompanies this distribution. The full text of the license may be found at + http://opensource.org/licenses/bsd-license.php + + THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, + WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. + + Module Name: SmmStatusCode.h + + @par Revision Reference: + This Protocol is defined in Framework of EFI SMM Core Interface Spec + Version 0.9. + +**/ + +#ifndef _EFI_SMM_ICHN_DISPATCH_H_ +#define _EFI_SMM_ICHN_DISPATCH_H_ + +#include +#include + +// +// Global ID for the Smm Status code Protocol +// +#define EFI_SMM_STATUS_CODE_PROTOCOL_GUID \ + { \ + 0x6afd2b77, 0x98c1, 0x4acd, {0xa6, 0xf9, 0x8a, 0x94, 0x39, 0xde, 0xf, 0xb1 } \ + } + +typedef struct _EFI_SMM_STATUS_CODE_PROTOCOL EFI_SMM_STATUS_CODE_PROTOCOL; + + +/** + Unregister a child SMI source dispatch function with a parent SMM driver + + @param This Points to this instance of the EFI_SMM_STATUS_CODE_PROTOCOL. + @param CodeType Indicates the type of status code being reported. + @param Value Describes the current status of a hardware or software entity. + This status includes information about the class and subclass + that is used to classify the entity, as well as an operation. + For progress codes, the operation is the current activity. For + error codes, it is the exception. For debug codes, it is not defined + at this time. + @param Instance The enumeration of a hardware or software entity within the system. + A system may contain multiple entities that match a class/subclass pairing. + @param CallerId This optional parameter may be used to identify the caller. This parameter + allows the status code driver to apply different rules to different callers. + @param Data This optional parameter may be used to pass additional data. + + + @retval EFI_SUCCESS The function completed successfully. + @retval EFI_DEVICE_ERROR The function should not be completed due to a device error. + +**/ +typedef +EFI_STATUS +(EFIAPI *EFI_SMM_REPORT_STATUS_CODE) ( + IN EFI_SMM_STATUS_CODE_PROTOCOL *This, + IN EFI_STATUS_CODE_TYPE CodeType, + IN EFI_STATUS_CODE_VALUE Value, + IN UINT32 Instance, + IN EFI_GUID *CallerId, + IN EFI_STATUS_CODE_DATA *Data OPTIONAL +); + + +/** + The EFI_SMM_STATUS_CODE_PROTOCOL provides the basic status code services while in SMRAM. + **/ +struct _EFI_SMM_STATUS_CODE_PROTOCOL { + EFI_SMM_REPORT_STATUS_CODE ReportStatusCode; ///< Allows for the SMM agent to produce a status code output. +}; + +extern EFI_GUID gEfiSmmStatusCodeProtocolGuid; + +#endif diff --git a/IntelFrameworkPkg/IntelFrameworkPkg.dec b/IntelFrameworkPkg/IntelFrameworkPkg.dec index 65e497ff2f..33305d275a 100644 --- a/IntelFrameworkPkg/IntelFrameworkPkg.dec +++ b/IntelFrameworkPkg/IntelFrameworkPkg.dec @@ -154,6 +154,9 @@ ## Include/Protocol/SmmIchnDispatch.h gEfiSmmIchnDispatchProtocolGuid = { 0xc50b323e, 0x9075, 0x4f2a, { 0xac, 0x8e, 0xd2, 0x59, 0x6a, 0x10, 0x85, 0xcc }} + ## Include/Protocol/SmmStatusCode.h + gEfiSmmStatusCodeProtocolGuid = { 0x6afd2b77, 0x98c1, 0x4acd, {0xa6, 0xf9, 0x8a, 0x94, 0x39, 0xde, 0xf, 0xb1 }} + ## Include/Protocol/FrameworkFormCallback.h gEfiFormCallbackProtocolGuid = { 0xF3E4543D, 0xCF35, 0x6CEF, { 0x35, 0xC4, 0x4F, 0xE6, 0x34, 0x4D, 0xFC, 0x54 }} -- 2.39.2