From nobody Fri May 3 15:33:53 2024 Delivered-To: importer@patchew.org Received-SPF: none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) client-ip=198.145.21.10; envelope-from=edk2-devel-bounces@lists.01.org; helo=ml01.01.org; Authentication-Results: mx.zoho.com; spf=none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) smtp.mailfrom=edk2-devel-bounces@lists.01.org; Return-Path: Received: from ml01.01.org (ml01.01.org [198.145.21.10]) by mx.zohomail.com with SMTPS id 1497296278659181.73703606369963; Mon, 12 Jun 2017 12:37:58 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id 5BD9221AE30D0; Mon, 12 Jun 2017 12:36:43 -0700 (PDT) Received: from foss.arm.com (foss.arm.com [217.140.101.70]) by ml01.01.org (Postfix) with ESMTP id 0C1AC21BB253A for ; Mon, 12 Jun 2017 12:36:43 -0700 (PDT) Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.72.51.249]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id C2A9C344; Mon, 12 Jun 2017 12:37:56 -0700 (PDT) Received: from u201365.usa.Arm.com (bc-c3-3-14.eu.iaas.arm.com [10.6.43.238]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id B761D3F581; Mon, 12 Jun 2017 12:37:55 -0700 (PDT) X-Original-To: edk2-devel@lists.01.org From: Supreeth Venkatesh To: edk2-devel@lists.01.org Date: Mon, 12 Jun 2017 20:37:31 +0100 Message-Id: <1497296252-46672-2-git-send-email-supreeth.venkatesh@arm.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1497296252-46672-1-git-send-email-supreeth.venkatesh@arm.com> References: <1497296252-46672-1-git-send-email-supreeth.venkatesh@arm.com> Subject: [edk2] [PATCH 1/2] MdePkg: Initial Version of MM Communication Protocol. X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: michael.d.kinney@intel.com, liming.gao@intel.com, leif.lindholm@linaro.org MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Errors-To: edk2-devel-bounces@lists.01.org Sender: "edk2-devel" X-ZohoMail: RSF_4 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" This patch adds initial version of MM Communication Protocol as defined in PI v1.5 Specification Volume 4. Also, It includes MM Communication Protocol in MdePkg dec file. Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Supreeth Venkatesh --- MdePkg/Include/Protocol/MmCommunication.h | 75 +++++++++++++++++++++++++++= ++++ MdePkg/MdePkg.dec | 3 ++ 2 files changed, 78 insertions(+) create mode 100644 MdePkg/Include/Protocol/MmCommunication.h diff --git a/MdePkg/Include/Protocol/MmCommunication.h b/MdePkg/Include/Pro= tocol/MmCommunication.h new file mode 100644 index 0000000..ea3ba10 --- /dev/null +++ b/MdePkg/Include/Protocol/MmCommunication.h @@ -0,0 +1,75 @@ +/** @file + EFI MM Communication Protocol as defined in the PI 1.5 specification. + + This protocol provides a means of communicating between drivers outside = of MM and MMI + handlers inside of MM. + + Copyright (c) 2016 - 2017, ARM Limited. All rights reserved. + + This program and the accompanying materials + are licensed and made available under the terms and conditions of the BS= D License + which accompanies this distribution. The full text of the license may b= e 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 IMP= LIED. + +**/ + +#ifndef _MM_COMMUNICATION_H_ +#define _MM_COMMUNICATION_H_ + +// +// Need include this header file for EFI_MM_COMMUNICATE_HEADER data struct= ure. +// +#include + +#define EFI_MM_COMMUNICATION_PROTOCOL_GUID \ + { \ + 0xc68ed8e2, 0x9dc6, 0x4cbd, { 0x9d, 0x94, 0xdb, 0x65, 0xac, 0xc5, 0xc3= , 0x32 } \ + } + +typedef struct _EFI_MM_COMMUNICATION_PROTOCOL EFI_MM_COMMUNICATION_PROTOC= OL; + +/** + Communicates with a registered handler. + + This function provides a service to send and receive messages to the + MM environment from a registered UEFI service. This function is part + of the MM Communication Protocol that may be called in physical mode pri= or to + SetVirtualAddressMap() and in virtual mode after SetVirtualAddressMap(). + + @param[in] This The EFI_MM_COMMUNICATION_PROTOCOL in= stance. + @param[in, out] CommBuffer A pointer to the buffer to convey in= to MMRAM. + @param[in, out] CommSize The size of the data buffer being pa= ssed in.On exit, the size of data + being returned. Zero if the handler = does not wish to reply with any data. This + parameter is optional and may be NU= LL. + + @retval EFI_SUCCESS The message was successfully posted. + @retval EFI_INVALID_PARAMETER The CommBuffer was NULL. + @retval EFI_BAD_BUFFER_SIZE The buffer is too large for the MM i= mplementation. If this error is + returned, the MessageLength field in= the CommBuffer header or the integer + pointed by CommSize are updated to r= eflect the maximum payload size the + implementation can accommodate. + @retval EFI_ACCESS_DENIED The CommunicateBuffer parameter or C= ommSize parameter, if not omitted, + are in address range that cannot be = accessed by the MM environment +**/ +typedef +EFI_STATUS +(EFIAPI *EFI_MM_COMMUNICATE)( + IN CONST EFI_MM_COMMUNICATION_PROTOCOL *This, + IN OUT VOID *CommBuffer, + IN OUT UINTN *CommSize OPTIONAL + ); + +// +// EFI MM Communication Protocol provides runtime services for communicati= ng +// between DXE drivers and a registered MMI/SMI handler. +// +struct _EFI_MM_COMMUNICATION_PROTOCOL { + EFI_MM_COMMUNICATE Communicate; +}; + +extern EFI_GUID gEfiMmCommunicationProtocolGuid; + +#endif diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec index 7a7504b..149783b 100644 --- a/MdePkg/MdePkg.dec +++ b/MdePkg/MdePkg.dec @@ -1050,6 +1050,9 @@ ## Include/Protocol/SmmCommunication.h gEfiSmmCommunicationProtocolGuid =3D { 0xc68ed8e2, 0x9dc6, 0x4cbd, { 0x= 9d, 0x94, 0xdb, 0x65, 0xac, 0xc5, 0xc3, 0x32 }} =20 + ## Include/Protocol/MmCommunication.h + gEfiMmCommunicationProtocolGuid =3D { 0xc68ed8e2, 0x9dc6, 0x4cbd, { 0x9= d, 0x94, 0xdb, 0x65, 0xac, 0xc5, 0xc3, 0x32 }} + ## Include/Protocol/SmmStatusCode.h gEfiSmmStatusCodeProtocolGuid =3D { 0x6afd2b77, 0x98c1, 0x4acd, { 0xa6= , 0xf9, 0x8a, 0x94, 0x39, 0xde, 0xf, 0xb1}} =20 --=20 2.7.4 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel From nobody Fri May 3 15:33:53 2024 Delivered-To: importer@patchew.org Received-SPF: none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) client-ip=198.145.21.10; envelope-from=edk2-devel-bounces@lists.01.org; helo=ml01.01.org; Authentication-Results: mx.zoho.com; spf=none (zoho.com: 198.145.21.10 is neither permitted nor denied by domain of lists.01.org) smtp.mailfrom=edk2-devel-bounces@lists.01.org; Return-Path: Received: from ml01.01.org (ml01.01.org [198.145.21.10]) by mx.zohomail.com with SMTPS id 1497296283666198.16351106671846; Mon, 12 Jun 2017 12:38:03 -0700 (PDT) Received: from [127.0.0.1] (localhost [IPv6:::1]) by ml01.01.org (Postfix) with ESMTP id 9D8622095A323; Mon, 12 Jun 2017 12:36:48 -0700 (PDT) Received: from foss.arm.com (foss.arm.com [217.140.101.70]) by ml01.01.org (Postfix) with ESMTP id A0D6321BB253A for ; Mon, 12 Jun 2017 12:36:47 -0700 (PDT) Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.72.51.249]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 57A0C344; Mon, 12 Jun 2017 12:38:01 -0700 (PDT) Received: from u201365.usa.Arm.com (bc-c3-3-14.eu.iaas.arm.com [10.6.43.238]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 4B6F33F581; Mon, 12 Jun 2017 12:38:00 -0700 (PDT) X-Original-To: edk2-devel@lists.01.org From: Supreeth Venkatesh To: edk2-devel@lists.01.org Date: Mon, 12 Jun 2017 20:37:32 +0100 Message-Id: <1497296252-46672-3-git-send-email-supreeth.venkatesh@arm.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1497296252-46672-1-git-send-email-supreeth.venkatesh@arm.com> References: <1497296252-46672-1-git-send-email-supreeth.venkatesh@arm.com> Subject: [edk2] [PATCH 2/2] MdePkg: Maintain backwards compatibility between MM/SMM. X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: michael.d.kinney@intel.com, liming.gao@intel.com, leif.lindholm@linaro.org MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Errors-To: edk2-devel-bounces@lists.01.org Sender: "edk2-devel" X-ZohoMail: RSF_4 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" PI v1.5 Volume 4 replaces EFI_SMM_COMMUNICATION_PROTOCOL with EFI_MM_COMMUNICATION_PROTOCOL. Hence, modify the SMM Communication protocol header file to include the EFI_MM_COMMUNICATION_PROTOCOL header. Also, PI v1.5 Volume 4 replaces the data structure EFI_SMM_COMMUNICATE_HEADER with EFI_MM_COMMUNICATE_HEADER. Hence, modify UefiAcpiDataTable header file to maintain backwards compatibility. Contributed-under: TianoCore Contribution Agreement 1.0 Signed-off-by: Supreeth Venkatesh --- MdePkg/Include/Protocol/SmmCommunication.h | 52 +++++++-------------------= ---- MdePkg/Include/Uefi/UefiAcpiDataTable.h | 4 ++- 2 files changed, 15 insertions(+), 41 deletions(-) diff --git a/MdePkg/Include/Protocol/SmmCommunication.h b/MdePkg/Include/Pr= otocol/SmmCommunication.h index c284e55..8edebc2 100644 --- a/MdePkg/Include/Protocol/SmmCommunication.h +++ b/MdePkg/Include/Protocol/SmmCommunication.h @@ -5,10 +5,12 @@ handlers inside of SMM. =20 =20 Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.
- This program and the accompanying materials =20 - are licensed and made available under the terms and conditions of the BS= D License =20 - which accompanies this distribution. The full text of the license may b= e found at =20 - http://opensource.org/licenses/bsd-license.php = =20 + Copyright (c) 2016 - 2017, ARM Limited. All rights reserved.
+ + This program and the accompanying materials + are licensed and made available under the terms and conditions of the BS= D License + which accompanies this distribution. The full text of the license may b= e found at + http://opensource.org/licenses/bsd-license.php =20 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, = =20 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMP= LIED. =20 @@ -19,45 +21,15 @@ #define _SMM_COMMUNICATION_H_ =20 // -// Need include this header file for EFI_SMM_COMMUNICATE_HEADER data struc= ture. +// Include the EFI_MM_COMMUNICATION_PROTOCOL header for actual definitions= . This +// header is used to maintain backwards compatibility. // -#include - -#define EFI_SMM_COMMUNICATION_PROTOCOL_GUID \ - { \ - 0xc68ed8e2, 0x9dc6, 0x4cbd, { 0x9d, 0x94, 0xdb, 0x65, 0xac, 0xc5, 0xc3= , 0x32 } \ - } - -typedef struct _EFI_SMM_COMMUNICATION_PROTOCOL EFI_SMM_COMMUNICATION_PROT= OCOL; +#include =20 -/** - Communicates with a registered handler. - =20 - This function provides a service to send and receive messages from a reg= istered UEFI service. - - @param[in] This The EFI_SMM_COMMUNICATION_PROTOCOL instan= ce. - @param[in] CommBuffer A pointer to the buffer to convey into SM= RAM. - @param[in] CommSize The size of the data buffer being passed = in.On exit, the size of data - being returned. Zero if the handler does = not wish to reply with any data. - - @retval EFI_SUCCESS The message was successfully posted. - @retval EFI_INVALID_PARAMETER The CommBuffer was NULL. -**/ -typedef -EFI_STATUS -(EFIAPI *EFI_SMM_COMMUNICATE2)( - IN CONST EFI_SMM_COMMUNICATION_PROTOCOL *This, - IN OUT VOID *CommBuffer, - IN OUT UINTN *CommSize - ); +#define EFI_SMM_COMMUNICATION_PROTOCOL_GUID EFI_MM_COMMUNICATION_PROTOCOL_= GUID =20 -/// -/// EFI SMM Communication Protocol provides runtime services for communica= ting -/// between DXE drivers and a registered SMI handler. -/// -struct _EFI_SMM_COMMUNICATION_PROTOCOL { - EFI_SMM_COMMUNICATE2 Communicate; -}; +typedef EFI_MM_COMMUNICATION_PROTOCOL EFI_SMM_COMMUNICATION_PROTOCOL; +typedef EFI_MM_COMMUNICATE EFI_SMM_COMMUNICATE2; =20 extern EFI_GUID gEfiSmmCommunicationProtocolGuid; =20 diff --git a/MdePkg/Include/Uefi/UefiAcpiDataTable.h b/MdePkg/Include/Uefi/= UefiAcpiDataTable.h index 957721f..f0043a3 100644 --- a/MdePkg/Include/Uefi/UefiAcpiDataTable.h +++ b/MdePkg/Include/Uefi/UefiAcpiDataTable.h @@ -52,7 +52,9 @@ typedef struct { /// Designates an array of bytes that is MessageLength in size. /// UINT8 Data[1]; -} EFI_SMM_COMMUNICATE_HEADER; +} EFI_MM_COMMUNICATE_HEADER; + +typedef EFI_MM_COMMUNICATE_HEADER EFI_SMM_COMMUNICATE_HEADER; =20 #pragma pack() =20 --=20 2.7.4 _______________________________________________ edk2-devel mailing list edk2-devel@lists.01.org https://lists.01.org/mailman/listinfo/edk2-devel