| /****************************************************************************** |
| * |
| * 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 |
| /* 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 Macro Definition---------------------------*/ |
| #define DbgPrint printk |
| #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-8723A] "); \ |
| 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_InitDebugSetting23a(struct dm_odm_t *pDM_Odm); |
| |
| #endif /* __ODM_DBG_H__ */ |