hal_hw_headers.h 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409
  1. /*
  2. * Copyright (c) 2016-2021 The Linux Foundation. All rights reserved.
  3. *
  4. * Permission to use, copy, modify, and/or distribute this software for
  5. * any purpose with or without fee is hereby granted, provided that the
  6. * above copyright notice and this permission notice appear in all
  7. * copies.
  8. *
  9. * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
  10. * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
  11. * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
  12. * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
  13. * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
  14. * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  15. * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  16. * PERFORMANCE OF THIS SOFTWARE.
  17. */
  18. #ifndef _HAL_HW_INTERNAL_H_
  19. #define _HAL_HW_INTERNAL_H_
  20. #include "qdf_types.h"
  21. #include "qdf_lock.h"
  22. #include "qdf_mem.h"
  23. #include "qdf_trace.h"
  24. #include "rx_msdu_link.h"
  25. #include "rx_reo_queue.h"
  26. #include "rx_reo_queue_ext.h"
  27. #include "wcss_seq_hwiobase.h"
  28. #include "tlv_hdr.h"
  29. #include "tlv_tag_def.h"
  30. #include "reo_destination_ring.h"
  31. #include "reo_entrance_ring.h"
  32. #include "reo_get_queue_stats.h"
  33. #include "reo_get_queue_stats_status.h"
  34. #include "tcl_data_cmd.h"
  35. #include "tcl_gse_cmd.h"
  36. #include "tcl_status_ring.h"
  37. #include "ce_src_desc.h"
  38. #include "ce_stat_desc.h"
  39. #include "wbm_link_descriptor_ring.h"
  40. #include "wbm_buffer_ring.h"
  41. #include "wbm_release_ring.h"
  42. #include "rx_msdu_desc_info.h"
  43. #include "rx_mpdu_start.h"
  44. #include "rx_mpdu_end.h"
  45. #include "rx_msdu_start.h"
  46. #include "rx_msdu_end.h"
  47. #include "rx_attention.h"
  48. #include "rx_ppdu_start.h"
  49. #include "rx_ppdu_start_user_info.h"
  50. #include "rx_ppdu_end_user_stats.h"
  51. #include "rx_ppdu_end_user_stats_ext.h"
  52. #include "rx_mpdu_desc_info.h"
  53. #include "rxpcu_ppdu_end_info.h"
  54. #include "phyrx_he_sig_a_su.h"
  55. #include "phyrx_he_sig_a_mu_dl.h"
  56. #if defined(QCA_WIFI_QCA6290_11AX_MU_UL) && defined(QCA_WIFI_QCA6290_11AX)
  57. #include "phyrx_he_sig_a_mu_ul.h"
  58. #endif
  59. #include "phyrx_he_sig_b1_mu.h"
  60. #include "phyrx_he_sig_b2_mu.h"
  61. #include "phyrx_he_sig_b2_ofdma.h"
  62. #include "phyrx_l_sig_a.h"
  63. #include "phyrx_l_sig_b.h"
  64. #include "phyrx_vht_sig_a.h"
  65. #include "phyrx_ht_sig.h"
  66. #include "tx_msdu_extension.h"
  67. #include "receive_rssi_info.h"
  68. #include "phyrx_pkt_end.h"
  69. #include "phyrx_rssi_legacy.h"
  70. #include "wcss_version.h"
  71. #include "rx_msdu_link.h"
  72. #include "hal_internal.h"
  73. #define HAL_SRNG_REO_EXCEPTION HAL_SRNG_REO2SW1
  74. #define HAL_SRNG_REO_ALTERNATE_SELECT 0x7
  75. #define HAL_NON_QOS_TID 16
  76. /* TODO: Check if the following can be provided directly by HW headers */
  77. #define SRNG_LOOP_CNT_MASK REO_DESTINATION_RING_15_LOOPING_COUNT_MASK
  78. #define SRNG_LOOP_CNT_LSB REO_DESTINATION_RING_15_LOOPING_COUNT_LSB
  79. #define HAL_REO_R0_REO2SW1_RING_MSI1_BASE_MSB_ADDR_SHFT 0x0
  80. #define HAL_REO_R0_REO2SW1_RING_MSI1_BASE_MSB_ADDR_BMSK 0xff
  81. #define HAL_REO_R0_REO2SW1_RING_MSI1_BASE_MSB_MSI1_ENABLE_SHFT 0x8
  82. #define HAL_REO_R0_REO2SW1_RING_MSI1_BASE_MSB_MSI1_ENABLE_BMSK 0x100
  83. #define HAL_REO_R0_REO2SW1_RING_BASE_MSB_RING_BASE_ADDR_MSB_SHFT 0x0
  84. #define HAL_REO_R0_REO2SW1_RING_BASE_MSB_RING_BASE_ADDR_MSB_BMSK 0xff
  85. #define HAL_REO_R0_REO2SW1_RING_BASE_MSB_RING_SIZE_SHFT 0x8
  86. #define HAL_REO_R0_REO2SW1_RING_BASE_MSB_RING_SIZE_BMSK 0xfffff00
  87. #define HAL_REO_R0_REO2SW1_RING_ID_RING_ID_SHFT 0x8
  88. #define HAL_REO_R0_REO2SW1_RING_ID_RING_ID_BMSK 0x0000ff00
  89. #define HAL_REO_R0_REO2SW1_RING_ID_ENTRY_SIZE_SHFT 0x0
  90. #define HAL_REO_R0_REO2SW1_RING_ID_ENTRY_SIZE_BMSK 0xff
  91. #define HAL_REO_R0_REO2SW1_RING_PRODUCER_INT_SETUP_INTERRUPT_TIMER_THRESHOLD_SHFT 0x10
  92. #define HAL_REO_R0_REO2SW1_RING_PRODUCER_INT_SETUP_INTERRUPT_TIMER_THRESHOLD_BMSK 0xffff0000
  93. #define HAL_REO_R0_REO2SW1_RING_PRODUCER_INT_SETUP_BATCH_COUNTER_THRESHOLD_SHFT 0x0
  94. #define HAL_REO_R0_REO2SW1_RING_PRODUCER_INT_SETUP_BATCH_COUNTER_THRESHOLD_BMSK 0x00007fff
  95. #define HAL_REO_R0_REO2SW1_RING_MISC_DATA_TLV_SWAP_BIT_SHFT 0x5
  96. #define HAL_REO_R0_REO2SW1_RING_MISC_DATA_TLV_SWAP_BIT_BMSK 0x20
  97. #define HAL_REO_R0_REO2SW1_RING_MISC_HOST_FW_SWAP_BIT_SHFT 0x4
  98. #define HAL_REO_R0_REO2SW1_RING_MISC_HOST_FW_SWAP_BIT_BMSK 0x10
  99. #define HAL_REO_R0_REO2SW1_RING_MISC_MSI_SWAP_BIT_SHFT 0x3
  100. #define HAL_REO_R0_REO2SW1_RING_MISC_MSI_SWAP_BIT_BMSK 0x8
  101. /* HAL Macro to get the buffer info size */
  102. #define HAL_RX_BUFFINFO_NUM_DWORDS NUM_OF_DWORDS_BUFFER_ADDR_INFO
  103. #define HAL_DEFAULT_BE_BK_VI_REO_TIMEOUT_MS 100 /* milliseconds */
  104. #define HAL_DEFAULT_VO_REO_TIMEOUT_MS 40 /* milliseconds */
  105. #define HAL_DESC_SET_FIELD(_desc, _word, _fld, _value) do { \
  106. ((uint32_t *)(_desc))[(_word ## _ ## _fld ## _OFFSET) >> 2] &= \
  107. ~(_word ## _ ## _fld ## _MASK); \
  108. ((uint32_t *)(_desc))[(_word ## _ ## _fld ## _OFFSET) >> 2] |= \
  109. ((_value) << _word ## _ ## _fld ## _LSB); \
  110. } while (0)
  111. #define HAL_SM(_reg, _fld, _val) \
  112. (((_val) << (_reg ## _ ## _fld ## _SHFT)) & \
  113. (_reg ## _ ## _fld ## _BMSK))
  114. #define HAL_MS(_reg, _fld, _val) \
  115. (((_val) & (_reg ## _ ## _fld ## _BMSK)) >> \
  116. (_reg ## _ ## _fld ## _SHFT))
  117. #define HAL_REG_WRITE(_soc, _reg, _value) \
  118. hal_write32_mb(_soc, (_reg), (_value))
  119. /* Check register writing result */
  120. #define HAL_REG_WRITE_CONFIRM(_soc, _reg, _value) \
  121. hal_write32_mb_confirm(_soc, (_reg), (_value))
  122. #define HAL_REG_WRITE_CONFIRM_RETRY(_soc, _reg, _value, _recovery) \
  123. hal_write32_mb_confirm_retry(_soc, (_reg), (_value), (_recovery))
  124. #define HAL_REG_READ(_soc, _offset) \
  125. hal_read32_mb(_soc, (_offset))
  126. #define HAL_CMEM_WRITE(_soc, _reg, _value) \
  127. hal_write32_mb_cmem(_soc, (_reg), (_value))
  128. #define HAL_CMEM_READ(_soc, _offset) \
  129. hal_read32_mb_cmem(_soc, (_offset))
  130. #define WBM_IDLE_DESC_LIST 1
  131. /**
  132. * Common SRNG register access macros:
  133. * The SRNG registers are distributed across various UMAC and LMAC HW blocks,
  134. * but the register group and format is exactly same for all rings, with some
  135. * difference between producer rings (these are 'producer rings' with respect
  136. * to HW and referred as 'destination rings' in SW) and consumer rings (these
  137. * are 'consumer rings' with respect to HW and
  138. * referred as 'source rings' in SW).
  139. * The following macros provide uniform access to all SRNG rings.
  140. */
  141. /* SRNG registers are split among two groups R0 and R2 and following
  142. * definitions identify the group to which each register belongs to
  143. */
  144. #define R0_INDEX 0
  145. #define R2_INDEX 1
  146. #define HWREG_INDEX(_reg_group) _reg_group ## _ ## INDEX
  147. /* Registers in R0 group */
  148. #define BASE_LSB_GROUP R0
  149. #define BASE_MSB_GROUP R0
  150. #define ID_GROUP R0
  151. #define STATUS_GROUP R0
  152. #define MISC_GROUP R0
  153. #define HP_ADDR_LSB_GROUP R0
  154. #define HP_ADDR_MSB_GROUP R0
  155. #define PRODUCER_INT_SETUP_GROUP R0
  156. #define PRODUCER_INT_STATUS_GROUP R0
  157. #define PRODUCER_FULL_COUNTER_GROUP R0
  158. #define MSI1_BASE_LSB_GROUP R0
  159. #define MSI1_BASE_MSB_GROUP R0
  160. #define MSI1_DATA_GROUP R0
  161. #define HP_TP_SW_OFFSET_GROUP R0
  162. #define TP_ADDR_LSB_GROUP R0
  163. #define TP_ADDR_MSB_GROUP R0
  164. #define CONSUMER_INT_SETUP_IX0_GROUP R0
  165. #define CONSUMER_INT_SETUP_IX1_GROUP R0
  166. #define CONSUMER_INT_STATUS_GROUP R0
  167. #define CONSUMER_EMPTY_COUNTER_GROUP R0
  168. #define CONSUMER_PREFETCH_TIMER_GROUP R0
  169. #define CONSUMER_PREFETCH_STATUS_GROUP R0
  170. /* Registers in R2 group */
  171. #define HP_GROUP R2
  172. #define TP_GROUP R2
  173. /**
  174. * Register definitions for all SRNG based rings are same, except few
  175. * differences between source (HW consumer) and destination (HW producer)
  176. * registers. Following macros definitions provide generic access to all
  177. * SRNG based rings.
  178. * For source rings, we will use the register/field definitions of SW2TCL1
  179. * ring defined in the HW header file mac_tcl_reg_seq_hwioreg.h. To setup
  180. * individual fields, SRNG_SM macros should be used with fields specified
  181. * using SRNG_SRC_FLD(<register>, <field>), Register writes should be done
  182. * using SRNG_SRC_REG_WRITE(<hal_srng>, <register>, <value>).
  183. * Similarly for destination rings we will use definitions of REO2SW1 ring
  184. * defined in the register reo_destination_ring.h. To setup individual
  185. * fields SRNG_SM macros should be used with fields specified using
  186. * SRNG_DST_FLD(<register>, <field>). Register writes should be done using
  187. * SRNG_DST_REG_WRITE(<hal_srng>, <register>, <value>).
  188. */
  189. #define SRNG_DST_REG_OFFSET(_reg, _reg_group) \
  190. HWIO_REO_ ## _reg_group ## _REO2SW1_RING_ ## _reg##_ADDR(0)
  191. #define SRNG_SRC_REG_OFFSET(_reg, _reg_group) \
  192. HWIO_TCL_ ## _reg_group ## _SW2TCL1_RING_ ## _reg ## _ADDR(0)
  193. #define _SRNG_DST_FLD(_reg_group, _reg_fld) \
  194. HAL_REO_ ## _reg_group ## _REO2SW1_RING_ ## _reg_fld
  195. #define _SRNG_SRC_FLD(_reg_group, _reg_fld) \
  196. HWIO_TCL_ ## _reg_group ## _SW2TCL1_RING_ ## _reg_fld
  197. #define _SRNG_FLD(_reg_group, _reg_fld, _dir) \
  198. _SRNG_ ## _dir ## _FLD(_reg_group, _reg_fld)
  199. #define SRNG_DST_FLD(_reg, _f) _SRNG_FLD(_reg ## _GROUP, _reg ## _ ## _f, DST)
  200. #define SRNG_SRC_FLD(_reg, _f) _SRNG_FLD(_reg ## _GROUP, _reg ## _ ## _f, SRC)
  201. #define SRNG_SRC_R0_START_OFFSET SRNG_SRC_REG_OFFSET(BASE_LSB, R0)
  202. #define SRNG_DST_R0_START_OFFSET SRNG_DST_REG_OFFSET(BASE_LSB, R0)
  203. #define SRNG_SRC_R2_START_OFFSET SRNG_SRC_REG_OFFSET(HP, R2)
  204. #define SRNG_DST_R2_START_OFFSET SRNG_DST_REG_OFFSET(HP, R2)
  205. #define SRNG_SRC_START_OFFSET(_reg_group) \
  206. SRNG_SRC_ ## _reg_group ## _START_OFFSET
  207. #define SRNG_DST_START_OFFSET(_reg_group) \
  208. SRNG_DST_ ## _reg_group ## _START_OFFSET
  209. #define SRNG_REG_ADDR(_srng, _reg, _reg_group, _dir) \
  210. ((_srng)->hwreg_base[HWREG_INDEX(_reg_group)] + \
  211. ((_srng)->hal_soc->hal_hw_reg_offset[_dir ## _ ##_reg]))
  212. #define CALCULATE_REG_OFFSET(_dir, _reg, _reg_group) \
  213. (SRNG_ ## _dir ## _REG_OFFSET(_reg, _reg_group) - \
  214. SRNG_ ## _dir ## _START_OFFSET(_reg_group))
  215. #define REG_OFFSET(_dir, _reg) \
  216. CALCULATE_REG_OFFSET(_dir, _reg, _reg ## _GROUP)
  217. #define SRNG_DST_ADDR(_srng, _reg) \
  218. SRNG_REG_ADDR(_srng, _reg, _reg ## _GROUP, DST)
  219. #define SRNG_SRC_ADDR(_srng, _reg) \
  220. SRNG_REG_ADDR(_srng, _reg, _reg ## _GROUP, SRC)
  221. #define SRNG_REG_WRITE(_srng, _reg, _value, _dir) \
  222. hal_write_address_32_mb(_srng->hal_soc,\
  223. SRNG_ ## _dir ## _ADDR(_srng, _reg), (_value), false)
  224. #define SRNG_REG_WRITE_CONFIRM(_srng, _reg, _value, _dir) \
  225. hal_write_address_32_mb(_srng->hal_soc,\
  226. SRNG_ ## _dir ## _ADDR(_srng, _reg), (_value), true)
  227. #define SRNG_REG_READ(_srng, _reg, _dir) \
  228. hal_read_address_32_mb(_srng->hal_soc, \
  229. SRNG_ ## _dir ## _ADDR(_srng, _reg))
  230. #define SRNG_SRC_REG_WRITE(_srng, _reg, _value) \
  231. SRNG_REG_WRITE(_srng, _reg, _value, SRC)
  232. #define SRNG_DST_REG_WRITE(_srng, _reg, _value) \
  233. SRNG_REG_WRITE(_srng, _reg, _value, DST)
  234. #define SRNG_DST_REG_WRITE_CONFIRM(_srng, _reg, _value) \
  235. SRNG_REG_WRITE_CONFIRM(_srng, _reg, _value, DST)
  236. #define SRNG_SRC_REG_READ(_srng, _reg) \
  237. SRNG_REG_READ(_srng, _reg, SRC)
  238. #define SRNG_DST_REG_READ(_srng, _reg) \
  239. SRNG_REG_READ(_srng, _reg, DST)
  240. #define _SRNG_FM(_reg_fld) _reg_fld ## _BMSK
  241. #define _SRNG_FS(_reg_fld) _reg_fld ## _SHFT
  242. #define SRNG_SM(_reg_fld, _val) \
  243. (((_val) << _SRNG_FS(_reg_fld)) & _SRNG_FM(_reg_fld))
  244. #define SRNG_MS(_reg_fld, _val) \
  245. (((_val) & _SRNG_FM(_reg_fld)) >> _SRNG_FS(_reg_fld))
  246. #define SRNG_MAX_SIZE_DWORDS \
  247. (SRNG_MS(SRNG_SRC_FLD(BASE_MSB, RING_SIZE), 0xffffffff))
  248. /**
  249. * HW ring configuration table to identify hardware ring attributes like
  250. * register addresses, number of rings, ring entry size etc., for each type
  251. * of SRNG ring.
  252. *
  253. * Currently there is just one HW ring table, but there could be multiple
  254. * configurations in future based on HW variants from the same wifi3.0 family
  255. * and hence need to be attached with hal_soc based on HW type
  256. */
  257. #define HAL_SRNG_CONFIG(_hal_soc, _ring_type) \
  258. (&_hal_soc->hw_srng_table[_ring_type])
  259. enum SRNG_REGISTERS {
  260. DST_HP = 0,
  261. DST_TP,
  262. DST_ID,
  263. DST_MISC,
  264. DST_HP_ADDR_LSB,
  265. DST_HP_ADDR_MSB,
  266. DST_MSI1_BASE_LSB,
  267. DST_MSI1_BASE_MSB,
  268. DST_MSI1_DATA,
  269. DST_BASE_LSB,
  270. DST_BASE_MSB,
  271. DST_PRODUCER_INT_SETUP,
  272. SRC_HP,
  273. SRC_TP,
  274. SRC_ID,
  275. SRC_MISC,
  276. SRC_TP_ADDR_LSB,
  277. SRC_TP_ADDR_MSB,
  278. SRC_MSI1_BASE_LSB,
  279. SRC_MSI1_BASE_MSB,
  280. SRC_MSI1_DATA,
  281. SRC_BASE_LSB,
  282. SRC_BASE_MSB,
  283. SRC_CONSUMER_INT_SETUP_IX0,
  284. SRC_CONSUMER_INT_SETUP_IX1,
  285. };
  286. /**
  287. * hal_set_link_desc_addr - Setup link descriptor in a buffer_addr_info
  288. * HW structure
  289. *
  290. * @hal_soc_hdl: HAL soc handle
  291. * @desc: Descriptor entry (from WBM_IDLE_LINK ring)
  292. * @cookie: SW cookie for the buffer/descriptor
  293. * @link_desc_paddr: Physical address of link descriptor entry
  294. *
  295. */
  296. static inline void hal_set_link_desc_addr(hal_soc_handle_t hal_soc_hdl,
  297. void *desc, uint32_t cookie,
  298. qdf_dma_addr_t link_desc_paddr)
  299. {
  300. struct hal_soc *hal_soc = (struct hal_soc *)hal_soc_hdl;
  301. if ((!hal_soc) || (!hal_soc->ops)) {
  302. hal_err("hal handle is NULL");
  303. return;
  304. }
  305. if (hal_soc->ops->hal_set_link_desc_addr)
  306. hal_soc->ops->hal_set_link_desc_addr(desc, cookie,
  307. link_desc_paddr);
  308. }
  309. /**
  310. * hal_get_reo_qdesc_size - Get size of reo queue descriptor
  311. *
  312. * @hal_soc: Opaque HAL SOC handle
  313. * @ba_window_size: BlockAck window size
  314. * @tid: TID number
  315. *
  316. */
  317. static inline
  318. uint32_t hal_get_reo_qdesc_size(hal_soc_handle_t hal_soc_hdl,
  319. uint32_t ba_window_size, int tid)
  320. {
  321. /* Return descriptor size corresponding to window size of 2 since
  322. * we set ba_window_size to 2 while setting up REO descriptors as
  323. * a WAR to get 2k jump exception aggregates are received without
  324. * a BA session.
  325. */
  326. if (ba_window_size <= 1) {
  327. if (tid != HAL_NON_QOS_TID)
  328. return sizeof(struct rx_reo_queue) +
  329. sizeof(struct rx_reo_queue_ext);
  330. else
  331. return sizeof(struct rx_reo_queue);
  332. }
  333. if (ba_window_size <= 105)
  334. return sizeof(struct rx_reo_queue) +
  335. sizeof(struct rx_reo_queue_ext);
  336. if (ba_window_size <= 210)
  337. return sizeof(struct rx_reo_queue) +
  338. (2 * sizeof(struct rx_reo_queue_ext));
  339. return sizeof(struct rx_reo_queue) +
  340. (3 * sizeof(struct rx_reo_queue_ext));
  341. }
  342. #endif /* _HAL_HW_INTERNAL_H_ */