iwl-prph.h 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275
  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 - 2013 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 COPYING.
  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 - 2013 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. /* Device system time */
  94. #define DEVICE_SYSTEM_TIME_REG 0xA0206C
  95. /*****************************************************************************
  96. * 7000/3000 series SHR DTS addresses *
  97. *****************************************************************************/
  98. #define SHR_MISC_WFM_DTS_EN (0x00a10024)
  99. #define DTSC_CFG_MODE (0x00a10604)
  100. #define DTSC_VREF_AVG (0x00a10648)
  101. #define DTSC_VREF5_AVG (0x00a1064c)
  102. #define DTSC_CFG_MODE_PERIODIC (0x2)
  103. #define DTSC_PTAT_AVG (0x00a10650)
  104. /**
  105. * Tx Scheduler
  106. *
  107. * The Tx Scheduler selects the next frame to be transmitted, choosing TFDs
  108. * (Transmit Frame Descriptors) from up to 16 circular Tx queues resident in
  109. * host DRAM. It steers each frame's Tx command (which contains the frame
  110. * data) into one of up to 7 prioritized Tx DMA FIFO channels within the
  111. * device. A queue maps to only one (selectable by driver) Tx DMA channel,
  112. * but one DMA channel may take input from several queues.
  113. *
  114. * Tx DMA FIFOs have dedicated purposes.
  115. *
  116. * For 5000 series and up, they are used differently
  117. * (cf. iwl5000_default_queue_to_tx_fifo in iwl-5000.c):
  118. *
  119. * 0 -- EDCA BK (background) frames, lowest priority
  120. * 1 -- EDCA BE (best effort) frames, normal priority
  121. * 2 -- EDCA VI (video) frames, higher priority
  122. * 3 -- EDCA VO (voice) and management frames, highest priority
  123. * 4 -- unused
  124. * 5 -- unused
  125. * 6 -- unused
  126. * 7 -- Commands
  127. *
  128. * Driver should normally map queues 0-6 to Tx DMA/FIFO channels 0-6.
  129. * In addition, driver can map the remaining queues to Tx DMA/FIFO
  130. * channels 0-3 to support 11n aggregation via EDCA DMA channels.
  131. *
  132. * The driver sets up each queue to work in one of two modes:
  133. *
  134. * 1) Scheduler-Ack, in which the scheduler automatically supports a
  135. * block-ack (BA) window of up to 64 TFDs. In this mode, each queue
  136. * contains TFDs for a unique combination of Recipient Address (RA)
  137. * and Traffic Identifier (TID), that is, traffic of a given
  138. * Quality-Of-Service (QOS) priority, destined for a single station.
  139. *
  140. * In scheduler-ack mode, the scheduler keeps track of the Tx status of
  141. * each frame within the BA window, including whether it's been transmitted,
  142. * and whether it's been acknowledged by the receiving station. The device
  143. * automatically processes block-acks received from the receiving STA,
  144. * and reschedules un-acked frames to be retransmitted (successful
  145. * Tx completion may end up being out-of-order).
  146. *
  147. * The driver must maintain the queue's Byte Count table in host DRAM
  148. * for this mode.
  149. * This mode does not support fragmentation.
  150. *
  151. * 2) FIFO (a.k.a. non-Scheduler-ACK), in which each TFD is processed in order.
  152. * The device may automatically retry Tx, but will retry only one frame
  153. * at a time, until receiving ACK from receiving station, or reaching
  154. * retry limit and giving up.
  155. *
  156. * The command queue (#4/#9) must use this mode!
  157. * This mode does not require use of the Byte Count table in host DRAM.
  158. *
  159. * Driver controls scheduler operation via 3 means:
  160. * 1) Scheduler registers
  161. * 2) Shared scheduler data base in internal SRAM
  162. * 3) Shared data in host DRAM
  163. *
  164. * Initialization:
  165. *
  166. * When loading, driver should allocate memory for:
  167. * 1) 16 TFD circular buffers, each with space for (typically) 256 TFDs.
  168. * 2) 16 Byte Count circular buffers in 16 KBytes contiguous memory
  169. * (1024 bytes for each queue).
  170. *
  171. * After receiving "Alive" response from uCode, driver must initialize
  172. * the scheduler (especially for queue #4/#9, the command queue, otherwise
  173. * the driver can't issue commands!):
  174. */
  175. #define SCD_MEM_LOWER_BOUND (0x0000)
  176. /**
  177. * Max Tx window size is the max number of contiguous TFDs that the scheduler
  178. * can keep track of at one time when creating block-ack chains of frames.
  179. * Note that "64" matches the number of ack bits in a block-ack packet.
  180. */
  181. #define SCD_WIN_SIZE 64
  182. #define SCD_FRAME_LIMIT 64
  183. #define SCD_TXFIFO_POS_TID (0)
  184. #define SCD_TXFIFO_POS_RA (4)
  185. #define SCD_QUEUE_RA_TID_MAP_RATID_MSK (0x01FF)
  186. /* agn SCD */
  187. #define SCD_QUEUE_STTS_REG_POS_TXF (0)
  188. #define SCD_QUEUE_STTS_REG_POS_ACTIVE (3)
  189. #define SCD_QUEUE_STTS_REG_POS_WSL (4)
  190. #define SCD_QUEUE_STTS_REG_POS_SCD_ACT_EN (19)
  191. #define SCD_QUEUE_STTS_REG_MSK (0x017F0000)
  192. #define SCD_QUEUE_CTX_REG1_CREDIT_POS (8)
  193. #define SCD_QUEUE_CTX_REG1_CREDIT_MSK (0x00FFFF00)
  194. #define SCD_QUEUE_CTX_REG1_SUPER_CREDIT_POS (24)
  195. #define SCD_QUEUE_CTX_REG1_SUPER_CREDIT_MSK (0xFF000000)
  196. #define SCD_QUEUE_CTX_REG2_WIN_SIZE_POS (0)
  197. #define SCD_QUEUE_CTX_REG2_WIN_SIZE_MSK (0x0000007F)
  198. #define SCD_QUEUE_CTX_REG2_FRAME_LIMIT_POS (16)
  199. #define SCD_QUEUE_CTX_REG2_FRAME_LIMIT_MSK (0x007F0000)
  200. /* Context Data */
  201. #define SCD_CONTEXT_MEM_LOWER_BOUND (SCD_MEM_LOWER_BOUND + 0x600)
  202. #define SCD_CONTEXT_MEM_UPPER_BOUND (SCD_MEM_LOWER_BOUND + 0x6A0)
  203. /* Tx status */
  204. #define SCD_TX_STTS_MEM_LOWER_BOUND (SCD_MEM_LOWER_BOUND + 0x6A0)
  205. #define SCD_TX_STTS_MEM_UPPER_BOUND (SCD_MEM_LOWER_BOUND + 0x7E0)
  206. /* Translation Data */
  207. #define SCD_TRANS_TBL_MEM_LOWER_BOUND (SCD_MEM_LOWER_BOUND + 0x7E0)
  208. #define SCD_TRANS_TBL_MEM_UPPER_BOUND (SCD_MEM_LOWER_BOUND + 0x808)
  209. #define SCD_CONTEXT_QUEUE_OFFSET(x)\
  210. (SCD_CONTEXT_MEM_LOWER_BOUND + ((x) * 8))
  211. #define SCD_TX_STTS_QUEUE_OFFSET(x)\
  212. (SCD_TX_STTS_MEM_LOWER_BOUND + ((x) * 16))
  213. #define SCD_TRANS_TBL_OFFSET_QUEUE(x) \
  214. ((SCD_TRANS_TBL_MEM_LOWER_BOUND + ((x) * 2)) & 0xfffc)
  215. #define SCD_BASE (PRPH_BASE + 0xa02c00)
  216. #define SCD_SRAM_BASE_ADDR (SCD_BASE + 0x0)
  217. #define SCD_DRAM_BASE_ADDR (SCD_BASE + 0x8)
  218. #define SCD_AIT (SCD_BASE + 0x0c)
  219. #define SCD_TXFACT (SCD_BASE + 0x10)
  220. #define SCD_ACTIVE (SCD_BASE + 0x14)
  221. #define SCD_QUEUECHAIN_SEL (SCD_BASE + 0xe8)
  222. #define SCD_CHAINEXT_EN (SCD_BASE + 0x244)
  223. #define SCD_AGGR_SEL (SCD_BASE + 0x248)
  224. #define SCD_INTERRUPT_MASK (SCD_BASE + 0x108)
  225. static inline unsigned int SCD_QUEUE_WRPTR(unsigned int chnl)
  226. {
  227. if (chnl < 20)
  228. return SCD_BASE + 0x18 + chnl * 4;
  229. WARN_ON_ONCE(chnl >= 32);
  230. return SCD_BASE + 0x284 + (chnl - 20) * 4;
  231. }
  232. static inline unsigned int SCD_QUEUE_RDPTR(unsigned int chnl)
  233. {
  234. if (chnl < 20)
  235. return SCD_BASE + 0x68 + chnl * 4;
  236. WARN_ON_ONCE(chnl >= 32);
  237. return SCD_BASE + 0x2B4 + (chnl - 20) * 4;
  238. }
  239. static inline unsigned int SCD_QUEUE_STATUS_BITS(unsigned int chnl)
  240. {
  241. if (chnl < 20)
  242. return SCD_BASE + 0x10c + chnl * 4;
  243. WARN_ON_ONCE(chnl >= 32);
  244. return SCD_BASE + 0x384 + (chnl - 20) * 4;
  245. }
  246. /*********************** END TX SCHEDULER *************************************/
  247. #endif /* __iwl_prph_h__ */