#include <Base.h>
#include <Library/BaseLib.h>
#include <Library/BaseMemoryLib.h>
#include <Library/TraceHubDebugSysTLib.h>
#include <Library/MipiSysTLib/mipi_syst.h>
#include <Guid/TraceHubDebugInfoHob.h>
#include "InternalTraceHubApiCommon.h"
#include "InternalTraceHubApi.h"

Functions
BOOLEAN EFIAPI	TraceHubDataEnabled (IN BOOLEAN Flag, IN UINT8 DbgLevel, IN TRACE_HUB_SEVERITY_TYPE SeverityType)

VOID EFIAPI	SwapBytesGuid (IN GUID Guid, OUT GUID ConvertedGuid)

RETURN_STATUS EFIAPI	CheckWhetherToOutputMsg (IN OUT MIPI_SYST_HANDLE MipiSystHandle, IN UINT8 DbgContext, IN TRACE_HUB_SEVERITY_TYPE SeverityType, IN TRACEHUB_PRINTTYPE PrintType)

RETURN_STATUS EFIAPI	GetTraceHubMmioAddress (IN UINT8 DbgContext, IN OUT UINT64 TraceAddress)

RETURN_STATUS EFIAPI	GetTraceHubMsgVisibility (IN UINT8 DbgContext, IN OUT BOOLEAN Flag, IN OUT UINT8 *DbgLevel)

Detailed Description

Functions implementation defined in this file are common for all type of TraceHubDebugSysTLib

SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file InternalTraceHubApiCommon.c.

Function Documentation

◆ CheckWhetherToOutputMsg()

RETURN_STATUS EFIAPI CheckWhetherToOutputMsg	(	IN OUT MIPI_SYST_HANDLE *	MipiSystHandle,
		IN UINT8 *	DbgContext,
		IN TRACE_HUB_SEVERITY_TYPE	SeverityType,
		IN TRACEHUB_PRINTTYPE	PrintType
	)

Check whether to output Trace Hub message according to some conditions. Trace Hub message will be disabled if TraceHubDataEnabled() return FALSE or Trace Hub MMIO address is 0.

Parameters

[in,out]	MipiSystHandle	A pointer to MIPI_SYST_HANDLE structure.
[in]	DbgContext	A pointer to Trace Hub debug instance.
[in]	SeverityType	Severity type of input message.
[in]	PrintType	Either catalog print or debug print.

Return values

RETURN_SUCCESS	Current Trace Hub message need to be output.
Other	Current Trace Hub message will be disabled.

Definition at line 94 of file InternalTraceHubApiCommon.c.

◆ GetTraceHubMmioAddress()

RETURN_STATUS EFIAPI GetTraceHubMmioAddress	(	IN UINT8 *	DbgContext,
		IN OUT UINT64 *	TraceAddress
	)

Get Trace Hub MMIO Address.

Parameters

[in]	DbgContext	A pointer to Trace Hub debug instance.
[in,out]	TraceAddress	Trace Hub MMIO Address.

Return values

RETURN_SUCCESS	Operation is successfully.
Other	Operation is failed.

Definition at line 145 of file InternalTraceHubApiCommon.c.

◆ GetTraceHubMsgVisibility()

RETURN_STATUS EFIAPI GetTraceHubMsgVisibility	(	IN UINT8 *	DbgContext,
		IN OUT BOOLEAN *	Flag,
		IN OUT UINT8 *	DbgLevel
	)

Get visibility of Trace Hub Msg.

Parameters

[in]	DbgContext	A pointer to Trace Hub debug instance.
[in,out]	Flag	Flag to enable or disable Trace Hub message.
[in,out]	DbgLevel	Debug Level of Trace Hub.

Return values

RETURN_SUCCESS	Operation is successfully.
Other	Operation is failed.

Definition at line 178 of file InternalTraceHubApiCommon.c.

◆ SwapBytesGuid()

VOID EFIAPI SwapBytesGuid	(	IN GUID *	Guid,
		OUT GUID *	ConvertedGuid
	)

Convert GUID from LE to BE or BE to LE.

Parameters

[in]	Guid	GUID that need to be converted.
[out]	ConvertedGuid	GUID that is converted.

Definition at line 68 of file InternalTraceHubApiCommon.c.

◆ TraceHubDataEnabled()

BOOLEAN EFIAPI TraceHubDataEnabled	(	IN BOOLEAN	Flag,
		IN UINT8	DbgLevel,
		IN TRACE_HUB_SEVERITY_TYPE	SeverityType
	)

Conditionally determine whether to enable Trace Hub message.

Parameters

[in]	Flag	Flag to enable or disable Trace Hub message.
[in]	DbgLevel	Debug Level of Trace Hub.
[in]	SeverityType	Severity type of input message.

Return values

TRUE	Enable trace hub message.
FALSE	Disable trace hub message.

Definition at line 31 of file InternalTraceHubApiCommon.c.