2 * Copyright (c) 2013 Qualcomm Atheros, Inc.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted (subject to the limitations in the
7 * disclaimer below) provided that the following conditions are met:
9 * * Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
12 * * Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the
17 * * Neither the name of Qualcomm Atheros nor the names of its
18 * contributors may be used to endorse or promote products derived
19 * from this software without specific prior written permission.
21 * NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE
22 * GRANTED BY THIS LICENSE. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT
23 * HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
24 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
25 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
26 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
27 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
28 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
29 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
30 * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
31 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
32 * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
33 * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
36 #ifndef _DEV_ATH_ATHVAR_H
37 #define _DEV_ATH_ATHVAR_H
40 #include <adf_os_types.h>
41 #include <adf_os_dma.h>
42 #include <adf_os_timer.h>
43 #include <adf_os_lock.h>
44 #include <adf_os_io.h>
45 #include <adf_os_mem.h>
46 #include <adf_os_util.h>
47 #include <adf_os_stdtypes.h>
48 #include <adf_os_defer.h>
49 #include <adf_os_atomic.h>
52 #include <adf_net_types.h>
53 #include <adf_net_wcmd.h>
54 #include <asf_queue.h>
57 #include "ieee80211_var.h"
58 #include "ieee80211_node.h"
59 #include "if_athrate.h"
61 #include <Magpie_api.h>
62 #include <htc_services.h>
67 #define tq_struct adf_os_bh_t
68 #define ATH_INIT_TQUEUE(a,b,c,d) adf_os_init_bh((a),(b),(c),(void *)(d))
69 #define ATH_SCHEDULE_TQUEUE(a,b) adf_os_sched_bh((a),(b))
70 typedef void * TQUEUE_ARG;
72 #define ATH_MIN(a,b) ((a) < (b) ? (a) : (b))
73 #define ATH_AC_2_TXQ(_sc, _ac) (_sc)->sc_ac2q[(_ac)]
74 #define TID_TO_ACTXQ(tidno) sc->sc_ac2q[ TID_TO_WME_AC(tidno)]
76 #define RATE_TABLE_SIZE 32
78 #define INCR(_l, _sz) (_l) ++; (_l) &= ((_sz) - 1)
80 #define IEEE80211_SEQ_MAX 4096
81 #define SEQNO_FROM_BF_SEQNO(_x) (_x >> IEEE80211_SEQ_SEQ_SHIFT)
82 #define BAW_WITHIN(_start, _bawsz, _seqno) \
83 ((((_seqno) - (_start)) & 4095) < (_bawsz))
85 #define __stats(sc, _x) sc->sc_tx_stats._x ++
86 #define __statsn(sc, _x, _n) sc->sc_tx_stats._x += _n
88 #define IS_HT_RATE(_rate) ((_rate) & 0x80)
92 ATH_TGT_AGGR_BAW_CLOSED,
98 #define ATH_BA_ISSET(_bm, _n) (((_n) < (WME_BA_BMP_SIZE)) && \
99 ((_bm)[(_n) >> 5] & (1 << ((_n) & 31))))
101 #define ATH_DS_BA_SEQ(_ds) ((struct ath_tx_desc *)_ds)->ds_us.tx.ts_seqnum
102 #define ATH_DS_BA_BITMAP(_ds) (&((struct ath_tx_desc *)_ds)->ds_us.tx.ba_low)
103 #define ATH_DS_TX_BA(_ds) (((struct ath_tx_desc *)_ds)->ds_us.tx.ts_flags & HAL_TX_BA)
104 #define ATH_DS_TX_STATUS(_ds) ((struct ath_tx_desc *)_ds)->ds_us.tx.ts_status
105 #define ATH_DS_TX_FLAGS(_ds) ((struct ath_tx_desc *)_ds)->ds_us.tx.ts_flags
106 #define ATH_BA_INDEX(_st, _seq) (((_seq) - (_st)) & (IEEE80211_SEQ_MAX - 1))
108 #define ATH_AGGR_DELIM_SZ 4
109 #define ATH_AGGR_MINPLEN 256
110 #define ATH_AGGR_ENCRYPTDELIM 10
112 #define ATH_AGGR_GET_NDELIM(_len) \
113 (((((_len) + ATH_AGGR_DELIM_SZ) < ATH_AGGR_MINPLEN) ? \
114 (ATH_AGGR_MINPLEN - (_len) - ATH_AGGR_DELIM_SZ) : 0) >> 2)
116 #define PADBYTES(_len) ((4 - ((_len) % 4)) % 4)
117 #define OWLMAX_RETRIES 10
118 #define OWLMAX_BAR_RETRIES 10
120 #define ATH_AN_2_TID(_an, _tidno) (&(_an)->tid[(_tidno)])
123 #define ATH_TXMAXTRY 11
124 #define TARGET_NODE_MAX ATH_NODE_MAX
125 #define TARGET_VAP_MAX ATH_VAP_MAX
127 #define MAX_RATE_POWER 63
128 #define ATH_COMP_PROC_NO_COMP_NO_CCS 3
130 #define ATH_BUFSTATUS_DONE 0x00000001 /* hw processing complete, desc processed by hal */
132 #define ATH_AGGR_MIN_QDEPTH 1
134 struct ath_softc_tgt;
138 #define ATH_TXQ(_sc, _qi) (&(_sc)->sc_txq[(_qi)])
139 #define ATH_TXQ_SETUP(sc, i) ((sc)->sc_txqsetup & (1<<i))
141 #define ATH_NODE_TARGET(_n) ((struct ath_node_target *)(_n))
144 * Built-in implementation for skb free.
146 #define ath_free_rx_skb(_sc,_skb) BUF_Pool_free_buf(_sc->pool_handle, POOL_ID_WLAN_RX_BUF, _skb)
147 #define ath_free_tx_skb(_htc_handle, endpt, _skb) HTC_ReturnBuffers(_htc_handle, endpt, _skb);
151 typedef void (*ath_txq_add_fn_t)(struct ath_softc_tgt *sc, struct ath_tx_buf *bf);
152 typedef void (*ath_tx_comp_fn_t)(struct ath_softc_tgt *sc, struct ath_tx_buf *bf);
154 struct ath_buf_state {
155 ath_tx_comp_fn_t bfs_comp; /* completion function */
156 ath_txq_add_fn_t bfs_txq_add; /* txq buffer add function */
157 a_uint16_t bfs_pktlen; /* pktlen including crc */
158 a_uint16_t bfs_seqno; /* sequence nuber */
159 a_uint8_t bfs_hdrlen; /* header length */
160 a_uint8_t bfs_keyix; /* key index */
161 a_uint8_t bfs_atype; /* packet type */
162 a_uint8_t bfs_ndelim; /* # delims for padding */
163 a_uint8_t bfs_nframes; /* # frames in aggregate */
164 a_uint8_t bfs_tidno; /* tid of the buffer */
165 a_uint16_t bfs_al; /* length of aggregate */
166 struct ath_rc_series bfs_rcs[4]; /* rate series */
167 struct ath_txq *bfs_txq; /* transmit h/w queue */
168 a_uint8_t bfs_protmode; /* protection mode */
169 a_uint8_t bfs_keytype; /* encr key type */
170 a_uint8_t bfs_retries; /* current retries */
171 a_uint32_t bfs_ismcast : 1; /* is multicast */
172 a_uint32_t bfs_shpream : 1; /* use short preamble */
173 a_uint32_t bfs_isaggr : 1; /* is an aggregate */
174 a_uint32_t bfs_isretried: 1; /* is retried */
177 #define bf_comp bf_state.bfs_comp
178 #define bf_txq_add bf_state.bfs_txq_add
179 #define bf_pktlen bf_state.bfs_pktlen
180 #define bf_hdrlen bf_state.bfs_hdrlen
181 #define bf_keyix bf_state.bfs_keyix
182 #define bf_atype bf_state.bfs_atype
183 #define bf_seqno bf_state.bfs_seqno
184 #define bf_ndelim bf_state.bfs_ndelim
185 #define bf_nframes bf_state.bfs_nframes
186 #define bf_al bf_state.bfs_al
187 #define bf_tidno bf_state.bfs_tidno
188 #define bf_rcs bf_state.bfs_rcs
189 #define bf_txq bf_state.bfs_txq
190 #define bf_protmode bf_state.bfs_protmode
191 #define bf_keytype bf_state.bfs_keytype
192 #define bf_ismcast bf_state.bfs_ismcast
193 #define bf_shpream bf_state.bfs_shpream
194 #define bf_isaggr bf_state.bfs_isaggr
195 #define bf_isretried bf_state.bfs_isretried
196 #define bf_retries bf_state.bfs_retries
198 #define ATH_GENERIC_BUF \
199 adf_os_dma_map_t bf_dmamap; \
200 adf_os_dmamap_info_t bf_dmamap_info; \
201 struct ieee80211_node_target *bf_node; \
202 adf_nbuf_queue_t bf_skbhead; \
208 asf_tailq_entry(ath_buf) bf_list;
209 struct ath_buf *bf_next;
210 struct ath_desc *bf_lastds;
211 struct ath_desc *bf_desc;
212 struct ath_desc *bf_descarr;
218 asf_tailq_entry(ath_tx_buf) bf_list;
219 struct ath_tx_buf *bf_next;
220 struct ath_tx_desc *bf_desc;
221 struct ath_tx_desc *bf_descarr;
222 struct ath_tx_desc *bf_lastds;
223 struct ath_buf_state bf_state;
225 HTC_ENDPOINT_ID bf_endpt;
233 asf_tailq_entry(ath_rx_buf) bf_list;
234 struct ath_rx_buf *bf_next;
235 struct ath_rx_desc *bf_desc;
236 struct ath_rx_desc *bf_descarr;
237 struct ath_rx_desc *bf_lastds;
238 a_uint32_t bf_status;
239 struct ath_rx_status bf_rx_status;
242 #define ATH_BUF_GET_DESC_PHY_ADDR(bf) (a_uint32_t)bf->bf_desc
243 #define ATH_BUF_GET_DESC_PHY_ADDR_WITH_IDX(bf, idx) (adf_os_dma_addr_t)(&bf->bf_descarr[idx])
244 #define ATH_BUF_SET_DESC_PHY_ADDR(bf, addr)
245 #define ATH_BUF_SET_DESC_PHY_ADDR_WITH_IDX(bf, idx, addr)
247 typedef asf_tailq_head(ath_deschead_s, ath_rx_desc) ath_deschead;
248 typedef asf_tailq_head(ath_bufhead_s, ath_buf) ath_bufhead;
249 typedef asf_tailq_head(ath_rx_bufhead_s, ath_rx_buf) ath_rx_bufhead;
250 typedef asf_tailq_head(ath_tx_bufhead_s, ath_tx_buf) ath_tx_bufhead;
252 #define WME_NUM_TID 8
253 #define WME_BA_BMP_SIZE 64
254 #define WME_MAX_BA WME_BA_BMP_SIZE
255 #define ATH_TID_MAX_BUFS (2 * WME_MAX_BA)
256 #define TID_CLEANUP_INPROGRES 0x1
257 #define TID_AGGR_ENABLED 0x2
258 #define TID_REINITIALIZE 0x4
260 #define TAILQ_DEQ(_q, _elm, _field) do { \
261 (_elm) = asf_tailq_first((_q)); \
263 asf_tailq_remove((_q), (_elm), _field); \
267 #define TX_BUF_BITMAP_SIZE 32
268 #define TX_BUF_BITMAP_SET(bitmap, i) bitmap[i>>5] |= ((a_uint32_t)1 << (i&0x1f))
269 #define TX_BUF_BITMAP_CLR(bitmap, i) bitmap[i>>5] &= (~((a_uint32_t)1 << (i&0x1f)))
270 #define TX_BUF_BITMAP_IS_SET(bitmap, i) ((bitmap[i>>5] & ((a_uint32_t)1 << (i&0x1f))) != 0)
272 typedef struct ath_atx_tid {
274 a_uint16_t seq_start;
279 a_uint32_t tx_buf_bitmap[ATH_TID_MAX_BUFS/TX_BUF_BITMAP_SIZE];
280 asf_tailq_entry(ath_atx_tid) tid_qelem;
281 asf_tailq_head(ath_tid_rbq,ath_tx_buf) buf_q;
286 struct ath_node_target *an;
289 struct ath_node_target {
290 struct ieee80211_node_target ni;
291 struct ath_atx_tid tid[WME_NUM_TID];
297 const a_int8_t *dd_name;
298 struct ath_desc *dd_desc;
299 adf_os_dma_map_t dd_desc_dmamap;
300 adf_os_dma_addr_t dd_desc_paddr;
301 adf_os_size_t dd_desc_len;
302 struct ath_buf *dd_bufptr;
307 a_uint32_t *axq_link;
308 asf_tailq_head(,ath_tx_buf) axq_q;
309 a_uint32_t axq_depth;
310 struct ath_tx_buf *axq_linkbuf;
311 asf_tailq_head(,ath_atx_tid) axq_tidq;
314 struct wmi_rc_rate_mask_cmd {
321 struct ath_vap_target {
322 struct ieee80211vap_target av_vap;
323 struct ath_txq av_mcastq;
324 struct ath_tx_buf *av_bcbuf;
325 a_uint32_t av_rate_mask[2]; /* 0 - 2G, 1 - 5G */
326 a_uint8_t av_minrateidx[2]; /* 0 - 2G, 1 - 5G */
330 #define ATH_RXBUF_RESET(bf) \
335 /* Target-side HTC/HIF/WMI related data structure */
336 pool_handle_t pool_handle;
337 hif_handle_t tgt_hif_handle;
338 htc_handle_t tgt_htc_handle;
339 wmi_handle_t tgt_wmi_handle;
341 /* Target HTC Service IDs */
342 HTC_SERVICE htc_beacon_service;
343 HTC_SERVICE htc_cab_service;
344 HTC_SERVICE htc_uapsd_service;
345 HTC_SERVICE htc_mgmt_service;
346 HTC_SERVICE htc_data_VO_service;
347 HTC_SERVICE htc_data_VI_service;
348 HTC_SERVICE htc_data_BE_service;
349 HTC_SERVICE htc_data_BK_service;
352 /* Target HTC Endpoint IDs */
353 HTC_ENDPOINT_ID wmi_command_ep;
354 HTC_ENDPOINT_ID beacon_ep;
355 HTC_ENDPOINT_ID cab_ep;
356 HTC_ENDPOINT_ID uapsd_ep;
357 HTC_ENDPOINT_ID mgmt_ep;
358 HTC_ENDPOINT_ID data_VO_ep;
359 HTC_ENDPOINT_ID data_VI_ep;
360 HTC_ENDPOINT_ID data_BE_ep;
361 HTC_ENDPOINT_ID data_BK_ep;
363 adf_os_handle_t sc_hdl;
364 adf_os_device_t sc_dev;
366 struct ath_ratectrl *sc_rc;
368 a_uint32_t sc_invalid : 1,
372 a_int32_t sc_rxbufsize;
373 a_uint16_t sc_cachelsz;
375 struct ath_interrupt_stats sc_int_stats;
376 struct ath_tx_stats sc_tx_stats;
377 struct ath_rx_stats sc_rx_stats;
379 const HAL_RATE_TABLE *sc_rates[IEEE80211_MODE_MAX];
380 const HAL_RATE_TABLE *sc_currates;
382 a_uint8_t sc_rixmap[256];
384 enum ieee80211_phymode sc_curmode;
386 a_uint8_t sc_protrix;
390 tq_struct sc_bmisstq;
392 tq_struct sc_fataltq;
394 ath_rx_bufhead sc_rxbuf;
396 ath_deschead sc_rxdesc_idle;
397 ath_deschead sc_rxdesc;
398 struct ath_rx_desc *sc_rxdesc_held;
400 struct ath_tx_buf *sc_txbuf_held;
402 struct ath_descdma sc_rxdma;
403 struct ath_descdma sc_txdma;
404 struct ath_descdma sc_bdma;
406 a_uint32_t *sc_rxlink;
407 ath_tx_bufhead sc_txbuf;
408 a_uint8_t sc_txqsetup;
410 struct ath_txq sc_txq[HAL_NUM_TX_QUEUES];
411 struct ath_txq *sc_ac2q[WME_NUM_AC];
414 struct ath_hal *sc_ah;
415 struct ath_txq *sc_cabq;
416 struct ath_txq *sc_uapsdq;
417 struct ath_node_target sc_sta[TARGET_NODE_MAX];
418 struct ath_vap_target sc_vap[TARGET_VAP_MAX];
419 struct ieee80211com_target sc_ic;
421 ath_tx_bufhead sc_bbuf;
422 a_uint64_t sc_swba_tsf;
424 WMI_TXSTATUS_EVENT tx_status[2];
427 #define SM(_v, _f) (((_v) << _f##_S) & _f)
428 #define MS(_v, _f) (((_v) & _f) >> _f##_S)
430 #define ATH9K_HTC_TXSTAT_ACK 1<<0
431 #define ATH9K_HTC_TXSTAT_FILT 1<<1
432 #define ATH9K_HTC_TXSTAT_RTC_CTS 1<<2
433 #define ATH9K_HTC_TXSTAT_MCS 1<<3
434 #define ATH9K_HTC_TXSTAT_CW40 1<<4
435 #define ATH9K_HTC_TXSTAT_SGI 1<<5
437 #define ATH9K_HTC_TXSTAT_RATE 0x0f
438 #define ATH9K_HTC_TXSTAT_RATE_S 0
439 #define ATH9K_HTC_TXSTAT_EPID 0xf0
440 #define ATH9K_HTC_TXSTAT_EPID_S 4
442 #define TAILQ_INSERTQ_HEAD(head, tq, field) do { \
443 if ((head)->tqh_first) { \
444 *(tq)->tqh_last = (head)->tqh_first; \
445 (head)->tqh_first->field.tqe_prev = (tq)->tqh_last; \
447 (head)->tqh_last = (tq)->tqh_last; \
449 (head)->tqh_first = (tq)->tqh_first; \
450 (tq)->tqh_first->field.tqe_prev = &(head)->tqh_first; \
453 #define ATH_TXQ_INSERT_TAIL(_tq, _elm, _field) do { \
454 asf_tailq_insert_tail( &(_tq)->axq_q, (_elm), _field); \
455 (_tq)->axq_depth++; \
456 (_tq)->axq_linkbuf = (_elm); \
458 #define ATH_TXQ_REMOVE_HEAD(_tq, _elm, _field) do { \
459 asf_tailq_remove(&(_tq)->axq_q, (_elm), _field); \
460 (_tq)->axq_depth--; \
463 struct ieee80211_rate {
464 struct ieee80211_rateset rates;
465 struct ieee80211_rateset htrates;
466 } __attribute__((packed));
468 struct wmi_rc_state_change_cmd {
473 struct ieee80211_rate rs;
474 } __attribute__((packed));
476 struct wmi_rc_rate_update_cmd {
477 a_uint8_t node_index;
481 struct ieee80211_rate rs;
482 } __attribute__((packed));
490 a_uint8_t ath_get_minrateidx(struct ath_softc_tgt *sc, struct ath_vap_target *avp);
492 #define ath_hal_intrset(_ah, _mask) \
493 ((*(_ah)->ah_setInterrupts)((_ah), (_mask)))
494 #define ath_hal_getisr(_ah, _pmask) \
495 ((*(_ah)->ah_getPendingInterrupts)((_ah), (_pmask)))
496 #define ath_hal_setuprxdesc(_ah, _ds, _size, _intreq) \
497 ((*(_ah)->ah_setupRxDesc)((_ah), (_ds), (_size), (_intreq)))
498 #define ath_hal_rxprocdescfast(_ah, _ds, _dspa, _dsnext, _rx_stats) \
499 ((*(_ah)->ah_procRxDescFast)((_ah), (_ds), (_dspa), (_dsnext), (_rx_stats)))
500 #define ath_hal_set11n_txdesc(_ah, _ds, _pktlen, _type, _txpower,\
501 _keyix, _keytype, _flags) \
502 ((*(_ah)->ah_set11nTxDesc)(_ah, _ds, _pktlen, _type, _txpower, _keyix,\
504 #define ath_hal_set11n_ratescenario(_ah, _ds, _durupdate, _rtsctsrate, _rtsctsduration, \
505 _series, _nseries, _flags) \
506 ((*(_ah)->ah_set11nRateScenario)(_ah, _ds, _durupdate, _rtsctsrate, _rtsctsduration,\
507 _series, _nseries, _flags))
508 #define ath_hal_clr11n_aggr(_ah, _ds) \
509 ((*(_ah)->ah_clr11nAggr)(_ah, _ds))
510 #define ath_hal_set11n_burstduration(_ah, _ds, _burstduration) \
511 ((*(_ah)->ah_set11nBurstDuration)(_ah, _ds, _burstduration))
512 #define ath_hal_set11n_virtualmorefrag(_ah, _ds, _vmf) \
513 ((*(_ah)->ah_set11nVirtualMoreFrag)(_ah, _ds, _vmf))
514 #define ath_hal_setuptxdesc(_ah, _ds, _plen, _hlen, _atype, _txpow, \
515 _txr0, _txtr0, _keyix, _ant, _flags, \
516 _rtsrate, _rtsdura, \
517 _compicvlen, _compivlen, _comp) \
518 ((*(_ah)->ah_setupTxDesc)((_ah), (_ds), (_plen), (_hlen), (_atype), \
519 (_txpow), (_txr0), (_txtr0), (_keyix), (_ant), \
520 (_flags), (_rtsrate), (_rtsdura), \
521 (_compicvlen), (_compivlen), (_comp)))
522 #define ath_hal_fillkeytxdesc(_ah, _ds, _keytype) \
523 ((*(_ah)->ah_fillKeyTxDesc)((_ah), (_ds), (_keytype)))
524 #define ath_hal_filltxdesc(_ah, _ds, _l, _first, _last, _ds0) \
525 ((*(_ah)->ah_fillTxDesc)((_ah), (_ds), (_l), (_first), (_last), (_ds0)))
526 #define ath_hal_txprocdesc(_ah, _ds) \
527 ((*(_ah)->ah_procTxDesc)((_ah), (_ds)))
528 #define ath_hal_htsupported(_ah) \
529 (ath_hal_getcapability(_ah, HAL_CAP_HT, 0, NULL) == HAL_OK)
530 #define ath_hal_getrtsaggrlimit(_ah, _pv) \
531 (ath_hal_getcapability(_ah, HAL_CAP_RTS_AGGR_LIMIT, 0, _pv) == HAL_OK)
532 #define ath_hal_intrset(_ah, _mask) \
533 ((*(_ah)->ah_setInterrupts)((_ah), (_mask)))
534 #define ath_hal_set11n_aggr_first(_ah, _ds, _aggrlen, _numdelims) \
535 ((*(_ah)->ah_set11nAggrFirst)(_ah, _ds, _aggrlen, _numdelims))
536 #define ath_hal_set11n_aggr_middle(_ah, _ds, _numdelims) \
537 ((*(_ah)->ah_set11nAggrMiddle)(_ah, _ds, _numdelims))
538 #define ath_hal_set11n_aggr_last(_ah, _ds) \
539 ((*(_ah)->ah_set11nAggrLast)(_ah, _ds))
541 #endif /* _DEV_ATH_ATHVAR_H */