summaryrefslogtreecommitdiffstats
path: root/drivers/staging/bcm/Debug.h
blob: 7b331215c1acc985c2cbc4fc6e603fe7474e2bdc (plain)
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
/*
 * Debug.h
 *
 * Dynamic (runtime) debug framework implementation.
 * -kaiwan.
 */
#ifndef _DEBUG_H
#define _DEBUG_H
#include <linux/string.h>
#define NONE 0xFFFF

/* TYPE and SUBTYPE
 * Define valid TYPE (or category or code-path, however you like to think of it)
 * and SUBTYPE s.
 * Type and SubType are treated as bitmasks.
 */
#define DBG_TYPE_INITEXIT	(1 << 0)	/* 1 */
#define DBG_TYPE_TX		(1 << 1)	/* 2 */
#define DBG_TYPE_RX		(1 << 2)	/* 4 */
#define DBG_TYPE_OTHERS		(1 << 3)	/* 8 */
#define NUMTYPES		4

/* -SUBTYPEs for TX :  TYPE is DBG_TYPE_TX -----//
 * Transmit.c ,Arp.c, LeakyBucket.c, And Qos.c
 * total 17 macros
 */
/* Transmit.c */
#define TX		1
#define MP_SEND		(TX << 0)
#define NEXT_SEND	(TX << 1)
#define TX_FIFO		(TX << 2)
#define TX_CONTROL	(TX << 3)

/* Arp.c */
#define IP_ADDR		(TX << 4)
#define ARP_REQ		(TX << 5)
#define ARP_RESP	(TX << 6)

/* Leakybucket.c */
#define TOKEN_COUNTS	(TX << 8)
#define CHECK_TOKENS	(TX << 9)
#define TX_PACKETS	(TX << 10)
#define TIMER		(TX << 11)

/* Qos.c */
#define QOS		TX
#define QUEUE_INDEX	(QOS << 12)
#define IPV4_DBG	(QOS << 13)
#define IPV6_DBG	(QOS << 14)
#define PRUNE_QUEUE	(QOS << 15)
#define SEND_QUEUE	(QOS << 16)

/* TX_Misc */
#define TX_OSAL_DBG	(TX << 17)

/* --SUBTYPEs for ------INIT & EXIT---------------------
 * ------------ TYPE is DBG_TYPE_INITEXIT -----//
 * DriverEntry.c, bcmfwup.c, ChipDetectTask.c, HaltnReset.c, InterfaceDDR.c
 */
#define MP		1
#define DRV_ENTRY	(MP << 0)
#define MP_INIT		(MP << 1)
#define READ_REG	(MP << 3)
#define DISPATCH	(MP << 2)
#define CLAIM_ADAP	(MP << 4)
#define REG_IO_PORT	(MP << 5)
#define INIT_DISP	(MP << 6)
#define RX_INIT		(MP << 7)

/* -SUBTYPEs for --RX----------------------------------
 * ------------RX  :  TYPE is DBG_TYPE_RX -----//
 * Receive.c
 */
#define RX		1
#define RX_DPC		(RX << 0)
#define RX_CTRL		(RX << 3)
#define RX_DATA		(RX << 4)
#define MP_RETURN	(RX << 1)
#define LINK_MSG	(RX << 2)

/* -SUBTYPEs for ----OTHER ROUTINES------------------
 * ------------OTHERS  :  TYPE is DBG_TYPE_OTHER -----//
 * HaltnReset,CheckForHang,PnP,Misc,CmHost
 * total 12 macros
 */
#define OTHERS		1
#define ISR		OTHERS
#define MP_DPC		(ISR << 0)

/* HaltnReset.c */
#define HALT		OTHERS
#define MP_HALT		(HALT << 1)
#define CHECK_HANG	(HALT << 2)
#define MP_RESET	(HALT << 3)
#define MP_SHUTDOWN	(HALT << 4)

/* pnp.c */
#define PNP		OTHERS
#define MP_PNP		(PNP << 5)

/* Misc.c */
#define MISC		OTHERS
#define DUMP_INFO	(MISC << 6)
#define CLASSIFY	(MISC << 7)
#define LINK_UP_MSG	(MISC << 8)
#define CP_CTRL_PKT	(MISC << 9)
#define DUMP_CONTROL	(MISC << 10)
#define LED_DUMP_INFO	(MISC << 11)

/* CmHost.c */
#define CMHOST		OTHERS
#define SERIAL		(OTHERS << 12)
#define IDLE_MODE	(OTHERS << 13)
#define WRM		(OTHERS << 14)
#define RDM		(OTHERS << 15)

/* TODO - put PHS_SEND in Tx PHS_RECEIVE in Rx path ? */
#define PHS_SEND	(OTHERS << 16)
#define PHS_RECEIVE	(OTHERS << 17)
#define PHS_MODULE	(OTHERS << 18)

#define INTF_INIT	(OTHERS << 19)
#define INTF_ERR	(OTHERS << 20)
#define INTF_WARN	(OTHERS << 21)
#define INTF_NORM	(OTHERS << 22)

#define IRP_COMPLETION		(OTHERS << 23)
#define SF_DESCRIPTOR_CNTS	(OTHERS << 24)
#define PHS_DISPATCH		(OTHERS << 25)
#define OSAL_DBG		(OTHERS << 26)
#define NVM_RW			(OTHERS << 27)

#define HOST_MIBS	(OTHERS << 28)
#define CONN_MSG	(CMHOST << 29)

/* Debug level
 * We have 8 debug levels, in (numerical) increasing order of verbosity.
 * IMP: Currently implementing ONLY DBG_LVL_ALL , i.e. , all debug prints will
 * appear (of course, iff global debug flag is ON and we match the Type and SubType).
 * Finer granularity debug levels are currently not in use, although the feature exists.
 *
 * Another way to say this:
 * All the debug prints currently have 'debug_level' set to DBG_LVL_ALL .
 * You can compile-time change that to any of the below, if you wish to. However, as of now, there's
 * no dynamic facility to have the userspace 'TestApp' set debug_level. Slated for future expansion.
 */
#define BCM_ALL		7
#define	BCM_LOW		6
#define	BCM_PRINT	5
#define	BCM_NORMAL	4
#define	BCM_MEDIUM	3
#define	BCM_SCREAM	2
#define	BCM_ERR		1
/* Not meant for developer in debug prints.
 * To be used to disable all prints by setting the DBG_LVL_CURR to this value
 */
#define	BCM_NONE	0

/* The current driver logging level.
 * Everything at this level and (numerically) lower (meaning higher prio)
 * is logged.
 * Replace 'BCM_ALL' in the DBG_LVL_CURR macro with the logging level desired.
 * For eg. to set the logging level to 'errors only' use:
 *	 #define DBG_LVL_CURR	(BCM_ERR)
 */

#define DBG_LVL_CURR	(BCM_ALL)
#define DBG_LVL_ALL	BCM_ALL

/* ---Userspace mapping of Debug State.
 * Delibrately matches that of the Windows driver..
 * The TestApp's ioctl passes this struct to us.
 */
struct bcm_user_debug_state {
	unsigned int Subtype, Type;
	unsigned int OnOff;
/*	unsigned int debug_level; future expansion */
} __packed;

/* ---Kernel-space mapping of Debug State */
struct bcm_debug_state {
	unsigned int type;
	/* A bitmap of 32 bits for Subtype per Type.
	 * Valid indexes in 'subtype' array are *only* 1,2,4 and 8,
	 * corresponding to valid Type values. Hence we use the 'Type' field
	 * as the index value, ignoring the array entries 0,3,5,6,7 !
	 */
	unsigned int subtype[(NUMTYPES*2)+1];
	unsigned int debug_level;
};
/* Instantiated in the Adapter structure
 * We'll reuse the debug level parameter to include a bit (the MSB) to indicate whether or not
 * we want the function's name printed.
 */
#define DBG_NO_FUNC_PRINT	(1 << 31)
#define DBG_LVL_BITMASK		0xFF

/* --- Only for direct printk's; "hidden" to API. */
#define DBG_TYPE_PRINTK		3

#define BCM_DEBUG_PRINT(Adapter, Type, SubType, dbg_level, string, args...) \
	do {								\
		if (DBG_TYPE_PRINTK == Type)				\
			pr_info("%s:" string, __func__, ##args);	\
		else if (Adapter &&					\
			(dbg_level & DBG_LVL_BITMASK) <= Adapter->stDebugState.debug_level && \
			(Type & Adapter->stDebugState.type) &&		\
			(SubType & Adapter->stDebugState.subtype[Type])) { \
			if (dbg_level & DBG_NO_FUNC_PRINT)		\
				pr_debug("%s:\n", string);	\
			else						\
				pr_debug("%s:\n" string, __func__, ##args); \
		}							\
	} while (0)

#define BCM_DEBUG_PRINT_BUFFER(Adapter, Type, SubType, dbg_level,  buffer, bufferlen) \
	do {								\
		if (DBG_TYPE_PRINTK == Type ||				\
			(Adapter &&					\
				(dbg_level & DBG_LVL_BITMASK) <= Adapter->stDebugState.debug_level  && \
				(Type & Adapter->stDebugState.type) &&	\
				(SubType & Adapter->stDebugState.subtype[Type]))) { \
			pr_debug("%s:\n", __func__);			\
			print_hex_dump(KERN_DEBUG, " ", DUMP_PREFIX_OFFSET, \
				16, 1, buffer, bufferlen, false);	\
		}							\
	} while (0)

#define BCM_SHOW_DEBUG_BITMAP(Adapter) do {			\
	int i;							\
	for (i = 0; i < (NUMTYPES * 2) + 1; i++) {		\
		if ((i == 1) || (i == 2) || (i == 4) || (i == 8)) {		\
			/* CAUTION! Forcefully turn on ALL debug paths and subpaths! \
			 * Adapter->stDebugState.subtype[i] = 0xffffffff; \
			 */ \
			BCM_DEBUG_PRINT(Adapter, DBG_TYPE_PRINTK, 0, 0, "subtype[%d] = 0x%08x\n",	\
					i, Adapter->stDebugState.subtype[i]); \
		}	\
	}		\
} while (0)

#endif