Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
qcu.c
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2004-2008 Reyk Floeter <[email protected]>
3  * Copyright (c) 2006-2008 Nick Kossifidis <[email protected]>
4  *
5  * Permission to use, copy, modify, and distribute this software for any
6  * purpose with or without fee is hereby granted, provided that the above
7  * copyright notice and this permission notice appear in all copies.
8  *
9  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16  *
17  */
18 
19 /********************************************\
20 Queue Control Unit, DCF Control Unit Functions
21 \********************************************/
22 
23 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
24 
25 #include "ath5k.h"
26 #include "reg.h"
27 #include "debug.h"
28 #include <linux/log2.h>
29 
53 /******************\
54 * Helper functions *
55 \******************/
56 
62 u32
63 ath5k_hw_num_tx_pending(struct ath5k_hw *ah, unsigned int queue)
64 {
65  u32 pending;
66  AR5K_ASSERT_ENTRY(queue, ah->ah_capabilities.cap_queues.q_tx_num);
67 
68  /* Return if queue is declared inactive */
69  if (ah->ah_txq[queue].tqi_type == AR5K_TX_QUEUE_INACTIVE)
70  return false;
71 
72  /* XXX: How about AR5K_CFG_TXCNT ? */
73  if (ah->ah_version == AR5K_AR5210)
74  return false;
75 
76  pending = ath5k_hw_reg_read(ah, AR5K_QUEUE_STATUS(queue));
77  pending &= AR5K_QCU_STS_FRMPENDCNT;
78 
79  /* It's possible to have no frames pending even if TXE
80  * is set. To indicate that q has not stopped return
81  * true */
82  if (!pending && AR5K_REG_READ_Q(ah, AR5K_QCU_TXE, queue))
83  return true;
84 
85  return pending;
86 }
87 
93 void
95 {
96  if (WARN_ON(queue >= ah->ah_capabilities.cap_queues.q_tx_num))
97  return;
98 
99  /* This queue will be skipped in further operations */
100  ah->ah_txq[queue].tqi_type = AR5K_TX_QUEUE_INACTIVE;
101  /*For SIMR setup*/
103 }
104 
111 static u16
112 ath5k_cw_validate(u16 cw_req)
113 {
114  cw_req = min(cw_req, (u16)1023);
115 
116  /* Check if cw_req + 1 a power of 2 */
117  if (is_power_of_2(cw_req + 1))
118  return cw_req;
119 
120  /* Check if cw_req is a power of 2 */
121  if (is_power_of_2(cw_req))
122  return cw_req - 1;
123 
124  /* If none of the above is correct
125  * find the closest power of 2 */
126  cw_req = (u16) roundup_pow_of_two(cw_req) - 1;
127 
128  return cw_req;
129 }
130 
137 int
139  struct ath5k_txq_info *queue_info)
140 {
141  memcpy(queue_info, &ah->ah_txq[queue], sizeof(struct ath5k_txq_info));
142  return 0;
143 }
144 
153 int
155  const struct ath5k_txq_info *qinfo)
156 {
157  struct ath5k_txq_info *qi;
158 
159  AR5K_ASSERT_ENTRY(queue, ah->ah_capabilities.cap_queues.q_tx_num);
160 
161  qi = &ah->ah_txq[queue];
162 
163  if (qi->tqi_type == AR5K_TX_QUEUE_INACTIVE)
164  return -EIO;
165 
166  /* copy and validate values */
167  qi->tqi_type = qinfo->tqi_type;
168  qi->tqi_subtype = qinfo->tqi_subtype;
169  qi->tqi_flags = qinfo->tqi_flags;
170  /*
171  * According to the docs: Although the AIFS field is 8 bit wide,
172  * the maximum supported value is 0xFC. Setting it higher than that
173  * will cause the DCU to hang.
174  */
175  qi->tqi_aifs = min(qinfo->tqi_aifs, (u8)0xFC);
176  qi->tqi_cw_min = ath5k_cw_validate(qinfo->tqi_cw_min);
177  qi->tqi_cw_max = ath5k_cw_validate(qinfo->tqi_cw_max);
178  qi->tqi_cbr_period = qinfo->tqi_cbr_period;
180  qi->tqi_burst_time = qinfo->tqi_burst_time;
181  qi->tqi_ready_time = qinfo->tqi_ready_time;
182 
183  /*XXX: Is this supported on 5210 ?*/
184  /*XXX: Is this correct for AR5K_WME_AC_VI,VO ???*/
185  if ((qinfo->tqi_type == AR5K_TX_QUEUE_DATA &&
186  ((qinfo->tqi_subtype == AR5K_WME_AC_VI) ||
187  (qinfo->tqi_subtype == AR5K_WME_AC_VO))) ||
188  qinfo->tqi_type == AR5K_TX_QUEUE_UAPSD)
190 
191  return 0;
192 }
193 
202 int
204  struct ath5k_txq_info *queue_info)
205 {
206  unsigned int queue;
207  int ret;
208 
209  /*
210  * Get queue by type
211  */
212  /* 5210 only has 2 queues */
213  if (ah->ah_capabilities.cap_queues.q_tx_num == 2) {
214  switch (queue_type) {
215  case AR5K_TX_QUEUE_DATA:
217  break;
219  case AR5K_TX_QUEUE_CAB:
221  break;
222  default:
223  return -EINVAL;
224  }
225  } else {
226  switch (queue_type) {
227  case AR5K_TX_QUEUE_DATA:
228  for (queue = AR5K_TX_QUEUE_ID_DATA_MIN;
229  ah->ah_txq[queue].tqi_type !=
230  AR5K_TX_QUEUE_INACTIVE; queue++) {
231 
232  if (queue > AR5K_TX_QUEUE_ID_DATA_MAX)
233  return -EINVAL;
234  }
235  break;
236  case AR5K_TX_QUEUE_UAPSD:
237  queue = AR5K_TX_QUEUE_ID_UAPSD;
238  break;
240  queue = AR5K_TX_QUEUE_ID_BEACON;
241  break;
242  case AR5K_TX_QUEUE_CAB:
243  queue = AR5K_TX_QUEUE_ID_CAB;
244  break;
245  default:
246  return -EINVAL;
247  }
248  }
249 
250  /*
251  * Setup internal queue structure
252  */
253  memset(&ah->ah_txq[queue], 0, sizeof(struct ath5k_txq_info));
254  ah->ah_txq[queue].tqi_type = queue_type;
255 
256  if (queue_info != NULL) {
257  queue_info->tqi_type = queue_type;
258  ret = ath5k_hw_set_tx_queueprops(ah, queue, queue_info);
259  if (ret)
260  return ret;
261  }
262 
263  /*
264  * We use ah_txq_status to hold a temp value for
265  * the Secondary interrupt mask registers on 5211+
266  * check out ath5k_hw_reset_tx_queue
267  */
268  AR5K_Q_ENABLE_BITS(ah->ah_txq_status, queue);
269 
270  return queue;
271 }
272 
273 
274 /*******************************\
275 * Single QCU/DCU initialization *
276 \*******************************/
277 
286 void
288  unsigned int queue)
289 {
290  /* Single data queue on AR5210 */
291  if (ah->ah_version == AR5K_AR5210) {
292  struct ath5k_txq_info *tq = &ah->ah_txq[queue];
293 
294  if (queue > 0)
295  return;
296 
297  ath5k_hw_reg_write(ah,
308  /* DCU on AR5211+ */
309  } else {
310  ath5k_hw_reg_write(ah,
318  }
319 }
320 
329 int
330 ath5k_hw_reset_tx_queue(struct ath5k_hw *ah, unsigned int queue)
331 {
332  struct ath5k_txq_info *tq = &ah->ah_txq[queue];
333 
334  AR5K_ASSERT_ENTRY(queue, ah->ah_capabilities.cap_queues.q_tx_num);
335 
336  tq = &ah->ah_txq[queue];
337 
338  /* Skip if queue inactive or if we are on AR5210
339  * that doesn't have QCU/DCU */
340  if ((ah->ah_version == AR5K_AR5210) ||
342  return 0;
343 
344  /*
345  * Set contention window (cw_min/cw_max)
346  * and arbitrated interframe space (aifs)...
347  */
348  ath5k_hw_reg_write(ah,
352  AR5K_QUEUE_DFS_LOCAL_IFS(queue));
353 
354  /*
355  * Set tx retry limits for this queue
356  */
357  ath5k_hw_set_tx_retry_limits(ah, queue);
358 
359 
360  /*
361  * Set misc registers
362  */
363 
364  /* Enable DCU to wait for next fragment from QCU */
367 
368  /* On Maui and Spirit use the global seqnum on DCU */
372 
373  /* Constant bit rate period */
374  if (tq->tqi_cbr_period) {
375  ath5k_hw_reg_write(ah, AR5K_REG_SM(tq->tqi_cbr_period,
379  AR5K_QUEUE_CBRCFG(queue));
380 
383 
384  if (tq->tqi_cbr_overflow_limit)
387  }
388 
389  /* Ready time interval */
390  if (tq->tqi_ready_time && (tq->tqi_type != AR5K_TX_QUEUE_CAB))
391  ath5k_hw_reg_write(ah, AR5K_REG_SM(tq->tqi_ready_time,
394  AR5K_QUEUE_RDYTIMECFG(queue));
395 
396  if (tq->tqi_burst_time) {
397  ath5k_hw_reg_write(ah, AR5K_REG_SM(tq->tqi_burst_time,
401 
405  }
406 
407  /* Enable/disable Post frame backoff */
409  ath5k_hw_reg_write(ah, AR5K_DCU_MISC_POST_FR_BKOFF_DIS,
410  AR5K_QUEUE_DFS_MISC(queue));
411 
412  /* Enable/disable fragmentation burst backoff */
414  ath5k_hw_reg_write(ah, AR5K_DCU_MISC_BACKOFF_FRAG,
415  AR5K_QUEUE_DFS_MISC(queue));
416 
417  /*
418  * Set registers by queue type
419  */
420  switch (tq->tqi_type) {
426 
433  break;
434 
435  case AR5K_TX_QUEUE_CAB:
436  /* XXX: use BCN_SENT_GT, if we can figure out how */
441 
442  ath5k_hw_reg_write(ah, ((tq->tqi_ready_time -
447  AR5K_QUEUE_RDYTIMECFG(queue));
448 
452  break;
453 
454  case AR5K_TX_QUEUE_UAPSD:
457  break;
458 
459  case AR5K_TX_QUEUE_DATA:
460  default:
461  break;
462  }
463 
464  /* TODO: Handle frame compression */
465 
466  /*
467  * Enable interrupts for this tx queue
468  * in the secondary interrupt mask registers
469  */
472 
475 
478 
481 
484 
487 
490 
493 
496 
497  /* Update secondary interrupt mask registers */
498 
499  /* Filter out inactive queues */
500  ah->ah_txq_imr_txok &= ah->ah_txq_status;
501  ah->ah_txq_imr_txerr &= ah->ah_txq_status;
502  ah->ah_txq_imr_txurn &= ah->ah_txq_status;
503  ah->ah_txq_imr_txdesc &= ah->ah_txq_status;
504  ah->ah_txq_imr_txeol &= ah->ah_txq_status;
505  ah->ah_txq_imr_cbrorn &= ah->ah_txq_status;
506  ah->ah_txq_imr_cbrurn &= ah->ah_txq_status;
507  ah->ah_txq_imr_qtrig &= ah->ah_txq_status;
508  ah->ah_txq_imr_nofrm &= ah->ah_txq_status;
509 
510  ath5k_hw_reg_write(ah, AR5K_REG_SM(ah->ah_txq_imr_txok,
514  AR5K_SIMR0);
515 
516  ath5k_hw_reg_write(ah, AR5K_REG_SM(ah->ah_txq_imr_txerr,
520  AR5K_SIMR1);
521 
522  /* Update SIMR2 but don't overwrite rest simr2 settings */
527 
528  ath5k_hw_reg_write(ah, AR5K_REG_SM(ah->ah_txq_imr_cbrorn,
532  AR5K_SIMR3);
533 
534  ath5k_hw_reg_write(ah, AR5K_REG_SM(ah->ah_txq_imr_qtrig,
536 
537  /* Set TXNOFRM_QCU for the queues with TXNOFRM enabled */
538  ath5k_hw_reg_write(ah, AR5K_REG_SM(ah->ah_txq_imr_nofrm,
540 
541  /* No queue has TXNOFRM enabled, disable the interrupt
542  * by setting AR5K_TXNOFRM to zero */
543  if (ah->ah_txq_imr_nofrm == 0)
544  ath5k_hw_reg_write(ah, 0, AR5K_TXNOFRM);
545 
546  /* Set QCU mask for this DCU to save power */
547  AR5K_REG_WRITE_Q(ah, AR5K_QUEUE_QCUMASK(queue), queue);
548 
549  return 0;
550 }
551 
552 
553 /**************************\
554 * Global QCU/DCU functions *
555 \**************************/
556 
565 int ath5k_hw_set_ifs_intervals(struct ath5k_hw *ah, unsigned int slot_time)
566 {
568  enum ieee80211_band band;
569  struct ieee80211_rate *rate;
570  u32 ack_tx_time, eifs, eifs_clock, sifs, sifs_clock;
571  u32 slot_time_clock = ath5k_hw_htoclock(ah, slot_time);
572 
573  if (slot_time < 6 || slot_time_clock > AR5K_SLOT_TIME_MAX)
574  return -EINVAL;
575 
576  sifs = ath5k_hw_get_default_sifs(ah);
577  sifs_clock = ath5k_hw_htoclock(ah, sifs - 2);
578 
579  /* EIFS
580  * Txtime of ack at lowest rate + SIFS + DIFS
581  * (DIFS = SIFS + 2 * Slot time)
582  *
583  * Note: HAL has some predefined values for EIFS
584  * Turbo: (37 + 2 * 6)
585  * Default: (74 + 2 * 9)
586  * Half: (149 + 2 * 13)
587  * Quarter: (298 + 2 * 21)
588  *
589  * (74 + 2 * 6) for AR5210 default and turbo !
590  *
591  * According to the formula we have
592  * ack_tx_time = 25 for turbo and
593  * ack_tx_time = 42.5 * clock multiplier
594  * for default/half/quarter.
595  *
596  * This can't be right, 42 is what we would get
597  * from ath5k_hw_get_frame_dur_for_bwmode or
598  * ieee80211_generic_frame_duration for zero frame
599  * length and without SIFS !
600  *
601  * Also we have different lowest rate for 802.11a
602  */
603  if (channel->band == IEEE80211_BAND_5GHZ)
604  band = IEEE80211_BAND_5GHZ;
605  else
606  band = IEEE80211_BAND_2GHZ;
607 
608  rate = &ah->sbands[band].bitrates[0];
609  ack_tx_time = ath5k_hw_get_frame_duration(ah, band, 10, rate, false);
610 
611  /* ack_tx_time includes an SIFS already */
612  eifs = ack_tx_time + sifs + 2 * slot_time;
613  eifs_clock = ath5k_hw_htoclock(ah, eifs);
614 
615  /* Set IFS settings on AR5210 */
616  if (ah->ah_version == AR5K_AR5210) {
617  u32 pifs, pifs_clock, difs, difs_clock;
618 
619  /* Set slot time */
620  ath5k_hw_reg_write(ah, slot_time_clock, AR5K_SLOT_TIME);
621 
622  /* Set EIFS */
623  eifs_clock = AR5K_REG_SM(eifs_clock, AR5K_IFS1_EIFS);
624 
625  /* PIFS = Slot time + SIFS */
626  pifs = slot_time + sifs;
627  pifs_clock = ath5k_hw_htoclock(ah, pifs);
628  pifs_clock = AR5K_REG_SM(pifs_clock, AR5K_IFS1_PIFS);
629 
630  /* DIFS = SIFS + 2 * Slot time */
631  difs = sifs + 2 * slot_time;
632  difs_clock = ath5k_hw_htoclock(ah, difs);
633 
634  /* Set SIFS/DIFS */
635  ath5k_hw_reg_write(ah, (difs_clock <<
636  AR5K_IFS0_DIFS_S) | sifs_clock,
637  AR5K_IFS0);
638 
639  /* Set PIFS/EIFS and preserve AR5K_INIT_CARR_SENSE_EN */
640  ath5k_hw_reg_write(ah, pifs_clock | eifs_clock |
642  AR5K_IFS1);
643 
644  return 0;
645  }
646 
647  /* Set IFS slot time */
648  ath5k_hw_reg_write(ah, slot_time_clock, AR5K_DCU_GBL_IFS_SLOT);
649 
650  /* Set EIFS interval */
651  ath5k_hw_reg_write(ah, eifs_clock, AR5K_DCU_GBL_IFS_EIFS);
652 
653  /* Set SIFS interval in usecs */
656  sifs);
657 
658  /* Set SIFS interval in clock cycles */
659  ath5k_hw_reg_write(ah, sifs_clock, AR5K_DCU_GBL_IFS_SIFS);
660 
661  return 0;
662 }
663 
664 
672 int
674 {
675  int i, ret;
676 
677  /* TODO: HW Compression support for data queues */
678  /* TODO: Burst prefetch for data queues */
679 
680  /*
681  * Reset queues and start beacon timers at the end of the reset routine
682  * This also sets QCU mask on each DCU for 1:1 qcu to dcu mapping
683  * Note: If we want we can assign multiple qcus on one dcu.
684  */
685  if (ah->ah_version != AR5K_AR5210)
686  for (i = 0; i < ah->ah_capabilities.cap_queues.q_tx_num; i++) {
687  ret = ath5k_hw_reset_tx_queue(ah, i);
688  if (ret) {
689  ATH5K_ERR(ah,
690  "failed to reset TX queue #%d\n", i);
691  return ret;
692  }
693  }
694  else
695  /* No QCU/DCU on AR5210, just set tx
696  * retry limits. We set IFS parameters
697  * on ath5k_hw_set_ifs_intervals */
699 
700  /* Set the turbo flag when operating on 40MHz */
701  if (ah->ah_bwmode == AR5K_BWMODE_40MHZ)
704 
705  /* If we didn't set IFS timings through
706  * ath5k_hw_set_coverage_class make sure
707  * we set them here */
708  if (!ah->ah_coverage_class) {
709  unsigned int slot_time = ath5k_hw_get_default_slottime(ah);
710  ath5k_hw_set_ifs_intervals(ah, slot_time);
711  }
712 
713  return 0;
714 }