From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) by mx.groups.io with SMTP id smtpd.web11.32930.1683762031295605069 for ; Wed, 10 May 2023 16:40:31 -0700 Authentication-Results: mx.groups.io; dkim=fail reason="unable to parse pub key" header.i=@intel.com header.s=intel header.b=NA44d9Ec; spf=pass (domain: intel.com, ip: 192.55.52.43, mailfrom: gua.guo@intel.com) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1683762031; x=1715298031; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=hYvU3lV5o/eOCKACyeHyoMcbjTZLr5jiLneCOCyr0pw=; b=NA44d9EcSIYko6xEafZrpRlyoZUyK6FgNKVByP6pZ43PpsqNTYNpebGk V1OAnrOVClCA+KOb0v64IJs/wgyYoTyxVm3H9htfQyByUOTcP55Gn2sIl KIfUvJnYJXc+RRcmglFjeaOQRAm7e0qRI9hxMR3LuZEhB5K9VdjKN6lin 0iLIF1/ch0/UfFAMqTQQnjioYp2duGwhcdI5LEorhw1ZHyJ1ZVn01vxlK 6K9GJjqYtUGfLbdmNBNk7weSkQmp4c+6GmYL7G5/Wx3AiTETvr3zAtPJ+ 1QPlmCLDyHEY7STA80dQGadYeslUft/i4Th30tGaNTTTy0Z8ESj6O4oQ6 g==; X-IronPort-AV: E=McAfee;i="6600,9927,10706"; a="436672925" X-IronPort-AV: E=Sophos;i="5.99,265,1677571200"; d="scan'208";a="436672925" Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 10 May 2023 16:40:29 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10706"; a="1029405179" X-IronPort-AV: E=Sophos;i="5.99,265,1677571200"; d="scan'208";a="1029405179" Received: from gguo-desk.gar.corp.intel.com ([10.5.215.23]) by fmsmga005.fm.intel.com with ESMTP; 10 May 2023 16:40:27 -0700 From: "Guo, Gua" To: devel@edk2.groups.io Cc: gua.guo@intel.com, Michael D Kinney , Liming Gao , Zhiguang Liu , Chan Laura , Prakashan Krishnadas Veliyathuparambil , K N Karthik Subject: [PATCH v9 3/5] MdePkg: Add NULL library of TraceHubDebugSysTLib Date: Thu, 11 May 2023 07:39:28 +0800 Message-Id: <20230510233930.1419-4-gua.guo@intel.com> X-Mailer: git-send-email 2.39.2.windows.1 In-Reply-To: <20230510233930.1419-1-gua.guo@intel.com> References: <20230510233930.1419-1-gua.guo@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable From: Gua Guo REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3D4144 This Library is NULL library of TraceHubDebugSysTLib. Cc: Michael D Kinney Cc: Liming Gao Cc: Zhiguang Liu Cc: Guo Gua Cc: Chan Laura Cc: Prakashan Krishnadas Veliyathuparambil Cc: K N Karthik Signed-off-by: Guo Gua Reviewed-by: Michael D Kinney Reviewed-by: K N Karthik Reviewed-by: Chan Laura --- MdePkg/Include/Library/TraceHubDebugSysTLib.h | 81 +++++++++++++++++++ .../TraceHubDebugSysTLibNull.c | 76 +++++++++++++++++ .../TraceHubDebugSysTLibNull.inf | 29 +++++++ MdePkg/MdePkg.dsc | 1 + 4 files changed, 187 insertions(+) create mode 100644 MdePkg/Include/Library/TraceHubDebugSysTLib.h create mode 100644 MdePkg/Library/TraceHubDebugSysTLibNull/TraceHubDebugSy= sTLibNull.c create mode 100644 MdePkg/Library/TraceHubDebugSysTLibNull/TraceHubDebugSy= sTLibNull.inf diff --git a/MdePkg/Include/Library/TraceHubDebugSysTLib.h b/MdePkg/Include= /Library/TraceHubDebugSysTLib.h new file mode 100644 index 0000000000..7df20e67d6 --- /dev/null +++ b/MdePkg/Include/Library/TraceHubDebugSysTLib.h @@ -0,0 +1,81 @@ +/** @file=0D +This header file declares Trace Hub related top level APIs.=0D +=0D +Copyright (c) 2023, Intel Corporation. All rights reserved.
=0D +=0D +SPDX-License-Identifier: BSD-2-Clause-Patent=0D +=0D +**/=0D +=0D +#ifndef TRACE_HUB_DEBUG_SYST_LIB_H_=0D +#define TRACE_HUB_DEBUG_SYST_LIB_H_=0D +=0D +typedef enum {=0D + SeverityNone =3D 0,=0D + SeverityFatal =3D 1,=0D + SeverityError =3D 2,=0D + SeverityWarning =3D 3,=0D + SeverityNormal =3D 4,=0D + SeverityUser1 =3D 5,=0D + SeverityUser2 =3D 6,=0D + SeverityUser3 =3D 7,=0D + SeverityMax=0D +} TRACE_HUB_SEVERITY_TYPE;=0D +=0D +/**=0D + Write debug string to specified Trace Hub MMIO address.=0D +=0D + @param[in] SeverityType Severity type of input message.=0D + @param[in] Buffer A pointer to the data buffer.=0D + @param[in] NumberOfBytes The size of data buffer.=0D +=0D + @retval RETURN_SUCCESS Data was written to Trace Hub.=0D + @retval Other Failed to output Trace Hub message.=0D +**/=0D +RETURN_STATUS=0D +EFIAPI=0D +TraceHubSysTDebugWrite (=0D + IN TRACE_HUB_SEVERITY_TYPE SeverityType,=0D + IN UINT8 *Buffer,=0D + IN UINTN NumberOfBytes=0D + );=0D +=0D +/**=0D + Write catalog status code message to specified Trace Hub MMIO address.=0D +=0D + @param[in] SeverityType Severity type of input message.=0D + @param[in] Id Catalog ID.=0D + @param[in] Guid Driver Guid.=0D +=0D + @retval RETURN_SUCCESS Data was written to Trace Hub.=0D + @retval Other Failed to output Trace Hub message.=0D +**/=0D +RETURN_STATUS=0D +EFIAPI=0D +TraceHubSysTWriteCataLog64StatusCode (=0D + IN TRACE_HUB_SEVERITY_TYPE SeverityType,=0D + IN UINT64 Id,=0D + IN GUID *Guid=0D + );=0D +=0D +/**=0D + Write catalog message to specified Trace Hub MMIO address.=0D +=0D + @param[in] SeverityType Severity type of input message.=0D + @param[in] Id Catalog ID.=0D + @param[in] NumberOfParams Number of entries in argument list.=0D + @param[in] ... Catalog message parameters.=0D +=0D + @retval RETURN_SUCCESS Data was written to Trace Hub.=0D + @retval Other Failed to output Trace Hub message.=0D +**/=0D +RETURN_STATUS=0D +EFIAPI=0D +TraceHubSysTWriteCataLog64 (=0D + IN TRACE_HUB_SEVERITY_TYPE SeverityType,=0D + IN UINT64 Id,=0D + IN UINTN NumberOfParams,=0D + ...=0D + );=0D +=0D +#endif // TRACE_HUB_DEBUG_SYST_LIB_H_=0D diff --git a/MdePkg/Library/TraceHubDebugSysTLibNull/TraceHubDebugSysTLibNu= ll.c b/MdePkg/Library/TraceHubDebugSysTLibNull/TraceHubDebugSysTLibNull.c new file mode 100644 index 0000000000..0bd14d4e24 --- /dev/null +++ b/MdePkg/Library/TraceHubDebugSysTLibNull/TraceHubDebugSysTLibNull.c @@ -0,0 +1,76 @@ +/** @file=0D +Null library of TraceHubDebugSysTLib.=0D +=0D +Copyright (c) 2023, Intel Corporation. All rights reserved.
=0D +=0D +SPDX-License-Identifier: BSD-2-Clause-Patent=0D +=0D +**/=0D +=0D +#include =0D +#include =0D +=0D +/**=0D + Write debug string to specified Trace Hub MMIO address.=0D +=0D + @param[in] SeverityType Severity type of input message.=0D + @param[in] Buffer A pointer to the data buffer.=0D + @param[in] NumberOfBytes The size of data buffer.=0D +=0D + @retval RETURN_SUCCESS Data was written to Trace Hub.=0D + @retval Other Failed to output Trace Hub message.=0D +**/=0D +RETURN_STATUS=0D +EFIAPI=0D +TraceHubSysTDebugWrite (=0D + IN TRACE_HUB_SEVERITY_TYPE SeverityType,=0D + IN UINT8 *Buffer,=0D + IN UINTN NumberOfBytes=0D + )=0D +{=0D + return RETURN_UNSUPPORTED;=0D +}=0D +=0D +/**=0D + Write catalog status code message to specified Trace Hub MMIO address.=0D +=0D + @param[in] SeverityType Severity type of input message.=0D + @param[in] Id Catalog ID.=0D + @param[in] Guid Driver Guid.=0D +=0D + @retval RETURN_SUCCESS Data was written to Trace Hub.=0D + @retval Other Failed to output Trace Hub message.=0D +**/=0D +RETURN_STATUS=0D +EFIAPI=0D +TraceHubSysTWriteCataLog64StatusCode (=0D + IN TRACE_HUB_SEVERITY_TYPE SeverityType,=0D + IN UINT64 Id,=0D + IN GUID *Guid=0D + )=0D +{=0D + return RETURN_UNSUPPORTED;=0D +}=0D +=0D +/**=0D + Write catalog message to specified Trace Hub MMIO address.=0D +=0D + @param[in] SeverityType Severity type of input message.=0D + @param[in] Id Catalog ID.=0D + @param[in] NumberOfParams Number of entries in argument list.=0D + @param[in] ... Catalog message parameters.=0D +=0D + @retval RETURN_SUCCESS Data was written to Trace Hub.=0D + @retval Other Failed to output Trace Hub message.=0D +**/=0D +RETURN_STATUS=0D +EFIAPI=0D +TraceHubSysTWriteCataLog64 (=0D + IN TRACE_HUB_SEVERITY_TYPE SeverityType,=0D + IN UINT64 Id,=0D + IN UINTN NumberOfParams,=0D + ...=0D + )=0D +{=0D + return RETURN_UNSUPPORTED;=0D +}=0D diff --git a/MdePkg/Library/TraceHubDebugSysTLibNull/TraceHubDebugSysTLibNu= ll.inf b/MdePkg/Library/TraceHubDebugSysTLibNull/TraceHubDebugSysTLibNull.i= nf new file mode 100644 index 0000000000..ba894fc250 --- /dev/null +++ b/MdePkg/Library/TraceHubDebugSysTLibNull/TraceHubDebugSysTLibNull.inf @@ -0,0 +1,29 @@ +## @file=0D +# Null library of TraceHubDebugSysTLib.=0D +#=0D +# Copyright (c) 2023, Intel Corporation. All rights reserved.
=0D +#=0D +# SPDX-License-Identifier: BSD-2-Clause-Patent=0D +#=0D +##=0D +=0D +=0D +[Defines]=0D + INF_VERSION =3D 0x00010005=0D + BASE_NAME =3D TraceHubDebugSysTLibNull=0D + FILE_GUID =3D 16196A4E-4196-4AF4-9A6B-F4D2ACC430A8= =0D + MODULE_TYPE =3D BASE=0D + VERSION_STRING =3D 1.0=0D + LIBRARY_CLASS =3D TraceHubDebugSysTLib=0D +=0D +#=0D +# The following information is for reference only and not required by the = build tools.=0D +#=0D +# VALID_ARCHITECTURES =3D IA32 X64=0D +#=0D +=0D +[Packages]=0D + MdePkg/MdePkg.dec=0D +=0D +[Sources]=0D + TraceHubDebugSysTLibNull.c=0D diff --git a/MdePkg/MdePkg.dsc b/MdePkg/MdePkg.dsc index 902a39cffc..c850970b23 100644 --- a/MdePkg/MdePkg.dsc +++ b/MdePkg/MdePkg.dsc @@ -185,6 +185,7 @@ MdePkg/Library/MmUnblockMemoryLib/MmUnblockMemoryLibNull.inf=0D MdePkg/Library/TdxLib/TdxLib.inf=0D MdePkg/Library/MipiSysTLib/MipiSysTLib.inf=0D + MdePkg/Library/TraceHubDebugSysTLibNull/TraceHubDebugSysTLibNull.inf=0D =0D [Components.EBC]=0D MdePkg/Library/BaseIoLibIntrinsic/BaseIoLibIntrinsic.inf=0D --=20 2.39.2.windows.1