From nobody Mon Feb 9 23:38:40 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) client-ip=66.175.222.12; envelope-from=bounce+27952+66824+1787277+3901457@groups.io; helo=web01.groups.io; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+66824+1787277+3901457@groups.io; dmarc=fail(p=none dis=none) header.from=arm.com ARC-Seal: i=1; a=rsa-sha256; t=1604070046; cv=none; d=zohomail.com; s=zohoarc; b=oKe0ct92OifXCrbCQd9kZQVwWxrmm+J4SbHFL1RG72ImTwCYhyzYcKrF3/uagJgVl9DbegoVv0Z+aAM/YpTrqaf6UvzeG3JXgYV6pDZdH+In5jrkd5mK79WjH9oB//7lWa3g2rBcRTA55XpGn4T1GfktxiuyHOhUf53CN+WMQug= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1604070046; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:References:Sender:Subject:To; bh=Bw//StHj0CjGaHQSoHVW6pZj5QU/ruK9zpDCrDu3hTY=; b=Ejaoda3W/mi4ZTR9QKvNzo6f4RPefltNLniDJBMOR1HgrK20uIM/PQmbhkom0+fI/bBTSAqBudo3Gkj8XhDqc/N7qYPybScFV8vx42R+8numZZFTOdatNWY+sG76piBE0wOR5mUHvq0iIeN5VIvLQgFZ0CdXKgaAsH/al4Gvdfg= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of groups.io designates 66.175.222.12 as permitted sender) smtp.mailfrom=bounce+27952+66824+1787277+3901457@groups.io; dmarc=fail header.from= (p=none dis=none) header.from= Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by mx.zohomail.com with SMTPS id 1604070046106190.0567394398854; Fri, 30 Oct 2020 08:00:46 -0700 (PDT) Return-Path: X-Received: by 127.0.0.2 with SMTP id WtnoYY1788612xy35jKGYBJv; Fri, 30 Oct 2020 08:00:43 -0700 X-Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by mx.groups.io with SMTP id smtpd.web12.10669.1604046989300503617 for ; Fri, 30 Oct 2020 01:36:29 -0700 X-Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id D411ED6E; Fri, 30 Oct 2020 01:36:28 -0700 (PDT) X-Received: from usa.arm.com (a076764.blr.arm.com [10.162.16.42]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPA id 373F83F719; Fri, 30 Oct 2020 01:36:26 -0700 (PDT) From: "Omkar Anand Kulkarni" To: devel@edk2.groups.io Cc: Ard Biesheuvel , Leif Lindholm , Sami Mujawar , Jiewen Yao Subject: [edk2-devel] [PATCH 2/3] ArmPlatformPkg: add definition for MM_HEST_ERROR_SOURCE_DESC_PROTOCOL Date: Fri, 30 Oct 2020 14:06:10 +0530 Message-Id: <20201030083611.8196-3-omkar.kulkarni@arm.com> In-Reply-To: <20201030083611.8196-1-omkar.kulkarni@arm.com> References: <20201030083611.8196-1-omkar.kulkarni@arm.com> MIME-Version: 1.0 Precedence: Bulk List-Unsubscribe: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,omkar.kulkarni@arm.com X-Gm-Message-State: vFHUXoOWcRG2cb7yWmHkbm6px1787277AA= Content-Transfer-Encoding: quoted-printable DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io; q=dns/txt; s=20140610; t=1604070043; bh=NiQiKYOMqgEEu9bFcZFNMCAHDhtXJE3givCOnPVW0fs=; h=Cc:Date:From:Reply-To:Subject:To; b=NNXDwrIE39CgaSo3+0SOR6awSVSo81F+OXmTokMc9Gp3VlF6jnnxCqsoOn7x7G1UhIU OGqbOoiZx/R6ZdNKXT+L2cE2s5sQkzDYcI0pfKn5mMzA/F3iFxgRDcUBf7ySf+el5ob8N Q5PLP7mIGM3wWuDEf0Qf6cvM5iGLsuwANI8= X-ZohoMail-DKIM: pass (identity @groups.io) Content-Type: text/plain; charset="utf-8" Add the protocol definition of the MM_HEST_ERROR_SOURCE_DESC_PROTOCOL protocol. This protocol can be implemented by MM drivers to publish error source descriptors that have to be populated into HEST table. Co-authored-by: Thomas Abraham Signed-off-by: Omkar Anand Kulkarni --- ArmPlatformPkg/ArmPlatformPkg.dec | 1 + ArmPlatformPkg/Include/Protocol/HestErrorSourceInfo.h | 64 +++++++++++++++= +++++ 2 files changed, 65 insertions(+) diff --git a/ArmPlatformPkg/ArmPlatformPkg.dec b/ArmPlatformPkg/ArmPlatform= Pkg.dec index 23c5b768f677..8fc44c40e813 100644 --- a/ArmPlatformPkg/ArmPlatformPkg.dec +++ b/ArmPlatformPkg/ArmPlatformPkg.dec @@ -114,3 +114,4 @@ [Protocols.common] ## Arm Platform HEST table generation protocol gHestTableProtocolGuid =3D { 0x705bdcd9, 0x8c47, 0x457e, { 0xad, 0x0d, 0= xf7, 0x86, 0xf3, 0x4a, 0x0d, 0x63 } } + gMmHestErrorSourceDescProtocolGuid =3D { 0x560bf236, 0xa4a8, 0x4d69, { 0= xbc, 0xf6, 0xc2, 0x97, 0x24, 0x10, 0x9d, 0x91 } } diff --git a/ArmPlatformPkg/Include/Protocol/HestErrorSourceInfo.h b/ArmPla= tformPkg/Include/Protocol/HestErrorSourceInfo.h new file mode 100644 index 000000000000..396a7cc48ee9 --- /dev/null +++ b/ArmPlatformPkg/Include/Protocol/HestErrorSourceInfo.h @@ -0,0 +1,64 @@ +/** @file + Standalone MM protocol to get the HEST secure error source descriptor + information. + + Drivers must implement his protocol in order to pusblih their Hardware + error source descriptor information to OS through the HEST ACPI table. + + Copyright (c) 2020, ARM Limited. All rights reserved. + SPDX-License-Identifier: BSD-2-Clause-Patent + +**/ + +#ifndef MM_HEST_ERROR_SOURCE_DESC_ +#define MM_HEST_ERROR_SOURCE_DESC_ + +#define MM_HEST_ERROR_SOURCE_DESC_PROTOCOL_GUID \ + { \ + 0x560bf236, 0xa4a8, 0x4d69, { 0xbc, 0xf6, 0xc2, 0x97, 0x24, 0x10, 0x9d= , 0x91 } \ + } + +typedef struct MM_HEST_ERROR_SOURCE_DESC_PROTOCOL_ + MM_HEST_ERROR_SOURCE_DESC_PROTOCOL; + +/** + Get HEST Secure Error Source Descriptors. + + The drivers implementing this protocol must convey the total count and t= otal + length of the error sources the driver has along with the actual error s= ource + descriptors. + If the user of this driver calls the protocol by passing NULL as Buffer = parameter. + Then protocol shall return EFI_INVALID_PARAMETR with the total length an= d count of + the error source descriptor it supports. + + @param[in] This Instance of MM_HEST_ERROR_SOURCE_DESC_PRO= TOCOL. + @param[out] Buffer Buffer to be appended with the error sour= ce descriptors information. + @param[out] ErrorSourcesLength Total length of all the error source desc= riptors. + @param[out] ErrorSourceCount Count of total error source descriptors s= upported by the + driver. + + retval EFI_SUCCESS If the Buffer is valid and is filled with= valid Error Source + descriptor data. + retval EFI_INVALID_PARAMTER Buffer is NULL. + retval Other If no error source descriptor information= is available. + +**/ +typedef +EFI_STATUS +(EFIAPI *MM_HEST_GET_ERROR_SOURCE_DESCRIPTORS) ( + IN MM_HEST_ERROR_SOURCE_DESC_PROTOCOL *This, + OUT VOID **Buffer, + OUT UINTN *ErrorSourcesLength, + OUT UINTN *ErrorSourcesCount + ); + +// +// Protocol declaration +// +struct MM_HEST_ERROR_SOURCE_DESC_PROTOCOL_ { + MM_HEST_GET_ERROR_SOURCE_DESCRIPTORS GetHestErrorSourceDescriptors; +}; + +extern EFI_GUID gMmHestErrorSourceDescProtocolGuid; + +#endif // MM_HEST_ERROR_SOURCE_DESC_ --=20 2.17.1 -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#66824): https://edk2.groups.io/g/devel/message/66824 Mute This Topic: https://groups.io/mt/77913842/1787277 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [importer@patchew.org] -=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-