drivers/net/wireless/ath/ath10k/core.c

   1 /*
   2  * Copyright (c) 2005-2011 Atheros Communications Inc.
   3  * Copyright (c) 2011-2013 Qualcomm Atheros, Inc.
   4  *
   5  * Permission to use, copy, modify, and/or distribute this software for any
   6  * purpose with or without fee is hereby granted, provided that the above
   7  * copyright notice and this permission notice appear in all copies.
   8  *
   9  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  10  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  11  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  12  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  13  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  14  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  15  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  16  */
  17
  18 #include <linux/module.h>
  19 #include <linux/firmware.h>
  20
  21 #include "core.h"
  22 #include "mac.h"
  23 #include "htc.h"
  24 #include "hif.h"
  25 #include "wmi.h"
  26 #include "bmi.h"
  27 #include "debug.h"
  28 #include "htt.h"
  29
  30 unsigned int ath10k_debug_mask;
  31 static bool uart_print;
  32 static unsigned int ath10k_p2p;
  33 module_param_named(debug_mask, ath10k_debug_mask, uint, 0644);
  34 module_param(uart_print, bool, 0644);
  35 module_param_named(p2p, ath10k_p2p, uint, 0644);
  36 MODULE_PARM_DESC(debug_mask, "Debugging mask");
  37 MODULE_PARM_DESC(uart_print, "Uart target debugging");
  38 MODULE_PARM_DESC(p2p, "Enable ath10k P2P support");
  39
  40 static const struct ath10k_hw_params ath10k_hw_params_list[] = {
  41         {
  42                 .id = QCA988X_HW_2_0_VERSION,
  43                 .name = "qca988x hw2.0",
  44                 .patch_load_addr = QCA988X_HW_2_0_PATCH_LOAD_ADDR,
  45                 .fw = {
  46                         .dir = QCA988X_HW_2_0_FW_DIR,
  47                         .fw = QCA988X_HW_2_0_FW_FILE,
  48                         .otp = QCA988X_HW_2_0_OTP_FILE,
  49                         .board = QCA988X_HW_2_0_BOARD_DATA_FILE,
  50                 },
  51         },
  52 };
  53
  54 static void ath10k_send_suspend_complete(struct ath10k *ar)
  55 {
  56         ath10k_dbg(ATH10K_DBG_BOOT, "boot suspend complete\n");
  57
  58         ar->is_target_paused = true;
  59         wake_up(&ar->event_queue);
  60 }
  61
  62 static int ath10k_init_connect_htc(struct ath10k *ar)
  63 {
  64         int status;
  65
  66         status = ath10k_wmi_connect_htc_service(ar);
  67         if (status)
  68                 goto conn_fail;
  69
  70         /* Start HTC */
  71         status = ath10k_htc_start(&ar->htc);
  72         if (status)
  73                 goto conn_fail;
  74
  75         /* Wait for WMI event to be ready */
  76         status = ath10k_wmi_wait_for_service_ready(ar);
  77         if (status <= 0) {
  78                 ath10k_warn("wmi service ready event not received");
  79                 status = -ETIMEDOUT;
  80                 goto timeout;
  81         }
  82
  83         ath10k_dbg(ATH10K_DBG_BOOT, "boot wmi ready\n");
  84         return 0;
  85
  86 timeout:
  87         ath10k_htc_stop(&ar->htc);
  88 conn_fail:
  89         return status;
  90 }
  91
  92 static int ath10k_init_configure_target(struct ath10k *ar)
  93 {
  94         u32 param_host;
  95         int ret;
  96
  97         /* tell target which HTC version it is used*/
  98         ret = ath10k_bmi_write32(ar, hi_app_host_interest,
  99                                  HTC_PROTOCOL_VERSION);
 100         if (ret) {
 101                 ath10k_err("settings HTC version failed\n");
 102                 return ret;
 103         }
 104
 105         /* set the firmware mode to STA/IBSS/AP */
 106         ret = ath10k_bmi_read32(ar, hi_option_flag, &param_host);
 107         if (ret) {
 108                 ath10k_err("setting firmware mode (1/2) failed\n");
 109                 return ret;
 110         }
 111
 112         /* TODO following parameters need to be re-visited. */
 113         /* num_device */
 114         param_host |= (1 << HI_OPTION_NUM_DEV_SHIFT);
 115         /* Firmware mode */
 116         /* FIXME: Why FW_MODE_AP ??.*/
 117         param_host |= (HI_OPTION_FW_MODE_AP << HI_OPTION_FW_MODE_SHIFT);
 118         /* mac_addr_method */
 119         param_host |= (1 << HI_OPTION_MAC_ADDR_METHOD_SHIFT);
 120         /* firmware_bridge */
 121         param_host |= (0 << HI_OPTION_FW_BRIDGE_SHIFT);
 122         /* fwsubmode */
 123         param_host |= (0 << HI_OPTION_FW_SUBMODE_SHIFT);
 124
 125         ret = ath10k_bmi_write32(ar, hi_option_flag, param_host);
 126         if (ret) {
 127                 ath10k_err("setting firmware mode (2/2) failed\n");
 128                 return ret;
 129         }
 130
 131         /* We do all byte-swapping on the host */
 132         ret = ath10k_bmi_write32(ar, hi_be, 0);
 133         if (ret) {
 134                 ath10k_err("setting host CPU BE mode failed\n");
 135                 return ret;
 136         }
 137
 138         /* FW descriptor/Data swap flags */
 139         ret = ath10k_bmi_write32(ar, hi_fw_swap, 0);
 140
 141         if (ret) {
 142                 ath10k_err("setting FW data/desc swap flags failed\n");
 143                 return ret;
 144         }
 145
 146         return 0;
 147 }
 148
 149 static const struct firmware *ath10k_fetch_fw_file(struct ath10k *ar,
 150                                                    const char *dir,
 151                                                    const char *file)
 152 {
 153         char filename[100];
 154         const struct firmware *fw;
 155         int ret;
 156
 157         if (file == NULL)
 158                 return ERR_PTR(-ENOENT);
 159
 160         if (dir == NULL)
 161                 dir = ".";
 162
 163         snprintf(filename, sizeof(filename), "%s/%s", dir, file);
 164         ret = request_firmware(&fw, filename, ar->dev);
 165         if (ret)
 166                 return ERR_PTR(ret);
 167
 168         return fw;
 169 }
 170
 171 static int ath10k_push_board_ext_data(struct ath10k *ar)
 172 {
 173         u32 board_data_size = QCA988X_BOARD_DATA_SZ;
 174         u32 board_ext_data_size = QCA988X_BOARD_EXT_DATA_SZ;
 175         u32 board_ext_data_addr;
 176         int ret;
 177
 178         ret = ath10k_bmi_read32(ar, hi_board_ext_data, &board_ext_data_addr);
 179         if (ret) {
 180                 ath10k_err("could not read board ext data addr (%d)\n", ret);
 181                 return ret;
 182         }
 183
 184         ath10k_dbg(ATH10K_DBG_BOOT,
 185                    "boot push board extended data addr 0x%x\n",
 186                    board_ext_data_addr);
 187
 188         if (board_ext_data_addr == 0)
 189                 return 0;
 190
 191         if (ar->board_len != (board_data_size + board_ext_data_size)) {
 192                 ath10k_err("invalid board (ext) data sizes %zu != %d+%d\n",
 193                            ar->board_len, board_data_size, board_ext_data_size);
 194                 return -EINVAL;
 195         }
 196
 197         ret = ath10k_bmi_write_memory(ar, board_ext_data_addr,
 198                                       ar->board_data + board_data_size,
 199                                       board_ext_data_size);
 200         if (ret) {
 201                 ath10k_err("could not write board ext data (%d)\n", ret);
 202                 return ret;
 203         }
 204
 205         ret = ath10k_bmi_write32(ar, hi_board_ext_data_config,
 206                                  (board_ext_data_size << 16) | 1);
 207         if (ret) {
 208                 ath10k_err("could not write board ext data bit (%d)\n", ret);
 209                 return ret;
 210         }
 211
 212         return 0;
 213 }
 214
 215 static int ath10k_download_board_data(struct ath10k *ar)
 216 {
 217         u32 board_data_size = QCA988X_BOARD_DATA_SZ;
 218         u32 address;
 219         int ret;
 220
 221         ret = ath10k_push_board_ext_data(ar);
 222         if (ret) {
 223                 ath10k_err("could not push board ext data (%d)\n", ret);
 224                 goto exit;
 225         }
 226
 227         ret = ath10k_bmi_read32(ar, hi_board_data, &address);
 228         if (ret) {
 229                 ath10k_err("could not read board data addr (%d)\n", ret);
 230                 goto exit;
 231         }
 232
 233         ret = ath10k_bmi_write_memory(ar, address, ar->board_data,
 234                                       min_t(u32, board_data_size,
 235                                             ar->board_len));
 236         if (ret) {
 237                 ath10k_err("could not write board data (%d)\n", ret);
 238                 goto exit;
 239         }
 240
 241         ret = ath10k_bmi_write32(ar, hi_board_data_initialized, 1);
 242         if (ret) {
 243                 ath10k_err("could not write board data bit (%d)\n", ret);
 244                 goto exit;
 245         }
 246
 247 exit:
 248         return ret;
 249 }
 250
 251 static int ath10k_download_and_run_otp(struct ath10k *ar)
 252 {
 253         u32 address = ar->hw_params.patch_load_addr;
 254         u32 exec_param;
 255         int ret;
 256
 257         /* OTP is optional */
 258
 259         if (!ar->otp_data || !ar->otp_len)
 260                 return 0;
 261
 262         ret = ath10k_bmi_fast_download(ar, address, ar->otp_data, ar->otp_len);
 263         if (ret) {
 264                 ath10k_err("could not write otp (%d)\n", ret);
 265                 goto exit;
 266         }
 267
 268         exec_param = 0;
 269         ret = ath10k_bmi_execute(ar, address, &exec_param);
 270         if (ret) {
 271                 ath10k_err("could not execute otp (%d)\n", ret);
 272                 goto exit;
 273         }
 274
 275 exit:
 276         return ret;
 277 }
 278
 279 static int ath10k_download_fw(struct ath10k *ar)
 280 {
 281         u32 address;
 282         int ret;
 283
 284         address = ar->hw_params.patch_load_addr;
 285
 286         ret = ath10k_bmi_fast_download(ar, address, ar->firmware_data,
 287                                        ar->firmware_len);
 288         if (ret) {
 289                 ath10k_err("could not write fw (%d)\n", ret);
 290                 goto exit;
 291         }
 292
 293 exit:
 294         return ret;
 295 }
 296
 297 static void ath10k_core_free_firmware_files(struct ath10k *ar)
 298 {
 299         if (ar->board && !IS_ERR(ar->board))
 300                 release_firmware(ar->board);
 301
 302         if (ar->otp && !IS_ERR(ar->otp))
 303                 release_firmware(ar->otp);
 304
 305         if (ar->firmware && !IS_ERR(ar->firmware))
 306                 release_firmware(ar->firmware);
 307
 308         ar->board = NULL;
 309         ar->board_data = NULL;
 310         ar->board_len = 0;
 311
 312         ar->otp = NULL;
 313         ar->otp_data = NULL;
 314         ar->otp_len = 0;
 315
 316         ar->firmware = NULL;
 317         ar->firmware_data = NULL;
 318         ar->firmware_len = 0;
 319 }
 320
 321 static int ath10k_core_fetch_firmware_api_1(struct ath10k *ar)
 322 {
 323         int ret = 0;
 324
 325         if (ar->hw_params.fw.fw == NULL) {
 326                 ath10k_err("firmware file not defined\n");
 327                 return -EINVAL;
 328         }
 329
 330         if (ar->hw_params.fw.board == NULL) {
 331                 ath10k_err("board data file not defined");
 332                 return -EINVAL;
 333         }
 334
 335         ar->board = ath10k_fetch_fw_file(ar,
 336                                          ar->hw_params.fw.dir,
 337                                          ar->hw_params.fw.board);
 338         if (IS_ERR(ar->board)) {
 339                 ret = PTR_ERR(ar->board);
 340                 ath10k_err("could not fetch board data (%d)\n", ret);
 341                 goto err;
 342         }
 343
 344         ar->board_data = ar->board->data;
 345         ar->board_len = ar->board->size;
 346
 347         ar->firmware = ath10k_fetch_fw_file(ar,
 348                                             ar->hw_params.fw.dir,
 349                                             ar->hw_params.fw.fw);
 350         if (IS_ERR(ar->firmware)) {
 351                 ret = PTR_ERR(ar->firmware);
 352                 ath10k_err("could not fetch firmware (%d)\n", ret);
 353                 goto err;
 354         }
 355
 356         ar->firmware_data = ar->firmware->data;
 357         ar->firmware_len = ar->firmware->size;
 358
 359         /* OTP may be undefined. If so, don't fetch it at all */
 360         if (ar->hw_params.fw.otp == NULL)
 361                 return 0;
 362
 363         ar->otp = ath10k_fetch_fw_file(ar,
 364                                        ar->hw_params.fw.dir,
 365                                        ar->hw_params.fw.otp);
 366         if (IS_ERR(ar->otp)) {
 367                 ret = PTR_ERR(ar->otp);
 368                 ath10k_err("could not fetch otp (%d)\n", ret);
 369                 goto err;
 370         }
 371
 372         ar->otp_data = ar->otp->data;
 373         ar->otp_len = ar->otp->size;
 374
 375         return 0;
 376
 377 err:
 378         ath10k_core_free_firmware_files(ar);
 379         return ret;
 380 }
 381
 382 static int ath10k_core_fetch_firmware_api_n(struct ath10k *ar, const char *name)
 383 {
 384         size_t magic_len, len, ie_len;
 385         int ie_id, i, index, bit, ret;
 386         struct ath10k_fw_ie *hdr;
 387         const u8 *data;
 388         __le32 *timestamp;
 389
 390         /* first fetch the firmware file (firmware-*.bin) */
 391         ar->firmware = ath10k_fetch_fw_file(ar, ar->hw_params.fw.dir, name);
 392         if (IS_ERR(ar->firmware)) {
 393                 ath10k_err("Could not fetch firmware file '%s': %ld\n",
 394                            name, PTR_ERR(ar->firmware));
 395                 return PTR_ERR(ar->firmware);
 396         }
 397
 398         data = ar->firmware->data;
 399         len = ar->firmware->size;
 400
 401         /* magic also includes the null byte, check that as well */
 402         magic_len = strlen(ATH10K_FIRMWARE_MAGIC) + 1;
 403
 404         if (len < magic_len) {
 405                 ath10k_err("firmware image too small to contain magic: %zu\n",
 406                            len);
 407                 ret = -EINVAL;
 408                 goto err;
 409         }
 410
 411         if (memcmp(data, ATH10K_FIRMWARE_MAGIC, magic_len) != 0) {
 412                 ath10k_err("Invalid firmware magic\n");
 413                 ret = -EINVAL;
 414                 goto err;
 415         }
 416
 417         /* jump over the padding */
 418         magic_len = ALIGN(magic_len, 4);
 419
 420         len -= magic_len;
 421         data += magic_len;
 422
 423         /* loop elements */
 424         while (len > sizeof(struct ath10k_fw_ie)) {
 425                 hdr = (struct ath10k_fw_ie *)data;
 426
 427                 ie_id = le32_to_cpu(hdr->id);
 428                 ie_len = le32_to_cpu(hdr->len);
 429
 430                 len -= sizeof(*hdr);
 431                 data += sizeof(*hdr);
 432
 433                 if (len < ie_len) {
 434                         ath10k_err("Invalid length for FW IE %d (%zu < %zu)\n",
 435                                    ie_id, len, ie_len);
 436                         ret = -EINVAL;
 437                         goto err;
 438                 }
 439
 440                 switch (ie_id) {
 441                 case ATH10K_FW_IE_FW_VERSION:
 442                         if (ie_len > sizeof(ar->hw->wiphy->fw_version) - 1)
 443                                 break;
 444
 445                         memcpy(ar->hw->wiphy->fw_version, data, ie_len);
 446                         ar->hw->wiphy->fw_version[ie_len] = '\0';
 447
 448                         ath10k_dbg(ATH10K_DBG_BOOT,
 449                                    "found fw version %s\n",
 450                                     ar->hw->wiphy->fw_version);
 451                         break;
 452                 case ATH10K_FW_IE_TIMESTAMP:
 453                         if (ie_len != sizeof(u32))
 454                                 break;
 455
 456                         timestamp = (__le32 *)data;
 457
 458                         ath10k_dbg(ATH10K_DBG_BOOT, "found fw timestamp %d\n",
 459                                    le32_to_cpup(timestamp));
 460                         break;
 461                 case ATH10K_FW_IE_FEATURES:
 462                         ath10k_dbg(ATH10K_DBG_BOOT,
 463                                    "found firmware features ie (%zd B)\n",
 464                                    ie_len);
 465
 466                         for (i = 0; i < ATH10K_FW_FEATURE_COUNT; i++) {
 467                                 index = i / 8;
 468                                 bit = i % 8;
 469
 470                                 if (index == ie_len)
 471                                         break;
 472
 473                                 if (data[index] & (1 << bit))
 474                                         __set_bit(i, ar->fw_features);
 475                         }
 476
 477                         ath10k_dbg_dump(ATH10K_DBG_BOOT, "features", "",
 478                                         ar->fw_features,
 479                                         sizeof(ar->fw_features));
 480                         break;
 481                 case ATH10K_FW_IE_FW_IMAGE:
 482                         ath10k_dbg(ATH10K_DBG_BOOT,
 483                                    "found fw image ie (%zd B)\n",
 484                                    ie_len);
 485
 486                         ar->firmware_data = data;
 487                         ar->firmware_len = ie_len;
 488
 489                         break;
 490                 case ATH10K_FW_IE_OTP_IMAGE:
 491                         ath10k_dbg(ATH10K_DBG_BOOT,
 492                                    "found otp image ie (%zd B)\n",
 493                                    ie_len);
 494
 495                         ar->otp_data = data;
 496                         ar->otp_len = ie_len;
 497
 498                         break;
 499                 default:
 500                         ath10k_warn("Unknown FW IE: %u\n",
 501                                     le32_to_cpu(hdr->id));
 502                         break;
 503                 }
 504
 505                 /* jump over the padding */
 506                 ie_len = ALIGN(ie_len, 4);
 507
 508                 len -= ie_len;
 509                 data += ie_len;
 510         }
 511
 512         if (!ar->firmware_data || !ar->firmware_len) {
 513                 ath10k_warn("No ATH10K_FW_IE_FW_IMAGE found from %s, skipping\n",
 514                             name);
 515                 ret = -ENOMEDIUM;
 516                 goto err;
 517         }
 518
 519         /* now fetch the board file */
 520         if (ar->hw_params.fw.board == NULL) {
 521                 ath10k_err("board data file not defined");
 522                 ret = -EINVAL;
 523                 goto err;
 524         }
 525
 526         ar->board = ath10k_fetch_fw_file(ar,
 527                                          ar->hw_params.fw.dir,
 528                                          ar->hw_params.fw.board);
 529         if (IS_ERR(ar->board)) {
 530                 ret = PTR_ERR(ar->board);
 531                 ath10k_err("could not fetch board data (%d)\n", ret);
 532                 goto err;
 533         }
 534
 535         ar->board_data = ar->board->data;
 536         ar->board_len = ar->board->size;
 537
 538         return 0;
 539
 540 err:
 541         ath10k_core_free_firmware_files(ar);
 542         return ret;
 543 }
 544
 545 static int ath10k_core_fetch_firmware_files(struct ath10k *ar)
 546 {
 547         int ret;
 548
 549         ret = ath10k_core_fetch_firmware_api_n(ar, ATH10K_FW_API2_FILE);
 550         if (ret == 0) {
 551                 ar->fw_api = 2;
 552                 goto out;
 553         }
 554
 555         ret = ath10k_core_fetch_firmware_api_1(ar);
 556         if (ret)
 557                 return ret;
 558
 559         ar->fw_api = 1;
 560
 561 out:
 562         ath10k_dbg(ATH10K_DBG_BOOT, "using fw api %d\n", ar->fw_api);
 563
 564         return 0;
 565 }
 566
 567 static int ath10k_init_download_firmware(struct ath10k *ar)
 568 {
 569         int ret;
 570
 571         ret = ath10k_download_board_data(ar);
 572         if (ret)
 573                 return ret;
 574
 575         ret = ath10k_download_and_run_otp(ar);
 576         if (ret)
 577                 return ret;
 578
 579         ret = ath10k_download_fw(ar);
 580         if (ret)
 581                 return ret;
 582
 583         return ret;
 584 }
 585
 586 static int ath10k_init_uart(struct ath10k *ar)
 587 {
 588         int ret;
 589
 590         /*
 591          * Explicitly setting UART prints to zero as target turns it on
 592          * based on scratch registers.
 593          */
 594         ret = ath10k_bmi_write32(ar, hi_serial_enable, 0);
 595         if (ret) {
 596                 ath10k_warn("could not disable UART prints (%d)\n", ret);
 597                 return ret;
 598         }
 599
 600         if (!uart_print) {
 601                 ath10k_info("UART prints disabled\n");
 602                 return 0;
 603         }
 604
 605         ret = ath10k_bmi_write32(ar, hi_dbg_uart_txpin, 7);
 606         if (ret) {
 607                 ath10k_warn("could not enable UART prints (%d)\n", ret);
 608                 return ret;
 609         }
 610
 611         ret = ath10k_bmi_write32(ar, hi_serial_enable, 1);
 612         if (ret) {
 613                 ath10k_warn("could not enable UART prints (%d)\n", ret);
 614                 return ret;
 615         }
 616
 617         /* Set the UART baud rate to 19200. */
 618         ret = ath10k_bmi_write32(ar, hi_desired_baud_rate, 19200);
 619         if (ret) {
 620                 ath10k_warn("could not set the baud rate (%d)\n", ret);
 621                 return ret;
 622         }
 623
 624         ath10k_info("UART prints enabled\n");
 625         return 0;
 626 }
 627
 628 static int ath10k_init_hw_params(struct ath10k *ar)
 629 {
 630         const struct ath10k_hw_params *uninitialized_var(hw_params);
 631         int i;
 632
 633         for (i = 0; i < ARRAY_SIZE(ath10k_hw_params_list); i++) {
 634                 hw_params = &ath10k_hw_params_list[i];
 635
 636                 if (hw_params->id == ar->target_version)
 637                         break;
 638         }
 639
 640         if (i == ARRAY_SIZE(ath10k_hw_params_list)) {
 641                 ath10k_err("Unsupported hardware version: 0x%x\n",
 642                            ar->target_version);
 643                 return -EINVAL;
 644         }
 645
 646         ar->hw_params = *hw_params;
 647
 648         ath10k_info("Hardware name %s version 0x%x\n",
 649                     ar->hw_params.name, ar->target_version);
 650
 651         return 0;
 652 }
 653
 654 static void ath10k_core_restart(struct work_struct *work)
 655 {
 656         struct ath10k *ar = container_of(work, struct ath10k, restart_work);
 657
 658         mutex_lock(&ar->conf_mutex);
 659
 660         switch (ar->state) {
 661         case ATH10K_STATE_ON:
 662                 ath10k_halt(ar);
 663                 ar->state = ATH10K_STATE_RESTARTING;
 664                 ieee80211_restart_hw(ar->hw);
 665                 break;
 666         case ATH10K_STATE_OFF:
 667                 /* this can happen if driver is being unloaded */
 668                 ath10k_warn("cannot restart a device that hasn't been started\n");
 669                 break;
 670         case ATH10K_STATE_RESTARTING:
 671         case ATH10K_STATE_RESTARTED:
 672                 ar->state = ATH10K_STATE_WEDGED;
 673                 /* fall through */
 674         case ATH10K_STATE_WEDGED:
 675                 ath10k_warn("device is wedged, will not restart\n");
 676                 break;
 677         }
 678
 679         mutex_unlock(&ar->conf_mutex);
 680 }
 681
 682 struct ath10k *ath10k_core_create(void *hif_priv, struct device *dev,
 683                                   const struct ath10k_hif_ops *hif_ops)
 684 {
 685         struct ath10k *ar;
 686
 687         ar = ath10k_mac_create();
 688         if (!ar)
 689                 return NULL;
 690
 691         ar->ath_common.priv = ar;
 692         ar->ath_common.hw = ar->hw;
 693
 694         ar->p2p = !!ath10k_p2p;
 695         ar->dev = dev;
 696
 697         ar->hif.priv = hif_priv;
 698         ar->hif.ops = hif_ops;
 699
 700         init_completion(&ar->scan.started);
 701         init_completion(&ar->scan.completed);
 702         init_completion(&ar->scan.on_channel);
 703
 704         init_completion(&ar->install_key_done);
 705         init_completion(&ar->vdev_setup_done);
 706
 707         setup_timer(&ar->scan.timeout, ath10k_reset_scan, (unsigned long)ar);
 708
 709         ar->workqueue = create_singlethread_workqueue("ath10k_wq");
 710         if (!ar->workqueue)
 711                 goto err_wq;
 712
 713         mutex_init(&ar->conf_mutex);
 714         spin_lock_init(&ar->data_lock);
 715
 716         INIT_LIST_HEAD(&ar->peers);
 717         init_waitqueue_head(&ar->peer_mapping_wq);
 718
 719         init_completion(&ar->offchan_tx_completed);
 720         INIT_WORK(&ar->offchan_tx_work, ath10k_offchan_tx_work);
 721         skb_queue_head_init(&ar->offchan_tx_queue);
 722
 723         INIT_WORK(&ar->wmi_mgmt_tx_work, ath10k_mgmt_over_wmi_tx_work);
 724         skb_queue_head_init(&ar->wmi_mgmt_tx_queue);
 725
 726         init_waitqueue_head(&ar->event_queue);
 727
 728         INIT_WORK(&ar->restart_work, ath10k_core_restart);
 729
 730         return ar;
 731
 732 err_wq:
 733         ath10k_mac_destroy(ar);
 734         return NULL;
 735 }
 736 EXPORT_SYMBOL(ath10k_core_create);
 737
 738 void ath10k_core_destroy(struct ath10k *ar)
 739 {
 740         ath10k_debug_destroy(ar);
 741
 742         flush_workqueue(ar->workqueue);
 743         destroy_workqueue(ar->workqueue);
 744
 745         ath10k_mac_destroy(ar);
 746 }
 747 EXPORT_SYMBOL(ath10k_core_destroy);
 748
 749 int ath10k_core_start(struct ath10k *ar)
 750 {
 751         int status;
 752
 753         lockdep_assert_held(&ar->conf_mutex);
 754
 755         ath10k_bmi_start(ar);
 756
 757         if (ath10k_init_configure_target(ar)) {
 758                 status = -EINVAL;
 759                 goto err;
 760         }
 761
 762         status = ath10k_init_download_firmware(ar);
 763         if (status)
 764                 goto err;
 765
 766         status = ath10k_init_uart(ar);
 767         if (status)
 768                 goto err;
 769
 770         ar->htc.htc_ops.target_send_suspend_complete =
 771                 ath10k_send_suspend_complete;
 772
 773         status = ath10k_htc_init(ar);
 774         if (status) {
 775                 ath10k_err("could not init HTC (%d)\n", status);
 776                 goto err;
 777         }
 778
 779         status = ath10k_bmi_done(ar);
 780         if (status)
 781                 goto err;
 782
 783         status = ath10k_wmi_attach(ar);
 784         if (status) {
 785                 ath10k_err("WMI attach failed: %d\n", status);
 786                 goto err;
 787         }
 788
 789         status = ath10k_htc_wait_target(&ar->htc);
 790         if (status)
 791                 goto err_wmi_detach;
 792
 793         status = ath10k_htt_attach(ar);
 794         if (status) {
 795                 ath10k_err("could not attach htt (%d)\n", status);
 796                 goto err_wmi_detach;
 797         }
 798
 799         status = ath10k_init_connect_htc(ar);
 800         if (status)
 801                 goto err_htt_detach;
 802
 803         ath10k_info("firmware %s booted\n", ar->hw->wiphy->fw_version);
 804
 805         status = ath10k_wmi_cmd_init(ar);
 806         if (status) {
 807                 ath10k_err("could not send WMI init command (%d)\n", status);
 808                 goto err_disconnect_htc;
 809         }
 810
 811         status = ath10k_wmi_wait_for_unified_ready(ar);
 812         if (status <= 0) {
 813                 ath10k_err("wmi unified ready event not received\n");
 814                 status = -ETIMEDOUT;
 815                 goto err_disconnect_htc;
 816         }
 817
 818         status = ath10k_htt_attach_target(&ar->htt);
 819         if (status)
 820                 goto err_disconnect_htc;
 821
 822         status = ath10k_debug_start(ar);
 823         if (status)
 824                 goto err_disconnect_htc;
 825
 826         ar->free_vdev_map = (1 << TARGET_NUM_VDEVS) - 1;
 827         INIT_LIST_HEAD(&ar->arvifs);
 828
 829         return 0;
 830
 831 err_disconnect_htc:
 832         ath10k_htc_stop(&ar->htc);
 833 err_htt_detach:
 834         ath10k_htt_detach(&ar->htt);
 835 err_wmi_detach:
 836         ath10k_wmi_detach(ar);
 837 err:
 838         return status;
 839 }
 840 EXPORT_SYMBOL(ath10k_core_start);
 841
 842 void ath10k_core_stop(struct ath10k *ar)
 843 {
 844         lockdep_assert_held(&ar->conf_mutex);
 845
 846         ath10k_debug_stop(ar);
 847         ath10k_htc_stop(&ar->htc);
 848         ath10k_htt_detach(&ar->htt);
 849         ath10k_wmi_detach(ar);
 850 }
 851 EXPORT_SYMBOL(ath10k_core_stop);
 852
 853 /* mac80211 manages fw/hw initialization through start/stop hooks. However in
 854  * order to know what hw capabilities should be advertised to mac80211 it is
 855  * necessary to load the firmware (and tear it down immediately since start
 856  * hook will try to init it again) before registering */
 857 static int ath10k_core_probe_fw(struct ath10k *ar)
 858 {
 859         struct bmi_target_info target_info;
 860         int ret = 0;
 861
 862         ret = ath10k_hif_power_up(ar);
 863         if (ret) {
 864                 ath10k_err("could not start pci hif (%d)\n", ret);
 865                 return ret;
 866         }
 867
 868         memset(&target_info, 0, sizeof(target_info));
 869         ret = ath10k_bmi_get_target_info(ar, &target_info);
 870         if (ret) {
 871                 ath10k_err("could not get target info (%d)\n", ret);
 872                 ath10k_hif_power_down(ar);
 873                 return ret;
 874         }
 875
 876         ar->target_version = target_info.version;
 877         ar->hw->wiphy->hw_version = target_info.version;
 878
 879         ret = ath10k_init_hw_params(ar);
 880         if (ret) {
 881                 ath10k_err("could not get hw params (%d)\n", ret);
 882                 ath10k_hif_power_down(ar);
 883                 return ret;
 884         }
 885
 886         ret = ath10k_core_fetch_firmware_files(ar);
 887         if (ret) {
 888                 ath10k_err("could not fetch firmware files (%d)\n", ret);
 889                 ath10k_hif_power_down(ar);
 890                 return ret;
 891         }
 892
 893         mutex_lock(&ar->conf_mutex);
 894
 895         ret = ath10k_core_start(ar);
 896         if (ret) {
 897                 ath10k_err("could not init core (%d)\n", ret);
 898                 ath10k_core_free_firmware_files(ar);
 899                 ath10k_hif_power_down(ar);
 900                 mutex_unlock(&ar->conf_mutex);
 901                 return ret;
 902         }
 903
 904         ath10k_core_stop(ar);
 905
 906         mutex_unlock(&ar->conf_mutex);
 907
 908         ath10k_hif_power_down(ar);
 909         return 0;
 910 }
 911
 912 static int ath10k_core_check_chip_id(struct ath10k *ar)
 913 {
 914         u32 hw_revision = MS(ar->chip_id, SOC_CHIP_ID_REV);
 915
 916         ath10k_dbg(ATH10K_DBG_BOOT, "boot chip_id 0x%08x hw_revision 0x%x\n",
 917                    ar->chip_id, hw_revision);
 918
 919         /* Check that we are not using hw1.0 (some of them have same pci id
 920          * as hw2.0) before doing anything else as ath10k crashes horribly
 921          * due to missing hw1.0 workarounds. */
 922         switch (hw_revision) {
 923         case QCA988X_HW_1_0_CHIP_ID_REV:
 924                 ath10k_err("ERROR: qca988x hw1.0 is not supported\n");
 925                 return -EOPNOTSUPP;
 926
 927         case QCA988X_HW_2_0_CHIP_ID_REV:
 928                 /* known hardware revision, continue normally */
 929                 return 0;
 930
 931         default:
 932                 ath10k_warn("Warning: hardware revision unknown (0x%x), expect problems\n",
 933                             ar->chip_id);
 934                 return 0;
 935         }
 936
 937         return 0;
 938 }
 939
 940 int ath10k_core_register(struct ath10k *ar, u32 chip_id)
 941 {
 942         int status;
 943
 944         ar->chip_id = chip_id;
 945
 946         status = ath10k_core_check_chip_id(ar);
 947         if (status) {
 948                 ath10k_err("Unsupported chip id 0x%08x\n", ar->chip_id);
 949                 return status;
 950         }
 951
 952         status = ath10k_core_probe_fw(ar);
 953         if (status) {
 954                 ath10k_err("could not probe fw (%d)\n", status);
 955                 return status;
 956         }
 957
 958         status = ath10k_mac_register(ar);
 959         if (status) {
 960                 ath10k_err("could not register to mac80211 (%d)\n", status);
 961                 goto err_release_fw;
 962         }
 963
 964         status = ath10k_debug_create(ar);
 965         if (status) {
 966                 ath10k_err("unable to initialize debugfs\n");
 967                 goto err_unregister_mac;
 968         }
 969
 970         return 0;
 971
 972 err_unregister_mac:
 973         ath10k_mac_unregister(ar);
 974 err_release_fw:
 975         ath10k_core_free_firmware_files(ar);
 976         return status;
 977 }
 978 EXPORT_SYMBOL(ath10k_core_register);
 979
 980 void ath10k_core_unregister(struct ath10k *ar)
 981 {
 982         /* We must unregister from mac80211 before we stop HTC and HIF.
 983          * Otherwise we will fail to submit commands to FW and mac80211 will be
 984          * unhappy about callback failures. */
 985         ath10k_mac_unregister(ar);
 986
 987         ath10k_core_free_firmware_files(ar);
 988 }
 989 EXPORT_SYMBOL(ath10k_core_unregister);
 990
 991 MODULE_AUTHOR("Qualcomm Atheros");
 992 MODULE_DESCRIPTION("Core module for QCA988X PCIe devices.");
 993 MODULE_LICENSE("Dual BSD/GPL");