iwl-prph.h 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258
  1. /******************************************************************************
  2. *
  3. * This file is provided under a dual BSD/GPLv2 license. When using or
  4. * redistributing this file, you may do so under either license.
  5. *
  6. * GPL LICENSE SUMMARY
  7. *
  8. * Copyright(c) 2005 - 2012 Intel Corporation. All rights reserved.
  9. *
  10. * This program is free software; you can redistribute it and/or modify
  11. * it under the terms of version 2 of the GNU General Public License as
  12. * published by the Free Software Foundation.
  13. *
  14. * This program is distributed in the hope that it will be useful, but
  15. * WITHOUT ANY WARRANTY; without even the implied warranty of
  16. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  17. * General Public License for more details.
  18. *
  19. * You should have received a copy of the GNU General Public License
  20. * along with this program; if not, write to the Free Software
  21. * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110,
  22. * USA
  23. *
  24. * The full GNU General Public License is included in this distribution
  25. * in the file called LICENSE.GPL.
  26. *
  27. * Contact Information:
  28. * Intel Linux Wireless <ilw@linux.intel.com>
  29. * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
  30. *
  31. * BSD LICENSE
  32. *
  33. * Copyright(c) 2005 - 2012 Intel Corporation. All rights reserved.
  34. * All rights reserved.
  35. *
  36. * Redistribution and use in source and binary forms, with or without
  37. * modification, are permitted provided that the following conditions
  38. * are met:
  39. *
  40. * * Redistributions of source code must retain the above copyright
  41. * notice, this list of conditions and the following disclaimer.
  42. * * Redistributions in binary form must reproduce the above copyright
  43. * notice, this list of conditions and the following disclaimer in
  44. * the documentation and/or other materials provided with the
  45. * distribution.
  46. * * Neither the name Intel Corporation nor the names of its
  47. * contributors may be used to endorse or promote products derived
  48. * from this software without specific prior written permission.
  49. *
  50. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  51. * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  52. * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  53. * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  54. * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  55. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  56. * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  57. * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  58. * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  59. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  60. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  61. *****************************************************************************/
  62. #ifndef __iwl_prph_h__
  63. #define __iwl_prph_h__
  64. /*
  65. * Registers in this file are internal, not PCI bus memory mapped.
  66. * Driver accesses these via HBUS_TARG_PRPH_* registers.
  67. */
  68. #define PRPH_BASE (0x00000)
  69. #define PRPH_END (0xFFFFF)
  70. /* APMG (power management) constants */
  71. #define APMG_BASE (PRPH_BASE + 0x3000)
  72. #define APMG_CLK_CTRL_REG (APMG_BASE + 0x0000)
  73. #define APMG_CLK_EN_REG (APMG_BASE + 0x0004)
  74. #define APMG_CLK_DIS_REG (APMG_BASE + 0x0008)
  75. #define APMG_PS_CTRL_REG (APMG_BASE + 0x000c)
  76. #define APMG_PCIDEV_STT_REG (APMG_BASE + 0x0010)
  77. #define APMG_RFKILL_REG (APMG_BASE + 0x0014)
  78. #define APMG_RTC_INT_STT_REG (APMG_BASE + 0x001c)
  79. #define APMG_RTC_INT_MSK_REG (APMG_BASE + 0x0020)
  80. #define APMG_DIGITAL_SVR_REG (APMG_BASE + 0x0058)
  81. #define APMG_ANALOG_SVR_REG (APMG_BASE + 0x006C)
  82. #define APMS_CLK_VAL_MRB_FUNC_MODE (0x00000001)
  83. #define APMG_CLK_VAL_DMA_CLK_RQT (0x00000200)
  84. #define APMG_CLK_VAL_BSM_CLK_RQT (0x00000800)
  85. #define APMG_PS_CTRL_EARLY_PWR_OFF_RESET_DIS (0x00400000)
  86. #define APMG_PS_CTRL_VAL_RESET_REQ (0x04000000)
  87. #define APMG_PS_CTRL_MSK_PWR_SRC (0x03000000)
  88. #define APMG_PS_CTRL_VAL_PWR_SRC_VMAIN (0x00000000)
  89. #define APMG_PS_CTRL_VAL_PWR_SRC_VAUX (0x02000000)
  90. #define APMG_SVR_VOLTAGE_CONFIG_BIT_MSK (0x000001E0) /* bit 8:5 */
  91. #define APMG_SVR_DIGITAL_VOLTAGE_1_32 (0x00000060)
  92. #define APMG_PCIDEV_STT_VAL_L1_ACT_DIS (0x00000800)
  93. /**
  94. * Tx Scheduler
  95. *
  96. * The Tx Scheduler selects the next frame to be transmitted, choosing TFDs
  97. * (Transmit Frame Descriptors) from up to 16 circular Tx queues resident in
  98. * host DRAM. It steers each frame's Tx command (which contains the frame
  99. * data) into one of up to 7 prioritized Tx DMA FIFO channels within the
  100. * device. A queue maps to only one (selectable by driver) Tx DMA channel,
  101. * but one DMA channel may take input from several queues.
  102. *
  103. * Tx DMA FIFOs have dedicated purposes.
  104. *
  105. * For 5000 series and up, they are used differently
  106. * (cf. iwl5000_default_queue_to_tx_fifo in iwl-5000.c):
  107. *
  108. * 0 -- EDCA BK (background) frames, lowest priority
  109. * 1 -- EDCA BE (best effort) frames, normal priority
  110. * 2 -- EDCA VI (video) frames, higher priority
  111. * 3 -- EDCA VO (voice) and management frames, highest priority
  112. * 4 -- unused
  113. * 5 -- unused
  114. * 6 -- unused
  115. * 7 -- Commands
  116. *
  117. * Driver should normally map queues 0-6 to Tx DMA/FIFO channels 0-6.
  118. * In addition, driver can map the remaining queues to Tx DMA/FIFO
  119. * channels 0-3 to support 11n aggregation via EDCA DMA channels.
  120. *
  121. * The driver sets up each queue to work in one of two modes:
  122. *
  123. * 1) Scheduler-Ack, in which the scheduler automatically supports a
  124. * block-ack (BA) window of up to 64 TFDs. In this mode, each queue
  125. * contains TFDs for a unique combination of Recipient Address (RA)
  126. * and Traffic Identifier (TID), that is, traffic of a given
  127. * Quality-Of-Service (QOS) priority, destined for a single station.
  128. *
  129. * In scheduler-ack mode, the scheduler keeps track of the Tx status of
  130. * each frame within the BA window, including whether it's been transmitted,
  131. * and whether it's been acknowledged by the receiving station. The device
  132. * automatically processes block-acks received from the receiving STA,
  133. * and reschedules un-acked frames to be retransmitted (successful
  134. * Tx completion may end up being out-of-order).
  135. *
  136. * The driver must maintain the queue's Byte Count table in host DRAM
  137. * for this mode.
  138. * This mode does not support fragmentation.
  139. *
  140. * 2) FIFO (a.k.a. non-Scheduler-ACK), in which each TFD is processed in order.
  141. * The device may automatically retry Tx, but will retry only one frame
  142. * at a time, until receiving ACK from receiving station, or reaching
  143. * retry limit and giving up.
  144. *
  145. * The command queue (#4/#9) must use this mode!
  146. * This mode does not require use of the Byte Count table in host DRAM.
  147. *
  148. * Driver controls scheduler operation via 3 means:
  149. * 1) Scheduler registers
  150. * 2) Shared scheduler data base in internal SRAM
  151. * 3) Shared data in host DRAM
  152. *
  153. * Initialization:
  154. *
  155. * When loading, driver should allocate memory for:
  156. * 1) 16 TFD circular buffers, each with space for (typically) 256 TFDs.
  157. * 2) 16 Byte Count circular buffers in 16 KBytes contiguous memory
  158. * (1024 bytes for each queue).
  159. *
  160. * After receiving "Alive" response from uCode, driver must initialize
  161. * the scheduler (especially for queue #4/#9, the command queue, otherwise
  162. * the driver can't issue commands!):
  163. */
  164. #define SCD_MEM_LOWER_BOUND (0x0000)
  165. /**
  166. * Max Tx window size is the max number of contiguous TFDs that the scheduler
  167. * can keep track of at one time when creating block-ack chains of frames.
  168. * Note that "64" matches the number of ack bits in a block-ack packet.
  169. */
  170. #define SCD_WIN_SIZE 64
  171. #define SCD_FRAME_LIMIT 64
  172. #define SCD_TXFIFO_POS_TID (0)
  173. #define SCD_TXFIFO_POS_RA (4)
  174. #define SCD_QUEUE_RA_TID_MAP_RATID_MSK (0x01FF)
  175. /* agn SCD */
  176. #define SCD_QUEUE_STTS_REG_POS_TXF (0)
  177. #define SCD_QUEUE_STTS_REG_POS_ACTIVE (3)
  178. #define SCD_QUEUE_STTS_REG_POS_WSL (4)
  179. #define SCD_QUEUE_STTS_REG_POS_SCD_ACT_EN (19)
  180. #define SCD_QUEUE_STTS_REG_MSK (0x00FF0000)
  181. #define SCD_QUEUE_CTX_REG1_CREDIT_POS (8)
  182. #define SCD_QUEUE_CTX_REG1_CREDIT_MSK (0x00FFFF00)
  183. #define SCD_QUEUE_CTX_REG1_SUPER_CREDIT_POS (24)
  184. #define SCD_QUEUE_CTX_REG1_SUPER_CREDIT_MSK (0xFF000000)
  185. #define SCD_QUEUE_CTX_REG2_WIN_SIZE_POS (0)
  186. #define SCD_QUEUE_CTX_REG2_WIN_SIZE_MSK (0x0000007F)
  187. #define SCD_QUEUE_CTX_REG2_FRAME_LIMIT_POS (16)
  188. #define SCD_QUEUE_CTX_REG2_FRAME_LIMIT_MSK (0x007F0000)
  189. /* Context Data */
  190. #define SCD_CONTEXT_MEM_LOWER_BOUND (SCD_MEM_LOWER_BOUND + 0x600)
  191. #define SCD_CONTEXT_MEM_UPPER_BOUND (SCD_MEM_LOWER_BOUND + 0x6A0)
  192. /* Tx status */
  193. #define SCD_TX_STTS_MEM_LOWER_BOUND (SCD_MEM_LOWER_BOUND + 0x6A0)
  194. #define SCD_TX_STTS_MEM_UPPER_BOUND (SCD_MEM_LOWER_BOUND + 0x7E0)
  195. /* Translation Data */
  196. #define SCD_TRANS_TBL_MEM_LOWER_BOUND (SCD_MEM_LOWER_BOUND + 0x7E0)
  197. #define SCD_TRANS_TBL_MEM_UPPER_BOUND (SCD_MEM_LOWER_BOUND + 0x808)
  198. #define SCD_CONTEXT_QUEUE_OFFSET(x)\
  199. (SCD_CONTEXT_MEM_LOWER_BOUND + ((x) * 8))
  200. #define SCD_TRANS_TBL_OFFSET_QUEUE(x) \
  201. ((SCD_TRANS_TBL_MEM_LOWER_BOUND + ((x) * 2)) & 0xfffc)
  202. #define SCD_BASE (PRPH_BASE + 0xa02c00)
  203. #define SCD_SRAM_BASE_ADDR (SCD_BASE + 0x0)
  204. #define SCD_DRAM_BASE_ADDR (SCD_BASE + 0x8)
  205. #define SCD_AIT (SCD_BASE + 0x0c)
  206. #define SCD_TXFACT (SCD_BASE + 0x10)
  207. #define SCD_ACTIVE (SCD_BASE + 0x14)
  208. #define SCD_QUEUECHAIN_SEL (SCD_BASE + 0xe8)
  209. #define SCD_CHAINEXT_EN (SCD_BASE + 0x244)
  210. #define SCD_AGGR_SEL (SCD_BASE + 0x248)
  211. #define SCD_INTERRUPT_MASK (SCD_BASE + 0x108)
  212. static inline unsigned int SCD_QUEUE_WRPTR(unsigned int chnl)
  213. {
  214. if (chnl < 20)
  215. return SCD_BASE + 0x18 + chnl * 4;
  216. WARN_ON_ONCE(chnl >= 32);
  217. return SCD_BASE + 0x284 + (chnl - 20) * 4;
  218. }
  219. static inline unsigned int SCD_QUEUE_RDPTR(unsigned int chnl)
  220. {
  221. if (chnl < 20)
  222. return SCD_BASE + 0x68 + chnl * 4;
  223. WARN_ON_ONCE(chnl >= 32);
  224. return SCD_BASE + 0x2B4 + (chnl - 20) * 4;
  225. }
  226. static inline unsigned int SCD_QUEUE_STATUS_BITS(unsigned int chnl)
  227. {
  228. if (chnl < 20)
  229. return SCD_BASE + 0x10c + chnl * 4;
  230. WARN_ON_ONCE(chnl >= 32);
  231. return SCD_BASE + 0x384 + (chnl - 20) * 4;
  232. }
  233. /*********************** END TX SCHEDULER *************************************/
  234. #endif /* __iwl_prph_h__ */