Home | History | Annotate | Line # | Download | only in ic
athvar.h revision 1.2
      1 /* $NetBSD: athvar.h,v 1.2 2003/10/13 05:23:07 dyoung Exp $ */
      2 /*-
      3  * Copyright (c) 2002, 2003 Sam Leffler, Errno Consulting
      4  * All rights reserved.
      5  *
      6  * Redistribution and use in source and binary forms, with or without
      7  * modification, are permitted provided that the following conditions
      8  * are met:
      9  * 1. Redistributions of source code must retain the above copyright
     10  *    notice, this list of conditions and the following disclaimer,
     11  *    without modification.
     12  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
     13  *    similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any
     14  *    redistribution must be conditioned upon including a substantially
     15  *    similar Disclaimer requirement for further binary redistribution.
     16  * 3. Neither the names of the above-listed copyright holders nor the names
     17  *    of any contributors may be used to endorse or promote products derived
     18  *    from this software without specific prior written permission.
     19  *
     20  * Alternatively, this software may be distributed under the terms of the
     21  * GNU General Public License ("GPL") version 2 as published by the Free
     22  * Software Foundation.
     23  *
     24  * NO WARRANTY
     25  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     26  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     27  * LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
     28  * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
     29  * THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,
     30  * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     31  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     32  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
     33  * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     34  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
     35  * THE POSSIBILITY OF SUCH DAMAGES.
     36  *
     37  * $FreeBSD: src/sys/dev/ath/if_athvar.h,v 1.6 2003/09/05 22:22:49 sam Exp $
     38  */
     39 
     40 /*
     41  * Defintions for the Atheros Wireless LAN controller driver.
     42  */
     43 #ifndef _DEV_ATH_ATHVAR_H
     44 #define _DEV_ATH_ATHVAR_H
     45 
     46 #ifdef __FreeBSD__
     47 #include <sys/taskqueue.h>
     48 
     49 #include <contrib/dev/ic/ah.h>
     50 #else
     51 #include <../contrib/sys/dev/ic/athhal.h>
     52 #endif
     53 #include <net80211/ieee80211_radiotap.h>
     54 #ifdef __FreeBSD__
     55 #include <dev/ath/if_athioctl.h>
     56 #else
     57 #include <dev/ic/athioctl.h>
     58 #endif
     59 
     60 #define	ATH_TIMEOUT		1000
     61 
     62 #define	ATH_RXBUF	40		/* number of RX buffers */
     63 #define	ATH_TXBUF	60		/* number of TX buffers */
     64 #define	ATH_TXDESC	8		/* number of descriptors per buffer */
     65 
     66 /* driver-specific node */
     67 struct ath_node {
     68 	struct ieee80211_node an_node;	/* base class */
     69 	u_int		an_tx_ok;	/* tx ok pkt */
     70 	u_int		an_tx_err;	/* tx !ok pkt */
     71 	u_int		an_tx_retr;	/* tx retry count */
     72 	int		an_tx_upper;	/* tx upper rate req cnt */
     73 	u_int		an_tx_antenna;	/* antenna for last good frame */
     74 	u_int		an_rx_antenna;	/* antenna for last rcvd frame */
     75 };
     76 #define	ATH_NODE(_n)	((struct ath_node *)(_n))
     77 
     78 struct ath_buf {
     79 	TAILQ_ENTRY(ath_buf)	bf_list;
     80 	bus_dmamap_t		bf_dmamap;	/* DMA map of the buffer */
     81 #ifdef __FreeBSD__
     82 	int			bf_nseg;
     83 	bus_dma_segment_t	bf_segs[ATH_MAX_SCATTER];
     84 	bus_size_t		bf_mapsize;
     85 #else
     86 #define bf_nseg		bf_dmamap->dm_nsegs
     87 #define bf_mapsize	bf_dmamap->dm_mapsize
     88 #define bf_segs		bf_dmamap->dm_segs
     89 #endif
     90 	struct ath_desc		*bf_desc;	/* virtual addr of desc */
     91 	bus_addr_t		bf_daddr;	/* physical addr of desc */
     92 	struct mbuf		*bf_m;		/* mbuf for buf */
     93 	struct ieee80211_node	*bf_node;	/* pointer to the node */
     94 #define	ATH_MAX_SCATTER		64
     95 };
     96 
     97 struct ath_softc {
     98 #ifdef __NetBSD__
     99 	struct device		sc_dev;
    100 #endif
    101 	struct ieee80211com	sc_ic;		/* IEEE 802.11 common */
    102 	int			(*sc_newstate)(struct ieee80211com *,
    103 					enum ieee80211_state, int);
    104 #ifdef __FreeBSD__
    105 	device_t		sc_dev;
    106 #endif
    107 	bus_space_tag_t		sc_st;		/* bus space tag */
    108 	bus_space_handle_t	sc_sh;		/* bus space handle */
    109 	bus_dma_tag_t		sc_dmat;	/* bus DMA tag */
    110 #ifdef __FreeBSD__
    111 	struct mtx		sc_mtx;		/* master lock (recursive) */
    112 #endif
    113 	struct ath_hal		*sc_ah;		/* Atheros HAL */
    114 	unsigned int		sc_invalid  : 1,/* disable hardware accesses */
    115 				sc_have11g  : 1,/* have 11g support */
    116 				sc_doani    : 1,/* dynamic noise immunity */
    117 				sc_probing  : 1;/* probing AP on beacon miss */
    118 						/* rate tables */
    119 	const HAL_RATE_TABLE	*sc_rates[IEEE80211_MODE_MAX];
    120 	const HAL_RATE_TABLE	*sc_currates;	/* current rate table */
    121 	enum ieee80211_phymode	sc_curmode;	/* current phy mode */
    122 	u_int8_t		sc_rixmap[256];	/* IEEE to h/w rate table ix */
    123 	u_int8_t		sc_hwmap[32];	/* h/w rate ix to IEEE table */
    124 	HAL_INT			sc_imask;	/* interrupt mask copy */
    125 
    126 #ifdef __FreeBSD__
    127 	struct bpf_if		*sc_drvbpf;
    128 #else
    129 	caddr_t			sc_drvbpf;
    130 #endif
    131 	union {
    132 		struct ath_tx_radiotap_header th;
    133 		u_int8_t	pad[64];
    134 	} u_tx_rt;
    135 	union {
    136 		struct ath_rx_radiotap_header th;
    137 		u_int8_t	pad[64];
    138 	} u_rx_rt;
    139 
    140 	struct ath_desc		*sc_desc;	/* TX/RX descriptors */
    141 	bus_dma_segment_t	sc_dseg;
    142 #ifdef __NetBSD__
    143 	int			sc_dnseg;	/* number of segments */
    144 #endif
    145 	bus_dmamap_t		sc_ddmamap;	/* DMA map for descriptors */
    146 	bus_addr_t		sc_desc_paddr;	/* physical addr of sc_desc */
    147 	bus_addr_t		sc_desc_len;	/* size of sc_desc */
    148 
    149 	ath_task_t		sc_fataltask;	/* fatal int processing */
    150 	ath_task_t		sc_rxorntask;	/* rxorn int processing */
    151 
    152 	TAILQ_HEAD(, ath_buf)	sc_rxbuf;	/* receive buffer */
    153 	u_int32_t		*sc_rxlink;	/* link ptr in last RX desc */
    154 	ath_task_t		sc_rxtask;	/* rx int processing */
    155 
    156 	u_int			sc_txhalq;	/* HAL q for outgoing frames */
    157 	u_int32_t		*sc_txlink;	/* link ptr in last TX desc */
    158 	int			sc_tx_timer;	/* transmit timeout */
    159 	TAILQ_HEAD(, ath_buf)	sc_txbuf;	/* transmit buffer */
    160 #ifdef __FreeBSD__
    161 	struct mtx		sc_txbuflock;	/* txbuf lock */
    162 #endif
    163 	TAILQ_HEAD(, ath_buf)	sc_txq;		/* transmitting queue */
    164 #ifdef __FreeBSD__
    165 	struct mtx		sc_txqlock;	/* lock on txq and txlink */
    166 #endif
    167 	ath_task_t		sc_txtask;	/* tx int processing */
    168 
    169 	u_int			sc_bhalq;	/* HAL q for outgoing beacons */
    170 	struct ath_buf		*sc_bcbuf;	/* beacon buffer */
    171 	struct ath_buf		*sc_bufptr;	/* allocated buffer ptr */
    172 	ath_task_t		sc_swbatask;	/* swba int processing */
    173 	ath_task_t		sc_bmisstask;	/* bmiss int processing */
    174 
    175 	struct callout		sc_cal_ch;	/* callout handle for cals */
    176 	struct callout		sc_scan_ch;	/* callout handle for scan */
    177 	struct ath_stats	sc_stats;	/* interface statistics */
    178 };
    179 #define	sc_tx_th		u_tx_rt.th
    180 #define	sc_rx_th		u_rx_rt.th
    181 
    182 int	ath_attach(u_int16_t, struct ath_softc *);
    183 int	ath_detach(struct ath_softc *);
    184 void	ath_resume(struct ath_softc *);
    185 void	ath_suspend(struct ath_softc *);
    186 void	ath_shutdown(struct ath_softc *);
    187 #ifdef __FreeBSD__
    188 void	ath_intr(void *);
    189 #else
    190 int	ath_intr(void *);
    191 #endif
    192 
    193 /*
    194  * HAL definitions to comply with local coding convention.
    195  */
    196 #define	ath_hal_reset(_ah, _opmode, _chan, _outdoor, _pstatus) \
    197 	((*(_ah)->ah_reset)((_ah), (_opmode), (_chan), (_outdoor), (_pstatus)))
    198 #define	ath_hal_getratetable(_ah, _mode) \
    199 	((*(_ah)->ah_getRateTable)((_ah), (_mode)))
    200 #define	ath_hal_getregdomain(_ah) \
    201 	((*(_ah)->ah_getRegDomain)((_ah)))
    202 #define	ath_hal_getcountrycode(_ah)	(_ah)->ah_countryCode
    203 #define	ath_hal_getmac(_ah, _mac) \
    204 	((*(_ah)->ah_getMacAddress)((_ah), (_mac)))
    205 #define	ath_hal_detach(_ah) \
    206 	((*(_ah)->ah_detach)((_ah)))
    207 #define	ath_hal_intrset(_ah, _mask) \
    208 	((*(_ah)->ah_setInterrupts)((_ah), (_mask)))
    209 #define	ath_hal_intrget(_ah) \
    210 	((*(_ah)->ah_getInterrupts)((_ah)))
    211 #define	ath_hal_intrpend(_ah) \
    212 	((*(_ah)->ah_isInterruptPending)((_ah)))
    213 #define	ath_hal_getisr(_ah, _pmask) \
    214 	((*(_ah)->ah_getPendingInterrupts)((_ah), (_pmask)))
    215 #define	ath_hal_updatetxtriglevel(_ah, _inc) \
    216 	((*(_ah)->ah_updateTxTrigLevel)((_ah), (_inc)))
    217 #define	ath_hal_setpower(_ah, _mode, _sleepduration) \
    218 	((*(_ah)->ah_setPowerMode)((_ah), (_mode), AH_TRUE, (_sleepduration)))
    219 #define	ath_hal_keyreset(_ah, _ix) \
    220 	((*(_ah)->ah_resetKeyCacheEntry)((_ah), (_ix)))
    221 #define	ath_hal_keyset(_ah, _ix, _pk) \
    222 	((*(_ah)->ah_setKeyCacheEntry)((_ah), (_ix), (_pk), NULL, AH_FALSE))
    223 #define	ath_hal_keyisvalid(_ah, _ix) \
    224 	(((*(_ah)->ah_isKeyCacheEntryValid)((_ah), (_ix))))
    225 #define	ath_hal_keysetmac(_ah, _ix, _mac) \
    226 	((*(_ah)->ah_setKeyCacheEntryMac)((_ah), (_ix), (_mac)))
    227 #define	ath_hal_getrxfilter(_ah) \
    228 	((*(_ah)->ah_getRxFilter)((_ah)))
    229 #define	ath_hal_setrxfilter(_ah, _filter) \
    230 	((*(_ah)->ah_setRxFilter)((_ah), (_filter)))
    231 #define	ath_hal_setmcastfilter(_ah, _mfilt0, _mfilt1) \
    232 	((*(_ah)->ah_setMulticastFilter)((_ah), (_mfilt0), (_mfilt1)))
    233 #define	ath_hal_waitforbeacon(_ah, _bf) \
    234 	((*(_ah)->ah_waitForBeaconDone)((_ah), (_bf)->bf_daddr))
    235 #define	ath_hal_putrxbuf(_ah, _bufaddr) \
    236 	((*(_ah)->ah_setRxDP)((_ah), (_bufaddr)))
    237 #define	ath_hal_gettsf32(_ah) \
    238 	((*(_ah)->ah_getTsf32)((_ah)))
    239 #define	ath_hal_gettsf64(_ah) \
    240 	((*(_ah)->ah_getTsf64)((_ah)))
    241 #define	ath_hal_resettsf(_ah) \
    242 	((*(_ah)->ah_resetTsf)((_ah)))
    243 #define	ath_hal_rxena(_ah) \
    244 	((*(_ah)->ah_enableReceive)((_ah)))
    245 #define	ath_hal_puttxbuf(_ah, _q, _bufaddr) \
    246 	((*(_ah)->ah_setTxDP)((_ah), (_q), (_bufaddr)))
    247 #define	ath_hal_gettxbuf(_ah, _q) \
    248 	((*(_ah)->ah_getTxDP)((_ah), (_q)))
    249 #define	ath_hal_getrxbuf(_ah) \
    250 	((*(_ah)->ah_getRxDP)((_ah)))
    251 #define	ath_hal_txstart(_ah, _q) \
    252 	((*(_ah)->ah_startTxDma)((_ah), (_q)))
    253 #define	ath_hal_setchannel(_ah, _chan) \
    254 	((*(_ah)->ah_setChannel)((_ah), (_chan)))
    255 #define	ath_hal_calibrate(_ah, _chan) \
    256 	((*(_ah)->ah_perCalibration)((_ah), (_chan)))
    257 #define	ath_hal_setledstate(_ah, _state) \
    258 	((*(_ah)->ah_setLedState)((_ah), (_state)))
    259 #define	ath_hal_beaconinit(_ah, _opmode, _nextb, _bperiod) \
    260 	((*(_ah)->ah_beaconInit)((_ah), (_opmode), (_nextb), (_bperiod)))
    261 #define	ath_hal_beaconreset(_ah) \
    262 	((*(_ah)->ah_resetStationBeaconTimers)((_ah)))
    263 #define	ath_hal_beacontimers(_ah, _bs, _tsf, _dc, _cc) \
    264 	((*(_ah)->ah_setStationBeaconTimers)((_ah), (_bs), (_tsf), \
    265 		(_dc), (_cc)))
    266 #define	ath_hal_setassocid(_ah, _bss, _associd) \
    267 	((*(_ah)->ah_writeAssocid)((_ah), (_bss), (_associd), 0))
    268 #define	ath_hal_setopmode(_ah, _opmode) \
    269 	((*(_ah)->ah_setPCUConfig)((_ah), (_opmode)))
    270 #define	ath_hal_stoptxdma(_ah, _qnum) \
    271 	((*(_ah)->ah_stopTxDma)((_ah), (_qnum)))
    272 #define	ath_hal_stoppcurecv(_ah) \
    273 	((*(_ah)->ah_stopPcuReceive)((_ah)))
    274 #define	ath_hal_startpcurecv(_ah) \
    275 	((*(_ah)->ah_startPcuReceive)((_ah)))
    276 #define	ath_hal_stopdmarecv(_ah) \
    277 	((*(_ah)->ah_stopDmaReceive)((_ah)))
    278 #define	ath_hal_dumpstate(_ah) \
    279 	((*(_ah)->ah_dumpState)((_ah)))
    280 #define	ath_hal_dumpeeprom(_ah) \
    281 	((*(_ah)->ah_dumpEeprom)((_ah)))
    282 #define	ath_hal_dumprfgain(_ah) \
    283 	((*(_ah)->ah_dumpRfGain)((_ah)))
    284 #define	ath_hal_dumpani(_ah) \
    285 	((*(_ah)->ah_dumpAni)((_ah)))
    286 #define	ath_hal_setuptxqueue(_ah, _type, _irq) \
    287 	((*(_ah)->ah_setupTxQueue)((_ah), (_type), (_irq)))
    288 #define	ath_hal_resettxqueue(_ah, _q) \
    289 	((*(_ah)->ah_resetTxQueue)((_ah), (_q)))
    290 #define	ath_hal_releasetxqueue(_ah, _q) \
    291 	((*(_ah)->ah_releaseTxQueue)((_ah), (_q)))
    292 #define	ath_hal_hasveol(_ah) \
    293 	((*(_ah)->ah_hasVEOL)((_ah)))
    294 #define	ath_hal_getrfgain(_ah) \
    295 	((*(_ah)->ah_getRfGain)((_ah)))
    296 #define	ath_hal_rxmonitor(_ah) \
    297 	((*(_ah)->ah_rxMonitor)((_ah)))
    298 
    299 #define	ath_hal_setupbeacondesc(_ah, _ds, _opmode, _flen, _hlen, \
    300 		_rate, _antmode) \
    301 	((*(_ah)->ah_setupBeaconDesc)((_ah), (_ds), (_opmode), \
    302 		(_flen), (_hlen), (_rate), (_antmode)))
    303 #define	ath_hal_setuprxdesc(_ah, _ds, _size, _intreq) \
    304 	((*(_ah)->ah_setupRxDesc)((_ah), (_ds), (_size), (_intreq)))
    305 #define	ath_hal_rxprocdesc(_ah, _ds) \
    306 	((*(_ah)->ah_procRxDesc)((_ah), (_ds)))
    307 #define	ath_hal_setuptxdesc(_ah, _ds, _plen, _hlen, _atype, _txpow, \
    308 		_txr0, _txtr0, _keyix, _ant, _flags, \
    309 		_rtsrate, _rtsdura) \
    310 	((*(_ah)->ah_setupTxDesc)((_ah), (_ds), (_plen), (_hlen), (_atype), \
    311 		(_txpow), (_txr0), (_txtr0), (_keyix), (_ant), \
    312 		(_flags), (_rtsrate), (_rtsdura)))
    313 #define	ath_hal_setupxtxdesc(_ah, _ds, _short, \
    314 		_txr1, _txtr1, _txr2, _txtr2, _txr3, _txtr3) \
    315 	((*(_ah)->ah_setupXTxDesc)((_ah), (_ds), (_short), \
    316 		(_txr1), (_txtr1), (_txr2), (_txtr2), (_txr3), (_txtr3)))
    317 #define	ath_hal_filltxdesc(_ah, _ds, _l, _first, _last) \
    318 	((*(_ah)->ah_fillTxDesc)((_ah), (_ds), (_l), (_first), (_last)))
    319 #define	ath_hal_txprocdesc(_ah, _ds) \
    320 	((*(_ah)->ah_procTxDesc)((_ah), (_ds)))
    321 
    322 #endif /* _DEV_ATH_ATHVAR_H */
    323