hc
2023-11-06 15ade055295d13f95d49e3d99b09f3bbfb4a43e7
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
/******************************************************************************
 *
 * Copyright(c) 2007 - 2017 Realtek Corporation.
 *
 * 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 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 DEBUG_VERSION    "1.4"  /*2017.03.13 Dino*/
 
/* -----------------------------------------------------------------------------
 *    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    BIT(0)
#define    INIT_RA_TABLE    BIT(1)
#define    RATE_UP        BIT(2)
#define    RATE_DOWN        BIT(3)
#define    TRY_DONE        BIT(4)
#define    RA_H2C            BIT(5)
#define    F_RATE_AP_RPT    BIT(7)
 
/* -----------------------------------------------------------------------------
 * Define the tracing components
 *
 * -----------------------------------------------------------------------------
 *BB FW Functions*/
#define    PHYDM_FW_COMP_RA            BIT(0)
#define    PHYDM_FW_COMP_MU            BIT(1)
#define    PHYDM_FW_COMP_PATH_DIV        BIT(2)
#define    PHYDM_FW_COMP_PT            BIT(3)
 
 
 
 
/*------------------------Export Marco Definition---------------------------*/
 
#define    config_phydm_read_txagc_check(data)        (data != INVALID_TXAGC_DATA)
 
#if (DM_ODM_SUPPORT_TYPE == ODM_WIN)
   #define    dbg_print                DbgPrint
   #define    dcmd_printf                DCMD_Printf
   #define    dcmd_scanf                DCMD_Scanf
   #define RT_PRINTK                dbg_print
#elif (DM_ODM_SUPPORT_TYPE == ODM_CE) && defined(DM_ODM_CE_MAC80211)
   #define dbg_print(args...)
   #define RT_PRINTK(fmt, args...)    \
           RT_TRACE(((struct rtl_priv *)p_dm->adapter),    \
                COMP_PHYDM, DBG_DMESG, fmt, ## args)
   #define    RT_DISP(dbgtype, dbgflag, printstr)
#elif (DM_ODM_SUPPORT_TYPE == ODM_CE)
   #define dbg_print    printk
   #define RT_PRINTK(fmt, args...)    dbg_print(fmt, ## args)
   #define    RT_DISP(dbgtype, dbgflag, printstr)
#else
   #define dbg_print    panic_printk
   /*#define RT_PRINTK(fmt, args...)    dbg_print("%s(): " fmt, __FUNCTION__, ## args);*/
   #define RT_PRINTK(args...)    dbg_print(args)
#endif
 
#ifndef ASSERT
   #define ASSERT(expr)
#endif
 
#if DBG
#define PHYDM_DBG(p_dm, comp, fmt)                \
   do {                                                    \
       if ((comp) & (p_dm->debug_components)) {    \
                                                       \
           dbg_print("[PHYDM] ");                        \
           RT_PRINTK fmt;                                \
       }                                                \
   } while (0)
 
#define PHYDM_DBG_F(p_dm, comp, fmt)                                     do {\
       if ((comp) & p_dm->debug_components) { \
           \
           RT_PRINTK fmt;                                                            \
       }    \
   } while (0)
 
#define PHYDM_PRINT_ADDR(p_dm, comp, title_str, ptr)                             do {\
       if ((comp) & p_dm->debug_components) { \
           \
           int __i;                                                                \
           u8 *__ptr = (u8 *)ptr;                                            \
           dbg_print("[PHYDM] ");                                                    \
           dbg_print(title_str);                                                    \
           dbg_print(" ");                                                        \
           for (__i = 0; __i < 6; __i++)                                                \
               dbg_print("%02X%s", __ptr[__i], (__i == 5) ? "" : "-");                        \
           dbg_print("\n");                                                        \
       }    \
   } while (0)
 
#define ODM_RT_TRACE(p_dm, comp, level, fmt)                                    \
   do {    \
       if (((comp) & p_dm->debug_components) && (level <= p_dm->debug_level || level == ODM_DBG_SERIOUS)) { \
           \
           if (p_dm->support_ic_type == ODM_RTL8188E)                            \
               dbg_print("[PhyDM-8188E] ");                                            \
           else if (p_dm->support_ic_type == ODM_RTL8192E)                        \
               dbg_print("[PhyDM-8192E] ");                                            \
           else if (p_dm->support_ic_type == ODM_RTL8812)                            \
               dbg_print("[PhyDM-8812A] ");                                            \
           else if (p_dm->support_ic_type == ODM_RTL8821)                            \
               dbg_print("[PhyDM-8821A] ");                                            \
           else if (p_dm->support_ic_type == ODM_RTL8814A)                            \
               dbg_print("[PhyDM-8814A] ");                                            \
           else if (p_dm->support_ic_type == ODM_RTL8703B)                            \
               dbg_print("[PhyDM-8703B] ");                                            \
           else if (p_dm->support_ic_type == ODM_RTL8822B)                            \
               dbg_print("[PhyDM-8822B] ");                                            \
           else if (p_dm->support_ic_type == ODM_RTL8188F)                            \
               dbg_print("[PhyDM-8188F] ");                                            \
           RT_PRINTK fmt;                                                            \
       }    \
   } while (0)
 
#else
#define PHYDM_DBG(p_dm, comp, fmt)
#define PHYDM_DBG_F(p_dm, comp, fmt)
#define PHYDM_PRINT_ADDR(p_dm, comp, title_str, ptr)
 
#define ODM_RT_TRACE(p_dm, comp, level, fmt)
#endif
 
#define    BB_DBGPORT_PRIORITY_3    3    /*Debug function (the highest priority)*/
#define    BB_DBGPORT_PRIORITY_2    2    /*Check hang function & Strong function*/
#define    BB_DBGPORT_PRIORITY_1    1    /*Watch dog function*/
#define    BB_DBGPORT_RELEASE        0    /*Init value (the lowest priority)*/
 
#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;\
       dbg_print(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;\
       dbg_print(output);\
   } while (0)
 
#if (PHYDM_DBGPRINT == 1)
#define    PHYDM_SNPRINTF(msg)\
   do {\
       snprintf msg;\
       dbg_print(output);\
   } while (0)
#else
#define    PHYDM_SNPRINTF(msg)\
   do {\
       if (out_len > used)\
           used += snprintf msg;\
   } while (0)
#endif
#endif
 
void
phydm_init_debug_setting(
   struct    PHY_DM_STRUCT    *p_dm
);
 
void
phydm_bb_dbg_port_header_sel(
   void        *p_dm_void,
   u32        header_idx
);
 
u8
phydm_set_bb_dbg_port(
   void        *p_dm_void,
   u8        curr_dbg_priority,
   u32        debug_port
);
 
void
phydm_release_bb_dbg_port(
   void        *p_dm_void
);
 
u32
phydm_get_bb_dbg_port_value(
   void        *p_dm_void
);
 
void
phydm_reset_rx_rate_distribution(
   struct PHY_DM_STRUCT    *p_dm_odm
);
 
void
phydm_rx_rate_distribution
(
   void            *p_dm_void
);
 
void
phydm_get_avg_phystatus_val
(
   void        *p_dm_void
);
 
void
phydm_get_phy_statistic(
   void        *p_dm_void
);
 
void 
phydm_basic_dbg_message(
   void        *p_dm_void
);
 
void 
phydm_basic_profile(
   void        *p_dm_void,
   u32        *_used,
   char        *output,
   u32        *_out_len
);
#if (DM_ODM_SUPPORT_TYPE & (ODM_CE | ODM_AP))
s32
phydm_cmd(
   struct PHY_DM_STRUCT    *p_dm,
   char        *input,
   u32        in_len,
   u8        flag,
   char        *output,
   u32        out_len
);
#endif
void
phydm_cmd_parser(
   struct PHY_DM_STRUCT    *p_dm,
   char        input[][16],
   u32        input_num,
   u8        flag,
   char        *output,
   u32        out_len
);
 
#if (DM_ODM_SUPPORT_TYPE == ODM_WIN)
void phydm_sbd_check(
   struct    PHY_DM_STRUCT    *p_dm
);
 
void phydm_sbd_callback(
   struct timer_list        *p_timer
);
 
void phydm_sbd_workitem_callback(
   void    *p_context
);
#endif
 
void
phydm_fw_trace_en_h2c(
   void        *p_dm_void,
   boolean    enable,
   u32        fw_debug_component,
   u32        monitor_mode,
   u32        macid
);
 
void
phydm_fw_trace_handler(
   void    *p_dm_void,
   u8    *cmd_buf,
   u8    cmd_len
);
 
void
phydm_fw_trace_handler_code(
   void    *p_dm_void,
   u8    *buffer,
   u8    cmd_len
);
 
void
phydm_fw_trace_handler_8051(
   void    *p_dm_void,
   u8    *cmd_buf,
   u8    cmd_len
);
 
#endif /* __ODM_DBG_H__ */