1 /******************************************************************************
3 * Copyright(c) 2003 - 2010 Intel Corporation. All rights reserved.
5 * Portions of this file are derived from the ipw3945 project, as well
6 * as portions of the ieee80211 subsystem header files.
8 * This program is free software; you can redistribute it and/or modify it
9 * under the terms of version 2 of the GNU General Public License as
10 * published by the Free Software Foundation.
12 * This program is distributed in the hope that it will be useful, but WITHOUT
13 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
14 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
17 * You should have received a copy of the GNU General Public License along with
18 * this program; if not, write to the Free Software Foundation, Inc.,
19 * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
21 * The full GNU General Public License is included in this distribution in the
22 * file called LICENSE.
24 * Contact Information:
25 * Intel Linux Wireless <ilw@linux.intel.com>
26 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
28 *****************************************************************************/
30 #include <linux/kernel.h>
31 #include <linux/module.h>
32 #include <linux/init.h>
33 #include <linux/pci.h>
34 #include <linux/dma-mapping.h>
35 #include <linux/delay.h>
36 #include <linux/sched.h>
37 #include <linux/skbuff.h>
38 #include <linux/netdevice.h>
39 #include <linux/wireless.h>
40 #include <linux/firmware.h>
41 #include <linux/etherdevice.h>
42 #include <linux/if_arp.h>
44 #include <net/mac80211.h>
46 #include <asm/div64.h>
48 #define DRV_NAME "iwlagn"
50 #include "iwl-eeprom.h"
54 #include "iwl-helpers.h"
56 #include "iwl-calib.h"
60 /******************************************************************************
64 ******************************************************************************/
67 * module name, copyright, version, etc.
69 #define DRV_DESCRIPTION "Intel(R) Wireless WiFi Link AGN driver for Linux"
71 #ifdef CONFIG_IWLWIFI_DEBUG
77 #define DRV_VERSION IWLWIFI_VERSION VD
80 MODULE_DESCRIPTION(DRV_DESCRIPTION);
81 MODULE_VERSION(DRV_VERSION);
82 MODULE_AUTHOR(DRV_COPYRIGHT " " DRV_AUTHOR);
83 MODULE_LICENSE("GPL");
84 MODULE_ALIAS("iwl4965");
87 * iwl_commit_rxon - commit staging_rxon to hardware
89 * The RXON command in staging_rxon is committed to the hardware and
90 * the active_rxon structure is updated with the new data. This
91 * function correctly transitions out of the RXON_ASSOC_MSK state if
92 * a HW tune is required based on the RXON structure changes.
94 int iwl_commit_rxon(struct iwl_priv *priv)
96 /* cast away the const for active_rxon in this function */
97 struct iwl_rxon_cmd *active_rxon = (void *)&priv->active_rxon;
100 !!(priv->staging_rxon.filter_flags & RXON_FILTER_ASSOC_MSK);
102 if (!iwl_is_alive(priv))
105 /* always get timestamp with Rx frame */
106 priv->staging_rxon.flags |= RXON_FLG_TSF2HOST_MSK;
108 ret = iwl_check_rxon_cmd(priv);
110 IWL_ERR(priv, "Invalid RXON configuration. Not committing.\n");
115 * receive commit_rxon request
116 * abort any previous channel switch if still in process
118 if (priv->switch_rxon.switch_in_progress &&
119 (priv->switch_rxon.channel != priv->staging_rxon.channel)) {
120 IWL_DEBUG_11H(priv, "abort channel switch on %d\n",
121 le16_to_cpu(priv->switch_rxon.channel));
122 priv->switch_rxon.switch_in_progress = false;
125 /* If we don't need to send a full RXON, we can use
126 * iwl_rxon_assoc_cmd which is used to reconfigure filter
127 * and other flags for the current radio configuration. */
128 if (!iwl_full_rxon_required(priv)) {
129 ret = iwl_send_rxon_assoc(priv);
131 IWL_ERR(priv, "Error setting RXON_ASSOC (%d)\n", ret);
135 memcpy(active_rxon, &priv->staging_rxon, sizeof(*active_rxon));
136 iwl_print_rx_config_cmd(priv);
140 /* If we are currently associated and the new config requires
141 * an RXON_ASSOC and the new config wants the associated mask enabled,
142 * we must clear the associated from the active configuration
143 * before we apply the new config */
144 if (iwl_is_associated(priv) && new_assoc) {
145 IWL_DEBUG_INFO(priv, "Toggling associated bit on current RXON\n");
146 active_rxon->filter_flags &= ~RXON_FILTER_ASSOC_MSK;
148 ret = iwl_send_cmd_pdu(priv, REPLY_RXON,
149 sizeof(struct iwl_rxon_cmd),
152 /* If the mask clearing failed then we set
153 * active_rxon back to what it was previously */
155 active_rxon->filter_flags |= RXON_FILTER_ASSOC_MSK;
156 IWL_ERR(priv, "Error clearing ASSOC_MSK (%d)\n", ret);
159 iwl_clear_ucode_stations(priv, false);
160 iwl_restore_stations(priv);
161 ret = iwl_restore_default_wep_keys(priv);
163 IWL_ERR(priv, "Failed to restore WEP keys (%d)\n", ret);
168 IWL_DEBUG_INFO(priv, "Sending RXON\n"
169 "* with%s RXON_FILTER_ASSOC_MSK\n"
172 (new_assoc ? "" : "out"),
173 le16_to_cpu(priv->staging_rxon.channel),
174 priv->staging_rxon.bssid_addr);
176 iwl_set_rxon_hwcrypto(priv, !priv->cfg->mod_params->sw_crypto);
178 /* Apply the new configuration
179 * RXON unassoc clears the station table in uCode so restoration of
180 * stations is needed after it (the RXON command) completes
183 ret = iwl_send_cmd_pdu(priv, REPLY_RXON,
184 sizeof(struct iwl_rxon_cmd), &priv->staging_rxon);
186 IWL_ERR(priv, "Error setting new RXON (%d)\n", ret);
189 IWL_DEBUG_INFO(priv, "Return from !new_assoc RXON.\n");
190 memcpy(active_rxon, &priv->staging_rxon, sizeof(*active_rxon));
191 iwl_clear_ucode_stations(priv, false);
192 iwl_restore_stations(priv);
193 ret = iwl_restore_default_wep_keys(priv);
195 IWL_ERR(priv, "Failed to restore WEP keys (%d)\n", ret);
200 priv->start_calib = 0;
203 * allow CTS-to-self if possible for new association.
204 * this is relevant only for 5000 series and up,
205 * but will not damage 4965
207 priv->staging_rxon.flags |= RXON_FLG_SELF_CTS_EN;
209 /* Apply the new configuration
210 * RXON assoc doesn't clear the station table in uCode,
212 ret = iwl_send_cmd_pdu(priv, REPLY_RXON,
213 sizeof(struct iwl_rxon_cmd), &priv->staging_rxon);
215 IWL_ERR(priv, "Error setting new RXON (%d)\n", ret);
218 memcpy(active_rxon, &priv->staging_rxon, sizeof(*active_rxon));
220 iwl_print_rx_config_cmd(priv);
222 iwl_init_sensitivity(priv);
224 /* If we issue a new RXON command which required a tune then we must
225 * send a new TXPOWER command or we won't be able to Tx any frames */
226 ret = iwl_set_tx_power(priv, priv->tx_power_user_lmt, true);
228 IWL_ERR(priv, "Error sending TX power (%d)\n", ret);
235 void iwl_update_chain_flags(struct iwl_priv *priv)
238 if (priv->cfg->ops->hcmd->set_rxon_chain)
239 priv->cfg->ops->hcmd->set_rxon_chain(priv);
240 iwlcore_commit_rxon(priv);
243 static void iwl_clear_free_frames(struct iwl_priv *priv)
245 struct list_head *element;
247 IWL_DEBUG_INFO(priv, "%d frames on pre-allocated heap on clear.\n",
250 while (!list_empty(&priv->free_frames)) {
251 element = priv->free_frames.next;
253 kfree(list_entry(element, struct iwl_frame, list));
254 priv->frames_count--;
257 if (priv->frames_count) {
258 IWL_WARN(priv, "%d frames still in use. Did we lose one?\n",
260 priv->frames_count = 0;
264 static struct iwl_frame *iwl_get_free_frame(struct iwl_priv *priv)
266 struct iwl_frame *frame;
267 struct list_head *element;
268 if (list_empty(&priv->free_frames)) {
269 frame = kzalloc(sizeof(*frame), GFP_KERNEL);
271 IWL_ERR(priv, "Could not allocate frame!\n");
275 priv->frames_count++;
279 element = priv->free_frames.next;
281 return list_entry(element, struct iwl_frame, list);
284 static void iwl_free_frame(struct iwl_priv *priv, struct iwl_frame *frame)
286 memset(frame, 0, sizeof(*frame));
287 list_add(&frame->list, &priv->free_frames);
290 static u32 iwl_fill_beacon_frame(struct iwl_priv *priv,
291 struct ieee80211_hdr *hdr,
294 if (!iwl_is_associated(priv) || !priv->ibss_beacon ||
295 ((priv->iw_mode != NL80211_IFTYPE_ADHOC) &&
296 (priv->iw_mode != NL80211_IFTYPE_AP)))
299 if (priv->ibss_beacon->len > left)
302 memcpy(hdr, priv->ibss_beacon->data, priv->ibss_beacon->len);
304 return priv->ibss_beacon->len;
307 /* Parse the beacon frame to find the TIM element and set tim_idx & tim_size */
308 static void iwl_set_beacon_tim(struct iwl_priv *priv,
309 struct iwl_tx_beacon_cmd *tx_beacon_cmd,
310 u8 *beacon, u32 frame_size)
313 struct ieee80211_mgmt *mgmt = (struct ieee80211_mgmt *)beacon;
316 * The index is relative to frame start but we start looking at the
317 * variable-length part of the beacon.
319 tim_idx = mgmt->u.beacon.variable - beacon;
321 /* Parse variable-length elements of beacon to find WLAN_EID_TIM */
322 while ((tim_idx < (frame_size - 2)) &&
323 (beacon[tim_idx] != WLAN_EID_TIM))
324 tim_idx += beacon[tim_idx+1] + 2;
326 /* If TIM field was found, set variables */
327 if ((tim_idx < (frame_size - 1)) && (beacon[tim_idx] == WLAN_EID_TIM)) {
328 tx_beacon_cmd->tim_idx = cpu_to_le16(tim_idx);
329 tx_beacon_cmd->tim_size = beacon[tim_idx+1];
331 IWL_WARN(priv, "Unable to find TIM Element in beacon\n");
334 static unsigned int iwl_hw_get_beacon_cmd(struct iwl_priv *priv,
335 struct iwl_frame *frame)
337 struct iwl_tx_beacon_cmd *tx_beacon_cmd;
342 * We have to set up the TX command, the TX Beacon command, and the
346 /* Initialize memory */
347 tx_beacon_cmd = &frame->u.beacon;
348 memset(tx_beacon_cmd, 0, sizeof(*tx_beacon_cmd));
350 /* Set up TX beacon contents */
351 frame_size = iwl_fill_beacon_frame(priv, tx_beacon_cmd->frame,
352 sizeof(frame->u) - sizeof(*tx_beacon_cmd));
353 if (WARN_ON_ONCE(frame_size > MAX_MPDU_SIZE))
356 /* Set up TX command fields */
357 tx_beacon_cmd->tx.len = cpu_to_le16((u16)frame_size);
358 tx_beacon_cmd->tx.sta_id = priv->hw_params.bcast_sta_id;
359 tx_beacon_cmd->tx.stop_time.life_time = TX_CMD_LIFE_TIME_INFINITE;
360 tx_beacon_cmd->tx.tx_flags = TX_CMD_FLG_SEQ_CTL_MSK |
361 TX_CMD_FLG_TSF_MSK | TX_CMD_FLG_STA_RATE_MSK;
363 /* Set up TX beacon command fields */
364 iwl_set_beacon_tim(priv, tx_beacon_cmd, (u8 *)tx_beacon_cmd->frame,
367 /* Set up packet rate and flags */
368 rate = iwl_rate_get_lowest_plcp(priv);
369 priv->mgmt_tx_ant = iwl_toggle_tx_ant(priv, priv->mgmt_tx_ant);
370 rate_flags = iwl_ant_idx_to_flags(priv->mgmt_tx_ant);
371 if ((rate >= IWL_FIRST_CCK_RATE) && (rate <= IWL_LAST_CCK_RATE))
372 rate_flags |= RATE_MCS_CCK_MSK;
373 tx_beacon_cmd->tx.rate_n_flags = iwl_hw_set_rate_n_flags(rate,
376 return sizeof(*tx_beacon_cmd) + frame_size;
378 static int iwl_send_beacon_cmd(struct iwl_priv *priv)
380 struct iwl_frame *frame;
381 unsigned int frame_size;
384 frame = iwl_get_free_frame(priv);
386 IWL_ERR(priv, "Could not obtain free frame buffer for beacon "
391 frame_size = iwl_hw_get_beacon_cmd(priv, frame);
393 IWL_ERR(priv, "Error configuring the beacon command\n");
394 iwl_free_frame(priv, frame);
398 rc = iwl_send_cmd_pdu(priv, REPLY_TX_BEACON, frame_size,
401 iwl_free_frame(priv, frame);
406 static inline dma_addr_t iwl_tfd_tb_get_addr(struct iwl_tfd *tfd, u8 idx)
408 struct iwl_tfd_tb *tb = &tfd->tbs[idx];
410 dma_addr_t addr = get_unaligned_le32(&tb->lo);
411 if (sizeof(dma_addr_t) > sizeof(u32))
413 ((dma_addr_t)(le16_to_cpu(tb->hi_n_len) & 0xF) << 16) << 16;
418 static inline u16 iwl_tfd_tb_get_len(struct iwl_tfd *tfd, u8 idx)
420 struct iwl_tfd_tb *tb = &tfd->tbs[idx];
422 return le16_to_cpu(tb->hi_n_len) >> 4;
425 static inline void iwl_tfd_set_tb(struct iwl_tfd *tfd, u8 idx,
426 dma_addr_t addr, u16 len)
428 struct iwl_tfd_tb *tb = &tfd->tbs[idx];
429 u16 hi_n_len = len << 4;
431 put_unaligned_le32(addr, &tb->lo);
432 if (sizeof(dma_addr_t) > sizeof(u32))
433 hi_n_len |= ((addr >> 16) >> 16) & 0xF;
435 tb->hi_n_len = cpu_to_le16(hi_n_len);
437 tfd->num_tbs = idx + 1;
440 static inline u8 iwl_tfd_get_num_tbs(struct iwl_tfd *tfd)
442 return tfd->num_tbs & 0x1f;
446 * iwl_hw_txq_free_tfd - Free all chunks referenced by TFD [txq->q.read_ptr]
447 * @priv - driver private data
450 * Does NOT advance any TFD circular buffer read/write indexes
451 * Does NOT free the TFD itself (which is within circular buffer)
453 void iwl_hw_txq_free_tfd(struct iwl_priv *priv, struct iwl_tx_queue *txq)
455 struct iwl_tfd *tfd_tmp = (struct iwl_tfd *)txq->tfds;
457 struct pci_dev *dev = priv->pci_dev;
458 int index = txq->q.read_ptr;
462 tfd = &tfd_tmp[index];
464 /* Sanity check on number of chunks */
465 num_tbs = iwl_tfd_get_num_tbs(tfd);
467 if (num_tbs >= IWL_NUM_OF_TBS) {
468 IWL_ERR(priv, "Too many chunks: %i\n", num_tbs);
469 /* @todo issue fatal error, it is quite serious situation */
475 pci_unmap_single(dev,
476 pci_unmap_addr(&txq->meta[index], mapping),
477 pci_unmap_len(&txq->meta[index], len),
478 PCI_DMA_BIDIRECTIONAL);
480 /* Unmap chunks, if any. */
481 for (i = 1; i < num_tbs; i++) {
482 pci_unmap_single(dev, iwl_tfd_tb_get_addr(tfd, i),
483 iwl_tfd_tb_get_len(tfd, i), PCI_DMA_TODEVICE);
486 dev_kfree_skb(txq->txb[txq->q.read_ptr].skb[i - 1]);
487 txq->txb[txq->q.read_ptr].skb[i - 1] = NULL;
492 int iwl_hw_txq_attach_buf_to_tfd(struct iwl_priv *priv,
493 struct iwl_tx_queue *txq,
494 dma_addr_t addr, u16 len,
498 struct iwl_tfd *tfd, *tfd_tmp;
502 tfd_tmp = (struct iwl_tfd *)txq->tfds;
503 tfd = &tfd_tmp[q->write_ptr];
506 memset(tfd, 0, sizeof(*tfd));
508 num_tbs = iwl_tfd_get_num_tbs(tfd);
510 /* Each TFD can point to a maximum 20 Tx buffers */
511 if (num_tbs >= IWL_NUM_OF_TBS) {
512 IWL_ERR(priv, "Error can not send more than %d chunks\n",
517 BUG_ON(addr & ~DMA_BIT_MASK(36));
518 if (unlikely(addr & ~IWL_TX_DMA_MASK))
519 IWL_ERR(priv, "Unaligned address = %llx\n",
520 (unsigned long long)addr);
522 iwl_tfd_set_tb(tfd, num_tbs, addr, len);
528 * Tell nic where to find circular buffer of Tx Frame Descriptors for
529 * given Tx queue, and enable the DMA channel used for that queue.
531 * 4965 supports up to 16 Tx queues in DRAM, mapped to up to 8 Tx DMA
532 * channels supported in hardware.
534 int iwl_hw_tx_queue_init(struct iwl_priv *priv,
535 struct iwl_tx_queue *txq)
537 int txq_id = txq->q.id;
539 /* Circular buffer (TFD queue in DRAM) physical base address */
540 iwl_write_direct32(priv, FH_MEM_CBBC_QUEUE(txq_id),
541 txq->q.dma_addr >> 8);
546 /******************************************************************************
548 * Generic RX handler implementations
550 ******************************************************************************/
551 static void iwl_rx_reply_alive(struct iwl_priv *priv,
552 struct iwl_rx_mem_buffer *rxb)
554 struct iwl_rx_packet *pkt = rxb_addr(rxb);
555 struct iwl_alive_resp *palive;
556 struct delayed_work *pwork;
558 palive = &pkt->u.alive_frame;
560 IWL_DEBUG_INFO(priv, "Alive ucode status 0x%08X revision "
562 palive->is_valid, palive->ver_type,
563 palive->ver_subtype);
565 if (palive->ver_subtype == INITIALIZE_SUBTYPE) {
566 IWL_DEBUG_INFO(priv, "Initialization Alive received.\n");
567 memcpy(&priv->card_alive_init,
569 sizeof(struct iwl_init_alive_resp));
570 pwork = &priv->init_alive_start;
572 IWL_DEBUG_INFO(priv, "Runtime Alive received.\n");
573 memcpy(&priv->card_alive, &pkt->u.alive_frame,
574 sizeof(struct iwl_alive_resp));
575 pwork = &priv->alive_start;
578 /* We delay the ALIVE response by 5ms to
579 * give the HW RF Kill time to activate... */
580 if (palive->is_valid == UCODE_VALID_OK)
581 queue_delayed_work(priv->workqueue, pwork,
582 msecs_to_jiffies(5));
584 IWL_WARN(priv, "uCode did not respond OK.\n");
587 static void iwl_bg_beacon_update(struct work_struct *work)
589 struct iwl_priv *priv =
590 container_of(work, struct iwl_priv, beacon_update);
591 struct sk_buff *beacon;
593 /* Pull updated AP beacon from mac80211. will fail if not in AP mode */
594 beacon = ieee80211_beacon_get(priv->hw, priv->vif);
597 IWL_ERR(priv, "update beacon failed\n");
601 mutex_lock(&priv->mutex);
602 /* new beacon skb is allocated every time; dispose previous.*/
603 if (priv->ibss_beacon)
604 dev_kfree_skb(priv->ibss_beacon);
606 priv->ibss_beacon = beacon;
607 mutex_unlock(&priv->mutex);
609 iwl_send_beacon_cmd(priv);
613 * iwl_bg_statistics_periodic - Timer callback to queue statistics
615 * This callback is provided in order to send a statistics request.
617 * This timer function is continually reset to execute within
618 * REG_RECALIB_PERIOD seconds since the last STATISTICS_NOTIFICATION
619 * was received. We need to ensure we receive the statistics in order
620 * to update the temperature used for calibrating the TXPOWER.
622 static void iwl_bg_statistics_periodic(unsigned long data)
624 struct iwl_priv *priv = (struct iwl_priv *)data;
626 if (test_bit(STATUS_EXIT_PENDING, &priv->status))
629 /* dont send host command if rf-kill is on */
630 if (!iwl_is_ready_rf(priv))
633 iwl_send_statistics_request(priv, CMD_ASYNC, false);
637 static void iwl_print_cont_event_trace(struct iwl_priv *priv, u32 base,
638 u32 start_idx, u32 num_events,
642 u32 ptr; /* SRAM byte address of log data */
643 u32 ev, time, data; /* event log data */
644 unsigned long reg_flags;
647 ptr = base + (4 * sizeof(u32)) + (start_idx * 2 * sizeof(u32));
649 ptr = base + (4 * sizeof(u32)) + (start_idx * 3 * sizeof(u32));
651 /* Make sure device is powered up for SRAM reads */
652 spin_lock_irqsave(&priv->reg_lock, reg_flags);
653 if (iwl_grab_nic_access(priv)) {
654 spin_unlock_irqrestore(&priv->reg_lock, reg_flags);
658 /* Set starting address; reads will auto-increment */
659 _iwl_write_direct32(priv, HBUS_TARG_MEM_RADDR, ptr);
663 * "time" is actually "data" for mode 0 (no timestamp).
664 * place event id # at far right for easier visual parsing.
666 for (i = 0; i < num_events; i++) {
667 ev = _iwl_read_direct32(priv, HBUS_TARG_MEM_RDAT);
668 time = _iwl_read_direct32(priv, HBUS_TARG_MEM_RDAT);
670 trace_iwlwifi_dev_ucode_cont_event(priv,
673 data = _iwl_read_direct32(priv, HBUS_TARG_MEM_RDAT);
674 trace_iwlwifi_dev_ucode_cont_event(priv,
678 /* Allow device to power down */
679 iwl_release_nic_access(priv);
680 spin_unlock_irqrestore(&priv->reg_lock, reg_flags);
683 static void iwl_continuous_event_trace(struct iwl_priv *priv)
685 u32 capacity; /* event log capacity in # entries */
686 u32 base; /* SRAM byte address of event log header */
687 u32 mode; /* 0 - no timestamp, 1 - timestamp recorded */
688 u32 num_wraps; /* # times uCode wrapped to top of log */
689 u32 next_entry; /* index of next entry to be written by uCode */
691 if (priv->ucode_type == UCODE_INIT)
692 base = le32_to_cpu(priv->card_alive_init.error_event_table_ptr);
694 base = le32_to_cpu(priv->card_alive.log_event_table_ptr);
695 if (priv->cfg->ops->lib->is_valid_rtc_data_addr(base)) {
696 capacity = iwl_read_targ_mem(priv, base);
697 num_wraps = iwl_read_targ_mem(priv, base + (2 * sizeof(u32)));
698 mode = iwl_read_targ_mem(priv, base + (1 * sizeof(u32)));
699 next_entry = iwl_read_targ_mem(priv, base + (3 * sizeof(u32)));
703 if (num_wraps == priv->event_log.num_wraps) {
704 iwl_print_cont_event_trace(priv,
705 base, priv->event_log.next_entry,
706 next_entry - priv->event_log.next_entry,
708 priv->event_log.non_wraps_count++;
710 if ((num_wraps - priv->event_log.num_wraps) > 1)
711 priv->event_log.wraps_more_count++;
713 priv->event_log.wraps_once_count++;
714 trace_iwlwifi_dev_ucode_wrap_event(priv,
715 num_wraps - priv->event_log.num_wraps,
716 next_entry, priv->event_log.next_entry);
717 if (next_entry < priv->event_log.next_entry) {
718 iwl_print_cont_event_trace(priv, base,
719 priv->event_log.next_entry,
720 capacity - priv->event_log.next_entry,
723 iwl_print_cont_event_trace(priv, base, 0,
726 iwl_print_cont_event_trace(priv, base,
727 next_entry, capacity - next_entry,
730 iwl_print_cont_event_trace(priv, base, 0,
734 priv->event_log.num_wraps = num_wraps;
735 priv->event_log.next_entry = next_entry;
739 * iwl_bg_ucode_trace - Timer callback to log ucode event
741 * The timer is continually set to execute every
742 * UCODE_TRACE_PERIOD milliseconds after the last timer expired
743 * this function is to perform continuous uCode event logging operation
746 static void iwl_bg_ucode_trace(unsigned long data)
748 struct iwl_priv *priv = (struct iwl_priv *)data;
750 if (test_bit(STATUS_EXIT_PENDING, &priv->status))
753 if (priv->event_log.ucode_trace) {
754 iwl_continuous_event_trace(priv);
755 /* Reschedule the timer to occur in UCODE_TRACE_PERIOD */
756 mod_timer(&priv->ucode_trace,
757 jiffies + msecs_to_jiffies(UCODE_TRACE_PERIOD));
761 static void iwl_rx_beacon_notif(struct iwl_priv *priv,
762 struct iwl_rx_mem_buffer *rxb)
764 #ifdef CONFIG_IWLWIFI_DEBUG
765 struct iwl_rx_packet *pkt = rxb_addr(rxb);
766 struct iwl4965_beacon_notif *beacon =
767 (struct iwl4965_beacon_notif *)pkt->u.raw;
768 u8 rate = iwl_hw_get_rate(beacon->beacon_notify_hdr.rate_n_flags);
770 IWL_DEBUG_RX(priv, "beacon status %x retries %d iss %d "
771 "tsf %d %d rate %d\n",
772 le32_to_cpu(beacon->beacon_notify_hdr.u.status) & TX_STATUS_MSK,
773 beacon->beacon_notify_hdr.failure_frame,
774 le32_to_cpu(beacon->ibss_mgr_status),
775 le32_to_cpu(beacon->high_tsf),
776 le32_to_cpu(beacon->low_tsf), rate);
779 if ((priv->iw_mode == NL80211_IFTYPE_AP) &&
780 (!test_bit(STATUS_EXIT_PENDING, &priv->status)))
781 queue_work(priv->workqueue, &priv->beacon_update);
784 /* Handle notification from uCode that card's power state is changing
785 * due to software, hardware, or critical temperature RFKILL */
786 static void iwl_rx_card_state_notif(struct iwl_priv *priv,
787 struct iwl_rx_mem_buffer *rxb)
789 struct iwl_rx_packet *pkt = rxb_addr(rxb);
790 u32 flags = le32_to_cpu(pkt->u.card_state_notif.flags);
791 unsigned long status = priv->status;
793 IWL_DEBUG_RF_KILL(priv, "Card state received: HW:%s SW:%s CT:%s\n",
794 (flags & HW_CARD_DISABLED) ? "Kill" : "On",
795 (flags & SW_CARD_DISABLED) ? "Kill" : "On",
796 (flags & CT_CARD_DISABLED) ?
797 "Reached" : "Not reached");
799 if (flags & (SW_CARD_DISABLED | HW_CARD_DISABLED |
802 iwl_write32(priv, CSR_UCODE_DRV_GP1_SET,
803 CSR_UCODE_DRV_GP1_BIT_CMD_BLOCKED);
805 iwl_write_direct32(priv, HBUS_TARG_MBX_C,
806 HBUS_TARG_MBX_C_REG_BIT_CMD_BLOCKED);
808 if (!(flags & RXON_CARD_DISABLED)) {
809 iwl_write32(priv, CSR_UCODE_DRV_GP1_CLR,
810 CSR_UCODE_DRV_GP1_BIT_CMD_BLOCKED);
811 iwl_write_direct32(priv, HBUS_TARG_MBX_C,
812 HBUS_TARG_MBX_C_REG_BIT_CMD_BLOCKED);
814 if (flags & CT_CARD_DISABLED)
815 iwl_tt_enter_ct_kill(priv);
817 if (!(flags & CT_CARD_DISABLED))
818 iwl_tt_exit_ct_kill(priv);
820 if (flags & HW_CARD_DISABLED)
821 set_bit(STATUS_RF_KILL_HW, &priv->status);
823 clear_bit(STATUS_RF_KILL_HW, &priv->status);
826 if (!(flags & RXON_CARD_DISABLED))
827 iwl_scan_cancel(priv);
829 if ((test_bit(STATUS_RF_KILL_HW, &status) !=
830 test_bit(STATUS_RF_KILL_HW, &priv->status)))
831 wiphy_rfkill_set_hw_state(priv->hw->wiphy,
832 test_bit(STATUS_RF_KILL_HW, &priv->status));
834 wake_up_interruptible(&priv->wait_command_queue);
837 int iwl_set_pwr_src(struct iwl_priv *priv, enum iwl_pwr_src src)
839 if (src == IWL_PWR_SRC_VAUX) {
840 if (pci_pme_capable(priv->pci_dev, PCI_D3cold))
841 iwl_set_bits_mask_prph(priv, APMG_PS_CTRL_REG,
842 APMG_PS_CTRL_VAL_PWR_SRC_VAUX,
843 ~APMG_PS_CTRL_MSK_PWR_SRC);
845 iwl_set_bits_mask_prph(priv, APMG_PS_CTRL_REG,
846 APMG_PS_CTRL_VAL_PWR_SRC_VMAIN,
847 ~APMG_PS_CTRL_MSK_PWR_SRC);
854 * iwl_setup_rx_handlers - Initialize Rx handler callbacks
856 * Setup the RX handlers for each of the reply types sent from the uCode
859 * This function chains into the hardware specific files for them to setup
860 * any hardware specific handlers as well.
862 static void iwl_setup_rx_handlers(struct iwl_priv *priv)
864 priv->rx_handlers[REPLY_ALIVE] = iwl_rx_reply_alive;
865 priv->rx_handlers[REPLY_ERROR] = iwl_rx_reply_error;
866 priv->rx_handlers[CHANNEL_SWITCH_NOTIFICATION] = iwl_rx_csa;
867 priv->rx_handlers[SPECTRUM_MEASURE_NOTIFICATION] =
868 iwl_rx_spectrum_measure_notif;
869 priv->rx_handlers[PM_SLEEP_NOTIFICATION] = iwl_rx_pm_sleep_notif;
870 priv->rx_handlers[PM_DEBUG_STATISTIC_NOTIFIC] =
871 iwl_rx_pm_debug_statistics_notif;
872 priv->rx_handlers[BEACON_NOTIFICATION] = iwl_rx_beacon_notif;
875 * The same handler is used for both the REPLY to a discrete
876 * statistics request from the host as well as for the periodic
877 * statistics notifications (after received beacons) from the uCode.
879 priv->rx_handlers[REPLY_STATISTICS_CMD] = iwl_reply_statistics;
880 priv->rx_handlers[STATISTICS_NOTIFICATION] = iwl_rx_statistics;
882 iwl_setup_rx_scan_handlers(priv);
884 /* status change handler */
885 priv->rx_handlers[CARD_STATE_NOTIFICATION] = iwl_rx_card_state_notif;
887 priv->rx_handlers[MISSED_BEACONS_NOTIFICATION] =
888 iwl_rx_missed_beacon_notif;
890 priv->rx_handlers[REPLY_RX_PHY_CMD] = iwlagn_rx_reply_rx_phy;
891 priv->rx_handlers[REPLY_RX_MPDU_CMD] = iwlagn_rx_reply_rx;
893 priv->rx_handlers[REPLY_COMPRESSED_BA] = iwlagn_rx_reply_compressed_ba;
894 /* Set up hardware specific Rx handlers */
895 priv->cfg->ops->lib->rx_handler_setup(priv);
899 * iwl_rx_handle - Main entry function for receiving responses from uCode
901 * Uses the priv->rx_handlers callback function array to invoke
902 * the appropriate handlers, including command responses,
903 * frame-received notifications, and other notifications.
905 void iwl_rx_handle(struct iwl_priv *priv)
907 struct iwl_rx_mem_buffer *rxb;
908 struct iwl_rx_packet *pkt;
909 struct iwl_rx_queue *rxq = &priv->rxq;
917 /* uCode's read index (stored in shared DRAM) indicates the last Rx
918 * buffer that the driver may process (last buffer filled by ucode). */
919 r = le16_to_cpu(rxq->rb_stts->closed_rb_num) & 0x0FFF;
922 /* Rx interrupt, but nothing sent from uCode */
924 IWL_DEBUG_RX(priv, "r = %d, i = %d\n", r, i);
926 /* calculate total frames need to be restock after handling RX */
927 total_empty = r - rxq->write_actual;
929 total_empty += RX_QUEUE_SIZE;
931 if (total_empty > (RX_QUEUE_SIZE / 2))
937 /* If an RXB doesn't have a Rx queue slot associated with it,
938 * then a bug has been introduced in the queue refilling
939 * routines -- catch it here */
942 rxq->queue[i] = NULL;
944 pci_unmap_page(priv->pci_dev, rxb->page_dma,
945 PAGE_SIZE << priv->hw_params.rx_page_order,
949 trace_iwlwifi_dev_rx(priv, pkt,
950 le32_to_cpu(pkt->len_n_flags) & FH_RSCSR_FRAME_SIZE_MSK);
952 /* Reclaim a command buffer only if this packet is a response
953 * to a (driver-originated) command.
954 * If the packet (e.g. Rx frame) originated from uCode,
955 * there is no command buffer to reclaim.
956 * Ucode should set SEQ_RX_FRAME bit if ucode-originated,
957 * but apparently a few don't get set; catch them here. */
958 reclaim = !(pkt->hdr.sequence & SEQ_RX_FRAME) &&
959 (pkt->hdr.cmd != REPLY_RX_PHY_CMD) &&
960 (pkt->hdr.cmd != REPLY_RX) &&
961 (pkt->hdr.cmd != REPLY_RX_MPDU_CMD) &&
962 (pkt->hdr.cmd != REPLY_COMPRESSED_BA) &&
963 (pkt->hdr.cmd != STATISTICS_NOTIFICATION) &&
964 (pkt->hdr.cmd != REPLY_TX);
966 /* Based on type of command response or notification,
967 * handle those that need handling via function in
968 * rx_handlers table. See iwl_setup_rx_handlers() */
969 if (priv->rx_handlers[pkt->hdr.cmd]) {
970 IWL_DEBUG_RX(priv, "r = %d, i = %d, %s, 0x%02x\n", r,
971 i, get_cmd_string(pkt->hdr.cmd), pkt->hdr.cmd);
972 priv->isr_stats.rx_handlers[pkt->hdr.cmd]++;
973 priv->rx_handlers[pkt->hdr.cmd] (priv, rxb);
975 /* No handling needed */
977 "r %d i %d No handler needed for %s, 0x%02x\n",
978 r, i, get_cmd_string(pkt->hdr.cmd),
983 * XXX: After here, we should always check rxb->page
984 * against NULL before touching it or its virtual
985 * memory (pkt). Because some rx_handler might have
986 * already taken or freed the pages.
990 /* Invoke any callbacks, transfer the buffer to caller,
991 * and fire off the (possibly) blocking iwl_send_cmd()
992 * as we reclaim the driver command queue */
994 iwl_tx_cmd_complete(priv, rxb);
996 IWL_WARN(priv, "Claim null rxb?\n");
999 /* Reuse the page if possible. For notification packets and
1000 * SKBs that fail to Rx correctly, add them back into the
1001 * rx_free list for reuse later. */
1002 spin_lock_irqsave(&rxq->lock, flags);
1003 if (rxb->page != NULL) {
1004 rxb->page_dma = pci_map_page(priv->pci_dev, rxb->page,
1005 0, PAGE_SIZE << priv->hw_params.rx_page_order,
1006 PCI_DMA_FROMDEVICE);
1007 list_add_tail(&rxb->list, &rxq->rx_free);
1010 list_add_tail(&rxb->list, &rxq->rx_used);
1012 spin_unlock_irqrestore(&rxq->lock, flags);
1014 i = (i + 1) & RX_QUEUE_MASK;
1015 /* If there are a lot of unused frames,
1016 * restock the Rx queue so ucode wont assert. */
1021 iwlagn_rx_replenish_now(priv);
1027 /* Backtrack one entry */
1030 iwlagn_rx_replenish_now(priv);
1032 iwlagn_rx_queue_restock(priv);
1035 /* call this function to flush any scheduled tasklet */
1036 static inline void iwl_synchronize_irq(struct iwl_priv *priv)
1038 /* wait to make sure we flush pending tasklet*/
1039 synchronize_irq(priv->pci_dev->irq);
1040 tasklet_kill(&priv->irq_tasklet);
1043 static void iwl_irq_tasklet_legacy(struct iwl_priv *priv)
1045 u32 inta, handled = 0;
1047 unsigned long flags;
1049 #ifdef CONFIG_IWLWIFI_DEBUG
1053 spin_lock_irqsave(&priv->lock, flags);
1055 /* Ack/clear/reset pending uCode interrupts.
1056 * Note: Some bits in CSR_INT are "OR" of bits in CSR_FH_INT_STATUS,
1057 * and will clear only when CSR_FH_INT_STATUS gets cleared. */
1058 inta = iwl_read32(priv, CSR_INT);
1059 iwl_write32(priv, CSR_INT, inta);
1061 /* Ack/clear/reset pending flow-handler (DMA) interrupts.
1062 * Any new interrupts that happen after this, either while we're
1063 * in this tasklet, or later, will show up in next ISR/tasklet. */
1064 inta_fh = iwl_read32(priv, CSR_FH_INT_STATUS);
1065 iwl_write32(priv, CSR_FH_INT_STATUS, inta_fh);
1067 #ifdef CONFIG_IWLWIFI_DEBUG
1068 if (iwl_get_debug_level(priv) & IWL_DL_ISR) {
1069 /* just for debug */
1070 inta_mask = iwl_read32(priv, CSR_INT_MASK);
1071 IWL_DEBUG_ISR(priv, "inta 0x%08x, enabled 0x%08x, fh 0x%08x\n",
1072 inta, inta_mask, inta_fh);
1076 spin_unlock_irqrestore(&priv->lock, flags);
1078 /* Since CSR_INT and CSR_FH_INT_STATUS reads and clears are not
1079 * atomic, make sure that inta covers all the interrupts that
1080 * we've discovered, even if FH interrupt came in just after
1081 * reading CSR_INT. */
1082 if (inta_fh & CSR49_FH_INT_RX_MASK)
1083 inta |= CSR_INT_BIT_FH_RX;
1084 if (inta_fh & CSR49_FH_INT_TX_MASK)
1085 inta |= CSR_INT_BIT_FH_TX;
1087 /* Now service all interrupt bits discovered above. */
1088 if (inta & CSR_INT_BIT_HW_ERR) {
1089 IWL_ERR(priv, "Hardware error detected. Restarting.\n");
1091 /* Tell the device to stop sending interrupts */
1092 iwl_disable_interrupts(priv);
1094 priv->isr_stats.hw++;
1095 iwl_irq_handle_error(priv);
1097 handled |= CSR_INT_BIT_HW_ERR;
1102 #ifdef CONFIG_IWLWIFI_DEBUG
1103 if (iwl_get_debug_level(priv) & (IWL_DL_ISR)) {
1104 /* NIC fires this, but we don't use it, redundant with WAKEUP */
1105 if (inta & CSR_INT_BIT_SCD) {
1106 IWL_DEBUG_ISR(priv, "Scheduler finished to transmit "
1107 "the frame/frames.\n");
1108 priv->isr_stats.sch++;
1111 /* Alive notification via Rx interrupt will do the real work */
1112 if (inta & CSR_INT_BIT_ALIVE) {
1113 IWL_DEBUG_ISR(priv, "Alive interrupt\n");
1114 priv->isr_stats.alive++;
1118 /* Safely ignore these bits for debug checks below */
1119 inta &= ~(CSR_INT_BIT_SCD | CSR_INT_BIT_ALIVE);
1121 /* HW RF KILL switch toggled */
1122 if (inta & CSR_INT_BIT_RF_KILL) {
1124 if (!(iwl_read32(priv, CSR_GP_CNTRL) &
1125 CSR_GP_CNTRL_REG_FLAG_HW_RF_KILL_SW))
1128 IWL_WARN(priv, "RF_KILL bit toggled to %s.\n",
1129 hw_rf_kill ? "disable radio" : "enable radio");
1131 priv->isr_stats.rfkill++;
1133 /* driver only loads ucode once setting the interface up.
1134 * the driver allows loading the ucode even if the radio
1135 * is killed. Hence update the killswitch state here. The
1136 * rfkill handler will care about restarting if needed.
1138 if (!test_bit(STATUS_ALIVE, &priv->status)) {
1140 set_bit(STATUS_RF_KILL_HW, &priv->status);
1142 clear_bit(STATUS_RF_KILL_HW, &priv->status);
1143 wiphy_rfkill_set_hw_state(priv->hw->wiphy, hw_rf_kill);
1146 handled |= CSR_INT_BIT_RF_KILL;
1149 /* Chip got too hot and stopped itself */
1150 if (inta & CSR_INT_BIT_CT_KILL) {
1151 IWL_ERR(priv, "Microcode CT kill error detected.\n");
1152 priv->isr_stats.ctkill++;
1153 handled |= CSR_INT_BIT_CT_KILL;
1156 /* Error detected by uCode */
1157 if (inta & CSR_INT_BIT_SW_ERR) {
1158 IWL_ERR(priv, "Microcode SW error detected. "
1159 " Restarting 0x%X.\n", inta);
1160 priv->isr_stats.sw++;
1161 priv->isr_stats.sw_err = inta;
1162 iwl_irq_handle_error(priv);
1163 handled |= CSR_INT_BIT_SW_ERR;
1167 * uCode wakes up after power-down sleep.
1168 * Tell device about any new tx or host commands enqueued,
1169 * and about any Rx buffers made available while asleep.
1171 if (inta & CSR_INT_BIT_WAKEUP) {
1172 IWL_DEBUG_ISR(priv, "Wakeup interrupt\n");
1173 iwl_rx_queue_update_write_ptr(priv, &priv->rxq);
1174 for (i = 0; i < priv->hw_params.max_txq_num; i++)
1175 iwl_txq_update_write_ptr(priv, &priv->txq[i]);
1176 priv->isr_stats.wakeup++;
1177 handled |= CSR_INT_BIT_WAKEUP;
1180 /* All uCode command responses, including Tx command responses,
1181 * Rx "responses" (frame-received notification), and other
1182 * notifications from uCode come through here*/
1183 if (inta & (CSR_INT_BIT_FH_RX | CSR_INT_BIT_SW_RX)) {
1184 iwl_rx_handle(priv);
1185 priv->isr_stats.rx++;
1186 handled |= (CSR_INT_BIT_FH_RX | CSR_INT_BIT_SW_RX);
1189 /* This "Tx" DMA channel is used only for loading uCode */
1190 if (inta & CSR_INT_BIT_FH_TX) {
1191 IWL_DEBUG_ISR(priv, "uCode load interrupt\n");
1192 priv->isr_stats.tx++;
1193 handled |= CSR_INT_BIT_FH_TX;
1194 /* Wake up uCode load routine, now that load is complete */
1195 priv->ucode_write_complete = 1;
1196 wake_up_interruptible(&priv->wait_command_queue);
1199 if (inta & ~handled) {
1200 IWL_ERR(priv, "Unhandled INTA bits 0x%08x\n", inta & ~handled);
1201 priv->isr_stats.unhandled++;
1204 if (inta & ~(priv->inta_mask)) {
1205 IWL_WARN(priv, "Disabled INTA bits 0x%08x were pending\n",
1206 inta & ~priv->inta_mask);
1207 IWL_WARN(priv, " with FH_INT = 0x%08x\n", inta_fh);
1210 /* Re-enable all interrupts */
1211 /* only Re-enable if diabled by irq */
1212 if (test_bit(STATUS_INT_ENABLED, &priv->status))
1213 iwl_enable_interrupts(priv);
1215 #ifdef CONFIG_IWLWIFI_DEBUG
1216 if (iwl_get_debug_level(priv) & (IWL_DL_ISR)) {
1217 inta = iwl_read32(priv, CSR_INT);
1218 inta_mask = iwl_read32(priv, CSR_INT_MASK);
1219 inta_fh = iwl_read32(priv, CSR_FH_INT_STATUS);
1220 IWL_DEBUG_ISR(priv, "End inta 0x%08x, enabled 0x%08x, fh 0x%08x, "
1221 "flags 0x%08lx\n", inta, inta_mask, inta_fh, flags);
1226 /* tasklet for iwlagn interrupt */
1227 static void iwl_irq_tasklet(struct iwl_priv *priv)
1231 unsigned long flags;
1233 #ifdef CONFIG_IWLWIFI_DEBUG
1237 spin_lock_irqsave(&priv->lock, flags);
1239 /* Ack/clear/reset pending uCode interrupts.
1240 * Note: Some bits in CSR_INT are "OR" of bits in CSR_FH_INT_STATUS,
1242 /* There is a hardware bug in the interrupt mask function that some
1243 * interrupts (i.e. CSR_INT_BIT_SCD) can still be generated even if
1244 * they are disabled in the CSR_INT_MASK register. Furthermore the
1245 * ICT interrupt handling mechanism has another bug that might cause
1246 * these unmasked interrupts fail to be detected. We workaround the
1247 * hardware bugs here by ACKing all the possible interrupts so that
1248 * interrupt coalescing can still be achieved.
1250 iwl_write32(priv, CSR_INT, priv->_agn.inta | ~priv->inta_mask);
1252 inta = priv->_agn.inta;
1254 #ifdef CONFIG_IWLWIFI_DEBUG
1255 if (iwl_get_debug_level(priv) & IWL_DL_ISR) {
1256 /* just for debug */
1257 inta_mask = iwl_read32(priv, CSR_INT_MASK);
1258 IWL_DEBUG_ISR(priv, "inta 0x%08x, enabled 0x%08x\n ",
1263 spin_unlock_irqrestore(&priv->lock, flags);
1265 /* saved interrupt in inta variable now we can reset priv->_agn.inta */
1266 priv->_agn.inta = 0;
1268 /* Now service all interrupt bits discovered above. */
1269 if (inta & CSR_INT_BIT_HW_ERR) {
1270 IWL_ERR(priv, "Hardware error detected. Restarting.\n");
1272 /* Tell the device to stop sending interrupts */
1273 iwl_disable_interrupts(priv);
1275 priv->isr_stats.hw++;
1276 iwl_irq_handle_error(priv);
1278 handled |= CSR_INT_BIT_HW_ERR;
1283 #ifdef CONFIG_IWLWIFI_DEBUG
1284 if (iwl_get_debug_level(priv) & (IWL_DL_ISR)) {
1285 /* NIC fires this, but we don't use it, redundant with WAKEUP */
1286 if (inta & CSR_INT_BIT_SCD) {
1287 IWL_DEBUG_ISR(priv, "Scheduler finished to transmit "
1288 "the frame/frames.\n");
1289 priv->isr_stats.sch++;
1292 /* Alive notification via Rx interrupt will do the real work */
1293 if (inta & CSR_INT_BIT_ALIVE) {
1294 IWL_DEBUG_ISR(priv, "Alive interrupt\n");
1295 priv->isr_stats.alive++;
1299 /* Safely ignore these bits for debug checks below */
1300 inta &= ~(CSR_INT_BIT_SCD | CSR_INT_BIT_ALIVE);
1302 /* HW RF KILL switch toggled */
1303 if (inta & CSR_INT_BIT_RF_KILL) {
1305 if (!(iwl_read32(priv, CSR_GP_CNTRL) &
1306 CSR_GP_CNTRL_REG_FLAG_HW_RF_KILL_SW))
1309 IWL_WARN(priv, "RF_KILL bit toggled to %s.\n",
1310 hw_rf_kill ? "disable radio" : "enable radio");
1312 priv->isr_stats.rfkill++;
1314 /* driver only loads ucode once setting the interface up.
1315 * the driver allows loading the ucode even if the radio
1316 * is killed. Hence update the killswitch state here. The
1317 * rfkill handler will care about restarting if needed.
1319 if (!test_bit(STATUS_ALIVE, &priv->status)) {
1321 set_bit(STATUS_RF_KILL_HW, &priv->status);
1323 clear_bit(STATUS_RF_KILL_HW, &priv->status);
1324 wiphy_rfkill_set_hw_state(priv->hw->wiphy, hw_rf_kill);
1327 handled |= CSR_INT_BIT_RF_KILL;
1330 /* Chip got too hot and stopped itself */
1331 if (inta & CSR_INT_BIT_CT_KILL) {
1332 IWL_ERR(priv, "Microcode CT kill error detected.\n");
1333 priv->isr_stats.ctkill++;
1334 handled |= CSR_INT_BIT_CT_KILL;
1337 /* Error detected by uCode */
1338 if (inta & CSR_INT_BIT_SW_ERR) {
1339 IWL_ERR(priv, "Microcode SW error detected. "
1340 " Restarting 0x%X.\n", inta);
1341 priv->isr_stats.sw++;
1342 priv->isr_stats.sw_err = inta;
1343 iwl_irq_handle_error(priv);
1344 handled |= CSR_INT_BIT_SW_ERR;
1347 /* uCode wakes up after power-down sleep */
1348 if (inta & CSR_INT_BIT_WAKEUP) {
1349 IWL_DEBUG_ISR(priv, "Wakeup interrupt\n");
1350 iwl_rx_queue_update_write_ptr(priv, &priv->rxq);
1351 for (i = 0; i < priv->hw_params.max_txq_num; i++)
1352 iwl_txq_update_write_ptr(priv, &priv->txq[i]);
1354 priv->isr_stats.wakeup++;
1356 handled |= CSR_INT_BIT_WAKEUP;
1359 /* All uCode command responses, including Tx command responses,
1360 * Rx "responses" (frame-received notification), and other
1361 * notifications from uCode come through here*/
1362 if (inta & (CSR_INT_BIT_FH_RX | CSR_INT_BIT_SW_RX |
1363 CSR_INT_BIT_RX_PERIODIC)) {
1364 IWL_DEBUG_ISR(priv, "Rx interrupt\n");
1365 if (inta & (CSR_INT_BIT_FH_RX | CSR_INT_BIT_SW_RX)) {
1366 handled |= (CSR_INT_BIT_FH_RX | CSR_INT_BIT_SW_RX);
1367 iwl_write32(priv, CSR_FH_INT_STATUS,
1368 CSR49_FH_INT_RX_MASK);
1370 if (inta & CSR_INT_BIT_RX_PERIODIC) {
1371 handled |= CSR_INT_BIT_RX_PERIODIC;
1372 iwl_write32(priv, CSR_INT, CSR_INT_BIT_RX_PERIODIC);
1374 /* Sending RX interrupt require many steps to be done in the
1376 * 1- write interrupt to current index in ICT table.
1378 * 3- update RX shared data to indicate last write index.
1379 * 4- send interrupt.
1380 * This could lead to RX race, driver could receive RX interrupt
1381 * but the shared data changes does not reflect this;
1382 * periodic interrupt will detect any dangling Rx activity.
1385 /* Disable periodic interrupt; we use it as just a one-shot. */
1386 iwl_write8(priv, CSR_INT_PERIODIC_REG,
1387 CSR_INT_PERIODIC_DIS);
1388 iwl_rx_handle(priv);
1391 * Enable periodic interrupt in 8 msec only if we received
1392 * real RX interrupt (instead of just periodic int), to catch
1393 * any dangling Rx interrupt. If it was just the periodic
1394 * interrupt, there was no dangling Rx activity, and no need
1395 * to extend the periodic interrupt; one-shot is enough.
1397 if (inta & (CSR_INT_BIT_FH_RX | CSR_INT_BIT_SW_RX))
1398 iwl_write8(priv, CSR_INT_PERIODIC_REG,
1399 CSR_INT_PERIODIC_ENA);
1401 priv->isr_stats.rx++;
1404 /* This "Tx" DMA channel is used only for loading uCode */
1405 if (inta & CSR_INT_BIT_FH_TX) {
1406 iwl_write32(priv, CSR_FH_INT_STATUS, CSR49_FH_INT_TX_MASK);
1407 IWL_DEBUG_ISR(priv, "uCode load interrupt\n");
1408 priv->isr_stats.tx++;
1409 handled |= CSR_INT_BIT_FH_TX;
1410 /* Wake up uCode load routine, now that load is complete */
1411 priv->ucode_write_complete = 1;
1412 wake_up_interruptible(&priv->wait_command_queue);
1415 if (inta & ~handled) {
1416 IWL_ERR(priv, "Unhandled INTA bits 0x%08x\n", inta & ~handled);
1417 priv->isr_stats.unhandled++;
1420 if (inta & ~(priv->inta_mask)) {
1421 IWL_WARN(priv, "Disabled INTA bits 0x%08x were pending\n",
1422 inta & ~priv->inta_mask);
1425 /* Re-enable all interrupts */
1426 /* only Re-enable if diabled by irq */
1427 if (test_bit(STATUS_INT_ENABLED, &priv->status))
1428 iwl_enable_interrupts(priv);
1431 /* the threshold ratio of actual_ack_cnt to expected_ack_cnt in percent */
1432 #define ACK_CNT_RATIO (50)
1433 #define BA_TIMEOUT_CNT (5)
1434 #define BA_TIMEOUT_MAX (16)
1437 * iwl_good_ack_health - checks for ACK count ratios, BA timeout retries.
1439 * When the ACK count ratio is 0 and aggregated BA timeout retries exceeding
1440 * the BA_TIMEOUT_MAX, reload firmware and bring system back to normal
1443 bool iwl_good_ack_health(struct iwl_priv *priv,
1444 struct iwl_rx_packet *pkt)
1447 int actual_ack_cnt_delta, expected_ack_cnt_delta;
1448 int ba_timeout_delta;
1450 actual_ack_cnt_delta =
1451 le32_to_cpu(pkt->u.stats.tx.actual_ack_cnt) -
1452 le32_to_cpu(priv->statistics.tx.actual_ack_cnt);
1453 expected_ack_cnt_delta =
1454 le32_to_cpu(pkt->u.stats.tx.expected_ack_cnt) -
1455 le32_to_cpu(priv->statistics.tx.expected_ack_cnt);
1457 le32_to_cpu(pkt->u.stats.tx.agg.ba_timeout) -
1458 le32_to_cpu(priv->statistics.tx.agg.ba_timeout);
1459 if ((priv->_agn.agg_tids_count > 0) &&
1460 (expected_ack_cnt_delta > 0) &&
1461 (((actual_ack_cnt_delta * 100) / expected_ack_cnt_delta)
1463 (ba_timeout_delta > BA_TIMEOUT_CNT)) {
1464 IWL_DEBUG_RADIO(priv, "actual_ack_cnt delta = %d,"
1465 " expected_ack_cnt = %d\n",
1466 actual_ack_cnt_delta, expected_ack_cnt_delta);
1468 #ifdef CONFIG_IWLWIFI_DEBUG
1469 IWL_DEBUG_RADIO(priv, "rx_detected_cnt delta = %d\n",
1470 priv->delta_statistics.tx.rx_detected_cnt);
1471 IWL_DEBUG_RADIO(priv,
1472 "ack_or_ba_timeout_collision delta = %d\n",
1473 priv->delta_statistics.tx.
1474 ack_or_ba_timeout_collision);
1476 IWL_DEBUG_RADIO(priv, "agg ba_timeout delta = %d\n",
1478 if (!actual_ack_cnt_delta &&
1479 (ba_timeout_delta >= BA_TIMEOUT_MAX))
1486 /******************************************************************************
1488 * uCode download functions
1490 ******************************************************************************/
1492 static void iwl_dealloc_ucode_pci(struct iwl_priv *priv)
1494 iwl_free_fw_desc(priv->pci_dev, &priv->ucode_code);
1495 iwl_free_fw_desc(priv->pci_dev, &priv->ucode_data);
1496 iwl_free_fw_desc(priv->pci_dev, &priv->ucode_data_backup);
1497 iwl_free_fw_desc(priv->pci_dev, &priv->ucode_init);
1498 iwl_free_fw_desc(priv->pci_dev, &priv->ucode_init_data);
1499 iwl_free_fw_desc(priv->pci_dev, &priv->ucode_boot);
1502 static void iwl_nic_start(struct iwl_priv *priv)
1504 /* Remove all resets to allow NIC to operate */
1505 iwl_write32(priv, CSR_RESET, 0);
1509 static void iwl_ucode_callback(const struct firmware *ucode_raw, void *context);
1510 static int iwl_mac_setup_register(struct iwl_priv *priv);
1512 static int __must_check iwl_request_firmware(struct iwl_priv *priv, bool first)
1514 const char *name_pre = priv->cfg->fw_name_pre;
1517 priv->fw_index = priv->cfg->ucode_api_max;
1521 if (priv->fw_index < priv->cfg->ucode_api_min) {
1522 IWL_ERR(priv, "no suitable firmware found!\n");
1526 sprintf(priv->firmware_name, "%s%d%s",
1527 name_pre, priv->fw_index, ".ucode");
1529 IWL_DEBUG_INFO(priv, "attempting to load firmware '%s'\n",
1530 priv->firmware_name);
1532 return request_firmware_nowait(THIS_MODULE, 1, priv->firmware_name,
1533 &priv->pci_dev->dev, GFP_KERNEL, priv,
1534 iwl_ucode_callback);
1538 * iwl_ucode_callback - callback when firmware was loaded
1540 * If loaded successfully, copies the firmware into buffers
1541 * for the card to fetch (via DMA).
1543 static void iwl_ucode_callback(const struct firmware *ucode_raw, void *context)
1545 struct iwl_priv *priv = context;
1546 struct iwl_ucode_header *ucode;
1547 const unsigned int api_max = priv->cfg->ucode_api_max;
1548 const unsigned int api_min = priv->cfg->ucode_api_min;
1552 u32 inst_size, data_size, init_size, init_data_size, boot_size;
1557 IWL_ERR(priv, "request for firmware file '%s' failed.\n",
1558 priv->firmware_name);
1562 IWL_DEBUG_INFO(priv, "Loaded firmware file '%s' (%zd bytes).\n",
1563 priv->firmware_name, ucode_raw->size);
1565 /* Make sure that we got at least the v1 header! */
1566 if (ucode_raw->size < priv->cfg->ops->ucode->get_header_size(1)) {
1567 IWL_ERR(priv, "File size way too small!\n");
1571 /* Data from ucode file: header followed by uCode images */
1572 ucode = (struct iwl_ucode_header *)ucode_raw->data;
1574 priv->ucode_ver = le32_to_cpu(ucode->ver);
1575 api_ver = IWL_UCODE_API(priv->ucode_ver);
1576 build = priv->cfg->ops->ucode->get_build(ucode, api_ver);
1577 inst_size = priv->cfg->ops->ucode->get_inst_size(ucode, api_ver);
1578 data_size = priv->cfg->ops->ucode->get_data_size(ucode, api_ver);
1579 init_size = priv->cfg->ops->ucode->get_init_size(ucode, api_ver);
1581 priv->cfg->ops->ucode->get_init_data_size(ucode, api_ver);
1582 boot_size = priv->cfg->ops->ucode->get_boot_size(ucode, api_ver);
1583 src = priv->cfg->ops->ucode->get_data(ucode, api_ver);
1585 /* api_ver should match the api version forming part of the
1586 * firmware filename ... but we don't check for that and only rely
1587 * on the API version read from firmware header from here on forward */
1589 if (api_ver < api_min || api_ver > api_max) {
1590 IWL_ERR(priv, "Driver unable to support your firmware API. "
1591 "Driver supports v%u, firmware is v%u.\n",
1596 if (api_ver != api_max)
1597 IWL_ERR(priv, "Firmware has old API version. Expected v%u, "
1598 "got v%u. New firmware can be obtained "
1599 "from http://www.intellinuxwireless.org.\n",
1602 IWL_INFO(priv, "loaded firmware version %u.%u.%u.%u\n",
1603 IWL_UCODE_MAJOR(priv->ucode_ver),
1604 IWL_UCODE_MINOR(priv->ucode_ver),
1605 IWL_UCODE_API(priv->ucode_ver),
1606 IWL_UCODE_SERIAL(priv->ucode_ver));
1608 snprintf(priv->hw->wiphy->fw_version,
1609 sizeof(priv->hw->wiphy->fw_version),
1611 IWL_UCODE_MAJOR(priv->ucode_ver),
1612 IWL_UCODE_MINOR(priv->ucode_ver),
1613 IWL_UCODE_API(priv->ucode_ver),
1614 IWL_UCODE_SERIAL(priv->ucode_ver));
1617 IWL_DEBUG_INFO(priv, "Build %u\n", build);
1619 eeprom_ver = iwl_eeprom_query16(priv, EEPROM_VERSION);
1620 IWL_DEBUG_INFO(priv, "NVM Type: %s, version: 0x%x\n",
1621 (priv->nvm_device_type == NVM_DEVICE_TYPE_OTP)
1622 ? "OTP" : "EEPROM", eeprom_ver);
1624 IWL_DEBUG_INFO(priv, "f/w package hdr ucode version raw = 0x%x\n",
1626 IWL_DEBUG_INFO(priv, "f/w package hdr runtime inst size = %u\n",
1628 IWL_DEBUG_INFO(priv, "f/w package hdr runtime data size = %u\n",
1630 IWL_DEBUG_INFO(priv, "f/w package hdr init inst size = %u\n",
1632 IWL_DEBUG_INFO(priv, "f/w package hdr init data size = %u\n",
1634 IWL_DEBUG_INFO(priv, "f/w package hdr boot inst size = %u\n",
1638 * For any of the failures below (before allocating pci memory)
1639 * we will try to load a version with a smaller API -- maybe the
1640 * user just got a corrupted version of the latest API.
1643 /* Verify size of file vs. image size info in file's header */
1644 if (ucode_raw->size !=
1645 priv->cfg->ops->ucode->get_header_size(api_ver) +
1646 inst_size + data_size + init_size +
1647 init_data_size + boot_size) {
1649 IWL_DEBUG_INFO(priv,
1650 "uCode file size %d does not match expected size\n",
1651 (int)ucode_raw->size);
1655 /* Verify that uCode images will fit in card's SRAM */
1656 if (inst_size > priv->hw_params.max_inst_size) {
1657 IWL_DEBUG_INFO(priv, "uCode instr len %d too large to fit in\n",
1662 if (data_size > priv->hw_params.max_data_size) {
1663 IWL_DEBUG_INFO(priv, "uCode data len %d too large to fit in\n",
1667 if (init_size > priv->hw_params.max_inst_size) {
1668 IWL_INFO(priv, "uCode init instr len %d too large to fit in\n",
1672 if (init_data_size > priv->hw_params.max_data_size) {
1673 IWL_INFO(priv, "uCode init data len %d too large to fit in\n",
1677 if (boot_size > priv->hw_params.max_bsm_size) {
1678 IWL_INFO(priv, "uCode boot instr len %d too large to fit in\n",
1683 /* Allocate ucode buffers for card's bus-master loading ... */
1685 /* Runtime instructions and 2 copies of data:
1686 * 1) unmodified from disk
1687 * 2) backup cache for save/restore during power-downs */
1688 priv->ucode_code.len = inst_size;
1689 iwl_alloc_fw_desc(priv->pci_dev, &priv->ucode_code);
1691 priv->ucode_data.len = data_size;
1692 iwl_alloc_fw_desc(priv->pci_dev, &priv->ucode_data);
1694 priv->ucode_data_backup.len = data_size;
1695 iwl_alloc_fw_desc(priv->pci_dev, &priv->ucode_data_backup);
1697 if (!priv->ucode_code.v_addr || !priv->ucode_data.v_addr ||
1698 !priv->ucode_data_backup.v_addr)
1701 /* Initialization instructions and data */
1702 if (init_size && init_data_size) {
1703 priv->ucode_init.len = init_size;
1704 iwl_alloc_fw_desc(priv->pci_dev, &priv->ucode_init);
1706 priv->ucode_init_data.len = init_data_size;
1707 iwl_alloc_fw_desc(priv->pci_dev, &priv->ucode_init_data);
1709 if (!priv->ucode_init.v_addr || !priv->ucode_init_data.v_addr)
1713 /* Bootstrap (instructions only, no data) */
1715 priv->ucode_boot.len = boot_size;
1716 iwl_alloc_fw_desc(priv->pci_dev, &priv->ucode_boot);
1718 if (!priv->ucode_boot.v_addr)
1722 /* Copy images into buffers for card's bus-master reads ... */
1724 /* Runtime instructions (first block of data in file) */
1726 IWL_DEBUG_INFO(priv, "Copying (but not loading) uCode instr len %Zd\n", len);
1727 memcpy(priv->ucode_code.v_addr, src, len);
1730 IWL_DEBUG_INFO(priv, "uCode instr buf vaddr = 0x%p, paddr = 0x%08x\n",
1731 priv->ucode_code.v_addr, (u32)priv->ucode_code.p_addr);
1733 /* Runtime data (2nd block)
1734 * NOTE: Copy into backup buffer will be done in iwl_up() */
1736 IWL_DEBUG_INFO(priv, "Copying (but not loading) uCode data len %Zd\n", len);
1737 memcpy(priv->ucode_data.v_addr, src, len);
1738 memcpy(priv->ucode_data_backup.v_addr, src, len);
1741 /* Initialization instructions (3rd block) */
1744 IWL_DEBUG_INFO(priv, "Copying (but not loading) init instr len %Zd\n",
1746 memcpy(priv->ucode_init.v_addr, src, len);
1750 /* Initialization data (4th block) */
1751 if (init_data_size) {
1752 len = init_data_size;
1753 IWL_DEBUG_INFO(priv, "Copying (but not loading) init data len %Zd\n",
1755 memcpy(priv->ucode_init_data.v_addr, src, len);
1759 /* Bootstrap instructions (5th block) */
1761 IWL_DEBUG_INFO(priv, "Copying (but not loading) boot instr len %Zd\n", len);
1762 memcpy(priv->ucode_boot.v_addr, src, len);
1764 /**************************************************
1765 * This is still part of probe() in a sense...
1767 * 9. Setup and register with mac80211 and debugfs
1768 **************************************************/
1769 err = iwl_mac_setup_register(priv);
1773 err = iwl_dbgfs_register(priv, DRV_NAME);
1775 IWL_ERR(priv, "failed to create debugfs files. Ignoring error: %d\n", err);
1777 /* We have our copies now, allow OS release its copies */
1778 release_firmware(ucode_raw);
1782 /* try next, if any */
1783 if (iwl_request_firmware(priv, false))
1785 release_firmware(ucode_raw);
1789 IWL_ERR(priv, "failed to allocate pci memory\n");
1790 iwl_dealloc_ucode_pci(priv);
1792 device_release_driver(&priv->pci_dev->dev);
1793 release_firmware(ucode_raw);
1796 static const char *desc_lookup_text[] = {
1801 "NMI_INTERRUPT_WDG",
1805 "HW_ERROR_TUNE_LOCK",
1806 "HW_ERROR_TEMPERATURE",
1807 "ILLEGAL_CHAN_FREQ",
1810 "NMI_INTERRUPT_HOST",
1811 "NMI_INTERRUPT_ACTION_PT",
1812 "NMI_INTERRUPT_UNKNOWN",
1813 "UCODE_VERSION_MISMATCH",
1814 "HW_ERROR_ABS_LOCK",
1815 "HW_ERROR_CAL_LOCK_FAIL",
1816 "NMI_INTERRUPT_INST_ACTION_PT",
1817 "NMI_INTERRUPT_DATA_ACTION_PT",
1819 "NMI_INTERRUPT_TRM",
1820 "NMI_INTERRUPT_BREAK_POINT"
1825 "ADVANCED SYSASSERT"
1828 static const char *desc_lookup(int i)
1830 int max = ARRAY_SIZE(desc_lookup_text) - 1;
1832 if (i < 0 || i > max)
1835 return desc_lookup_text[i];
1838 #define ERROR_START_OFFSET (1 * sizeof(u32))
1839 #define ERROR_ELEM_SIZE (7 * sizeof(u32))
1841 void iwl_dump_nic_error_log(struct iwl_priv *priv)
1844 u32 desc, time, count, base, data1;
1845 u32 blink1, blink2, ilink1, ilink2;
1848 if (priv->ucode_type == UCODE_INIT)
1849 base = le32_to_cpu(priv->card_alive_init.error_event_table_ptr);
1851 base = le32_to_cpu(priv->card_alive.error_event_table_ptr);
1853 if (!priv->cfg->ops->lib->is_valid_rtc_data_addr(base)) {
1855 "Not valid error log pointer 0x%08X for %s uCode\n",
1856 base, (priv->ucode_type == UCODE_INIT) ? "Init" : "RT");
1860 count = iwl_read_targ_mem(priv, base);
1862 if (ERROR_START_OFFSET <= count * ERROR_ELEM_SIZE) {
1863 IWL_ERR(priv, "Start IWL Error Log Dump:\n");
1864 IWL_ERR(priv, "Status: 0x%08lX, count: %d\n",
1865 priv->status, count);
1868 desc = iwl_read_targ_mem(priv, base + 1 * sizeof(u32));
1869 pc = iwl_read_targ_mem(priv, base + 2 * sizeof(u32));
1870 blink1 = iwl_read_targ_mem(priv, base + 3 * sizeof(u32));
1871 blink2 = iwl_read_targ_mem(priv, base + 4 * sizeof(u32));
1872 ilink1 = iwl_read_targ_mem(priv, base + 5 * sizeof(u32));
1873 ilink2 = iwl_read_targ_mem(priv, base + 6 * sizeof(u32));
1874 data1 = iwl_read_targ_mem(priv, base + 7 * sizeof(u32));
1875 data2 = iwl_read_targ_mem(priv, base + 8 * sizeof(u32));
1876 line = iwl_read_targ_mem(priv, base + 9 * sizeof(u32));
1877 time = iwl_read_targ_mem(priv, base + 11 * sizeof(u32));
1878 hcmd = iwl_read_targ_mem(priv, base + 22 * sizeof(u32));
1880 trace_iwlwifi_dev_ucode_error(priv, desc, time, data1, data2, line,
1881 blink1, blink2, ilink1, ilink2);
1883 IWL_ERR(priv, "Desc Time "
1884 "data1 data2 line\n");
1885 IWL_ERR(priv, "%-28s (#%02d) %010u 0x%08X 0x%08X %u\n",
1886 desc_lookup(desc), desc, time, data1, data2, line);
1887 IWL_ERR(priv, "pc blink1 blink2 ilink1 ilink2 hcmd\n");
1888 IWL_ERR(priv, "0x%05X 0x%05X 0x%05X 0x%05X 0x%05X 0x%05X\n",
1889 pc, blink1, blink2, ilink1, ilink2, hcmd);
1892 #define EVENT_START_OFFSET (4 * sizeof(u32))
1895 * iwl_print_event_log - Dump error event log to syslog
1898 static int iwl_print_event_log(struct iwl_priv *priv, u32 start_idx,
1899 u32 num_events, u32 mode,
1900 int pos, char **buf, size_t bufsz)
1903 u32 base; /* SRAM byte address of event log header */
1904 u32 event_size; /* 2 u32s, or 3 u32s if timestamp recorded */
1905 u32 ptr; /* SRAM byte address of log data */
1906 u32 ev, time, data; /* event log data */
1907 unsigned long reg_flags;
1909 if (num_events == 0)
1911 if (priv->ucode_type == UCODE_INIT)
1912 base = le32_to_cpu(priv->card_alive_init.log_event_table_ptr);
1914 base = le32_to_cpu(priv->card_alive.log_event_table_ptr);
1917 event_size = 2 * sizeof(u32);
1919 event_size = 3 * sizeof(u32);
1921 ptr = base + EVENT_START_OFFSET + (start_idx * event_size);
1923 /* Make sure device is powered up for SRAM reads */
1924 spin_lock_irqsave(&priv->reg_lock, reg_flags);
1925 iwl_grab_nic_access(priv);
1927 /* Set starting address; reads will auto-increment */
1928 _iwl_write_direct32(priv, HBUS_TARG_MEM_RADDR, ptr);
1931 /* "time" is actually "data" for mode 0 (no timestamp).
1932 * place event id # at far right for easier visual parsing. */
1933 for (i = 0; i < num_events; i++) {
1934 ev = _iwl_read_direct32(priv, HBUS_TARG_MEM_RDAT);
1935 time = _iwl_read_direct32(priv, HBUS_TARG_MEM_RDAT);
1939 pos += scnprintf(*buf + pos, bufsz - pos,
1940 "EVT_LOG:0x%08x:%04u\n",
1943 trace_iwlwifi_dev_ucode_event(priv, 0,
1945 IWL_ERR(priv, "EVT_LOG:0x%08x:%04u\n",
1949 data = _iwl_read_direct32(priv, HBUS_TARG_MEM_RDAT);
1951 pos += scnprintf(*buf + pos, bufsz - pos,
1952 "EVT_LOGT:%010u:0x%08x:%04u\n",
1955 IWL_ERR(priv, "EVT_LOGT:%010u:0x%08x:%04u\n",
1957 trace_iwlwifi_dev_ucode_event(priv, time,
1963 /* Allow device to power down */
1964 iwl_release_nic_access(priv);
1965 spin_unlock_irqrestore(&priv->reg_lock, reg_flags);
1970 * iwl_print_last_event_logs - Dump the newest # of event log to syslog
1972 static int iwl_print_last_event_logs(struct iwl_priv *priv, u32 capacity,
1973 u32 num_wraps, u32 next_entry,
1975 int pos, char **buf, size_t bufsz)
1978 * display the newest DEFAULT_LOG_ENTRIES entries
1979 * i.e the entries just before the next ont that uCode would fill.
1982 if (next_entry < size) {
1983 pos = iwl_print_event_log(priv,
1984 capacity - (size - next_entry),
1985 size - next_entry, mode,
1987 pos = iwl_print_event_log(priv, 0,
1991 pos = iwl_print_event_log(priv, next_entry - size,
1992 size, mode, pos, buf, bufsz);
1994 if (next_entry < size) {
1995 pos = iwl_print_event_log(priv, 0, next_entry,
1996 mode, pos, buf, bufsz);
1998 pos = iwl_print_event_log(priv, next_entry - size,
1999 size, mode, pos, buf, bufsz);
2005 #define DEFAULT_DUMP_EVENT_LOG_ENTRIES (20)
2007 int iwl_dump_nic_event_log(struct iwl_priv *priv, bool full_log,
2008 char **buf, bool display)
2010 u32 base; /* SRAM byte address of event log header */
2011 u32 capacity; /* event log capacity in # entries */
2012 u32 mode; /* 0 - no timestamp, 1 - timestamp recorded */
2013 u32 num_wraps; /* # times uCode wrapped to top of log */
2014 u32 next_entry; /* index of next entry to be written by uCode */
2015 u32 size; /* # entries that we'll print */
2019 if (priv->ucode_type == UCODE_INIT)
2020 base = le32_to_cpu(priv->card_alive_init.log_event_table_ptr);
2022 base = le32_to_cpu(priv->card_alive.log_event_table_ptr);
2024 if (!priv->cfg->ops->lib->is_valid_rtc_data_addr(base)) {
2026 "Invalid event log pointer 0x%08X for %s uCode\n",
2027 base, (priv->ucode_type == UCODE_INIT) ? "Init" : "RT");
2031 /* event log header */
2032 capacity = iwl_read_targ_mem(priv, base);
2033 mode = iwl_read_targ_mem(priv, base + (1 * sizeof(u32)));
2034 num_wraps = iwl_read_targ_mem(priv, base + (2 * sizeof(u32)));
2035 next_entry = iwl_read_targ_mem(priv, base + (3 * sizeof(u32)));
2037 if (capacity > priv->cfg->max_event_log_size) {
2038 IWL_ERR(priv, "Log capacity %d is bogus, limit to %d entries\n",
2039 capacity, priv->cfg->max_event_log_size);
2040 capacity = priv->cfg->max_event_log_size;
2043 if (next_entry > priv->cfg->max_event_log_size) {
2044 IWL_ERR(priv, "Log write index %d is bogus, limit to %d\n",
2045 next_entry, priv->cfg->max_event_log_size);
2046 next_entry = priv->cfg->max_event_log_size;
2049 size = num_wraps ? capacity : next_entry;
2051 /* bail out if nothing in log */
2053 IWL_ERR(priv, "Start IWL Event Log Dump: nothing in log\n");
2057 #ifdef CONFIG_IWLWIFI_DEBUG
2058 if (!(iwl_get_debug_level(priv) & IWL_DL_FW_ERRORS) && !full_log)
2059 size = (size > DEFAULT_DUMP_EVENT_LOG_ENTRIES)
2060 ? DEFAULT_DUMP_EVENT_LOG_ENTRIES : size;
2062 size = (size > DEFAULT_DUMP_EVENT_LOG_ENTRIES)
2063 ? DEFAULT_DUMP_EVENT_LOG_ENTRIES : size;
2065 IWL_ERR(priv, "Start IWL Event Log Dump: display last %u entries\n",
2068 #ifdef CONFIG_IWLWIFI_DEBUG
2071 bufsz = capacity * 48;
2074 *buf = kmalloc(bufsz, GFP_KERNEL);
2078 if ((iwl_get_debug_level(priv) & IWL_DL_FW_ERRORS) || full_log) {
2080 * if uCode has wrapped back to top of log,
2081 * start at the oldest entry,
2082 * i.e the next one that uCode would fill.
2085 pos = iwl_print_event_log(priv, next_entry,
2086 capacity - next_entry, mode,
2088 /* (then/else) start at top of log */
2089 pos = iwl_print_event_log(priv, 0,
2090 next_entry, mode, pos, buf, bufsz);
2092 pos = iwl_print_last_event_logs(priv, capacity, num_wraps,
2093 next_entry, size, mode,
2096 pos = iwl_print_last_event_logs(priv, capacity, num_wraps,
2097 next_entry, size, mode,
2104 * iwl_alive_start - called after REPLY_ALIVE notification received
2105 * from protocol/runtime uCode (initialization uCode's
2106 * Alive gets handled by iwl_init_alive_start()).
2108 static void iwl_alive_start(struct iwl_priv *priv)
2112 IWL_DEBUG_INFO(priv, "Runtime Alive received.\n");
2114 if (priv->card_alive.is_valid != UCODE_VALID_OK) {
2115 /* We had an error bringing up the hardware, so take it
2116 * all the way back down so we can try again */
2117 IWL_DEBUG_INFO(priv, "Alive failed.\n");
2121 /* Initialize uCode has loaded Runtime uCode ... verify inst image.
2122 * This is a paranoid check, because we would not have gotten the
2123 * "runtime" alive if code weren't properly loaded. */
2124 if (iwl_verify_ucode(priv)) {
2125 /* Runtime instruction load was bad;
2126 * take it all the way back down so we can try again */
2127 IWL_DEBUG_INFO(priv, "Bad runtime uCode load.\n");
2131 ret = priv->cfg->ops->lib->alive_notify(priv);
2134 "Could not complete ALIVE transition [ntf]: %d\n", ret);
2138 /* After the ALIVE response, we can send host commands to the uCode */
2139 set_bit(STATUS_ALIVE, &priv->status);
2141 if (priv->cfg->ops->lib->recover_from_tx_stall) {
2142 /* Enable timer to monitor the driver queues */
2143 mod_timer(&priv->monitor_recover,
2145 msecs_to_jiffies(priv->cfg->monitor_recover_period));
2148 if (iwl_is_rfkill(priv))
2151 ieee80211_wake_queues(priv->hw);
2153 priv->active_rate = IWL_RATES_MASK;
2155 /* Configure Tx antenna selection based on H/W config */
2156 if (priv->cfg->ops->hcmd->set_tx_ant)
2157 priv->cfg->ops->hcmd->set_tx_ant(priv, priv->cfg->valid_tx_ant);
2159 if (iwl_is_associated(priv)) {
2160 struct iwl_rxon_cmd *active_rxon =
2161 (struct iwl_rxon_cmd *)&priv->active_rxon;
2162 /* apply any changes in staging */
2163 priv->staging_rxon.filter_flags |= RXON_FILTER_ASSOC_MSK;
2164 active_rxon->filter_flags &= ~RXON_FILTER_ASSOC_MSK;
2166 /* Initialize our rx_config data */
2167 iwl_connection_init_rx_config(priv, priv->iw_mode);
2169 if (priv->cfg->ops->hcmd->set_rxon_chain)
2170 priv->cfg->ops->hcmd->set_rxon_chain(priv);
2172 memcpy(priv->staging_rxon.node_addr, priv->mac_addr, ETH_ALEN);
2175 /* Configure Bluetooth device coexistence support */
2176 iwl_send_bt_config(priv);
2178 iwl_reset_run_time_calib(priv);
2180 /* Configure the adapter for unassociated operation */
2181 iwlcore_commit_rxon(priv);
2183 /* At this point, the NIC is initialized and operational */
2184 iwl_rf_kill_ct_config(priv);
2186 iwl_leds_init(priv);
2188 IWL_DEBUG_INFO(priv, "ALIVE processing complete.\n");
2189 set_bit(STATUS_READY, &priv->status);
2190 wake_up_interruptible(&priv->wait_command_queue);
2192 iwl_power_update_mode(priv, true);
2193 IWL_DEBUG_INFO(priv, "Updated power mode\n");
2199 queue_work(priv->workqueue, &priv->restart);
2202 static void iwl_cancel_deferred_work(struct iwl_priv *priv);
2204 static void __iwl_down(struct iwl_priv *priv)
2206 unsigned long flags;
2207 int exit_pending = test_bit(STATUS_EXIT_PENDING, &priv->status);
2209 IWL_DEBUG_INFO(priv, DRV_NAME " is going down\n");
2212 set_bit(STATUS_EXIT_PENDING, &priv->status);
2214 iwl_clear_ucode_stations(priv, true);
2216 /* Unblock any waiting calls */
2217 wake_up_interruptible_all(&priv->wait_command_queue);
2219 /* Wipe out the EXIT_PENDING status bit if we are not actually
2220 * exiting the module */
2222 clear_bit(STATUS_EXIT_PENDING, &priv->status);
2224 /* stop and reset the on-board processor */
2225 iwl_write32(priv, CSR_RESET, CSR_RESET_REG_FLAG_NEVO_RESET);
2227 /* tell the device to stop sending interrupts */
2228 spin_lock_irqsave(&priv->lock, flags);
2229 iwl_disable_interrupts(priv);
2230 spin_unlock_irqrestore(&priv->lock, flags);
2231 iwl_synchronize_irq(priv);
2233 if (priv->mac80211_registered)
2234 ieee80211_stop_queues(priv->hw);
2236 /* If we have not previously called iwl_init() then
2237 * clear all bits but the RF Kill bit and return */
2238 if (!iwl_is_init(priv)) {
2239 priv->status = test_bit(STATUS_RF_KILL_HW, &priv->status) <<
2241 test_bit(STATUS_GEO_CONFIGURED, &priv->status) <<
2242 STATUS_GEO_CONFIGURED |
2243 test_bit(STATUS_EXIT_PENDING, &priv->status) <<
2244 STATUS_EXIT_PENDING;
2248 /* ...otherwise clear out all the status bits but the RF Kill
2249 * bit and continue taking the NIC down. */
2250 priv->status &= test_bit(STATUS_RF_KILL_HW, &priv->status) <<
2252 test_bit(STATUS_GEO_CONFIGURED, &priv->status) <<
2253 STATUS_GEO_CONFIGURED |
2254 test_bit(STATUS_FW_ERROR, &priv->status) <<
2256 test_bit(STATUS_EXIT_PENDING, &priv->status) <<
2257 STATUS_EXIT_PENDING;
2259 /* device going down, Stop using ICT table */
2260 iwl_disable_ict(priv);
2262 iwlagn_txq_ctx_stop(priv);
2263 iwlagn_rxq_stop(priv);
2265 /* Power-down device's busmaster DMA clocks */
2266 iwl_write_prph(priv, APMG_CLK_DIS_REG, APMG_CLK_VAL_DMA_CLK_RQT);
2269 /* Make sure (redundant) we've released our request to stay awake */
2270 iwl_clear_bit(priv, CSR_GP_CNTRL, CSR_GP_CNTRL_REG_FLAG_MAC_ACCESS_REQ);
2272 /* Stop the device, and put it in low power state */
2273 priv->cfg->ops->lib->apm_ops.stop(priv);
2276 memset(&priv->card_alive, 0, sizeof(struct iwl_alive_resp));
2278 if (priv->ibss_beacon)
2279 dev_kfree_skb(priv->ibss_beacon);
2280 priv->ibss_beacon = NULL;
2282 /* clear out any free frames */
2283 iwl_clear_free_frames(priv);
2286 static void iwl_down(struct iwl_priv *priv)
2288 mutex_lock(&priv->mutex);
2290 mutex_unlock(&priv->mutex);
2292 iwl_cancel_deferred_work(priv);
2295 #define HW_READY_TIMEOUT (50)
2297 static int iwl_set_hw_ready(struct iwl_priv *priv)
2301 iwl_set_bit(priv, CSR_HW_IF_CONFIG_REG,
2302 CSR_HW_IF_CONFIG_REG_BIT_NIC_READY);
2304 /* See if we got it */
2305 ret = iwl_poll_bit(priv, CSR_HW_IF_CONFIG_REG,
2306 CSR_HW_IF_CONFIG_REG_BIT_NIC_READY,
2307 CSR_HW_IF_CONFIG_REG_BIT_NIC_READY,
2309 if (ret != -ETIMEDOUT)
2310 priv->hw_ready = true;
2312 priv->hw_ready = false;
2314 IWL_DEBUG_INFO(priv, "hardware %s\n",
2315 (priv->hw_ready == 1) ? "ready" : "not ready");
2319 static int iwl_prepare_card_hw(struct iwl_priv *priv)
2323 IWL_DEBUG_INFO(priv, "iwl_prepare_card_hw enter\n");
2325 ret = iwl_set_hw_ready(priv);
2329 /* If HW is not ready, prepare the conditions to check again */
2330 iwl_set_bit(priv, CSR_HW_IF_CONFIG_REG,
2331 CSR_HW_IF_CONFIG_REG_PREPARE);
2333 ret = iwl_poll_bit(priv, CSR_HW_IF_CONFIG_REG,
2334 ~CSR_HW_IF_CONFIG_REG_BIT_NIC_PREPARE_DONE,
2335 CSR_HW_IF_CONFIG_REG_BIT_NIC_PREPARE_DONE, 150000);
2337 /* HW should be ready by now, check again. */
2338 if (ret != -ETIMEDOUT)
2339 iwl_set_hw_ready(priv);
2344 #define MAX_HW_RESTARTS 5
2346 static int __iwl_up(struct iwl_priv *priv)
2351 if (test_bit(STATUS_EXIT_PENDING, &priv->status)) {
2352 IWL_WARN(priv, "Exit pending; will not bring the NIC up\n");
2356 if (!priv->ucode_data_backup.v_addr || !priv->ucode_data.v_addr) {
2357 IWL_ERR(priv, "ucode not available for device bringup\n");
2361 iwl_prepare_card_hw(priv);
2363 if (!priv->hw_ready) {
2364 IWL_WARN(priv, "Exit HW not ready\n");
2368 /* If platform's RF_KILL switch is NOT set to KILL */
2369 if (iwl_read32(priv, CSR_GP_CNTRL) & CSR_GP_CNTRL_REG_FLAG_HW_RF_KILL_SW)
2370 clear_bit(STATUS_RF_KILL_HW, &priv->status);
2372 set_bit(STATUS_RF_KILL_HW, &priv->status);
2374 if (iwl_is_rfkill(priv)) {
2375 wiphy_rfkill_set_hw_state(priv->hw->wiphy, true);
2377 iwl_enable_interrupts(priv);
2378 IWL_WARN(priv, "Radio disabled by HW RF Kill switch\n");
2382 iwl_write32(priv, CSR_INT, 0xFFFFFFFF);
2384 ret = iwlagn_hw_nic_init(priv);
2386 IWL_ERR(priv, "Unable to init nic\n");
2390 /* make sure rfkill handshake bits are cleared */
2391 iwl_write32(priv, CSR_UCODE_DRV_GP1_CLR, CSR_UCODE_SW_BIT_RFKILL);
2392 iwl_write32(priv, CSR_UCODE_DRV_GP1_CLR,
2393 CSR_UCODE_DRV_GP1_BIT_CMD_BLOCKED);
2395 /* clear (again), then enable host interrupts */
2396 iwl_write32(priv, CSR_INT, 0xFFFFFFFF);
2397 iwl_enable_interrupts(priv);
2399 /* really make sure rfkill handshake bits are cleared */
2400 iwl_write32(priv, CSR_UCODE_DRV_GP1_CLR, CSR_UCODE_SW_BIT_RFKILL);
2401 iwl_write32(priv, CSR_UCODE_DRV_GP1_CLR, CSR_UCODE_SW_BIT_RFKILL);
2403 /* Copy original ucode data image from disk into backup cache.
2404 * This will be used to initialize the on-board processor's
2405 * data SRAM for a clean start when the runtime program first loads. */
2406 memcpy(priv->ucode_data_backup.v_addr, priv->ucode_data.v_addr,
2407 priv->ucode_data.len);
2409 for (i = 0; i < MAX_HW_RESTARTS; i++) {
2411 /* load bootstrap state machine,
2412 * load bootstrap program into processor's memory,
2413 * prepare to load the "initialize" uCode */
2414 ret = priv->cfg->ops->lib->load_ucode(priv);
2417 IWL_ERR(priv, "Unable to set up bootstrap uCode: %d\n",
2422 /* start card; "initialize" will load runtime ucode */
2423 iwl_nic_start(priv);
2425 IWL_DEBUG_INFO(priv, DRV_NAME " is coming up\n");
2430 set_bit(STATUS_EXIT_PENDING, &priv->status);
2432 clear_bit(STATUS_EXIT_PENDING, &priv->status);
2434 /* tried to restart and config the device for as long as our
2435 * patience could withstand */
2436 IWL_ERR(priv, "Unable to initialize device after %d attempts.\n", i);
2441 /*****************************************************************************
2443 * Workqueue callbacks
2445 *****************************************************************************/
2447 static void iwl_bg_init_alive_start(struct work_struct *data)
2449 struct iwl_priv *priv =
2450 container_of(data, struct iwl_priv, init_alive_start.work);
2452 if (test_bit(STATUS_EXIT_PENDING, &priv->status))
2455 mutex_lock(&priv->mutex);
2456 priv->cfg->ops->lib->init_alive_start(priv);
2457 mutex_unlock(&priv->mutex);
2460 static void iwl_bg_alive_start(struct work_struct *data)
2462 struct iwl_priv *priv =
2463 container_of(data, struct iwl_priv, alive_start.work);
2465 if (test_bit(STATUS_EXIT_PENDING, &priv->status))
2468 /* enable dram interrupt */
2469 iwl_reset_ict(priv);
2471 mutex_lock(&priv->mutex);
2472 iwl_alive_start(priv);
2473 mutex_unlock(&priv->mutex);
2476 static void iwl_bg_run_time_calib_work(struct work_struct *work)
2478 struct iwl_priv *priv = container_of(work, struct iwl_priv,
2479 run_time_calib_work);
2481 mutex_lock(&priv->mutex);
2483 if (test_bit(STATUS_EXIT_PENDING, &priv->status) ||
2484 test_bit(STATUS_SCANNING, &priv->status)) {
2485 mutex_unlock(&priv->mutex);
2489 if (priv->start_calib) {
2490 iwl_chain_noise_calibration(priv, &priv->statistics);
2492 iwl_sensitivity_calibration(priv, &priv->statistics);
2495 mutex_unlock(&priv->mutex);
2499 static void iwl_bg_restart(struct work_struct *data)
2501 struct iwl_priv *priv = container_of(data, struct iwl_priv, restart);
2503 if (test_bit(STATUS_EXIT_PENDING, &priv->status))
2506 if (test_and_clear_bit(STATUS_FW_ERROR, &priv->status)) {
2507 mutex_lock(&priv->mutex);
2510 mutex_unlock(&priv->mutex);
2512 ieee80211_restart_hw(priv->hw);
2516 if (test_bit(STATUS_EXIT_PENDING, &priv->status))
2519 mutex_lock(&priv->mutex);
2521 mutex_unlock(&priv->mutex);
2525 static void iwl_bg_rx_replenish(struct work_struct *data)
2527 struct iwl_priv *priv =
2528 container_of(data, struct iwl_priv, rx_replenish);
2530 if (test_bit(STATUS_EXIT_PENDING, &priv->status))
2533 mutex_lock(&priv->mutex);
2534 iwlagn_rx_replenish(priv);
2535 mutex_unlock(&priv->mutex);
2538 #define IWL_DELAY_NEXT_SCAN (HZ*2)
2540 void iwl_post_associate(struct iwl_priv *priv)
2542 struct ieee80211_conf *conf = NULL;
2545 if (priv->iw_mode == NL80211_IFTYPE_AP) {
2546 IWL_ERR(priv, "%s Should not be called in AP mode\n", __func__);
2550 if (test_bit(STATUS_EXIT_PENDING, &priv->status))
2554 if (!priv->vif || !priv->is_open)
2557 iwl_scan_cancel_timeout(priv, 200);
2559 conf = ieee80211_get_hw_conf(priv->hw);
2561 priv->staging_rxon.filter_flags &= ~RXON_FILTER_ASSOC_MSK;
2562 iwlcore_commit_rxon(priv);
2564 iwl_setup_rxon_timing(priv);
2565 ret = iwl_send_cmd_pdu(priv, REPLY_RXON_TIMING,
2566 sizeof(priv->rxon_timing), &priv->rxon_timing);
2568 IWL_WARN(priv, "REPLY_RXON_TIMING failed - "
2569 "Attempting to continue.\n");
2571 priv->staging_rxon.filter_flags |= RXON_FILTER_ASSOC_MSK;
2573 iwl_set_rxon_ht(priv, &priv->current_ht_config);
2575 if (priv->cfg->ops->hcmd->set_rxon_chain)
2576 priv->cfg->ops->hcmd->set_rxon_chain(priv);
2578 priv->staging_rxon.assoc_id = cpu_to_le16(priv->assoc_id);
2580 IWL_DEBUG_ASSOC(priv, "assoc id %d beacon interval %d\n",
2581 priv->assoc_id, priv->beacon_int);
2583 if (priv->assoc_capability & WLAN_CAPABILITY_SHORT_PREAMBLE)
2584 priv->staging_rxon.flags |= RXON_FLG_SHORT_PREAMBLE_MSK;
2586 priv->staging_rxon.flags &= ~RXON_FLG_SHORT_PREAMBLE_MSK;
2588 if (priv->staging_rxon.flags & RXON_FLG_BAND_24G_MSK) {
2589 if (priv->assoc_capability & WLAN_CAPABILITY_SHORT_SLOT_TIME)
2590 priv->staging_rxon.flags |= RXON_FLG_SHORT_SLOT_MSK;
2592 priv->staging_rxon.flags &= ~RXON_FLG_SHORT_SLOT_MSK;
2594 if (priv->iw_mode == NL80211_IFTYPE_ADHOC)
2595 priv->staging_rxon.flags &= ~RXON_FLG_SHORT_SLOT_MSK;
2599 iwlcore_commit_rxon(priv);
2601 IWL_DEBUG_ASSOC(priv, "Associated as %d to: %pM\n",
2602 priv->assoc_id, priv->active_rxon.bssid_addr);
2604 switch (priv->iw_mode) {
2605 case NL80211_IFTYPE_STATION:
2608 case NL80211_IFTYPE_ADHOC:
2610 /* assume default assoc id */
2613 iwl_add_local_station(priv, priv->bssid, true);
2614 iwl_send_beacon_cmd(priv);
2619 IWL_ERR(priv, "%s Should not be called in %d mode\n",
2620 __func__, priv->iw_mode);
2624 /* the chain noise calibration will enabled PM upon completion
2625 * If chain noise has already been run, then we need to enable
2626 * power management here */
2627 if (priv->chain_noise_data.state == IWL_CHAIN_NOISE_DONE)
2628 iwl_power_update_mode(priv, false);
2630 /* Enable Rx differential gain and sensitivity calibrations */
2631 iwl_chain_noise_reset(priv);
2632 priv->start_calib = 1;
2636 /*****************************************************************************
2638 * mac80211 entry point functions
2640 *****************************************************************************/
2642 #define UCODE_READY_TIMEOUT (4 * HZ)
2645 * Not a mac80211 entry point function, but it fits in with all the
2646 * other mac80211 functions grouped here.
2648 static int iwl_mac_setup_register(struct iwl_priv *priv)
2651 struct ieee80211_hw *hw = priv->hw;
2652 hw->rate_control_algorithm = "iwl-agn-rs";
2654 /* Tell mac80211 our characteristics */
2655 hw->flags = IEEE80211_HW_SIGNAL_DBM |
2656 IEEE80211_HW_NOISE_DBM |
2657 IEEE80211_HW_AMPDU_AGGREGATION |
2658 IEEE80211_HW_SPECTRUM_MGMT;
2660 if (!priv->cfg->broken_powersave)
2661 hw->flags |= IEEE80211_HW_SUPPORTS_PS |
2662 IEEE80211_HW_SUPPORTS_DYNAMIC_PS;
2664 if (priv->cfg->sku & IWL_SKU_N)
2665 hw->flags |= IEEE80211_HW_SUPPORTS_DYNAMIC_SMPS |
2666 IEEE80211_HW_SUPPORTS_STATIC_SMPS;
2668 hw->sta_data_size = sizeof(struct iwl_station_priv);
2669 hw->wiphy->interface_modes =
2670 BIT(NL80211_IFTYPE_STATION) |
2671 BIT(NL80211_IFTYPE_ADHOC);
2673 hw->wiphy->flags |= WIPHY_FLAG_CUSTOM_REGULATORY |
2674 WIPHY_FLAG_DISABLE_BEACON_HINTS;
2677 * For now, disable PS by default because it affects
2678 * RX performance significantly.
2680 hw->wiphy->flags &= ~WIPHY_FLAG_PS_ON_BY_DEFAULT;
2682 hw->wiphy->max_scan_ssids = PROBE_OPTION_MAX;
2683 /* we create the 802.11 header and a zero-length SSID element */
2684 hw->wiphy->max_scan_ie_len = IWL_MAX_PROBE_REQUEST - 24 - 2;
2686 /* Default value; 4 EDCA QOS priorities */
2689 hw->max_listen_interval = IWL_CONN_MAX_LISTEN_INTERVAL;
2691 if (priv->bands[IEEE80211_BAND_2GHZ].n_channels)
2692 priv->hw->wiphy->bands[IEEE80211_BAND_2GHZ] =
2693 &priv->bands[IEEE80211_BAND_2GHZ];
2694 if (priv->bands[IEEE80211_BAND_5GHZ].n_channels)
2695 priv->hw->wiphy->bands[IEEE80211_BAND_5GHZ] =
2696 &priv->bands[IEEE80211_BAND_5GHZ];
2698 ret = ieee80211_register_hw(priv->hw);
2700 IWL_ERR(priv, "Failed to register hw (error %d)\n", ret);
2703 priv->mac80211_registered = 1;
2709 static int iwl_mac_start(struct ieee80211_hw *hw)
2711 struct iwl_priv *priv = hw->priv;
2714 IWL_DEBUG_MAC80211(priv, "enter\n");
2716 /* we should be verifying the device is ready to be opened */
2717 mutex_lock(&priv->mutex);
2718 ret = __iwl_up(priv);
2719 mutex_unlock(&priv->mutex);
2724 if (iwl_is_rfkill(priv))
2727 IWL_DEBUG_INFO(priv, "Start UP work done.\n");
2729 /* Wait for START_ALIVE from Run Time ucode. Otherwise callbacks from
2730 * mac80211 will not be run successfully. */
2731 ret = wait_event_interruptible_timeout(priv->wait_command_queue,
2732 test_bit(STATUS_READY, &priv->status),
2733 UCODE_READY_TIMEOUT);
2735 if (!test_bit(STATUS_READY, &priv->status)) {
2736 IWL_ERR(priv, "START_ALIVE timeout after %dms.\n",
2737 jiffies_to_msecs(UCODE_READY_TIMEOUT));
2742 iwl_led_start(priv);
2746 IWL_DEBUG_MAC80211(priv, "leave\n");
2750 static void iwl_mac_stop(struct ieee80211_hw *hw)
2752 struct iwl_priv *priv = hw->priv;
2754 IWL_DEBUG_MAC80211(priv, "enter\n");
2761 if (iwl_is_ready_rf(priv) || test_bit(STATUS_SCAN_HW, &priv->status)) {
2762 /* stop mac, cancel any scan request and clear
2763 * RXON_FILTER_ASSOC_MSK BIT
2765 mutex_lock(&priv->mutex);
2766 iwl_scan_cancel_timeout(priv, 100);
2767 mutex_unlock(&priv->mutex);
2772 flush_workqueue(priv->workqueue);
2774 /* enable interrupts again in order to receive rfkill changes */
2775 iwl_write32(priv, CSR_INT, 0xFFFFFFFF);
2776 iwl_enable_interrupts(priv);
2778 IWL_DEBUG_MAC80211(priv, "leave\n");
2781 static int iwl_mac_tx(struct ieee80211_hw *hw, struct sk_buff *skb)
2783 struct iwl_priv *priv = hw->priv;
2785 IWL_DEBUG_MACDUMP(priv, "enter\n");
2787 IWL_DEBUG_TX(priv, "dev->xmit(%d bytes) at rate 0x%02x\n", skb->len,
2788 ieee80211_get_tx_rate(hw, IEEE80211_SKB_CB(skb))->bitrate);
2790 if (iwlagn_tx_skb(priv, skb))
2791 dev_kfree_skb_any(skb);
2793 IWL_DEBUG_MACDUMP(priv, "leave\n");
2794 return NETDEV_TX_OK;
2797 void iwl_config_ap(struct iwl_priv *priv)
2801 if (test_bit(STATUS_EXIT_PENDING, &priv->status))
2804 /* The following should be done only at AP bring up */
2805 if (!iwl_is_associated(priv)) {
2807 /* RXON - unassoc (to set timing command) */
2808 priv->staging_rxon.filter_flags &= ~RXON_FILTER_ASSOC_MSK;
2809 iwlcore_commit_rxon(priv);
2812 iwl_setup_rxon_timing(priv);
2813 ret = iwl_send_cmd_pdu(priv, REPLY_RXON_TIMING,
2814 sizeof(priv->rxon_timing), &priv->rxon_timing);
2816 IWL_WARN(priv, "REPLY_RXON_TIMING failed - "
2817 "Attempting to continue.\n");
2819 /* AP has all antennas */
2820 priv->chain_noise_data.active_chains =
2821 priv->hw_params.valid_rx_ant;
2822 iwl_set_rxon_ht(priv, &priv->current_ht_config);
2823 if (priv->cfg->ops->hcmd->set_rxon_chain)
2824 priv->cfg->ops->hcmd->set_rxon_chain(priv);
2826 /* FIXME: what should be the assoc_id for AP? */
2827 priv->staging_rxon.assoc_id = cpu_to_le16(priv->assoc_id);
2828 if (priv->assoc_capability & WLAN_CAPABILITY_SHORT_PREAMBLE)
2829 priv->staging_rxon.flags |=
2830 RXON_FLG_SHORT_PREAMBLE_MSK;
2832 priv->staging_rxon.flags &=
2833 ~RXON_FLG_SHORT_PREAMBLE_MSK;
2835 if (priv->staging_rxon.flags & RXON_FLG_BAND_24G_MSK) {
2836 if (priv->assoc_capability &
2837 WLAN_CAPABILITY_SHORT_SLOT_TIME)
2838 priv->staging_rxon.flags |=
2839 RXON_FLG_SHORT_SLOT_MSK;
2841 priv->staging_rxon.flags &=
2842 ~RXON_FLG_SHORT_SLOT_MSK;
2844 if (priv->iw_mode == NL80211_IFTYPE_ADHOC)
2845 priv->staging_rxon.flags &=
2846 ~RXON_FLG_SHORT_SLOT_MSK;
2848 /* restore RXON assoc */
2849 priv->staging_rxon.filter_flags |= RXON_FILTER_ASSOC_MSK;
2850 iwlcore_commit_rxon(priv);
2851 iwl_add_bcast_station(priv);
2853 iwl_send_beacon_cmd(priv);
2855 /* FIXME - we need to add code here to detect a totally new
2856 * configuration, reset the AP, unassoc, rxon timing, assoc,
2857 * clear sta table, add BCAST sta... */
2860 static void iwl_mac_update_tkip_key(struct ieee80211_hw *hw,
2861 struct ieee80211_vif *vif,
2862 struct ieee80211_key_conf *keyconf,
2863 struct ieee80211_sta *sta,
2864 u32 iv32, u16 *phase1key)
2867 struct iwl_priv *priv = hw->priv;
2868 IWL_DEBUG_MAC80211(priv, "enter\n");
2870 iwl_update_tkip_key(priv, keyconf,
2871 sta ? sta->addr : iwl_bcast_addr,
2874 IWL_DEBUG_MAC80211(priv, "leave\n");
2877 static int iwl_mac_set_key(struct ieee80211_hw *hw, enum set_key_cmd cmd,
2878 struct ieee80211_vif *vif,
2879 struct ieee80211_sta *sta,
2880 struct ieee80211_key_conf *key)
2882 struct iwl_priv *priv = hw->priv;
2886 bool is_default_wep_key = false;
2888 IWL_DEBUG_MAC80211(priv, "enter\n");
2890 if (priv->cfg->mod_params->sw_crypto) {
2891 IWL_DEBUG_MAC80211(priv, "leave - hwcrypto disabled\n");
2894 addr = sta ? sta->addr : iwl_bcast_addr;
2895 sta_id = iwl_find_station(priv, addr);
2896 if (sta_id == IWL_INVALID_STATION) {
2897 IWL_DEBUG_MAC80211(priv, "leave - %pM not in station map.\n",
2903 mutex_lock(&priv->mutex);
2904 iwl_scan_cancel_timeout(priv, 100);
2907 * If we are getting WEP group key and we didn't receive any key mapping
2908 * so far, we are in legacy wep mode (group key only), otherwise we are
2910 * In legacy wep mode, we use another host command to the uCode.
2912 if (key->alg == ALG_WEP && !sta && vif->type != NL80211_IFTYPE_AP) {
2914 is_default_wep_key = !priv->key_mapping_key;
2916 is_default_wep_key =
2917 (key->hw_key_idx == HW_KEY_DEFAULT);
2922 if (is_default_wep_key)
2923 ret = iwl_set_default_wep_key(priv, key);
2925 ret = iwl_set_dynamic_key(priv, key, sta_id);
2927 IWL_DEBUG_MAC80211(priv, "enable hwcrypto key\n");
2930 if (is_default_wep_key)
2931 ret = iwl_remove_default_wep_key(priv, key);
2933 ret = iwl_remove_dynamic_key(priv, key, sta_id);
2935 IWL_DEBUG_MAC80211(priv, "disable hwcrypto key\n");
2941 mutex_unlock(&priv->mutex);
2942 IWL_DEBUG_MAC80211(priv, "leave\n");
2947 static int iwl_mac_ampdu_action(struct ieee80211_hw *hw,
2948 struct ieee80211_vif *vif,
2949 enum ieee80211_ampdu_mlme_action action,
2950 struct ieee80211_sta *sta, u16 tid, u16 *ssn)
2952 struct iwl_priv *priv = hw->priv;
2955 IWL_DEBUG_HT(priv, "A-MPDU action on addr %pM tid %d\n",
2958 if (!(priv->cfg->sku & IWL_SKU_N))
2962 case IEEE80211_AMPDU_RX_START:
2963 IWL_DEBUG_HT(priv, "start Rx\n");
2964 return iwl_sta_rx_agg_start(priv, sta->addr, tid, *ssn);
2965 case IEEE80211_AMPDU_RX_STOP:
2966 IWL_DEBUG_HT(priv, "stop Rx\n");
2967 ret = iwl_sta_rx_agg_stop(priv, sta->addr, tid);
2968 if (test_bit(STATUS_EXIT_PENDING, &priv->status))
2972 case IEEE80211_AMPDU_TX_START:
2973 IWL_DEBUG_HT(priv, "start Tx\n");
2974 ret = iwlagn_tx_agg_start(priv, sta->addr, tid, ssn);
2976 priv->_agn.agg_tids_count++;
2977 IWL_DEBUG_HT(priv, "priv->_agn.agg_tids_count = %u\n",
2978 priv->_agn.agg_tids_count);
2981 case IEEE80211_AMPDU_TX_STOP:
2982 IWL_DEBUG_HT(priv, "stop Tx\n");
2983 ret = iwlagn_tx_agg_stop(priv, sta->addr, tid);
2984 if ((ret == 0) && (priv->_agn.agg_tids_count > 0)) {
2985 priv->_agn.agg_tids_count--;
2986 IWL_DEBUG_HT(priv, "priv->_agn.agg_tids_count = %u\n",
2987 priv->_agn.agg_tids_count);
2989 if (test_bit(STATUS_EXIT_PENDING, &priv->status))
2993 case IEEE80211_AMPDU_TX_OPERATIONAL:
2997 IWL_DEBUG_HT(priv, "unknown\n");
3004 static int iwl_mac_get_stats(struct ieee80211_hw *hw,
3005 struct ieee80211_low_level_stats *stats)
3007 struct iwl_priv *priv = hw->priv;
3010 IWL_DEBUG_MAC80211(priv, "enter\n");
3011 IWL_DEBUG_MAC80211(priv, "leave\n");
3016 static void iwl_mac_sta_notify(struct ieee80211_hw *hw,
3017 struct ieee80211_vif *vif,
3018 enum sta_notify_cmd cmd,
3019 struct ieee80211_sta *sta)
3021 struct iwl_priv *priv = hw->priv;
3022 struct iwl_station_priv *sta_priv = (void *)sta->drv_priv;
3026 case STA_NOTIFY_SLEEP:
3027 WARN_ON(!sta_priv->client);
3028 sta_priv->asleep = true;
3029 if (atomic_read(&sta_priv->pending_frames) > 0)
3030 ieee80211_sta_block_awake(hw, sta, true);
3032 case STA_NOTIFY_AWAKE:
3033 WARN_ON(!sta_priv->client);
3034 if (!sta_priv->asleep)
3036 sta_priv->asleep = false;
3037 sta_id = iwl_find_station(priv, sta->addr);
3038 if (sta_id != IWL_INVALID_STATION)
3039 iwl_sta_modify_ps_wake(priv, sta_id);
3046 static int iwlagn_mac_sta_add(struct ieee80211_hw *hw,
3047 struct ieee80211_vif *vif,
3048 struct ieee80211_sta *sta)
3050 struct iwl_priv *priv = hw->priv;
3051 struct iwl_station_priv *sta_priv = (void *)sta->drv_priv;
3052 bool is_ap = priv->iw_mode == NL80211_IFTYPE_STATION;
3056 IWL_DEBUG_INFO(priv, "received request to add station %pM\n",
3059 atomic_set(&sta_priv->pending_frames, 0);
3060 if (vif->type == NL80211_IFTYPE_AP)
3061 sta_priv->client = true;
3063 ret = iwl_add_station_common(priv, sta->addr, is_ap, &sta->ht_cap,
3066 IWL_ERR(priv, "Unable to add station %pM (%d)\n",
3068 /* Should we return success if return code is EEXIST ? */
3072 /* Initialize rate scaling */
3073 IWL_DEBUG_INFO(priv, "Initializing rate scaling for station %pM\n",
3075 iwl_rs_rate_init(priv, sta, sta_id);
3080 /*****************************************************************************
3084 *****************************************************************************/
3086 #ifdef CONFIG_IWLWIFI_DEBUG
3089 * The following adds a new attribute to the sysfs representation
3090 * of this device driver (i.e. a new file in /sys/class/net/wlan0/device/)
3091 * used for controlling the debug level.
3093 * See the level definitions in iwl for details.
3095 * The debug_level being managed using sysfs below is a per device debug
3096 * level that is used instead of the global debug level if it (the per
3097 * device debug level) is set.
3099 static ssize_t show_debug_level(struct device *d,
3100 struct device_attribute *attr, char *buf)
3102 struct iwl_priv *priv = dev_get_drvdata(d);
3103 return sprintf(buf, "0x%08X\n", iwl_get_debug_level(priv));
3105 static ssize_t store_debug_level(struct device *d,
3106 struct device_attribute *attr,
3107 const char *buf, size_t count)
3109 struct iwl_priv *priv = dev_get_drvdata(d);
3113 ret = strict_strtoul(buf, 0, &val);
3115 IWL_ERR(priv, "%s is not in hex or decimal form.\n", buf);
3117 priv->debug_level = val;
3118 if (iwl_alloc_traffic_mem(priv))
3120 "Not enough memory to generate traffic log\n");
3122 return strnlen(buf, count);
3125 static DEVICE_ATTR(debug_level, S_IWUSR | S_IRUGO,
3126 show_debug_level, store_debug_level);
3129 #endif /* CONFIG_IWLWIFI_DEBUG */
3132 static ssize_t show_temperature(struct device *d,
3133 struct device_attribute *attr, char *buf)
3135 struct iwl_priv *priv = dev_get_drvdata(d);
3137 if (!iwl_is_alive(priv))
3140 return sprintf(buf, "%d\n", priv->temperature);
3143 static DEVICE_ATTR(temperature, S_IRUGO, show_temperature, NULL);
3145 static ssize_t show_tx_power(struct device *d,
3146 struct device_attribute *attr, char *buf)
3148 struct iwl_priv *priv = dev_get_drvdata(d);
3150 if (!iwl_is_ready_rf(priv))
3151 return sprintf(buf, "off\n");
3153 return sprintf(buf, "%d\n", priv->tx_power_user_lmt);
3156 static ssize_t store_tx_power(struct device *d,
3157 struct device_attribute *attr,
3158 const char *buf, size_t count)
3160 struct iwl_priv *priv = dev_get_drvdata(d);
3164 ret = strict_strtoul(buf, 10, &val);
3166 IWL_INFO(priv, "%s is not in decimal form.\n", buf);
3168 ret = iwl_set_tx_power(priv, val, false);
3170 IWL_ERR(priv, "failed setting tx power (0x%d).\n",
3178 static DEVICE_ATTR(tx_power, S_IWUSR | S_IRUGO, show_tx_power, store_tx_power);
3180 static ssize_t show_rts_ht_protection(struct device *d,
3181 struct device_attribute *attr, char *buf)
3183 struct iwl_priv *priv = dev_get_drvdata(d);
3185 return sprintf(buf, "%s\n",
3186 priv->cfg->use_rts_for_ht ? "RTS/CTS" : "CTS-to-self");
3189 static ssize_t store_rts_ht_protection(struct device *d,
3190 struct device_attribute *attr,
3191 const char *buf, size_t count)
3193 struct iwl_priv *priv = dev_get_drvdata(d);
3197 ret = strict_strtoul(buf, 10, &val);
3199 IWL_INFO(priv, "Input is not in decimal form.\n");
3201 if (!iwl_is_associated(priv))
3202 priv->cfg->use_rts_for_ht = val ? true : false;
3204 IWL_ERR(priv, "Sta associated with AP - "
3205 "Change protection mechanism is not allowed\n");
3211 static DEVICE_ATTR(rts_ht_protection, S_IWUSR | S_IRUGO,
3212 show_rts_ht_protection, store_rts_ht_protection);
3215 /*****************************************************************************
3217 * driver setup and teardown
3219 *****************************************************************************/
3221 static void iwl_setup_deferred_work(struct iwl_priv *priv)
3223 priv->workqueue = create_singlethread_workqueue(DRV_NAME);
3225 init_waitqueue_head(&priv->wait_command_queue);
3227 INIT_WORK(&priv->restart, iwl_bg_restart);
3228 INIT_WORK(&priv->rx_replenish, iwl_bg_rx_replenish);
3229 INIT_WORK(&priv->beacon_update, iwl_bg_beacon_update);
3230 INIT_WORK(&priv->run_time_calib_work, iwl_bg_run_time_calib_work);
3231 INIT_DELAYED_WORK(&priv->init_alive_start, iwl_bg_init_alive_start);
3232 INIT_DELAYED_WORK(&priv->alive_start, iwl_bg_alive_start);
3234 iwl_setup_scan_deferred_work(priv);
3236 if (priv->cfg->ops->lib->setup_deferred_work)
3237 priv->cfg->ops->lib->setup_deferred_work(priv);
3239 init_timer(&priv->statistics_periodic);
3240 priv->statistics_periodic.data = (unsigned long)priv;
3241 priv->statistics_periodic.function = iwl_bg_statistics_periodic;
3243 init_timer(&priv->ucode_trace);
3244 priv->ucode_trace.data = (unsigned long)priv;
3245 priv->ucode_trace.function = iwl_bg_ucode_trace;
3247 if (priv->cfg->ops->lib->recover_from_tx_stall) {
3248 init_timer(&priv->monitor_recover);
3249 priv->monitor_recover.data = (unsigned long)priv;
3250 priv->monitor_recover.function =
3251 priv->cfg->ops->lib->recover_from_tx_stall;
3254 if (!priv->cfg->use_isr_legacy)
3255 tasklet_init(&priv->irq_tasklet, (void (*)(unsigned long))
3256 iwl_irq_tasklet, (unsigned long)priv);
3258 tasklet_init(&priv->irq_tasklet, (void (*)(unsigned long))
3259 iwl_irq_tasklet_legacy, (unsigned long)priv);
3262 static void iwl_cancel_deferred_work(struct iwl_priv *priv)
3264 if (priv->cfg->ops->lib->cancel_deferred_work)
3265 priv->cfg->ops->lib->cancel_deferred_work(priv);
3267 cancel_delayed_work_sync(&priv->init_alive_start);
3268 cancel_delayed_work(&priv->scan_check);
3269 cancel_work_sync(&priv->start_internal_scan);
3270 cancel_delayed_work(&priv->alive_start);
3271 cancel_work_sync(&priv->beacon_update);
3272 del_timer_sync(&priv->statistics_periodic);
3273 del_timer_sync(&priv->ucode_trace);
3274 if (priv->cfg->ops->lib->recover_from_tx_stall)
3275 del_timer_sync(&priv->monitor_recover);
3278 static void iwl_init_hw_rates(struct iwl_priv *priv,
3279 struct ieee80211_rate *rates)
3283 for (i = 0; i < IWL_RATE_COUNT_LEGACY; i++) {
3284 rates[i].bitrate = iwl_rates[i].ieee * 5;
3285 rates[i].hw_value = i; /* Rate scaling will work on indexes */
3286 rates[i].hw_value_short = i;
3288 if ((i >= IWL_FIRST_CCK_RATE) && (i <= IWL_LAST_CCK_RATE)) {
3290 * If CCK != 1M then set short preamble rate flag.
3293 (iwl_rates[i].plcp == IWL_RATE_1M_PLCP) ?
3294 0 : IEEE80211_RATE_SHORT_PREAMBLE;
3299 static int iwl_init_drv(struct iwl_priv *priv)
3303 priv->ibss_beacon = NULL;
3305 spin_lock_init(&priv->sta_lock);
3306 spin_lock_init(&priv->hcmd_lock);
3308 INIT_LIST_HEAD(&priv->free_frames);
3310 mutex_init(&priv->mutex);
3311 mutex_init(&priv->sync_cmd_mutex);
3313 priv->ieee_channels = NULL;
3314 priv->ieee_rates = NULL;
3315 priv->band = IEEE80211_BAND_2GHZ;
3317 priv->iw_mode = NL80211_IFTYPE_STATION;
3318 priv->current_ht_config.smps = IEEE80211_SMPS_STATIC;
3319 priv->missed_beacon_threshold = IWL_MISSED_BEACON_THRESHOLD_DEF;
3320 priv->_agn.agg_tids_count = 0;
3322 /* initialize force reset */
3323 priv->force_reset[IWL_RF_RESET].reset_duration =
3324 IWL_DELAY_NEXT_FORCE_RF_RESET;
3325 priv->force_reset[IWL_FW_RESET].reset_duration =
3326 IWL_DELAY_NEXT_FORCE_FW_RELOAD;
3328 /* Choose which receivers/antennas to use */
3329 if (priv->cfg->ops->hcmd->set_rxon_chain)
3330 priv->cfg->ops->hcmd->set_rxon_chain(priv);
3332 iwl_init_scan_params(priv);
3334 /* Set the tx_power_user_lmt to the lowest power level
3335 * this value will get overwritten by channel max power avg
3337 priv->tx_power_user_lmt = IWLAGN_TX_POWER_TARGET_POWER_MIN;
3339 ret = iwl_init_channel_map(priv);
3341 IWL_ERR(priv, "initializing regulatory failed: %d\n", ret);
3345 ret = iwlcore_init_geos(priv);
3347 IWL_ERR(priv, "initializing geos failed: %d\n", ret);
3348 goto err_free_channel_map;
3350 iwl_init_hw_rates(priv, priv->ieee_rates);
3354 err_free_channel_map:
3355 iwl_free_channel_map(priv);
3360 static void iwl_uninit_drv(struct iwl_priv *priv)
3362 iwl_calib_free_results(priv);
3363 iwlcore_free_geos(priv);
3364 iwl_free_channel_map(priv);
3365 kfree(priv->scan_cmd);
3368 static struct attribute *iwl_sysfs_entries[] = {
3369 &dev_attr_temperature.attr,
3370 &dev_attr_tx_power.attr,
3371 &dev_attr_rts_ht_protection.attr,
3372 #ifdef CONFIG_IWLWIFI_DEBUG
3373 &dev_attr_debug_level.attr,
3378 static struct attribute_group iwl_attribute_group = {
3379 .name = NULL, /* put in device directory */
3380 .attrs = iwl_sysfs_entries,
3383 static struct ieee80211_ops iwl_hw_ops = {
3385 .start = iwl_mac_start,
3386 .stop = iwl_mac_stop,
3387 .add_interface = iwl_mac_add_interface,
3388 .remove_interface = iwl_mac_remove_interface,
3389 .config = iwl_mac_config,
3390 .configure_filter = iwl_configure_filter,
3391 .set_key = iwl_mac_set_key,
3392 .update_tkip_key = iwl_mac_update_tkip_key,
3393 .get_stats = iwl_mac_get_stats,
3394 .conf_tx = iwl_mac_conf_tx,
3395 .reset_tsf = iwl_mac_reset_tsf,
3396 .bss_info_changed = iwl_bss_info_changed,
3397 .ampdu_action = iwl_mac_ampdu_action,
3398 .hw_scan = iwl_mac_hw_scan,
3399 .sta_notify = iwl_mac_sta_notify,
3400 .sta_add = iwlagn_mac_sta_add,
3401 .sta_remove = iwl_mac_sta_remove,
3404 static int iwl_pci_probe(struct pci_dev *pdev, const struct pci_device_id *ent)
3407 struct iwl_priv *priv;
3408 struct ieee80211_hw *hw;
3409 struct iwl_cfg *cfg = (struct iwl_cfg *)(ent->driver_data);
3410 unsigned long flags;
3413 /************************
3414 * 1. Allocating HW data
3415 ************************/
3417 /* Disabling hardware scan means that mac80211 will perform scans
3418 * "the hard way", rather than using device's scan. */
3419 if (cfg->mod_params->disable_hw_scan) {
3420 if (iwl_debug_level & IWL_DL_INFO)
3421 dev_printk(KERN_DEBUG, &(pdev->dev),
3422 "Disabling hw_scan\n");
3423 iwl_hw_ops.hw_scan = NULL;
3426 hw = iwl_alloc_all(cfg, &iwl_hw_ops);
3432 /* At this point both hw and priv are allocated. */
3434 SET_IEEE80211_DEV(hw, &pdev->dev);
3436 IWL_DEBUG_INFO(priv, "*** LOAD DRIVER ***\n");
3438 priv->pci_dev = pdev;
3439 priv->inta_mask = CSR_INI_SET_MASK;
3441 #ifdef CONFIG_IWLWIFI_DEBUG
3442 atomic_set(&priv->restrict_refcnt, 0);
3444 if (iwl_alloc_traffic_mem(priv))
3445 IWL_ERR(priv, "Not enough memory to generate traffic log\n");
3447 /**************************
3448 * 2. Initializing PCI bus
3449 **************************/
3450 if (pci_enable_device(pdev)) {
3452 goto out_ieee80211_free_hw;
3455 pci_set_master(pdev);
3457 err = pci_set_dma_mask(pdev, DMA_BIT_MASK(36));
3459 err = pci_set_consistent_dma_mask(pdev, DMA_BIT_MASK(36));
3461 err = pci_set_dma_mask(pdev, DMA_BIT_MASK(32));
3463 err = pci_set_consistent_dma_mask(pdev, DMA_BIT_MASK(32));
3464 /* both attempts failed: */
3466 IWL_WARN(priv, "No suitable DMA available.\n");
3467 goto out_pci_disable_device;
3471 err = pci_request_regions(pdev, DRV_NAME);
3473 goto out_pci_disable_device;
3475 pci_set_drvdata(pdev, priv);
3478 /***********************
3479 * 3. Read REV register
3480 ***********************/
3481 priv->hw_base = pci_iomap(pdev, 0, 0);
3482 if (!priv->hw_base) {
3484 goto out_pci_release_regions;
3487 IWL_DEBUG_INFO(priv, "pci_resource_len = 0x%08llx\n",
3488 (unsigned long long) pci_resource_len(pdev, 0));
3489 IWL_DEBUG_INFO(priv, "pci_resource_base = %p\n", priv->hw_base);
3491 /* these spin locks will be used in apm_ops.init and EEPROM access
3492 * we should init now
3494 spin_lock_init(&priv->reg_lock);
3495 spin_lock_init(&priv->lock);
3498 * stop and reset the on-board processor just in case it is in a
3499 * strange state ... like being left stranded by a primary kernel
3500 * and this is now the kdump kernel trying to start up
3502 iwl_write32(priv, CSR_RESET, CSR_RESET_REG_FLAG_NEVO_RESET);
3504 iwl_hw_detect(priv);
3505 IWL_INFO(priv, "Detected %s, REV=0x%X\n",
3506 priv->cfg->name, priv->hw_rev);
3508 /* We disable the RETRY_TIMEOUT register (0x41) to keep
3509 * PCI Tx retries from interfering with C3 CPU state */
3510 pci_write_config_byte(pdev, PCI_CFG_RETRY_TIMEOUT, 0x00);
3512 iwl_prepare_card_hw(priv);
3513 if (!priv->hw_ready) {
3514 IWL_WARN(priv, "Failed, HW not ready\n");
3521 /* Read the EEPROM */
3522 err = iwl_eeprom_init(priv);
3524 IWL_ERR(priv, "Unable to init EEPROM\n");
3527 err = iwl_eeprom_check_version(priv);
3529 goto out_free_eeprom;
3531 /* extract MAC Address */
3532 iwl_eeprom_get_mac(priv, priv->mac_addr);
3533 IWL_DEBUG_INFO(priv, "MAC address: %pM\n", priv->mac_addr);
3534 SET_IEEE80211_PERM_ADDR(priv->hw, priv->mac_addr);
3536 /************************
3537 * 5. Setup HW constants
3538 ************************/
3539 if (iwl_set_hw_params(priv)) {
3540 IWL_ERR(priv, "failed to set hw parameters\n");
3541 goto out_free_eeprom;
3544 /*******************
3546 *******************/
3548 err = iwl_init_drv(priv);
3550 goto out_free_eeprom;
3551 /* At this point both hw and priv are initialized. */
3553 /********************
3555 ********************/
3556 spin_lock_irqsave(&priv->lock, flags);
3557 iwl_disable_interrupts(priv);
3558 spin_unlock_irqrestore(&priv->lock, flags);
3560 pci_enable_msi(priv->pci_dev);
3562 iwl_alloc_isr_ict(priv);
3563 err = request_irq(priv->pci_dev->irq, priv->cfg->ops->lib->isr,
3564 IRQF_SHARED, DRV_NAME, priv);
3566 IWL_ERR(priv, "Error allocating IRQ %d\n", priv->pci_dev->irq);
3567 goto out_disable_msi;
3569 err = sysfs_create_group(&pdev->dev.kobj, &iwl_attribute_group);
3571 IWL_ERR(priv, "failed to create sysfs device attributes\n");
3575 iwl_setup_deferred_work(priv);
3576 iwl_setup_rx_handlers(priv);
3578 /*********************************************
3579 * 8. Enable interrupts and read RFKILL state
3580 *********************************************/
3582 /* enable interrupts if needed: hw bug w/a */
3583 pci_read_config_word(priv->pci_dev, PCI_COMMAND, &pci_cmd);
3584 if (pci_cmd & PCI_COMMAND_INTX_DISABLE) {
3585 pci_cmd &= ~PCI_COMMAND_INTX_DISABLE;
3586 pci_write_config_word(priv->pci_dev, PCI_COMMAND, pci_cmd);
3589 iwl_enable_interrupts(priv);
3591 /* If platform's RF_KILL switch is NOT set to KILL */
3592 if (iwl_read32(priv, CSR_GP_CNTRL) & CSR_GP_CNTRL_REG_FLAG_HW_RF_KILL_SW)
3593 clear_bit(STATUS_RF_KILL_HW, &priv->status);
3595 set_bit(STATUS_RF_KILL_HW, &priv->status);
3597 wiphy_rfkill_set_hw_state(priv->hw->wiphy,
3598 test_bit(STATUS_RF_KILL_HW, &priv->status));
3600 iwl_power_initialize(priv);
3601 iwl_tt_initialize(priv);
3603 err = iwl_request_firmware(priv, true);
3605 goto out_remove_sysfs;
3610 destroy_workqueue(priv->workqueue);
3611 priv->workqueue = NULL;
3612 sysfs_remove_group(&pdev->dev.kobj, &iwl_attribute_group);
3614 free_irq(priv->pci_dev->irq, priv);
3615 iwl_free_isr_ict(priv);
3617 pci_disable_msi(priv->pci_dev);
3618 iwl_uninit_drv(priv);
3620 iwl_eeprom_free(priv);
3622 pci_iounmap(pdev, priv->hw_base);
3623 out_pci_release_regions:
3624 pci_set_drvdata(pdev, NULL);
3625 pci_release_regions(pdev);
3626 out_pci_disable_device:
3627 pci_disable_device(pdev);
3628 out_ieee80211_free_hw:
3629 iwl_free_traffic_mem(priv);
3630 ieee80211_free_hw(priv->hw);
3635 static void __devexit iwl_pci_remove(struct pci_dev *pdev)
3637 struct iwl_priv *priv = pci_get_drvdata(pdev);
3638 unsigned long flags;
3643 IWL_DEBUG_INFO(priv, "*** UNLOAD DRIVER ***\n");
3645 iwl_dbgfs_unregister(priv);
3646 sysfs_remove_group(&pdev->dev.kobj, &iwl_attribute_group);
3648 /* ieee80211_unregister_hw call wil cause iwl_mac_stop to
3649 * to be called and iwl_down since we are removing the device
3650 * we need to set STATUS_EXIT_PENDING bit.
3652 set_bit(STATUS_EXIT_PENDING, &priv->status);
3653 if (priv->mac80211_registered) {
3654 ieee80211_unregister_hw(priv->hw);
3655 priv->mac80211_registered = 0;
3661 * Make sure device is reset to low power before unloading driver.
3662 * This may be redundant with iwl_down(), but there are paths to
3663 * run iwl_down() without calling apm_ops.stop(), and there are
3664 * paths to avoid running iwl_down() at all before leaving driver.
3665 * This (inexpensive) call *makes sure* device is reset.
3667 priv->cfg->ops->lib->apm_ops.stop(priv);
3671 /* make sure we flush any pending irq or
3672 * tasklet for the driver
3674 spin_lock_irqsave(&priv->lock, flags);
3675 iwl_disable_interrupts(priv);
3676 spin_unlock_irqrestore(&priv->lock, flags);
3678 iwl_synchronize_irq(priv);
3680 iwl_dealloc_ucode_pci(priv);
3683 iwlagn_rx_queue_free(priv, &priv->rxq);
3684 iwlagn_hw_txq_ctx_free(priv);
3686 iwl_eeprom_free(priv);
3689 /*netif_stop_queue(dev); */
3690 flush_workqueue(priv->workqueue);
3692 /* ieee80211_unregister_hw calls iwl_mac_stop, which flushes
3693 * priv->workqueue... so we can't take down the workqueue
3695 destroy_workqueue(priv->workqueue);
3696 priv->workqueue = NULL;
3697 iwl_free_traffic_mem(priv);
3699 free_irq(priv->pci_dev->irq, priv);
3700 pci_disable_msi(priv->pci_dev);
3701 pci_iounmap(pdev, priv->hw_base);
3702 pci_release_regions(pdev);
3703 pci_disable_device(pdev);
3704 pci_set_drvdata(pdev, NULL);
3706 iwl_uninit_drv(priv);
3708 iwl_free_isr_ict(priv);
3710 if (priv->ibss_beacon)
3711 dev_kfree_skb(priv->ibss_beacon);
3713 ieee80211_free_hw(priv->hw);
3717 /*****************************************************************************
3719 * driver and module entry point
3721 *****************************************************************************/
3723 /* Hardware specific file defines the PCI IDs table for that hardware module */
3724 static DEFINE_PCI_DEVICE_TABLE(iwl_hw_card_ids) = {
3725 #ifdef CONFIG_IWL4965
3726 {IWL_PCI_DEVICE(0x4229, PCI_ANY_ID, iwl4965_agn_cfg)},
3727 {IWL_PCI_DEVICE(0x4230, PCI_ANY_ID, iwl4965_agn_cfg)},
3728 #endif /* CONFIG_IWL4965 */
3729 #ifdef CONFIG_IWL5000
3730 /* 5100 Series WiFi */
3731 {IWL_PCI_DEVICE(0x4232, 0x1201, iwl5100_agn_cfg)}, /* Mini Card */
3732 {IWL_PCI_DEVICE(0x4232, 0x1301, iwl5100_agn_cfg)}, /* Half Mini Card */
3733 {IWL_PCI_DEVICE(0x4232, 0x1204, iwl5100_agn_cfg)}, /* Mini Card */
3734 {IWL_PCI_DEVICE(0x4232, 0x1304, iwl5100_agn_cfg)}, /* Half Mini Card */
3735 {IWL_PCI_DEVICE(0x4232, 0x1205, iwl5100_bgn_cfg)}, /* Mini Card */
3736 {IWL_PCI_DEVICE(0x4232, 0x1305, iwl5100_bgn_cfg)}, /* Half Mini Card */
3737 {IWL_PCI_DEVICE(0x4232, 0x1206, iwl5100_abg_cfg)}, /* Mini Card */
3738 {IWL_PCI_DEVICE(0x4232, 0x1306, iwl5100_abg_cfg)}, /* Half Mini Card */
3739 {IWL_PCI_DEVICE(0x4232, 0x1221, iwl5100_agn_cfg)}, /* Mini Card */
3740 {IWL_PCI_DEVICE(0x4232, 0x1321, iwl5100_agn_cfg)}, /* Half Mini Card */
3741 {IWL_PCI_DEVICE(0x4232, 0x1224, iwl5100_agn_cfg)}, /* Mini Card */
3742 {IWL_PCI_DEVICE(0x4232, 0x1324, iwl5100_agn_cfg)}, /* Half Mini Card */
3743 {IWL_PCI_DEVICE(0x4232, 0x1225, iwl5100_bgn_cfg)}, /* Mini Card */
3744 {IWL_PCI_DEVICE(0x4232, 0x1325, iwl5100_bgn_cfg)}, /* Half Mini Card */
3745 {IWL_PCI_DEVICE(0x4232, 0x1226, iwl5100_abg_cfg)}, /* Mini Card */
3746 {IWL_PCI_DEVICE(0x4232, 0x1326, iwl5100_abg_cfg)}, /* Half Mini Card */
3747 {IWL_PCI_DEVICE(0x4237, 0x1211, iwl5100_agn_cfg)}, /* Mini Card */
3748 {IWL_PCI_DEVICE(0x4237, 0x1311, iwl5100_agn_cfg)}, /* Half Mini Card */
3749 {IWL_PCI_DEVICE(0x4237, 0x1214, iwl5100_agn_cfg)}, /* Mini Card */
3750 {IWL_PCI_DEVICE(0x4237, 0x1314, iwl5100_agn_cfg)}, /* Half Mini Card */
3751 {IWL_PCI_DEVICE(0x4237, 0x1215, iwl5100_bgn_cfg)}, /* Mini Card */
3752 {IWL_PCI_DEVICE(0x4237, 0x1315, iwl5100_bgn_cfg)}, /* Half Mini Card */
3753 {IWL_PCI_DEVICE(0x4237, 0x1216, iwl5100_abg_cfg)}, /* Mini Card */
3754 {IWL_PCI_DEVICE(0x4237, 0x1316, iwl5100_abg_cfg)}, /* Half Mini Card */
3756 /* 5300 Series WiFi */
3757 {IWL_PCI_DEVICE(0x4235, 0x1021, iwl5300_agn_cfg)}, /* Mini Card */
3758 {IWL_PCI_DEVICE(0x4235, 0x1121, iwl5300_agn_cfg)}, /* Half Mini Card */
3759 {IWL_PCI_DEVICE(0x4235, 0x1024, iwl5300_agn_cfg)}, /* Mini Card */
3760 {IWL_PCI_DEVICE(0x4235, 0x1124, iwl5300_agn_cfg)}, /* Half Mini Card */
3761 {IWL_PCI_DEVICE(0x4235, 0x1001, iwl5300_agn_cfg)}, /* Mini Card */
3762 {IWL_PCI_DEVICE(0x4235, 0x1101, iwl5300_agn_cfg)}, /* Half Mini Card */
3763 {IWL_PCI_DEVICE(0x4235, 0x1004, iwl5300_agn_cfg)}, /* Mini Card */
3764 {IWL_PCI_DEVICE(0x4235, 0x1104, iwl5300_agn_cfg)}, /* Half Mini Card */
3765 {IWL_PCI_DEVICE(0x4236, 0x1011, iwl5300_agn_cfg)}, /* Mini Card */
3766 {IWL_PCI_DEVICE(0x4236, 0x1111, iwl5300_agn_cfg)}, /* Half Mini Card */
3767 {IWL_PCI_DEVICE(0x4236, 0x1014, iwl5300_agn_cfg)}, /* Mini Card */
3768 {IWL_PCI_DEVICE(0x4236, 0x1114, iwl5300_agn_cfg)}, /* Half Mini Card */
3770 /* 5350 Series WiFi/WiMax */
3771 {IWL_PCI_DEVICE(0x423A, 0x1001, iwl5350_agn_cfg)}, /* Mini Card */
3772 {IWL_PCI_DEVICE(0x423A, 0x1021, iwl5350_agn_cfg)}, /* Mini Card */
3773 {IWL_PCI_DEVICE(0x423B, 0x1011, iwl5350_agn_cfg)}, /* Mini Card */
3775 /* 5150 Series Wifi/WiMax */
3776 {IWL_PCI_DEVICE(0x423C, 0x1201, iwl5150_agn_cfg)}, /* Mini Card */
3777 {IWL_PCI_DEVICE(0x423C, 0x1301, iwl5150_agn_cfg)}, /* Half Mini Card */
3778 {IWL_PCI_DEVICE(0x423C, 0x1206, iwl5150_abg_cfg)}, /* Mini Card */
3779 {IWL_PCI_DEVICE(0x423C, 0x1306, iwl5150_abg_cfg)}, /* Half Mini Card */
3780 {IWL_PCI_DEVICE(0x423C, 0x1221, iwl5150_agn_cfg)}, /* Mini Card */
3781 {IWL_PCI_DEVICE(0x423C, 0x1321, iwl5150_agn_cfg)}, /* Half Mini Card */
3783 {IWL_PCI_DEVICE(0x423D, 0x1211, iwl5150_agn_cfg)}, /* Mini Card */
3784 {IWL_PCI_DEVICE(0x423D, 0x1311, iwl5150_agn_cfg)}, /* Half Mini Card */
3785 {IWL_PCI_DEVICE(0x423D, 0x1216, iwl5150_abg_cfg)}, /* Mini Card */
3786 {IWL_PCI_DEVICE(0x423D, 0x1316, iwl5150_abg_cfg)}, /* Half Mini Card */
3789 {IWL_PCI_DEVICE(0x422B, 0x1101, iwl6000_3agn_cfg)},
3790 {IWL_PCI_DEVICE(0x422B, 0x1121, iwl6000_3agn_cfg)},
3791 {IWL_PCI_DEVICE(0x422C, 0x1301, iwl6000i_2agn_cfg)},
3792 {IWL_PCI_DEVICE(0x422C, 0x1306, iwl6000i_2abg_cfg)},
3793 {IWL_PCI_DEVICE(0x422C, 0x1307, iwl6000i_2bg_cfg)},
3794 {IWL_PCI_DEVICE(0x422C, 0x1321, iwl6000i_2agn_cfg)},
3795 {IWL_PCI_DEVICE(0x422C, 0x1326, iwl6000i_2abg_cfg)},
3796 {IWL_PCI_DEVICE(0x4238, 0x1111, iwl6000_3agn_cfg)},
3797 {IWL_PCI_DEVICE(0x4239, 0x1311, iwl6000i_2agn_cfg)},
3798 {IWL_PCI_DEVICE(0x4239, 0x1316, iwl6000i_2abg_cfg)},
3800 /* 6x00 Series Gen2 */
3801 {IWL_PCI_DEVICE(0x0082, 0x1201, iwl6000g2i_2agn_cfg)},
3802 {IWL_PCI_DEVICE(0x0082, 0x1301, iwl6000g2i_2agn_cfg)},
3803 {IWL_PCI_DEVICE(0x0082, 0x1321, iwl6000g2i_2agn_cfg)},
3804 {IWL_PCI_DEVICE(0x0085, 0x1311, iwl6000g2i_2agn_cfg)},
3806 /* 6x50 WiFi/WiMax Series */
3807 {IWL_PCI_DEVICE(0x0087, 0x1301, iwl6050_2agn_cfg)},
3808 {IWL_PCI_DEVICE(0x0087, 0x1306, iwl6050_2abg_cfg)},
3809 {IWL_PCI_DEVICE(0x0087, 0x1321, iwl6050_2agn_cfg)},
3810 {IWL_PCI_DEVICE(0x0087, 0x1326, iwl6050_2abg_cfg)},
3811 {IWL_PCI_DEVICE(0x0089, 0x1311, iwl6050_2agn_cfg)},
3812 {IWL_PCI_DEVICE(0x0089, 0x1316, iwl6050_2abg_cfg)},
3814 /* 1000 Series WiFi */
3815 {IWL_PCI_DEVICE(0x0083, 0x1205, iwl1000_bgn_cfg)},
3816 {IWL_PCI_DEVICE(0x0083, 0x1305, iwl1000_bgn_cfg)},
3817 {IWL_PCI_DEVICE(0x0083, 0x1225, iwl1000_bgn_cfg)},
3818 {IWL_PCI_DEVICE(0x0083, 0x1325, iwl1000_bgn_cfg)},
3819 {IWL_PCI_DEVICE(0x0084, 0x1215, iwl1000_bgn_cfg)},
3820 {IWL_PCI_DEVICE(0x0084, 0x1315, iwl1000_bgn_cfg)},
3821 {IWL_PCI_DEVICE(0x0083, 0x1206, iwl1000_bg_cfg)},
3822 {IWL_PCI_DEVICE(0x0083, 0x1306, iwl1000_bg_cfg)},
3823 {IWL_PCI_DEVICE(0x0083, 0x1226, iwl1000_bg_cfg)},
3824 {IWL_PCI_DEVICE(0x0083, 0x1326, iwl1000_bg_cfg)},
3825 {IWL_PCI_DEVICE(0x0084, 0x1216, iwl1000_bg_cfg)},
3826 {IWL_PCI_DEVICE(0x0084, 0x1316, iwl1000_bg_cfg)},
3827 #endif /* CONFIG_IWL5000 */
3831 MODULE_DEVICE_TABLE(pci, iwl_hw_card_ids);
3833 static struct pci_driver iwl_driver = {
3835 .id_table = iwl_hw_card_ids,
3836 .probe = iwl_pci_probe,
3837 .remove = __devexit_p(iwl_pci_remove),
3839 .suspend = iwl_pci_suspend,
3840 .resume = iwl_pci_resume,
3844 static int __init iwl_init(void)
3848 printk(KERN_INFO DRV_NAME ": " DRV_DESCRIPTION ", " DRV_VERSION "\n");
3849 printk(KERN_INFO DRV_NAME ": " DRV_COPYRIGHT "\n");
3851 ret = iwlagn_rate_control_register();
3853 printk(KERN_ERR DRV_NAME
3854 "Unable to register rate control algorithm: %d\n", ret);
3858 ret = pci_register_driver(&iwl_driver);
3860 printk(KERN_ERR DRV_NAME "Unable to initialize PCI module\n");
3861 goto error_register;
3867 iwlagn_rate_control_unregister();
3871 static void __exit iwl_exit(void)
3873 pci_unregister_driver(&iwl_driver);
3874 iwlagn_rate_control_unregister();
3877 module_exit(iwl_exit);
3878 module_init(iwl_init);
3880 #ifdef CONFIG_IWLWIFI_DEBUG
3881 module_param_named(debug50, iwl_debug_level, uint, S_IRUGO);
3882 MODULE_PARM_DESC(debug50, "50XX debug output mask (deprecated)");
3883 module_param_named(debug, iwl_debug_level, uint, S_IRUGO | S_IWUSR);
3884 MODULE_PARM_DESC(debug, "debug output mask");
3887 module_param_named(swcrypto50, iwlagn_mod_params.sw_crypto, bool, S_IRUGO);
3888 MODULE_PARM_DESC(swcrypto50,
3889 "using crypto in software (default 0 [hardware]) (deprecated)");
3890 module_param_named(swcrypto, iwlagn_mod_params.sw_crypto, int, S_IRUGO);
3891 MODULE_PARM_DESC(swcrypto, "using crypto in software (default 0 [hardware])");
3892 module_param_named(queues_num50,
3893 iwlagn_mod_params.num_of_queues, int, S_IRUGO);
3894 MODULE_PARM_DESC(queues_num50,
3895 "number of hw queues in 50xx series (deprecated)");
3896 module_param_named(queues_num, iwlagn_mod_params.num_of_queues, int, S_IRUGO);
3897 MODULE_PARM_DESC(queues_num, "number of hw queues.");
3898 module_param_named(11n_disable50, iwlagn_mod_params.disable_11n, int, S_IRUGO);
3899 MODULE_PARM_DESC(11n_disable50, "disable 50XX 11n functionality (deprecated)");
3900 module_param_named(11n_disable, iwlagn_mod_params.disable_11n, int, S_IRUGO);
3901 MODULE_PARM_DESC(11n_disable, "disable 11n functionality");
3902 module_param_named(amsdu_size_8K50, iwlagn_mod_params.amsdu_size_8K,
3904 MODULE_PARM_DESC(amsdu_size_8K50,
3905 "enable 8K amsdu size in 50XX series (deprecated)");
3906 module_param_named(amsdu_size_8K, iwlagn_mod_params.amsdu_size_8K,
3908 MODULE_PARM_DESC(amsdu_size_8K, "enable 8K amsdu size");
3909 module_param_named(fw_restart50, iwlagn_mod_params.restart_fw, int, S_IRUGO);
3910 MODULE_PARM_DESC(fw_restart50,
3911 "restart firmware in case of error (deprecated)");
3912 module_param_named(fw_restart, iwlagn_mod_params.restart_fw, int, S_IRUGO);
3913 MODULE_PARM_DESC(fw_restart, "restart firmware in case of error");
3915 disable_hw_scan, iwlagn_mod_params.disable_hw_scan, int, S_IRUGO);
3916 MODULE_PARM_DESC(disable_hw_scan, "disable hardware scanning (default 0)");