cregit-Linux how code gets into the kernel

Release 4.15 drivers/staging/rtl8723bs/hal/odm_debug.h

/******************************************************************************
 *
 * Copyright(c) 2007 - 2011 Realtek Corporation. All rights reserved.
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of version 2 of the GNU General Public License as
 * published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
 * more details.
 *
 ******************************************************************************/

#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 develope 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 unexpeted 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__ */

Overall Contributors

PersonTokensPropCommitsCommitProp
Hans de Goede34696.65%133.33%
Arnd Bergmann82.23%133.33%
Justin Vreeland41.12%133.33%
Total358100.00%3100.00%
Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.
Created with cregit.