1 /******************************************************************************
3 * Copyright(c) 2003 - 2011 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 *****************************************************************************/
29 #include <linux/etherdevice.h>
30 #include <linux/slab.h>
31 #include <linux/sched.h>
33 /* TODO: remove include to iwl-dev.h */
35 #include "iwl-debug.h"
39 #include "iwl-agn-hw.h"
40 #include "iwl-helpers.h"
41 #include "iwl-trans-pcie-int.h"
43 #define IWL_TX_CRC_SIZE 4
44 #define IWL_TX_DELIMITER_SIZE 4
47 * iwl_trans_txq_update_byte_cnt_tbl - Set up entry in Tx byte-count array
49 void iwl_trans_txq_update_byte_cnt_tbl(struct iwl_trans *trans,
50 struct iwl_tx_queue *txq,
53 struct iwlagn_scd_bc_tbl *scd_bc_tbl;
54 struct iwl_trans_pcie *trans_pcie =
55 IWL_TRANS_GET_PCIE_TRANS(trans);
56 int write_ptr = txq->q.write_ptr;
57 int txq_id = txq->q.id;
60 u16 len = byte_cnt + IWL_TX_CRC_SIZE + IWL_TX_DELIMITER_SIZE;
62 struct iwl_tx_cmd *tx_cmd =
63 (struct iwl_tx_cmd *) txq->cmd[txq->q.write_ptr]->payload;
65 scd_bc_tbl = trans_pcie->scd_bc_tbls.addr;
67 WARN_ON(len > 0xFFF || write_ptr >= TFD_QUEUE_SIZE_MAX);
69 sta_id = tx_cmd->sta_id;
70 sec_ctl = tx_cmd->sec_ctl;
72 switch (sec_ctl & TX_CMD_SEC_MSK) {
80 len += WEP_IV_LEN + WEP_ICV_LEN;
84 bc_ent = cpu_to_le16((len & 0xFFF) | (sta_id << 12));
86 scd_bc_tbl[txq_id].tfd_offset[write_ptr] = bc_ent;
88 if (write_ptr < TFD_QUEUE_SIZE_BC_DUP)
90 tfd_offset[TFD_QUEUE_SIZE_MAX + write_ptr] = bc_ent;
94 * iwl_txq_update_write_ptr - Send new write index to hardware
96 void iwl_txq_update_write_ptr(struct iwl_trans *trans, struct iwl_tx_queue *txq)
99 int txq_id = txq->q.id;
101 if (txq->need_update == 0)
104 if (hw_params(trans).shadow_reg_enable) {
105 /* shadow register enabled */
106 iwl_write32(bus(trans), HBUS_TARG_WRPTR,
107 txq->q.write_ptr | (txq_id << 8));
109 /* if we're trying to save power */
110 if (test_bit(STATUS_POWER_PMI, &trans->shrd->status)) {
111 /* wake up nic if it's powered down ...
112 * uCode will wake up, and interrupt us again, so next
113 * time we'll skip this part. */
114 reg = iwl_read32(bus(trans), CSR_UCODE_DRV_GP1);
116 if (reg & CSR_UCODE_DRV_GP1_BIT_MAC_SLEEP) {
117 IWL_DEBUG_INFO(trans,
118 "Tx queue %d requesting wakeup,"
119 " GP1 = 0x%x\n", txq_id, reg);
120 iwl_set_bit(bus(trans), CSR_GP_CNTRL,
121 CSR_GP_CNTRL_REG_FLAG_MAC_ACCESS_REQ);
125 iwl_write_direct32(bus(trans), HBUS_TARG_WRPTR,
126 txq->q.write_ptr | (txq_id << 8));
129 * else not in power-save mode,
130 * uCode will never sleep when we're
131 * trying to tx (during RFKILL, we're not trying to tx).
134 iwl_write32(bus(trans), HBUS_TARG_WRPTR,
135 txq->q.write_ptr | (txq_id << 8));
137 txq->need_update = 0;
140 static inline dma_addr_t iwl_tfd_tb_get_addr(struct iwl_tfd *tfd, u8 idx)
142 struct iwl_tfd_tb *tb = &tfd->tbs[idx];
144 dma_addr_t addr = get_unaligned_le32(&tb->lo);
145 if (sizeof(dma_addr_t) > sizeof(u32))
147 ((dma_addr_t)(le16_to_cpu(tb->hi_n_len) & 0xF) << 16) << 16;
152 static inline u16 iwl_tfd_tb_get_len(struct iwl_tfd *tfd, u8 idx)
154 struct iwl_tfd_tb *tb = &tfd->tbs[idx];
156 return le16_to_cpu(tb->hi_n_len) >> 4;
159 static inline void iwl_tfd_set_tb(struct iwl_tfd *tfd, u8 idx,
160 dma_addr_t addr, u16 len)
162 struct iwl_tfd_tb *tb = &tfd->tbs[idx];
163 u16 hi_n_len = len << 4;
165 put_unaligned_le32(addr, &tb->lo);
166 if (sizeof(dma_addr_t) > sizeof(u32))
167 hi_n_len |= ((addr >> 16) >> 16) & 0xF;
169 tb->hi_n_len = cpu_to_le16(hi_n_len);
171 tfd->num_tbs = idx + 1;
174 static inline u8 iwl_tfd_get_num_tbs(struct iwl_tfd *tfd)
176 return tfd->num_tbs & 0x1f;
179 static void iwlagn_unmap_tfd(struct iwl_trans *trans, struct iwl_cmd_meta *meta,
180 struct iwl_tfd *tfd, enum dma_data_direction dma_dir)
185 /* Sanity check on number of chunks */
186 num_tbs = iwl_tfd_get_num_tbs(tfd);
188 if (num_tbs >= IWL_NUM_OF_TBS) {
189 IWL_ERR(trans, "Too many chunks: %i\n", num_tbs);
190 /* @todo issue fatal error, it is quite serious situation */
196 dma_unmap_single(bus(trans)->dev,
197 dma_unmap_addr(meta, mapping),
198 dma_unmap_len(meta, len),
201 /* Unmap chunks, if any. */
202 for (i = 1; i < num_tbs; i++)
203 dma_unmap_single(bus(trans)->dev, iwl_tfd_tb_get_addr(tfd, i),
204 iwl_tfd_tb_get_len(tfd, i), dma_dir);
208 * iwlagn_txq_free_tfd - Free all chunks referenced by TFD [txq->q.read_ptr]
209 * @trans - transport private data
211 * @index - the index of the TFD to be freed
212 *@dma_dir - the direction of the DMA mapping
214 * Does NOT advance any TFD circular buffer read/write indexes
215 * Does NOT free the TFD itself (which is within circular buffer)
217 void iwlagn_txq_free_tfd(struct iwl_trans *trans, struct iwl_tx_queue *txq,
218 int index, enum dma_data_direction dma_dir)
220 struct iwl_tfd *tfd_tmp = txq->tfds;
222 iwlagn_unmap_tfd(trans, &txq->meta[index], &tfd_tmp[index], dma_dir);
228 skb = txq->skbs[index];
230 /* Can be called from irqs-disabled context
231 * If skb is not NULL, it means that the whole queue is being
232 * freed and that the queue is not empty - free the skb
235 iwl_free_skb(priv(trans), skb);
236 txq->skbs[index] = NULL;
241 int iwlagn_txq_attach_buf_to_tfd(struct iwl_trans *trans,
242 struct iwl_tx_queue *txq,
243 dma_addr_t addr, u16 len,
247 struct iwl_tfd *tfd, *tfd_tmp;
252 tfd = &tfd_tmp[q->write_ptr];
255 memset(tfd, 0, sizeof(*tfd));
257 num_tbs = iwl_tfd_get_num_tbs(tfd);
259 /* Each TFD can point to a maximum 20 Tx buffers */
260 if (num_tbs >= IWL_NUM_OF_TBS) {
261 IWL_ERR(trans, "Error can not send more than %d chunks\n",
266 if (WARN_ON(addr & ~DMA_BIT_MASK(36)))
269 if (unlikely(addr & ~IWL_TX_DMA_MASK))
270 IWL_ERR(trans, "Unaligned address = %llx\n",
271 (unsigned long long)addr);
273 iwl_tfd_set_tb(tfd, num_tbs, addr, len);
278 /*************** DMA-QUEUE-GENERAL-FUNCTIONS *****
281 * Theory of operation
283 * A Tx or Rx queue resides in host DRAM, and is comprised of a circular buffer
284 * of buffer descriptors, each of which points to one or more data buffers for
285 * the device to read from or fill. Driver and device exchange status of each
286 * queue via "read" and "write" pointers. Driver keeps minimum of 2 empty
287 * entries in each circular buffer, to protect against confusing empty and full
290 * The device reads or writes the data in the queues via the device's several
291 * DMA/FIFO channels. Each queue is mapped to a single DMA channel.
293 * For Tx queue, there are low mark and high mark limits. If, after queuing
294 * the packet for Tx, free space become < low mark, Tx queue stopped. When
295 * reclaiming packets (on 'tx done IRQ), if free space become > high mark,
298 ***************************************************/
300 int iwl_queue_space(const struct iwl_queue *q)
302 int s = q->read_ptr - q->write_ptr;
304 if (q->read_ptr > q->write_ptr)
309 /* keep some reserve to not confuse empty and full situations */
317 * iwl_queue_init - Initialize queue's high/low-water and read/write indexes
319 int iwl_queue_init(struct iwl_queue *q, int count, int slots_num, u32 id)
322 q->n_window = slots_num;
325 /* count must be power-of-two size, otherwise iwl_queue_inc_wrap
326 * and iwl_queue_dec_wrap are broken. */
327 if (WARN_ON(!is_power_of_2(count)))
330 /* slots_num must be power-of-two size, otherwise
331 * get_cmd_index is broken. */
332 if (WARN_ON(!is_power_of_2(slots_num)))
335 q->low_mark = q->n_window / 4;
339 q->high_mark = q->n_window / 8;
340 if (q->high_mark < 2)
343 q->write_ptr = q->read_ptr = 0;
348 static void iwlagn_txq_inval_byte_cnt_tbl(struct iwl_trans *trans,
349 struct iwl_tx_queue *txq)
351 struct iwl_trans_pcie *trans_pcie =
352 IWL_TRANS_GET_PCIE_TRANS(trans);
353 struct iwlagn_scd_bc_tbl *scd_bc_tbl = trans_pcie->scd_bc_tbls.addr;
354 int txq_id = txq->q.id;
355 int read_ptr = txq->q.read_ptr;
358 struct iwl_tx_cmd *tx_cmd =
359 (struct iwl_tx_cmd *) txq->cmd[txq->q.read_ptr]->payload;
361 WARN_ON(read_ptr >= TFD_QUEUE_SIZE_MAX);
363 if (txq_id != trans->shrd->cmd_queue)
364 sta_id = tx_cmd->sta_id;
366 bc_ent = cpu_to_le16(1 | (sta_id << 12));
367 scd_bc_tbl[txq_id].tfd_offset[read_ptr] = bc_ent;
369 if (read_ptr < TFD_QUEUE_SIZE_BC_DUP)
371 tfd_offset[TFD_QUEUE_SIZE_MAX + read_ptr] = bc_ent;
374 static int iwlagn_tx_queue_set_q2ratid(struct iwl_trans *trans, u16 ra_tid,
381 struct iwl_trans_pcie *trans_pcie =
382 IWL_TRANS_GET_PCIE_TRANS(trans);
384 scd_q2ratid = ra_tid & SCD_QUEUE_RA_TID_MAP_RATID_MSK;
386 tbl_dw_addr = trans_pcie->scd_base_addr +
387 SCD_TRANS_TBL_OFFSET_QUEUE(txq_id);
389 tbl_dw = iwl_read_targ_mem(bus(trans), tbl_dw_addr);
392 tbl_dw = (scd_q2ratid << 16) | (tbl_dw & 0x0000FFFF);
394 tbl_dw = scd_q2ratid | (tbl_dw & 0xFFFF0000);
396 iwl_write_targ_mem(bus(trans), tbl_dw_addr, tbl_dw);
401 static void iwlagn_tx_queue_stop_scheduler(struct iwl_trans *trans, u16 txq_id)
403 /* Simply stop the queue, but don't change any configuration;
404 * the SCD_ACT_EN bit is the write-enable mask for the ACTIVE bit. */
405 iwl_write_prph(bus(trans),
406 SCD_QUEUE_STATUS_BITS(txq_id),
407 (0 << SCD_QUEUE_STTS_REG_POS_ACTIVE)|
408 (1 << SCD_QUEUE_STTS_REG_POS_SCD_ACT_EN));
411 void iwl_trans_set_wr_ptrs(struct iwl_trans *trans,
412 int txq_id, u32 index)
414 iwl_write_direct32(bus(trans), HBUS_TARG_WRPTR,
415 (index & 0xff) | (txq_id << 8));
416 iwl_write_prph(bus(trans), SCD_QUEUE_RDPTR(txq_id), index);
419 void iwl_trans_tx_queue_set_status(struct iwl_trans *trans,
420 struct iwl_tx_queue *txq,
421 int tx_fifo_id, int scd_retry)
423 struct iwl_trans_pcie *trans_pcie = IWL_TRANS_GET_PCIE_TRANS(trans);
424 int txq_id = txq->q.id;
426 test_bit(txq_id, &trans_pcie->txq_ctx_active_msk) ? 1 : 0;
428 iwl_write_prph(bus(trans), SCD_QUEUE_STATUS_BITS(txq_id),
429 (active << SCD_QUEUE_STTS_REG_POS_ACTIVE) |
430 (tx_fifo_id << SCD_QUEUE_STTS_REG_POS_TXF) |
431 (1 << SCD_QUEUE_STTS_REG_POS_WSL) |
432 SCD_QUEUE_STTS_REG_MSK);
434 txq->sched_retry = scd_retry;
436 IWL_DEBUG_INFO(trans, "%s %s Queue %d on FIFO %d\n",
437 active ? "Activate" : "Deactivate",
438 scd_retry ? "BA" : "AC/CMD", txq_id, tx_fifo_id);
441 static inline int get_fifo_from_tid(struct iwl_trans_pcie *trans_pcie,
444 const u8 *ac_to_fifo = trans_pcie->ac_to_fifo[ctx];
445 if (likely(tid < ARRAY_SIZE(tid_to_ac)))
446 return ac_to_fifo[tid_to_ac[tid]];
448 /* no support for TIDs 8-15 yet */
452 void iwl_trans_pcie_tx_agg_setup(struct iwl_trans *trans,
453 enum iwl_rxon_context_id ctx, int sta_id,
454 int tid, int frame_limit)
456 int tx_fifo, txq_id, ssn_idx;
459 struct iwl_tid_data *tid_data;
461 struct iwl_trans_pcie *trans_pcie =
462 IWL_TRANS_GET_PCIE_TRANS(trans);
464 if (WARN_ON(sta_id == IWL_INVALID_STATION))
466 if (WARN_ON(tid >= IWL_MAX_TID_COUNT))
469 tx_fifo = get_fifo_from_tid(trans_pcie, ctx, tid);
470 if (WARN_ON(tx_fifo < 0)) {
471 IWL_ERR(trans, "txq_agg_setup, bad fifo: %d\n", tx_fifo);
475 spin_lock_irqsave(&trans->shrd->sta_lock, flags);
476 tid_data = &trans->shrd->tid_data[sta_id][tid];
477 ssn_idx = SEQ_TO_SN(tid_data->seq_number);
478 txq_id = tid_data->agg.txq_id;
479 spin_unlock_irqrestore(&trans->shrd->sta_lock, flags);
481 ra_tid = BUILD_RAxTID(sta_id, tid);
483 spin_lock_irqsave(&trans->shrd->lock, flags);
485 /* Stop this Tx queue before configuring it */
486 iwlagn_tx_queue_stop_scheduler(trans, txq_id);
488 /* Map receiver-address / traffic-ID to this queue */
489 iwlagn_tx_queue_set_q2ratid(trans, ra_tid, txq_id);
491 /* Set this queue as a chain-building queue */
492 iwl_set_bits_prph(bus(trans), SCD_QUEUECHAIN_SEL, (1<<txq_id));
494 /* enable aggregations for the queue */
495 iwl_set_bits_prph(bus(trans), SCD_AGGR_SEL, (1<<txq_id));
497 /* Place first TFD at index corresponding to start sequence number.
498 * Assumes that ssn_idx is valid (!= 0xFFF) */
499 trans_pcie->txq[txq_id].q.read_ptr = (ssn_idx & 0xff);
500 trans_pcie->txq[txq_id].q.write_ptr = (ssn_idx & 0xff);
501 iwl_trans_set_wr_ptrs(trans, txq_id, ssn_idx);
503 /* Set up Tx window size and frame limit for this queue */
504 iwl_write_targ_mem(bus(trans), trans_pcie->scd_base_addr +
505 SCD_CONTEXT_QUEUE_OFFSET(txq_id) +
508 SCD_QUEUE_CTX_REG2_WIN_SIZE_POS) &
509 SCD_QUEUE_CTX_REG2_WIN_SIZE_MSK) |
511 SCD_QUEUE_CTX_REG2_FRAME_LIMIT_POS) &
512 SCD_QUEUE_CTX_REG2_FRAME_LIMIT_MSK));
514 iwl_set_bits_prph(bus(trans), SCD_INTERRUPT_MASK, (1 << txq_id));
516 /* Set up Status area in SRAM, map to Tx DMA/FIFO, activate the queue */
517 iwl_trans_tx_queue_set_status(trans, &trans_pcie->txq[txq_id],
520 trans_pcie->txq[txq_id].sta_id = sta_id;
521 trans_pcie->txq[txq_id].tid = tid;
523 spin_unlock_irqrestore(&trans->shrd->lock, flags);
527 * Find first available (lowest unused) Tx Queue, mark it "active".
528 * Called only when finding queue for aggregation.
529 * Should never return anything < 7, because they should already
530 * be in use as EDCA AC (0-3), Command (4), reserved (5, 6)
532 static int iwlagn_txq_ctx_activate_free(struct iwl_trans *trans)
534 struct iwl_trans_pcie *trans_pcie = IWL_TRANS_GET_PCIE_TRANS(trans);
537 for (txq_id = 0; txq_id < hw_params(trans).max_txq_num; txq_id++)
538 if (!test_and_set_bit(txq_id,
539 &trans_pcie->txq_ctx_active_msk))
544 int iwl_trans_pcie_tx_agg_alloc(struct iwl_trans *trans,
545 enum iwl_rxon_context_id ctx, int sta_id,
548 struct iwl_trans_pcie *trans_pcie = IWL_TRANS_GET_PCIE_TRANS(trans);
549 struct iwl_tid_data *tid_data;
553 txq_id = iwlagn_txq_ctx_activate_free(trans);
555 IWL_ERR(trans, "No free aggregation queue available\n");
559 spin_lock_irqsave(&trans->shrd->sta_lock, flags);
560 tid_data = &trans->shrd->tid_data[sta_id][tid];
561 *ssn = SEQ_TO_SN(tid_data->seq_number);
562 tid_data->agg.txq_id = txq_id;
563 iwl_set_swq_id(&trans_pcie->txq[txq_id], get_ac_from_tid(tid), txq_id);
565 tid_data = &trans->shrd->tid_data[sta_id][tid];
566 if (tid_data->tfds_in_queue == 0) {
567 IWL_DEBUG_HT(trans, "HW queue is empty\n");
568 tid_data->agg.state = IWL_AGG_ON;
569 iwl_start_tx_ba_trans_ready(priv(trans), ctx, sta_id, tid);
571 IWL_DEBUG_HT(trans, "HW queue is NOT empty: %d packets in HW"
572 "queue\n", tid_data->tfds_in_queue);
573 tid_data->agg.state = IWL_EMPTYING_HW_QUEUE_ADDBA;
575 spin_unlock_irqrestore(&trans->shrd->sta_lock, flags);
580 void iwl_trans_pcie_txq_agg_disable(struct iwl_trans *trans, int txq_id)
582 struct iwl_trans_pcie *trans_pcie = IWL_TRANS_GET_PCIE_TRANS(trans);
583 iwlagn_tx_queue_stop_scheduler(trans, txq_id);
585 iwl_clear_bits_prph(bus(trans), SCD_AGGR_SEL, (1 << txq_id));
587 trans_pcie->txq[txq_id].q.read_ptr = 0;
588 trans_pcie->txq[txq_id].q.write_ptr = 0;
589 /* supposes that ssn_idx is valid (!= 0xFFF) */
590 iwl_trans_set_wr_ptrs(trans, txq_id, 0);
592 iwl_clear_bits_prph(bus(trans), SCD_INTERRUPT_MASK, (1 << txq_id));
593 iwl_txq_ctx_deactivate(trans_pcie, txq_id);
594 iwl_trans_tx_queue_set_status(trans, &trans_pcie->txq[txq_id], 0, 0);
597 int iwl_trans_pcie_tx_agg_disable(struct iwl_trans *trans,
598 enum iwl_rxon_context_id ctx, int sta_id,
601 struct iwl_trans_pcie *trans_pcie = IWL_TRANS_GET_PCIE_TRANS(trans);
603 int read_ptr, write_ptr;
604 struct iwl_tid_data *tid_data;
607 spin_lock_irqsave(&trans->shrd->sta_lock, flags);
609 tid_data = &trans->shrd->tid_data[sta_id][tid];
610 txq_id = tid_data->agg.txq_id;
612 if ((IWLAGN_FIRST_AMPDU_QUEUE > txq_id) ||
613 (IWLAGN_FIRST_AMPDU_QUEUE +
614 hw_params(trans).num_ampdu_queues <= txq_id)) {
616 "queue number out of range: %d, must be %d to %d\n",
617 txq_id, IWLAGN_FIRST_AMPDU_QUEUE,
618 IWLAGN_FIRST_AMPDU_QUEUE +
619 hw_params(trans).num_ampdu_queues - 1);
620 spin_unlock_irqrestore(&trans->shrd->sta_lock, flags);
624 switch (trans->shrd->tid_data[sta_id][tid].agg.state) {
625 case IWL_EMPTYING_HW_QUEUE_ADDBA:
627 * This can happen if the peer stops aggregation
628 * again before we've had a chance to drain the
629 * queue we selected previously, i.e. before the
630 * session was really started completely.
632 IWL_DEBUG_HT(trans, "AGG stop before setup done\n");
637 IWL_WARN(trans, "Stopping AGG while state not ON "
638 "or starting for %d on %d (%d)\n", sta_id, tid,
639 trans->shrd->tid_data[sta_id][tid].agg.state);
640 spin_unlock_irqrestore(&trans->shrd->sta_lock, flags);
644 write_ptr = trans_pcie->txq[txq_id].q.write_ptr;
645 read_ptr = trans_pcie->txq[txq_id].q.read_ptr;
647 /* The queue is not empty */
648 if (write_ptr != read_ptr) {
649 IWL_DEBUG_HT(trans, "Stopping a non empty AGG HW QUEUE\n");
650 trans->shrd->tid_data[sta_id][tid].agg.state =
651 IWL_EMPTYING_HW_QUEUE_DELBA;
652 spin_unlock_irqrestore(&trans->shrd->sta_lock, flags);
656 IWL_DEBUG_HT(trans, "HW queue is empty\n");
658 trans->shrd->tid_data[sta_id][tid].agg.state = IWL_AGG_OFF;
660 /* do not restore/save irqs */
661 spin_unlock(&trans->shrd->sta_lock);
662 spin_lock(&trans->shrd->lock);
664 iwl_trans_pcie_txq_agg_disable(trans, txq_id);
666 spin_unlock_irqrestore(&trans->shrd->lock, flags);
668 iwl_stop_tx_ba_trans_ready(priv(trans), ctx, sta_id, tid);
673 /*************** HOST COMMAND QUEUE FUNCTIONS *****/
676 * iwl_enqueue_hcmd - enqueue a uCode command
677 * @priv: device private data point
678 * @cmd: a point to the ucode command structure
680 * The function returns < 0 values to indicate the operation is
681 * failed. On success, it turns the index (> 0) of command in the
684 static int iwl_enqueue_hcmd(struct iwl_trans *trans, struct iwl_host_cmd *cmd)
686 struct iwl_trans_pcie *trans_pcie = IWL_TRANS_GET_PCIE_TRANS(trans);
687 struct iwl_tx_queue *txq = &trans_pcie->txq[trans->shrd->cmd_queue];
688 struct iwl_queue *q = &txq->q;
689 struct iwl_device_cmd *out_cmd;
690 struct iwl_cmd_meta *out_meta;
691 dma_addr_t phys_addr;
694 u16 copy_size, cmd_size;
695 bool is_ct_kill = false;
696 bool had_nocopy = false;
699 #ifdef CONFIG_IWLWIFI_DEVICE_TRACING
700 const void *trace_bufs[IWL_MAX_CMD_TFDS + 1] = {};
701 int trace_lens[IWL_MAX_CMD_TFDS + 1] = {};
705 if (test_bit(STATUS_FW_ERROR, &trans->shrd->status)) {
706 IWL_WARN(trans, "fw recovery, no hcmd send\n");
710 if ((trans->shrd->ucode_owner == IWL_OWNERSHIP_TM) &&
711 !(cmd->flags & CMD_ON_DEMAND)) {
712 IWL_DEBUG_HC(trans, "tm own the uCode, no regular hcmd send\n");
716 copy_size = sizeof(out_cmd->hdr);
717 cmd_size = sizeof(out_cmd->hdr);
719 /* need one for the header if the first is NOCOPY */
720 BUILD_BUG_ON(IWL_MAX_CMD_TFDS > IWL_NUM_OF_TBS - 1);
722 for (i = 0; i < IWL_MAX_CMD_TFDS; i++) {
725 if (cmd->dataflags[i] & IWL_HCMD_DFL_NOCOPY) {
728 /* NOCOPY must not be followed by normal! */
729 if (WARN_ON(had_nocopy))
731 copy_size += cmd->len[i];
733 cmd_size += cmd->len[i];
737 * If any of the command structures end up being larger than
738 * the TFD_MAX_PAYLOAD_SIZE and they aren't dynamically
739 * allocated into separate TFDs, then we will need to
740 * increase the size of the buffers.
742 if (WARN_ON(copy_size > TFD_MAX_PAYLOAD_SIZE))
745 if (iwl_is_rfkill(trans->shrd) || iwl_is_ctkill(trans->shrd)) {
746 IWL_WARN(trans, "Not sending command - %s KILL\n",
747 iwl_is_rfkill(trans->shrd) ? "RF" : "CT");
751 spin_lock_irqsave(&trans->hcmd_lock, flags);
753 if (iwl_queue_space(q) < ((cmd->flags & CMD_ASYNC) ? 2 : 1)) {
754 spin_unlock_irqrestore(&trans->hcmd_lock, flags);
756 IWL_ERR(trans, "No space in command queue\n");
757 is_ct_kill = iwl_check_for_ct_kill(priv(trans));
759 IWL_ERR(trans, "Restarting adapter queue is full\n");
760 iwlagn_fw_error(priv(trans), false);
765 idx = get_cmd_index(q, q->write_ptr);
766 out_cmd = txq->cmd[idx];
767 out_meta = &txq->meta[idx];
769 memset(out_meta, 0, sizeof(*out_meta)); /* re-initialize to NULL */
770 if (cmd->flags & CMD_WANT_SKB)
771 out_meta->source = cmd;
773 /* set up the header */
775 out_cmd->hdr.cmd = cmd->id;
776 out_cmd->hdr.flags = 0;
777 out_cmd->hdr.sequence =
778 cpu_to_le16(QUEUE_TO_SEQ(trans->shrd->cmd_queue) |
779 INDEX_TO_SEQ(q->write_ptr));
781 /* and copy the data that needs to be copied */
783 cmd_dest = out_cmd->payload;
784 for (i = 0; i < IWL_MAX_CMD_TFDS; i++) {
787 if (cmd->dataflags[i] & IWL_HCMD_DFL_NOCOPY)
789 memcpy(cmd_dest, cmd->data[i], cmd->len[i]);
790 cmd_dest += cmd->len[i];
793 IWL_DEBUG_HC(trans, "Sending command %s (#%x), seq: 0x%04X, "
794 "%d bytes at %d[%d]:%d\n",
795 get_cmd_string(out_cmd->hdr.cmd),
797 le16_to_cpu(out_cmd->hdr.sequence), cmd_size,
798 q->write_ptr, idx, trans->shrd->cmd_queue);
800 phys_addr = dma_map_single(bus(trans)->dev, &out_cmd->hdr, copy_size,
802 if (unlikely(dma_mapping_error(bus(trans)->dev, phys_addr))) {
807 dma_unmap_addr_set(out_meta, mapping, phys_addr);
808 dma_unmap_len_set(out_meta, len, copy_size);
810 iwlagn_txq_attach_buf_to_tfd(trans, txq,
811 phys_addr, copy_size, 1);
812 #ifdef CONFIG_IWLWIFI_DEVICE_TRACING
813 trace_bufs[0] = &out_cmd->hdr;
814 trace_lens[0] = copy_size;
818 for (i = 0; i < IWL_MAX_CMD_TFDS; i++) {
821 if (!(cmd->dataflags[i] & IWL_HCMD_DFL_NOCOPY))
823 phys_addr = dma_map_single(bus(trans)->dev,
824 (void *)cmd->data[i],
825 cmd->len[i], DMA_BIDIRECTIONAL);
826 if (dma_mapping_error(bus(trans)->dev, phys_addr)) {
827 iwlagn_unmap_tfd(trans, out_meta,
828 &txq->tfds[q->write_ptr],
834 iwlagn_txq_attach_buf_to_tfd(trans, txq, phys_addr,
836 #ifdef CONFIG_IWLWIFI_DEVICE_TRACING
837 trace_bufs[trace_idx] = cmd->data[i];
838 trace_lens[trace_idx] = cmd->len[i];
843 out_meta->flags = cmd->flags;
845 txq->need_update = 1;
847 /* check that tracing gets all possible blocks */
848 BUILD_BUG_ON(IWL_MAX_CMD_TFDS + 1 != 3);
849 #ifdef CONFIG_IWLWIFI_DEVICE_TRACING
850 trace_iwlwifi_dev_hcmd(priv(trans), cmd->flags,
851 trace_bufs[0], trace_lens[0],
852 trace_bufs[1], trace_lens[1],
853 trace_bufs[2], trace_lens[2]);
856 /* Increment and update queue's write index */
857 q->write_ptr = iwl_queue_inc_wrap(q->write_ptr, q->n_bd);
858 iwl_txq_update_write_ptr(trans, txq);
861 spin_unlock_irqrestore(&trans->hcmd_lock, flags);
866 * iwl_hcmd_queue_reclaim - Reclaim TX command queue entries already Tx'd
868 * When FW advances 'R' index, all entries between old and new 'R' index
869 * need to be reclaimed. As result, some free space forms. If there is
870 * enough free space (> low mark), wake the stack that feeds us.
872 static void iwl_hcmd_queue_reclaim(struct iwl_trans *trans, int txq_id,
875 struct iwl_trans_pcie *trans_pcie = IWL_TRANS_GET_PCIE_TRANS(trans);
876 struct iwl_tx_queue *txq = &trans_pcie->txq[txq_id];
877 struct iwl_queue *q = &txq->q;
880 if ((idx >= q->n_bd) || (iwl_queue_used(q, idx) == 0)) {
881 IWL_ERR(trans, "%s: Read index for DMA queue txq id (%d), "
882 "index %d is out of range [0-%d] %d %d.\n", __func__,
883 txq_id, idx, q->n_bd, q->write_ptr, q->read_ptr);
887 for (idx = iwl_queue_inc_wrap(idx, q->n_bd); q->read_ptr != idx;
888 q->read_ptr = iwl_queue_inc_wrap(q->read_ptr, q->n_bd)) {
891 IWL_ERR(trans, "HCMD skipped: index (%d) %d %d\n", idx,
892 q->write_ptr, q->read_ptr);
893 iwlagn_fw_error(priv(trans), false);
900 * iwl_tx_cmd_complete - Pull unused buffers off the queue and reclaim them
901 * @rxb: Rx buffer to reclaim
902 * @handler_status: return value of the handler of the command
903 * (put in setup_rx_handlers)
905 * If an Rx buffer has an async callback associated with it the callback
906 * will be executed. The attached skb (if present) will only be freed
907 * if the callback returns 1
909 void iwl_tx_cmd_complete(struct iwl_trans *trans, struct iwl_rx_mem_buffer *rxb,
912 struct iwl_rx_packet *pkt = rxb_addr(rxb);
913 u16 sequence = le16_to_cpu(pkt->hdr.sequence);
914 int txq_id = SEQ_TO_QUEUE(sequence);
915 int index = SEQ_TO_INDEX(sequence);
917 struct iwl_device_cmd *cmd;
918 struct iwl_cmd_meta *meta;
919 struct iwl_trans_pcie *trans_pcie = IWL_TRANS_GET_PCIE_TRANS(trans);
920 struct iwl_tx_queue *txq = &trans_pcie->txq[trans->shrd->cmd_queue];
923 /* If a Tx command is being handled and it isn't in the actual
924 * command queue then there a command routing bug has been introduced
925 * in the queue management code. */
926 if (WARN(txq_id != trans->shrd->cmd_queue,
927 "wrong command queue %d (should be %d), sequence 0x%X readp=%d writep=%d\n",
928 txq_id, trans->shrd->cmd_queue, sequence,
929 trans_pcie->txq[trans->shrd->cmd_queue].q.read_ptr,
930 trans_pcie->txq[trans->shrd->cmd_queue].q.write_ptr)) {
931 iwl_print_hex_error(trans, pkt, 32);
935 cmd_index = get_cmd_index(&txq->q, index);
936 cmd = txq->cmd[cmd_index];
937 meta = &txq->meta[cmd_index];
939 txq->time_stamp = jiffies;
941 iwlagn_unmap_tfd(trans, meta, &txq->tfds[index],
944 /* Input error checking is done when commands are added to queue. */
945 if (meta->flags & CMD_WANT_SKB) {
946 meta->source->reply_page = (unsigned long)rxb_addr(rxb);
947 meta->source->handler_status = handler_status;
951 spin_lock_irqsave(&trans->hcmd_lock, flags);
953 iwl_hcmd_queue_reclaim(trans, txq_id, index);
955 if (!(meta->flags & CMD_ASYNC)) {
956 if (!test_bit(STATUS_HCMD_ACTIVE, &trans->shrd->status)) {
958 "HCMD_ACTIVE already clear for command %s\n",
959 get_cmd_string(cmd->hdr.cmd));
961 clear_bit(STATUS_HCMD_ACTIVE, &trans->shrd->status);
962 IWL_DEBUG_INFO(trans, "Clearing HCMD_ACTIVE for command %s\n",
963 get_cmd_string(cmd->hdr.cmd));
964 wake_up(&trans->shrd->wait_command_queue);
969 spin_unlock_irqrestore(&trans->hcmd_lock, flags);
972 #define HOST_COMPLETE_TIMEOUT (2 * HZ)
974 static int iwl_send_cmd_async(struct iwl_trans *trans, struct iwl_host_cmd *cmd)
978 /* An asynchronous command can not expect an SKB to be set. */
979 if (WARN_ON(cmd->flags & CMD_WANT_SKB))
983 if (test_bit(STATUS_EXIT_PENDING, &trans->shrd->status))
986 ret = iwl_enqueue_hcmd(trans, cmd);
988 IWL_ERR(trans, "Error sending %s: enqueue_hcmd failed: %d\n",
989 get_cmd_string(cmd->id), ret);
995 static int iwl_send_cmd_sync(struct iwl_trans *trans, struct iwl_host_cmd *cmd)
997 struct iwl_trans_pcie *trans_pcie = IWL_TRANS_GET_PCIE_TRANS(trans);
1001 lockdep_assert_held(&trans->shrd->mutex);
1003 IWL_DEBUG_INFO(trans, "Attempting to send sync command %s\n",
1004 get_cmd_string(cmd->id));
1006 set_bit(STATUS_HCMD_ACTIVE, &trans->shrd->status);
1007 IWL_DEBUG_INFO(trans, "Setting HCMD_ACTIVE for command %s\n",
1008 get_cmd_string(cmd->id));
1010 cmd_idx = iwl_enqueue_hcmd(trans, cmd);
1013 clear_bit(STATUS_HCMD_ACTIVE, &trans->shrd->status);
1014 IWL_ERR(trans, "Error sending %s: enqueue_hcmd failed: %d\n",
1015 get_cmd_string(cmd->id), ret);
1019 ret = wait_event_timeout(trans->shrd->wait_command_queue,
1020 !test_bit(STATUS_HCMD_ACTIVE, &trans->shrd->status),
1021 HOST_COMPLETE_TIMEOUT);
1023 if (test_bit(STATUS_HCMD_ACTIVE, &trans->shrd->status)) {
1024 struct iwl_priv *priv = priv(trans);
1025 struct iwl_tx_queue *txq =
1026 &trans_pcie->txq[priv->shrd->cmd_queue];
1027 struct iwl_queue *q = &txq->q;
1030 "Error sending %s: time out after %dms.\n",
1031 get_cmd_string(cmd->id),
1032 jiffies_to_msecs(HOST_COMPLETE_TIMEOUT));
1035 "Current CMD queue read_ptr %d write_ptr %d\n",
1036 q->read_ptr, q->write_ptr);
1038 clear_bit(STATUS_HCMD_ACTIVE, &trans->shrd->status);
1039 IWL_DEBUG_INFO(trans, "Clearing HCMD_ACTIVE for command"
1040 "%s\n", get_cmd_string(cmd->id));
1046 if (test_bit(STATUS_RF_KILL_HW, &trans->shrd->status)) {
1047 IWL_ERR(trans, "Command %s aborted: RF KILL Switch\n",
1048 get_cmd_string(cmd->id));
1052 if (test_bit(STATUS_FW_ERROR, &trans->shrd->status)) {
1053 IWL_ERR(trans, "Command %s failed: FW Error\n",
1054 get_cmd_string(cmd->id));
1058 if ((cmd->flags & CMD_WANT_SKB) && !cmd->reply_page) {
1059 IWL_ERR(trans, "Error: Response NULL in '%s'\n",
1060 get_cmd_string(cmd->id));
1068 if (cmd->flags & CMD_WANT_SKB) {
1070 * Cancel the CMD_WANT_SKB flag for the cmd in the
1071 * TX cmd queue. Otherwise in case the cmd comes
1072 * in later, it will possibly set an invalid
1073 * address (cmd->meta.source).
1075 trans_pcie->txq[trans->shrd->cmd_queue].meta[cmd_idx].flags &=
1079 if (cmd->reply_page) {
1080 iwl_free_pages(trans->shrd, cmd->reply_page);
1081 cmd->reply_page = 0;
1087 int iwl_trans_pcie_send_cmd(struct iwl_trans *trans, struct iwl_host_cmd *cmd)
1089 if (cmd->flags & CMD_ASYNC)
1090 return iwl_send_cmd_async(trans, cmd);
1092 return iwl_send_cmd_sync(trans, cmd);
1095 /* Frees buffers until index _not_ inclusive */
1096 int iwl_tx_queue_reclaim(struct iwl_trans *trans, int txq_id, int index,
1097 struct sk_buff_head *skbs)
1099 struct iwl_trans_pcie *trans_pcie = IWL_TRANS_GET_PCIE_TRANS(trans);
1100 struct iwl_tx_queue *txq = &trans_pcie->txq[txq_id];
1101 struct iwl_queue *q = &txq->q;
1105 /* This function is not meant to release cmd queue*/
1106 if (WARN_ON(txq_id == trans->shrd->cmd_queue))
1109 /*Since we free until index _not_ inclusive, the one before index is
1110 * the last we will free. This one must be used */
1111 last_to_free = iwl_queue_dec_wrap(index, q->n_bd);
1113 if ((index >= q->n_bd) ||
1114 (iwl_queue_used(q, last_to_free) == 0)) {
1115 IWL_ERR(trans, "%s: Read index for DMA queue txq id (%d), "
1116 "last_to_free %d is out of range [0-%d] %d %d.\n",
1117 __func__, txq_id, last_to_free, q->n_bd,
1118 q->write_ptr, q->read_ptr);
1122 IWL_DEBUG_TX_REPLY(trans, "reclaim: [%d, %d, %d]\n", txq_id,
1123 q->read_ptr, index);
1125 if (WARN_ON(!skb_queue_empty(skbs)))
1129 q->read_ptr != index;
1130 q->read_ptr = iwl_queue_inc_wrap(q->read_ptr, q->n_bd)) {
1132 if (WARN_ON_ONCE(txq->skbs[txq->q.read_ptr] == NULL))
1135 __skb_queue_tail(skbs, txq->skbs[txq->q.read_ptr]);
1137 txq->skbs[txq->q.read_ptr] = NULL;
1139 iwlagn_txq_inval_byte_cnt_tbl(trans, txq);
1141 iwlagn_txq_free_tfd(trans, txq, txq->q.read_ptr, DMA_TO_DEVICE);