/* SPDX-License-Identifier: GPL-2.0 */
|
/******************************************************************************
|
*
|
* Copyright(c) 2007 - 2011 Realtek Corporation. All rights reserved.
|
*
|
******************************************************************************/
|
|
#ifndef __ODM_DBG_H__
|
#define __ODM_DBG_H__
|
|
|
/* */
|
/* Define the debug levels */
|
/* */
|
/* 1. DBG_TRACE and DBG_LOUD are used for normal cases. */
|
/* So that, they can help SW engineer to developed or trace states changed */
|
/* and also help HW enginner to trace every operation to and from HW, */
|
/* e.g IO, Tx, Rx. */
|
/* */
|
/* 2. DBG_WARNNING and DBG_SERIOUS are used for unusual or error cases, */
|
/* which help us to debug SW or HW. */
|
/* */
|
/* */
|
/* */
|
/* Never used in a call to ODM_RT_TRACE()! */
|
/* */
|
#define ODM_DBG_OFF 1
|
|
/* */
|
/* Fatal bug. */
|
/* For example, Tx/Rx/IO locked up, OS hangs, memory access violation, */
|
/* resource allocation failed, unexpected HW behavior, HW BUG and so on. */
|
/* */
|
#define ODM_DBG_SERIOUS 2
|
|
/* */
|
/* Abnormal, rare, or unexpected cases. */
|
/* For example, */
|
/* IRP/Packet/OID canceled, */
|
/* device suprisely unremoved and so on. */
|
/* */
|
#define ODM_DBG_WARNING 3
|
|
/* */
|
/* Normal case with useful information about current SW or HW state. */
|
/* For example, Tx/Rx descriptor to fill, Tx/Rx descriptor completed status, */
|
/* SW protocol state change, dynamic mechanism state change and so on. */
|
/* */
|
#define ODM_DBG_LOUD 4
|
|
/* */
|
/* Normal case with detail execution flow or information. */
|
/* */
|
#define ODM_DBG_TRACE 5
|
|
/* */
|
/* Define the tracing components */
|
/* */
|
/* */
|
/* BB Functions */
|
#define ODM_COMP_DIG BIT0
|
#define ODM_COMP_RA_MASK BIT1
|
#define ODM_COMP_DYNAMIC_TXPWR BIT2
|
#define ODM_COMP_FA_CNT BIT3
|
#define ODM_COMP_RSSI_MONITOR BIT4
|
#define ODM_COMP_CCK_PD BIT5
|
#define ODM_COMP_ANT_DIV BIT6
|
#define ODM_COMP_PWR_SAVE BIT7
|
#define ODM_COMP_PWR_TRAIN BIT8
|
#define ODM_COMP_RATE_ADAPTIVE BIT9
|
#define ODM_COMP_PATH_DIV BIT10
|
#define ODM_COMP_PSD BIT11
|
#define ODM_COMP_DYNAMIC_PRICCA BIT12
|
#define ODM_COMP_RXHP BIT13
|
#define ODM_COMP_MP BIT14
|
#define ODM_COMP_CFO_TRACKING BIT15
|
/* MAC Functions */
|
#define ODM_COMP_EDCA_TURBO BIT16
|
#define ODM_COMP_EARLY_MODE BIT17
|
/* RF Functions */
|
#define ODM_COMP_TX_PWR_TRACK BIT24
|
#define ODM_COMP_RX_GAIN_TRACK BIT25
|
#define ODM_COMP_CALIBRATION BIT26
|
/* Common Functions */
|
#define ODM_COMP_COMMON BIT30
|
#define ODM_COMP_INIT BIT31
|
|
/*------------------------Export Marco Definition---------------------------*/
|
#define DbgPrint printk
|
#define RT_PRINTK(fmt, args...)\
|
DbgPrint("%s(): " fmt, __func__, ## args)
|
#define RT_DISP(dbgtype, dbgflag, printstr)
|
|
#ifndef ASSERT
|
#define ASSERT(expr)
|
#endif
|
|
#if DBG
|
#define ODM_RT_TRACE(pDM_Odm, comp, level, fmt)\
|
do {\
|
if (\
|
(comp & pDM_Odm->DebugComponents) &&\
|
(level <= pDM_Odm->DebugLevel ||\
|
level == ODM_DBG_SERIOUS)\
|
) {\
|
RT_PRINTK fmt;\
|
} \
|
} while (0)
|
|
#define ODM_RT_TRACE_F(pDM_Odm, comp, level, fmt)\
|
do {\
|
if (\
|
(comp & pDM_Odm->DebugComponents) &&\
|
(level <= pDM_Odm->DebugLevel)\
|
) {\
|
RT_PRINTK fmt;\
|
} \
|
} while (0)
|
|
#define ODM_RT_ASSERT(pDM_Odm, expr, fmt)\
|
do {\
|
if (!expr) {\
|
DbgPrint("Assertion failed! %s at ......\n", #expr);\
|
DbgPrint(\
|
" ......%s,%s, line =%d\n",\
|
__FILE__,\
|
__func__,\
|
__LINE__\
|
);\
|
RT_PRINTK fmt;\
|
ASSERT(false);\
|
} \
|
} while (0)
|
#define ODM_dbg_enter() { DbgPrint("==> %s\n", __func__); }
|
#define ODM_dbg_exit() { DbgPrint("<== %s\n", __func__); }
|
#define ODM_dbg_trace(str) { DbgPrint("%s:%s\n", __func__, str); }
|
|
#define ODM_PRINT_ADDR(pDM_Odm, comp, level, title_str, ptr)\
|
do {\
|
if (\
|
(comp & pDM_Odm->DebugComponents) &&\
|
(level <= pDM_Odm->DebugLevel)\
|
) {\
|
int __i;\
|
u8 *__ptr = (u8 *)ptr;\
|
DbgPrint("[ODM] ");\
|
DbgPrint(title_str);\
|
DbgPrint(" ");\
|
for (__i = 0; __i < 6; __i++)\
|
DbgPrint("%02X%s", __ptr[__i], (__i == 5) ? "" : "-");\
|
DbgPrint("\n");\
|
} \
|
} while (0)
|
#else
|
#define ODM_RT_TRACE(pDM_Odm, comp, level, fmt) no_printk fmt
|
#define ODM_RT_TRACE_F(pDM_Odm, comp, level, fmt) no_printk fmt
|
#define ODM_RT_ASSERT(pDM_Odm, expr, fmt) no_printk fmt
|
#define ODM_dbg_enter() do {} while (0)
|
#define ODM_dbg_exit() do {} while (0)
|
#define ODM_dbg_trace(str) no_printk("%s", str)
|
#define ODM_PRINT_ADDR(pDM_Odm, comp, level, title_str, ptr) \
|
no_printk("%s %p", title_str, ptr)
|
#endif
|
|
void ODM_InitDebugSetting(PDM_ODM_T pDM_Odm);
|
|
#endif /* __ODM_DBG_H__ */
|
