1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
|
/*
** Id: //Department/DaVinci/BRANCHES/MT6620_WIFI_DRIVER_V2_3/include/debug.h#1
*/
/*! \file debug.h
\brief Definition of SW debugging level.
In this file, it describes the definition of various SW debugging levels and
assert functions.
*/
/*
** Log: debug.h
*
* 12 16 2011 wh.su
* [WCXRP00001078] [MT6620 Wi-Fi][Driver] Adding the mediatek log improment support : XLOG
* fixed the Windows DDK free build compiling error.
*
* 11 24 2011 wh.su
* [WCXRP00001078] [MT6620 Wi-Fi][Driver] Adding the mediatek log improment support : XLOG
* Adjust code for DBG and CONFIG_XLOG.
*
* 11 11 2011 wh.su
* [WCXRP00001078] [MT6620 Wi-Fi][Driver] Adding the mediatek log improment support : XLOG
* modify the xlog related code.
*
* 11 10 2011 wh.su
* [WCXRP00001078] [MT6620 Wi-Fi][Driver] Adding the mediatek log improment support : XLOG
* Using the new XLOG define for dum Memory.
*
* 11 03 2011 wh.su
* [WCXRP00001078] [MT6620 Wi-Fi][Driver] Adding the mediatek log improment support : XLOG
* Add dumpMemory8 at XLOG support.
*
* 11 02 2011 wh.su
* [WCXRP00001078] [MT6620 Wi-Fi][Driver] Adding the mediatek log improment support : XLOG
* adding the code for XLOG.
*
* 08 31 2011 cm.chang
* [WCXRP00000969] [MT6620 Wi-Fi][Driver][FW] Channel list for 5G band based on country code
* .
*
* 01 27 2011 tsaiyuan.hsu
* [WCXRP00000392] [MT6620 Wi-Fi][Driver] Add Roaming Support
* add roaming fsm
* 1. not support 11r, only use strength of signal to determine roaming.
* 2. not enable CFG_SUPPORT_ROAMING until completion of full test.
* 3. in 6620, adopt work-around to avoid sign extension problem of cck of hw
* 4. assume that change of link quality in smooth way.
*
* 01 07 2011 wh.su
* [WCXRP00000326] [MT6620][Wi-Fi][Driver] check in the binary format gl_sec.o.new instead of use change type!!!
* .
*
* 09 23 2010 cp.wu
* NULL
* add BOW index for debugging message and passing compilation
*
* 07 20 2010 wh.su
*
* adding the wapi code.
*
* 07 08 2010 cp.wu
*
* [WPD00003833] [MT6620 and MT5931] Driver migration - move to new repository.
*
* 06 21 2010 yarco.yang
* [WPD00003837][MT6620]Data Path Refine
* Support CFG_MQM_MIGRATION flag
*
* 06 17 2010 yuche.tsai
* [WPD00003839][MT6620 5931][P2P] Feature migration
* Add one more debug moduel for P2P.
*
* 06 14 2010 cp.wu
* [WPD00003833][MT6620 and MT5931] Driver migration
* add management dispatching function table.
*
* 06 11 2010 cp.wu
* [WPD00003833][MT6620 and MT5931] Driver migration
* add bss.c.
*
* 06 11 2010 cp.wu
* [WPD00003833][MT6620 and MT5931] Driver migration
* 1) migrate assoc.c.
* 2) add ucTxSeqNum for tracking frames which needs TX-DONE awareness
* 3) add configuration options for CNM_MEM and RSN modules
* 4) add data path for management frames
* 5) eliminate rPacketInfo of MSDU_INFO_T
*
* 06 10 2010 cp.wu
* [WPD00003833][MT6620 and MT5931] Driver migration
* add debug module index for cnm and ais.
*
* 06 06 2010 kevin.huang
* [WPD00003832][MT6620 5931] Create driver base
* [MT6620 5931] Create driver base
*
* 05 17 2010 cp.wu
* [WPD00001943]Create WiFi test driver framework on WinXP
* add CFG_STARTUP_DEBUG for debugging starting up issue.
*
* 04 26 2010 cp.wu
* [WPD00001943]Create WiFi test driver framework on WinXP
* 1) surpress compiler warning
* 2) when acqruing LP-own, keep writing WHLPCR whenever OWN is not acquired yet
** \main\maintrunk.MT6620WiFiDriver_Prj\4 2009-10-29 19:47:50 GMT mtk01084
** add emu category
** \main\maintrunk.MT6620WiFiDriver_Prj\3 2009-04-17 18:12:04 GMT mtk01426
** Don't use dynamic memory allocate for debug message
** \main\maintrunk.MT6620WiFiDriver_Prj\2 2009-03-10 20:11:29 GMT mtk01426
** Init for develop
**
*/
#ifndef _DEBUG_H
#define _DEBUG_H
/*******************************************************************************
* C O M P I L E R F L A G S
********************************************************************************
*/
#ifndef BUILD_QA_DBG
#define BUILD_QA_DBG 0
#endif
/*******************************************************************************
* E X T E R N A L R E F E R E N C E S
********************************************************************************
*/
#include "gl_typedef.h"
extern UINT_8 aucDebugModule[];
extern UINT_32 u4DebugModule;
/*******************************************************************************
* C O N S T A N T S
********************************************************************************
*/
/* Define debug category (class):
* (1) ERROR (2) WARN (3) STATE (4) EVENT (5) TRACE (6) INFO (7) LOUD (8) TEMP
*/
#define DBG_CLASS_ERROR BIT(0)
#define DBG_CLASS_WARN BIT(1)
#define DBG_CLASS_STATE BIT(2)
#define DBG_CLASS_EVENT BIT(3)
#define DBG_CLASS_TRACE BIT(4)
#define DBG_CLASS_INFO BIT(5)
#define DBG_CLASS_LOUD BIT(6)
#define DBG_CLASS_TEMP BIT(7)
#define DBG_CLASS_MASK BITS(0, 7)
#if defined(LINUX)
#define DBG_PRINTF_64BIT_DEC "lld"
#else /* Windows */
#define DBG_PRINTF_64BIT_DEC "I64d"
#endif
/*******************************************************************************
* D A T A T Y P E S
********************************************************************************
*/
/* Define debug module index */
typedef enum _ENUM_DBG_MODULE_T {
DBG_INIT_IDX = 0, /* For driver initial */
DBG_HAL_IDX, /* For HAL(HW) Layer */
DBG_INTR_IDX, /* For Interrupt */
DBG_REQ_IDX,
DBG_TX_IDX,
DBG_RX_IDX,
DBG_RFTEST_IDX, /* For RF test mode */
DBG_EMU_IDX, /* Developer specific */
DBG_SW1_IDX, /* Developer specific */
DBG_SW2_IDX, /* Developer specific */
DBG_SW3_IDX, /* Developer specific */
DBG_SW4_IDX, /* Developer specific */
DBG_HEM_IDX, /* HEM */
DBG_AIS_IDX, /* AIS */
DBG_RLM_IDX, /* RLM */
DBG_MEM_IDX, /* RLM */
DBG_CNM_IDX, /* CNM */
DBG_RSN_IDX, /* RSN */
DBG_BSS_IDX, /* BSS */
DBG_SCN_IDX, /* SCN */
DBG_SAA_IDX, /* SAA */
DBG_AAA_IDX, /* AAA */
DBG_P2P_IDX, /* P2P */
DBG_QM_IDX, /* QUE_MGT */
DBG_SEC_IDX, /* SEC */
DBG_BOW_IDX, /* BOW */
DBG_WAPI_IDX, /* WAPI */
DBG_ROAMING_IDX, /* ROAMING */
DBG_TDLS_IDX, /* TDLS *//* CFG_SUPPORT_TDLS */
DBG_OID_IDX,
DBG_NIC_IDX,
DBG_MODULE_NUM /* Notice the XLOG check */
} ENUM_DBG_MODULE_T;
/* XLOG */
/* #define XLOG_DBG_MODULE_IDX 28 */ /* DBG_MODULE_NUM */
/* #if (XLOG_DBG_MODULE_IDX != XLOG_DBG_MODULE_IDX) */
/* #error "Please modify the DBG_MODULE_NUM and make sure this include at XLOG" */
/* #endif */
/* Define who owns developer specific index */
#define DBG_YARCO_IDX DBG_SW1_IDX
#define DBG_KEVIN_IDX DBG_SW2_IDX
#define DBG_CMC_IDX DBG_SW3_IDX
#define DBG_GEORGE_IDX DBG_SW4_IDX
/*******************************************************************************
* P U B L I C D A T A
********************************************************************************
*/
/*******************************************************************************
* P R I V A T E D A T A
********************************************************************************
*/
/*******************************************************************************
* M A C R O S
********************************************************************************
*/
/* Debug print format string for the OS system time */
#define OS_SYSTIME_DBG_FORMAT "0x%08x"
/* Debug print argument for the OS system time */
#define OS_SYSTIME_DBG_ARGUMENT(systime) (systime)
/* Debug print format string for the MAC Address */
#define MACSTR "%pM"
/* "%02x:%02x:%02x:%02x:%02x:%02x" */
/* Debug print argument for the MAC Address */
#define MAC2STR(a) a
/* ((PUINT_8)a)[0], ((PUINT_8)a)[1], ((PUINT_8)a)[2], ((PUINT_8)a)[3], ((PUINT_8)a)[4], ((PUINT_8)a)[5] */
/* The pre-defined format to dump the value of a varaible with its name shown. */
#define DUMPVAR(variable, format) (#variable " = " format "\n", variable)
/* The pre-defined format to dump the MAC type value with its name shown. */
#define DUMPMACADDR(addr) (#addr " = %pM\n", (addr))
/* Basiclly, we just do renaming of KAL functions although they should
* be defined as "Nothing to do" if DBG=0. But in some compiler, the macro
* syntax does not support #define LOG_FUNC(x,...)
*
* A caller shall not invoke these three macros when DBG=0.
*/
/*LOG_FUNC("[wlan]%s:(" #_Module " " #_Class ") "_Fmt, __func__, ##__VA_ARGS__);*/
#define LOG_FUNC kalPrint
#if defined(LINUX)
#define DBGLOG(_Module, _Class, _Fmt, ...) \
do { \
if ((aucDebugModule[DBG_##_Module##_IDX] & DBG_CLASS_##_Class) == 0) \
break; \
LOG_FUNC("%s:(" #_Module " " #_Class ")"_Fmt, __func__, ##__VA_ARGS__); \
} while (0)
#else
#define DBGLOG(_Module, _Class, _Fmt)
#endif
#if DBG
#define TMP_BUF_LEN 256
#define TMP_WBUF_LEN (TMP_BUF_LEN * 2)
extern PINT_16 g_wbuf_p;
extern PINT_8 g_buf_p;
/* If __func__ is already defined by compiler, we just use it. */
#if defined(__func__)
#define DEBUGFUNC(_Func)
#else
#define DEBUGFUNC(_Func) \
static const char __func__[] = _Func
#endif
#define DBGLOG_MEM8(_Module, _Class, _StartAddr, _Length) \
{ \
if (aucDebugModule[DBG_##_Module##_IDX] & DBG_CLASS_##_Class) { \
LOG_FUNC("%s: (" #_Module " " #_Class ")\n", __func__); \
dumpMemory8((PUINT_8) (_StartAddr), (UINT_32) (_Length)); \
} \
}
#define DBGLOG_MEM32(_Module, _Class, _StartAddr, _Length) \
{ \
if (aucDebugModule[DBG_##_Module##_IDX] & DBG_CLASS_##_Class) { \
LOG_FUNC("%s: (" #_Module " " #_Class ")\n", __func__); \
dumpMemory32((PUINT_32) (_StartAddr), (UINT_32) (_Length)); \
} \
}
/*lint -restore */
/*lint -save -e961 use of '#undef' is discouraged */
#undef ASSERT
/*lint -restore */
#ifdef _lint
#define ASSERT(_exp) \
{ \
if (!(_exp)) { \
do {} while (1); \
} \
}
#else
#define ASSERT(_exp) \
{ \
if (!(_exp) && !fgIsBusAccessFailed) { \
LOG_FUNC("Assertion failed: %s:%d %s\n", __FILE__, __LINE__, #_exp); \
kalBreakPoint(); \
} \
}
#endif /* _lint */
#define ASSERT_REPORT(_exp, _fmt) \
{ \
if (!(_exp) && !fgIsBusAccessFailed) { \
LOG_FUNC("Assertion failed: %s:%d %s\n", __FILE__, __LINE__, #_exp); \
LOG_FUNC _fmt; \
kalBreakPoint(); \
} \
}
#define DISP_STRING(_str) _str
#else /* !DBG */
#define DEBUGFUNC(_Func)
#define INITLOG(_Fmt)
#define ERRORLOG(_Fmt)
#define WARNLOG(_Fmt)
#define DBGLOG_MEM8(_Module, _Class, _StartAddr, _Length)
#define DBGLOG_MEM32(_Module, _Class, _StartAddr, _Length)
#undef ASSERT
#if BUILD_QA_DBG
#if defined(LINUX) /* For debugging in Linux w/o GDB */
#define ASSERT(_exp) \
{ \
if (!(_exp) && !fgIsBusAccessFailed) { \
LOG_FUNC("Assertion failed: %s:%d (%s)\n", __FILE__, __LINE__, #_exp); \
kalBreakPoint(); \
} \
}
#define ASSERT_REPORT(_exp, _fmt) \
{ \
if (!(_exp) && !fgIsBusAccessFailed) { \
LOG_FUNC("Assertion failed: %s:%d (%s)\n", __FILE__, __LINE__, #_exp); \
LOG_FUNC _fmt; \
kalBreakPoint(); \
} \
}
#else
#ifdef WINDOWS_CE
#define UNICODE_TEXT(_msg) TEXT(_msg)
#define ASSERT(_exp) \
{ \
if (!(_exp) && !fgIsBusAccessFailed) { \
TCHAR rUbuf[256]; \
kalBreakPoint(); \
_stprintf(rUbuf, TEXT("Assertion failed: %s:%d %s\n"), \
UNICODE_TEXT(__FILE__), \
__LINE__, \
UNICODE_TEXT(#_exp)); \
MessageBox(NULL, rUbuf, TEXT("ASSERT!"), MB_OK); \
} \
}
#define ASSERT_REPORT(_exp, _fmt) \
{ \
if (!(_exp) && !fgIsBusAccessFailed) { \
TCHAR rUbuf[256]; \
kalBreakPoint(); \
_stprintf(rUbuf, TEXT("Assertion failed: %s:%d %s\n"), \
UNICODE_TEXT(__FILE__), \
__LINE__, \
UNICODE_TEXT(#_exp)); \
MessageBox(NULL, rUbuf, TEXT("ASSERT!"), MB_OK); \
} \
}
#else
#define ASSERT(_exp) \
{ \
if (!(_exp) && !fgIsBusAccessFailed) { \
kalBreakPoint(); \
} \
}
#define ASSERT_REPORT(_exp, _fmt) \
{ \
if (!(_exp) && !fgIsBusAccessFailed) { \
kalBreakPoint(); \
} \
}
#endif /* WINDOWS_CE */
#endif /* LINUX */
#else
#define ASSERT(_exp) \
{ \
if (!(_exp) && !fgIsBusAccessFailed) { \
LOG_FUNC("Warning at %s:%d (%s)\n", __func__, __LINE__, #_exp); \
} \
}
#define ASSERT_REPORT(_exp, _fmt) \
{ \
if (!(_exp) && !fgIsBusAccessFailed) { \
LOG_FUNC("Warning at %s:%d (%s)\n", __func__, __LINE__, #_exp); \
LOG_FUNC _fmt; \
} \
}
#endif /* BUILD_QA_DBG */
#define DISP_STRING(_str) ""
#endif /* DBG */
#if CFG_STARTUP_DEBUG
#if defined(LINUX)
#define DBGPRINTF kalPrint
#else
#define DBGPRINTF DbgPrint
#endif
#else
#define DBGPRINTF(...)
#endif
/* The following macro is used for debugging packed structures. */
#ifndef DATA_STRUCT_INSPECTING_ASSERT
#define DATA_STRUCT_INSPECTING_ASSERT(expr) \
{ \
switch (0) {case 0: case (expr): default:; } \
}
#endif
/*******************************************************************************
* F U N C T I O N D E C L A R A T I O N S
********************************************************************************
*/
VOID dumpMemory8(IN PUINT_8 pucStartAddr, IN UINT_32 u4Length);
VOID dumpMemory32(IN PUINT_32 pu4StartAddr, IN UINT_32 u4Length);
VOID wlanDebugInit(VOID);
VOID wlanDebugUninit(VOID);
VOID wlanTraceReleaseTcRes(P_ADAPTER_T prAdapter, PUINT_8 aucTxRlsCnt, UINT_8 ucAvailable);
VOID wlanTraceTxCmd(P_ADAPTER_T prAdapter, P_CMD_INFO_T prCmd);
VOID wlanReadFwStatus(P_ADAPTER_T prAdapter);
VOID wlanDumpTcResAndTxedCmd(PUINT_8 pucBuf, UINT_32 maxLen);
VOID wlanDumpCommandFwStatus(VOID);
/*******************************************************************************
* F U N C T I O N S
********************************************************************************
*/
#endif /* _DEBUG_H */
|
