1 /* $OpenBSD: if_iwm.c,v 1.39 2015/03/23 00:35:19 jsg Exp $ */
4 * Copyright (c) 2014 genua mbh <info@genua.de>
5 * Copyright (c) 2014 Fixup Software Ltd.
7 * Permission to use, copy, modify, and distribute this software for any
8 * purpose with or without fee is hereby granted, provided that the above
9 * copyright notice and this permission notice appear in all copies.
11 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
12 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
13 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
14 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
15 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
16 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
17 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
21 * Based on BSD-licensed source modules in the Linux iwlwifi driver,
22 * which were used as the reference documentation for this implementation.
24 * Driver version we are currently based off of is
25 * Linux 3.14.3 (tag id a2df521e42b1d9a23f620ac79dbfe8655a8391dd)
27 ***********************************************************************
29 * This file is provided under a dual BSD/GPLv2 license. When using or
30 * redistributing this file, you may do so under either license.
34 * Copyright(c) 2007 - 2013 Intel Corporation. All rights reserved.
36 * This program is free software; you can redistribute it and/or modify
37 * it under the terms of version 2 of the GNU General Public License as
38 * published by the Free Software Foundation.
40 * This program is distributed in the hope that it will be useful, but
41 * WITHOUT ANY WARRANTY; without even the implied warranty of
42 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
43 * General Public License for more details.
45 * You should have received a copy of the GNU General Public License
46 * along with this program; if not, write to the Free Software
47 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110,
50 * The full GNU General Public License is included in this distribution
51 * in the file called COPYING.
53 * Contact Information:
54 * Intel Linux Wireless <ilw@linux.intel.com>
55 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
60 * Copyright(c) 2005 - 2013 Intel Corporation. All rights reserved.
61 * All rights reserved.
63 * Redistribution and use in source and binary forms, with or without
64 * modification, are permitted provided that the following conditions
67 * * Redistributions of source code must retain the above copyright
68 * notice, this list of conditions and the following disclaimer.
69 * * Redistributions in binary form must reproduce the above copyright
70 * notice, this list of conditions and the following disclaimer in
71 * the documentation and/or other materials provided with the
73 * * Neither the name Intel Corporation nor the names of its
74 * contributors may be used to endorse or promote products derived
75 * from this software without specific prior written permission.
77 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
78 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
79 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
80 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
81 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
82 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
83 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
84 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
85 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
86 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
87 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
91 * Copyright (c) 2007-2010 Damien Bergamini <damien.bergamini@free.fr>
93 * Permission to use, copy, modify, and distribute this software for any
94 * purpose with or without fee is hereby granted, provided that the above
95 * copyright notice and this permission notice appear in all copies.
97 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
98 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
99 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
100 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
101 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
102 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
103 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
105 #include <sys/cdefs.h>
106 __FBSDID("$FreeBSD$");
108 #include "opt_wlan.h"
110 #include <sys/param.h>
112 #include <sys/conf.h>
113 #include <sys/endian.h>
114 #include <sys/firmware.h>
115 #include <sys/kernel.h>
116 #include <sys/malloc.h>
117 #include <sys/mbuf.h>
118 #include <sys/mutex.h>
119 #include <sys/module.h>
120 #include <sys/proc.h>
121 #include <sys/rman.h>
122 #include <sys/socket.h>
123 #include <sys/sockio.h>
124 #include <sys/sysctl.h>
125 #include <sys/linker.h>
127 #include <machine/bus.h>
128 #include <machine/endian.h>
129 #include <machine/resource.h>
131 #include <dev/pci/pcivar.h>
132 #include <dev/pci/pcireg.h>
137 #include <net/if_var.h>
138 #include <net/if_arp.h>
139 #include <net/if_dl.h>
140 #include <net/if_media.h>
141 #include <net/if_types.h>
143 #include <netinet/in.h>
144 #include <netinet/in_systm.h>
145 #include <netinet/if_ether.h>
146 #include <netinet/ip.h>
148 #include <net80211/ieee80211_var.h>
149 #include <net80211/ieee80211_regdomain.h>
150 #include <net80211/ieee80211_ratectl.h>
151 #include <net80211/ieee80211_radiotap.h>
153 #include <dev/iwm/if_iwmreg.h>
154 #include <dev/iwm/if_iwmvar.h>
155 #include <dev/iwm/if_iwm_debug.h>
156 #include <dev/iwm/if_iwm_util.h>
157 #include <dev/iwm/if_iwm_mac_ctxt.h>
160 * BEGIN mvm/mac-ctxt.c
164 iwm_mvm_ack_rates(struct iwm_softc *sc, int is2ghz,
165 int *cck_rates, int *ofdm_rates, struct iwm_node *in)
167 int lowest_present_ofdm = 100;
168 int lowest_present_cck = 100;
172 struct ieee80211_rateset *rs = &in->in_ni.ni_rates;
175 for (i = IWM_FIRST_CCK_RATE; i <= IWM_LAST_CCK_RATE; i++) {
176 if ((iwm_ridx2rate(rs, i) & IEEE80211_RATE_BASIC) == 0)
179 if (lowest_present_cck > i)
180 lowest_present_cck = i;
183 for (i = IWM_FIRST_OFDM_RATE; i <= IWM_LAST_NON_HT_RATE; i++) {
184 if ((iwm_ridx2rate(rs, i) & IEEE80211_RATE_BASIC) == 0)
186 ofdm |= (1 << (i - IWM_FIRST_OFDM_RATE));
187 if (lowest_present_ofdm > i)
188 lowest_present_ofdm = i;
192 * Now we've got the basic rates as bitmaps in the ofdm and cck
193 * variables. This isn't sufficient though, as there might not
194 * be all the right rates in the bitmap. E.g. if the only basic
195 * rates are 5.5 Mbps and 11 Mbps, we still need to add 1 Mbps
196 * and 6 Mbps because the 802.11-2007 standard says in 9.6:
198 * [...] a STA responding to a received frame shall transmit
199 * its Control Response frame [...] at the highest rate in the
200 * BSSBasicRateSet parameter that is less than or equal to the
201 * rate of the immediately previous frame in the frame exchange
202 * sequence ([...]) and that is of the same modulation class
203 * ([...]) as the received frame. If no rate contained in the
204 * BSSBasicRateSet parameter meets these conditions, then the
205 * control frame sent in response to a received frame shall be
206 * transmitted at the highest mandatory rate of the PHY that is
207 * less than or equal to the rate of the received frame, and
208 * that is of the same modulation class as the received frame.
210 * As a consequence, we need to add all mandatory rates that are
211 * lower than all of the basic rates to these bitmaps.
214 if (IWM_RATE_24M_INDEX < lowest_present_ofdm)
215 ofdm |= IWM_RATE_BIT_MSK(24) >> IWM_FIRST_OFDM_RATE;
216 if (IWM_RATE_12M_INDEX < lowest_present_ofdm)
217 ofdm |= IWM_RATE_BIT_MSK(12) >> IWM_FIRST_OFDM_RATE;
218 /* 6M already there or needed so always add */
219 ofdm |= IWM_RATE_BIT_MSK(6) >> IWM_FIRST_OFDM_RATE;
222 * CCK is a bit more complex with DSSS vs. HR/DSSS vs. ERP.
224 * - if no CCK rates are basic, it must be ERP since there must
225 * be some basic rates at all, so they're OFDM => ERP PHY
226 * (or we're in 5 GHz, and the cck bitmap will never be used)
227 * - if 11M is a basic rate, it must be ERP as well, so add 5.5M
228 * - if 5.5M is basic, 1M and 2M are mandatory
229 * - if 2M is basic, 1M is mandatory
230 * - if 1M is basic, that's the only valid ACK rate.
231 * As a consequence, it's not as complicated as it sounds, just add
232 * any lower rates to the ACK rate bitmap.
234 if (IWM_RATE_11M_INDEX < lowest_present_cck)
235 cck |= IWM_RATE_BIT_MSK(11) >> IWM_FIRST_CCK_RATE;
236 if (IWM_RATE_5M_INDEX < lowest_present_cck)
237 cck |= IWM_RATE_BIT_MSK(5) >> IWM_FIRST_CCK_RATE;
238 if (IWM_RATE_2M_INDEX < lowest_present_cck)
239 cck |= IWM_RATE_BIT_MSK(2) >> IWM_FIRST_CCK_RATE;
240 /* 1M already there or needed so always add */
241 cck |= IWM_RATE_BIT_MSK(1) >> IWM_FIRST_CCK_RATE;
248 iwm_mvm_mac_ctxt_cmd_common(struct iwm_softc *sc, struct iwm_node *in,
249 struct iwm_mac_ctx_cmd *cmd, uint32_t action)
251 struct ieee80211com *ic = &sc->sc_ic;
252 struct ieee80211vap *vap = TAILQ_FIRST(&ic->ic_vaps);
253 struct ieee80211_node *ni = vap->iv_bss;
254 int cck_ack_rates, ofdm_ack_rates;
259 * id is the MAC address ID - something to do with MAC filtering.
262 * These are both functions of the vap, not of the node.
263 * So, for now, hard-code both to 0 (default).
265 cmd->id_and_color = htole32(IWM_FW_CMD_ID_AND_COLOR(IWM_DEFAULT_MACID,
267 cmd->action = htole32(action);
269 cmd->mac_type = htole32(IWM_FW_MAC_TYPE_BSS_STA);
272 * The TSF ID is one of four TSF tracking resources in the firmware.
273 * Read the iwlwifi/mvm code for more details.
275 * For now, just hard-code it to TSF tracking ID 0; we only support
276 * a single STA mode VAP.
278 * It's per-vap, not per-node.
280 cmd->tsf_id = htole32(IWM_DEFAULT_TSFID);
282 IEEE80211_ADDR_COPY(cmd->node_addr, vap->iv_myaddr);
285 * XXX should we error out if in_assoc is 1 and ni == NULL?
289 IEEE80211_ADDR_COPY(cmd->bssid_addr, ni->ni_bssid);
291 /* eth broadcast address */
292 IEEE80211_ADDR_COPY(cmd->bssid_addr, ieee80211broadcastaddr);
296 * XXX This workaround makes the firmware behave more correctly once
297 * we are associated, regularly giving us statistics notifications,
298 * as well as signaling missed beacons to us.
299 * Since we only call iwm_mvm_mac_ctxt_add() and
300 * iwm_mvm_mac_ctxt_changed() when already authenticating or
301 * associating, ni->ni_bssid should always make sense here.
303 IEEE80211_ADDR_COPY(cmd->bssid_addr, ni->ni_bssid);
307 * Default to 2ghz if no node information is given.
310 is2ghz = !! IEEE80211_IS_CHAN_2GHZ(in->in_ni.ni_chan);
314 iwm_mvm_ack_rates(sc, is2ghz, &cck_ack_rates, &ofdm_ack_rates, in);
315 cmd->cck_rates = htole32(cck_ack_rates);
316 cmd->ofdm_rates = htole32(ofdm_ack_rates);
318 cmd->cck_short_preamble
319 = htole32((ic->ic_flags & IEEE80211_F_SHPREAMBLE)
320 ? IWM_MAC_FLG_SHORT_PREAMBLE : 0);
322 = htole32((ic->ic_flags & IEEE80211_F_SHSLOT)
323 ? IWM_MAC_FLG_SHORT_SLOT : 0);
326 * XXX TODO: if we're doing QOS..
327 * cmd->qos_flags |= cpu_to_le32(MAC_QOS_FLG_UPDATE_EDCA)
330 /* XXX TODO: set wme parameters; also handle getting updated wme parameters */
331 for (i = 0; i < IWM_AC_NUM+1; i++) {
334 cmd->ac[txf].cw_min = htole16(0x0f);
335 cmd->ac[txf].cw_max = htole16(0x3f);
336 cmd->ac[txf].aifsn = 1;
337 cmd->ac[txf].fifos_mask = (1 << txf);
338 cmd->ac[txf].edca_txop = 0;
341 if (ic->ic_flags & IEEE80211_F_USEPROT)
342 cmd->protection_flags |= htole32(IWM_MAC_PROT_FLG_TGG_PROTECT);
344 cmd->filter_flags = htole32(IWM_MAC_FILTER_ACCEPT_GRP);
348 iwm_mvm_mac_ctxt_send_cmd(struct iwm_softc *sc, struct iwm_mac_ctx_cmd *cmd)
350 int ret = iwm_mvm_send_cmd_pdu(sc, IWM_MAC_CONTEXT_CMD, IWM_CMD_SYNC,
353 device_printf(sc->sc_dev,
354 "%s: Failed to send MAC context (action:%d): %d\n",
355 __func__, le32toh(cmd->action), ret);
360 * Fill the specific data for mac context of type station or p2p client
363 iwm_mvm_mac_ctxt_cmd_fill_sta(struct iwm_softc *sc, struct iwm_node *in,
364 struct iwm_mac_data_sta *ctxt_sta, int force_assoc_off)
366 struct ieee80211_node *ni = &in->in_ni;
367 unsigned dtim_period, dtim_count;
368 struct ieee80211com *ic = &sc->sc_ic;
369 struct ieee80211vap *vap = TAILQ_FIRST(&ic->ic_vaps);
371 /* will this work? */
372 dtim_period = vap->iv_dtim_period;
373 dtim_count = vap->iv_dtim_count;
374 IWM_DPRINTF(sc, IWM_DEBUG_RESET | IWM_DEBUG_BEACON | IWM_DEBUG_CMD,
375 "%s: force_assoc_off=%d\n", __func__, force_assoc_off);
376 IWM_DPRINTF(sc, IWM_DEBUG_RESET | IWM_DEBUG_BEACON | IWM_DEBUG_CMD,
377 "DTIM: period=%d count=%d\n", dtim_period, dtim_count);
378 IWM_DPRINTF(sc, IWM_DEBUG_RESET | IWM_DEBUG_BEACON | IWM_DEBUG_CMD,
379 "BEACON: tsf: %llu, ni_intval=%d\n",
380 (unsigned long long) le64toh(ni->ni_tstamp.tsf),
383 /* We need the dtim_period to set the MAC as associated */
384 if (in->in_assoc && dtim_period && !force_assoc_off) {
389 * The DTIM count counts down, so when it is N that means N
390 * more beacon intervals happen until the DTIM TBTT. Therefore
391 * add this to the current time. If that ends up being in the
392 * future, the firmware will handle it.
394 * Also note that the system_timestamp (which we get here as
395 * "sync_device_ts") and TSF timestamp aren't at exactly the
396 * same offset in the frame -- the TSF is at the first symbol
397 * of the TSF, the system timestamp is at signal acquisition
398 * time. This means there's an offset between them of at most
399 * a few hundred microseconds (24 * 8 bits + PLCP time gives
400 * 384us in the longest case), this is currently not relevant
401 * as the firmware wakes up around 2ms before the TBTT.
403 dtim_offs = dtim_count * ni->ni_intval;
404 /* convert TU to usecs */
408 * net80211: TSF is in 802.11 order, so convert up to local
409 * ordering before we manipulate things.
411 tsf = le64toh(ni->ni_tstamp.tsf);
413 ctxt_sta->dtim_tsf = htole64(tsf + dtim_offs);
414 ctxt_sta->dtim_time = htole32(tsf + dtim_offs);
416 IWM_DPRINTF(sc, IWM_DEBUG_RESET | IWM_DEBUG_BEACON | IWM_DEBUG_CMD,
417 "DTIM TBTT is 0x%llx/0x%x, offset %d\n",
418 (long long)le64toh(ctxt_sta->dtim_tsf),
419 le32toh(ctxt_sta->dtim_time), dtim_offs);
421 ctxt_sta->is_assoc = htole32(1);
423 ctxt_sta->is_assoc = htole32(0);
426 IWM_DPRINTF(sc, IWM_DEBUG_RESET | IWM_DEBUG_CMD | IWM_DEBUG_BEACON,
427 "%s: ni_intval: %d, bi_reciprocal: %d, dtim_interval: %d, dtim_reciprocal: %d\n",
430 iwm_mvm_reciprocal(ni->ni_intval),
431 ni->ni_intval * dtim_period,
432 iwm_mvm_reciprocal(ni->ni_intval * dtim_period));
434 ctxt_sta->bi = htole32(ni->ni_intval);
435 ctxt_sta->bi_reciprocal = htole32(iwm_mvm_reciprocal(ni->ni_intval));
436 ctxt_sta->dtim_interval = htole32(ni->ni_intval * dtim_period);
437 ctxt_sta->dtim_reciprocal =
438 htole32(iwm_mvm_reciprocal(ni->ni_intval * dtim_period));
440 /* 10 = CONN_MAX_LISTEN_INTERVAL */
441 ctxt_sta->listen_interval = htole32(10);
442 IWM_DPRINTF(sc, IWM_DEBUG_RESET | IWM_DEBUG_CMD | IWM_DEBUG_BEACON,
443 "%s: associd=%d\n", __func__, IEEE80211_AID(ni->ni_associd));
444 ctxt_sta->assoc_id = htole32(IEEE80211_AID(ni->ni_associd));
448 iwm_mvm_mac_ctxt_cmd_station(struct iwm_softc *sc, struct ieee80211vap *vap,
451 struct ieee80211_node *ni = vap->iv_bss;
452 struct iwm_node *in = IWM_NODE(ni);
453 struct iwm_mac_ctx_cmd cmd = {};
455 IWM_DPRINTF(sc, IWM_DEBUG_RESET,
456 "%s: called; action=%d\n", __func__, action);
458 /* Fill the common data for all mac context types */
459 iwm_mvm_mac_ctxt_cmd_common(sc, in, &cmd, action);
461 /* Allow beacons to pass through as long as we are not associated,or we
462 * do not have dtim period information */
463 if (!in->in_assoc || !vap->iv_dtim_period)
464 cmd.filter_flags |= htole32(IWM_MAC_FILTER_IN_BEACON);
466 cmd.filter_flags &= ~htole32(IWM_MAC_FILTER_IN_BEACON);
468 /* Fill the data specific for station mode */
469 iwm_mvm_mac_ctxt_cmd_fill_sta(sc, in,
470 &cmd.sta, action == IWM_FW_CTXT_ACTION_ADD);
472 return iwm_mvm_mac_ctxt_send_cmd(sc, &cmd);
476 iwm_mvm_mac_ctx_send(struct iwm_softc *sc, struct ieee80211vap *vap,
479 return iwm_mvm_mac_ctxt_cmd_station(sc, vap, action);
483 iwm_mvm_mac_ctxt_add(struct iwm_softc *sc, struct ieee80211vap *vap)
485 struct iwm_vap *iv = IWM_VAP(vap);
488 if (iv->is_uploaded != 0) {
489 device_printf(sc->sc_dev, "%s: called; uploaded != 0\n",
494 ret = iwm_mvm_mac_ctx_send(sc, vap, IWM_FW_CTXT_ACTION_ADD);
502 iwm_mvm_mac_ctxt_changed(struct iwm_softc *sc, struct ieee80211vap *vap)
504 struct iwm_vap *iv = IWM_VAP(vap);
506 if (iv->is_uploaded == 0) {
507 device_printf(sc->sc_dev, "%s: called; uploaded = 0\n",
511 return iwm_mvm_mac_ctx_send(sc, vap, IWM_FW_CTXT_ACTION_MODIFY);
516 iwm_mvm_mac_ctxt_remove(struct iwm_softc *sc, struct iwm_node *in)
518 struct iwm_mac_ctx_cmd cmd;
521 if (!in->in_uploaded) {
522 device_printf(sc->sc_dev,
523 "attempt to remove !uploaded node %p", in);
527 memset(&cmd, 0, sizeof(cmd));
529 cmd.id_and_color = htole32(IWM_FW_CMD_ID_AND_COLOR(IWM_DEFAULT_MACID,
531 cmd.action = htole32(IWM_FW_CTXT_ACTION_REMOVE);
533 ret = iwm_mvm_send_cmd_pdu(sc,
534 IWM_MAC_CONTEXT_CMD, IWM_CMD_SYNC, sizeof(cmd), &cmd);
536 device_printf(sc->sc_dev,
537 "Failed to remove MAC context: %d\n", ret);