init.c 27.3 KB
Newer Older
S
Sujith 已提交
1
/*
2
 * Copyright (c) 2008-2011 Atheros Communications Inc.
S
Sujith 已提交
3 4 5 6 7 8 9 10 11 12 13 14 15 16
 *
 * Permission to use, copy, modify, and/or distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */

17 18
#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt

19
#include <linux/dma-mapping.h>
20
#include <linux/slab.h>
21
#include <linux/ath9k_platform.h>
22
#include <linux/module.h>
23

S
Sujith 已提交
24 25
#include "ath9k.h"

26 27 28 29 30
struct ath9k_eeprom_ctx {
	struct completion complete;
	struct ath_hw *ah;
};

S
Sujith 已提交
31 32 33 34 35 36 37 38 39 40 41
static char *dev_info = "ath9k";

MODULE_AUTHOR("Atheros Communications");
MODULE_DESCRIPTION("Support for Atheros 802.11n wireless LAN cards.");
MODULE_SUPPORTED_DEVICE("Atheros 802.11n WLAN cards");
MODULE_LICENSE("Dual BSD/GPL");

static unsigned int ath9k_debug = ATH_DBG_DEFAULT;
module_param_named(debug, ath9k_debug, uint, 0);
MODULE_PARM_DESC(debug, "Debugging mask");

42 43
int ath9k_modparam_nohwcrypt;
module_param_named(nohwcrypt, ath9k_modparam_nohwcrypt, int, 0444);
S
Sujith 已提交
44 45
MODULE_PARM_DESC(nohwcrypt, "Disable hardware encryption");

46
int led_blink;
47 48 49
module_param_named(blink, led_blink, int, 0444);
MODULE_PARM_DESC(blink, "Enable LED blink on activity");

50 51 52 53
static int ath9k_btcoex_enable;
module_param_named(btcoex_enable, ath9k_btcoex_enable, int, 0444);
MODULE_PARM_DESC(btcoex_enable, "Enable wifi-BT coexistence");

54 55 56 57
static int ath9k_enable_diversity;
module_param_named(enable_diversity, ath9k_enable_diversity, int, 0444);
MODULE_PARM_DESC(enable_diversity, "Enable Antenna diversity for AR9565");

58
bool is_ath9k_unloaded;
S
Sujith 已提交
59 60 61
/* We use the hw_value as an index into our private channel structure */

#define CHAN2G(_freq, _idx)  { \
62
	.band = IEEE80211_BAND_2GHZ, \
S
Sujith 已提交
63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78
	.center_freq = (_freq), \
	.hw_value = (_idx), \
	.max_power = 20, \
}

#define CHAN5G(_freq, _idx) { \
	.band = IEEE80211_BAND_5GHZ, \
	.center_freq = (_freq), \
	.hw_value = (_idx), \
	.max_power = 20, \
}

/* Some 2 GHz radios are actually tunable on 2312-2732
 * on 5 MHz steps, we support the channels which we know
 * we have calibration data for all cards though to make
 * this static */
79
static const struct ieee80211_channel ath9k_2ghz_chantable[] = {
S
Sujith 已提交
80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99
	CHAN2G(2412, 0), /* Channel 1 */
	CHAN2G(2417, 1), /* Channel 2 */
	CHAN2G(2422, 2), /* Channel 3 */
	CHAN2G(2427, 3), /* Channel 4 */
	CHAN2G(2432, 4), /* Channel 5 */
	CHAN2G(2437, 5), /* Channel 6 */
	CHAN2G(2442, 6), /* Channel 7 */
	CHAN2G(2447, 7), /* Channel 8 */
	CHAN2G(2452, 8), /* Channel 9 */
	CHAN2G(2457, 9), /* Channel 10 */
	CHAN2G(2462, 10), /* Channel 11 */
	CHAN2G(2467, 11), /* Channel 12 */
	CHAN2G(2472, 12), /* Channel 13 */
	CHAN2G(2484, 13), /* Channel 14 */
};

/* Some 5 GHz radios are actually tunable on XXXX-YYYY
 * on 5 MHz steps, we support the channels which we know
 * we have calibration data for all cards though to make
 * this static */
100
static const struct ieee80211_channel ath9k_5ghz_chantable[] = {
S
Sujith 已提交
101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156
	/* _We_ call this UNII 1 */
	CHAN5G(5180, 14), /* Channel 36 */
	CHAN5G(5200, 15), /* Channel 40 */
	CHAN5G(5220, 16), /* Channel 44 */
	CHAN5G(5240, 17), /* Channel 48 */
	/* _We_ call this UNII 2 */
	CHAN5G(5260, 18), /* Channel 52 */
	CHAN5G(5280, 19), /* Channel 56 */
	CHAN5G(5300, 20), /* Channel 60 */
	CHAN5G(5320, 21), /* Channel 64 */
	/* _We_ call this "Middle band" */
	CHAN5G(5500, 22), /* Channel 100 */
	CHAN5G(5520, 23), /* Channel 104 */
	CHAN5G(5540, 24), /* Channel 108 */
	CHAN5G(5560, 25), /* Channel 112 */
	CHAN5G(5580, 26), /* Channel 116 */
	CHAN5G(5600, 27), /* Channel 120 */
	CHAN5G(5620, 28), /* Channel 124 */
	CHAN5G(5640, 29), /* Channel 128 */
	CHAN5G(5660, 30), /* Channel 132 */
	CHAN5G(5680, 31), /* Channel 136 */
	CHAN5G(5700, 32), /* Channel 140 */
	/* _We_ call this UNII 3 */
	CHAN5G(5745, 33), /* Channel 149 */
	CHAN5G(5765, 34), /* Channel 153 */
	CHAN5G(5785, 35), /* Channel 157 */
	CHAN5G(5805, 36), /* Channel 161 */
	CHAN5G(5825, 37), /* Channel 165 */
};

/* Atheros hardware rate code addition for short premble */
#define SHPCHECK(__hw_rate, __flags) \
	((__flags & IEEE80211_RATE_SHORT_PREAMBLE) ? (__hw_rate | 0x04 ) : 0)

#define RATE(_bitrate, _hw_rate, _flags) {              \
	.bitrate        = (_bitrate),                   \
	.flags          = (_flags),                     \
	.hw_value       = (_hw_rate),                   \
	.hw_value_short = (SHPCHECK(_hw_rate, _flags))  \
}

static struct ieee80211_rate ath9k_legacy_rates[] = {
	RATE(10, 0x1b, 0),
	RATE(20, 0x1a, IEEE80211_RATE_SHORT_PREAMBLE),
	RATE(55, 0x19, IEEE80211_RATE_SHORT_PREAMBLE),
	RATE(110, 0x18, IEEE80211_RATE_SHORT_PREAMBLE),
	RATE(60, 0x0b, 0),
	RATE(90, 0x0f, 0),
	RATE(120, 0x0a, 0),
	RATE(180, 0x0e, 0),
	RATE(240, 0x09, 0),
	RATE(360, 0x0d, 0),
	RATE(480, 0x08, 0),
	RATE(540, 0x0c, 0),
};

157 158 159 160 161 162 163 164 165 166 167 168 169 170 171
#ifdef CONFIG_MAC80211_LEDS
static const struct ieee80211_tpt_blink ath9k_tpt_blink[] = {
	{ .throughput = 0 * 1024, .blink_time = 334 },
	{ .throughput = 1 * 1024, .blink_time = 260 },
	{ .throughput = 5 * 1024, .blink_time = 220 },
	{ .throughput = 10 * 1024, .blink_time = 190 },
	{ .throughput = 20 * 1024, .blink_time = 170 },
	{ .throughput = 50 * 1024, .blink_time = 150 },
	{ .throughput = 70 * 1024, .blink_time = 130 },
	{ .throughput = 100 * 1024, .blink_time = 110 },
	{ .throughput = 200 * 1024, .blink_time = 80 },
	{ .throughput = 300 * 1024, .blink_time = 50 },
};
#endif

S
Sujith 已提交
172
static void ath9k_deinit_softc(struct ath_softc *sc);
S
Sujith 已提交
173 174 175 176 177 178 179 180 181 182 183 184 185

/*
 * Read and write, they both share the same lock. We do this to serialize
 * reads and writes on Atheros 802.11n PCI devices only. This is required
 * as the FIFO on these devices can only accept sanely 2 requests.
 */

static void ath9k_iowrite32(void *hw_priv, u32 val, u32 reg_offset)
{
	struct ath_hw *ah = (struct ath_hw *) hw_priv;
	struct ath_common *common = ath9k_hw_common(ah);
	struct ath_softc *sc = (struct ath_softc *) common->priv;

186
	if (NR_CPUS > 1 && ah->config.serialize_regmode == SER_REG_MODE_ON) {
S
Sujith 已提交
187 188 189 190 191 192 193 194 195 196 197 198 199 200 201
		unsigned long flags;
		spin_lock_irqsave(&sc->sc_serial_rw, flags);
		iowrite32(val, sc->mem + reg_offset);
		spin_unlock_irqrestore(&sc->sc_serial_rw, flags);
	} else
		iowrite32(val, sc->mem + reg_offset);
}

static unsigned int ath9k_ioread32(void *hw_priv, u32 reg_offset)
{
	struct ath_hw *ah = (struct ath_hw *) hw_priv;
	struct ath_common *common = ath9k_hw_common(ah);
	struct ath_softc *sc = (struct ath_softc *) common->priv;
	u32 val;

202
	if (NR_CPUS > 1 && ah->config.serialize_regmode == SER_REG_MODE_ON) {
S
Sujith 已提交
203 204 205 206 207 208 209 210 211
		unsigned long flags;
		spin_lock_irqsave(&sc->sc_serial_rw, flags);
		val = ioread32(sc->mem + reg_offset);
		spin_unlock_irqrestore(&sc->sc_serial_rw, flags);
	} else
		val = ioread32(sc->mem + reg_offset);
	return val;
}

R
Rajkumar Manoharan 已提交
212 213 214 215 216 217 218 219 220 221 222 223 224
static unsigned int __ath9k_reg_rmw(struct ath_softc *sc, u32 reg_offset,
				    u32 set, u32 clr)
{
	u32 val;

	val = ioread32(sc->mem + reg_offset);
	val &= ~clr;
	val |= set;
	iowrite32(val, sc->mem + reg_offset);

	return val;
}

225 226 227 228 229 230 231 232
static unsigned int ath9k_reg_rmw(void *hw_priv, u32 reg_offset, u32 set, u32 clr)
{
	struct ath_hw *ah = (struct ath_hw *) hw_priv;
	struct ath_common *common = ath9k_hw_common(ah);
	struct ath_softc *sc = (struct ath_softc *) common->priv;
	unsigned long uninitialized_var(flags);
	u32 val;

233
	if (NR_CPUS > 1 && ah->config.serialize_regmode == SER_REG_MODE_ON) {
234
		spin_lock_irqsave(&sc->sc_serial_rw, flags);
R
Rajkumar Manoharan 已提交
235
		val = __ath9k_reg_rmw(sc, reg_offset, set, clr);
236
		spin_unlock_irqrestore(&sc->sc_serial_rw, flags);
R
Rajkumar Manoharan 已提交
237 238
	} else
		val = __ath9k_reg_rmw(sc, reg_offset, set, clr);
239 240 241 242

	return val;
}

S
Sujith 已提交
243 244 245 246 247 248 249
/**************************/
/*     Initialization     */
/**************************/

static void setup_ht_cap(struct ath_softc *sc,
			 struct ieee80211_sta_ht_cap *ht_info)
{
250 251
	struct ath_hw *ah = sc->sc_ah;
	struct ath_common *common = ath9k_hw_common(ah);
S
Sujith 已提交
252
	u8 tx_streams, rx_streams;
253
	int i, max_streams;
S
Sujith 已提交
254 255 256 257 258 259 260

	ht_info->ht_supported = true;
	ht_info->cap = IEEE80211_HT_CAP_SUP_WIDTH_20_40 |
		       IEEE80211_HT_CAP_SM_PS |
		       IEEE80211_HT_CAP_SGI_40 |
		       IEEE80211_HT_CAP_DSSSCCK40;

L
Luis R. Rodriguez 已提交
261 262 263
	if (sc->sc_ah->caps.hw_caps & ATH9K_HW_CAP_LDPC)
		ht_info->cap |= IEEE80211_HT_CAP_LDPC_CODING;

264 265 266
	if (sc->sc_ah->caps.hw_caps & ATH9K_HW_CAP_SGI_20)
		ht_info->cap |= IEEE80211_HT_CAP_SGI_20;

S
Sujith 已提交
267 268 269
	ht_info->ampdu_factor = IEEE80211_HT_MAX_AMPDU_64K;
	ht_info->ampdu_density = IEEE80211_HT_MPDU_DENSITY_8;

270
	if (AR_SREV_9330(ah) || AR_SREV_9485(ah) || AR_SREV_9565(ah))
271
		max_streams = 1;
272 273
	else if (AR_SREV_9462(ah))
		max_streams = 2;
274
	else if (AR_SREV_9300_20_OR_LATER(ah))
275 276 277 278
		max_streams = 3;
	else
		max_streams = 2;

279
	if (AR_SREV_9280_20_OR_LATER(ah)) {
280 281 282 283 284
		if (max_streams >= 2)
			ht_info->cap |= IEEE80211_HT_CAP_TX_STBC;
		ht_info->cap |= (1 << IEEE80211_HT_CAP_RX_STBC_SHIFT);
	}

S
Sujith 已提交
285 286
	/* set up supported mcs set */
	memset(&ht_info->mcs, 0, sizeof(ht_info->mcs));
287 288
	tx_streams = ath9k_cmn_count_streams(ah->txchainmask, max_streams);
	rx_streams = ath9k_cmn_count_streams(ah->rxchainmask, max_streams);
289

290
	ath_dbg(common, CONFIG, "TX streams %d, RX streams: %d\n",
J
Joe Perches 已提交
291
		tx_streams, rx_streams);
S
Sujith 已提交
292 293 294 295 296 297 298

	if (tx_streams != rx_streams) {
		ht_info->mcs.tx_params |= IEEE80211_HT_MCS_TX_RX_DIFF;
		ht_info->mcs.tx_params |= ((tx_streams - 1) <<
				IEEE80211_HT_MCS_TX_MAX_STREAMS_SHIFT);
	}

299 300
	for (i = 0; i < rx_streams; i++)
		ht_info->mcs.rx_mask[i] = 0xff;
S
Sujith 已提交
301 302 303 304 305 306 307 308

	ht_info->mcs.tx_params |= IEEE80211_HT_MCS_TX_DEFINED;
}

static int ath9k_reg_notifier(struct wiphy *wiphy,
			      struct regulatory_request *request)
{
	struct ieee80211_hw *hw = wiphy_to_ieee80211_hw(wiphy);
309
	struct ath_softc *sc = hw->priv;
310 311 312 313 314 315 316 317 318 319 320 321 322 323
	struct ath_hw *ah = sc->sc_ah;
	struct ath_regulatory *reg = ath9k_hw_regulatory(ah);
	int ret;

	ret = ath_reg_notifier_apply(wiphy, request, reg);

	/* Set tx power */
	if (ah->curchan) {
		sc->config.txpowlimit = 2 * ah->curchan->chan->max_power;
		ath9k_ps_wakeup(sc);
		ath9k_hw_set_txpowerlimit(ah, sc->config.txpowlimit, false);
		sc->curtxpow = ath9k_hw_regulatory(ah)->power_limit;
		ath9k_ps_restore(sc);
	}
S
Sujith 已提交
324

325
	return ret;
S
Sujith 已提交
326 327 328 329 330 331 332 333 334
}

/*
 *  This function will allocate both the DMA descriptor structure, and the
 *  buffers it contains.  These are used to contain the descriptors used
 *  by the system.
*/
int ath_descdma_setup(struct ath_softc *sc, struct ath_descdma *dd,
		      struct list_head *head, const char *name,
335
		      int nbuf, int ndesc, bool is_tx)
S
Sujith 已提交
336 337
{
	struct ath_common *common = ath9k_hw_common(sc->sc_ah);
338
	u8 *ds;
S
Sujith 已提交
339
	struct ath_buf *bf;
340
	int i, bsize, error, desc_len;
S
Sujith 已提交
341

342
	ath_dbg(common, CONFIG, "%s DMA: %u buffers %u desc/buf\n",
J
Joe Perches 已提交
343
		name, nbuf, ndesc);
S
Sujith 已提交
344 345

	INIT_LIST_HEAD(head);
346 347 348 349 350 351

	if (is_tx)
		desc_len = sc->sc_ah->caps.tx_desc_len;
	else
		desc_len = sizeof(struct ath_desc);

S
Sujith 已提交
352
	/* ath_desc must be a multiple of DWORDs */
353
	if ((desc_len % 4) != 0) {
354
		ath_err(common, "ath_desc not DWORD aligned\n");
355
		BUG_ON((desc_len % 4) != 0);
S
Sujith 已提交
356 357 358 359
		error = -ENOMEM;
		goto fail;
	}

360
	dd->dd_desc_len = desc_len * nbuf * ndesc;
S
Sujith 已提交
361 362 363 364 365 366 367 368 369 370 371 372

	/*
	 * Need additional DMA memory because we can't use
	 * descriptors that cross the 4K page boundary. Assume
	 * one skipped descriptor per 4K page.
	 */
	if (!(sc->sc_ah->caps.hw_caps & ATH9K_HW_CAP_4KB_SPLITTRANS)) {
		u32 ndesc_skipped =
			ATH_DESC_4KB_BOUND_NUM_SKIPPED(dd->dd_desc_len);
		u32 dma_len;

		while (ndesc_skipped) {
373
			dma_len = ndesc_skipped * desc_len;
S
Sujith 已提交
374 375 376
			dd->dd_desc_len += dma_len;

			ndesc_skipped = ATH_DESC_4KB_BOUND_NUM_SKIPPED(dma_len);
377
		}
S
Sujith 已提交
378 379 380 381 382 383 384 385 386
	}

	/* allocate descriptors */
	dd->dd_desc = dma_alloc_coherent(sc->dev, dd->dd_desc_len,
					 &dd->dd_desc_paddr, GFP_KERNEL);
	if (dd->dd_desc == NULL) {
		error = -ENOMEM;
		goto fail;
	}
387
	ds = (u8 *) dd->dd_desc;
388
	ath_dbg(common, CONFIG, "%s DMA map: %p (%u) -> %llx (%u)\n",
J
Joe Perches 已提交
389 390
		name, ds, (u32) dd->dd_desc_len,
		ito64(dd->dd_desc_paddr), /*XXX*/(u32) dd->dd_desc_len);
S
Sujith 已提交
391 392 393 394 395 396 397 398 399 400

	/* allocate buffers */
	bsize = sizeof(struct ath_buf) * nbuf;
	bf = kzalloc(bsize, GFP_KERNEL);
	if (bf == NULL) {
		error = -ENOMEM;
		goto fail2;
	}
	dd->dd_bufptr = bf;

401
	for (i = 0; i < nbuf; i++, bf++, ds += (desc_len * ndesc)) {
S
Sujith 已提交
402 403 404 405 406 407 408 409 410 411 412 413 414 415 416
		bf->bf_desc = ds;
		bf->bf_daddr = DS2PHYS(dd, ds);

		if (!(sc->sc_ah->caps.hw_caps &
		      ATH9K_HW_CAP_4KB_SPLITTRANS)) {
			/*
			 * Skip descriptor addresses which can cause 4KB
			 * boundary crossing (addr + length) with a 32 dword
			 * descriptor fetch.
			 */
			while (ATH_DESC_4KB_BOUND_CHECK(bf->bf_daddr)) {
				BUG_ON((caddr_t) bf->bf_desc >=
				       ((caddr_t) dd->dd_desc +
					dd->dd_desc_len));

417
				ds += (desc_len * ndesc);
S
Sujith 已提交
418 419 420 421 422 423 424 425 426 427 428 429 430 431 432
				bf->bf_desc = ds;
				bf->bf_daddr = DS2PHYS(dd, ds);
			}
		}
		list_add_tail(&bf->list, head);
	}
	return 0;
fail2:
	dma_free_coherent(sc->dev, dd->dd_desc_len, dd->dd_desc,
			  dd->dd_desc_paddr);
fail:
	memset(dd, 0, sizeof(*dd));
	return error;
}

S
Sujith 已提交
433 434 435 436 437
static int ath9k_init_queues(struct ath_softc *sc)
{
	int i = 0;

	sc->beacon.beaconq = ath9k_hw_beaconq_setup(sc->sc_ah);
S
Sujith 已提交
438 439 440 441 442
	sc->beacon.cabq = ath_txq_setup(sc, ATH9K_TX_QUEUE_CAB, 0);

	sc->config.cabqReadytime = ATH_CABQ_READY_TIME;
	ath_cabq_update(sc);

443
	for (i = 0; i < IEEE80211_NUM_ACS; i++) {
444
		sc->tx.txq_map[i] = ath_txq_setup(sc, ATH9K_TX_QUEUE_DATA, i);
445
		sc->tx.txq_map[i]->mac80211_qnum = i;
446
		sc->tx.txq_max_pending[i] = ATH_MAX_QDEPTH;
447
	}
S
Sujith 已提交
448 449 450
	return 0;
}

451
static int ath9k_init_channels_rates(struct ath_softc *sc)
S
Sujith 已提交
452
{
453 454
	void *channels;

455 456 457 458
	BUILD_BUG_ON(ARRAY_SIZE(ath9k_2ghz_chantable) +
		     ARRAY_SIZE(ath9k_5ghz_chantable) !=
		     ATH9K_NUM_CHANNELS);

459
	if (sc->sc_ah->caps.hw_caps & ATH9K_HW_CAP_2GHZ) {
460 461 462 463 464 465
		channels = kmemdup(ath9k_2ghz_chantable,
			sizeof(ath9k_2ghz_chantable), GFP_KERNEL);
		if (!channels)
		    return -ENOMEM;

		sc->sbands[IEEE80211_BAND_2GHZ].channels = channels;
S
Sujith 已提交
466 467 468 469 470 471
		sc->sbands[IEEE80211_BAND_2GHZ].band = IEEE80211_BAND_2GHZ;
		sc->sbands[IEEE80211_BAND_2GHZ].n_channels =
			ARRAY_SIZE(ath9k_2ghz_chantable);
		sc->sbands[IEEE80211_BAND_2GHZ].bitrates = ath9k_legacy_rates;
		sc->sbands[IEEE80211_BAND_2GHZ].n_bitrates =
			ARRAY_SIZE(ath9k_legacy_rates);
S
Sujith 已提交
472 473
	}

474
	if (sc->sc_ah->caps.hw_caps & ATH9K_HW_CAP_5GHZ) {
475 476 477 478 479 480 481 482 483
		channels = kmemdup(ath9k_5ghz_chantable,
			sizeof(ath9k_5ghz_chantable), GFP_KERNEL);
		if (!channels) {
			if (sc->sbands[IEEE80211_BAND_2GHZ].channels)
				kfree(sc->sbands[IEEE80211_BAND_2GHZ].channels);
			return -ENOMEM;
		}

		sc->sbands[IEEE80211_BAND_5GHZ].channels = channels;
S
Sujith 已提交
484 485 486 487 488 489 490 491
		sc->sbands[IEEE80211_BAND_5GHZ].band = IEEE80211_BAND_5GHZ;
		sc->sbands[IEEE80211_BAND_5GHZ].n_channels =
			ARRAY_SIZE(ath9k_5ghz_chantable);
		sc->sbands[IEEE80211_BAND_5GHZ].bitrates =
			ath9k_legacy_rates + 4;
		sc->sbands[IEEE80211_BAND_5GHZ].n_bitrates =
			ARRAY_SIZE(ath9k_legacy_rates) - 4;
	}
492
	return 0;
S
Sujith 已提交
493
}
S
Sujith 已提交
494

S
Sujith 已提交
495 496 497 498
static void ath9k_init_misc(struct ath_softc *sc)
{
	struct ath_common *common = ath9k_hw_common(sc->sc_ah);
	int i = 0;
499

S
Sujith 已提交
500
	setup_timer(&common->ani.timer, ath_ani_calibrate, (unsigned long)sc);
S
Sujith 已提交
501

502
	sc->last_rssi = ATH_RSSI_DUMMY_MARKER;
S
Sujith 已提交
503
	sc->config.txpowlimit = ATH_TXPOWER_MAX;
504
	memcpy(common->bssidmask, ath_bcast_mac, ETH_ALEN);
S
Sujith 已提交
505
	sc->beacon.slottime = ATH9K_SLOT_TIME_9;
S
Sujith 已提交
506

507
	for (i = 0; i < ARRAY_SIZE(sc->beacon.bslot); i++)
S
Sujith 已提交
508
		sc->beacon.bslot[i] = NULL;
509 510 511

	if (sc->sc_ah->caps.hw_caps & ATH9K_HW_CAP_ANT_DIV_COMB)
		sc->ant_comb.count = ATH_ANT_DIV_COMB_INIT_COUNT;
S
Sujith 已提交
512
}
S
Sujith 已提交
513

514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558
static void ath9k_eeprom_request_cb(const struct firmware *eeprom_blob,
				    void *ctx)
{
	struct ath9k_eeprom_ctx *ec = ctx;

	if (eeprom_blob)
		ec->ah->eeprom_blob = eeprom_blob;

	complete(&ec->complete);
}

static int ath9k_eeprom_request(struct ath_softc *sc, const char *name)
{
	struct ath9k_eeprom_ctx ec;
	struct ath_hw *ah = ah = sc->sc_ah;
	int err;

	/* try to load the EEPROM content asynchronously */
	init_completion(&ec.complete);
	ec.ah = sc->sc_ah;

	err = request_firmware_nowait(THIS_MODULE, 1, name, sc->dev, GFP_KERNEL,
				      &ec, ath9k_eeprom_request_cb);
	if (err < 0) {
		ath_err(ath9k_hw_common(ah),
			"EEPROM request failed\n");
		return err;
	}

	wait_for_completion(&ec.complete);

	if (!ah->eeprom_blob) {
		ath_err(ath9k_hw_common(ah),
			"Unable to load EEPROM file %s\n", name);
		return -EINVAL;
	}

	return 0;
}

static void ath9k_eeprom_release(struct ath_softc *sc)
{
	release_firmware(sc->sc_ah->eeprom_blob);
}

559
static int ath9k_init_softc(u16 devid, struct ath_softc *sc,
S
Sujith 已提交
560 561
			    const struct ath_bus_ops *bus_ops)
{
562
	struct ath9k_platform_data *pdata = sc->dev->platform_data;
S
Sujith 已提交
563 564 565 566
	struct ath_hw *ah = NULL;
	struct ath_common *common;
	int ret = 0, i;
	int csz = 0;
S
Sujith 已提交
567

S
Sujith 已提交
568 569 570 571
	ah = kzalloc(sizeof(struct ath_hw), GFP_KERNEL);
	if (!ah)
		return -ENOMEM;

B
Ben Greear 已提交
572
	ah->hw = sc->hw;
S
Sujith 已提交
573
	ah->hw_version.devid = devid;
574 575
	ah->reg_ops.read = ath9k_ioread32;
	ah->reg_ops.write = ath9k_iowrite32;
576
	ah->reg_ops.rmw = ath9k_reg_rmw;
577
	atomic_set(&ah->intr_ref_cnt, -1);
S
Sujith 已提交
578 579
	sc->sc_ah = ah;

580 581
	sc->dfs_detector = dfs_pattern_detector_init(NL80211_DFS_UNSET);

582
	if (!pdata) {
583
		ah->ah_flags |= AH_USE_EEPROM;
584 585 586 587 588
		sc->sc_ah->led_pin = -1;
	} else {
		sc->sc_ah->gpio_mask = pdata->gpio_mask;
		sc->sc_ah->gpio_val = pdata->gpio_val;
		sc->sc_ah->led_pin = pdata->led_pin;
589
		ah->is_clk_25mhz = pdata->is_clk_25mhz;
590
		ah->get_mac_revision = pdata->get_mac_revision;
591
		ah->external_reset = pdata->external_reset;
592
	}
593

S
Sujith 已提交
594
	common = ath9k_hw_common(ah);
595
	common->ops = &ah->reg_ops;
S
Sujith 已提交
596 597 598 599 600
	common->bus_ops = bus_ops;
	common->ah = ah;
	common->hw = sc->hw;
	common->priv = sc;
	common->debug_mask = ath9k_debug;
601
	common->btcoex_enabled = ath9k_btcoex_enable == 1;
602
	common->disable_ani = false;
603 604 605 606 607 608 609 610

	/*
	 * Enable Antenna diversity only when BTCOEX is disabled
	 * and the user manually requests the feature.
	 */
	if (!common->btcoex_enabled && ath9k_enable_diversity)
		common->antenna_diversity = 1;

611
	spin_lock_init(&common->cc_lock);
S
Sujith 已提交
612 613 614 615

	spin_lock_init(&sc->sc_serial_rw);
	spin_lock_init(&sc->sc_pm_lock);
	mutex_init(&sc->mutex);
616 617
#ifdef CONFIG_ATH9K_MAC_DEBUG
	spin_lock_init(&sc->debug.samp_lock);
618
#endif
S
Sujith 已提交
619
	tasklet_init(&sc->intr_tq, ath9k_tasklet, (unsigned long)sc);
620
	tasklet_init(&sc->bcon_tasklet, ath9k_beacon_tasklet,
S
Sujith 已提交
621 622
		     (unsigned long)sc);

623 624 625 626 627 628
	INIT_WORK(&sc->hw_reset_work, ath_reset_work);
	INIT_WORK(&sc->hw_check_work, ath_hw_check);
	INIT_WORK(&sc->paprd_work, ath_paprd_calibrate);
	INIT_DELAYED_WORK(&sc->hw_pll_work, ath_hw_pll_work);
	setup_timer(&sc->rx_poll_timer, ath_rx_poll, (unsigned long)sc);

S
Sujith 已提交
629 630 631 632 633 634 635
	/*
	 * Cache line size is used to size and align various
	 * structures used to communicate with the hardware.
	 */
	ath_read_cachesize(common, &csz);
	common->cachelsz = csz << 2; /* convert to bytes */

636 637 638 639 640 641
	if (pdata->eeprom_name) {
		ret = ath9k_eeprom_request(sc, pdata->eeprom_name);
		if (ret)
			goto err_eeprom;
	}

642
	/* Initializes the hardware for all supported chipsets */
S
Sujith 已提交
643
	ret = ath9k_hw_init(ah);
644
	if (ret)
S
Sujith 已提交
645
		goto err_hw;
S
Sujith 已提交
646

647 648 649
	if (pdata && pdata->macaddr)
		memcpy(common->macaddr, pdata->macaddr, ETH_ALEN);

S
Sujith 已提交
650 651 652 653 654 655 656 657
	ret = ath9k_init_queues(sc);
	if (ret)
		goto err_queues;

	ret =  ath9k_init_btcoex(sc);
	if (ret)
		goto err_btcoex;

658 659 660 661
	ret = ath9k_init_channels_rates(sc);
	if (ret)
		goto err_btcoex;

662
	ath9k_cmn_init_crypto(sc->sc_ah);
S
Sujith 已提交
663
	ath9k_init_misc(sc);
664
	ath_fill_led_pin(sc);
S
Sujith 已提交
665

S
Sujith Manoharan 已提交
666 667 668
	if (common->bus_ops->aspm_init)
		common->bus_ops->aspm_init(common);

S
Sujith 已提交
669
	return 0;
S
Sujith 已提交
670 671

err_btcoex:
S
Sujith 已提交
672 673 674
	for (i = 0; i < ATH9K_NUM_TX_QUEUES; i++)
		if (ATH_TXQ_SETUP(sc, i))
			ath_tx_cleanupq(sc, &sc->tx.txq[i]);
S
Sujith 已提交
675 676 677
err_queues:
	ath9k_hw_deinit(ah);
err_hw:
678 679
	ath9k_eeprom_release(sc);
err_eeprom:
S
Sujith 已提交
680 681 682 683
	kfree(ah);
	sc->sc_ah = NULL;

	return ret;
S
Sujith 已提交
684 685
}

686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714
static void ath9k_init_band_txpower(struct ath_softc *sc, int band)
{
	struct ieee80211_supported_band *sband;
	struct ieee80211_channel *chan;
	struct ath_hw *ah = sc->sc_ah;
	int i;

	sband = &sc->sbands[band];
	for (i = 0; i < sband->n_channels; i++) {
		chan = &sband->channels[i];
		ah->curchan = &ah->channels[chan->hw_value];
		ath9k_cmn_update_ichannel(ah->curchan, chan, NL80211_CHAN_HT20);
		ath9k_hw_set_txpowerlimit(ah, MAX_RATE_POWER, true);
	}
}

static void ath9k_init_txpower_limits(struct ath_softc *sc)
{
	struct ath_hw *ah = sc->sc_ah;
	struct ath9k_channel *curchan = ah->curchan;

	if (ah->caps.hw_caps & ATH9K_HW_CAP_2GHZ)
		ath9k_init_band_txpower(sc, IEEE80211_BAND_2GHZ);
	if (ah->caps.hw_caps & ATH9K_HW_CAP_5GHZ)
		ath9k_init_band_txpower(sc, IEEE80211_BAND_5GHZ);

	ah->curchan = curchan;
}

715 716 717 718 719 720 721 722 723 724 725
void ath9k_reload_chainmask_settings(struct ath_softc *sc)
{
	if (!(sc->sc_ah->caps.hw_caps & ATH9K_HW_CAP_HT))
		return;

	if (sc->sc_ah->caps.hw_caps & ATH9K_HW_CAP_2GHZ)
		setup_ht_cap(sc, &sc->sbands[IEEE80211_BAND_2GHZ].ht_cap);
	if (sc->sc_ah->caps.hw_caps & ATH9K_HW_CAP_5GHZ)
		setup_ht_cap(sc, &sc->sbands[IEEE80211_BAND_5GHZ].ht_cap);
}

726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742
static const struct ieee80211_iface_limit if_limits[] = {
	{ .max = 2048,	.types = BIT(NL80211_IFTYPE_STATION) |
				 BIT(NL80211_IFTYPE_P2P_CLIENT) |
				 BIT(NL80211_IFTYPE_WDS) },
	{ .max = 8,	.types =
#ifdef CONFIG_MAC80211_MESH
				 BIT(NL80211_IFTYPE_MESH_POINT) |
#endif
				 BIT(NL80211_IFTYPE_AP) |
				 BIT(NL80211_IFTYPE_P2P_GO) },
};

static const struct ieee80211_iface_combination if_comb = {
	.limits = if_limits,
	.n_limits = ARRAY_SIZE(if_limits),
	.max_interfaces = 2048,
	.num_different_channels = 1,
743
	.beacon_int_infra_match = true,
744
};
745

S
Sujith 已提交
746
void ath9k_set_hw_capab(struct ath_softc *sc, struct ieee80211_hw *hw)
S
Sujith 已提交
747
{
748 749
	struct ath_hw *ah = sc->sc_ah;
	struct ath_common *common = ath9k_hw_common(ah);
S
Sujith 已提交
750

S
Sujith 已提交
751 752 753 754 755
	hw->flags = IEEE80211_HW_RX_INCLUDES_FCS |
		IEEE80211_HW_HOST_BROADCAST_PS_BUFFERING |
		IEEE80211_HW_SIGNAL_DBM |
		IEEE80211_HW_SUPPORTS_PS |
		IEEE80211_HW_PS_NULLFUNC_STACK |
756
		IEEE80211_HW_SPECTRUM_MGMT |
757
		IEEE80211_HW_REPORTS_TX_ACK_STATUS;
S
Sujith 已提交
758

759 760 761
	if (sc->sc_ah->caps.hw_caps & ATH9K_HW_CAP_HT)
		 hw->flags |= IEEE80211_HW_AMPDU_AGGREGATION;

762
	if (AR_SREV_9160_10_OR_LATER(sc->sc_ah) || ath9k_modparam_nohwcrypt)
S
Sujith 已提交
763 764 765
		hw->flags |= IEEE80211_HW_MFP_CAPABLE;

	hw->wiphy->interface_modes =
J
Johannes Berg 已提交
766 767
		BIT(NL80211_IFTYPE_P2P_GO) |
		BIT(NL80211_IFTYPE_P2P_CLIENT) |
S
Sujith 已提交
768
		BIT(NL80211_IFTYPE_AP) |
B
Bill Jordan 已提交
769
		BIT(NL80211_IFTYPE_WDS) |
S
Sujith 已提交
770 771 772 773
		BIT(NL80211_IFTYPE_STATION) |
		BIT(NL80211_IFTYPE_ADHOC) |
		BIT(NL80211_IFTYPE_MESH_POINT);

774 775 776
	hw->wiphy->iface_combinations = &if_comb;
	hw->wiphy->n_iface_combinations = 1;

777 778
	if (AR_SREV_5416(sc->sc_ah))
		hw->wiphy->flags &= ~WIPHY_FLAG_PS_ON_BY_DEFAULT;
S
Sujith 已提交
779

J
Jouni Malinen 已提交
780
	hw->wiphy->flags |= WIPHY_FLAG_IBSS_RSN;
J
Jouni Malinen 已提交
781
	hw->wiphy->flags |= WIPHY_FLAG_SUPPORTS_TDLS;
782
	hw->wiphy->flags |= WIPHY_FLAG_HAS_REMAIN_ON_CHANNEL;
J
Jouni Malinen 已提交
783

784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801
#ifdef CONFIG_PM_SLEEP

	if ((ah->caps.hw_caps & ATH9K_HW_WOW_DEVICE_CAPABLE) &&
	    device_can_wakeup(sc->dev)) {

		hw->wiphy->wowlan.flags = WIPHY_WOWLAN_MAGIC_PKT |
					  WIPHY_WOWLAN_DISCONNECT;
		hw->wiphy->wowlan.n_patterns = MAX_NUM_USER_PATTERN;
		hw->wiphy->wowlan.pattern_min_len = 1;
		hw->wiphy->wowlan.pattern_max_len = MAX_PATTERN_SIZE;

	}

	atomic_set(&sc->wow_sleep_proc_intr, -1);
	atomic_set(&sc->wow_got_bmiss_intr, -1);

#endif

S
Sujith 已提交
802 803 804
	hw->queues = 4;
	hw->max_rates = 4;
	hw->channel_change_time = 5000;
805
	hw->max_listen_interval = 1;
806
	hw->max_rate_tries = 10;
S
Sujith 已提交
807 808 809
	hw->sta_data_size = sizeof(struct ath_node);
	hw->vif_data_size = sizeof(struct ath_vif);

810 811 812 813 814 815 816 817 818 819
	hw->wiphy->available_antennas_rx = BIT(ah->caps.max_rxchains) - 1;
	hw->wiphy->available_antennas_tx = BIT(ah->caps.max_txchains) - 1;

	/* single chain devices with rx diversity */
	if (ah->caps.hw_caps & ATH9K_HW_CAP_ANT_DIV_COMB)
		hw->wiphy->available_antennas_rx = BIT(0) | BIT(1);

	sc->ant_rx = hw->wiphy->available_antennas_rx;
	sc->ant_tx = hw->wiphy->available_antennas_tx;

820
#ifdef CONFIG_ATH9K_RATE_CONTROL
S
Sujith 已提交
821
	hw->rate_control_algorithm = "ath9k_rate_control";
822
#endif
S
Sujith 已提交
823

824
	if (sc->sc_ah->caps.hw_caps & ATH9K_HW_CAP_2GHZ)
S
Sujith 已提交
825 826
		hw->wiphy->bands[IEEE80211_BAND_2GHZ] =
			&sc->sbands[IEEE80211_BAND_2GHZ];
827
	if (sc->sc_ah->caps.hw_caps & ATH9K_HW_CAP_5GHZ)
S
Sujith 已提交
828 829
		hw->wiphy->bands[IEEE80211_BAND_5GHZ] =
			&sc->sbands[IEEE80211_BAND_5GHZ];
S
Sujith 已提交
830

831
	ath9k_reload_chainmask_settings(sc);
S
Sujith 已提交
832 833

	SET_IEEE80211_PERM_ADDR(hw, common->macaddr);
S
Sujith 已提交
834 835
}

836
int ath9k_init_device(u16 devid, struct ath_softc *sc,
S
Sujith 已提交
837 838 839 840 841
		    const struct ath_bus_ops *bus_ops)
{
	struct ieee80211_hw *hw = sc->hw;
	struct ath_common *common;
	struct ath_hw *ah;
S
Sujith 已提交
842
	int error = 0;
S
Sujith 已提交
843 844
	struct ath_regulatory *reg;

S
Sujith 已提交
845
	/* Bring up device */
846
	error = ath9k_init_softc(devid, sc, bus_ops);
S
Sujith 已提交
847
	if (error != 0)
S
Sujith 已提交
848
		goto error_init;
S
Sujith 已提交
849 850 851

	ah = sc->sc_ah;
	common = ath9k_hw_common(ah);
S
Sujith 已提交
852
	ath9k_set_hw_capab(sc, hw);
S
Sujith 已提交
853

S
Sujith 已提交
854
	/* Initialize regulatory */
S
Sujith 已提交
855 856 857
	error = ath_regd_init(&common->regulatory, sc->hw->wiphy,
			      ath9k_reg_notifier);
	if (error)
S
Sujith 已提交
858
		goto error_regd;
S
Sujith 已提交
859 860 861

	reg = &common->regulatory;

S
Sujith 已提交
862
	/* Setup TX DMA */
S
Sujith 已提交
863 864
	error = ath_tx_init(sc, ATH_TXBUF);
	if (error != 0)
S
Sujith 已提交
865
		goto error_tx;
S
Sujith 已提交
866

S
Sujith 已提交
867
	/* Setup RX DMA */
S
Sujith 已提交
868 869
	error = ath_rx_init(sc, ATH_RXBUF);
	if (error != 0)
S
Sujith 已提交
870
		goto error_rx;
S
Sujith 已提交
871

872 873
	ath9k_init_txpower_limits(sc);

874 875 876 877 878 879 880
#ifdef CONFIG_MAC80211_LEDS
	/* must be initialized before ieee80211_register_hw */
	sc->led_cdev.default_trigger = ieee80211_create_tpt_led_trigger(sc->hw,
		IEEE80211_TPT_LEDTRIG_FL_RADIO, ath9k_tpt_blink,
		ARRAY_SIZE(ath9k_tpt_blink));
#endif

S
Sujith 已提交
881
	/* Register with mac80211 */
S
Sujith 已提交
882
	error = ieee80211_register_hw(hw);
S
Sujith 已提交
883 884
	if (error)
		goto error_register;
S
Sujith 已提交
885

886 887
	error = ath9k_init_debug(ah);
	if (error) {
888
		ath_err(common, "Unable to create debugfs files\n");
889 890 891
		goto error_world;
	}

S
Sujith 已提交
892
	/* Handle world regulatory */
S
Sujith 已提交
893 894 895
	if (!ath_is_world_regd(reg)) {
		error = regulatory_hint(hw->wiphy, reg->alpha2);
		if (error)
S
Sujith 已提交
896
			goto error_world;
S
Sujith 已提交
897 898
	}

S
Sujith 已提交
899
	ath_init_leds(sc);
S
Sujith 已提交
900 901 902 903
	ath_start_rfkill_poll(sc);

	return 0;

S
Sujith 已提交
904 905 906 907 908 909 910 911 912 913 914
error_world:
	ieee80211_unregister_hw(hw);
error_register:
	ath_rx_cleanup(sc);
error_rx:
	ath_tx_cleanup(sc);
error_tx:
	/* Nothing */
error_regd:
	ath9k_deinit_softc(sc);
error_init:
S
Sujith 已提交
915 916 917 918 919 920 921
	return error;
}

/*****************************/
/*     De-Initialization     */
/*****************************/

S
Sujith 已提交
922
static void ath9k_deinit_softc(struct ath_softc *sc)
S
Sujith 已提交
923
{
S
Sujith 已提交
924
	int i = 0;
S
Sujith 已提交
925

926 927 928 929 930 931
	if (sc->sbands[IEEE80211_BAND_2GHZ].channels)
		kfree(sc->sbands[IEEE80211_BAND_2GHZ].channels);

	if (sc->sbands[IEEE80211_BAND_5GHZ].channels)
		kfree(sc->sbands[IEEE80211_BAND_5GHZ].channels);

932
	ath9k_deinit_btcoex(sc);
933

S
Sujith 已提交
934 935 936 937 938
	for (i = 0; i < ATH9K_NUM_TX_QUEUES; i++)
		if (ATH_TXQ_SETUP(sc, i))
			ath_tx_cleanupq(sc, &sc->tx.txq[i]);

	ath9k_hw_deinit(sc->sc_ah);
939 940
	if (sc->dfs_detector != NULL)
		sc->dfs_detector->exit(sc->dfs_detector);
S
Sujith 已提交
941

942
	ath9k_eeprom_release(sc);
S
Sujith 已提交
943 944
	kfree(sc->sc_ah);
	sc->sc_ah = NULL;
S
Sujith 已提交
945 946
}

S
Sujith 已提交
947
void ath9k_deinit_device(struct ath_softc *sc)
S
Sujith 已提交
948 949 950 951 952 953
{
	struct ieee80211_hw *hw = sc->hw;

	ath9k_ps_wakeup(sc);

	wiphy_rfkill_stop_polling(sc->hw->wiphy);
S
Sujith 已提交
954
	ath_deinit_leds(sc);
S
Sujith 已提交
955

956 957
	ath9k_ps_restore(sc);

S
Sujith 已提交
958 959 960
	ieee80211_unregister_hw(hw);
	ath_rx_cleanup(sc);
	ath_tx_cleanup(sc);
S
Sujith 已提交
961
	ath9k_deinit_softc(sc);
S
Sujith 已提交
962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986
}

void ath_descdma_cleanup(struct ath_softc *sc,
			 struct ath_descdma *dd,
			 struct list_head *head)
{
	dma_free_coherent(sc->dev, dd->dd_desc_len, dd->dd_desc,
			  dd->dd_desc_paddr);

	INIT_LIST_HEAD(head);
	kfree(dd->dd_bufptr);
	memset(dd, 0, sizeof(*dd));
}

/************************/
/*     Module Hooks     */
/************************/

static int __init ath9k_init(void)
{
	int error;

	/* Register rate control algorithm */
	error = ath_rate_control_register();
	if (error != 0) {
987 988
		pr_err("Unable to register rate control algorithm: %d\n",
		       error);
S
Sujith 已提交
989 990 991 992 993
		goto err_out;
	}

	error = ath_pci_init();
	if (error < 0) {
994
		pr_err("No PCI devices found, driver not installed\n");
S
Sujith 已提交
995
		error = -ENODEV;
996
		goto err_rate_unregister;
S
Sujith 已提交
997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018
	}

	error = ath_ahb_init();
	if (error < 0) {
		error = -ENODEV;
		goto err_pci_exit;
	}

	return 0;

 err_pci_exit:
	ath_pci_exit();

 err_rate_unregister:
	ath_rate_control_unregister();
 err_out:
	return error;
}
module_init(ath9k_init);

static void __exit ath9k_exit(void)
{
1019
	is_ath9k_unloaded = true;
S
Sujith 已提交
1020 1021 1022
	ath_ahb_exit();
	ath_pci_exit();
	ath_rate_control_unregister();
1023
	pr_info("%s: Driver unloaded\n", dev_info);
S
Sujith 已提交
1024 1025
}
module_exit(ath9k_exit);