| /****************************************************************************** |
| * |
| * 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. |
| * |
| * You should have received a copy of the GNU General Public License along with |
| * this program; if not, write to the Free Software Foundation, Inc., |
| * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA |
| * |
| * |
| ******************************************************************************/ |
| |
| |
| #ifndef __ODM_DBG_H__ |
| #define __ODM_DBG_H__ |
| |
| |
| /* */ |
| /* Define the debug levels */ |
| /* */ |
| /* 1. DBG_TRACE and DBG_LOUD are used for normal cases. */ |
| /* They can help SW engineer to develop 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 descr. 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_TRA 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 |
| /* 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 pr_info |
| #define RT_PRINTK(fmt, args...) \ |
| DbgPrint( "%s(): " fmt, __func__, ## args); |
| |
| #ifndef ASSERT |
| #define ASSERT(expr) |
| #endif |
| |
| #define ODM_RT_TRACE(pDM_Odm, comp, level, fmt) \ |
| if (((comp) & pDM_Odm->DebugComponents) && \ |
| (level <= pDM_Odm->DebugLevel)) { \ |
| DbgPrint("[ODM-8188E] "); \ |
| RT_PRINTK fmt; \ |
| } |
| |
| #define ODM_RT_TRACE_F(pDM_Odm, comp, level, fmt) \ |
| if (((comp) & pDM_Odm->DebugComponents) && \ |
| (level <= pDM_Odm->DebugLevel)) { \ |
| RT_PRINTK fmt; \ |
| } |
| |
| #define ODM_RT_ASSERT(pDM_Odm, expr, fmt) \ |
| if (!(expr)) { \ |
| DbgPrint( "Assertion failed! %s at ......\n", #expr); \ |
| DbgPrint( " ......%s,%s,line=%d\n", __FILE__, \ |
| __func__, __LINE__); \ |
| RT_PRINTK fmt; \ |
| ASSERT(false); \ |
| } |
| #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) \ |
| 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"); \ |
| } |
| |
| void ODM_InitDebugSetting(struct odm_dm_struct *pDM_Odm); |
| |
| #endif /* __ODM_DBG_H__ */ |