xref: /freebsd/sys/dev/ath/if_ath_tx_ht.c (revision b2dce55fe9208b062ee3fa1c857cba94248c69dc)
1 /*-
2  * Copyright (c) 2011 Adrian Chadd, Xenion Pty Ltd.
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 
30 #include <sys/cdefs.h>
31 __FBSDID("$FreeBSD$");
32 
33 #include "opt_inet.h"
34 #include "opt_ath.h"
35 #include "opt_wlan.h"
36 
37 #include <sys/param.h>
38 #include <sys/systm.h>
39 #include <sys/sysctl.h>
40 #include <sys/mbuf.h>
41 #include <sys/malloc.h>
42 #include <sys/lock.h>
43 #include <sys/mutex.h>
44 #include <sys/kernel.h>
45 #include <sys/socket.h>
46 #include <sys/sockio.h>
47 #include <sys/errno.h>
48 #include <sys/callout.h>
49 #include <sys/bus.h>
50 #include <sys/endian.h>
51 #include <sys/kthread.h>
52 #include <sys/taskqueue.h>
53 #include <sys/priv.h>
54 
55 #include <machine/bus.h>
56 
57 #include <net/if.h>
58 #include <net/if_dl.h>
59 #include <net/if_media.h>
60 #include <net/if_types.h>
61 #include <net/if_arp.h>
62 #include <net/ethernet.h>
63 #include <net/if_llc.h>
64 
65 #include <net80211/ieee80211_var.h>
66 #include <net80211/ieee80211_regdomain.h>
67 #ifdef IEEE80211_SUPPORT_SUPERG
68 #include <net80211/ieee80211_superg.h>
69 #endif
70 #ifdef IEEE80211_SUPPORT_TDMA
71 #include <net80211/ieee80211_tdma.h>
72 #endif
73 
74 #include <net/bpf.h>
75 
76 #ifdef INET
77 #include <netinet/in.h>
78 #include <netinet/if_ether.h>
79 #endif
80 
81 #include <dev/ath/if_athvar.h>
82 #include <dev/ath/ath_hal/ah_devid.h>		/* XXX for softled */
83 #include <dev/ath/ath_hal/ah_diagcodes.h>
84 
85 #ifdef ATH_TX99_DIAG
86 #include <dev/ath/ath_tx99/ath_tx99.h>
87 #endif
88 
89 #include <dev/ath/if_ath_tx_ht.h>
90 
91 /*
92  * Setup a 11n rate series structure
93  *
94  * This should be called for both legacy and MCS rates.
95  */
96 static void
97 ath_rateseries_setup(struct ath_softc *sc, struct ieee80211_node *ni,
98     HAL_11N_RATE_SERIES *series, unsigned int pktlen, uint8_t *rix,
99     uint8_t *try)
100 {
101 	struct ieee80211com *ic = ni->ni_ic;
102 	struct ath_hal *ah = sc->sc_ah;
103 	HAL_BOOL shortPreamble = AH_FALSE;
104 	const HAL_RATE_TABLE *rt = sc->sc_currates;
105 	int i;
106 	uint8_t txrate;
107 
108 	if ((ic->ic_flags & IEEE80211_F_SHPREAMBLE) &&
109 	    (ni->ni_capinfo & IEEE80211_CAPINFO_SHORT_PREAMBLE))
110 		shortPreamble = AH_TRUE;
111 
112 	memset(series, 0, sizeof(HAL_11N_RATE_SERIES) * 4);
113 	for (i = 0; i < 4;  i++) {
114 		txrate = rt->info[rix[i]].rateCode;
115 		series[i].Tries = try[i];
116 		series[i].ChSel = sc->sc_txchainmask;
117 		if (ic->ic_protmode == IEEE80211_PROT_RTSCTS ||
118 		    ic->ic_protmode == IEEE80211_PROT_CTSONLY)
119 			series[i].RateFlags |= HAL_RATESERIES_RTS_CTS;
120 		if (ni->ni_htcap & IEEE80211_HTCAP_CHWIDTH40)
121 			series[i].RateFlags |= HAL_RATESERIES_2040;
122 		if (ni->ni_htcap & IEEE80211_HTCAP_SHORTGI20 ||
123 		    ni->ni_htcap & IEEE80211_HTCAP_SHORTGI40)
124 			series[i].RateFlags |= HAL_RATESERIES_HALFGI;
125 
126 		/* XXX should this check the short preamble value should be set for legacy rates? -adrian */
127 		series[i].Rate = txrate;
128 
129 		/* PktDuration doesn't include slot, ACK, RTS, etc timing - it's just the packet duration */
130 		if (txrate & IEEE80211_RATE_MCS) {
131 			series[i].PktDuration =
132 			    ath_computedur_ht(pktlen
133 				, txrate
134 				, ic->ic_txstream
135 				, (ni->ni_htcap & IEEE80211_HTCAP_CHWIDTH40)
136 				, series[i].RateFlags & HAL_RATESERIES_HALFGI);
137 		} else {
138 			series[i].PktDuration = ath_hal_computetxtime(ah,
139 			    rt, pktlen, rix[i], shortPreamble);
140 		}
141 	}
142 }
143 
144 #if 0
145 static void
146 ath_rateseries_print(HAL_11N_RATE_SERIES *series)
147 {
148 	int i;
149 	for (i = 0; i < 4; i++) {
150 		printf("series %d: rate %x; tries %d; pktDuration %d; chSel %d; rateFlags %x\n",
151 		    i,
152 		    series[i].Rate,
153 		    series[i].Tries,
154 		    series[i].PktDuration,
155 		    series[i].ChSel,
156 		    series[i].RateFlags);
157 	}
158 }
159 #endif
160 
161 /*
162  * Setup the 11n rate scenario and burst duration for the given TX descriptor
163  * list.
164  *
165  * This isn't useful for sending beacon frames, which has different needs
166  * wrt what's passed into the rate scenario function.
167  */
168 
169 void
170 ath_buf_set_rate(struct ath_softc *sc, struct ieee80211_node *ni, struct ath_buf *bf,
171     int pktlen, int flags, uint8_t ctsrate, int is_pspoll, uint8_t *rix, uint8_t *try)
172 {
173 	HAL_11N_RATE_SERIES series[4];
174 	struct ath_desc *ds = bf->bf_desc;
175 	struct ath_desc *lastds = NULL;
176 	struct ath_hal *ah = sc->sc_ah;
177 
178 	/* Setup rate scenario */
179 	memset(&series, 0, sizeof(series));
180 
181 	ath_rateseries_setup(sc, ni, series, pktlen, rix, try);
182 
183 	/* Enforce AR5416 aggregate limit - can't do RTS w/ an agg frame > 8k */
184 
185 	/* Enforce RTS and CTS are mutually exclusive */
186 
187 	/* Get a pointer to the last tx descriptor in the list */
188 	lastds = &bf->bf_desc[bf->bf_nseg - 1];
189 
190 	/* Set rate scenario */
191 	ath_hal_set11nratescenario(ah, ds,
192 	    !is_pspoll,	/* whether to override the duration or not */
193 			/* don't allow hardware to override the duration on ps-poll packets */
194 	    ctsrate,	/* rts/cts rate */
195 	    series,	/* 11n rate series */
196 	    4,		/* number of series */
197 	    flags);
198 
199 	/* Setup the last descriptor in the chain */
200 	ath_hal_setuplasttxdesc(ah, lastds, ds);
201 
202 	/* Set burst duration */
203 	/* This should only be done if aggregate protection is enabled */
204 	//ath_hal_set11nburstduration(ah, ds, 8192);
205 }
206