From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wr1-f48.google.com (mail-wr1-f48.google.com [209.85.221.48]) by mx.groups.io with SMTP id smtpd.web11.3950.1574411562698738059 for ; Fri, 22 Nov 2019 00:32:43 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@linaro.org header.s=google header.b=KXwfFMwB; spf=pass (domain: linaro.org, ip: 209.85.221.48, mailfrom: ard.biesheuvel@linaro.org) Received: by mail-wr1-f48.google.com with SMTP id z3so7559107wru.3 for ; Fri, 22 Nov 2019 00:32:42 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=KJ4xz6E2A7SkSTd9U1sN1hdMCWKr4VQHwLrU7Ou8jEU=; b=KXwfFMwBEN74keqlFXg38KXPOuORj36XO0N22jYYrJsB7Q1xBrjx0bu3Q+UKvb4NU0 gB39/41soSnBApEhTUrPVQMvZLYyIR3AK/GpTtDCPyQRctf+WzpnqvMMOthSFsQEGjtf Mk+df05wAF8V9sxRDKauhFz0I+FrLYdgpfZpV0BatFzvqci1WkxYRjrZSmsSXCzeZEuw Mo9IFGd/Nv5ajy31UWIXFZNxgm6UVUJp3p7HlZ2uK7S+QcgrJRrROYh1yWTc6x+Eloat WVjD7kPIikWDYsuqjug7MukP62P72qgNCRu3Qip95hld/RXBby4rhN7h+S7QH79YzNtT dHyA== 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=KJ4xz6E2A7SkSTd9U1sN1hdMCWKr4VQHwLrU7Ou8jEU=; b=aF9ACH6JIYqMxpNYErOjhxALXhB4OdZ+82ai54K9A7Hti5a5gu2XsXP4OTBXBxBQr4 m/BIYlh+Vj90aquyHaAawsH3L/62zfYCv4S8ERPEek2BkWK3KIjtsFvCobUkojVp7Y1n YpxYVIJKKhSQyjog3G5cKDl7RXT+qz3lYaibmMFdziBskkRSbyrTFA0TPrfpGN9DiqHr w0ofOhuzNNCKLk5QacRBjRi/c8Y2l61t7NUlrpjo8/Bjgldw7Dhu1Q8Kk03sprJwDntn 3KKCtAGjCxs1lxzDIz177YdUXiGAzQo4iYJYFosr6a97GjEmWBIEhHIkQKhN4QVFII26 H4mQ== X-Gm-Message-State: APjAAAVAi9p4nBetwWOF/D+1TSnRkoFR1kvlUjUVtEoo3PsAYBEzJaoj C7/+/QbGdsRWPUZ83cVt27SdLlFTNs33PfRl X-Google-Smtp-Source: APXvYqxWZ9tpcyiWZOlrJbCi/GyerCM2R3+NnZRUobyn2ELdFMKVdKzV2doXcjnKF2TTsovyC0q8hg== X-Received: by 2002:a5d:51c9:: with SMTP id n9mr17189715wrv.6.1574411561007; Fri, 22 Nov 2019 00:32:41 -0800 (PST) Return-Path: Received: from sudo.home ([2a01:cb1d:112:6f00:ac04:254:3863:fdeb]) by smtp.gmail.com with ESMTPSA id c15sm7225845wrx.78.2019.11.22.00.32.39 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 22 Nov 2019 00:32:40 -0800 (PST) From: "Ard Biesheuvel" To: devel@edk2.groups.io Cc: leif.lindholm@linaro.org, Ard Biesheuvel , piwg@uefi.org, kimon.berlin@hp.com, eugene@hp.com Subject: [PATCH 1/6] MdePkg: introduce MM communicate 2 protocol Date: Fri, 22 Nov 2019 09:32:29 +0100 Message-Id: <20191122083234.12756-2-ard.biesheuvel@linaro.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20191122083234.12756-1-ard.biesheuvel@linaro.org> References: <20191122083234.12756-1-ard.biesheuvel@linaro.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Add the protocol definition of the MM communicate 2 protocol, which has been introduced by version 1.7 errata A of the PI spec. Signed-off-by: Ard Biesheuvel --- MdePkg/Include/Protocol/MmCommunication2.h | 69 ++++++++++++++++++++ MdePkg/MdePkg.dec | 7 ++ 2 files changed, 76 insertions(+) diff --git a/MdePkg/Include/Protocol/MmCommunication2.h b/MdePkg/Include/Protocol/MmCommunication2.h new file mode 100644 index 000000000000..05f56dcae53e --- /dev/null +++ b/MdePkg/Include/Protocol/MmCommunication2.h @@ -0,0 +1,69 @@ +/** @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_COMMUNICATION2_H_ +#define _MM_COMMUNICATION2_H_ + +#include + +#define EFI_MM_COMMUNICATION2_PROTOCOL_GUID \ + { \ + 0x378daedc, 0xf06b, 0x4446, { 0x83, 0x14, 0x40, 0xab, 0x93, 0x3c, 0x87, 0xa3 } \ + } + +typedef struct _EFI_MM_COMMUNICATION2_PROTOCOL EFI_MM_COMMUNICATION2_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_COMMUNICATION_PROTOCOL instance. + @param[in] CommBufferPhysical Physical address of the MM communication buffer + @param[in] CommBufferVirtual Virtual address of the MM communication buffer + @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. + 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_COMMUNICATE2)( + IN CONST EFI_MM_COMMUNICATION2_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_COMMUNICATION2_PROTOCOL { + EFI_MM_COMMUNICATE2 Communicate; +}; + +extern EFI_GUID gEfiMmCommunication2ProtocolGuid; + +#endif + diff --git a/MdePkg/MdePkg.dec b/MdePkg/MdePkg.dec index d022cc5e3ef2..93037e0e6c61 100644 --- a/MdePkg/MdePkg.dec +++ b/MdePkg/MdePkg.dec @@ -1276,6 +1276,13 @@ ## Include/Protocol/SpiSmmNorFlash.h gEfiSpiSmmNorFlashProtocolGuid = { 0xaab18f19, 0xfe14, 0x4666, { 0x86, 0x04, 0x87, 0xff, 0x6d, 0x66, 0x2c, 0x9a }} + # + # Protocols defined in PI 1.7. + # + + ## Include/Protocol/MmCommunication2.h + gEfiMmCommunication2ProtocolGuid = { 0x378daedc, 0xf06b, 0x4446, { 0x83, 0x14, 0x40, 0xab, 0x93, 0x3c, 0x87, 0xa3 }} + # # Protocols defined in UEFI2.1/UEFI2.0/EFI1.1 # -- 2.20.1