Deleted Added
full compact
if_ath_tx.h (239205) if_ath_tx.h (241170)
1/*-
2 * Copyright (c) 2002-2009 Sam Leffler, Errno Consulting
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer,
10 * without modification.
11 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
12 * similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any
13 * redistribution must be conditioned upon including a substantially
14 * similar Disclaimer requirement for further binary redistribution.
15 *
16 * NO WARRANTY
17 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
18 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
19 * LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
20 * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
21 * THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,
22 * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
24 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
25 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
26 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
27 * THE POSSIBILITY OF SUCH DAMAGES.
28 *
1/*-
2 * Copyright (c) 2002-2009 Sam Leffler, Errno Consulting
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer,
10 * without modification.
11 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
12 * similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any
13 * redistribution must be conditioned upon including a substantially
14 * similar Disclaimer requirement for further binary redistribution.
15 *
16 * NO WARRANTY
17 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
18 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
19 * LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
20 * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
21 * THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,
22 * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
24 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
25 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
26 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
27 * THE POSSIBILITY OF SUCH DAMAGES.
28 *
29 * $FreeBSD: head/sys/dev/ath/if_ath_tx.h 239205 2012-08-12 00:46:15Z adrian $
29 * $FreeBSD: head/sys/dev/ath/if_ath_tx.h 241170 2012-10-03 23:23:45Z adrian $
30 */
31#ifndef __IF_ATH_TX_H__
32#define __IF_ATH_TX_H__
33
34/*
35 * some general macros
36 */
37#define INCR(_l, _sz) (_l) ++; (_l) &= ((_sz) - 1)
38/*
39 * return block-ack bitmap index given sequence and starting sequence
40 */
41#define ATH_BA_INDEX(_st, _seq) (((_seq) - (_st)) & (IEEE80211_SEQ_RANGE - 1))
42
43#define WME_BA_BMP_SIZE 64
44#define WME_MAX_BA WME_BA_BMP_SIZE
45
46/*
47 * How 'busy' to try and keep the hardware txq
48 */
49#define ATH_AGGR_MIN_QDEPTH 2
50
51/*
52 * Watermark for scheduling TIDs in order to maximise aggregation.
53 *
54 * If hwq_depth is greater than this, don't schedule the TID
55 * for packet scheduling - the hardware is already busy servicing
56 * this TID.
57 *
58 * If hwq_depth is less than this, schedule the TID for packet
59 * scheduling in the completion handler.
60 */
61#define ATH_AGGR_SCHED_HIGH 4
62#define ATH_AGGR_SCHED_LOW 2
63
64/*
65 * return whether a bit at index _n in bitmap _bm is set
66 * _sz is the size of the bitmap
67 */
68#define ATH_BA_ISSET(_bm, _n) (((_n) < (WME_BA_BMP_SIZE)) && \
69 ((_bm)[(_n) >> 5] & (1 << ((_n) & 31))))
70
71
72/* extracting the seqno from buffer seqno */
73#define SEQNO(_a) ((_a) >> IEEE80211_SEQ_SEQ_SHIFT)
74
75/*
76 * Whether the current sequence number is within the
77 * BAW.
78 */
79#define BAW_WITHIN(_start, _bawsz, _seqno) \
80 ((((_seqno) - (_start)) & 4095) < (_bawsz))
81
82extern void ath_freetx(struct mbuf *m);
83extern void ath_tx_node_flush(struct ath_softc *sc, struct ath_node *an);
84extern void ath_tx_txq_drain(struct ath_softc *sc, struct ath_txq *txq);
85extern void ath_txfrag_cleanup(struct ath_softc *sc, ath_bufhead *frags,
86 struct ieee80211_node *ni);
87extern int ath_txfrag_setup(struct ath_softc *sc, ath_bufhead *frags,
88 struct mbuf *m0, struct ieee80211_node *ni);
89extern int ath_tx_start(struct ath_softc *sc, struct ieee80211_node *ni,
90 struct ath_buf *bf, struct mbuf *m0);
91extern int ath_raw_xmit(struct ieee80211_node *ni, struct mbuf *m,
92 const struct ieee80211_bpf_params *params);
93
94/* software queue stuff */
95extern void ath_tx_swq(struct ath_softc *sc, struct ieee80211_node *ni,
96 struct ath_txq *txq, struct ath_buf *bf);
97extern void ath_tx_tid_init(struct ath_softc *sc, struct ath_node *an);
98extern void ath_tx_tid_hw_queue_aggr(struct ath_softc *sc, struct ath_node *an,
99 struct ath_tid *tid);
100extern void ath_tx_tid_hw_queue_norm(struct ath_softc *sc, struct ath_node *an,
101 struct ath_tid *tid);
102extern void ath_txq_sched(struct ath_softc *sc, struct ath_txq *txq);
103extern void ath_tx_normal_comp(struct ath_softc *sc, struct ath_buf *bf,
104 int fail);
105extern void ath_tx_aggr_comp(struct ath_softc *sc, struct ath_buf *bf,
106 int fail);
107extern void ath_tx_addto_baw(struct ath_softc *sc, struct ath_node *an,
108 struct ath_tid *tid, struct ath_buf *bf);
109extern struct ieee80211_tx_ampdu * ath_tx_get_tx_tid(struct ath_node *an,
110 int tid);
111
112/* TX addba handling */
113extern int ath_addba_request(struct ieee80211_node *ni,
114 struct ieee80211_tx_ampdu *tap, int dialogtoken,
115 int baparamset, int batimeout);
116extern int ath_addba_response(struct ieee80211_node *ni,
117 struct ieee80211_tx_ampdu *tap, int dialogtoken,
118 int code, int batimeout);
119extern void ath_addba_stop(struct ieee80211_node *ni,
120 struct ieee80211_tx_ampdu *tap);
121extern void ath_bar_response(struct ieee80211_node *ni,
122 struct ieee80211_tx_ampdu *tap, int status);
123extern void ath_addba_response_timeout(struct ieee80211_node *ni,
124 struct ieee80211_tx_ampdu *tap);
125
126/*
30 */
31#ifndef __IF_ATH_TX_H__
32#define __IF_ATH_TX_H__
33
34/*
35 * some general macros
36 */
37#define INCR(_l, _sz) (_l) ++; (_l) &= ((_sz) - 1)
38/*
39 * return block-ack bitmap index given sequence and starting sequence
40 */
41#define ATH_BA_INDEX(_st, _seq) (((_seq) - (_st)) & (IEEE80211_SEQ_RANGE - 1))
42
43#define WME_BA_BMP_SIZE 64
44#define WME_MAX_BA WME_BA_BMP_SIZE
45
46/*
47 * How 'busy' to try and keep the hardware txq
48 */
49#define ATH_AGGR_MIN_QDEPTH 2
50
51/*
52 * Watermark for scheduling TIDs in order to maximise aggregation.
53 *
54 * If hwq_depth is greater than this, don't schedule the TID
55 * for packet scheduling - the hardware is already busy servicing
56 * this TID.
57 *
58 * If hwq_depth is less than this, schedule the TID for packet
59 * scheduling in the completion handler.
60 */
61#define ATH_AGGR_SCHED_HIGH 4
62#define ATH_AGGR_SCHED_LOW 2
63
64/*
65 * return whether a bit at index _n in bitmap _bm is set
66 * _sz is the size of the bitmap
67 */
68#define ATH_BA_ISSET(_bm, _n) (((_n) < (WME_BA_BMP_SIZE)) && \
69 ((_bm)[(_n) >> 5] & (1 << ((_n) & 31))))
70
71
72/* extracting the seqno from buffer seqno */
73#define SEQNO(_a) ((_a) >> IEEE80211_SEQ_SEQ_SHIFT)
74
75/*
76 * Whether the current sequence number is within the
77 * BAW.
78 */
79#define BAW_WITHIN(_start, _bawsz, _seqno) \
80 ((((_seqno) - (_start)) & 4095) < (_bawsz))
81
82extern void ath_freetx(struct mbuf *m);
83extern void ath_tx_node_flush(struct ath_softc *sc, struct ath_node *an);
84extern void ath_tx_txq_drain(struct ath_softc *sc, struct ath_txq *txq);
85extern void ath_txfrag_cleanup(struct ath_softc *sc, ath_bufhead *frags,
86 struct ieee80211_node *ni);
87extern int ath_txfrag_setup(struct ath_softc *sc, ath_bufhead *frags,
88 struct mbuf *m0, struct ieee80211_node *ni);
89extern int ath_tx_start(struct ath_softc *sc, struct ieee80211_node *ni,
90 struct ath_buf *bf, struct mbuf *m0);
91extern int ath_raw_xmit(struct ieee80211_node *ni, struct mbuf *m,
92 const struct ieee80211_bpf_params *params);
93
94/* software queue stuff */
95extern void ath_tx_swq(struct ath_softc *sc, struct ieee80211_node *ni,
96 struct ath_txq *txq, struct ath_buf *bf);
97extern void ath_tx_tid_init(struct ath_softc *sc, struct ath_node *an);
98extern void ath_tx_tid_hw_queue_aggr(struct ath_softc *sc, struct ath_node *an,
99 struct ath_tid *tid);
100extern void ath_tx_tid_hw_queue_norm(struct ath_softc *sc, struct ath_node *an,
101 struct ath_tid *tid);
102extern void ath_txq_sched(struct ath_softc *sc, struct ath_txq *txq);
103extern void ath_tx_normal_comp(struct ath_softc *sc, struct ath_buf *bf,
104 int fail);
105extern void ath_tx_aggr_comp(struct ath_softc *sc, struct ath_buf *bf,
106 int fail);
107extern void ath_tx_addto_baw(struct ath_softc *sc, struct ath_node *an,
108 struct ath_tid *tid, struct ath_buf *bf);
109extern struct ieee80211_tx_ampdu * ath_tx_get_tx_tid(struct ath_node *an,
110 int tid);
111
112/* TX addba handling */
113extern int ath_addba_request(struct ieee80211_node *ni,
114 struct ieee80211_tx_ampdu *tap, int dialogtoken,
115 int baparamset, int batimeout);
116extern int ath_addba_response(struct ieee80211_node *ni,
117 struct ieee80211_tx_ampdu *tap, int dialogtoken,
118 int code, int batimeout);
119extern void ath_addba_stop(struct ieee80211_node *ni,
120 struct ieee80211_tx_ampdu *tap);
121extern void ath_bar_response(struct ieee80211_node *ni,
122 struct ieee80211_tx_ampdu *tap, int status);
123extern void ath_addba_response_timeout(struct ieee80211_node *ni,
124 struct ieee80211_tx_ampdu *tap);
125
126/*
127 * AP mode power save handling (of stations)
128 */
129extern void ath_tx_node_sleep(struct ath_softc *sc, struct ath_node *an);
130extern void ath_tx_node_wakeup(struct ath_softc *sc, struct ath_node *an);
131
132/*
127 * Setup path
128 */
129#define ath_txdma_setup(_sc) \
130 (_sc)->sc_tx.xmit_setup(_sc)
131#define ath_txdma_teardown(_sc) \
132 (_sc)->sc_tx.xmit_teardown(_sc)
133#define ath_txq_restart_dma(_sc, _txq) \
134 (_sc)->sc_tx.xmit_dma_restart((_sc), (_txq))
135#define ath_tx_handoff(_sc, _txq, _bf) \
136 (_sc)->sc_tx.xmit_handoff((_sc), (_txq), (_bf))
137#define ath_draintxq(_sc, _rtype) \
138 (_sc)->sc_tx.xmit_drain((_sc), (_rtype))
139
140extern void ath_xmit_setup_legacy(struct ath_softc *sc);
141
142#endif
133 * Setup path
134 */
135#define ath_txdma_setup(_sc) \
136 (_sc)->sc_tx.xmit_setup(_sc)
137#define ath_txdma_teardown(_sc) \
138 (_sc)->sc_tx.xmit_teardown(_sc)
139#define ath_txq_restart_dma(_sc, _txq) \
140 (_sc)->sc_tx.xmit_dma_restart((_sc), (_txq))
141#define ath_tx_handoff(_sc, _txq, _bf) \
142 (_sc)->sc_tx.xmit_handoff((_sc), (_txq), (_bf))
143#define ath_draintxq(_sc, _rtype) \
144 (_sc)->sc_tx.xmit_drain((_sc), (_rtype))
145
146extern void ath_xmit_setup_legacy(struct ath_softc *sc);
147
148#endif