1 /*
2  * Copyright (c) 2012 Broadcom Corporation
3  * Copyright (c) 2012 Canonical Ltd.
4  *
5  * Permission to use, copy, modify, and/or distribute this software for any
6  * purpose with or without fee is hereby granted, provided that the above
7  * copyright notice and this permission notice appear in all copies.
8  *
9  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
12  * SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
14  * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
15  * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16  */
17 #ifndef _BRCMS_DEBUG_H_
18 #define _BRCMS_DEBUG_H_
19 
20 #include <linux/device.h>
21 #include <linux/bcma/bcma.h>
22 #include <net/cfg80211.h>
23 #include <net/mac80211.h>
24 #include "main.h"
25 #include "mac80211_if.h"
26 
27 __printf(2, 3)
28 void __brcms_info(struct device *dev, const char *fmt, ...);
29 __printf(2, 3)
30 void __brcms_warn(struct device *dev, const char *fmt, ...);
31 __printf(2, 3)
32 void __brcms_err(struct device *dev, const char *fmt, ...);
33 __printf(2, 3)
34 void __brcms_crit(struct device *dev, const char *fmt, ...);
35 
36 #if defined(CONFIG_BRCMDBG) || defined(CONFIG_BRCM_TRACING)
37 __printf(4, 5)
38 void __brcms_dbg(struct device *dev, u32 level, const char *func,
39 		 const char *fmt, ...);
40 #else
41 static inline __printf(4, 5)
__brcms_dbg(struct device * dev,u32 level,const char * func,const char * fmt,...)42 void __brcms_dbg(struct device *dev, u32 level, const char *func,
43 		 const char *fmt, ...)
44 {
45 }
46 #endif
47 
48 /*
49  * Debug macros cannot be used when wlc is uninitialized. Generally
50  * this means any code that could run before brcms_c_attach() has
51  * returned successfully probably shouldn't use the following macros.
52  */
53 
54 #define brcms_dbg(core, l, f, a...)	__brcms_dbg(&(core)->dev, l, __func__, f, ##a)
55 #define brcms_info(core, f, a...)	__brcms_info(&(core)->dev, f, ##a)
56 #define brcms_warn(core, f, a...)	__brcms_warn(&(core)->dev, f, ##a)
57 #define brcms_err(core, f, a...)	__brcms_err(&(core)->dev, f, ##a)
58 #define brcms_crit(core, f, a...)	__brcms_crit(&(core)->dev, f, ##a)
59 
60 #define brcms_dbg_info(core, f, a...)		brcms_dbg(core, BRCM_DL_INFO, f, ##a)
61 #define brcms_dbg_mac80211(core, f, a...)	brcms_dbg(core, BRCM_DL_MAC80211, f, ##a)
62 #define brcms_dbg_rx(core, f, a...)		brcms_dbg(core, BRCM_DL_RX, f, ##a)
63 #define brcms_dbg_tx(core, f, a...)		brcms_dbg(core, BRCM_DL_TX, f, ##a)
64 #define brcms_dbg_int(core, f, a...)		brcms_dbg(core, BRCM_DL_INT, f, ##a)
65 #define brcms_dbg_dma(core, f, a...)		brcms_dbg(core, BRCM_DL_DMA, f, ##a)
66 #define brcms_dbg_ht(core, f, a...)		brcms_dbg(core, BRCM_DL_HT, f, ##a)
67 
68 struct brcms_pub;
69 void brcms_debugfs_init(void);
70 void brcms_debugfs_exit(void);
71 void brcms_debugfs_attach(struct brcms_pub *drvr);
72 void brcms_debugfs_detach(struct brcms_pub *drvr);
73 struct dentry *brcms_debugfs_get_devdir(struct brcms_pub *drvr);
74 void brcms_debugfs_create_files(struct brcms_pub *drvr);
75 
76 #endif /* _BRCMS_DEBUG_H_ */
77