/****************************************************************************** * * 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 DEBUG_VERSION "1.1"*/ /*2015.07.29 YuChen*/ /*#define DEBUG_VERSION "1.2"*/ /*2015.08.28 Dino*/ #define DEBUG_VERSION "1.3" /*2016.04.28 YuChen*/ //----------------------------------------------------------------------------- // 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 /*FW DBG MSG*/ #define RATE_DECISION BIT0 #define INIT_RA_TABLE BIT1 #define RATE_UP BIT2 #define RATE_DOWN BIT3 #define TRY_DONE BIT4 #define RA_H2C BIT5 #define F_RATE_AP_RPT BIT7 //----------------------------------------------------------------------------- // 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_SNIFFER BIT5 #define ODM_COMP_ANT_DIV BIT6 #define ODM_COMP_DFS BIT7 #define ODM_COMP_NOISY_DETECT BIT8 #define ODM_COMP_RATE_ADAPTIVE BIT9 #define ODM_COMP_PATH_DIV BIT10 #define ODM_COMP_CCX BIT11 #define ODM_COMP_DYNAMIC_PRICCA BIT12 /*BIT13 TBD*/ #define ODM_COMP_MP BIT14 #define ODM_COMP_CFO_TRACKING BIT15 #define ODM_COMP_ACS BIT16 #define PHYDM_COMP_ADAPTIVITY BIT17 #define PHYDM_COMP_RA_DBG BIT18 #define PHYDM_COMP_TXBF BIT19 //MAC Functions #define ODM_COMP_EDCA_TURBO BIT20 /*BIT21 TBD*/ #define ODM_FW_DEBUG_TRACE BIT22 //RF Functions /*BIT23 TBD*/ #define ODM_COMP_TX_PWR_TRACK BIT24 #define ODM_COMP_RX_GAIN_TRACK BIT25 #define ODM_COMP_CALIBRATION BIT26 //Common Functions #define ODM_PHY_CONFIG BIT28 #define ODM_COMP_INIT BIT29 #define ODM_COMP_COMMON BIT30 #define ODM_COMP_API BIT31 /*------------------------Export Marco Definition---------------------------*/ #define config_phydm_read_txagc_check(data) (data != INVALID_TXAGC_DATA) #if (DM_ODM_SUPPORT_TYPE == ODM_WIN) #define RT_PRINTK DbgPrint #elif (DM_ODM_SUPPORT_TYPE == ODM_CE) #define DbgPrint printk #define RT_PRINTK(fmt, args...) DbgPrint( "%s(): " fmt, __FUNCTION__, ## args); #define RT_DISP(dbgtype, dbgflag, printstr) #else #define DbgPrint panic_printk #define RT_PRINTK(fmt, args...) DbgPrint( "%s(): " fmt, __FUNCTION__, ## args); #endif #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)) \ { \ if (pDM_Odm->SupportICType == ODM_RTL8188E) \ DbgPrint("[PhyDM-8188E] "); \ else if(pDM_Odm->SupportICType == ODM_RTL8192E) \ DbgPrint("[PhyDM-8192E] "); \ else if(pDM_Odm->SupportICType == ODM_RTL8812) \ DbgPrint("[PhyDM-8812A] "); \ else if(pDM_Odm->SupportICType == ODM_RTL8821) \ DbgPrint("[PhyDM-8821A] "); \ else if(pDM_Odm->SupportICType == ODM_RTL8814A) \ DbgPrint("[PhyDM-8814A] "); \ else if(pDM_Odm->SupportICType == ODM_RTL8703B) \ DbgPrint("[PhyDM-8703B] "); \ else if(pDM_Odm->SupportICType == ODM_RTL8822B) \ DbgPrint("[PhyDM-8822B] "); \ else if (pDM_Odm->SupportICType == ODM_RTL8188F) \ DbgPrint("[PhyDM-8188F] "); \ RT_PRINTK fmt; \ } \ } while (0) #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__,__FUNCTION__,__LINE__); \ RT_PRINTK fmt; \ ASSERT(FALSE); \ } #define ODM_dbg_enter() { DbgPrint("==> %s\n", __FUNCTION__); } #define ODM_dbg_exit() { DbgPrint("<== %s\n", __FUNCTION__); } #define ODM_dbg_trace(str) { DbgPrint("%s:%s\n", __FUNCTION__, str); } #define ODM_PRINT_ADDR(pDM_Odm, comp, level, title_str, ptr) \ if(((comp) & pDM_Odm->DebugComponents) && (level <= pDM_Odm->DebugLevel)) \ { \ int __i; \ pu1Byte __ptr = (pu1Byte)ptr; \ DbgPrint("[ODM] "); \ DbgPrint(title_str); \ DbgPrint(" "); \ for( __i=0; __i<6; __i++ ) \ DbgPrint("%02X%s", __ptr[__i], (__i==5)?"":"-"); \ DbgPrint("\n"); \ } #else #define ODM_RT_TRACE(pDM_Odm, comp, level, fmt) #define ODM_RT_TRACE_F(pDM_Odm, comp, level, fmt) #define ODM_RT_ASSERT(pDM_Odm, expr, fmt) #define ODM_dbg_enter() #define ODM_dbg_exit() #define ODM_dbg_trace(str) #define ODM_PRINT_ADDR(pDM_Odm, comp, level, title_str, ptr) #endif VOID PHYDM_InitDebugSetting(IN PDM_ODM_T pDM_Odm); VOID phydm_BasicDbgMessage( IN PVOID pDM_VOID); #if (DM_ODM_SUPPORT_TYPE == ODM_WIN) #define PHYDM_DBGPRINT 0 #define PHYDM_SSCANF(x, y, z) DCMD_Scanf(x, y, z) #define PHYDM_VAST_INFO_SNPRINTF PHYDM_SNPRINTF #if (PHYDM_DBGPRINT == 1) #define PHYDM_SNPRINTF(msg) \ do {\ rsprintf msg;\ DbgPrint(output);\ } while (0) #else #define PHYDM_SNPRINTF(msg) \ do {\ rsprintf msg;\ DCMD_Printf(output);\ } while (0) #endif #else #if (DM_ODM_SUPPORT_TYPE == ODM_CE) || defined(__OSK__) #define PHYDM_DBGPRINT 0 #else #define PHYDM_DBGPRINT 1 #endif #define MAX_ARGC 20 #define MAX_ARGV 16 #define DCMD_DECIMAL "%d" #define DCMD_CHAR "%c" #define DCMD_HEX "%x" #define PHYDM_SSCANF(x, y, z) sscanf(x, y, z) #define PHYDM_VAST_INFO_SNPRINTF(msg)\ do {\ snprintf msg;\ DbgPrint(output);\ } while (0) #if (PHYDM_DBGPRINT == 1) #define PHYDM_SNPRINTF(msg)\ do {\ snprintf msg;\ DbgPrint(output);\ } while (0) #else #define PHYDM_SNPRINTF(msg)\ do {\ if(out_len > used)\ used+=snprintf msg;\ } while (0) #endif #endif VOID phydm_BasicProfile( IN PVOID pDM_VOID, IN u4Byte *_used, OUT char *output, IN u4Byte *_out_len ); #if(DM_ODM_SUPPORT_TYPE & (ODM_CE|ODM_AP)) s4Byte phydm_cmd( IN PDM_ODM_T pDM_Odm, IN char *input, IN u4Byte in_len, IN u1Byte flag, OUT char *output, IN u4Byte out_len ); #endif VOID phydm_cmd_parser( IN PDM_ODM_T pDM_Odm, IN char input[][16], IN u4Byte input_num, IN u1Byte flag, OUT char *output, IN u4Byte out_len ); #if (DM_ODM_SUPPORT_TYPE == ODM_WIN) void phydm_sbd_check( IN PDM_ODM_T pDM_Odm ); void phydm_sbd_callback( PRT_TIMER pTimer ); void phydm_sbd_workitem_callback( IN PVOID pContext ); #endif VOID phydm_fw_trace_en_h2c( IN PVOID pDM_VOID, IN BOOLEAN enable, IN u4Byte monitor_mode, IN u4Byte macid ); VOID phydm_fw_trace_handler( IN PVOID pDM_VOID, IN pu1Byte CmdBuf, IN u1Byte CmdLen ); VOID phydm_fw_trace_handler_code( IN PVOID pDM_VOID, IN pu1Byte Buffer, IN u1Byte CmdLen ); VOID phydm_fw_trace_handler_8051( IN PVOID pDM_VOID, IN pu1Byte CmdBuf, IN u1Byte CmdLen ); #endif // __ODM_DBG_H__