166 lines · c
1/*2 * Copyright (c) 2007 Bruno Randolf <bruno@thinktube.com>3 *4 * This file is free software: you may copy, redistribute and/or modify it5 * under the terms of the GNU General Public License as published by the6 * Free Software Foundation, either version 2 of the License, or (at your7 * option) any later version.8 *9 * This file is distributed in the hope that it will be useful, but10 * WITHOUT ANY WARRANTY; without even the implied warranty of11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU12 * General Public License for more details.13 *14 * You should have received a copy of the GNU General Public License15 * along with this program. If not, see <http://www.gnu.org/licenses/>.16 *17 *18 * This file incorporates work covered by the following copyright and19 * permission notice:20 *21 * Copyright (c) 2002-2005 Sam Leffler, Errno Consulting22 * Copyright (c) 2004-2005 Atheros Communications, Inc.23 * Copyright (c) 2006 Devicescape Software, Inc.24 * Copyright (c) 2007 Jiri Slaby <jirislaby@gmail.com>25 * Copyright (c) 2007 Luis R. Rodriguez <mcgrof@winlab.rutgers.edu>26 *27 * All rights reserved.28 *29 * Redistribution and use in source and binary forms, with or without30 * modification, are permitted provided that the following conditions31 * are met:32 * 1. Redistributions of source code must retain the above copyright33 * notice, this list of conditions and the following disclaimer,34 * without modification.35 * 2. Redistributions in binary form must reproduce at minimum a disclaimer36 * similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any37 * redistribution must be conditioned upon including a substantially38 * similar Disclaimer requirement for further binary redistribution.39 * 3. Neither the names of the above-listed copyright holders nor the names40 * of any contributors may be used to endorse or promote products derived41 * from this software without specific prior written permission.42 *43 * Alternatively, this software may be distributed under the terms of the44 * GNU General Public License ("GPL") version 2 as published by the Free45 * Software Foundation.46 *47 * NO WARRANTY48 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS49 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT50 * LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY51 * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL52 * THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,53 * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF54 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS55 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER56 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)57 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF58 * THE POSSIBILITY OF SUCH DAMAGES.59 */60 61#ifndef _ATH5K_DEBUG_H62#define _ATH5K_DEBUG_H63 64struct ath5k_hw;65struct sk_buff;66struct ath5k_buf;67 68struct ath5k_dbg_info {69 unsigned int level; /* debug level */70};71 72/**73 * enum ath5k_debug_level - ath5k debug level74 *75 * @ATH5K_DEBUG_RESET: reset processing76 * @ATH5K_DEBUG_INTR: interrupt handling77 * @ATH5K_DEBUG_MODE: mode init/setup78 * @ATH5K_DEBUG_XMIT: basic xmit operation79 * @ATH5K_DEBUG_BEACON: beacon handling80 * @ATH5K_DEBUG_CALIBRATE: periodic calibration81 * @ATH5K_DEBUG_TXPOWER: transmit power setting82 * @ATH5K_DEBUG_LED: led management83 * @ATH5K_DEBUG_DUMP_RX: print received skb content84 * @ATH5K_DEBUG_DUMP_TX: print transmit skb content85 * @ATH5K_DEBUG_DUMPBANDS: dump bands86 * @ATH5K_DEBUG_DMA: debug dma start/stop87 * @ATH5K_DEBUG_TRACE: trace function calls88 * @ATH5K_DEBUG_DESC: descriptor setup89 * @ATH5K_DEBUG_ANY: show at any debug level90 *91 * The debug level is used to control the amount and type of debugging output92 * we want to see. The debug level is given in calls to ATH5K_DBG to specify93 * where the message should appear, and the user can control the debugging94 * messages he wants to see, either by the module parameter 'debug' on module95 * load, or dynamically by using debugfs 'ath5k/phyX/debug'. these levels can96 * be combined together by bitwise OR.97 */98enum ath5k_debug_level {99 ATH5K_DEBUG_RESET = 0x00000001,100 ATH5K_DEBUG_INTR = 0x00000002,101 ATH5K_DEBUG_MODE = 0x00000004,102 ATH5K_DEBUG_XMIT = 0x00000008,103 ATH5K_DEBUG_BEACON = 0x00000010,104 ATH5K_DEBUG_CALIBRATE = 0x00000020,105 ATH5K_DEBUG_TXPOWER = 0x00000040,106 ATH5K_DEBUG_LED = 0x00000080,107 ATH5K_DEBUG_DUMPBANDS = 0x00000400,108 ATH5K_DEBUG_DMA = 0x00000800,109 ATH5K_DEBUG_ANI = 0x00002000,110 ATH5K_DEBUG_DESC = 0x00004000,111 ATH5K_DEBUG_ANY = 0xffffffff112};113 114#ifdef CONFIG_ATH5K_DEBUG115 116#define ATH5K_DBG(_sc, _m, _fmt, ...) do { \117 if (unlikely((_sc)->debug.level & (_m) && net_ratelimit())) \118 ATH5K_PRINTK(_sc, KERN_DEBUG, "(%s:%d): " _fmt, \119 __func__, __LINE__, ##__VA_ARGS__); \120 } while (0)121 122#define ATH5K_DBG_UNLIMIT(_sc, _m, _fmt, ...) do { \123 if (unlikely((_sc)->debug.level & (_m))) \124 ATH5K_PRINTK(_sc, KERN_DEBUG, "(%s:%d): " _fmt, \125 __func__, __LINE__, ##__VA_ARGS__); \126 } while (0)127 128void129ath5k_debug_init_device(struct ath5k_hw *ah);130 131void132ath5k_debug_printrxbuffs(struct ath5k_hw *ah);133 134void135ath5k_debug_dump_bands(struct ath5k_hw *ah);136 137void138ath5k_debug_printtxbuf(struct ath5k_hw *ah, struct ath5k_buf *bf);139 140#else /* no debugging */141 142#include <linux/compiler.h>143 144static inline __printf(3, 4) void145ATH5K_DBG(struct ath5k_hw *ah, unsigned int m, const char *fmt, ...) {}146 147static inline __printf(3, 4) void148ATH5K_DBG_UNLIMIT(struct ath5k_hw *ah, unsigned int m, const char *fmt, ...)149{}150 151static inline void152ath5k_debug_init_device(struct ath5k_hw *ah) {}153 154static inline void155ath5k_debug_printrxbuffs(struct ath5k_hw *ah) {}156 157static inline void158ath5k_debug_dump_bands(struct ath5k_hw *ah) {}159 160static inline void161ath5k_debug_printtxbuf(struct ath5k_hw *ah, struct ath5k_buf *bf) {}162 163#endif /* ifdef CONFIG_ATH5K_DEBUG */164 165#endif /* ifndef _ATH5K_DEBUG_H */166