1 /******************************************************************************
3 * This file is provided under a dual BSD/GPLv2 license. When using or
4 * redistributing this file, you may do so under either license.
8 * Copyright(c) 2007 - 2015 Intel Corporation. All rights reserved.
9 * Copyright(c) 2013 - 2015 Intel Mobile Communications GmbH
10 * Copyright(c) 2016 - 2017 Intel Deutschland GmbH
11 * Copyright(c) 2018 - 2019 Intel Corporation
13 * This program is free software; you can redistribute it and/or modify
14 * it under the terms of version 2 of the GNU General Public License as
15 * published by the Free Software Foundation.
17 * This program is distributed in the hope that it will be useful, but
18 * WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20 * General Public License for more details.
22 * The full GNU General Public License is included in this distribution
23 * in the file called COPYING.
25 * Contact Information:
26 * Intel Linux Wireless <linuxwifi@intel.com>
27 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
31 * Copyright(c) 2005 - 2015 Intel Corporation. All rights reserved.
32 * Copyright(c) 2013 - 2015 Intel Mobile Communications GmbH
33 * Copyright(c) 2016 - 2017 Intel Deutschland GmbH
34 * Copyright(c) 2018 - 2019 Intel Corporation
35 * All rights reserved.
37 * Redistribution and use in source and binary forms, with or without
38 * modification, are permitted provided that the following conditions
41 * * Redistributions of source code must retain the above copyright
42 * notice, this list of conditions and the following disclaimer.
43 * * Redistributions in binary form must reproduce the above copyright
44 * notice, this list of conditions and the following disclaimer in
45 * the documentation and/or other materials provided with the
47 * * Neither the name Intel Corporation nor the names of its
48 * contributors may be used to endorse or promote products derived
49 * from this software without specific prior written permission.
51 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
52 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
53 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
54 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
55 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
56 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
57 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
58 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
59 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
60 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
61 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
63 *****************************************************************************/
64 #include <linux/pci.h>
65 #include <linux/interrupt.h>
66 #include <linux/debugfs.h>
67 #include <linux/sched.h>
68 #include <linux/bitops.h>
69 #include <linux/gfp.h>
70 #include <linux/vmalloc.h>
71 #include <linux/module.h>
72 #include <linux/wait.h>
75 #include "iwl-trans.h"
79 #include "iwl-agn-hw.h"
80 #include "fw/error-dump.h"
82 #include "fw/api/tx.h"
86 /* extended range in FW SRAM */
87 #define IWL_FW_MEM_EXTENDED_START 0x40000
88 #define IWL_FW_MEM_EXTENDED_END 0x57FFF
90 void iwl_trans_pcie_dump_regs(struct iwl_trans
*trans
)
92 #define PCI_DUMP_SIZE 352
93 #define PCI_MEM_DUMP_SIZE 64
94 #define PCI_PARENT_DUMP_SIZE 524
96 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
97 struct pci_dev
*pdev
= trans_pcie
->pci_dev
;
98 u32 i
, pos
, alloc_size
, *ptr
, *buf
;
101 if (trans_pcie
->pcie_dbg_dumped_once
)
104 /* Should be a multiple of 4 */
105 BUILD_BUG_ON(PCI_DUMP_SIZE
> 4096 || PCI_DUMP_SIZE
& 0x3);
106 BUILD_BUG_ON(PCI_MEM_DUMP_SIZE
> 4096 || PCI_MEM_DUMP_SIZE
& 0x3);
107 BUILD_BUG_ON(PCI_PARENT_DUMP_SIZE
> 4096 || PCI_PARENT_DUMP_SIZE
& 0x3);
109 /* Alloc a max size buffer */
110 alloc_size
= PCI_ERR_ROOT_ERR_SRC
+ 4 + PREFIX_LEN
;
111 alloc_size
= max_t(u32
, alloc_size
, PCI_DUMP_SIZE
+ PREFIX_LEN
);
112 alloc_size
= max_t(u32
, alloc_size
, PCI_MEM_DUMP_SIZE
+ PREFIX_LEN
);
113 alloc_size
= max_t(u32
, alloc_size
, PCI_PARENT_DUMP_SIZE
+ PREFIX_LEN
);
115 buf
= kmalloc(alloc_size
, GFP_ATOMIC
);
118 prefix
= (char *)buf
+ alloc_size
- PREFIX_LEN
;
120 IWL_ERR(trans
, "iwlwifi transaction failed, dumping registers\n");
122 /* Print wifi device registers */
123 sprintf(prefix
, "iwlwifi %s: ", pci_name(pdev
));
124 IWL_ERR(trans
, "iwlwifi device config registers:\n");
125 for (i
= 0, ptr
= buf
; i
< PCI_DUMP_SIZE
; i
+= 4, ptr
++)
126 if (pci_read_config_dword(pdev
, i
, ptr
))
128 print_hex_dump(KERN_ERR
, prefix
, DUMP_PREFIX_OFFSET
, 32, 4, buf
, i
, 0);
130 IWL_ERR(trans
, "iwlwifi device memory mapped registers:\n");
131 for (i
= 0, ptr
= buf
; i
< PCI_MEM_DUMP_SIZE
; i
+= 4, ptr
++)
132 *ptr
= iwl_read32(trans
, i
);
133 print_hex_dump(KERN_ERR
, prefix
, DUMP_PREFIX_OFFSET
, 32, 4, buf
, i
, 0);
135 pos
= pci_find_ext_capability(pdev
, PCI_EXT_CAP_ID_ERR
);
137 IWL_ERR(trans
, "iwlwifi device AER capability structure:\n");
138 for (i
= 0, ptr
= buf
; i
< PCI_ERR_ROOT_COMMAND
; i
+= 4, ptr
++)
139 if (pci_read_config_dword(pdev
, pos
+ i
, ptr
))
141 print_hex_dump(KERN_ERR
, prefix
, DUMP_PREFIX_OFFSET
,
145 /* Print parent device registers next */
146 if (!pdev
->bus
->self
)
149 pdev
= pdev
->bus
->self
;
150 sprintf(prefix
, "iwlwifi %s: ", pci_name(pdev
));
152 IWL_ERR(trans
, "iwlwifi parent port (%s) config registers:\n",
154 for (i
= 0, ptr
= buf
; i
< PCI_PARENT_DUMP_SIZE
; i
+= 4, ptr
++)
155 if (pci_read_config_dword(pdev
, i
, ptr
))
157 print_hex_dump(KERN_ERR
, prefix
, DUMP_PREFIX_OFFSET
, 32, 4, buf
, i
, 0);
159 /* Print root port AER registers */
161 pdev
= pcie_find_root_port(pdev
);
163 pos
= pci_find_ext_capability(pdev
, PCI_EXT_CAP_ID_ERR
);
165 IWL_ERR(trans
, "iwlwifi root port (%s) AER cap structure:\n",
167 sprintf(prefix
, "iwlwifi %s: ", pci_name(pdev
));
168 for (i
= 0, ptr
= buf
; i
<= PCI_ERR_ROOT_ERR_SRC
; i
+= 4, ptr
++)
169 if (pci_read_config_dword(pdev
, pos
+ i
, ptr
))
171 print_hex_dump(KERN_ERR
, prefix
, DUMP_PREFIX_OFFSET
, 32,
177 print_hex_dump(KERN_ERR
, prefix
, DUMP_PREFIX_OFFSET
, 32, 4, buf
, i
, 0);
178 IWL_ERR(trans
, "Read failed at 0x%X\n", i
);
180 trans_pcie
->pcie_dbg_dumped_once
= 1;
184 static void iwl_trans_pcie_sw_reset(struct iwl_trans
*trans
)
186 /* Reset entire device - do controller reset (results in SHRD_HW_RST) */
187 iwl_set_bit(trans
, CSR_RESET
, CSR_RESET_REG_FLAG_SW_RESET
);
188 usleep_range(5000, 6000);
191 static void iwl_pcie_free_fw_monitor(struct iwl_trans
*trans
)
193 struct iwl_dram_data
*fw_mon
= &trans
->dbg
.fw_mon
;
198 dma_free_coherent(trans
->dev
, fw_mon
->size
, fw_mon
->block
,
201 fw_mon
->block
= NULL
;
202 fw_mon
->physical
= 0;
206 static void iwl_pcie_alloc_fw_monitor_block(struct iwl_trans
*trans
,
207 u8 max_power
, u8 min_power
)
209 struct iwl_dram_data
*fw_mon
= &trans
->dbg
.fw_mon
;
211 dma_addr_t physical
= 0;
218 for (power
= max_power
; power
>= min_power
; power
--) {
220 block
= dma_alloc_coherent(trans
->dev
, size
, &physical
,
221 GFP_KERNEL
| __GFP_NOWARN
);
226 "Allocated 0x%08x bytes for firmware monitor.\n",
231 if (WARN_ON_ONCE(!block
))
234 if (power
!= max_power
)
236 "Sorry - debug buffer is only %luK while you requested %luK\n",
237 (unsigned long)BIT(power
- 10),
238 (unsigned long)BIT(max_power
- 10));
240 fw_mon
->block
= block
;
241 fw_mon
->physical
= physical
;
245 void iwl_pcie_alloc_fw_monitor(struct iwl_trans
*trans
, u8 max_power
)
248 /* default max_power is maximum */
254 if (WARN(max_power
> 26,
255 "External buffer size for monitor is too big %d, check the FW TLV\n",
259 if (trans
->dbg
.fw_mon
.size
)
262 iwl_pcie_alloc_fw_monitor_block(trans
, max_power
, 11);
265 static u32
iwl_trans_pcie_read_shr(struct iwl_trans
*trans
, u32 reg
)
267 iwl_write32(trans
, HEEP_CTRL_WRD_PCIEX_CTRL_REG
,
268 ((reg
& 0x0000ffff) | (2 << 28)));
269 return iwl_read32(trans
, HEEP_CTRL_WRD_PCIEX_DATA_REG
);
272 static void iwl_trans_pcie_write_shr(struct iwl_trans
*trans
, u32 reg
, u32 val
)
274 iwl_write32(trans
, HEEP_CTRL_WRD_PCIEX_DATA_REG
, val
);
275 iwl_write32(trans
, HEEP_CTRL_WRD_PCIEX_CTRL_REG
,
276 ((reg
& 0x0000ffff) | (3 << 28)));
279 static void iwl_pcie_set_pwr(struct iwl_trans
*trans
, bool vaux
)
281 if (trans
->cfg
->apmg_not_supported
)
284 if (vaux
&& pci_pme_capable(to_pci_dev(trans
->dev
), PCI_D3cold
))
285 iwl_set_bits_mask_prph(trans
, APMG_PS_CTRL_REG
,
286 APMG_PS_CTRL_VAL_PWR_SRC_VAUX
,
287 ~APMG_PS_CTRL_MSK_PWR_SRC
);
289 iwl_set_bits_mask_prph(trans
, APMG_PS_CTRL_REG
,
290 APMG_PS_CTRL_VAL_PWR_SRC_VMAIN
,
291 ~APMG_PS_CTRL_MSK_PWR_SRC
);
295 #define PCI_CFG_RETRY_TIMEOUT 0x041
297 void iwl_pcie_apm_config(struct iwl_trans
*trans
)
299 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
304 * L0S states have been found to be unstable with our devices
305 * and in newer hardware they are not officially supported at
306 * all, so we must always set the L0S_DISABLED bit.
308 iwl_set_bit(trans
, CSR_GIO_REG
, CSR_GIO_REG_VAL_L0S_DISABLED
);
310 pcie_capability_read_word(trans_pcie
->pci_dev
, PCI_EXP_LNKCTL
, &lctl
);
311 trans
->pm_support
= !(lctl
& PCI_EXP_LNKCTL_ASPM_L0S
);
313 pcie_capability_read_word(trans_pcie
->pci_dev
, PCI_EXP_DEVCTL2
, &cap
);
314 trans
->ltr_enabled
= cap
& PCI_EXP_DEVCTL2_LTR_EN
;
315 IWL_DEBUG_POWER(trans
, "L1 %sabled - LTR %sabled\n",
316 (lctl
& PCI_EXP_LNKCTL_ASPM_L1
) ? "En" : "Dis",
317 trans
->ltr_enabled
? "En" : "Dis");
321 * Start up NIC's basic functionality after it has been reset
322 * (e.g. after platform boot, or shutdown via iwl_pcie_apm_stop())
323 * NOTE: This does not load uCode nor start the embedded processor
325 static int iwl_pcie_apm_init(struct iwl_trans
*trans
)
329 IWL_DEBUG_INFO(trans
, "Init card's basic functions\n");
332 * Use "set_bit" below rather than "write", to preserve any hardware
333 * bits already set by default after reset.
336 /* Disable L0S exit timer (platform NMI Work/Around) */
337 if (trans
->trans_cfg
->device_family
< IWL_DEVICE_FAMILY_8000
)
338 iwl_set_bit(trans
, CSR_GIO_CHICKEN_BITS
,
339 CSR_GIO_CHICKEN_BITS_REG_BIT_DIS_L0S_EXIT_TIMER
);
342 * Disable L0s without affecting L1;
343 * don't wait for ICH L0s (ICH bug W/A)
345 iwl_set_bit(trans
, CSR_GIO_CHICKEN_BITS
,
346 CSR_GIO_CHICKEN_BITS_REG_BIT_L1A_NO_L0S_RX
);
348 /* Set FH wait threshold to maximum (HW error during stress W/A) */
349 iwl_set_bit(trans
, CSR_DBG_HPET_MEM_REG
, CSR_DBG_HPET_MEM_REG_VAL
);
352 * Enable HAP INTA (interrupt from management bus) to
353 * wake device's PCI Express link L1a -> L0s
355 iwl_set_bit(trans
, CSR_HW_IF_CONFIG_REG
,
356 CSR_HW_IF_CONFIG_REG_BIT_HAP_WAKE_L1A
);
358 iwl_pcie_apm_config(trans
);
360 /* Configure analog phase-lock-loop before activating to D0A */
361 if (trans
->trans_cfg
->base_params
->pll_cfg
)
362 iwl_set_bit(trans
, CSR_ANA_PLL_CFG
, CSR50_ANA_PLL_CFG_VAL
);
364 ret
= iwl_finish_nic_init(trans
, trans
->trans_cfg
);
368 if (trans
->cfg
->host_interrupt_operation_mode
) {
370 * This is a bit of an abuse - This is needed for 7260 / 3160
371 * only check host_interrupt_operation_mode even if this is
372 * not related to host_interrupt_operation_mode.
374 * Enable the oscillator to count wake up time for L1 exit. This
375 * consumes slightly more power (100uA) - but allows to be sure
376 * that we wake up from L1 on time.
378 * This looks weird: read twice the same register, discard the
379 * value, set a bit, and yet again, read that same register
380 * just to discard the value. But that's the way the hardware
383 iwl_read_prph(trans
, OSC_CLK
);
384 iwl_read_prph(trans
, OSC_CLK
);
385 iwl_set_bits_prph(trans
, OSC_CLK
, OSC_CLK_FORCE_CONTROL
);
386 iwl_read_prph(trans
, OSC_CLK
);
387 iwl_read_prph(trans
, OSC_CLK
);
391 * Enable DMA clock and wait for it to stabilize.
393 * Write to "CLK_EN_REG"; "1" bits enable clocks, while "0"
394 * bits do not disable clocks. This preserves any hardware
395 * bits already set by default in "CLK_CTRL_REG" after reset.
397 if (!trans
->cfg
->apmg_not_supported
) {
398 iwl_write_prph(trans
, APMG_CLK_EN_REG
,
399 APMG_CLK_VAL_DMA_CLK_RQT
);
402 /* Disable L1-Active */
403 iwl_set_bits_prph(trans
, APMG_PCIDEV_STT_REG
,
404 APMG_PCIDEV_STT_VAL_L1_ACT_DIS
);
406 /* Clear the interrupt in APMG if the NIC is in RFKILL */
407 iwl_write_prph(trans
, APMG_RTC_INT_STT_REG
,
408 APMG_RTC_INT_STT_RFKILL
);
411 set_bit(STATUS_DEVICE_ENABLED
, &trans
->status
);
417 * Enable LP XTAL to avoid HW bug where device may consume much power if
418 * FW is not loaded after device reset. LP XTAL is disabled by default
419 * after device HW reset. Do it only if XTAL is fed by internal source.
420 * Configure device's "persistence" mode to avoid resetting XTAL again when
421 * SHRD_HW_RST occurs in S3.
423 static void iwl_pcie_apm_lp_xtal_enable(struct iwl_trans
*trans
)
427 u32 apmg_xtal_cfg_reg
;
431 __iwl_trans_pcie_set_bit(trans
, CSR_GP_CNTRL
,
432 CSR_GP_CNTRL_REG_FLAG_XTAL_ON
);
434 iwl_trans_pcie_sw_reset(trans
);
436 ret
= iwl_finish_nic_init(trans
, trans
->trans_cfg
);
438 /* Release XTAL ON request */
439 __iwl_trans_pcie_clear_bit(trans
, CSR_GP_CNTRL
,
440 CSR_GP_CNTRL_REG_FLAG_XTAL_ON
);
445 * Clear "disable persistence" to avoid LP XTAL resetting when
446 * SHRD_HW_RST is applied in S3.
448 iwl_clear_bits_prph(trans
, APMG_PCIDEV_STT_REG
,
449 APMG_PCIDEV_STT_VAL_PERSIST_DIS
);
452 * Force APMG XTAL to be active to prevent its disabling by HW
453 * caused by APMG idle state.
455 apmg_xtal_cfg_reg
= iwl_trans_pcie_read_shr(trans
,
456 SHR_APMG_XTAL_CFG_REG
);
457 iwl_trans_pcie_write_shr(trans
, SHR_APMG_XTAL_CFG_REG
,
459 SHR_APMG_XTAL_CFG_XTAL_ON_REQ
);
461 iwl_trans_pcie_sw_reset(trans
);
463 /* Enable LP XTAL by indirect access through CSR */
464 apmg_gp1_reg
= iwl_trans_pcie_read_shr(trans
, SHR_APMG_GP1_REG
);
465 iwl_trans_pcie_write_shr(trans
, SHR_APMG_GP1_REG
, apmg_gp1_reg
|
466 SHR_APMG_GP1_WF_XTAL_LP_EN
|
467 SHR_APMG_GP1_CHICKEN_BIT_SELECT
);
469 /* Clear delay line clock power up */
470 dl_cfg_reg
= iwl_trans_pcie_read_shr(trans
, SHR_APMG_DL_CFG_REG
);
471 iwl_trans_pcie_write_shr(trans
, SHR_APMG_DL_CFG_REG
, dl_cfg_reg
&
472 ~SHR_APMG_DL_CFG_DL_CLOCK_POWER_UP
);
475 * Enable persistence mode to avoid LP XTAL resetting when
476 * SHRD_HW_RST is applied in S3.
478 iwl_set_bit(trans
, CSR_HW_IF_CONFIG_REG
,
479 CSR_HW_IF_CONFIG_REG_PERSIST_MODE
);
482 * Clear "initialization complete" bit to move adapter from
483 * D0A* (powered-up Active) --> D0U* (Uninitialized) state.
485 iwl_clear_bit(trans
, CSR_GP_CNTRL
, CSR_GP_CNTRL_REG_FLAG_INIT_DONE
);
487 /* Activates XTAL resources monitor */
488 __iwl_trans_pcie_set_bit(trans
, CSR_MONITOR_CFG_REG
,
489 CSR_MONITOR_XTAL_RESOURCES
);
491 /* Release XTAL ON request */
492 __iwl_trans_pcie_clear_bit(trans
, CSR_GP_CNTRL
,
493 CSR_GP_CNTRL_REG_FLAG_XTAL_ON
);
496 /* Release APMG XTAL */
497 iwl_trans_pcie_write_shr(trans
, SHR_APMG_XTAL_CFG_REG
,
499 ~SHR_APMG_XTAL_CFG_XTAL_ON_REQ
);
502 void iwl_pcie_apm_stop_master(struct iwl_trans
*trans
)
506 /* stop device's busmaster DMA activity */
507 iwl_set_bit(trans
, CSR_RESET
, CSR_RESET_REG_FLAG_STOP_MASTER
);
509 ret
= iwl_poll_bit(trans
, CSR_RESET
,
510 CSR_RESET_REG_FLAG_MASTER_DISABLED
,
511 CSR_RESET_REG_FLAG_MASTER_DISABLED
, 100);
513 IWL_WARN(trans
, "Master Disable Timed Out, 100 usec\n");
515 IWL_DEBUG_INFO(trans
, "stop master\n");
518 static void iwl_pcie_apm_stop(struct iwl_trans
*trans
, bool op_mode_leave
)
520 IWL_DEBUG_INFO(trans
, "Stop card, put in low power state\n");
523 if (!test_bit(STATUS_DEVICE_ENABLED
, &trans
->status
))
524 iwl_pcie_apm_init(trans
);
526 /* inform ME that we are leaving */
527 if (trans
->trans_cfg
->device_family
== IWL_DEVICE_FAMILY_7000
)
528 iwl_set_bits_prph(trans
, APMG_PCIDEV_STT_REG
,
529 APMG_PCIDEV_STT_VAL_WAKE_ME
);
530 else if (trans
->trans_cfg
->device_family
>=
531 IWL_DEVICE_FAMILY_8000
) {
532 iwl_set_bit(trans
, CSR_DBG_LINK_PWR_MGMT_REG
,
533 CSR_RESET_LINK_PWR_MGMT_DISABLED
);
534 iwl_set_bit(trans
, CSR_HW_IF_CONFIG_REG
,
535 CSR_HW_IF_CONFIG_REG_PREPARE
|
536 CSR_HW_IF_CONFIG_REG_ENABLE_PME
);
538 iwl_clear_bit(trans
, CSR_DBG_LINK_PWR_MGMT_REG
,
539 CSR_RESET_LINK_PWR_MGMT_DISABLED
);
544 clear_bit(STATUS_DEVICE_ENABLED
, &trans
->status
);
546 /* Stop device's DMA activity */
547 iwl_pcie_apm_stop_master(trans
);
549 if (trans
->cfg
->lp_xtal_workaround
) {
550 iwl_pcie_apm_lp_xtal_enable(trans
);
554 iwl_trans_pcie_sw_reset(trans
);
557 * Clear "initialization complete" bit to move adapter from
558 * D0A* (powered-up Active) --> D0U* (Uninitialized) state.
560 iwl_clear_bit(trans
, CSR_GP_CNTRL
, CSR_GP_CNTRL_REG_FLAG_INIT_DONE
);
563 static int iwl_pcie_nic_init(struct iwl_trans
*trans
)
565 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
569 spin_lock(&trans_pcie
->irq_lock
);
570 ret
= iwl_pcie_apm_init(trans
);
571 spin_unlock(&trans_pcie
->irq_lock
);
576 iwl_pcie_set_pwr(trans
, false);
578 iwl_op_mode_nic_config(trans
->op_mode
);
580 /* Allocate the RX queue, or reset if it is already allocated */
581 iwl_pcie_rx_init(trans
);
583 /* Allocate or reset and init all Tx and Command queues */
584 if (iwl_pcie_tx_init(trans
))
587 if (trans
->trans_cfg
->base_params
->shadow_reg_enable
) {
588 /* enable shadow regs in HW */
589 iwl_set_bit(trans
, CSR_MAC_SHADOW_REG_CTRL
, 0x800FFFFF);
590 IWL_DEBUG_INFO(trans
, "Enabling shadow registers in device\n");
596 #define HW_READY_TIMEOUT (50)
598 /* Note: returns poll_bit return value, which is >= 0 if success */
599 static int iwl_pcie_set_hw_ready(struct iwl_trans
*trans
)
603 iwl_set_bit(trans
, CSR_HW_IF_CONFIG_REG
,
604 CSR_HW_IF_CONFIG_REG_BIT_NIC_READY
);
606 /* See if we got it */
607 ret
= iwl_poll_bit(trans
, CSR_HW_IF_CONFIG_REG
,
608 CSR_HW_IF_CONFIG_REG_BIT_NIC_READY
,
609 CSR_HW_IF_CONFIG_REG_BIT_NIC_READY
,
613 iwl_set_bit(trans
, CSR_MBOX_SET_REG
, CSR_MBOX_SET_REG_OS_ALIVE
);
615 IWL_DEBUG_INFO(trans
, "hardware%s ready\n", ret
< 0 ? " not" : "");
619 /* Note: returns standard 0/-ERROR code */
620 int iwl_pcie_prepare_card_hw(struct iwl_trans
*trans
)
626 IWL_DEBUG_INFO(trans
, "iwl_trans_prepare_card_hw enter\n");
628 ret
= iwl_pcie_set_hw_ready(trans
);
629 /* If the card is ready, exit 0 */
633 iwl_set_bit(trans
, CSR_DBG_LINK_PWR_MGMT_REG
,
634 CSR_RESET_LINK_PWR_MGMT_DISABLED
);
635 usleep_range(1000, 2000);
637 for (iter
= 0; iter
< 10; iter
++) {
638 /* If HW is not ready, prepare the conditions to check again */
639 iwl_set_bit(trans
, CSR_HW_IF_CONFIG_REG
,
640 CSR_HW_IF_CONFIG_REG_PREPARE
);
643 ret
= iwl_pcie_set_hw_ready(trans
);
647 usleep_range(200, 1000);
649 } while (t
< 150000);
653 IWL_ERR(trans
, "Couldn't prepare the card\n");
661 static void iwl_pcie_load_firmware_chunk_fh(struct iwl_trans
*trans
,
662 u32 dst_addr
, dma_addr_t phy_addr
,
665 iwl_write32(trans
, FH_TCSR_CHNL_TX_CONFIG_REG(FH_SRVC_CHNL
),
666 FH_TCSR_TX_CONFIG_REG_VAL_DMA_CHNL_PAUSE
);
668 iwl_write32(trans
, FH_SRVC_CHNL_SRAM_ADDR_REG(FH_SRVC_CHNL
),
671 iwl_write32(trans
, FH_TFDIB_CTRL0_REG(FH_SRVC_CHNL
),
672 phy_addr
& FH_MEM_TFDIB_DRAM_ADDR_LSB_MSK
);
674 iwl_write32(trans
, FH_TFDIB_CTRL1_REG(FH_SRVC_CHNL
),
675 (iwl_get_dma_hi_addr(phy_addr
)
676 << FH_MEM_TFDIB_REG1_ADDR_BITSHIFT
) | byte_cnt
);
678 iwl_write32(trans
, FH_TCSR_CHNL_TX_BUF_STS_REG(FH_SRVC_CHNL
),
679 BIT(FH_TCSR_CHNL_TX_BUF_STS_REG_POS_TB_NUM
) |
680 BIT(FH_TCSR_CHNL_TX_BUF_STS_REG_POS_TB_IDX
) |
681 FH_TCSR_CHNL_TX_BUF_STS_REG_VAL_TFDB_VALID
);
683 iwl_write32(trans
, FH_TCSR_CHNL_TX_CONFIG_REG(FH_SRVC_CHNL
),
684 FH_TCSR_TX_CONFIG_REG_VAL_DMA_CHNL_ENABLE
|
685 FH_TCSR_TX_CONFIG_REG_VAL_DMA_CREDIT_DISABLE
|
686 FH_TCSR_TX_CONFIG_REG_VAL_CIRQ_HOST_ENDTFD
);
689 static int iwl_pcie_load_firmware_chunk(struct iwl_trans
*trans
,
690 u32 dst_addr
, dma_addr_t phy_addr
,
693 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
697 trans_pcie
->ucode_write_complete
= false;
699 if (!iwl_trans_grab_nic_access(trans
, &flags
))
702 iwl_pcie_load_firmware_chunk_fh(trans
, dst_addr
, phy_addr
,
704 iwl_trans_release_nic_access(trans
, &flags
);
706 ret
= wait_event_timeout(trans_pcie
->ucode_write_waitq
,
707 trans_pcie
->ucode_write_complete
, 5 * HZ
);
709 IWL_ERR(trans
, "Failed to load firmware chunk!\n");
710 iwl_trans_pcie_dump_regs(trans
);
717 static int iwl_pcie_load_section(struct iwl_trans
*trans
, u8 section_num
,
718 const struct fw_desc
*section
)
722 u32 offset
, chunk_sz
= min_t(u32
, FH_MEM_TB_MAX_LENGTH
, section
->len
);
725 IWL_DEBUG_FW(trans
, "[%d] uCode section being loaded...\n",
728 v_addr
= dma_alloc_coherent(trans
->dev
, chunk_sz
, &p_addr
,
729 GFP_KERNEL
| __GFP_NOWARN
);
731 IWL_DEBUG_INFO(trans
, "Falling back to small chunks of DMA\n");
732 chunk_sz
= PAGE_SIZE
;
733 v_addr
= dma_alloc_coherent(trans
->dev
, chunk_sz
,
734 &p_addr
, GFP_KERNEL
);
739 for (offset
= 0; offset
< section
->len
; offset
+= chunk_sz
) {
740 u32 copy_size
, dst_addr
;
741 bool extended_addr
= false;
743 copy_size
= min_t(u32
, chunk_sz
, section
->len
- offset
);
744 dst_addr
= section
->offset
+ offset
;
746 if (dst_addr
>= IWL_FW_MEM_EXTENDED_START
&&
747 dst_addr
<= IWL_FW_MEM_EXTENDED_END
)
748 extended_addr
= true;
751 iwl_set_bits_prph(trans
, LMPM_CHICK
,
752 LMPM_CHICK_EXTENDED_ADDR_SPACE
);
754 memcpy(v_addr
, (u8
*)section
->data
+ offset
, copy_size
);
755 ret
= iwl_pcie_load_firmware_chunk(trans
, dst_addr
, p_addr
,
759 iwl_clear_bits_prph(trans
, LMPM_CHICK
,
760 LMPM_CHICK_EXTENDED_ADDR_SPACE
);
764 "Could not load the [%d] uCode section\n",
770 dma_free_coherent(trans
->dev
, chunk_sz
, v_addr
, p_addr
);
774 static int iwl_pcie_load_cpu_sections_8000(struct iwl_trans
*trans
,
775 const struct fw_img
*image
,
777 int *first_ucode_section
)
780 int i
, ret
= 0, sec_num
= 0x1;
781 u32 val
, last_read_idx
= 0;
785 *first_ucode_section
= 0;
788 (*first_ucode_section
)++;
791 for (i
= *first_ucode_section
; i
< image
->num_sec
; i
++) {
795 * CPU1_CPU2_SEPARATOR_SECTION delimiter - separate between
797 * PAGING_SEPARATOR_SECTION delimiter - separate between
798 * CPU2 non paged to CPU2 paging sec.
800 if (!image
->sec
[i
].data
||
801 image
->sec
[i
].offset
== CPU1_CPU2_SEPARATOR_SECTION
||
802 image
->sec
[i
].offset
== PAGING_SEPARATOR_SECTION
) {
804 "Break since Data not valid or Empty section, sec = %d\n",
809 ret
= iwl_pcie_load_section(trans
, i
, &image
->sec
[i
]);
813 /* Notify ucode of loaded section number and status */
814 val
= iwl_read_direct32(trans
, FH_UCODE_LOAD_STATUS
);
815 val
= val
| (sec_num
<< shift_param
);
816 iwl_write_direct32(trans
, FH_UCODE_LOAD_STATUS
, val
);
818 sec_num
= (sec_num
<< 1) | 0x1;
821 *first_ucode_section
= last_read_idx
;
823 iwl_enable_interrupts(trans
);
825 if (trans
->trans_cfg
->use_tfh
) {
827 iwl_write_prph(trans
, UREG_UCODE_LOAD_STATUS
,
830 iwl_write_prph(trans
, UREG_UCODE_LOAD_STATUS
,
834 iwl_write_direct32(trans
, FH_UCODE_LOAD_STATUS
,
837 iwl_write_direct32(trans
, FH_UCODE_LOAD_STATUS
,
844 static int iwl_pcie_load_cpu_sections(struct iwl_trans
*trans
,
845 const struct fw_img
*image
,
847 int *first_ucode_section
)
850 u32 last_read_idx
= 0;
853 *first_ucode_section
= 0;
855 (*first_ucode_section
)++;
857 for (i
= *first_ucode_section
; i
< image
->num_sec
; i
++) {
861 * CPU1_CPU2_SEPARATOR_SECTION delimiter - separate between
863 * PAGING_SEPARATOR_SECTION delimiter - separate between
864 * CPU2 non paged to CPU2 paging sec.
866 if (!image
->sec
[i
].data
||
867 image
->sec
[i
].offset
== CPU1_CPU2_SEPARATOR_SECTION
||
868 image
->sec
[i
].offset
== PAGING_SEPARATOR_SECTION
) {
870 "Break since Data not valid or Empty section, sec = %d\n",
875 ret
= iwl_pcie_load_section(trans
, i
, &image
->sec
[i
]);
880 *first_ucode_section
= last_read_idx
;
885 static void iwl_pcie_apply_destination_ini(struct iwl_trans
*trans
)
887 enum iwl_fw_ini_allocation_id alloc_id
= IWL_FW_INI_ALLOCATION_ID_DBGC1
;
888 struct iwl_fw_ini_allocation_tlv
*fw_mon_cfg
=
889 &trans
->dbg
.fw_mon_cfg
[alloc_id
];
890 struct iwl_dram_data
*frag
;
892 if (!iwl_trans_dbg_ini_valid(trans
))
895 if (le32_to_cpu(fw_mon_cfg
->buf_location
) ==
896 IWL_FW_INI_LOCATION_SRAM_PATH
) {
897 IWL_DEBUG_FW(trans
, "WRT: Applying SMEM buffer destination\n");
898 /* set sram monitor by enabling bit 7 */
899 iwl_set_bit(trans
, CSR_HW_IF_CONFIG_REG
,
900 CSR_HW_IF_CONFIG_REG_BIT_MONITOR_SRAM
);
905 if (le32_to_cpu(fw_mon_cfg
->buf_location
) !=
906 IWL_FW_INI_LOCATION_DRAM_PATH
||
907 !trans
->dbg
.fw_mon_ini
[alloc_id
].num_frags
)
910 frag
= &trans
->dbg
.fw_mon_ini
[alloc_id
].frags
[0];
912 IWL_DEBUG_FW(trans
, "WRT: Applying DRAM destination (alloc_id=%u)\n",
915 iwl_write_umac_prph(trans
, MON_BUFF_BASE_ADDR_VER2
,
916 frag
->physical
>> MON_BUFF_SHIFT_VER2
);
917 iwl_write_umac_prph(trans
, MON_BUFF_END_ADDR_VER2
,
918 (frag
->physical
+ frag
->size
- 256) >>
919 MON_BUFF_SHIFT_VER2
);
922 void iwl_pcie_apply_destination(struct iwl_trans
*trans
)
924 const struct iwl_fw_dbg_dest_tlv_v1
*dest
= trans
->dbg
.dest_tlv
;
925 const struct iwl_dram_data
*fw_mon
= &trans
->dbg
.fw_mon
;
928 if (iwl_trans_dbg_ini_valid(trans
)) {
929 iwl_pcie_apply_destination_ini(trans
);
933 IWL_INFO(trans
, "Applying debug destination %s\n",
934 get_fw_dbg_mode_string(dest
->monitor_mode
));
936 if (dest
->monitor_mode
== EXTERNAL_MODE
)
937 iwl_pcie_alloc_fw_monitor(trans
, dest
->size_power
);
939 IWL_WARN(trans
, "PCI should have external buffer debug\n");
941 for (i
= 0; i
< trans
->dbg
.n_dest_reg
; i
++) {
942 u32 addr
= le32_to_cpu(dest
->reg_ops
[i
].addr
);
943 u32 val
= le32_to_cpu(dest
->reg_ops
[i
].val
);
945 switch (dest
->reg_ops
[i
].op
) {
947 iwl_write32(trans
, addr
, val
);
950 iwl_set_bit(trans
, addr
, BIT(val
));
953 iwl_clear_bit(trans
, addr
, BIT(val
));
956 iwl_write_prph(trans
, addr
, val
);
959 iwl_set_bits_prph(trans
, addr
, BIT(val
));
962 iwl_clear_bits_prph(trans
, addr
, BIT(val
));
965 if (iwl_read_prph(trans
, addr
) & BIT(val
)) {
967 "BIT(%u) in address 0x%x is 1, stopping FW configuration\n",
973 IWL_ERR(trans
, "FW debug - unknown OP %d\n",
974 dest
->reg_ops
[i
].op
);
980 if (dest
->monitor_mode
== EXTERNAL_MODE
&& fw_mon
->size
) {
981 iwl_write_prph(trans
, le32_to_cpu(dest
->base_reg
),
982 fw_mon
->physical
>> dest
->base_shift
);
983 if (trans
->trans_cfg
->device_family
>= IWL_DEVICE_FAMILY_8000
)
984 iwl_write_prph(trans
, le32_to_cpu(dest
->end_reg
),
985 (fw_mon
->physical
+ fw_mon
->size
-
986 256) >> dest
->end_shift
);
988 iwl_write_prph(trans
, le32_to_cpu(dest
->end_reg
),
989 (fw_mon
->physical
+ fw_mon
->size
) >>
994 static int iwl_pcie_load_given_ucode(struct iwl_trans
*trans
,
995 const struct fw_img
*image
)
998 int first_ucode_section
;
1000 IWL_DEBUG_FW(trans
, "working with %s CPU\n",
1001 image
->is_dual_cpus
? "Dual" : "Single");
1003 /* load to FW the binary non secured sections of CPU1 */
1004 ret
= iwl_pcie_load_cpu_sections(trans
, image
, 1, &first_ucode_section
);
1008 if (image
->is_dual_cpus
) {
1009 /* set CPU2 header address */
1010 iwl_write_prph(trans
,
1011 LMPM_SECURE_UCODE_LOAD_CPU2_HDR_ADDR
,
1012 LMPM_SECURE_CPU2_HDR_MEM_SPACE
);
1014 /* load to FW the binary sections of CPU2 */
1015 ret
= iwl_pcie_load_cpu_sections(trans
, image
, 2,
1016 &first_ucode_section
);
1021 /* supported for 7000 only for the moment */
1022 if (iwlwifi_mod_params
.fw_monitor
&&
1023 trans
->trans_cfg
->device_family
== IWL_DEVICE_FAMILY_7000
) {
1024 struct iwl_dram_data
*fw_mon
= &trans
->dbg
.fw_mon
;
1026 iwl_pcie_alloc_fw_monitor(trans
, 0);
1028 iwl_write_prph(trans
, MON_BUFF_BASE_ADDR
,
1029 fw_mon
->physical
>> 4);
1030 iwl_write_prph(trans
, MON_BUFF_END_ADDR
,
1031 (fw_mon
->physical
+ fw_mon
->size
) >> 4);
1033 } else if (iwl_pcie_dbg_on(trans
)) {
1034 iwl_pcie_apply_destination(trans
);
1037 iwl_enable_interrupts(trans
);
1039 /* release CPU reset */
1040 iwl_write32(trans
, CSR_RESET
, 0);
1045 static int iwl_pcie_load_given_ucode_8000(struct iwl_trans
*trans
,
1046 const struct fw_img
*image
)
1049 int first_ucode_section
;
1051 IWL_DEBUG_FW(trans
, "working with %s CPU\n",
1052 image
->is_dual_cpus
? "Dual" : "Single");
1054 if (iwl_pcie_dbg_on(trans
))
1055 iwl_pcie_apply_destination(trans
);
1057 IWL_DEBUG_POWER(trans
, "Original WFPM value = 0x%08X\n",
1058 iwl_read_prph(trans
, WFPM_GP2
));
1061 * Set default value. On resume reading the values that were
1062 * zeored can provide debug data on the resume flow.
1063 * This is for debugging only and has no functional impact.
1065 iwl_write_prph(trans
, WFPM_GP2
, 0x01010101);
1067 /* configure the ucode to be ready to get the secured image */
1068 /* release CPU reset */
1069 iwl_write_prph(trans
, RELEASE_CPU_RESET
, RELEASE_CPU_RESET_BIT
);
1071 /* load to FW the binary Secured sections of CPU1 */
1072 ret
= iwl_pcie_load_cpu_sections_8000(trans
, image
, 1,
1073 &first_ucode_section
);
1077 /* load to FW the binary sections of CPU2 */
1078 return iwl_pcie_load_cpu_sections_8000(trans
, image
, 2,
1079 &first_ucode_section
);
1082 bool iwl_pcie_check_hw_rf_kill(struct iwl_trans
*trans
)
1084 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
1085 bool hw_rfkill
= iwl_is_rfkill_set(trans
);
1086 bool prev
= test_bit(STATUS_RFKILL_OPMODE
, &trans
->status
);
1090 set_bit(STATUS_RFKILL_HW
, &trans
->status
);
1091 set_bit(STATUS_RFKILL_OPMODE
, &trans
->status
);
1093 clear_bit(STATUS_RFKILL_HW
, &trans
->status
);
1094 if (trans_pcie
->opmode_down
)
1095 clear_bit(STATUS_RFKILL_OPMODE
, &trans
->status
);
1098 report
= test_bit(STATUS_RFKILL_OPMODE
, &trans
->status
);
1101 iwl_trans_pcie_rf_kill(trans
, report
);
1106 struct iwl_causes_list
{
1112 static struct iwl_causes_list causes_list
[] = {
1113 {MSIX_FH_INT_CAUSES_D2S_CH0_NUM
, CSR_MSIX_FH_INT_MASK_AD
, 0},
1114 {MSIX_FH_INT_CAUSES_D2S_CH1_NUM
, CSR_MSIX_FH_INT_MASK_AD
, 0x1},
1115 {MSIX_FH_INT_CAUSES_S2D
, CSR_MSIX_FH_INT_MASK_AD
, 0x3},
1116 {MSIX_FH_INT_CAUSES_FH_ERR
, CSR_MSIX_FH_INT_MASK_AD
, 0x5},
1117 {MSIX_HW_INT_CAUSES_REG_ALIVE
, CSR_MSIX_HW_INT_MASK_AD
, 0x10},
1118 {MSIX_HW_INT_CAUSES_REG_WAKEUP
, CSR_MSIX_HW_INT_MASK_AD
, 0x11},
1119 {MSIX_HW_INT_CAUSES_REG_IML
, CSR_MSIX_HW_INT_MASK_AD
, 0x12},
1120 {MSIX_HW_INT_CAUSES_REG_CT_KILL
, CSR_MSIX_HW_INT_MASK_AD
, 0x16},
1121 {MSIX_HW_INT_CAUSES_REG_RF_KILL
, CSR_MSIX_HW_INT_MASK_AD
, 0x17},
1122 {MSIX_HW_INT_CAUSES_REG_PERIODIC
, CSR_MSIX_HW_INT_MASK_AD
, 0x18},
1123 {MSIX_HW_INT_CAUSES_REG_SW_ERR
, CSR_MSIX_HW_INT_MASK_AD
, 0x29},
1124 {MSIX_HW_INT_CAUSES_REG_SCD
, CSR_MSIX_HW_INT_MASK_AD
, 0x2A},
1125 {MSIX_HW_INT_CAUSES_REG_FH_TX
, CSR_MSIX_HW_INT_MASK_AD
, 0x2B},
1126 {MSIX_HW_INT_CAUSES_REG_HW_ERR
, CSR_MSIX_HW_INT_MASK_AD
, 0x2D},
1127 {MSIX_HW_INT_CAUSES_REG_HAP
, CSR_MSIX_HW_INT_MASK_AD
, 0x2E},
1130 static void iwl_pcie_map_non_rx_causes(struct iwl_trans
*trans
)
1132 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
1133 int val
= trans_pcie
->def_irq
| MSIX_NON_AUTO_CLEAR_CAUSE
;
1134 int i
, arr_size
= ARRAY_SIZE(causes_list
);
1135 struct iwl_causes_list
*causes
= causes_list
;
1138 * Access all non RX causes and map them to the default irq.
1139 * In case we are missing at least one interrupt vector,
1140 * the first interrupt vector will serve non-RX and FBQ causes.
1142 for (i
= 0; i
< arr_size
; i
++) {
1143 iwl_write8(trans
, CSR_MSIX_IVAR(causes
[i
].addr
), val
);
1144 iwl_clear_bit(trans
, causes
[i
].mask_reg
,
1145 causes
[i
].cause_num
);
1149 static void iwl_pcie_map_rx_causes(struct iwl_trans
*trans
)
1151 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
1153 trans_pcie
->shared_vec_mask
& IWL_SHARED_IRQ_FIRST_RSS
? 1 : 0;
1157 * The first RX queue - fallback queue, which is designated for
1158 * management frame, command responses etc, is always mapped to the
1159 * first interrupt vector. The other RX queues are mapped to
1160 * the other (N - 2) interrupt vectors.
1162 val
= BIT(MSIX_FH_INT_CAUSES_Q(0));
1163 for (idx
= 1; idx
< trans
->num_rx_queues
; idx
++) {
1164 iwl_write8(trans
, CSR_MSIX_RX_IVAR(idx
),
1165 MSIX_FH_INT_CAUSES_Q(idx
- offset
));
1166 val
|= BIT(MSIX_FH_INT_CAUSES_Q(idx
));
1168 iwl_write32(trans
, CSR_MSIX_FH_INT_MASK_AD
, ~val
);
1170 val
= MSIX_FH_INT_CAUSES_Q(0);
1171 if (trans_pcie
->shared_vec_mask
& IWL_SHARED_IRQ_NON_RX
)
1172 val
|= MSIX_NON_AUTO_CLEAR_CAUSE
;
1173 iwl_write8(trans
, CSR_MSIX_RX_IVAR(0), val
);
1175 if (trans_pcie
->shared_vec_mask
& IWL_SHARED_IRQ_FIRST_RSS
)
1176 iwl_write8(trans
, CSR_MSIX_RX_IVAR(1), val
);
1179 void iwl_pcie_conf_msix_hw(struct iwl_trans_pcie
*trans_pcie
)
1181 struct iwl_trans
*trans
= trans_pcie
->trans
;
1183 if (!trans_pcie
->msix_enabled
) {
1184 if (trans
->trans_cfg
->mq_rx_supported
&&
1185 test_bit(STATUS_DEVICE_ENABLED
, &trans
->status
))
1186 iwl_write_umac_prph(trans
, UREG_CHICK
,
1187 UREG_CHICK_MSI_ENABLE
);
1191 * The IVAR table needs to be configured again after reset,
1192 * but if the device is disabled, we can't write to
1195 if (test_bit(STATUS_DEVICE_ENABLED
, &trans
->status
))
1196 iwl_write_umac_prph(trans
, UREG_CHICK
, UREG_CHICK_MSIX_ENABLE
);
1199 * Each cause from the causes list above and the RX causes is
1200 * represented as a byte in the IVAR table. The first nibble
1201 * represents the bound interrupt vector of the cause, the second
1202 * represents no auto clear for this cause. This will be set if its
1203 * interrupt vector is bound to serve other causes.
1205 iwl_pcie_map_rx_causes(trans
);
1207 iwl_pcie_map_non_rx_causes(trans
);
1210 static void iwl_pcie_init_msix(struct iwl_trans_pcie
*trans_pcie
)
1212 struct iwl_trans
*trans
= trans_pcie
->trans
;
1214 iwl_pcie_conf_msix_hw(trans_pcie
);
1216 if (!trans_pcie
->msix_enabled
)
1219 trans_pcie
->fh_init_mask
= ~iwl_read32(trans
, CSR_MSIX_FH_INT_MASK_AD
);
1220 trans_pcie
->fh_mask
= trans_pcie
->fh_init_mask
;
1221 trans_pcie
->hw_init_mask
= ~iwl_read32(trans
, CSR_MSIX_HW_INT_MASK_AD
);
1222 trans_pcie
->hw_mask
= trans_pcie
->hw_init_mask
;
1225 static void _iwl_trans_pcie_stop_device(struct iwl_trans
*trans
)
1227 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
1229 lockdep_assert_held(&trans_pcie
->mutex
);
1231 if (trans_pcie
->is_down
)
1234 trans_pcie
->is_down
= true;
1236 /* tell the device to stop sending interrupts */
1237 iwl_disable_interrupts(trans
);
1239 /* device going down, Stop using ICT table */
1240 iwl_pcie_disable_ict(trans
);
1243 * If a HW restart happens during firmware loading,
1244 * then the firmware loading might call this function
1245 * and later it might be called again due to the
1246 * restart. So don't process again if the device is
1249 if (test_and_clear_bit(STATUS_DEVICE_ENABLED
, &trans
->status
)) {
1250 IWL_DEBUG_INFO(trans
,
1251 "DEVICE_ENABLED bit was set and is now cleared\n");
1252 iwl_pcie_tx_stop(trans
);
1253 iwl_pcie_rx_stop(trans
);
1255 /* Power-down device's busmaster DMA clocks */
1256 if (!trans
->cfg
->apmg_not_supported
) {
1257 iwl_write_prph(trans
, APMG_CLK_DIS_REG
,
1258 APMG_CLK_VAL_DMA_CLK_RQT
);
1263 /* Make sure (redundant) we've released our request to stay awake */
1264 iwl_clear_bit(trans
, CSR_GP_CNTRL
,
1265 CSR_GP_CNTRL_REG_FLAG_MAC_ACCESS_REQ
);
1267 /* Stop the device, and put it in low power state */
1268 iwl_pcie_apm_stop(trans
, false);
1270 iwl_trans_pcie_sw_reset(trans
);
1273 * Upon stop, the IVAR table gets erased, so msi-x won't
1274 * work. This causes a bug in RF-KILL flows, since the interrupt
1275 * that enables radio won't fire on the correct irq, and the
1276 * driver won't be able to handle the interrupt.
1277 * Configure the IVAR table again after reset.
1279 iwl_pcie_conf_msix_hw(trans_pcie
);
1282 * Upon stop, the APM issues an interrupt if HW RF kill is set.
1283 * This is a bug in certain verions of the hardware.
1284 * Certain devices also keep sending HW RF kill interrupt all
1285 * the time, unless the interrupt is ACKed even if the interrupt
1286 * should be masked. Re-ACK all the interrupts here.
1288 iwl_disable_interrupts(trans
);
1290 /* clear all status bits */
1291 clear_bit(STATUS_SYNC_HCMD_ACTIVE
, &trans
->status
);
1292 clear_bit(STATUS_INT_ENABLED
, &trans
->status
);
1293 clear_bit(STATUS_TPOWER_PMI
, &trans
->status
);
1296 * Even if we stop the HW, we still want the RF kill
1299 iwl_enable_rfkill_int(trans
);
1301 /* re-take ownership to prevent other users from stealing the device */
1302 iwl_pcie_prepare_card_hw(trans
);
1305 void iwl_pcie_synchronize_irqs(struct iwl_trans
*trans
)
1307 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
1309 if (trans_pcie
->msix_enabled
) {
1312 for (i
= 0; i
< trans_pcie
->alloc_vecs
; i
++)
1313 synchronize_irq(trans_pcie
->msix_entries
[i
].vector
);
1315 synchronize_irq(trans_pcie
->pci_dev
->irq
);
1319 static int iwl_trans_pcie_start_fw(struct iwl_trans
*trans
,
1320 const struct fw_img
*fw
, bool run_in_rfkill
)
1322 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
1326 /* This may fail if AMT took ownership of the device */
1327 if (iwl_pcie_prepare_card_hw(trans
)) {
1328 IWL_WARN(trans
, "Exit HW not ready\n");
1333 iwl_enable_rfkill_int(trans
);
1335 iwl_write32(trans
, CSR_INT
, 0xFFFFFFFF);
1338 * We enabled the RF-Kill interrupt and the handler may very
1339 * well be running. Disable the interrupts to make sure no other
1340 * interrupt can be fired.
1342 iwl_disable_interrupts(trans
);
1344 /* Make sure it finished running */
1345 iwl_pcie_synchronize_irqs(trans
);
1347 mutex_lock(&trans_pcie
->mutex
);
1349 /* If platform's RF_KILL switch is NOT set to KILL */
1350 hw_rfkill
= iwl_pcie_check_hw_rf_kill(trans
);
1351 if (hw_rfkill
&& !run_in_rfkill
) {
1356 /* Someone called stop_device, don't try to start_fw */
1357 if (trans_pcie
->is_down
) {
1359 "Can't start_fw since the HW hasn't been started\n");
1364 /* make sure rfkill handshake bits are cleared */
1365 iwl_write32(trans
, CSR_UCODE_DRV_GP1_CLR
, CSR_UCODE_SW_BIT_RFKILL
);
1366 iwl_write32(trans
, CSR_UCODE_DRV_GP1_CLR
,
1367 CSR_UCODE_DRV_GP1_BIT_CMD_BLOCKED
);
1369 /* clear (again), then enable host interrupts */
1370 iwl_write32(trans
, CSR_INT
, 0xFFFFFFFF);
1372 ret
= iwl_pcie_nic_init(trans
);
1374 IWL_ERR(trans
, "Unable to init nic\n");
1379 * Now, we load the firmware and don't want to be interrupted, even
1380 * by the RF-Kill interrupt (hence mask all the interrupt besides the
1381 * FH_TX interrupt which is needed to load the firmware). If the
1382 * RF-Kill switch is toggled, we will find out after having loaded
1383 * the firmware and return the proper value to the caller.
1385 iwl_enable_fw_load_int(trans
);
1387 /* really make sure rfkill handshake bits are cleared */
1388 iwl_write32(trans
, CSR_UCODE_DRV_GP1_CLR
, CSR_UCODE_SW_BIT_RFKILL
);
1389 iwl_write32(trans
, CSR_UCODE_DRV_GP1_CLR
, CSR_UCODE_SW_BIT_RFKILL
);
1391 /* Load the given image to the HW */
1392 if (trans
->trans_cfg
->device_family
>= IWL_DEVICE_FAMILY_8000
)
1393 ret
= iwl_pcie_load_given_ucode_8000(trans
, fw
);
1395 ret
= iwl_pcie_load_given_ucode(trans
, fw
);
1397 /* re-check RF-Kill state since we may have missed the interrupt */
1398 hw_rfkill
= iwl_pcie_check_hw_rf_kill(trans
);
1399 if (hw_rfkill
&& !run_in_rfkill
)
1403 mutex_unlock(&trans_pcie
->mutex
);
1407 static void iwl_trans_pcie_fw_alive(struct iwl_trans
*trans
, u32 scd_addr
)
1409 iwl_pcie_reset_ict(trans
);
1410 iwl_pcie_tx_start(trans
, scd_addr
);
1413 void iwl_trans_pcie_handle_stop_rfkill(struct iwl_trans
*trans
,
1419 * Check again since the RF kill state may have changed while
1420 * all the interrupts were disabled, in this case we couldn't
1421 * receive the RF kill interrupt and update the state in the
1423 * Don't call the op_mode if the rkfill state hasn't changed.
1424 * This allows the op_mode to call stop_device from the rfkill
1425 * notification without endless recursion. Under very rare
1426 * circumstances, we might have a small recursion if the rfkill
1427 * state changed exactly now while we were called from stop_device.
1428 * This is very unlikely but can happen and is supported.
1430 hw_rfkill
= iwl_is_rfkill_set(trans
);
1432 set_bit(STATUS_RFKILL_HW
, &trans
->status
);
1433 set_bit(STATUS_RFKILL_OPMODE
, &trans
->status
);
1435 clear_bit(STATUS_RFKILL_HW
, &trans
->status
);
1436 clear_bit(STATUS_RFKILL_OPMODE
, &trans
->status
);
1438 if (hw_rfkill
!= was_in_rfkill
)
1439 iwl_trans_pcie_rf_kill(trans
, hw_rfkill
);
1442 static void iwl_trans_pcie_stop_device(struct iwl_trans
*trans
)
1444 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
1447 mutex_lock(&trans_pcie
->mutex
);
1448 trans_pcie
->opmode_down
= true;
1449 was_in_rfkill
= test_bit(STATUS_RFKILL_OPMODE
, &trans
->status
);
1450 _iwl_trans_pcie_stop_device(trans
);
1451 iwl_trans_pcie_handle_stop_rfkill(trans
, was_in_rfkill
);
1452 mutex_unlock(&trans_pcie
->mutex
);
1455 void iwl_trans_pcie_rf_kill(struct iwl_trans
*trans
, bool state
)
1457 struct iwl_trans_pcie __maybe_unused
*trans_pcie
=
1458 IWL_TRANS_GET_PCIE_TRANS(trans
);
1460 lockdep_assert_held(&trans_pcie
->mutex
);
1462 IWL_WARN(trans
, "reporting RF_KILL (radio %s)\n",
1463 state
? "disabled" : "enabled");
1464 if (iwl_op_mode_hw_rf_kill(trans
->op_mode
, state
)) {
1465 if (trans
->trans_cfg
->gen2
)
1466 _iwl_trans_pcie_gen2_stop_device(trans
);
1468 _iwl_trans_pcie_stop_device(trans
);
1472 void iwl_pcie_d3_complete_suspend(struct iwl_trans
*trans
,
1473 bool test
, bool reset
)
1475 iwl_disable_interrupts(trans
);
1478 * in testing mode, the host stays awake and the
1479 * hardware won't be reset (not even partially)
1484 iwl_pcie_disable_ict(trans
);
1486 iwl_pcie_synchronize_irqs(trans
);
1488 iwl_clear_bit(trans
, CSR_GP_CNTRL
,
1489 CSR_GP_CNTRL_REG_FLAG_MAC_ACCESS_REQ
);
1490 iwl_clear_bit(trans
, CSR_GP_CNTRL
, CSR_GP_CNTRL_REG_FLAG_INIT_DONE
);
1494 * reset TX queues -- some of their registers reset during S3
1495 * so if we don't reset everything here the D3 image would try
1496 * to execute some invalid memory upon resume
1498 iwl_trans_pcie_tx_reset(trans
);
1501 iwl_pcie_set_pwr(trans
, true);
1504 static int iwl_trans_pcie_d3_suspend(struct iwl_trans
*trans
, bool test
,
1508 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
1511 * Family IWL_DEVICE_FAMILY_AX210 and above persist mode is set by FW.
1513 if (!reset
&& trans
->trans_cfg
->device_family
< IWL_DEVICE_FAMILY_AX210
) {
1514 /* Enable persistence mode to avoid reset */
1515 iwl_set_bit(trans
, CSR_HW_IF_CONFIG_REG
,
1516 CSR_HW_IF_CONFIG_REG_PERSIST_MODE
);
1519 if (trans
->trans_cfg
->device_family
>= IWL_DEVICE_FAMILY_AX210
) {
1520 iwl_write_umac_prph(trans
, UREG_DOORBELL_TO_ISR6
,
1521 UREG_DOORBELL_TO_ISR6_SUSPEND
);
1523 ret
= wait_event_timeout(trans_pcie
->sx_waitq
,
1524 trans_pcie
->sx_complete
, 2 * HZ
);
1526 * Invalidate it toward resume.
1528 trans_pcie
->sx_complete
= false;
1531 IWL_ERR(trans
, "Timeout entering D3\n");
1535 iwl_pcie_d3_complete_suspend(trans
, test
, reset
);
1540 static int iwl_trans_pcie_d3_resume(struct iwl_trans
*trans
,
1541 enum iwl_d3_status
*status
,
1542 bool test
, bool reset
)
1544 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
1549 iwl_enable_interrupts(trans
);
1550 *status
= IWL_D3_STATUS_ALIVE
;
1554 iwl_set_bit(trans
, CSR_GP_CNTRL
,
1555 CSR_GP_CNTRL_REG_FLAG_MAC_ACCESS_REQ
);
1557 ret
= iwl_finish_nic_init(trans
, trans
->trans_cfg
);
1562 * Reconfigure IVAR table in case of MSIX or reset ict table in
1563 * MSI mode since HW reset erased it.
1564 * Also enables interrupts - none will happen as
1565 * the device doesn't know we're waking it up, only when
1566 * the opmode actually tells it after this call.
1568 iwl_pcie_conf_msix_hw(trans_pcie
);
1569 if (!trans_pcie
->msix_enabled
)
1570 iwl_pcie_reset_ict(trans
);
1571 iwl_enable_interrupts(trans
);
1573 iwl_pcie_set_pwr(trans
, false);
1576 iwl_clear_bit(trans
, CSR_GP_CNTRL
,
1577 CSR_GP_CNTRL_REG_FLAG_MAC_ACCESS_REQ
);
1579 iwl_trans_pcie_tx_reset(trans
);
1581 ret
= iwl_pcie_rx_init(trans
);
1584 "Failed to resume the device (RX reset)\n");
1589 IWL_DEBUG_POWER(trans
, "WFPM value upon resume = 0x%08X\n",
1590 iwl_read_umac_prph(trans
, WFPM_GP2
));
1592 val
= iwl_read32(trans
, CSR_RESET
);
1593 if (val
& CSR_RESET_REG_FLAG_NEVO_RESET
)
1594 *status
= IWL_D3_STATUS_RESET
;
1596 *status
= IWL_D3_STATUS_ALIVE
;
1599 if (*status
== IWL_D3_STATUS_ALIVE
&&
1600 trans
->trans_cfg
->device_family
>= IWL_DEVICE_FAMILY_AX210
) {
1601 trans_pcie
->sx_complete
= false;
1602 iwl_write_umac_prph(trans
, UREG_DOORBELL_TO_ISR6
,
1603 UREG_DOORBELL_TO_ISR6_RESUME
);
1605 ret
= wait_event_timeout(trans_pcie
->sx_waitq
,
1606 trans_pcie
->sx_complete
, 2 * HZ
);
1608 * Invalidate it toward next suspend.
1610 trans_pcie
->sx_complete
= false;
1613 IWL_ERR(trans
, "Timeout exiting D3\n");
1621 iwl_pcie_set_interrupt_capa(struct pci_dev
*pdev
,
1622 struct iwl_trans
*trans
,
1623 const struct iwl_cfg_trans_params
*cfg_trans
)
1625 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
1626 int max_irqs
, num_irqs
, i
, ret
;
1629 if (!cfg_trans
->mq_rx_supported
)
1632 max_irqs
= min_t(u32
, num_online_cpus() + 2, IWL_MAX_RX_HW_QUEUES
);
1633 for (i
= 0; i
< max_irqs
; i
++)
1634 trans_pcie
->msix_entries
[i
].entry
= i
;
1636 num_irqs
= pci_enable_msix_range(pdev
, trans_pcie
->msix_entries
,
1637 MSIX_MIN_INTERRUPT_VECTORS
,
1640 IWL_DEBUG_INFO(trans
,
1641 "Failed to enable msi-x mode (ret %d). Moving to msi mode.\n",
1645 trans_pcie
->def_irq
= (num_irqs
== max_irqs
) ? num_irqs
- 1 : 0;
1647 IWL_DEBUG_INFO(trans
,
1648 "MSI-X enabled. %d interrupt vectors were allocated\n",
1652 * In case the OS provides fewer interrupts than requested, different
1653 * causes will share the same interrupt vector as follows:
1654 * One interrupt less: non rx causes shared with FBQ.
1655 * Two interrupts less: non rx causes shared with FBQ and RSS.
1656 * More than two interrupts: we will use fewer RSS queues.
1658 if (num_irqs
<= max_irqs
- 2) {
1659 trans_pcie
->trans
->num_rx_queues
= num_irqs
+ 1;
1660 trans_pcie
->shared_vec_mask
= IWL_SHARED_IRQ_NON_RX
|
1661 IWL_SHARED_IRQ_FIRST_RSS
;
1662 } else if (num_irqs
== max_irqs
- 1) {
1663 trans_pcie
->trans
->num_rx_queues
= num_irqs
;
1664 trans_pcie
->shared_vec_mask
= IWL_SHARED_IRQ_NON_RX
;
1666 trans_pcie
->trans
->num_rx_queues
= num_irqs
- 1;
1668 WARN_ON(trans_pcie
->trans
->num_rx_queues
> IWL_MAX_RX_HW_QUEUES
);
1670 trans_pcie
->alloc_vecs
= num_irqs
;
1671 trans_pcie
->msix_enabled
= true;
1675 ret
= pci_enable_msi(pdev
);
1677 dev_err(&pdev
->dev
, "pci_enable_msi failed - %d\n", ret
);
1678 /* enable rfkill interrupt: hw bug w/a */
1679 pci_read_config_word(pdev
, PCI_COMMAND
, &pci_cmd
);
1680 if (pci_cmd
& PCI_COMMAND_INTX_DISABLE
) {
1681 pci_cmd
&= ~PCI_COMMAND_INTX_DISABLE
;
1682 pci_write_config_word(pdev
, PCI_COMMAND
, pci_cmd
);
1687 static void iwl_pcie_irq_set_affinity(struct iwl_trans
*trans
)
1689 int iter_rx_q
, i
, ret
, cpu
, offset
;
1690 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
1692 i
= trans_pcie
->shared_vec_mask
& IWL_SHARED_IRQ_FIRST_RSS
? 0 : 1;
1693 iter_rx_q
= trans_pcie
->trans
->num_rx_queues
- 1 + i
;
1695 for (; i
< iter_rx_q
; i
++) {
1697 * Get the cpu prior to the place to search
1698 * (i.e. return will be > i - 1).
1700 cpu
= cpumask_next(i
- offset
, cpu_online_mask
);
1701 cpumask_set_cpu(cpu
, &trans_pcie
->affinity_mask
[i
]);
1702 ret
= irq_set_affinity_hint(trans_pcie
->msix_entries
[i
].vector
,
1703 &trans_pcie
->affinity_mask
[i
]);
1705 IWL_ERR(trans_pcie
->trans
,
1706 "Failed to set affinity mask for IRQ %d\n",
1711 static int iwl_pcie_init_msix_handler(struct pci_dev
*pdev
,
1712 struct iwl_trans_pcie
*trans_pcie
)
1716 for (i
= 0; i
< trans_pcie
->alloc_vecs
; i
++) {
1718 struct msix_entry
*msix_entry
;
1719 const char *qname
= queue_name(&pdev
->dev
, trans_pcie
, i
);
1724 msix_entry
= &trans_pcie
->msix_entries
[i
];
1725 ret
= devm_request_threaded_irq(&pdev
->dev
,
1728 (i
== trans_pcie
->def_irq
) ?
1729 iwl_pcie_irq_msix_handler
:
1730 iwl_pcie_irq_rx_msix_handler
,
1735 IWL_ERR(trans_pcie
->trans
,
1736 "Error allocating IRQ %d\n", i
);
1741 iwl_pcie_irq_set_affinity(trans_pcie
->trans
);
1746 static int iwl_trans_pcie_clear_persistence_bit(struct iwl_trans
*trans
)
1750 switch (trans
->trans_cfg
->device_family
) {
1751 case IWL_DEVICE_FAMILY_9000
:
1752 wprot
= PREG_PRPH_WPROT_9000
;
1754 case IWL_DEVICE_FAMILY_22000
:
1755 wprot
= PREG_PRPH_WPROT_22000
;
1761 hpm
= iwl_read_umac_prph_no_grab(trans
, HPM_DEBUG
);
1762 if (hpm
!= 0xa5a5a5a0 && (hpm
& PERSISTENCE_BIT
)) {
1763 u32 wprot_val
= iwl_read_umac_prph_no_grab(trans
, wprot
);
1765 if (wprot_val
& PREG_WFPM_ACCESS
) {
1767 "Error, can not clear persistence bit\n");
1770 iwl_write_umac_prph_no_grab(trans
, HPM_DEBUG
,
1771 hpm
& ~PERSISTENCE_BIT
);
1777 static int iwl_pcie_gen2_force_power_gating(struct iwl_trans
*trans
)
1781 ret
= iwl_finish_nic_init(trans
, trans
->trans_cfg
);
1785 iwl_set_bits_prph(trans
, HPM_HIPM_GEN_CFG
,
1786 HPM_HIPM_GEN_CFG_CR_FORCE_ACTIVE
);
1788 iwl_set_bits_prph(trans
, HPM_HIPM_GEN_CFG
,
1789 HPM_HIPM_GEN_CFG_CR_PG_EN
|
1790 HPM_HIPM_GEN_CFG_CR_SLP_EN
);
1792 iwl_clear_bits_prph(trans
, HPM_HIPM_GEN_CFG
,
1793 HPM_HIPM_GEN_CFG_CR_FORCE_ACTIVE
);
1795 iwl_trans_pcie_sw_reset(trans
);
1800 static int _iwl_trans_pcie_start_hw(struct iwl_trans
*trans
)
1802 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
1805 lockdep_assert_held(&trans_pcie
->mutex
);
1807 err
= iwl_pcie_prepare_card_hw(trans
);
1809 IWL_ERR(trans
, "Error while preparing HW: %d\n", err
);
1813 err
= iwl_trans_pcie_clear_persistence_bit(trans
);
1817 iwl_trans_pcie_sw_reset(trans
);
1819 if (trans
->trans_cfg
->device_family
== IWL_DEVICE_FAMILY_22000
&&
1820 trans
->cfg
->integrated
) {
1821 err
= iwl_pcie_gen2_force_power_gating(trans
);
1826 err
= iwl_pcie_apm_init(trans
);
1830 iwl_pcie_init_msix(trans_pcie
);
1832 /* From now on, the op_mode will be kept updated about RF kill state */
1833 iwl_enable_rfkill_int(trans
);
1835 trans_pcie
->opmode_down
= false;
1837 /* Set is_down to false here so that...*/
1838 trans_pcie
->is_down
= false;
1840 /* ...rfkill can call stop_device and set it false if needed */
1841 iwl_pcie_check_hw_rf_kill(trans
);
1846 static int iwl_trans_pcie_start_hw(struct iwl_trans
*trans
)
1848 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
1851 mutex_lock(&trans_pcie
->mutex
);
1852 ret
= _iwl_trans_pcie_start_hw(trans
);
1853 mutex_unlock(&trans_pcie
->mutex
);
1858 static void iwl_trans_pcie_op_mode_leave(struct iwl_trans
*trans
)
1860 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
1862 mutex_lock(&trans_pcie
->mutex
);
1864 /* disable interrupts - don't enable HW RF kill interrupt */
1865 iwl_disable_interrupts(trans
);
1867 iwl_pcie_apm_stop(trans
, true);
1869 iwl_disable_interrupts(trans
);
1871 iwl_pcie_disable_ict(trans
);
1873 mutex_unlock(&trans_pcie
->mutex
);
1875 iwl_pcie_synchronize_irqs(trans
);
1878 static void iwl_trans_pcie_write8(struct iwl_trans
*trans
, u32 ofs
, u8 val
)
1880 writeb(val
, IWL_TRANS_GET_PCIE_TRANS(trans
)->hw_base
+ ofs
);
1883 static void iwl_trans_pcie_write32(struct iwl_trans
*trans
, u32 ofs
, u32 val
)
1885 writel(val
, IWL_TRANS_GET_PCIE_TRANS(trans
)->hw_base
+ ofs
);
1888 static u32
iwl_trans_pcie_read32(struct iwl_trans
*trans
, u32 ofs
)
1890 return readl(IWL_TRANS_GET_PCIE_TRANS(trans
)->hw_base
+ ofs
);
1893 static u32
iwl_trans_pcie_prph_msk(struct iwl_trans
*trans
)
1895 if (trans
->trans_cfg
->device_family
>= IWL_DEVICE_FAMILY_AX210
)
1901 static u32
iwl_trans_pcie_read_prph(struct iwl_trans
*trans
, u32 reg
)
1903 u32 mask
= iwl_trans_pcie_prph_msk(trans
);
1905 iwl_trans_pcie_write32(trans
, HBUS_TARG_PRPH_RADDR
,
1906 ((reg
& mask
) | (3 << 24)));
1907 return iwl_trans_pcie_read32(trans
, HBUS_TARG_PRPH_RDAT
);
1910 static void iwl_trans_pcie_write_prph(struct iwl_trans
*trans
, u32 addr
,
1913 u32 mask
= iwl_trans_pcie_prph_msk(trans
);
1915 iwl_trans_pcie_write32(trans
, HBUS_TARG_PRPH_WADDR
,
1916 ((addr
& mask
) | (3 << 24)));
1917 iwl_trans_pcie_write32(trans
, HBUS_TARG_PRPH_WDAT
, val
);
1920 static void iwl_trans_pcie_configure(struct iwl_trans
*trans
,
1921 const struct iwl_trans_config
*trans_cfg
)
1923 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
1925 trans_pcie
->cmd_queue
= trans_cfg
->cmd_queue
;
1926 trans_pcie
->cmd_fifo
= trans_cfg
->cmd_fifo
;
1927 trans_pcie
->cmd_q_wdg_timeout
= trans_cfg
->cmd_q_wdg_timeout
;
1928 if (WARN_ON(trans_cfg
->n_no_reclaim_cmds
> MAX_NO_RECLAIM_CMDS
))
1929 trans_pcie
->n_no_reclaim_cmds
= 0;
1931 trans_pcie
->n_no_reclaim_cmds
= trans_cfg
->n_no_reclaim_cmds
;
1932 if (trans_pcie
->n_no_reclaim_cmds
)
1933 memcpy(trans_pcie
->no_reclaim_cmds
, trans_cfg
->no_reclaim_cmds
,
1934 trans_pcie
->n_no_reclaim_cmds
* sizeof(u8
));
1936 trans_pcie
->rx_buf_size
= trans_cfg
->rx_buf_size
;
1937 trans_pcie
->rx_page_order
=
1938 iwl_trans_get_rb_size_order(trans_pcie
->rx_buf_size
);
1939 trans_pcie
->rx_buf_bytes
=
1940 iwl_trans_get_rb_size(trans_pcie
->rx_buf_size
);
1941 trans_pcie
->supported_dma_mask
= DMA_BIT_MASK(12);
1942 if (trans
->trans_cfg
->device_family
>= IWL_DEVICE_FAMILY_AX210
)
1943 trans_pcie
->supported_dma_mask
= DMA_BIT_MASK(11);
1945 trans_pcie
->bc_table_dword
= trans_cfg
->bc_table_dword
;
1946 trans_pcie
->scd_set_active
= trans_cfg
->scd_set_active
;
1947 trans_pcie
->sw_csum_tx
= trans_cfg
->sw_csum_tx
;
1949 trans_pcie
->page_offs
= trans_cfg
->cb_data_offs
;
1950 trans_pcie
->dev_cmd_offs
= trans_cfg
->cb_data_offs
+ sizeof(void *);
1952 trans
->command_groups
= trans_cfg
->command_groups
;
1953 trans
->command_groups_size
= trans_cfg
->command_groups_size
;
1955 /* Initialize NAPI here - it should be before registering to mac80211
1956 * in the opmode but after the HW struct is allocated.
1957 * As this function may be called again in some corner cases don't
1958 * do anything if NAPI was already initialized.
1960 if (trans_pcie
->napi_dev
.reg_state
!= NETREG_DUMMY
)
1961 init_dummy_netdev(&trans_pcie
->napi_dev
);
1964 void iwl_trans_pcie_free(struct iwl_trans
*trans
)
1966 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
1969 iwl_pcie_synchronize_irqs(trans
);
1971 if (trans
->trans_cfg
->gen2
)
1972 iwl_pcie_gen2_tx_free(trans
);
1974 iwl_pcie_tx_free(trans
);
1975 iwl_pcie_rx_free(trans
);
1977 if (trans_pcie
->rba
.alloc_wq
) {
1978 destroy_workqueue(trans_pcie
->rba
.alloc_wq
);
1979 trans_pcie
->rba
.alloc_wq
= NULL
;
1982 if (trans_pcie
->msix_enabled
) {
1983 for (i
= 0; i
< trans_pcie
->alloc_vecs
; i
++) {
1984 irq_set_affinity_hint(
1985 trans_pcie
->msix_entries
[i
].vector
,
1989 trans_pcie
->msix_enabled
= false;
1991 iwl_pcie_free_ict(trans
);
1994 iwl_pcie_free_fw_monitor(trans
);
1996 for_each_possible_cpu(i
) {
1997 struct iwl_tso_hdr_page
*p
=
1998 per_cpu_ptr(trans_pcie
->tso_hdr_page
, i
);
2001 __free_page(p
->page
);
2004 free_percpu(trans_pcie
->tso_hdr_page
);
2005 mutex_destroy(&trans_pcie
->mutex
);
2006 iwl_trans_free(trans
);
2009 static void iwl_trans_pcie_set_pmi(struct iwl_trans
*trans
, bool state
)
2012 set_bit(STATUS_TPOWER_PMI
, &trans
->status
);
2014 clear_bit(STATUS_TPOWER_PMI
, &trans
->status
);
2017 struct iwl_trans_pcie_removal
{
2018 struct pci_dev
*pdev
;
2019 struct work_struct work
;
2022 static void iwl_trans_pcie_removal_wk(struct work_struct
*wk
)
2024 struct iwl_trans_pcie_removal
*removal
=
2025 container_of(wk
, struct iwl_trans_pcie_removal
, work
);
2026 struct pci_dev
*pdev
= removal
->pdev
;
2027 static char *prop
[] = {"EVENT=INACCESSIBLE", NULL
};
2029 dev_err(&pdev
->dev
, "Device gone - attempting removal\n");
2030 kobject_uevent_env(&pdev
->dev
.kobj
, KOBJ_CHANGE
, prop
);
2031 pci_lock_rescan_remove();
2033 pci_stop_and_remove_bus_device(pdev
);
2034 pci_unlock_rescan_remove();
2037 module_put(THIS_MODULE
);
2040 static bool iwl_trans_pcie_grab_nic_access(struct iwl_trans
*trans
,
2041 unsigned long *flags
)
2044 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2046 spin_lock_irqsave(&trans_pcie
->reg_lock
, *flags
);
2048 if (trans_pcie
->cmd_hold_nic_awake
)
2051 /* this bit wakes up the NIC */
2052 __iwl_trans_pcie_set_bit(trans
, CSR_GP_CNTRL
,
2053 CSR_GP_CNTRL_REG_FLAG_MAC_ACCESS_REQ
);
2054 if (trans
->trans_cfg
->device_family
>= IWL_DEVICE_FAMILY_8000
)
2058 * These bits say the device is running, and should keep running for
2059 * at least a short while (at least as long as MAC_ACCESS_REQ stays 1),
2060 * but they do not indicate that embedded SRAM is restored yet;
2061 * HW with volatile SRAM must save/restore contents to/from
2062 * host DRAM when sleeping/waking for power-saving.
2063 * Each direction takes approximately 1/4 millisecond; with this
2064 * overhead, it's a good idea to grab and hold MAC_ACCESS_REQUEST if a
2065 * series of register accesses are expected (e.g. reading Event Log),
2066 * to keep device from sleeping.
2068 * CSR_UCODE_DRV_GP1 register bit MAC_SLEEP == 0 indicates that
2069 * SRAM is okay/restored. We don't check that here because this call
2070 * is just for hardware register access; but GP1 MAC_SLEEP
2071 * check is a good idea before accessing the SRAM of HW with
2072 * volatile SRAM (e.g. reading Event Log).
2074 * 5000 series and later (including 1000 series) have non-volatile SRAM,
2075 * and do not save/restore SRAM when power cycling.
2077 ret
= iwl_poll_bit(trans
, CSR_GP_CNTRL
,
2078 CSR_GP_CNTRL_REG_VAL_MAC_ACCESS_EN
,
2079 (CSR_GP_CNTRL_REG_FLAG_MAC_CLOCK_READY
|
2080 CSR_GP_CNTRL_REG_FLAG_GOING_TO_SLEEP
), 15000);
2081 if (unlikely(ret
< 0)) {
2082 u32 cntrl
= iwl_read32(trans
, CSR_GP_CNTRL
);
2085 "Timeout waiting for hardware access (CSR_GP_CNTRL 0x%08x)\n",
2088 iwl_trans_pcie_dump_regs(trans
);
2090 if (iwlwifi_mod_params
.remove_when_gone
&& cntrl
== ~0U) {
2091 struct iwl_trans_pcie_removal
*removal
;
2093 if (test_bit(STATUS_TRANS_DEAD
, &trans
->status
))
2096 IWL_ERR(trans
, "Device gone - scheduling removal!\n");
2099 * get a module reference to avoid doing this
2100 * while unloading anyway and to avoid
2101 * scheduling a work with code that's being
2104 if (!try_module_get(THIS_MODULE
)) {
2106 "Module is being unloaded - abort\n");
2110 removal
= kzalloc(sizeof(*removal
), GFP_ATOMIC
);
2112 module_put(THIS_MODULE
);
2116 * we don't need to clear this flag, because
2117 * the trans will be freed and reallocated.
2119 set_bit(STATUS_TRANS_DEAD
, &trans
->status
);
2121 removal
->pdev
= to_pci_dev(trans
->dev
);
2122 INIT_WORK(&removal
->work
, iwl_trans_pcie_removal_wk
);
2123 pci_dev_get(removal
->pdev
);
2124 schedule_work(&removal
->work
);
2126 iwl_write32(trans
, CSR_RESET
,
2127 CSR_RESET_REG_FLAG_FORCE_NMI
);
2131 spin_unlock_irqrestore(&trans_pcie
->reg_lock
, *flags
);
2137 * Fool sparse by faking we release the lock - sparse will
2138 * track nic_access anyway.
2140 __release(&trans_pcie
->reg_lock
);
2144 static void iwl_trans_pcie_release_nic_access(struct iwl_trans
*trans
,
2145 unsigned long *flags
)
2147 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2149 lockdep_assert_held(&trans_pcie
->reg_lock
);
2152 * Fool sparse by faking we acquiring the lock - sparse will
2153 * track nic_access anyway.
2155 __acquire(&trans_pcie
->reg_lock
);
2157 if (trans_pcie
->cmd_hold_nic_awake
)
2160 __iwl_trans_pcie_clear_bit(trans
, CSR_GP_CNTRL
,
2161 CSR_GP_CNTRL_REG_FLAG_MAC_ACCESS_REQ
);
2163 * Above we read the CSR_GP_CNTRL register, which will flush
2164 * any previous writes, but we need the write that clears the
2165 * MAC_ACCESS_REQ bit to be performed before any other writes
2166 * scheduled on different CPUs (after we drop reg_lock).
2169 spin_unlock_irqrestore(&trans_pcie
->reg_lock
, *flags
);
2172 static int iwl_trans_pcie_read_mem(struct iwl_trans
*trans
, u32 addr
,
2173 void *buf
, int dwords
)
2175 unsigned long flags
;
2179 if (iwl_trans_grab_nic_access(trans
, &flags
)) {
2180 iwl_write32(trans
, HBUS_TARG_MEM_RADDR
, addr
);
2181 for (offs
= 0; offs
< dwords
; offs
++)
2182 vals
[offs
] = iwl_read32(trans
, HBUS_TARG_MEM_RDAT
);
2183 iwl_trans_release_nic_access(trans
, &flags
);
2190 static int iwl_trans_pcie_write_mem(struct iwl_trans
*trans
, u32 addr
,
2191 const void *buf
, int dwords
)
2193 unsigned long flags
;
2195 const u32
*vals
= buf
;
2197 if (iwl_trans_grab_nic_access(trans
, &flags
)) {
2198 iwl_write32(trans
, HBUS_TARG_MEM_WADDR
, addr
);
2199 for (offs
= 0; offs
< dwords
; offs
++)
2200 iwl_write32(trans
, HBUS_TARG_MEM_WDAT
,
2201 vals
? vals
[offs
] : 0);
2202 iwl_trans_release_nic_access(trans
, &flags
);
2209 static void iwl_trans_pcie_freeze_txq_timer(struct iwl_trans
*trans
,
2213 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2216 for_each_set_bit(queue
, &txqs
, BITS_PER_LONG
) {
2217 struct iwl_txq
*txq
= trans_pcie
->txq
[queue
];
2220 spin_lock_bh(&txq
->lock
);
2224 if (txq
->frozen
== freeze
)
2227 IWL_DEBUG_TX_QUEUES(trans
, "%s TXQ %d\n",
2228 freeze
? "Freezing" : "Waking", queue
);
2230 txq
->frozen
= freeze
;
2232 if (txq
->read_ptr
== txq
->write_ptr
)
2236 if (unlikely(time_after(now
,
2237 txq
->stuck_timer
.expires
))) {
2239 * The timer should have fired, maybe it is
2240 * spinning right now on the lock.
2244 /* remember how long until the timer fires */
2245 txq
->frozen_expiry_remainder
=
2246 txq
->stuck_timer
.expires
- now
;
2247 del_timer(&txq
->stuck_timer
);
2252 * Wake a non-empty queue -> arm timer with the
2253 * remainder before it froze
2255 mod_timer(&txq
->stuck_timer
,
2256 now
+ txq
->frozen_expiry_remainder
);
2259 spin_unlock_bh(&txq
->lock
);
2263 static void iwl_trans_pcie_block_txq_ptrs(struct iwl_trans
*trans
, bool block
)
2265 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2268 for (i
= 0; i
< trans
->trans_cfg
->base_params
->num_of_queues
; i
++) {
2269 struct iwl_txq
*txq
= trans_pcie
->txq
[i
];
2271 if (i
== trans_pcie
->cmd_queue
)
2274 spin_lock_bh(&txq
->lock
);
2276 if (!block
&& !(WARN_ON_ONCE(!txq
->block
))) {
2279 iwl_write32(trans
, HBUS_TARG_WRPTR
,
2280 txq
->write_ptr
| (i
<< 8));
2286 spin_unlock_bh(&txq
->lock
);
2290 #define IWL_FLUSH_WAIT_MS 2000
2292 void iwl_trans_pcie_log_scd_error(struct iwl_trans
*trans
, struct iwl_txq
*txq
)
2294 u32 txq_id
= txq
->id
;
2299 if (trans
->trans_cfg
->use_tfh
) {
2300 IWL_ERR(trans
, "Queue %d is stuck %d %d\n", txq_id
,
2301 txq
->read_ptr
, txq
->write_ptr
);
2302 /* TODO: access new SCD registers and dump them */
2306 status
= iwl_read_prph(trans
, SCD_QUEUE_STATUS_BITS(txq_id
));
2307 fifo
= (status
>> SCD_QUEUE_STTS_REG_POS_TXF
) & 0x7;
2308 active
= !!(status
& BIT(SCD_QUEUE_STTS_REG_POS_ACTIVE
));
2311 "Queue %d is %sactive on fifo %d and stuck for %u ms. SW [%d, %d] HW [%d, %d] FH TRB=0x0%x\n",
2312 txq_id
, active
? "" : "in", fifo
,
2313 jiffies_to_msecs(txq
->wd_timeout
),
2314 txq
->read_ptr
, txq
->write_ptr
,
2315 iwl_read_prph(trans
, SCD_QUEUE_RDPTR(txq_id
)) &
2316 (trans
->trans_cfg
->base_params
->max_tfd_queue_size
- 1),
2317 iwl_read_prph(trans
, SCD_QUEUE_WRPTR(txq_id
)) &
2318 (trans
->trans_cfg
->base_params
->max_tfd_queue_size
- 1),
2319 iwl_read_direct32(trans
, FH_TX_TRB_REG(fifo
)));
2322 static int iwl_trans_pcie_rxq_dma_data(struct iwl_trans
*trans
, int queue
,
2323 struct iwl_trans_rxq_dma_data
*data
)
2325 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2327 if (queue
>= trans
->num_rx_queues
|| !trans_pcie
->rxq
)
2330 data
->fr_bd_cb
= trans_pcie
->rxq
[queue
].bd_dma
;
2331 data
->urbd_stts_wrptr
= trans_pcie
->rxq
[queue
].rb_stts_dma
;
2332 data
->ur_bd_cb
= trans_pcie
->rxq
[queue
].used_bd_dma
;
2333 data
->fr_bd_wid
= 0;
2338 static int iwl_trans_pcie_wait_txq_empty(struct iwl_trans
*trans
, int txq_idx
)
2340 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2341 struct iwl_txq
*txq
;
2342 unsigned long now
= jiffies
;
2346 /* Make sure the NIC is still alive in the bus */
2347 if (test_bit(STATUS_TRANS_DEAD
, &trans
->status
))
2350 if (!test_bit(txq_idx
, trans_pcie
->queue_used
))
2353 IWL_DEBUG_TX_QUEUES(trans
, "Emptying queue %d...\n", txq_idx
);
2354 txq
= trans_pcie
->txq
[txq_idx
];
2356 spin_lock_bh(&txq
->lock
);
2357 overflow_tx
= txq
->overflow_tx
||
2358 !skb_queue_empty(&txq
->overflow_q
);
2359 spin_unlock_bh(&txq
->lock
);
2361 wr_ptr
= READ_ONCE(txq
->write_ptr
);
2363 while ((txq
->read_ptr
!= READ_ONCE(txq
->write_ptr
) ||
2365 !time_after(jiffies
,
2366 now
+ msecs_to_jiffies(IWL_FLUSH_WAIT_MS
))) {
2367 u8 write_ptr
= READ_ONCE(txq
->write_ptr
);
2370 * If write pointer moved during the wait, warn only
2371 * if the TX came from op mode. In case TX came from
2372 * trans layer (overflow TX) don't warn.
2374 if (WARN_ONCE(wr_ptr
!= write_ptr
&& !overflow_tx
,
2375 "WR pointer moved while flushing %d -> %d\n",
2380 usleep_range(1000, 2000);
2382 spin_lock_bh(&txq
->lock
);
2383 overflow_tx
= txq
->overflow_tx
||
2384 !skb_queue_empty(&txq
->overflow_q
);
2385 spin_unlock_bh(&txq
->lock
);
2388 if (txq
->read_ptr
!= txq
->write_ptr
) {
2390 "fail to flush all tx fifo queues Q %d\n", txq_idx
);
2391 iwl_trans_pcie_log_scd_error(trans
, txq
);
2395 IWL_DEBUG_TX_QUEUES(trans
, "Queue %d is now empty.\n", txq_idx
);
2400 static int iwl_trans_pcie_wait_txqs_empty(struct iwl_trans
*trans
, u32 txq_bm
)
2402 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2406 /* waiting for all the tx frames complete might take a while */
2408 cnt
< trans
->trans_cfg
->base_params
->num_of_queues
;
2411 if (cnt
== trans_pcie
->cmd_queue
)
2413 if (!test_bit(cnt
, trans_pcie
->queue_used
))
2415 if (!(BIT(cnt
) & txq_bm
))
2418 ret
= iwl_trans_pcie_wait_txq_empty(trans
, cnt
);
2426 static void iwl_trans_pcie_set_bits_mask(struct iwl_trans
*trans
, u32 reg
,
2427 u32 mask
, u32 value
)
2429 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2430 unsigned long flags
;
2432 spin_lock_irqsave(&trans_pcie
->reg_lock
, flags
);
2433 __iwl_trans_pcie_set_bits_mask(trans
, reg
, mask
, value
);
2434 spin_unlock_irqrestore(&trans_pcie
->reg_lock
, flags
);
2437 static const char *get_csr_string(int cmd
)
2439 #define IWL_CMD(x) case x: return #x
2441 IWL_CMD(CSR_HW_IF_CONFIG_REG
);
2442 IWL_CMD(CSR_INT_COALESCING
);
2444 IWL_CMD(CSR_INT_MASK
);
2445 IWL_CMD(CSR_FH_INT_STATUS
);
2446 IWL_CMD(CSR_GPIO_IN
);
2448 IWL_CMD(CSR_GP_CNTRL
);
2449 IWL_CMD(CSR_HW_REV
);
2450 IWL_CMD(CSR_EEPROM_REG
);
2451 IWL_CMD(CSR_EEPROM_GP
);
2452 IWL_CMD(CSR_OTP_GP_REG
);
2453 IWL_CMD(CSR_GIO_REG
);
2454 IWL_CMD(CSR_GP_UCODE_REG
);
2455 IWL_CMD(CSR_GP_DRIVER_REG
);
2456 IWL_CMD(CSR_UCODE_DRV_GP1
);
2457 IWL_CMD(CSR_UCODE_DRV_GP2
);
2458 IWL_CMD(CSR_LED_REG
);
2459 IWL_CMD(CSR_DRAM_INT_TBL_REG
);
2460 IWL_CMD(CSR_GIO_CHICKEN_BITS
);
2461 IWL_CMD(CSR_ANA_PLL_CFG
);
2462 IWL_CMD(CSR_HW_REV_WA_REG
);
2463 IWL_CMD(CSR_MONITOR_STATUS_REG
);
2464 IWL_CMD(CSR_DBG_HPET_MEM_REG
);
2471 void iwl_pcie_dump_csr(struct iwl_trans
*trans
)
2474 static const u32 csr_tbl
[] = {
2475 CSR_HW_IF_CONFIG_REG
,
2493 CSR_DRAM_INT_TBL_REG
,
2494 CSR_GIO_CHICKEN_BITS
,
2496 CSR_MONITOR_STATUS_REG
,
2498 CSR_DBG_HPET_MEM_REG
2500 IWL_ERR(trans
, "CSR values:\n");
2501 IWL_ERR(trans
, "(2nd byte of CSR_INT_COALESCING is "
2502 "CSR_INT_PERIODIC_REG)\n");
2503 for (i
= 0; i
< ARRAY_SIZE(csr_tbl
); i
++) {
2504 IWL_ERR(trans
, " %25s: 0X%08x\n",
2505 get_csr_string(csr_tbl
[i
]),
2506 iwl_read32(trans
, csr_tbl
[i
]));
2510 #ifdef CONFIG_IWLWIFI_DEBUGFS
2511 /* create and remove of files */
2512 #define DEBUGFS_ADD_FILE(name, parent, mode) do { \
2513 debugfs_create_file(#name, mode, parent, trans, \
2514 &iwl_dbgfs_##name##_ops); \
2517 /* file operation */
2518 #define DEBUGFS_READ_FILE_OPS(name) \
2519 static const struct file_operations iwl_dbgfs_##name##_ops = { \
2520 .read = iwl_dbgfs_##name##_read, \
2521 .open = simple_open, \
2522 .llseek = generic_file_llseek, \
2525 #define DEBUGFS_WRITE_FILE_OPS(name) \
2526 static const struct file_operations iwl_dbgfs_##name##_ops = { \
2527 .write = iwl_dbgfs_##name##_write, \
2528 .open = simple_open, \
2529 .llseek = generic_file_llseek, \
2532 #define DEBUGFS_READ_WRITE_FILE_OPS(name) \
2533 static const struct file_operations iwl_dbgfs_##name##_ops = { \
2534 .write = iwl_dbgfs_##name##_write, \
2535 .read = iwl_dbgfs_##name##_read, \
2536 .open = simple_open, \
2537 .llseek = generic_file_llseek, \
2540 static ssize_t
iwl_dbgfs_tx_queue_read(struct file
*file
,
2541 char __user
*user_buf
,
2542 size_t count
, loff_t
*ppos
)
2544 struct iwl_trans
*trans
= file
->private_data
;
2545 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2546 struct iwl_txq
*txq
;
2553 bufsz
= sizeof(char) * 75 *
2554 trans
->trans_cfg
->base_params
->num_of_queues
;
2556 if (!trans_pcie
->txq_memory
)
2559 buf
= kzalloc(bufsz
, GFP_KERNEL
);
2564 cnt
< trans
->trans_cfg
->base_params
->num_of_queues
;
2566 txq
= trans_pcie
->txq
[cnt
];
2567 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
,
2568 "hwq %.2d: read=%u write=%u use=%d stop=%d need_update=%d frozen=%d%s\n",
2569 cnt
, txq
->read_ptr
, txq
->write_ptr
,
2570 !!test_bit(cnt
, trans_pcie
->queue_used
),
2571 !!test_bit(cnt
, trans_pcie
->queue_stopped
),
2572 txq
->need_update
, txq
->frozen
,
2573 (cnt
== trans_pcie
->cmd_queue
? " HCMD" : ""));
2575 ret
= simple_read_from_buffer(user_buf
, count
, ppos
, buf
, pos
);
2580 static ssize_t
iwl_dbgfs_rx_queue_read(struct file
*file
,
2581 char __user
*user_buf
,
2582 size_t count
, loff_t
*ppos
)
2584 struct iwl_trans
*trans
= file
->private_data
;
2585 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2587 int pos
= 0, i
, ret
;
2590 bufsz
= sizeof(char) * 121 * trans
->num_rx_queues
;
2592 if (!trans_pcie
->rxq
)
2595 buf
= kzalloc(bufsz
, GFP_KERNEL
);
2599 for (i
= 0; i
< trans
->num_rx_queues
&& pos
< bufsz
; i
++) {
2600 struct iwl_rxq
*rxq
= &trans_pcie
->rxq
[i
];
2602 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
, "queue#: %2d\n",
2604 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
, "\tread: %u\n",
2606 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
, "\twrite: %u\n",
2608 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
, "\twrite_actual: %u\n",
2610 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
, "\tneed_update: %2d\n",
2612 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
, "\tfree_count: %u\n",
2615 u32 r
= __le16_to_cpu(iwl_get_closed_rb_stts(trans
,
2617 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
,
2618 "\tclosed_rb_num: %u\n",
2621 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
,
2622 "\tclosed_rb_num: Not Allocated\n");
2625 ret
= simple_read_from_buffer(user_buf
, count
, ppos
, buf
, pos
);
2631 static ssize_t
iwl_dbgfs_interrupt_read(struct file
*file
,
2632 char __user
*user_buf
,
2633 size_t count
, loff_t
*ppos
)
2635 struct iwl_trans
*trans
= file
->private_data
;
2636 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2637 struct isr_statistics
*isr_stats
= &trans_pcie
->isr_stats
;
2641 int bufsz
= 24 * 64; /* 24 items * 64 char per item */
2644 buf
= kzalloc(bufsz
, GFP_KERNEL
);
2648 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
,
2649 "Interrupt Statistics Report:\n");
2651 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
, "HW Error:\t\t\t %u\n",
2653 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
, "SW Error:\t\t\t %u\n",
2655 if (isr_stats
->sw
|| isr_stats
->hw
) {
2656 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
,
2657 "\tLast Restarting Code: 0x%X\n",
2658 isr_stats
->err_code
);
2660 #ifdef CONFIG_IWLWIFI_DEBUG
2661 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
, "Frame transmitted:\t\t %u\n",
2663 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
, "Alive interrupt:\t\t %u\n",
2666 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
,
2667 "HW RF KILL switch toggled:\t %u\n", isr_stats
->rfkill
);
2669 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
, "CT KILL:\t\t\t %u\n",
2672 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
, "Wakeup Interrupt:\t\t %u\n",
2675 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
,
2676 "Rx command responses:\t\t %u\n", isr_stats
->rx
);
2678 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
, "Tx/FH interrupt:\t\t %u\n",
2681 pos
+= scnprintf(buf
+ pos
, bufsz
- pos
, "Unexpected INTA:\t\t %u\n",
2682 isr_stats
->unhandled
);
2684 ret
= simple_read_from_buffer(user_buf
, count
, ppos
, buf
, pos
);
2689 static ssize_t
iwl_dbgfs_interrupt_write(struct file
*file
,
2690 const char __user
*user_buf
,
2691 size_t count
, loff_t
*ppos
)
2693 struct iwl_trans
*trans
= file
->private_data
;
2694 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2695 struct isr_statistics
*isr_stats
= &trans_pcie
->isr_stats
;
2699 ret
= kstrtou32_from_user(user_buf
, count
, 16, &reset_flag
);
2702 if (reset_flag
== 0)
2703 memset(isr_stats
, 0, sizeof(*isr_stats
));
2708 static ssize_t
iwl_dbgfs_csr_write(struct file
*file
,
2709 const char __user
*user_buf
,
2710 size_t count
, loff_t
*ppos
)
2712 struct iwl_trans
*trans
= file
->private_data
;
2714 iwl_pcie_dump_csr(trans
);
2719 static ssize_t
iwl_dbgfs_fh_reg_read(struct file
*file
,
2720 char __user
*user_buf
,
2721 size_t count
, loff_t
*ppos
)
2723 struct iwl_trans
*trans
= file
->private_data
;
2727 ret
= iwl_dump_fh(trans
, &buf
);
2732 ret
= simple_read_from_buffer(user_buf
, count
, ppos
, buf
, ret
);
2737 static ssize_t
iwl_dbgfs_rfkill_read(struct file
*file
,
2738 char __user
*user_buf
,
2739 size_t count
, loff_t
*ppos
)
2741 struct iwl_trans
*trans
= file
->private_data
;
2742 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2746 pos
= scnprintf(buf
, sizeof(buf
), "debug: %d\nhw: %d\n",
2747 trans_pcie
->debug_rfkill
,
2748 !(iwl_read32(trans
, CSR_GP_CNTRL
) &
2749 CSR_GP_CNTRL_REG_FLAG_HW_RF_KILL_SW
));
2751 return simple_read_from_buffer(user_buf
, count
, ppos
, buf
, pos
);
2754 static ssize_t
iwl_dbgfs_rfkill_write(struct file
*file
,
2755 const char __user
*user_buf
,
2756 size_t count
, loff_t
*ppos
)
2758 struct iwl_trans
*trans
= file
->private_data
;
2759 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2763 ret
= kstrtobool_from_user(user_buf
, count
, &new_value
);
2766 if (new_value
== trans_pcie
->debug_rfkill
)
2768 IWL_WARN(trans
, "changing debug rfkill %d->%d\n",
2769 trans_pcie
->debug_rfkill
, new_value
);
2770 trans_pcie
->debug_rfkill
= new_value
;
2771 iwl_pcie_handle_rfkill_irq(trans
);
2776 static int iwl_dbgfs_monitor_data_open(struct inode
*inode
,
2779 struct iwl_trans
*trans
= inode
->i_private
;
2780 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2782 if (!trans
->dbg
.dest_tlv
||
2783 trans
->dbg
.dest_tlv
->monitor_mode
!= EXTERNAL_MODE
) {
2784 IWL_ERR(trans
, "Debug destination is not set to DRAM\n");
2788 if (trans_pcie
->fw_mon_data
.state
!= IWL_FW_MON_DBGFS_STATE_CLOSED
)
2791 trans_pcie
->fw_mon_data
.state
= IWL_FW_MON_DBGFS_STATE_OPEN
;
2792 return simple_open(inode
, file
);
2795 static int iwl_dbgfs_monitor_data_release(struct inode
*inode
,
2798 struct iwl_trans_pcie
*trans_pcie
=
2799 IWL_TRANS_GET_PCIE_TRANS(inode
->i_private
);
2801 if (trans_pcie
->fw_mon_data
.state
== IWL_FW_MON_DBGFS_STATE_OPEN
)
2802 trans_pcie
->fw_mon_data
.state
= IWL_FW_MON_DBGFS_STATE_CLOSED
;
2806 static bool iwl_write_to_user_buf(char __user
*user_buf
, ssize_t count
,
2807 void *buf
, ssize_t
*size
,
2808 ssize_t
*bytes_copied
)
2810 int buf_size_left
= count
- *bytes_copied
;
2812 buf_size_left
= buf_size_left
- (buf_size_left
% sizeof(u32
));
2813 if (*size
> buf_size_left
)
2814 *size
= buf_size_left
;
2816 *size
-= copy_to_user(user_buf
, buf
, *size
);
2817 *bytes_copied
+= *size
;
2819 if (buf_size_left
== *size
)
2824 static ssize_t
iwl_dbgfs_monitor_data_read(struct file
*file
,
2825 char __user
*user_buf
,
2826 size_t count
, loff_t
*ppos
)
2828 struct iwl_trans
*trans
= file
->private_data
;
2829 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2830 void *cpu_addr
= (void *)trans
->dbg
.fw_mon
.block
, *curr_buf
;
2831 struct cont_rec
*data
= &trans_pcie
->fw_mon_data
;
2832 u32 write_ptr_addr
, wrap_cnt_addr
, write_ptr
, wrap_cnt
;
2833 ssize_t size
, bytes_copied
= 0;
2836 if (trans
->dbg
.dest_tlv
) {
2838 le32_to_cpu(trans
->dbg
.dest_tlv
->write_ptr_reg
);
2839 wrap_cnt_addr
= le32_to_cpu(trans
->dbg
.dest_tlv
->wrap_count
);
2841 write_ptr_addr
= MON_BUFF_WRPTR
;
2842 wrap_cnt_addr
= MON_BUFF_CYCLE_CNT
;
2845 if (unlikely(!trans
->dbg
.rec_on
))
2848 mutex_lock(&data
->mutex
);
2850 IWL_FW_MON_DBGFS_STATE_DISABLED
) {
2851 mutex_unlock(&data
->mutex
);
2855 /* write_ptr position in bytes rather then DW */
2856 write_ptr
= iwl_read_prph(trans
, write_ptr_addr
) * sizeof(u32
);
2857 wrap_cnt
= iwl_read_prph(trans
, wrap_cnt_addr
);
2859 if (data
->prev_wrap_cnt
== wrap_cnt
) {
2860 size
= write_ptr
- data
->prev_wr_ptr
;
2861 curr_buf
= cpu_addr
+ data
->prev_wr_ptr
;
2862 b_full
= iwl_write_to_user_buf(user_buf
, count
,
2865 data
->prev_wr_ptr
+= size
;
2867 } else if (data
->prev_wrap_cnt
== wrap_cnt
- 1 &&
2868 write_ptr
< data
->prev_wr_ptr
) {
2869 size
= trans
->dbg
.fw_mon
.size
- data
->prev_wr_ptr
;
2870 curr_buf
= cpu_addr
+ data
->prev_wr_ptr
;
2871 b_full
= iwl_write_to_user_buf(user_buf
, count
,
2874 data
->prev_wr_ptr
+= size
;
2878 b_full
= iwl_write_to_user_buf(user_buf
, count
,
2881 data
->prev_wr_ptr
= size
;
2882 data
->prev_wrap_cnt
++;
2885 if (data
->prev_wrap_cnt
== wrap_cnt
- 1 &&
2886 write_ptr
> data
->prev_wr_ptr
)
2888 "write pointer passed previous write pointer, start copying from the beginning\n");
2889 else if (!unlikely(data
->prev_wrap_cnt
== 0 &&
2890 data
->prev_wr_ptr
== 0))
2892 "monitor data is out of sync, start copying from the beginning\n");
2895 b_full
= iwl_write_to_user_buf(user_buf
, count
,
2898 data
->prev_wr_ptr
= size
;
2899 data
->prev_wrap_cnt
= wrap_cnt
;
2902 mutex_unlock(&data
->mutex
);
2904 return bytes_copied
;
2907 DEBUGFS_READ_WRITE_FILE_OPS(interrupt
);
2908 DEBUGFS_READ_FILE_OPS(fh_reg
);
2909 DEBUGFS_READ_FILE_OPS(rx_queue
);
2910 DEBUGFS_READ_FILE_OPS(tx_queue
);
2911 DEBUGFS_WRITE_FILE_OPS(csr
);
2912 DEBUGFS_READ_WRITE_FILE_OPS(rfkill
);
2914 static const struct file_operations iwl_dbgfs_monitor_data_ops
= {
2915 .read
= iwl_dbgfs_monitor_data_read
,
2916 .open
= iwl_dbgfs_monitor_data_open
,
2917 .release
= iwl_dbgfs_monitor_data_release
,
2920 /* Create the debugfs files and directories */
2921 void iwl_trans_pcie_dbgfs_register(struct iwl_trans
*trans
)
2923 struct dentry
*dir
= trans
->dbgfs_dir
;
2925 DEBUGFS_ADD_FILE(rx_queue
, dir
, 0400);
2926 DEBUGFS_ADD_FILE(tx_queue
, dir
, 0400);
2927 DEBUGFS_ADD_FILE(interrupt
, dir
, 0600);
2928 DEBUGFS_ADD_FILE(csr
, dir
, 0200);
2929 DEBUGFS_ADD_FILE(fh_reg
, dir
, 0400);
2930 DEBUGFS_ADD_FILE(rfkill
, dir
, 0600);
2931 DEBUGFS_ADD_FILE(monitor_data
, dir
, 0400);
2934 static void iwl_trans_pcie_debugfs_cleanup(struct iwl_trans
*trans
)
2936 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2937 struct cont_rec
*data
= &trans_pcie
->fw_mon_data
;
2939 mutex_lock(&data
->mutex
);
2940 data
->state
= IWL_FW_MON_DBGFS_STATE_DISABLED
;
2941 mutex_unlock(&data
->mutex
);
2943 #endif /*CONFIG_IWLWIFI_DEBUGFS */
2945 static u32
iwl_trans_pcie_get_cmdlen(struct iwl_trans
*trans
, void *tfd
)
2947 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2951 for (i
= 0; i
< trans_pcie
->max_tbs
; i
++)
2952 cmdlen
+= iwl_pcie_tfd_tb_get_len(trans
, tfd
, i
);
2957 static u32
iwl_trans_pcie_dump_rbs(struct iwl_trans
*trans
,
2958 struct iwl_fw_error_dump_data
**data
,
2959 int allocated_rb_nums
)
2961 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
2962 int max_len
= trans_pcie
->rx_buf_bytes
;
2963 /* Dump RBs is supported only for pre-9000 devices (1 queue) */
2964 struct iwl_rxq
*rxq
= &trans_pcie
->rxq
[0];
2965 u32 i
, r
, j
, rb_len
= 0;
2967 spin_lock(&rxq
->lock
);
2969 r
= le16_to_cpu(iwl_get_closed_rb_stts(trans
, rxq
)) & 0x0FFF;
2971 for (i
= rxq
->read
, j
= 0;
2972 i
!= r
&& j
< allocated_rb_nums
;
2973 i
= (i
+ 1) & RX_QUEUE_MASK
, j
++) {
2974 struct iwl_rx_mem_buffer
*rxb
= rxq
->queue
[i
];
2975 struct iwl_fw_error_dump_rb
*rb
;
2977 dma_unmap_page(trans
->dev
, rxb
->page_dma
, max_len
,
2980 rb_len
+= sizeof(**data
) + sizeof(*rb
) + max_len
;
2982 (*data
)->type
= cpu_to_le32(IWL_FW_ERROR_DUMP_RB
);
2983 (*data
)->len
= cpu_to_le32(sizeof(*rb
) + max_len
);
2984 rb
= (void *)(*data
)->data
;
2985 rb
->index
= cpu_to_le32(i
);
2986 memcpy(rb
->data
, page_address(rxb
->page
), max_len
);
2987 /* remap the page for the free benefit */
2988 rxb
->page_dma
= dma_map_page(trans
->dev
, rxb
->page
,
2989 rxb
->offset
, max_len
,
2992 *data
= iwl_fw_error_next_data(*data
);
2995 spin_unlock(&rxq
->lock
);
2999 #define IWL_CSR_TO_DUMP (0x250)
3001 static u32
iwl_trans_pcie_dump_csr(struct iwl_trans
*trans
,
3002 struct iwl_fw_error_dump_data
**data
)
3004 u32 csr_len
= sizeof(**data
) + IWL_CSR_TO_DUMP
;
3008 (*data
)->type
= cpu_to_le32(IWL_FW_ERROR_DUMP_CSR
);
3009 (*data
)->len
= cpu_to_le32(IWL_CSR_TO_DUMP
);
3010 val
= (void *)(*data
)->data
;
3012 for (i
= 0; i
< IWL_CSR_TO_DUMP
; i
+= 4)
3013 *val
++ = cpu_to_le32(iwl_trans_pcie_read32(trans
, i
));
3015 *data
= iwl_fw_error_next_data(*data
);
3020 static u32
iwl_trans_pcie_fh_regs_dump(struct iwl_trans
*trans
,
3021 struct iwl_fw_error_dump_data
**data
)
3023 u32 fh_regs_len
= FH_MEM_UPPER_BOUND
- FH_MEM_LOWER_BOUND
;
3024 unsigned long flags
;
3028 if (!iwl_trans_grab_nic_access(trans
, &flags
))
3031 (*data
)->type
= cpu_to_le32(IWL_FW_ERROR_DUMP_FH_REGS
);
3032 (*data
)->len
= cpu_to_le32(fh_regs_len
);
3033 val
= (void *)(*data
)->data
;
3035 if (!trans
->trans_cfg
->gen2
)
3036 for (i
= FH_MEM_LOWER_BOUND
; i
< FH_MEM_UPPER_BOUND
;
3038 *val
++ = cpu_to_le32(iwl_trans_pcie_read32(trans
, i
));
3040 for (i
= iwl_umac_prph(trans
, FH_MEM_LOWER_BOUND_GEN2
);
3041 i
< iwl_umac_prph(trans
, FH_MEM_UPPER_BOUND_GEN2
);
3043 *val
++ = cpu_to_le32(iwl_trans_pcie_read_prph(trans
,
3046 iwl_trans_release_nic_access(trans
, &flags
);
3048 *data
= iwl_fw_error_next_data(*data
);
3050 return sizeof(**data
) + fh_regs_len
;
3054 iwl_trans_pci_dump_marbh_monitor(struct iwl_trans
*trans
,
3055 struct iwl_fw_error_dump_fw_mon
*fw_mon_data
,
3058 u32 buf_size_in_dwords
= (monitor_len
>> 2);
3059 u32
*buffer
= (u32
*)fw_mon_data
->data
;
3060 unsigned long flags
;
3063 if (!iwl_trans_grab_nic_access(trans
, &flags
))
3066 iwl_write_umac_prph_no_grab(trans
, MON_DMARB_RD_CTL_ADDR
, 0x1);
3067 for (i
= 0; i
< buf_size_in_dwords
; i
++)
3068 buffer
[i
] = iwl_read_umac_prph_no_grab(trans
,
3069 MON_DMARB_RD_DATA_ADDR
);
3070 iwl_write_umac_prph_no_grab(trans
, MON_DMARB_RD_CTL_ADDR
, 0x0);
3072 iwl_trans_release_nic_access(trans
, &flags
);
3078 iwl_trans_pcie_dump_pointers(struct iwl_trans
*trans
,
3079 struct iwl_fw_error_dump_fw_mon
*fw_mon_data
)
3081 u32 base
, base_high
, write_ptr
, write_ptr_val
, wrap_cnt
;
3083 if (trans
->trans_cfg
->device_family
>= IWL_DEVICE_FAMILY_AX210
) {
3084 base
= DBGC_CUR_DBGBUF_BASE_ADDR_LSB
;
3085 base_high
= DBGC_CUR_DBGBUF_BASE_ADDR_MSB
;
3086 write_ptr
= DBGC_CUR_DBGBUF_STATUS
;
3087 wrap_cnt
= DBGC_DBGBUF_WRAP_AROUND
;
3088 } else if (trans
->dbg
.dest_tlv
) {
3089 write_ptr
= le32_to_cpu(trans
->dbg
.dest_tlv
->write_ptr_reg
);
3090 wrap_cnt
= le32_to_cpu(trans
->dbg
.dest_tlv
->wrap_count
);
3091 base
= le32_to_cpu(trans
->dbg
.dest_tlv
->base_reg
);
3093 base
= MON_BUFF_BASE_ADDR
;
3094 write_ptr
= MON_BUFF_WRPTR
;
3095 wrap_cnt
= MON_BUFF_CYCLE_CNT
;
3098 write_ptr_val
= iwl_read_prph(trans
, write_ptr
);
3099 fw_mon_data
->fw_mon_cycle_cnt
=
3100 cpu_to_le32(iwl_read_prph(trans
, wrap_cnt
));
3101 fw_mon_data
->fw_mon_base_ptr
=
3102 cpu_to_le32(iwl_read_prph(trans
, base
));
3103 if (trans
->trans_cfg
->device_family
>= IWL_DEVICE_FAMILY_AX210
) {
3104 fw_mon_data
->fw_mon_base_high_ptr
=
3105 cpu_to_le32(iwl_read_prph(trans
, base_high
));
3106 write_ptr_val
&= DBGC_CUR_DBGBUF_STATUS_OFFSET_MSK
;
3108 fw_mon_data
->fw_mon_wr_ptr
= cpu_to_le32(write_ptr_val
);
3112 iwl_trans_pcie_dump_monitor(struct iwl_trans
*trans
,
3113 struct iwl_fw_error_dump_data
**data
,
3116 struct iwl_dram_data
*fw_mon
= &trans
->dbg
.fw_mon
;
3119 if (trans
->dbg
.dest_tlv
||
3121 (trans
->trans_cfg
->device_family
== IWL_DEVICE_FAMILY_7000
||
3122 trans
->trans_cfg
->device_family
>= IWL_DEVICE_FAMILY_AX210
))) {
3123 struct iwl_fw_error_dump_fw_mon
*fw_mon_data
;
3125 (*data
)->type
= cpu_to_le32(IWL_FW_ERROR_DUMP_FW_MONITOR
);
3126 fw_mon_data
= (void *)(*data
)->data
;
3128 iwl_trans_pcie_dump_pointers(trans
, fw_mon_data
);
3130 len
+= sizeof(**data
) + sizeof(*fw_mon_data
);
3132 memcpy(fw_mon_data
->data
, fw_mon
->block
, fw_mon
->size
);
3133 monitor_len
= fw_mon
->size
;
3134 } else if (trans
->dbg
.dest_tlv
->monitor_mode
== SMEM_MODE
) {
3135 u32 base
= le32_to_cpu(fw_mon_data
->fw_mon_base_ptr
);
3137 * Update pointers to reflect actual values after
3140 if (trans
->dbg
.dest_tlv
->version
) {
3141 base
= (iwl_read_prph(trans
, base
) &
3142 IWL_LDBG_M2S_BUF_BA_MSK
) <<
3143 trans
->dbg
.dest_tlv
->base_shift
;
3144 base
*= IWL_M2S_UNIT_SIZE
;
3145 base
+= trans
->cfg
->smem_offset
;
3147 base
= iwl_read_prph(trans
, base
) <<
3148 trans
->dbg
.dest_tlv
->base_shift
;
3151 iwl_trans_read_mem(trans
, base
, fw_mon_data
->data
,
3152 monitor_len
/ sizeof(u32
));
3153 } else if (trans
->dbg
.dest_tlv
->monitor_mode
== MARBH_MODE
) {
3155 iwl_trans_pci_dump_marbh_monitor(trans
,
3159 /* Didn't match anything - output no monitor data */
3164 (*data
)->len
= cpu_to_le32(monitor_len
+ sizeof(*fw_mon_data
));
3170 static int iwl_trans_get_fw_monitor_len(struct iwl_trans
*trans
, u32
*len
)
3172 if (trans
->dbg
.fw_mon
.size
) {
3173 *len
+= sizeof(struct iwl_fw_error_dump_data
) +
3174 sizeof(struct iwl_fw_error_dump_fw_mon
) +
3175 trans
->dbg
.fw_mon
.size
;
3176 return trans
->dbg
.fw_mon
.size
;
3177 } else if (trans
->dbg
.dest_tlv
) {
3178 u32 base
, end
, cfg_reg
, monitor_len
;
3180 if (trans
->dbg
.dest_tlv
->version
== 1) {
3181 cfg_reg
= le32_to_cpu(trans
->dbg
.dest_tlv
->base_reg
);
3182 cfg_reg
= iwl_read_prph(trans
, cfg_reg
);
3183 base
= (cfg_reg
& IWL_LDBG_M2S_BUF_BA_MSK
) <<
3184 trans
->dbg
.dest_tlv
->base_shift
;
3185 base
*= IWL_M2S_UNIT_SIZE
;
3186 base
+= trans
->cfg
->smem_offset
;
3189 (cfg_reg
& IWL_LDBG_M2S_BUF_SIZE_MSK
) >>
3190 trans
->dbg
.dest_tlv
->end_shift
;
3191 monitor_len
*= IWL_M2S_UNIT_SIZE
;
3193 base
= le32_to_cpu(trans
->dbg
.dest_tlv
->base_reg
);
3194 end
= le32_to_cpu(trans
->dbg
.dest_tlv
->end_reg
);
3196 base
= iwl_read_prph(trans
, base
) <<
3197 trans
->dbg
.dest_tlv
->base_shift
;
3198 end
= iwl_read_prph(trans
, end
) <<
3199 trans
->dbg
.dest_tlv
->end_shift
;
3201 /* Make "end" point to the actual end */
3202 if (trans
->trans_cfg
->device_family
>=
3203 IWL_DEVICE_FAMILY_8000
||
3204 trans
->dbg
.dest_tlv
->monitor_mode
== MARBH_MODE
)
3205 end
+= (1 << trans
->dbg
.dest_tlv
->end_shift
);
3206 monitor_len
= end
- base
;
3208 *len
+= sizeof(struct iwl_fw_error_dump_data
) +
3209 sizeof(struct iwl_fw_error_dump_fw_mon
) +
3216 static struct iwl_trans_dump_data
3217 *iwl_trans_pcie_dump_data(struct iwl_trans
*trans
,
3220 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
3221 struct iwl_fw_error_dump_data
*data
;
3222 struct iwl_txq
*cmdq
= trans_pcie
->txq
[trans_pcie
->cmd_queue
];
3223 struct iwl_fw_error_dump_txcmd
*txcmd
;
3224 struct iwl_trans_dump_data
*dump_data
;
3225 u32 len
, num_rbs
= 0, monitor_len
= 0;
3227 bool dump_rbs
= test_bit(STATUS_FW_ERROR
, &trans
->status
) &&
3228 !trans
->trans_cfg
->mq_rx_supported
&&
3229 dump_mask
& BIT(IWL_FW_ERROR_DUMP_RB
);
3234 /* transport dump header */
3235 len
= sizeof(*dump_data
);
3238 if (dump_mask
& BIT(IWL_FW_ERROR_DUMP_TXCMD
) && cmdq
)
3239 len
+= sizeof(*data
) +
3240 cmdq
->n_window
* (sizeof(*txcmd
) +
3241 TFD_MAX_PAYLOAD_SIZE
);
3244 if (dump_mask
& BIT(IWL_FW_ERROR_DUMP_FW_MONITOR
))
3245 monitor_len
= iwl_trans_get_fw_monitor_len(trans
, &len
);
3248 if (dump_mask
& BIT(IWL_FW_ERROR_DUMP_CSR
))
3249 len
+= sizeof(*data
) + IWL_CSR_TO_DUMP
;
3252 if (dump_mask
& BIT(IWL_FW_ERROR_DUMP_FH_REGS
)) {
3253 if (trans
->trans_cfg
->gen2
)
3254 len
+= sizeof(*data
) +
3255 (iwl_umac_prph(trans
, FH_MEM_UPPER_BOUND_GEN2
) -
3256 iwl_umac_prph(trans
, FH_MEM_LOWER_BOUND_GEN2
));
3258 len
+= sizeof(*data
) +
3259 (FH_MEM_UPPER_BOUND
-
3260 FH_MEM_LOWER_BOUND
);
3264 /* Dump RBs is supported only for pre-9000 devices (1 queue) */
3265 struct iwl_rxq
*rxq
= &trans_pcie
->rxq
[0];
3268 le16_to_cpu(iwl_get_closed_rb_stts(trans
, rxq
))
3270 num_rbs
= (num_rbs
- rxq
->read
) & RX_QUEUE_MASK
;
3271 len
+= num_rbs
* (sizeof(*data
) +
3272 sizeof(struct iwl_fw_error_dump_rb
) +
3273 (PAGE_SIZE
<< trans_pcie
->rx_page_order
));
3276 /* Paged memory for gen2 HW */
3277 if (trans
->trans_cfg
->gen2
&& dump_mask
& BIT(IWL_FW_ERROR_DUMP_PAGING
))
3278 for (i
= 0; i
< trans
->init_dram
.paging_cnt
; i
++)
3279 len
+= sizeof(*data
) +
3280 sizeof(struct iwl_fw_error_dump_paging
) +
3281 trans
->init_dram
.paging
[i
].size
;
3283 dump_data
= vzalloc(len
);
3288 data
= (void *)dump_data
->data
;
3290 if (dump_mask
& BIT(IWL_FW_ERROR_DUMP_TXCMD
) && cmdq
) {
3291 u16 tfd_size
= trans_pcie
->tfd_size
;
3293 data
->type
= cpu_to_le32(IWL_FW_ERROR_DUMP_TXCMD
);
3294 txcmd
= (void *)data
->data
;
3295 spin_lock_bh(&cmdq
->lock
);
3296 ptr
= cmdq
->write_ptr
;
3297 for (i
= 0; i
< cmdq
->n_window
; i
++) {
3298 u8 idx
= iwl_pcie_get_cmd_index(cmdq
, ptr
);
3302 if (trans
->trans_cfg
->use_tfh
)
3307 cmdlen
= iwl_trans_pcie_get_cmdlen(trans
,
3310 caplen
= min_t(u32
, TFD_MAX_PAYLOAD_SIZE
, cmdlen
);
3313 len
+= sizeof(*txcmd
) + caplen
;
3314 txcmd
->cmdlen
= cpu_to_le32(cmdlen
);
3315 txcmd
->caplen
= cpu_to_le32(caplen
);
3316 memcpy(txcmd
->data
, cmdq
->entries
[idx
].cmd
,
3318 txcmd
= (void *)((u8
*)txcmd
->data
+ caplen
);
3321 ptr
= iwl_queue_dec_wrap(trans
, ptr
);
3323 spin_unlock_bh(&cmdq
->lock
);
3325 data
->len
= cpu_to_le32(len
);
3326 len
+= sizeof(*data
);
3327 data
= iwl_fw_error_next_data(data
);
3330 if (dump_mask
& BIT(IWL_FW_ERROR_DUMP_CSR
))
3331 len
+= iwl_trans_pcie_dump_csr(trans
, &data
);
3332 if (dump_mask
& BIT(IWL_FW_ERROR_DUMP_FH_REGS
))
3333 len
+= iwl_trans_pcie_fh_regs_dump(trans
, &data
);
3335 len
+= iwl_trans_pcie_dump_rbs(trans
, &data
, num_rbs
);
3337 /* Paged memory for gen2 HW */
3338 if (trans
->trans_cfg
->gen2
&&
3339 dump_mask
& BIT(IWL_FW_ERROR_DUMP_PAGING
)) {
3340 for (i
= 0; i
< trans
->init_dram
.paging_cnt
; i
++) {
3341 struct iwl_fw_error_dump_paging
*paging
;
3342 u32 page_len
= trans
->init_dram
.paging
[i
].size
;
3344 data
->type
= cpu_to_le32(IWL_FW_ERROR_DUMP_PAGING
);
3345 data
->len
= cpu_to_le32(sizeof(*paging
) + page_len
);
3346 paging
= (void *)data
->data
;
3347 paging
->index
= cpu_to_le32(i
);
3348 memcpy(paging
->data
,
3349 trans
->init_dram
.paging
[i
].block
, page_len
);
3350 data
= iwl_fw_error_next_data(data
);
3352 len
+= sizeof(*data
) + sizeof(*paging
) + page_len
;
3355 if (dump_mask
& BIT(IWL_FW_ERROR_DUMP_FW_MONITOR
))
3356 len
+= iwl_trans_pcie_dump_monitor(trans
, &data
, monitor_len
);
3358 dump_data
->len
= len
;
3363 #ifdef CONFIG_PM_SLEEP
3364 static int iwl_trans_pcie_suspend(struct iwl_trans
*trans
)
3369 static void iwl_trans_pcie_resume(struct iwl_trans
*trans
)
3372 #endif /* CONFIG_PM_SLEEP */
3374 #define IWL_TRANS_COMMON_OPS \
3375 .op_mode_leave = iwl_trans_pcie_op_mode_leave, \
3376 .write8 = iwl_trans_pcie_write8, \
3377 .write32 = iwl_trans_pcie_write32, \
3378 .read32 = iwl_trans_pcie_read32, \
3379 .read_prph = iwl_trans_pcie_read_prph, \
3380 .write_prph = iwl_trans_pcie_write_prph, \
3381 .read_mem = iwl_trans_pcie_read_mem, \
3382 .write_mem = iwl_trans_pcie_write_mem, \
3383 .configure = iwl_trans_pcie_configure, \
3384 .set_pmi = iwl_trans_pcie_set_pmi, \
3385 .sw_reset = iwl_trans_pcie_sw_reset, \
3386 .grab_nic_access = iwl_trans_pcie_grab_nic_access, \
3387 .release_nic_access = iwl_trans_pcie_release_nic_access, \
3388 .set_bits_mask = iwl_trans_pcie_set_bits_mask, \
3389 .dump_data = iwl_trans_pcie_dump_data, \
3390 .d3_suspend = iwl_trans_pcie_d3_suspend, \
3391 .d3_resume = iwl_trans_pcie_d3_resume, \
3392 .sync_nmi = iwl_trans_pcie_sync_nmi
3394 #ifdef CONFIG_PM_SLEEP
3395 #define IWL_TRANS_PM_OPS \
3396 .suspend = iwl_trans_pcie_suspend, \
3397 .resume = iwl_trans_pcie_resume,
3399 #define IWL_TRANS_PM_OPS
3400 #endif /* CONFIG_PM_SLEEP */
3402 static const struct iwl_trans_ops trans_ops_pcie
= {
3403 IWL_TRANS_COMMON_OPS
,
3405 .start_hw
= iwl_trans_pcie_start_hw
,
3406 .fw_alive
= iwl_trans_pcie_fw_alive
,
3407 .start_fw
= iwl_trans_pcie_start_fw
,
3408 .stop_device
= iwl_trans_pcie_stop_device
,
3410 .send_cmd
= iwl_trans_pcie_send_hcmd
,
3412 .tx
= iwl_trans_pcie_tx
,
3413 .reclaim
= iwl_trans_pcie_reclaim
,
3415 .txq_disable
= iwl_trans_pcie_txq_disable
,
3416 .txq_enable
= iwl_trans_pcie_txq_enable
,
3418 .txq_set_shared_mode
= iwl_trans_pcie_txq_set_shared_mode
,
3420 .wait_tx_queues_empty
= iwl_trans_pcie_wait_txqs_empty
,
3422 .freeze_txq_timer
= iwl_trans_pcie_freeze_txq_timer
,
3423 .block_txq_ptrs
= iwl_trans_pcie_block_txq_ptrs
,
3424 #ifdef CONFIG_IWLWIFI_DEBUGFS
3425 .debugfs_cleanup
= iwl_trans_pcie_debugfs_cleanup
,
3429 static const struct iwl_trans_ops trans_ops_pcie_gen2
= {
3430 IWL_TRANS_COMMON_OPS
,
3432 .start_hw
= iwl_trans_pcie_start_hw
,
3433 .fw_alive
= iwl_trans_pcie_gen2_fw_alive
,
3434 .start_fw
= iwl_trans_pcie_gen2_start_fw
,
3435 .stop_device
= iwl_trans_pcie_gen2_stop_device
,
3437 .send_cmd
= iwl_trans_pcie_gen2_send_hcmd
,
3439 .tx
= iwl_trans_pcie_gen2_tx
,
3440 .reclaim
= iwl_trans_pcie_reclaim
,
3442 .set_q_ptrs
= iwl_trans_pcie_set_q_ptrs
,
3444 .txq_alloc
= iwl_trans_pcie_dyn_txq_alloc
,
3445 .txq_free
= iwl_trans_pcie_dyn_txq_free
,
3446 .wait_txq_empty
= iwl_trans_pcie_wait_txq_empty
,
3447 .rxq_dma_data
= iwl_trans_pcie_rxq_dma_data
,
3448 #ifdef CONFIG_IWLWIFI_DEBUGFS
3449 .debugfs_cleanup
= iwl_trans_pcie_debugfs_cleanup
,
3453 struct iwl_trans
*iwl_trans_pcie_alloc(struct pci_dev
*pdev
,
3454 const struct pci_device_id
*ent
,
3455 const struct iwl_cfg_trans_params
*cfg_trans
)
3457 struct iwl_trans_pcie
*trans_pcie
;
3458 struct iwl_trans
*trans
;
3459 int ret
, addr_size
, txcmd_size
, txcmd_align
;
3460 const struct iwl_trans_ops
*ops
= &trans_ops_pcie_gen2
;
3462 if (!cfg_trans
->gen2
) {
3463 ops
= &trans_ops_pcie
;
3464 txcmd_size
= sizeof(struct iwl_tx_cmd
);
3465 txcmd_align
= sizeof(void *);
3466 } else if (cfg_trans
->device_family
< IWL_DEVICE_FAMILY_AX210
) {
3467 txcmd_size
= sizeof(struct iwl_tx_cmd_gen2
);
3470 txcmd_size
= sizeof(struct iwl_tx_cmd_gen3
);
3474 txcmd_size
+= sizeof(struct iwl_cmd_header
);
3475 txcmd_size
+= 36; /* biggest possible 802.11 header */
3477 /* Ensure device TX cmd cannot reach/cross a page boundary in gen2 */
3478 if (WARN_ON(cfg_trans
->gen2
&& txcmd_size
>= txcmd_align
))
3479 return ERR_PTR(-EINVAL
);
3481 ret
= pcim_enable_device(pdev
);
3483 return ERR_PTR(ret
);
3485 trans
= iwl_trans_alloc(sizeof(struct iwl_trans_pcie
), &pdev
->dev
, ops
,
3486 txcmd_size
, txcmd_align
);
3488 return ERR_PTR(-ENOMEM
);
3490 trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
3492 trans_pcie
->trans
= trans
;
3493 trans_pcie
->opmode_down
= true;
3494 spin_lock_init(&trans_pcie
->irq_lock
);
3495 spin_lock_init(&trans_pcie
->reg_lock
);
3496 spin_lock_init(&trans_pcie
->alloc_page_lock
);
3497 mutex_init(&trans_pcie
->mutex
);
3498 init_waitqueue_head(&trans_pcie
->ucode_write_waitq
);
3500 trans_pcie
->rba
.alloc_wq
= alloc_workqueue("rb_allocator",
3501 WQ_HIGHPRI
| WQ_UNBOUND
, 1);
3502 if (!trans_pcie
->rba
.alloc_wq
) {
3504 goto out_free_trans
;
3506 INIT_WORK(&trans_pcie
->rba
.rx_alloc
, iwl_pcie_rx_allocator_work
);
3508 trans_pcie
->tso_hdr_page
= alloc_percpu(struct iwl_tso_hdr_page
);
3509 if (!trans_pcie
->tso_hdr_page
) {
3513 trans_pcie
->debug_rfkill
= -1;
3515 if (!cfg_trans
->base_params
->pcie_l1_allowed
) {
3517 * W/A - seems to solve weird behavior. We need to remove this
3518 * if we don't want to stay in L1 all the time. This wastes a
3521 pci_disable_link_state(pdev
, PCIE_LINK_STATE_L0S
|
3522 PCIE_LINK_STATE_L1
|
3523 PCIE_LINK_STATE_CLKPM
);
3526 trans_pcie
->def_rx_queue
= 0;
3528 if (cfg_trans
->use_tfh
) {
3530 trans_pcie
->max_tbs
= IWL_TFH_NUM_TBS
;
3531 trans_pcie
->tfd_size
= sizeof(struct iwl_tfh_tfd
);
3534 trans_pcie
->max_tbs
= IWL_NUM_OF_TBS
;
3535 trans_pcie
->tfd_size
= sizeof(struct iwl_tfd
);
3537 trans
->max_skb_frags
= IWL_PCIE_MAX_FRAGS(trans_pcie
);
3539 pci_set_master(pdev
);
3541 ret
= pci_set_dma_mask(pdev
, DMA_BIT_MASK(addr_size
));
3543 ret
= pci_set_consistent_dma_mask(pdev
,
3544 DMA_BIT_MASK(addr_size
));
3546 ret
= pci_set_dma_mask(pdev
, DMA_BIT_MASK(32));
3548 ret
= pci_set_consistent_dma_mask(pdev
,
3550 /* both attempts failed: */
3552 dev_err(&pdev
->dev
, "No suitable DMA available\n");
3557 ret
= pcim_iomap_regions_request_all(pdev
, BIT(0), DRV_NAME
);
3559 dev_err(&pdev
->dev
, "pcim_iomap_regions_request_all failed\n");
3563 trans_pcie
->hw_base
= pcim_iomap_table(pdev
)[0];
3564 if (!trans_pcie
->hw_base
) {
3565 dev_err(&pdev
->dev
, "pcim_iomap_table failed\n");
3570 /* We disable the RETRY_TIMEOUT register (0x41) to keep
3571 * PCI Tx retries from interfering with C3 CPU state */
3572 pci_write_config_byte(pdev
, PCI_CFG_RETRY_TIMEOUT
, 0x00);
3574 trans_pcie
->pci_dev
= pdev
;
3575 iwl_disable_interrupts(trans
);
3577 trans
->hw_rev
= iwl_read32(trans
, CSR_HW_REV
);
3578 if (trans
->hw_rev
== 0xffffffff) {
3579 dev_err(&pdev
->dev
, "HW_REV=0xFFFFFFFF, PCI issues?\n");
3585 * In the 8000 HW family the format of the 4 bytes of CSR_HW_REV have
3586 * changed, and now the revision step also includes bit 0-1 (no more
3587 * "dash" value). To keep hw_rev backwards compatible - we'll store it
3588 * in the old format.
3590 if (cfg_trans
->device_family
>= IWL_DEVICE_FAMILY_8000
) {
3591 trans
->hw_rev
= (trans
->hw_rev
& 0xfff0) |
3592 (CSR_HW_REV_STEP(trans
->hw_rev
<< 2) << 2);
3594 ret
= iwl_pcie_prepare_card_hw(trans
);
3596 IWL_WARN(trans
, "Exit HW not ready\n");
3601 * in-order to recognize C step driver should read chip version
3602 * id located at the AUX bus MISC address space.
3604 ret
= iwl_finish_nic_init(trans
, cfg_trans
);
3610 IWL_DEBUG_INFO(trans
, "HW REV: 0x%0x\n", trans
->hw_rev
);
3612 iwl_pcie_set_interrupt_capa(pdev
, trans
, cfg_trans
);
3613 trans
->hw_id
= (pdev
->device
<< 16) + pdev
->subsystem_device
;
3614 snprintf(trans
->hw_id_str
, sizeof(trans
->hw_id_str
),
3615 "PCI ID: 0x%04X:0x%04X", pdev
->device
, pdev
->subsystem_device
);
3617 /* Initialize the wait queue for commands */
3618 init_waitqueue_head(&trans_pcie
->wait_command_queue
);
3620 init_waitqueue_head(&trans_pcie
->sx_waitq
);
3622 if (trans_pcie
->msix_enabled
) {
3623 ret
= iwl_pcie_init_msix_handler(pdev
, trans_pcie
);
3627 ret
= iwl_pcie_alloc_ict(trans
);
3631 ret
= devm_request_threaded_irq(&pdev
->dev
, pdev
->irq
,
3633 iwl_pcie_irq_handler
,
3634 IRQF_SHARED
, DRV_NAME
, trans
);
3636 IWL_ERR(trans
, "Error allocating IRQ %d\n", pdev
->irq
);
3639 trans_pcie
->inta_mask
= CSR_INI_SET_MASK
;
3642 #ifdef CONFIG_IWLWIFI_DEBUGFS
3643 trans_pcie
->fw_mon_data
.state
= IWL_FW_MON_DBGFS_STATE_CLOSED
;
3644 mutex_init(&trans_pcie
->fw_mon_data
.mutex
);
3647 iwl_dbg_tlv_init(trans
);
3652 iwl_pcie_free_ict(trans
);
3654 free_percpu(trans_pcie
->tso_hdr_page
);
3655 destroy_workqueue(trans_pcie
->rba
.alloc_wq
);
3657 iwl_trans_free(trans
);
3658 return ERR_PTR(ret
);
3661 void iwl_trans_pcie_sync_nmi(struct iwl_trans
*trans
)
3663 struct iwl_trans_pcie
*trans_pcie
= IWL_TRANS_GET_PCIE_TRANS(trans
);
3664 unsigned long timeout
= jiffies
+ IWL_TRANS_NMI_TIMEOUT
;
3665 bool interrupts_enabled
= test_bit(STATUS_INT_ENABLED
, &trans
->status
);
3666 u32 inta_addr
, sw_err_bit
;
3668 if (trans_pcie
->msix_enabled
) {
3669 inta_addr
= CSR_MSIX_HW_INT_CAUSES_AD
;
3670 sw_err_bit
= MSIX_HW_INT_CAUSES_REG_SW_ERR
;
3672 inta_addr
= CSR_INT
;
3673 sw_err_bit
= CSR_INT_BIT_SW_ERR
;
3676 /* if the interrupts were already disabled, there is no point in
3677 * calling iwl_disable_interrupts
3679 if (interrupts_enabled
)
3680 iwl_disable_interrupts(trans
);
3682 iwl_force_nmi(trans
);
3683 while (time_after(timeout
, jiffies
)) {
3684 u32 inta_hw
= iwl_read32(trans
, inta_addr
);
3686 /* Error detected by uCode */
3687 if (inta_hw
& sw_err_bit
) {
3688 /* Clear causes register */
3689 iwl_write32(trans
, inta_addr
, inta_hw
& sw_err_bit
);
3696 /* enable interrupts only if there were already enabled before this
3697 * function to avoid a case were the driver enable interrupts before
3698 * proper configurations were made
3700 if (interrupts_enabled
)
3701 iwl_enable_interrupts(trans
);
3703 iwl_trans_fw_error(trans
);