core.c 30.3 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
/*
 * Copyright (c) 2005-2011 Atheros Communications Inc.
 * Copyright (c) 2011-2013 Qualcomm Atheros, Inc.
 *
 * 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.
 */

#include <linux/module.h>
#include <linux/firmware.h>
20
#include <linux/of.h>
21 22 23 24 25 26 27 28 29

#include "core.h"
#include "mac.h"
#include "htc.h"
#include "hif.h"
#include "wmi.h"
#include "bmi.h"
#include "debug.h"
#include "htt.h"
K
Kalle Valo 已提交
30
#include "testmode.h"
31 32 33 34

unsigned int ath10k_debug_mask;
static bool uart_print;
static unsigned int ath10k_p2p;
35 36
static bool skip_otp;

37 38 39
module_param_named(debug_mask, ath10k_debug_mask, uint, 0644);
module_param(uart_print, bool, 0644);
module_param_named(p2p, ath10k_p2p, uint, 0644);
40 41
module_param(skip_otp, bool, 0644);

42 43 44
MODULE_PARM_DESC(debug_mask, "Debugging mask");
MODULE_PARM_DESC(uart_print, "Uart target debugging");
MODULE_PARM_DESC(p2p, "Enable ath10k P2P support");
45
MODULE_PARM_DESC(skip_otp, "Skip otp failure for calibration in testmode");
46 47 48 49 50 51

static const struct ath10k_hw_params ath10k_hw_params_list[] = {
	{
		.id = QCA988X_HW_2_0_VERSION,
		.name = "qca988x hw2.0",
		.patch_load_addr = QCA988X_HW_2_0_PATCH_LOAD_ADDR,
52
		.uart_pin = 7,
53 54 55 56 57
		.fw = {
			.dir = QCA988X_HW_2_0_FW_DIR,
			.fw = QCA988X_HW_2_0_FW_FILE,
			.otp = QCA988X_HW_2_0_OTP_FILE,
			.board = QCA988X_HW_2_0_BOARD_DATA_FILE,
58 59
			.board_size = QCA988X_BOARD_DATA_SZ,
			.board_ext_size = QCA988X_BOARD_EXT_DATA_SZ,
60 61 62 63 64 65
		},
	},
};

static void ath10k_send_suspend_complete(struct ath10k *ar)
{
66
	ath10k_dbg(ar, ATH10K_DBG_BOOT, "boot suspend complete\n");
67

68
	complete(&ar->target_suspend);
69 70 71 72 73 74 75 76 77 78 79
}

static int ath10k_init_configure_target(struct ath10k *ar)
{
	u32 param_host;
	int ret;

	/* tell target which HTC version it is used*/
	ret = ath10k_bmi_write32(ar, hi_app_host_interest,
				 HTC_PROTOCOL_VERSION);
	if (ret) {
80
		ath10k_err(ar, "settings HTC version failed\n");
81 82 83 84 85 86
		return ret;
	}

	/* set the firmware mode to STA/IBSS/AP */
	ret = ath10k_bmi_read32(ar, hi_option_flag, &param_host);
	if (ret) {
87
		ath10k_err(ar, "setting firmware mode (1/2) failed\n");
88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105
		return ret;
	}

	/* TODO following parameters need to be re-visited. */
	/* num_device */
	param_host |= (1 << HI_OPTION_NUM_DEV_SHIFT);
	/* Firmware mode */
	/* FIXME: Why FW_MODE_AP ??.*/
	param_host |= (HI_OPTION_FW_MODE_AP << HI_OPTION_FW_MODE_SHIFT);
	/* mac_addr_method */
	param_host |= (1 << HI_OPTION_MAC_ADDR_METHOD_SHIFT);
	/* firmware_bridge */
	param_host |= (0 << HI_OPTION_FW_BRIDGE_SHIFT);
	/* fwsubmode */
	param_host |= (0 << HI_OPTION_FW_SUBMODE_SHIFT);

	ret = ath10k_bmi_write32(ar, hi_option_flag, param_host);
	if (ret) {
106
		ath10k_err(ar, "setting firmware mode (2/2) failed\n");
107 108 109 110 111 112
		return ret;
	}

	/* We do all byte-swapping on the host */
	ret = ath10k_bmi_write32(ar, hi_be, 0);
	if (ret) {
113
		ath10k_err(ar, "setting host CPU BE mode failed\n");
114 115 116 117 118 119 120
		return ret;
	}

	/* FW descriptor/Data swap flags */
	ret = ath10k_bmi_write32(ar, hi_fw_swap, 0);

	if (ret) {
121
		ath10k_err(ar, "setting FW data/desc swap flags failed\n");
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
		return ret;
	}

	return 0;
}

static const struct firmware *ath10k_fetch_fw_file(struct ath10k *ar,
						   const char *dir,
						   const char *file)
{
	char filename[100];
	const struct firmware *fw;
	int ret;

	if (file == NULL)
		return ERR_PTR(-ENOENT);

	if (dir == NULL)
		dir = ".";

	snprintf(filename, sizeof(filename), "%s/%s", dir, file);
	ret = request_firmware(&fw, filename, ar->dev);
	if (ret)
		return ERR_PTR(ret);

	return fw;
}

150 151
static int ath10k_push_board_ext_data(struct ath10k *ar, const void *data,
				      size_t data_len)
152
{
153 154
	u32 board_data_size = ar->hw_params.fw.board_size;
	u32 board_ext_data_size = ar->hw_params.fw.board_ext_size;
155 156 157 158 159
	u32 board_ext_data_addr;
	int ret;

	ret = ath10k_bmi_read32(ar, hi_board_ext_data, &board_ext_data_addr);
	if (ret) {
160 161
		ath10k_err(ar, "could not read board ext data addr (%d)\n",
			   ret);
162 163 164
		return ret;
	}

165
	ath10k_dbg(ar, ATH10K_DBG_BOOT,
166
		   "boot push board extended data addr 0x%x\n",
167 168 169 170 171
		   board_ext_data_addr);

	if (board_ext_data_addr == 0)
		return 0;

172
	if (data_len != (board_data_size + board_ext_data_size)) {
173
		ath10k_err(ar, "invalid board (ext) data sizes %zu != %d+%d\n",
174
			   data_len, board_data_size, board_ext_data_size);
175 176 177 178
		return -EINVAL;
	}

	ret = ath10k_bmi_write_memory(ar, board_ext_data_addr,
179
				      data + board_data_size,
180 181
				      board_ext_data_size);
	if (ret) {
182
		ath10k_err(ar, "could not write board ext data (%d)\n", ret);
183 184 185 186 187 188
		return ret;
	}

	ret = ath10k_bmi_write32(ar, hi_board_ext_data_config,
				 (board_ext_data_size << 16) | 1);
	if (ret) {
189 190
		ath10k_err(ar, "could not write board ext data bit (%d)\n",
			   ret);
191 192 193 194 195 196
		return ret;
	}

	return 0;
}

197 198
static int ath10k_download_board_data(struct ath10k *ar, const void *data,
				      size_t data_len)
199
{
200
	u32 board_data_size = ar->hw_params.fw.board_size;
201 202 203
	u32 address;
	int ret;

204
	ret = ath10k_push_board_ext_data(ar, data, data_len);
205
	if (ret) {
206
		ath10k_err(ar, "could not push board ext data (%d)\n", ret);
207 208 209 210 211
		goto exit;
	}

	ret = ath10k_bmi_read32(ar, hi_board_data, &address);
	if (ret) {
212
		ath10k_err(ar, "could not read board data addr (%d)\n", ret);
213 214 215
		goto exit;
	}

216
	ret = ath10k_bmi_write_memory(ar, address, data,
217
				      min_t(u32, board_data_size,
218
					    data_len));
219
	if (ret) {
220
		ath10k_err(ar, "could not write board data (%d)\n", ret);
221 222 223 224 225
		goto exit;
	}

	ret = ath10k_bmi_write32(ar, hi_board_data_initialized, 1);
	if (ret) {
226
		ath10k_err(ar, "could not write board data bit (%d)\n", ret);
227 228 229 230 231 232 233
		goto exit;
	}

exit:
	return ret;
}

234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255
static int ath10k_download_cal_file(struct ath10k *ar)
{
	int ret;

	if (!ar->cal_file)
		return -ENOENT;

	if (IS_ERR(ar->cal_file))
		return PTR_ERR(ar->cal_file);

	ret = ath10k_download_board_data(ar, ar->cal_file->data,
					 ar->cal_file->size);
	if (ret) {
		ath10k_err(ar, "failed to download cal_file data: %d\n", ret);
		return ret;
	}

	ath10k_dbg(ar, ATH10K_DBG_BOOT, "boot cal file downloaded\n");

	return 0;
}

256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312
static int ath10k_download_cal_dt(struct ath10k *ar)
{
	struct device_node *node;
	int data_len;
	void *data;
	int ret;

	node = ar->dev->of_node;
	if (!node)
		/* Device Tree is optional, don't print any warnings if
		 * there's no node for ath10k.
		 */
		return -ENOENT;

	if (!of_get_property(node, "qcom,ath10k-calibration-data",
			     &data_len)) {
		/* The calibration data node is optional */
		return -ENOENT;
	}

	if (data_len != QCA988X_CAL_DATA_LEN) {
		ath10k_warn(ar, "invalid calibration data length in DT: %d\n",
			    data_len);
		ret = -EMSGSIZE;
		goto out;
	}

	data = kmalloc(data_len, GFP_KERNEL);
	if (!data) {
		ret = -ENOMEM;
		goto out;
	}

	ret = of_property_read_u8_array(node, "qcom,ath10k-calibration-data",
					data, data_len);
	if (ret) {
		ath10k_warn(ar, "failed to read calibration data from DT: %d\n",
			    ret);
		goto out_free;
	}

	ret = ath10k_download_board_data(ar, data, data_len);
	if (ret) {
		ath10k_warn(ar, "failed to download calibration data from Device Tree: %d\n",
			    ret);
		goto out_free;
	}

	ret = 0;

out_free:
	kfree(data);

out:
	return ret;
}

313 314
static int ath10k_download_and_run_otp(struct ath10k *ar)
{
315
	u32 result, address = ar->hw_params.patch_load_addr;
316 317
	int ret;

318
	ret = ath10k_download_board_data(ar, ar->board_data, ar->board_len);
319 320 321 322 323
	if (ret) {
		ath10k_err(ar, "failed to download board data: %d\n", ret);
		return ret;
	}

324 325
	/* OTP is optional */

K
Kalle Valo 已提交
326
	if (!ar->otp_data || !ar->otp_len) {
327
		ath10k_warn(ar, "Not running otp, calibration will be incorrect (otp-data %p otp_len %zd)!\n",
328
			    ar->otp_data, ar->otp_len);
329
		return 0;
K
Kalle Valo 已提交
330 331
	}

332
	ath10k_dbg(ar, ATH10K_DBG_BOOT, "boot upload otp to 0x%x len %zd\n",
K
Kalle Valo 已提交
333
		   address, ar->otp_len);
334

335
	ret = ath10k_bmi_fast_download(ar, address, ar->otp_data, ar->otp_len);
336
	if (ret) {
337
		ath10k_err(ar, "could not write otp (%d)\n", ret);
K
Kalle Valo 已提交
338
		return ret;
339 340
	}

341
	ret = ath10k_bmi_execute(ar, address, 0, &result);
342
	if (ret) {
343
		ath10k_err(ar, "could not execute otp (%d)\n", ret);
K
Kalle Valo 已提交
344
		return ret;
345 346
	}

347
	ath10k_dbg(ar, ATH10K_DBG_BOOT, "boot otp execute result %d\n", result);
K
Kalle Valo 已提交
348

349
	if (!skip_otp && result != 0) {
350
		ath10k_err(ar, "otp calibration failed: %d", result);
K
Kalle Valo 已提交
351 352 353 354
		return -EINVAL;
	}

	return 0;
355 356
}

K
Kalle Valo 已提交
357
static int ath10k_download_fw(struct ath10k *ar, enum ath10k_firmware_mode mode)
358
{
K
Kalle Valo 已提交
359 360 361
	u32 address, data_len;
	const char *mode_name;
	const void *data;
362 363 364 365
	int ret;

	address = ar->hw_params.patch_load_addr;

K
Kalle Valo 已提交
366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386
	switch (mode) {
	case ATH10K_FIRMWARE_MODE_NORMAL:
		data = ar->firmware_data;
		data_len = ar->firmware_len;
		mode_name = "normal";
		break;
	case ATH10K_FIRMWARE_MODE_UTF:
		data = ar->testmode.utf->data;
		data_len = ar->testmode.utf->size;
		mode_name = "utf";
		break;
	default:
		ath10k_err(ar, "unknown firmware mode: %d\n", mode);
		return -EINVAL;
	}

	ath10k_dbg(ar, ATH10K_DBG_BOOT,
		   "boot uploading firmware image %p len %d mode %s\n",
		   data, data_len, mode_name);

	ret = ath10k_bmi_fast_download(ar, address, data, data_len);
387
	if (ret) {
K
Kalle Valo 已提交
388 389 390
		ath10k_err(ar, "failed to download %s firmware: %d\n",
			   mode_name, ret);
		return ret;
391 392
	}

393 394 395 396 397
	return ret;
}

static void ath10k_core_free_firmware_files(struct ath10k *ar)
{
398 399
	if (ar->board && !IS_ERR(ar->board))
		release_firmware(ar->board);
400 401 402 403 404 405 406

	if (ar->otp && !IS_ERR(ar->otp))
		release_firmware(ar->otp);

	if (ar->firmware && !IS_ERR(ar->firmware))
		release_firmware(ar->firmware);

407 408 409
	if (ar->cal_file && !IS_ERR(ar->cal_file))
		release_firmware(ar->cal_file);

410
	ar->board = NULL;
411 412 413
	ar->board_data = NULL;
	ar->board_len = 0;

414
	ar->otp = NULL;
415 416 417
	ar->otp_data = NULL;
	ar->otp_len = 0;

418
	ar->firmware = NULL;
419 420
	ar->firmware_data = NULL;
	ar->firmware_len = 0;
421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441

	ar->cal_file = NULL;
}

static int ath10k_fetch_cal_file(struct ath10k *ar)
{
	char filename[100];

	/* cal-<bus>-<id>.bin */
	scnprintf(filename, sizeof(filename), "cal-%s-%s.bin",
		  ath10k_bus_str(ar->hif.bus), dev_name(ar->dev));

	ar->cal_file = ath10k_fetch_fw_file(ar, ATH10K_FW_DIR, filename);
	if (IS_ERR(ar->cal_file))
		/* calibration file is optional, don't print any warnings */
		return PTR_ERR(ar->cal_file);

	ath10k_dbg(ar, ATH10K_DBG_BOOT, "found calibration file %s/%s\n",
		   ATH10K_FW_DIR, filename);

	return 0;
442 443
}

444
static int ath10k_core_fetch_firmware_api_1(struct ath10k *ar)
445 446 447 448
{
	int ret = 0;

	if (ar->hw_params.fw.fw == NULL) {
449
		ath10k_err(ar, "firmware file not defined\n");
450 451 452 453
		return -EINVAL;
	}

	if (ar->hw_params.fw.board == NULL) {
454
		ath10k_err(ar, "board data file not defined");
455 456 457
		return -EINVAL;
	}

458 459 460 461 462
	ar->board = ath10k_fetch_fw_file(ar,
					 ar->hw_params.fw.dir,
					 ar->hw_params.fw.board);
	if (IS_ERR(ar->board)) {
		ret = PTR_ERR(ar->board);
463
		ath10k_err(ar, "could not fetch board data (%d)\n", ret);
464 465 466
		goto err;
	}

467 468 469
	ar->board_data = ar->board->data;
	ar->board_len = ar->board->size;

470 471 472 473 474
	ar->firmware = ath10k_fetch_fw_file(ar,
					    ar->hw_params.fw.dir,
					    ar->hw_params.fw.fw);
	if (IS_ERR(ar->firmware)) {
		ret = PTR_ERR(ar->firmware);
475
		ath10k_err(ar, "could not fetch firmware (%d)\n", ret);
476 477 478
		goto err;
	}

479 480 481
	ar->firmware_data = ar->firmware->data;
	ar->firmware_len = ar->firmware->size;

482 483 484 485 486 487 488 489 490
	/* OTP may be undefined. If so, don't fetch it at all */
	if (ar->hw_params.fw.otp == NULL)
		return 0;

	ar->otp = ath10k_fetch_fw_file(ar,
				       ar->hw_params.fw.dir,
				       ar->hw_params.fw.otp);
	if (IS_ERR(ar->otp)) {
		ret = PTR_ERR(ar->otp);
491
		ath10k_err(ar, "could not fetch otp (%d)\n", ret);
492 493 494
		goto err;
	}

495 496 497
	ar->otp_data = ar->otp->data;
	ar->otp_len = ar->otp->size;

498 499 500 501
	return 0;

err:
	ath10k_core_free_firmware_files(ar);
502 503 504
	return ret;
}

505 506 507 508 509 510 511 512 513 514 515
static int ath10k_core_fetch_firmware_api_n(struct ath10k *ar, const char *name)
{
	size_t magic_len, len, ie_len;
	int ie_id, i, index, bit, ret;
	struct ath10k_fw_ie *hdr;
	const u8 *data;
	__le32 *timestamp;

	/* first fetch the firmware file (firmware-*.bin) */
	ar->firmware = ath10k_fetch_fw_file(ar, ar->hw_params.fw.dir, name);
	if (IS_ERR(ar->firmware)) {
516
		ath10k_err(ar, "could not fetch firmware file '%s/%s': %ld\n",
517
			   ar->hw_params.fw.dir, name, PTR_ERR(ar->firmware));
518 519 520 521 522 523 524 525 526 527
		return PTR_ERR(ar->firmware);
	}

	data = ar->firmware->data;
	len = ar->firmware->size;

	/* magic also includes the null byte, check that as well */
	magic_len = strlen(ATH10K_FIRMWARE_MAGIC) + 1;

	if (len < magic_len) {
528
		ath10k_err(ar, "firmware file '%s/%s' too small to contain magic: %zu\n",
529
			   ar->hw_params.fw.dir, name, len);
530 531
		ret = -EINVAL;
		goto err;
532 533 534
	}

	if (memcmp(data, ATH10K_FIRMWARE_MAGIC, magic_len) != 0) {
535
		ath10k_err(ar, "invalid firmware magic\n");
536 537
		ret = -EINVAL;
		goto err;
538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556
	}

	/* jump over the padding */
	magic_len = ALIGN(magic_len, 4);

	len -= magic_len;
	data += magic_len;

	/* loop elements */
	while (len > sizeof(struct ath10k_fw_ie)) {
		hdr = (struct ath10k_fw_ie *)data;

		ie_id = le32_to_cpu(hdr->id);
		ie_len = le32_to_cpu(hdr->len);

		len -= sizeof(*hdr);
		data += sizeof(*hdr);

		if (len < ie_len) {
557
			ath10k_err(ar, "invalid length for FW IE %d (%zu < %zu)\n",
558
				   ie_id, len, ie_len);
559 560
			ret = -EINVAL;
			goto err;
561 562 563 564 565 566 567 568 569 570
		}

		switch (ie_id) {
		case ATH10K_FW_IE_FW_VERSION:
			if (ie_len > sizeof(ar->hw->wiphy->fw_version) - 1)
				break;

			memcpy(ar->hw->wiphy->fw_version, data, ie_len);
			ar->hw->wiphy->fw_version[ie_len] = '\0';

571
			ath10k_dbg(ar, ATH10K_DBG_BOOT,
572 573 574 575 576 577 578 579 580
				   "found fw version %s\n",
				    ar->hw->wiphy->fw_version);
			break;
		case ATH10K_FW_IE_TIMESTAMP:
			if (ie_len != sizeof(u32))
				break;

			timestamp = (__le32 *)data;

581
			ath10k_dbg(ar, ATH10K_DBG_BOOT, "found fw timestamp %d\n",
582 583 584
				   le32_to_cpup(timestamp));
			break;
		case ATH10K_FW_IE_FEATURES:
585
			ath10k_dbg(ar, ATH10K_DBG_BOOT,
586 587 588 589 590 591 592 593 594 595
				   "found firmware features ie (%zd B)\n",
				   ie_len);

			for (i = 0; i < ATH10K_FW_FEATURE_COUNT; i++) {
				index = i / 8;
				bit = i % 8;

				if (index == ie_len)
					break;

596
				if (data[index] & (1 << bit)) {
597
					ath10k_dbg(ar, ATH10K_DBG_BOOT,
598 599
						   "Enabling feature bit: %i\n",
						   i);
600
					__set_bit(i, ar->fw_features);
601
				}
602 603
			}

604
			ath10k_dbg_dump(ar, ATH10K_DBG_BOOT, "features", "",
605 606 607 608
					ar->fw_features,
					sizeof(ar->fw_features));
			break;
		case ATH10K_FW_IE_FW_IMAGE:
609
			ath10k_dbg(ar, ATH10K_DBG_BOOT,
610 611 612 613 614 615 616 617
				   "found fw image ie (%zd B)\n",
				   ie_len);

			ar->firmware_data = data;
			ar->firmware_len = ie_len;

			break;
		case ATH10K_FW_IE_OTP_IMAGE:
618
			ath10k_dbg(ar, ATH10K_DBG_BOOT,
619 620 621 622 623 624 625 626
				   "found otp image ie (%zd B)\n",
				   ie_len);

			ar->otp_data = data;
			ar->otp_len = ie_len;

			break;
		default:
627
			ath10k_warn(ar, "Unknown FW IE: %u\n",
628 629 630 631 632 633 634 635 636
				    le32_to_cpu(hdr->id));
			break;
		}

		/* jump over the padding */
		ie_len = ALIGN(ie_len, 4);

		len -= ie_len;
		data += ie_len;
637
	}
638 639

	if (!ar->firmware_data || !ar->firmware_len) {
640
		ath10k_warn(ar, "No ATH10K_FW_IE_FW_IMAGE found from '%s/%s', skipping\n",
641
			    ar->hw_params.fw.dir, name);
642 643 644 645
		ret = -ENOMEDIUM;
		goto err;
	}

646 647
	if (test_bit(ATH10K_FW_FEATURE_WMI_10_2, ar->fw_features) &&
	    !test_bit(ATH10K_FW_FEATURE_WMI_10X, ar->fw_features)) {
648
		ath10k_err(ar, "feature bits corrupted: 10.2 feature requires 10.x feature to be set as well");
649 650 651 652
		ret = -EINVAL;
		goto err;
	}

653 654
	/* now fetch the board file */
	if (ar->hw_params.fw.board == NULL) {
655
		ath10k_err(ar, "board data file not defined");
656 657 658 659 660 661 662 663 664
		ret = -EINVAL;
		goto err;
	}

	ar->board = ath10k_fetch_fw_file(ar,
					 ar->hw_params.fw.dir,
					 ar->hw_params.fw.board);
	if (IS_ERR(ar->board)) {
		ret = PTR_ERR(ar->board);
665
		ath10k_err(ar, "could not fetch board data '%s/%s' (%d)\n",
666 667
			   ar->hw_params.fw.dir, ar->hw_params.fw.board,
			   ret);
668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684
		goto err;
	}

	ar->board_data = ar->board->data;
	ar->board_len = ar->board->size;

	return 0;

err:
	ath10k_core_free_firmware_files(ar);
	return ret;
}

static int ath10k_core_fetch_firmware_files(struct ath10k *ar)
{
	int ret;

685 686 687
	/* calibration file is optional, don't check for any errors */
	ath10k_fetch_cal_file(ar);

688
	ar->fw_api = 3;
689
	ath10k_dbg(ar, ATH10K_DBG_BOOT, "trying fw api %d\n", ar->fw_api);
690 691 692 693 694

	ret = ath10k_core_fetch_firmware_api_n(ar, ATH10K_FW_API3_FILE);
	if (ret == 0)
		goto success;

695
	ar->fw_api = 2;
696
	ath10k_dbg(ar, ATH10K_DBG_BOOT, "trying fw api %d\n", ar->fw_api);
697

698
	ret = ath10k_core_fetch_firmware_api_n(ar, ATH10K_FW_API2_FILE);
699 700 701 702
	if (ret == 0)
		goto success;

	ar->fw_api = 1;
703
	ath10k_dbg(ar, ATH10K_DBG_BOOT, "trying fw api %d\n", ar->fw_api);
704 705 706 707 708

	ret = ath10k_core_fetch_firmware_api_1(ar);
	if (ret)
		return ret;

709
success:
710
	ath10k_dbg(ar, ATH10K_DBG_BOOT, "using fw api %d\n", ar->fw_api);
711 712 713 714

	return 0;
}

715
static int ath10k_download_cal_data(struct ath10k *ar)
716 717 718
{
	int ret;

719 720 721 722 723 724 725
	ret = ath10k_download_cal_file(ar);
	if (ret == 0) {
		ar->cal_mode = ATH10K_CAL_MODE_FILE;
		goto done;
	}

	ath10k_dbg(ar, ATH10K_DBG_BOOT,
726 727 728 729 730 731 732 733 734 735 736
		   "boot did not find a calibration file, try DT next: %d\n",
		   ret);

	ret = ath10k_download_cal_dt(ar);
	if (ret == 0) {
		ar->cal_mode = ATH10K_CAL_MODE_DT;
		goto done;
	}

	ath10k_dbg(ar, ATH10K_DBG_BOOT,
		   "boot did not find DT entry, try OTP next: %d\n",
737 738
		   ret);

739
	ret = ath10k_download_and_run_otp(ar);
740
	if (ret) {
741
		ath10k_err(ar, "failed to run otp: %d\n", ret);
742
		return ret;
743
	}
744

745 746 747 748 749 750
	ar->cal_mode = ATH10K_CAL_MODE_OTP;

done:
	ath10k_dbg(ar, ATH10K_DBG_BOOT, "boot using calibration mode %s\n",
		   ath10k_cal_mode_str(ar->cal_mode));
	return 0;
751 752 753 754 755 756 757 758 759 760 761 762
}

static int ath10k_init_uart(struct ath10k *ar)
{
	int ret;

	/*
	 * Explicitly setting UART prints to zero as target turns it on
	 * based on scratch registers.
	 */
	ret = ath10k_bmi_write32(ar, hi_serial_enable, 0);
	if (ret) {
763
		ath10k_warn(ar, "could not disable UART prints (%d)\n", ret);
764 765 766
		return ret;
	}

767
	if (!uart_print)
768 769
		return 0;

770
	ret = ath10k_bmi_write32(ar, hi_dbg_uart_txpin, ar->hw_params.uart_pin);
771
	if (ret) {
772
		ath10k_warn(ar, "could not enable UART prints (%d)\n", ret);
773 774 775 776 777
		return ret;
	}

	ret = ath10k_bmi_write32(ar, hi_serial_enable, 1);
	if (ret) {
778
		ath10k_warn(ar, "could not enable UART prints (%d)\n", ret);
779 780 781
		return ret;
	}

782 783 784
	/* Set the UART baud rate to 19200. */
	ret = ath10k_bmi_write32(ar, hi_desired_baud_rate, 19200);
	if (ret) {
785
		ath10k_warn(ar, "could not set the baud rate (%d)\n", ret);
786 787 788
		return ret;
	}

789
	ath10k_info(ar, "UART prints enabled\n");
790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805
	return 0;
}

static int ath10k_init_hw_params(struct ath10k *ar)
{
	const struct ath10k_hw_params *uninitialized_var(hw_params);
	int i;

	for (i = 0; i < ARRAY_SIZE(ath10k_hw_params_list); i++) {
		hw_params = &ath10k_hw_params_list[i];

		if (hw_params->id == ar->target_version)
			break;
	}

	if (i == ARRAY_SIZE(ath10k_hw_params_list)) {
806
		ath10k_err(ar, "Unsupported hardware version: 0x%x\n",
807 808 809 810 811 812
			   ar->target_version);
		return -EINVAL;
	}

	ar->hw_params = *hw_params;

813
	ath10k_dbg(ar, ATH10K_DBG_BOOT, "Hardware name %s version 0x%x\n",
814
		   ar->hw_params.name, ar->target_version);
815 816 817 818

	return 0;
}

819 820 821 822
static void ath10k_core_restart(struct work_struct *work)
{
	struct ath10k *ar = container_of(work, struct ath10k, restart_work);

M
Michal Kazior 已提交
823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841
	set_bit(ATH10K_FLAG_CRASH_FLUSH, &ar->dev_flags);

	/* Place a barrier to make sure the compiler doesn't reorder
	 * CRASH_FLUSH and calling other functions.
	 */
	barrier();

	ieee80211_stop_queues(ar->hw);
	ath10k_drain_tx(ar);
	complete_all(&ar->scan.started);
	complete_all(&ar->scan.completed);
	complete_all(&ar->scan.on_channel);
	complete_all(&ar->offchan_tx_completed);
	complete_all(&ar->install_key_done);
	complete_all(&ar->vdev_setup_done);
	wake_up(&ar->htt.empty_tx_wq);
	wake_up(&ar->wmi.tx_credits_wq);
	wake_up(&ar->peer_mapping_wq);

842 843 844 845 846
	mutex_lock(&ar->conf_mutex);

	switch (ar->state) {
	case ATH10K_STATE_ON:
		ar->state = ATH10K_STATE_RESTARTING;
847
		ath10k_hif_stop(ar);
848
		ath10k_scan_finish(ar);
849 850 851
		ieee80211_restart_hw(ar->hw);
		break;
	case ATH10K_STATE_OFF:
852 853
		/* this can happen if driver is being unloaded
		 * or if the crash happens during FW probing */
854
		ath10k_warn(ar, "cannot restart a device that hasn't been started\n");
855 856
		break;
	case ATH10K_STATE_RESTARTING:
857 858
		/* hw restart might be requested from multiple places */
		break;
859 860 861 862
	case ATH10K_STATE_RESTARTED:
		ar->state = ATH10K_STATE_WEDGED;
		/* fall through */
	case ATH10K_STATE_WEDGED:
863
		ath10k_warn(ar, "device is wedged, will not restart\n");
864
		break;
K
Kalle Valo 已提交
865 866 867
	case ATH10K_STATE_UTF:
		ath10k_warn(ar, "firmware restart in UTF mode not supported\n");
		break;
868 869 870 871 872
	}

	mutex_unlock(&ar->conf_mutex);
}

873 874 875 876 877 878 879 880 881 882 883
static void ath10k_core_init_max_sta_count(struct ath10k *ar)
{
	if (test_bit(ATH10K_FW_FEATURE_WMI_10X, ar->fw_features)) {
		ar->max_num_peers = TARGET_10X_NUM_PEERS;
		ar->max_num_stations = TARGET_10X_NUM_STATIONS;
	} else {
		ar->max_num_peers = TARGET_NUM_PEERS;
		ar->max_num_stations = TARGET_NUM_STATIONS;
	}
}

K
Kalle Valo 已提交
884
int ath10k_core_start(struct ath10k *ar, enum ath10k_firmware_mode mode)
885 886 887
{
	int status;

888 889
	lockdep_assert_held(&ar->conf_mutex);

M
Michal Kazior 已提交
890 891
	clear_bit(ATH10K_FLAG_CRASH_FLUSH, &ar->dev_flags);

892 893
	ath10k_bmi_start(ar);

894 895 896 897 898
	if (ath10k_init_configure_target(ar)) {
		status = -EINVAL;
		goto err;
	}

899 900 901 902 903
	status = ath10k_download_cal_data(ar);
	if (status)
		goto err;

	status = ath10k_download_fw(ar, mode);
904 905 906 907 908 909 910
	if (status)
		goto err;

	status = ath10k_init_uart(ar);
	if (status)
		goto err;

911 912
	ar->htc.htc_ops.target_send_suspend_complete =
		ath10k_send_suspend_complete;
913

914 915
	status = ath10k_htc_init(ar);
	if (status) {
916
		ath10k_err(ar, "could not init HTC (%d)\n", status);
917 918 919 920 921
		goto err;
	}

	status = ath10k_bmi_done(ar);
	if (status)
922
		goto err;
923 924 925

	status = ath10k_wmi_attach(ar);
	if (status) {
926
		ath10k_err(ar, "WMI attach failed: %d\n", status);
927
		goto err;
928 929
	}

M
Michal Kazior 已提交
930 931
	status = ath10k_htt_init(ar);
	if (status) {
932
		ath10k_err(ar, "failed to init htt: %d\n", status);
M
Michal Kazior 已提交
933 934 935 936 937
		goto err_wmi_detach;
	}

	status = ath10k_htt_tx_alloc(&ar->htt);
	if (status) {
938
		ath10k_err(ar, "failed to alloc htt tx: %d\n", status);
M
Michal Kazior 已提交
939 940 941 942 943
		goto err_wmi_detach;
	}

	status = ath10k_htt_rx_alloc(&ar->htt);
	if (status) {
944
		ath10k_err(ar, "failed to alloc htt rx: %d\n", status);
M
Michal Kazior 已提交
945 946 947
		goto err_htt_tx_detach;
	}

M
Michal Kazior 已提交
948 949
	status = ath10k_hif_start(ar);
	if (status) {
950
		ath10k_err(ar, "could not start HIF: %d\n", status);
M
Michal Kazior 已提交
951
		goto err_htt_rx_detach;
M
Michal Kazior 已提交
952 953 954 955
	}

	status = ath10k_htc_wait_target(&ar->htc);
	if (status) {
956
		ath10k_err(ar, "failed to connect to HTC: %d\n", status);
M
Michal Kazior 已提交
957 958
		goto err_hif_stop;
	}
959

K
Kalle Valo 已提交
960 961 962 963 964 965
	if (mode == ATH10K_FIRMWARE_MODE_NORMAL) {
		status = ath10k_htt_connect(&ar->htt);
		if (status) {
			ath10k_err(ar, "failed to connect htt (%d)\n", status);
			goto err_hif_stop;
		}
966 967
	}

M
Michal Kazior 已提交
968 969
	status = ath10k_wmi_connect(ar);
	if (status) {
970
		ath10k_err(ar, "could not connect wmi: %d\n", status);
M
Michal Kazior 已提交
971 972 973 974 975
		goto err_hif_stop;
	}

	status = ath10k_htc_start(&ar->htc);
	if (status) {
976
		ath10k_err(ar, "failed to start htc: %d\n", status);
M
Michal Kazior 已提交
977 978 979
		goto err_hif_stop;
	}

K
Kalle Valo 已提交
980 981 982 983 984 985 986
	if (mode == ATH10K_FIRMWARE_MODE_NORMAL) {
		status = ath10k_wmi_wait_for_service_ready(ar);
		if (status <= 0) {
			ath10k_warn(ar, "wmi service ready event not received");
			status = -ETIMEDOUT;
			goto err_hif_stop;
		}
M
Michal Kazior 已提交
987
	}
988

989
	ath10k_dbg(ar, ATH10K_DBG_BOOT, "firmware %s booted\n",
990
		   ar->hw->wiphy->fw_version);
991 992 993

	status = ath10k_wmi_cmd_init(ar);
	if (status) {
994 995
		ath10k_err(ar, "could not send WMI init command (%d)\n",
			   status);
M
Michal Kazior 已提交
996
		goto err_hif_stop;
997 998 999 1000
	}

	status = ath10k_wmi_wait_for_unified_ready(ar);
	if (status <= 0) {
1001
		ath10k_err(ar, "wmi unified ready event not received\n");
1002
		status = -ETIMEDOUT;
M
Michal Kazior 已提交
1003
		goto err_hif_stop;
1004 1005
	}

K
Kalle Valo 已提交
1006 1007 1008 1009 1010 1011 1012
	/* we don't care about HTT in UTF mode */
	if (mode == ATH10K_FIRMWARE_MODE_NORMAL) {
		status = ath10k_htt_setup(&ar->htt);
		if (status) {
			ath10k_err(ar, "failed to setup htt: %d\n", status);
			goto err_hif_stop;
		}
M
Michal Kazior 已提交
1013
	}
1014

1015 1016
	status = ath10k_debug_start(ar);
	if (status)
M
Michal Kazior 已提交
1017
		goto err_hif_stop;
1018

1019
	if (test_bit(ATH10K_FW_FEATURE_WMI_10X, ar->fw_features))
B
Ben Greear 已提交
1020
		ar->free_vdev_map = (1LL << TARGET_10X_NUM_VDEVS) - 1;
1021
	else
B
Ben Greear 已提交
1022
		ar->free_vdev_map = (1LL << TARGET_NUM_VDEVS) - 1;
1023

M
Michal Kazior 已提交
1024
	INIT_LIST_HEAD(&ar->arvifs);
1025

1026 1027
	return 0;

M
Michal Kazior 已提交
1028 1029
err_hif_stop:
	ath10k_hif_stop(ar);
M
Michal Kazior 已提交
1030 1031 1032 1033
err_htt_rx_detach:
	ath10k_htt_rx_free(&ar->htt);
err_htt_tx_detach:
	ath10k_htt_tx_free(&ar->htt);
1034 1035 1036 1037 1038
err_wmi_detach:
	ath10k_wmi_detach(ar);
err:
	return status;
}
1039
EXPORT_SYMBOL(ath10k_core_start);
1040

1041 1042 1043 1044 1045 1046 1047 1048
int ath10k_wait_for_suspend(struct ath10k *ar, u32 suspend_opt)
{
	int ret;

	reinit_completion(&ar->target_suspend);

	ret = ath10k_wmi_pdev_suspend_target(ar, suspend_opt);
	if (ret) {
1049
		ath10k_warn(ar, "could not suspend target (%d)\n", ret);
1050 1051 1052 1053 1054 1055
		return ret;
	}

	ret = wait_for_completion_timeout(&ar->target_suspend, 1 * HZ);

	if (ret == 0) {
1056
		ath10k_warn(ar, "suspend timed out - target pause event never came\n");
1057 1058 1059 1060 1061 1062
		return -ETIMEDOUT;
	}

	return 0;
}

1063 1064
void ath10k_core_stop(struct ath10k *ar)
{
1065 1066
	lockdep_assert_held(&ar->conf_mutex);

1067
	/* try to suspend target */
K
Kalle Valo 已提交
1068 1069
	if (ar->state != ATH10K_STATE_RESTARTING &&
	    ar->state != ATH10K_STATE_UTF)
1070 1071
		ath10k_wait_for_suspend(ar, WMI_PDEV_SUSPEND_AND_DISABLE_INTR);

1072
	ath10k_debug_stop(ar);
M
Michal Kazior 已提交
1073 1074 1075
	ath10k_hif_stop(ar);
	ath10k_htt_tx_free(&ar->htt);
	ath10k_htt_rx_free(&ar->htt);
1076 1077
	ath10k_wmi_detach(ar);
}
1078 1079 1080 1081 1082 1083 1084 1085
EXPORT_SYMBOL(ath10k_core_stop);

/* mac80211 manages fw/hw initialization through start/stop hooks. However in
 * order to know what hw capabilities should be advertised to mac80211 it is
 * necessary to load the firmware (and tear it down immediately since start
 * hook will try to init it again) before registering */
static int ath10k_core_probe_fw(struct ath10k *ar)
{
1086 1087
	struct bmi_target_info target_info;
	int ret = 0;
1088 1089 1090

	ret = ath10k_hif_power_up(ar);
	if (ret) {
1091
		ath10k_err(ar, "could not start pci hif (%d)\n", ret);
1092 1093 1094
		return ret;
	}

1095 1096 1097
	memset(&target_info, 0, sizeof(target_info));
	ret = ath10k_bmi_get_target_info(ar, &target_info);
	if (ret) {
1098
		ath10k_err(ar, "could not get target info (%d)\n", ret);
1099 1100 1101 1102 1103 1104 1105 1106 1107
		ath10k_hif_power_down(ar);
		return ret;
	}

	ar->target_version = target_info.version;
	ar->hw->wiphy->hw_version = target_info.version;

	ret = ath10k_init_hw_params(ar);
	if (ret) {
1108
		ath10k_err(ar, "could not get hw params (%d)\n", ret);
1109 1110 1111 1112 1113 1114
		ath10k_hif_power_down(ar);
		return ret;
	}

	ret = ath10k_core_fetch_firmware_files(ar);
	if (ret) {
1115
		ath10k_err(ar, "could not fetch firmware files (%d)\n", ret);
1116 1117 1118 1119
		ath10k_hif_power_down(ar);
		return ret;
	}

1120 1121
	ath10k_core_init_max_sta_count(ar);

1122 1123
	mutex_lock(&ar->conf_mutex);

K
Kalle Valo 已提交
1124
	ret = ath10k_core_start(ar, ATH10K_FIRMWARE_MODE_NORMAL);
1125
	if (ret) {
1126
		ath10k_err(ar, "could not init core (%d)\n", ret);
1127
		ath10k_core_free_firmware_files(ar);
1128
		ath10k_hif_power_down(ar);
1129
		mutex_unlock(&ar->conf_mutex);
1130 1131 1132
		return ret;
	}

M
Michal Kazior 已提交
1133
	ath10k_print_driver_info(ar);
1134
	ath10k_core_stop(ar);
1135 1136 1137

	mutex_unlock(&ar->conf_mutex);

1138 1139 1140
	ath10k_hif_power_down(ar);
	return 0;
}
1141

1142
static void ath10k_core_register_work(struct work_struct *work)
1143
{
1144
	struct ath10k *ar = container_of(work, struct ath10k, register_work);
1145 1146
	int status;

1147 1148
	status = ath10k_core_probe_fw(ar);
	if (status) {
1149
		ath10k_err(ar, "could not probe fw (%d)\n", status);
1150
		goto err;
1151
	}
1152

1153
	status = ath10k_mac_register(ar);
1154
	if (status) {
1155
		ath10k_err(ar, "could not register to mac80211 (%d)\n", status);
1156
		goto err_release_fw;
1157
	}
1158

1159
	status = ath10k_debug_register(ar);
1160
	if (status) {
1161
		ath10k_err(ar, "unable to initialize debugfs\n");
1162 1163 1164
		goto err_unregister_mac;
	}

1165 1166
	status = ath10k_spectral_create(ar);
	if (status) {
1167
		ath10k_err(ar, "failed to initialize spectral\n");
1168 1169 1170
		goto err_debug_destroy;
	}

1171 1172
	set_bit(ATH10K_FLAG_CORE_REGISTERED, &ar->dev_flags);
	return;
1173

1174 1175
err_debug_destroy:
	ath10k_debug_destroy(ar);
1176 1177
err_unregister_mac:
	ath10k_mac_unregister(ar);
1178 1179
err_release_fw:
	ath10k_core_free_firmware_files(ar);
1180
err:
1181 1182 1183
	/* TODO: It's probably a good idea to release device from the driver
	 * but calling device_release_driver() here will cause a deadlock.
	 */
1184 1185 1186 1187 1188 1189 1190 1191 1192
	return;
}

int ath10k_core_register(struct ath10k *ar, u32 chip_id)
{
	ar->chip_id = chip_id;
	queue_work(ar->workqueue, &ar->register_work);

	return 0;
1193 1194 1195 1196 1197
}
EXPORT_SYMBOL(ath10k_core_register);

void ath10k_core_unregister(struct ath10k *ar)
{
1198 1199 1200 1201 1202
	cancel_work_sync(&ar->register_work);

	if (!test_bit(ATH10K_FLAG_CORE_REGISTERED, &ar->dev_flags))
		return;

1203 1204 1205 1206 1207 1208
	/* Stop spectral before unregistering from mac80211 to remove the
	 * relayfs debugfs file cleanly. Otherwise the parent debugfs tree
	 * would be already be free'd recursively, leading to a double free.
	 */
	ath10k_spectral_destroy(ar);

1209 1210 1211 1212
	/* We must unregister from mac80211 before we stop HTC and HIF.
	 * Otherwise we will fail to submit commands to FW and mac80211 will be
	 * unhappy about callback failures. */
	ath10k_mac_unregister(ar);
1213

K
Kalle Valo 已提交
1214 1215
	ath10k_testmode_destroy(ar);

1216
	ath10k_core_free_firmware_files(ar);
1217

1218
	ath10k_debug_unregister(ar);
1219 1220 1221
}
EXPORT_SYMBOL(ath10k_core_unregister);

M
Michal Kazior 已提交
1222
struct ath10k *ath10k_core_create(size_t priv_size, struct device *dev,
K
Kalle Valo 已提交
1223
				  enum ath10k_bus bus,
1224 1225 1226
				  const struct ath10k_hif_ops *hif_ops)
{
	struct ath10k *ar;
1227
	int ret;
1228

M
Michal Kazior 已提交
1229
	ar = ath10k_mac_create(priv_size);
1230 1231 1232 1233 1234 1235 1236 1237 1238 1239
	if (!ar)
		return NULL;

	ar->ath_common.priv = ar;
	ar->ath_common.hw = ar->hw;

	ar->p2p = !!ath10k_p2p;
	ar->dev = dev;

	ar->hif.ops = hif_ops;
K
Kalle Valo 已提交
1240
	ar->hif.bus = bus;
1241 1242 1243 1244 1245 1246 1247 1248 1249

	init_completion(&ar->scan.started);
	init_completion(&ar->scan.completed);
	init_completion(&ar->scan.on_channel);
	init_completion(&ar->target_suspend);

	init_completion(&ar->install_key_done);
	init_completion(&ar->vdev_setup_done);

1250
	INIT_DELAYED_WORK(&ar->scan.timeout, ath10k_scan_timeout_work);
1251 1252 1253

	ar->workqueue = create_singlethread_workqueue("ath10k_wq");
	if (!ar->workqueue)
1254
		goto err_free_mac;
1255 1256 1257 1258 1259 1260

	mutex_init(&ar->conf_mutex);
	spin_lock_init(&ar->data_lock);

	INIT_LIST_HEAD(&ar->peers);
	init_waitqueue_head(&ar->peer_mapping_wq);
M
Michal Kazior 已提交
1261 1262
	init_waitqueue_head(&ar->htt.empty_tx_wq);
	init_waitqueue_head(&ar->wmi.tx_credits_wq);
1263 1264 1265 1266 1267 1268 1269 1270

	init_completion(&ar->offchan_tx_completed);
	INIT_WORK(&ar->offchan_tx_work, ath10k_offchan_tx_work);
	skb_queue_head_init(&ar->offchan_tx_queue);

	INIT_WORK(&ar->wmi_mgmt_tx_work, ath10k_mgmt_over_wmi_tx_work);
	skb_queue_head_init(&ar->wmi_mgmt_tx_queue);

1271
	INIT_WORK(&ar->register_work, ath10k_core_register_work);
1272 1273
	INIT_WORK(&ar->restart_work, ath10k_core_restart);

1274 1275 1276 1277
	ret = ath10k_debug_create(ar);
	if (ret)
		goto err_free_wq;

1278 1279
	return ar;

1280 1281 1282 1283
err_free_wq:
	destroy_workqueue(ar->workqueue);

err_free_mac:
1284
	ath10k_mac_destroy(ar);
1285

1286 1287 1288 1289 1290 1291 1292 1293 1294
	return NULL;
}
EXPORT_SYMBOL(ath10k_core_create);

void ath10k_core_destroy(struct ath10k *ar)
{
	flush_workqueue(ar->workqueue);
	destroy_workqueue(ar->workqueue);

1295
	ath10k_debug_destroy(ar);
1296 1297 1298 1299
	ath10k_mac_destroy(ar);
}
EXPORT_SYMBOL(ath10k_core_destroy);

1300 1301 1302
MODULE_AUTHOR("Qualcomm Atheros");
MODULE_DESCRIPTION("Core module for QCA988X PCIe devices.");
MODULE_LICENSE("Dual BSD/GPL");