From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pl1-f171.google.com (mail-pl1-f171.google.com [209.85.214.171]) by mx.groups.io with SMTP id smtpd.web10.35295.1629176927881631247 for ; Mon, 16 Aug 2021 22:08:47 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@gmail.com header.s=20161025 header.b=aX10Ddl2; spf=pass (domain: gmail.com, ip: 209.85.214.171, mailfrom: kuqin12@gmail.com) Received: by mail-pl1-f171.google.com with SMTP id a5so23456647plh.5 for ; Mon, 16 Aug 2021 22:08:47 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=h6SAlxGwYkOLOo8JuGOH5i3ObxdpjTvUI4/tsCapVto=; b=aX10Ddl2k45ceL7XtOuL2X5tLOpe86lU45gAKzo05qwV3TZzdQOpBWXNCEs7NSSpNM r/boUXkn/0v97E1fSNPn8AonY2PnV3V5LfYXJnmHQFkXnfDSMigfjmBqhLDMrcHjDHN2 kqTSgFkVAWF4rGRsYWPmQJ6GPxGwRMkIQbDFX2/QgMav1oG1Vl0jMP5s3ngi/cSme8mQ yinTSb+3QxwBQxwSDNGLQwzZMUR9eX6uDQJJX7d+P0RZ4qsx2IOa3ud1qN1GRA28esRX /8z3Twkl3Eawa29Or5NB58KrcktutWLZkO5qEb3jTXLUqYWECbJpax5Ug6jwjs2O53kt 0asg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=h6SAlxGwYkOLOo8JuGOH5i3ObxdpjTvUI4/tsCapVto=; b=sAMxb07/7ysMs7v+H/o4KVoV9asPUdOg86d70Pclo5GprE1PqwxSj0DPHeLo+POj3K Etkd1gzOOOwO8m0dazxCSTqUF7aBCi7pnYajWHsoBCo5rZZQrukkc481J6zLtAovsLIP ksj03a5Yezd2tWQjTzobHY+5qvDnKwXNpUKh2DdSHXRTE3eQ90fD1IlZdtO7atxSdh/x n+MN+4DHlHkINs7Ep88YWnNQYOtC9oFXbZ6xPDmD6Ll5PkuCh3MDmxGBZ7O3vioDazeW O8ct8osAatfVKJfRa/Rtn+KoEHIddYHoXtJsdDQ1ePWWvCMrBfuLMcsd1N/RmOcTdbE9 2mSA== X-Gm-Message-State: AOAM530fo4SmU0B9bS8WOTHZt8ue1z8S9dltYVxRWuwM3PoYRVfDtP87 RT3wSjiVdFaGbp9eSA1u0CaO9a72lldCzw== X-Google-Smtp-Source: ABdhPJyNuolI6BExlL7gA4F3tTo9MIg6pZ4bdvf+vhtzji5CCbRlyGxMIJVls3yNScRSkq3BoGJbyg== X-Received: by 2002:a17:902:a705:b029:12b:71be:d24e with SMTP id w5-20020a170902a705b029012b71bed24emr1501601plq.29.1629176927269; Mon, 16 Aug 2021 22:08:47 -0700 (PDT) Return-Path: Received: from localhost.localdomain ([50.35.88.161]) by smtp.gmail.com with ESMTPSA id i5sm737965pjk.47.2021.08.16.22.08.46 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 16 Aug 2021 22:08:46 -0700 (PDT) From: "Kun Qin" To: devel@edk2.groups.io Cc: Michael D Kinney , Liming Gao , Zhiguang Liu , Hao A Wu , =?UTF-8?q?Marvin=20H=C3=A4user?= , Bret Barkelew , Michael Kubacki Subject: [PATCH v3 3/7] MdePkg: MmCommunication: Introduce EFI_MM_COMMUNICATION3_PROTOCOL to MdePkg Date: Mon, 16 Aug 2021 22:08:03 -0700 Message-Id: <20210817050807.766-4-kuqin12@gmail.com> X-Mailer: git-send-email 2.32.0.windows.1 In-Reply-To: <20210817050807.766-1-kuqin12@gmail.com> References: <20210817050807.766-1-kuqin12@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3398 REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3430 This change introduces a new definition for MM communicate protocol v3. This protocol will be installed under a new GUID in contrast to exisiting EFI_MM_COMMUNICATION_PROTOCOL. Data communicated to MM through EFI_MM_COMMUNICATION3_PROTOCOL should always start with EFI_MM_COMMUNICATE_HEADER_V3 with its HeaderGuid, Signature and Version fields properly populated. Cc: Michael D Kinney Cc: Liming Gao Cc: Zhiguang Liu Cc: Hao A Wu Cc: Marvin Häuser Cc: Bret Barkelew Cc: Michael Kubacki Signed-off-by: Kun Qin --- Notes: v3: - Newly introduced v3 of communicate protocol MdePkg/Include/Protocol/MmCommunication3.h | 70 ++++++++++++++++++++ MdePkg/MdePkg.dec | 3 + 2 files changed, 73 insertions(+) diff --git a/MdePkg/Include/Protocol/MmCommunication3.h b/MdePkg/Include/Protocol/MmCommunication3.h new file mode 100644 index 000000000000..1dfebbdddb5e --- /dev/null +++ b/MdePkg/Include/Protocol/MmCommunication3.h @@ -0,0 +1,70 @@ +/** @file + EFI MM Communication Protocol 2 as defined in the PI 1.7 errata A specification. + + This protocol provides a means of communicating between drivers outside of MM and MMI + handlers inside of MM. + + Copyright (c) 2017, Intel Corporation. All rights reserved.
+ Copyright (c) 2019, Arm Limited. All rights reserved.
+ SPDX-License-Identifier: BSD-2-Clause-Patent + +**/ + +#ifndef MM_COMMUNICATION3_H_ +#define MM_COMMUNICATION3_H_ + +#include + +#define EFI_MM_COMMUNICATION3_PROTOCOL_GUID \ + { \ + 0xf7234a14, 0xdf2, 0x46c0, { 0xad, 0x28, 0x90, 0xe6, 0xb8, 0x83, 0xa7, 0x2f } \ + } + +typedef struct _EFI_MM_COMMUNICATION3_PROTOCOL EFI_MM_COMMUNICATION3_PROTOCOL; + +/** + Communicates with a registered handler. + + This function provides a service to send and receive messages from a registered UEFI service. + + @param[in] This The EFI_MM_COMMUNICATION3_PROTOCOL instance. + @param[in, out] CommBufferPhysical Physical address of the MM communication buffer, of which content must + start with EFI_MM_COMMUNICATE_HEADER_V3. + @param[in, out] CommBufferVirtual Virtual address of the MM communication buffer, of which content must + start with EFI_MM_COMMUNICATE_HEADER_V3. + @param[in, out] 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. + This parameter is optional and may be NULL. + + @retval EFI_SUCCESS The message was successfully posted. + @retval EFI_INVALID_PARAMETER CommBufferPhysical was NULL or CommBufferVirtual was NULL. + @retval EFI_BAD_BUFFER_SIZE The buffer is too large for the MM implementation. + If this error is returned, the MessageLength field + in the CommBuffer header or the integer pointed by + CommSize, are updated to reflect the maximum payload + size the implementation can accommodate. + @retval EFI_ACCESS_DENIED The CommunicateBuffer parameter or CommSize parameter, + if not omitted, are in address range that cannot be + accessed by the MM environment. + +**/ +typedef +EFI_STATUS +(EFIAPI *EFI_MM_COMMUNICATE3)( + IN CONST EFI_MM_COMMUNICATION3_PROTOCOL *This, + IN OUT VOID *CommBufferPhysical, + IN OUT VOID *CommBufferVirtual, + IN OUT UINTN *CommSize OPTIONAL + ); + +/// +/// EFI MM Communication Protocol provides runtime services for communicating +/// between DXE drivers and a registered MMI handler. +/// +struct _EFI_MM_COMMUNICATION3_PROTOCOL { + EFI_MM_COMMUNICATE3 Communicate; +}; + +extern EFI_GUID gEfiMmCommunication3ProtocolGuid; + +#endif diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec index 411079a4343e..3168534951c1 100644 --- a/MdePkg/MdePkg.dec +++ b/MdePkg/MdePkg.dec @@ -1348,6 +1348,9 @@ [Protocols] ## Include/Protocol/MmCommunication2.h gEfiMmCommunication2ProtocolGuid = { 0x378daedc, 0xf06b, 0x4446, { 0x83, 0x14, 0x40, 0xab, 0x93, 0x3c, 0x87, 0xa3 }} + ## Include/Protocol/MmCommunication3.h + gEfiMmCommunication3ProtocolGuid = { 0xf7234a14, 0xdf2, 0x46c0, { 0xad, 0x28, 0x90, 0xe6, 0xb8, 0x83, 0xa7, 0x2f }} + # # Protocols defined in UEFI2.1/UEFI2.0/EFI1.1 # -- 2.32.0.windows.1