ath10k: implement device recovery
[cascardo/linux.git] / 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_1_0_VERSION,
43                 .name = "qca988x hw1.0",
44                 .patch_load_addr = QCA988X_HW_1_0_PATCH_LOAD_ADDR,
45                 .fw = {
46                         .dir = QCA988X_HW_1_0_FW_DIR,
47                         .fw = QCA988X_HW_1_0_FW_FILE,
48                         .otp = QCA988X_HW_1_0_OTP_FILE,
49                         .board = QCA988X_HW_1_0_BOARD_DATA_FILE,
50                 },
51         },
52         {
53                 .id = QCA988X_HW_2_0_VERSION,
54                 .name = "qca988x hw2.0",
55                 .patch_load_addr = QCA988X_HW_2_0_PATCH_LOAD_ADDR,
56                 .fw = {
57                         .dir = QCA988X_HW_2_0_FW_DIR,
58                         .fw = QCA988X_HW_2_0_FW_FILE,
59                         .otp = QCA988X_HW_2_0_OTP_FILE,
60                         .board = QCA988X_HW_2_0_BOARD_DATA_FILE,
61                 },
62         },
63 };
64
65 static void ath10k_send_suspend_complete(struct ath10k *ar)
66 {
67         ath10k_dbg(ATH10K_DBG_CORE, "%s\n", __func__);
68
69         ar->is_target_paused = true;
70         wake_up(&ar->event_queue);
71 }
72
73 static int ath10k_check_fw_version(struct ath10k *ar)
74 {
75         char version[32];
76
77         if (ar->fw_version_major >= SUPPORTED_FW_MAJOR &&
78             ar->fw_version_minor >= SUPPORTED_FW_MINOR &&
79             ar->fw_version_release >= SUPPORTED_FW_RELEASE &&
80             ar->fw_version_build >= SUPPORTED_FW_BUILD)
81                 return 0;
82
83         snprintf(version, sizeof(version), "%u.%u.%u.%u",
84                  SUPPORTED_FW_MAJOR, SUPPORTED_FW_MINOR,
85                  SUPPORTED_FW_RELEASE, SUPPORTED_FW_BUILD);
86
87         ath10k_warn("WARNING: Firmware version %s is not officially supported.\n",
88                     ar->hw->wiphy->fw_version);
89         ath10k_warn("Please upgrade to version %s (or newer)\n", version);
90
91         return 0;
92 }
93
94 static int ath10k_init_connect_htc(struct ath10k *ar)
95 {
96         int status;
97
98         status = ath10k_wmi_connect_htc_service(ar);
99         if (status)
100                 goto conn_fail;
101
102         /* Start HTC */
103         status = ath10k_htc_start(&ar->htc);
104         if (status)
105                 goto conn_fail;
106
107         /* Wait for WMI event to be ready */
108         status = ath10k_wmi_wait_for_service_ready(ar);
109         if (status <= 0) {
110                 ath10k_warn("wmi service ready event not received");
111                 status = -ETIMEDOUT;
112                 goto timeout;
113         }
114
115         ath10k_dbg(ATH10K_DBG_CORE, "core wmi ready\n");
116         return 0;
117
118 timeout:
119         ath10k_htc_stop(&ar->htc);
120 conn_fail:
121         return status;
122 }
123
124 static int ath10k_init_configure_target(struct ath10k *ar)
125 {
126         u32 param_host;
127         int ret;
128
129         /* tell target which HTC version it is used*/
130         ret = ath10k_bmi_write32(ar, hi_app_host_interest,
131                                  HTC_PROTOCOL_VERSION);
132         if (ret) {
133                 ath10k_err("settings HTC version failed\n");
134                 return ret;
135         }
136
137         /* set the firmware mode to STA/IBSS/AP */
138         ret = ath10k_bmi_read32(ar, hi_option_flag, &param_host);
139         if (ret) {
140                 ath10k_err("setting firmware mode (1/2) failed\n");
141                 return ret;
142         }
143
144         /* TODO following parameters need to be re-visited. */
145         /* num_device */
146         param_host |= (1 << HI_OPTION_NUM_DEV_SHIFT);
147         /* Firmware mode */
148         /* FIXME: Why FW_MODE_AP ??.*/
149         param_host |= (HI_OPTION_FW_MODE_AP << HI_OPTION_FW_MODE_SHIFT);
150         /* mac_addr_method */
151         param_host |= (1 << HI_OPTION_MAC_ADDR_METHOD_SHIFT);
152         /* firmware_bridge */
153         param_host |= (0 << HI_OPTION_FW_BRIDGE_SHIFT);
154         /* fwsubmode */
155         param_host |= (0 << HI_OPTION_FW_SUBMODE_SHIFT);
156
157         ret = ath10k_bmi_write32(ar, hi_option_flag, param_host);
158         if (ret) {
159                 ath10k_err("setting firmware mode (2/2) failed\n");
160                 return ret;
161         }
162
163         /* We do all byte-swapping on the host */
164         ret = ath10k_bmi_write32(ar, hi_be, 0);
165         if (ret) {
166                 ath10k_err("setting host CPU BE mode failed\n");
167                 return ret;
168         }
169
170         /* FW descriptor/Data swap flags */
171         ret = ath10k_bmi_write32(ar, hi_fw_swap, 0);
172
173         if (ret) {
174                 ath10k_err("setting FW data/desc swap flags failed\n");
175                 return ret;
176         }
177
178         return 0;
179 }
180
181 static const struct firmware *ath10k_fetch_fw_file(struct ath10k *ar,
182                                                    const char *dir,
183                                                    const char *file)
184 {
185         char filename[100];
186         const struct firmware *fw;
187         int ret;
188
189         if (file == NULL)
190                 return ERR_PTR(-ENOENT);
191
192         if (dir == NULL)
193                 dir = ".";
194
195         snprintf(filename, sizeof(filename), "%s/%s", dir, file);
196         ret = request_firmware(&fw, filename, ar->dev);
197         if (ret)
198                 return ERR_PTR(ret);
199
200         return fw;
201 }
202
203 static int ath10k_push_board_ext_data(struct ath10k *ar,
204                                       const struct firmware *fw)
205 {
206         u32 board_data_size = QCA988X_BOARD_DATA_SZ;
207         u32 board_ext_data_size = QCA988X_BOARD_EXT_DATA_SZ;
208         u32 board_ext_data_addr;
209         int ret;
210
211         ret = ath10k_bmi_read32(ar, hi_board_ext_data, &board_ext_data_addr);
212         if (ret) {
213                 ath10k_err("could not read board ext data addr (%d)\n", ret);
214                 return ret;
215         }
216
217         ath10k_dbg(ATH10K_DBG_CORE,
218                    "ath10k: Board extended Data download addr: 0x%x\n",
219                    board_ext_data_addr);
220
221         if (board_ext_data_addr == 0)
222                 return 0;
223
224         if (fw->size != (board_data_size + board_ext_data_size)) {
225                 ath10k_err("invalid board (ext) data sizes %zu != %d+%d\n",
226                            fw->size, board_data_size, board_ext_data_size);
227                 return -EINVAL;
228         }
229
230         ret = ath10k_bmi_write_memory(ar, board_ext_data_addr,
231                                       fw->data + board_data_size,
232                                       board_ext_data_size);
233         if (ret) {
234                 ath10k_err("could not write board ext data (%d)\n", ret);
235                 return ret;
236         }
237
238         ret = ath10k_bmi_write32(ar, hi_board_ext_data_config,
239                                  (board_ext_data_size << 16) | 1);
240         if (ret) {
241                 ath10k_err("could not write board ext data bit (%d)\n", ret);
242                 return ret;
243         }
244
245         return 0;
246 }
247
248 static int ath10k_download_board_data(struct ath10k *ar)
249 {
250         const struct firmware *fw = ar->board_data;
251         u32 board_data_size = QCA988X_BOARD_DATA_SZ;
252         u32 address;
253         int ret;
254
255         ret = ath10k_push_board_ext_data(ar, fw);
256         if (ret) {
257                 ath10k_err("could not push board ext data (%d)\n", ret);
258                 goto exit;
259         }
260
261         ret = ath10k_bmi_read32(ar, hi_board_data, &address);
262         if (ret) {
263                 ath10k_err("could not read board data addr (%d)\n", ret);
264                 goto exit;
265         }
266
267         ret = ath10k_bmi_write_memory(ar, address, fw->data,
268                                       min_t(u32, board_data_size, fw->size));
269         if (ret) {
270                 ath10k_err("could not write board data (%d)\n", ret);
271                 goto exit;
272         }
273
274         ret = ath10k_bmi_write32(ar, hi_board_data_initialized, 1);
275         if (ret) {
276                 ath10k_err("could not write board data bit (%d)\n", ret);
277                 goto exit;
278         }
279
280 exit:
281         return ret;
282 }
283
284 static int ath10k_download_and_run_otp(struct ath10k *ar)
285 {
286         const struct firmware *fw = ar->otp;
287         u32 address = ar->hw_params.patch_load_addr;
288         u32 exec_param;
289         int ret;
290
291         /* OTP is optional */
292
293         if (!ar->otp)
294                 return 0;
295
296         ret = ath10k_bmi_fast_download(ar, address, fw->data, fw->size);
297         if (ret) {
298                 ath10k_err("could not write otp (%d)\n", ret);
299                 goto exit;
300         }
301
302         exec_param = 0;
303         ret = ath10k_bmi_execute(ar, address, &exec_param);
304         if (ret) {
305                 ath10k_err("could not execute otp (%d)\n", ret);
306                 goto exit;
307         }
308
309 exit:
310         return ret;
311 }
312
313 static int ath10k_download_fw(struct ath10k *ar)
314 {
315         const struct firmware *fw = ar->firmware;
316         u32 address;
317         int ret;
318
319         address = ar->hw_params.patch_load_addr;
320
321         ret = ath10k_bmi_fast_download(ar, address, fw->data, fw->size);
322         if (ret) {
323                 ath10k_err("could not write fw (%d)\n", ret);
324                 goto exit;
325         }
326
327 exit:
328         return ret;
329 }
330
331 static void ath10k_core_free_firmware_files(struct ath10k *ar)
332 {
333         if (ar->board_data && !IS_ERR(ar->board_data))
334                 release_firmware(ar->board_data);
335
336         if (ar->otp && !IS_ERR(ar->otp))
337                 release_firmware(ar->otp);
338
339         if (ar->firmware && !IS_ERR(ar->firmware))
340                 release_firmware(ar->firmware);
341
342         ar->board_data = NULL;
343         ar->otp = NULL;
344         ar->firmware = NULL;
345 }
346
347 static int ath10k_core_fetch_firmware_files(struct ath10k *ar)
348 {
349         int ret = 0;
350
351         if (ar->hw_params.fw.fw == NULL) {
352                 ath10k_err("firmware file not defined\n");
353                 return -EINVAL;
354         }
355
356         if (ar->hw_params.fw.board == NULL) {
357                 ath10k_err("board data file not defined");
358                 return -EINVAL;
359         }
360
361         ar->board_data = ath10k_fetch_fw_file(ar,
362                                               ar->hw_params.fw.dir,
363                                               ar->hw_params.fw.board);
364         if (IS_ERR(ar->board_data)) {
365                 ret = PTR_ERR(ar->board_data);
366                 ath10k_err("could not fetch board data (%d)\n", ret);
367                 goto err;
368         }
369
370         ar->firmware = ath10k_fetch_fw_file(ar,
371                                             ar->hw_params.fw.dir,
372                                             ar->hw_params.fw.fw);
373         if (IS_ERR(ar->firmware)) {
374                 ret = PTR_ERR(ar->firmware);
375                 ath10k_err("could not fetch firmware (%d)\n", ret);
376                 goto err;
377         }
378
379         /* OTP may be undefined. If so, don't fetch it at all */
380         if (ar->hw_params.fw.otp == NULL)
381                 return 0;
382
383         ar->otp = ath10k_fetch_fw_file(ar,
384                                        ar->hw_params.fw.dir,
385                                        ar->hw_params.fw.otp);
386         if (IS_ERR(ar->otp)) {
387                 ret = PTR_ERR(ar->otp);
388                 ath10k_err("could not fetch otp (%d)\n", ret);
389                 goto err;
390         }
391
392         return 0;
393
394 err:
395         ath10k_core_free_firmware_files(ar);
396         return ret;
397 }
398
399 static int ath10k_init_download_firmware(struct ath10k *ar)
400 {
401         int ret;
402
403         ret = ath10k_download_board_data(ar);
404         if (ret)
405                 return ret;
406
407         ret = ath10k_download_and_run_otp(ar);
408         if (ret)
409                 return ret;
410
411         ret = ath10k_download_fw(ar);
412         if (ret)
413                 return ret;
414
415         return ret;
416 }
417
418 static int ath10k_init_uart(struct ath10k *ar)
419 {
420         int ret;
421
422         /*
423          * Explicitly setting UART prints to zero as target turns it on
424          * based on scratch registers.
425          */
426         ret = ath10k_bmi_write32(ar, hi_serial_enable, 0);
427         if (ret) {
428                 ath10k_warn("could not disable UART prints (%d)\n", ret);
429                 return ret;
430         }
431
432         if (!uart_print) {
433                 ath10k_info("UART prints disabled\n");
434                 return 0;
435         }
436
437         ret = ath10k_bmi_write32(ar, hi_dbg_uart_txpin, 7);
438         if (ret) {
439                 ath10k_warn("could not enable UART prints (%d)\n", ret);
440                 return ret;
441         }
442
443         ret = ath10k_bmi_write32(ar, hi_serial_enable, 1);
444         if (ret) {
445                 ath10k_warn("could not enable UART prints (%d)\n", ret);
446                 return ret;
447         }
448
449         ath10k_info("UART prints enabled\n");
450         return 0;
451 }
452
453 static int ath10k_init_hw_params(struct ath10k *ar)
454 {
455         const struct ath10k_hw_params *uninitialized_var(hw_params);
456         int i;
457
458         for (i = 0; i < ARRAY_SIZE(ath10k_hw_params_list); i++) {
459                 hw_params = &ath10k_hw_params_list[i];
460
461                 if (hw_params->id == ar->target_version)
462                         break;
463         }
464
465         if (i == ARRAY_SIZE(ath10k_hw_params_list)) {
466                 ath10k_err("Unsupported hardware version: 0x%x\n",
467                            ar->target_version);
468                 return -EINVAL;
469         }
470
471         ar->hw_params = *hw_params;
472
473         ath10k_info("Hardware name %s version 0x%x\n",
474                     ar->hw_params.name, ar->target_version);
475
476         return 0;
477 }
478
479 static void ath10k_core_restart(struct work_struct *work)
480 {
481         struct ath10k *ar = container_of(work, struct ath10k, restart_work);
482
483         mutex_lock(&ar->conf_mutex);
484
485         switch (ar->state) {
486         case ATH10K_STATE_ON:
487                 ath10k_halt(ar);
488                 ar->state = ATH10K_STATE_RESTARTING;
489                 ieee80211_restart_hw(ar->hw);
490                 break;
491         case ATH10K_STATE_OFF:
492                 /* this can happen if driver is being unloaded */
493                 ath10k_warn("cannot restart a device that hasn't been started\n");
494                 break;
495         case ATH10K_STATE_RESTARTING:
496         case ATH10K_STATE_RESTARTED:
497                 ar->state = ATH10K_STATE_WEDGED;
498                 /* fall through */
499         case ATH10K_STATE_WEDGED:
500                 ath10k_warn("device is wedged, will not restart\n");
501                 break;
502         }
503
504         mutex_unlock(&ar->conf_mutex);
505 }
506
507 struct ath10k *ath10k_core_create(void *hif_priv, struct device *dev,
508                                   const struct ath10k_hif_ops *hif_ops)
509 {
510         struct ath10k *ar;
511
512         ar = ath10k_mac_create();
513         if (!ar)
514                 return NULL;
515
516         ar->ath_common.priv = ar;
517         ar->ath_common.hw = ar->hw;
518
519         ar->p2p = !!ath10k_p2p;
520         ar->dev = dev;
521
522         ar->hif.priv = hif_priv;
523         ar->hif.ops = hif_ops;
524
525         init_completion(&ar->scan.started);
526         init_completion(&ar->scan.completed);
527         init_completion(&ar->scan.on_channel);
528
529         init_completion(&ar->install_key_done);
530         init_completion(&ar->vdev_setup_done);
531
532         setup_timer(&ar->scan.timeout, ath10k_reset_scan, (unsigned long)ar);
533
534         ar->workqueue = create_singlethread_workqueue("ath10k_wq");
535         if (!ar->workqueue)
536                 goto err_wq;
537
538         mutex_init(&ar->conf_mutex);
539         spin_lock_init(&ar->data_lock);
540
541         INIT_LIST_HEAD(&ar->peers);
542         init_waitqueue_head(&ar->peer_mapping_wq);
543
544         init_completion(&ar->offchan_tx_completed);
545         INIT_WORK(&ar->offchan_tx_work, ath10k_offchan_tx_work);
546         skb_queue_head_init(&ar->offchan_tx_queue);
547
548         init_waitqueue_head(&ar->event_queue);
549
550         INIT_WORK(&ar->restart_work, ath10k_core_restart);
551
552         return ar;
553
554 err_wq:
555         ath10k_mac_destroy(ar);
556         return NULL;
557 }
558 EXPORT_SYMBOL(ath10k_core_create);
559
560 void ath10k_core_destroy(struct ath10k *ar)
561 {
562         flush_workqueue(ar->workqueue);
563         destroy_workqueue(ar->workqueue);
564
565         ath10k_mac_destroy(ar);
566 }
567 EXPORT_SYMBOL(ath10k_core_destroy);
568
569 int ath10k_core_start(struct ath10k *ar)
570 {
571         int status;
572
573         ath10k_bmi_start(ar);
574
575         if (ath10k_init_configure_target(ar)) {
576                 status = -EINVAL;
577                 goto err;
578         }
579
580         status = ath10k_init_download_firmware(ar);
581         if (status)
582                 goto err;
583
584         status = ath10k_init_uart(ar);
585         if (status)
586                 goto err;
587
588         ar->htc.htc_ops.target_send_suspend_complete =
589                 ath10k_send_suspend_complete;
590
591         status = ath10k_htc_init(ar);
592         if (status) {
593                 ath10k_err("could not init HTC (%d)\n", status);
594                 goto err;
595         }
596
597         status = ath10k_bmi_done(ar);
598         if (status)
599                 goto err;
600
601         status = ath10k_wmi_attach(ar);
602         if (status) {
603                 ath10k_err("WMI attach failed: %d\n", status);
604                 goto err;
605         }
606
607         status = ath10k_htc_wait_target(&ar->htc);
608         if (status)
609                 goto err_wmi_detach;
610
611         status = ath10k_htt_attach(ar);
612         if (status) {
613                 ath10k_err("could not attach htt (%d)\n", status);
614                 goto err_wmi_detach;
615         }
616
617         status = ath10k_init_connect_htc(ar);
618         if (status)
619                 goto err_htt_detach;
620
621         ath10k_info("firmware %s booted\n", ar->hw->wiphy->fw_version);
622
623         status = ath10k_check_fw_version(ar);
624         if (status)
625                 goto err_disconnect_htc;
626
627         status = ath10k_wmi_cmd_init(ar);
628         if (status) {
629                 ath10k_err("could not send WMI init command (%d)\n", status);
630                 goto err_disconnect_htc;
631         }
632
633         status = ath10k_wmi_wait_for_unified_ready(ar);
634         if (status <= 0) {
635                 ath10k_err("wmi unified ready event not received\n");
636                 status = -ETIMEDOUT;
637                 goto err_disconnect_htc;
638         }
639
640         status = ath10k_htt_attach_target(&ar->htt);
641         if (status)
642                 goto err_disconnect_htc;
643
644         ar->free_vdev_map = (1 << TARGET_NUM_VDEVS) - 1;
645
646         return 0;
647
648 err_disconnect_htc:
649         ath10k_htc_stop(&ar->htc);
650 err_htt_detach:
651         ath10k_htt_detach(&ar->htt);
652 err_wmi_detach:
653         ath10k_wmi_detach(ar);
654 err:
655         return status;
656 }
657 EXPORT_SYMBOL(ath10k_core_start);
658
659 void ath10k_core_stop(struct ath10k *ar)
660 {
661         ath10k_htc_stop(&ar->htc);
662         ath10k_htt_detach(&ar->htt);
663         ath10k_wmi_detach(ar);
664 }
665 EXPORT_SYMBOL(ath10k_core_stop);
666
667 /* mac80211 manages fw/hw initialization through start/stop hooks. However in
668  * order to know what hw capabilities should be advertised to mac80211 it is
669  * necessary to load the firmware (and tear it down immediately since start
670  * hook will try to init it again) before registering */
671 static int ath10k_core_probe_fw(struct ath10k *ar)
672 {
673         struct bmi_target_info target_info;
674         int ret = 0;
675
676         ret = ath10k_hif_power_up(ar);
677         if (ret) {
678                 ath10k_err("could not start pci hif (%d)\n", ret);
679                 return ret;
680         }
681
682         memset(&target_info, 0, sizeof(target_info));
683         ret = ath10k_bmi_get_target_info(ar, &target_info);
684         if (ret) {
685                 ath10k_err("could not get target info (%d)\n", ret);
686                 ath10k_hif_power_down(ar);
687                 return ret;
688         }
689
690         ar->target_version = target_info.version;
691         ar->hw->wiphy->hw_version = target_info.version;
692
693         ret = ath10k_init_hw_params(ar);
694         if (ret) {
695                 ath10k_err("could not get hw params (%d)\n", ret);
696                 ath10k_hif_power_down(ar);
697                 return ret;
698         }
699
700         ret = ath10k_core_fetch_firmware_files(ar);
701         if (ret) {
702                 ath10k_err("could not fetch firmware files (%d)\n", ret);
703                 ath10k_hif_power_down(ar);
704                 return ret;
705         }
706
707         ret = ath10k_core_start(ar);
708         if (ret) {
709                 ath10k_err("could not init core (%d)\n", ret);
710                 ath10k_core_free_firmware_files(ar);
711                 ath10k_hif_power_down(ar);
712                 return ret;
713         }
714
715         ath10k_core_stop(ar);
716         ath10k_hif_power_down(ar);
717         return 0;
718 }
719
720 int ath10k_core_register(struct ath10k *ar)
721 {
722         int status;
723
724         status = ath10k_core_probe_fw(ar);
725         if (status) {
726                 ath10k_err("could not probe fw (%d)\n", status);
727                 return status;
728         }
729
730         status = ath10k_mac_register(ar);
731         if (status) {
732                 ath10k_err("could not register to mac80211 (%d)\n", status);
733                 goto err_release_fw;
734         }
735
736         status = ath10k_debug_create(ar);
737         if (status) {
738                 ath10k_err("unable to initialize debugfs\n");
739                 goto err_unregister_mac;
740         }
741
742         return 0;
743
744 err_unregister_mac:
745         ath10k_mac_unregister(ar);
746 err_release_fw:
747         ath10k_core_free_firmware_files(ar);
748         return status;
749 }
750 EXPORT_SYMBOL(ath10k_core_register);
751
752 void ath10k_core_unregister(struct ath10k *ar)
753 {
754         /* We must unregister from mac80211 before we stop HTC and HIF.
755          * Otherwise we will fail to submit commands to FW and mac80211 will be
756          * unhappy about callback failures. */
757         ath10k_mac_unregister(ar);
758         ath10k_core_free_firmware_files(ar);
759 }
760 EXPORT_SYMBOL(ath10k_core_unregister);
761
762 MODULE_AUTHOR("Qualcomm Atheros");
763 MODULE_DESCRIPTION("Core module for QCA988X PCIe devices.");
764 MODULE_LICENSE("Dual BSD/GPL");