cdp_txrx_mob_def.h 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465
  1. /*
  2. * Copyright (c) 2016-2019 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 __CDP_TXRX_MOB_DEF_H
  19. #define __CDP_TXRX_MOB_DEF_H
  20. #include <sir_types.h>
  21. #include <htt.h>
  22. #define TX_WMM_AC_NUM 4
  23. #define OL_TXQ_PAUSE_REASON_FW (1 << 0)
  24. #define OL_TXQ_PAUSE_REASON_PEER_UNAUTHORIZED (1 << 1)
  25. #define OL_TXQ_PAUSE_REASON_TX_ABORT (1 << 2)
  26. #define OL_TXQ_PAUSE_REASON_VDEV_STOP (1 << 3)
  27. #define OL_TXQ_PAUSE_REASON_THERMAL_MITIGATION (1 << 4)
  28. #define OL_TXRX_INVALID_NUM_PEERS (-1)
  29. /* Maximum number of station supported by data path, including BC. */
  30. #define WLAN_MAX_STA_COUNT (HAL_NUM_STA)
  31. /* The symbolic station ID return to HDD to specify the packet is bc/mc */
  32. #define WLAN_RX_BCMC_STA_ID (WLAN_MAX_STA_COUNT + 1)
  33. /* The symbolic station ID return to HDD to specify the packet is
  34. to soft-AP itself */
  35. #define WLAN_RX_SAP_SELF_STA_ID (WLAN_MAX_STA_COUNT + 2)
  36. /* is 802.11 address multicast/broadcast? */
  37. #define IEEE80211_IS_MULTICAST(_a) (*(_a) & 0x01)
  38. #define MAX_PEERS 32
  39. /*
  40. * Bins used for reporting delay histogram:
  41. * bin 0: 0 - 10 ms delay
  42. * bin 1: 10 - 20 ms delay
  43. * bin 2: 20 - 40 ms delay
  44. * bin 3: 40 - 80 ms delay
  45. * bin 4: 80 - 160 ms delay
  46. * bin 5: > 160 ms delay
  47. */
  48. #define QCA_TX_DELAY_HIST_REPORT_BINS 6
  49. /* BA actions */
  50. #define IEEE80211_ACTION_BA_ADDBA_REQUEST 0 /* ADDBA request */
  51. #define IEEE80211_ACTION_BA_ADDBA_RESPONSE 1 /* ADDBA response */
  52. #define IEEE80211_ACTION_BA_DELBA 2 /* DELBA */
  53. #define IEEE80211_BA_POLICY_DELAYED 0
  54. #define IEEE80211_BA_POLICY_IMMEDIATE 1
  55. #define IEEE80211_BA_AMSDU_SUPPORTED 1
  56. /**
  57. * enum netif_action_type - Type of actions on netif queues
  58. * @WLAN_STOP_ALL_NETIF_QUEUE: stop all netif queues
  59. * @WLAN_START_ALL_NETIF_QUEUE: start all netif queues
  60. * @WLAN_WAKE_ALL_NETIF_QUEUE: wake all netif queues
  61. * @WLAN_STOP_ALL_NETIF_QUEUE_N_CARRIER: stop all queues and off carrier
  62. * @WLAN_START_ALL_NETIF_QUEUE_N_CARRIER: start all queues and on carrier
  63. * @WLAN_NETIF_TX_DISABLE: disable tx
  64. * @WLAN_NETIF_TX_DISABLE_N_CARRIER: disable tx and off carrier
  65. * @WLAN_NETIF_CARRIER_ON: on carrier
  66. * @WLAN_NETIF_CARRIER_OFF: off carrier
  67. * @WLAN_NETIF_PRIORITY_QUEUE_ON: start priority netif queues
  68. * @WLAN_NETIF_PRIORITY_QUEUE_OFF: stop priority netif queues
  69. * @WLAN_WAKE_NON_PRIORITY_QUEUE: wake non priority netif queues
  70. * @WLAN_STOP_NON_PRIORITY_QUEUE: stop non priority netif queues
  71. */
  72. enum netif_action_type {
  73. WLAN_NETIF_ACTION_TYPE_NONE = 0,
  74. WLAN_STOP_ALL_NETIF_QUEUE = 1,
  75. WLAN_START_ALL_NETIF_QUEUE = 2,
  76. WLAN_WAKE_ALL_NETIF_QUEUE = 3,
  77. WLAN_STOP_ALL_NETIF_QUEUE_N_CARRIER = 4,
  78. WLAN_START_ALL_NETIF_QUEUE_N_CARRIER = 5,
  79. WLAN_NETIF_TX_DISABLE = 6,
  80. WLAN_NETIF_TX_DISABLE_N_CARRIER = 7,
  81. WLAN_NETIF_CARRIER_ON = 8,
  82. WLAN_NETIF_CARRIER_OFF = 9,
  83. WLAN_NETIF_PRIORITY_QUEUE_ON = 10,
  84. WLAN_NETIF_PRIORITY_QUEUE_OFF = 11,
  85. WLAN_NETIF_VO_QUEUE_ON = 12,
  86. WLAN_NETIF_VO_QUEUE_OFF = 13,
  87. WLAN_NETIF_VI_QUEUE_ON = 14,
  88. WLAN_NETIF_VI_QUEUE_OFF = 15,
  89. WLAN_NETIF_BE_BK_QUEUE_OFF = 16,
  90. WLAN_WAKE_NON_PRIORITY_QUEUE = 17,
  91. WLAN_STOP_NON_PRIORITY_QUEUE = 18,
  92. WLAN_NETIF_ACTION_TYPE_MAX,
  93. };
  94. /**
  95. * enum netif_reason_type - reason for netif queue action
  96. * @WLAN_CONTROL_PATH: action from control path
  97. * @WLAN_DATA_FLOW_CONTROL: because of flow control
  98. * @WLAN_FW_PAUSE: because of firmware pause
  99. * @WLAN_TX_ABORT: because of tx abort
  100. * @WLAN_VDEV_STOP: because of vdev stop
  101. * @WLAN_PEER_UNAUTHORISED: because of peer is unauthorised
  102. * @WLAN_THERMAL_MITIGATION: because of thermal mitigation
  103. */
  104. enum netif_reason_type {
  105. WLAN_CONTROL_PATH = 1,
  106. WLAN_DATA_FLOW_CONTROL,
  107. WLAN_FW_PAUSE,
  108. WLAN_TX_ABORT,
  109. WLAN_VDEV_STOP,
  110. WLAN_PEER_UNAUTHORISED,
  111. WLAN_THERMAL_MITIGATION,
  112. WLAN_DATA_FLOW_CONTROL_PRIORITY,
  113. WLAN_REASON_TYPE_MAX,
  114. };
  115. enum ol_rx_err_type {
  116. OL_RX_ERR_DEFRAG_MIC,
  117. OL_RX_ERR_PN,
  118. OL_RX_ERR_UNKNOWN_PEER,
  119. OL_RX_ERR_MALFORMED,
  120. OL_RX_ERR_TKIP_MIC,
  121. OL_RX_ERR_DECRYPT,
  122. OL_RX_ERR_MPDU_LENGTH,
  123. OL_RX_ERR_ENCRYPT_REQUIRED,
  124. OL_RX_ERR_DUP,
  125. OL_RX_ERR_UNKNOWN,
  126. OL_RX_ERR_FCS,
  127. OL_RX_ERR_PRIVACY,
  128. OL_RX_ERR_NONE_FRAG,
  129. OL_RX_ERR_NONE = 0xFF
  130. };
  131. enum throttle_level {
  132. THROTTLE_LEVEL_0,
  133. THROTTLE_LEVEL_1,
  134. THROTTLE_LEVEL_2,
  135. THROTTLE_LEVEL_3,
  136. /* Invalid */
  137. THROTTLE_LEVEL_MAX,
  138. };
  139. enum {
  140. OL_TX_WMM_AC_BE,
  141. OL_TX_WMM_AC_BK,
  142. OL_TX_WMM_AC_VI,
  143. OL_TX_WMM_AC_VO,
  144. OL_TX_NUM_WMM_AC
  145. };
  146. /**
  147. * @enum ol_tx_spec
  148. * @brief indicate what non-standard transmission actions to apply
  149. * @details
  150. * Indicate one or more of the following:
  151. * - The tx frame already has a complete 802.11 header.
  152. * Thus, skip 802.3/native-WiFi to 802.11 header encapsulation and
  153. * A-MSDU aggregation.
  154. * - The tx frame should not be aggregated (A-MPDU or A-MSDU)
  155. * - The tx frame is already encrypted - don't attempt encryption.
  156. * - The tx frame is a segment of a TCP jumbo frame.
  157. * - This tx frame should not be unmapped and freed by the txrx layer
  158. * after transmission, but instead given to a registered tx completion
  159. * callback.
  160. * More than one of these specification can apply, though typically
  161. * only a single specification is applied to a tx frame.
  162. * A compound specification can be created, as a bit-OR of these
  163. * specifications.
  164. */
  165. enum ol_tx_spec {
  166. OL_TX_SPEC_STD = 0x0, /* do regular processing */
  167. OL_TX_SPEC_RAW = 0x1, /* skip encap + A-MSDU aggr */
  168. OL_TX_SPEC_NO_AGGR = 0x2, /* skip encap + all aggr */
  169. OL_TX_SPEC_NO_ENCRYPT = 0x4, /* skip encap + encrypt */
  170. OL_TX_SPEC_TSO = 0x8, /* TCP segmented */
  171. OL_TX_SPEC_NWIFI_NO_ENCRYPT = 0x10, /* skip encrypt for nwifi */
  172. OL_TX_SPEC_NO_FREE = 0x20, /* give to cb rather than free */
  173. };
  174. /**
  175. * @enum peer_debug_id_type: debug ids to track peer get_ref and release_ref
  176. * @brief Unique peer debug IDs to track the callers. Each new usage can add to
  177. * this enum list to create a new "PEER_DEBUG_ID_".
  178. * @PEER_DEBUG_ID_OL_INTERNAL: debug id for OL internal usage
  179. * @PEER_DEBUG_ID_WMA_PKT_DROP: debug id for wma_is_pkt_drop_candidate API
  180. * @PEER_DEBUG_ID_WMA_ADDBA_REQ: debug id for ADDBA request
  181. * @PEER_DEBUG_ID_WMA_DELBA_REQ: debug id for DELBA request
  182. * @PEER_DEBUG_ID_LIM_SEND_ADDBA_RESP: debug id for send ADDBA response
  183. * @PEER_DEBUG_ID_OL_RX_THREAD: debug id for rx thread
  184. * @PEER_DEBUG_ID_WMA_CCMP_REPLAY_ATTACK: debug id for CCMP replay
  185. * @PEER_DEBUG_ID_WMA_DEL_BSS:debug id for remove BSS
  186. * @PEER_DEBUG_ID_WMA_VDEV_STOP_RESP:debug id for vdev stop response handler
  187. * @PEER_DEBUG_ID_OL_PEER_MAP:debug id for peer map/unmap
  188. * @PEER_DEBUG_ID_OL_PEER_ATTACH: debug id for peer attach/detach
  189. * @PEER_DEBUG_ID_OL_TXQ_VDEV_FL: debug id for vdev flush
  190. * @PEER_DEBUG_ID_OL_HASH_ERS:debug id for peer find hash erase
  191. * @PEER_DEBUG_ID_MAX: debug id MAX
  192. */
  193. enum peer_debug_id_type {
  194. PEER_DEBUG_ID_OL_INTERNAL,
  195. PEER_DEBUG_ID_WMA_PKT_DROP,
  196. PEER_DEBUG_ID_WMA_ADDBA_REQ,
  197. PEER_DEBUG_ID_WMA_DELBA_REQ,
  198. PEER_DEBUG_ID_LIM_SEND_ADDBA_RESP,
  199. PEER_DEBUG_ID_OL_RX_THREAD,
  200. PEER_DEBUG_ID_WMA_CCMP_REPLAY_ATTACK,
  201. PEER_DEBUG_ID_WMA_DEL_BSS,
  202. PEER_DEBUG_ID_WMA_VDEV_STOP_RESP,
  203. PEER_DEBUG_ID_OL_PEER_MAP,
  204. PEER_DEBUG_ID_OL_PEER_ATTACH,
  205. PEER_DEBUG_ID_OL_TXQ_VDEV_FL,
  206. PEER_DEBUG_ID_OL_HASH_ERS,
  207. PEER_DEBUG_ID_OL_UNMAP_TIMER_WORK,
  208. PEER_DEBUG_ID_MAX
  209. };
  210. /**
  211. * struct ol_txrx_desc_type - txrx descriptor type
  212. * @sta_id: sta id
  213. * @is_qos_enabled: is station qos enabled
  214. * @is_wapi_supported: is station wapi supported
  215. */
  216. struct ol_txrx_desc_type {
  217. uint8_t sta_id;
  218. uint8_t is_qos_enabled;
  219. uint8_t is_wapi_supported;
  220. };
  221. /**
  222. * struct ol_tx_sched_wrr_ac_specs_t - the wrr ac specs params structure
  223. * @wrr_skip_weight: map to ol_tx_sched_wrr_adv_category_info_t.specs.
  224. * wrr_skip_weight
  225. * @credit_threshold: map to ol_tx_sched_wrr_adv_category_info_t.specs.
  226. * credit_threshold
  227. * @send_limit: map to ol_tx_sched_wrr_adv_category_info_t.specs.
  228. * send_limit
  229. * @credit_reserve: map to ol_tx_sched_wrr_adv_category_info_t.specs.
  230. * credit_reserve
  231. * @discard_weight: map to ol_tx_sched_wrr_adv_category_info_t.specs.
  232. * discard_weight
  233. *
  234. * This structure is for wrr ac specs params set from user, it will update
  235. * its content corresponding to the ol_tx_sched_wrr_adv_category_info_t.specs.
  236. */
  237. struct ol_tx_sched_wrr_ac_specs_t {
  238. int wrr_skip_weight;
  239. uint32_t credit_threshold;
  240. uint16_t send_limit;
  241. int credit_reserve;
  242. int discard_weight;
  243. };
  244. /**
  245. * struct txrx_pdev_cfg_param_t - configuration information
  246. * passed to the data path
  247. */
  248. struct txrx_pdev_cfg_param_t {
  249. uint8_t is_full_reorder_offload;
  250. /* IPA Micro controller data path offload enable flag */
  251. uint8_t is_uc_offload_enabled;
  252. /* IPA Micro controller data path offload TX buffer count */
  253. uint32_t uc_tx_buffer_count;
  254. /* IPA Micro controller data path offload TX buffer size */
  255. uint32_t uc_tx_buffer_size;
  256. /* IPA Micro controller data path offload RX indication ring count */
  257. uint32_t uc_rx_indication_ring_count;
  258. /* IPA Micro controller data path offload TX partition base */
  259. uint32_t uc_tx_partition_base;
  260. /* IP, TCP and UDP checksum offload */
  261. bool ip_tcp_udp_checksum_offload;
  262. /* Rx processing in thread from TXRX */
  263. bool enable_rxthread;
  264. /* CE classification enabled through INI */
  265. bool ce_classify_enabled;
  266. /* Threshold to stop queue in percentage */
  267. uint32_t tx_flow_stop_queue_th;
  268. /* Start queue offset in percentage */
  269. uint32_t tx_flow_start_queue_offset;
  270. #ifdef QCA_SUPPORT_TXRX_DRIVER_TCP_DEL_ACK
  271. /* enable the tcp delay ack feature in the driver */
  272. bool del_ack_enable;
  273. /* timeout if no more tcp ack frames, unit is ms */
  274. uint16_t del_ack_timer_value;
  275. /* the maximum number of replaced tcp ack frames */
  276. uint16_t del_ack_pkt_count;
  277. #endif
  278. struct ol_tx_sched_wrr_ac_specs_t ac_specs[TX_WMM_AC_NUM];
  279. bool gro_enable;
  280. bool tso_enable;
  281. bool lro_enable;
  282. bool enable_data_stall_detection;
  283. bool enable_flow_steering;
  284. bool disable_intra_bss_fwd;
  285. };
  286. #ifdef IPA_OFFLOAD
  287. /**
  288. * ol_txrx_ipa_resources - Resources needed for IPA
  289. */
  290. struct ol_txrx_ipa_resources {
  291. qdf_shared_mem_t *ce_sr;
  292. uint32_t ce_sr_ring_size;
  293. qdf_dma_addr_t ce_reg_paddr;
  294. qdf_shared_mem_t *tx_comp_ring;
  295. uint32_t tx_num_alloc_buffer;
  296. qdf_shared_mem_t *rx_rdy_ring;
  297. qdf_shared_mem_t *rx_proc_done_idx;
  298. qdf_shared_mem_t *rx2_rdy_ring;
  299. qdf_shared_mem_t *rx2_proc_done_idx;
  300. /* IPA UC doorbell registers paddr */
  301. qdf_dma_addr_t tx_comp_doorbell_dmaaddr;
  302. qdf_dma_addr_t rx_ready_doorbell_dmaaddr;
  303. uint32_t tx_pipe_handle;
  304. uint32_t rx_pipe_handle;
  305. };
  306. #endif
  307. struct ol_txrx_ocb_chan_info {
  308. uint32_t chan_freq;
  309. uint16_t disable_rx_stats_hdr:1;
  310. };
  311. /**
  312. * ol_mic_error_info - carries the information associated with
  313. * a MIC error
  314. * @vdev_id: virtual device ID
  315. * @key_id: Key ID
  316. * @pn: packet number
  317. * @sa: source address
  318. * @da: destination address
  319. * @ta: transmitter address
  320. */
  321. struct ol_mic_error_info {
  322. uint8_t vdev_id;
  323. uint32_t key_id;
  324. uint64_t pn;
  325. uint8_t sa[QDF_MAC_ADDR_SIZE];
  326. uint8_t da[QDF_MAC_ADDR_SIZE];
  327. uint8_t ta[QDF_MAC_ADDR_SIZE];
  328. };
  329. /**
  330. * ol_error_info - carries the information associated with an
  331. * error indicated by the firmware
  332. * @mic_err: MIC error information
  333. */
  334. struct ol_error_info {
  335. union {
  336. struct ol_mic_error_info mic_err;
  337. } u;
  338. };
  339. /**
  340. * struct ol_txrx_ocb_set_chan - txrx OCB channel info
  341. * @ocb_channel_count: Channel count
  342. * @ocb_channel_info: OCB channel info
  343. */
  344. struct ol_txrx_ocb_set_chan {
  345. uint32_t ocb_channel_count;
  346. struct ol_txrx_ocb_chan_info *ocb_channel_info;
  347. };
  348. /**
  349. * @brief Parameter type to pass WMM setting to ol_txrx_set_wmm_param
  350. * @details
  351. * The struct is used to specify informaiton to update TX WMM scheduler.
  352. */
  353. struct ol_tx_ac_param_t {
  354. uint32_t aifs;
  355. uint32_t cwmin;
  356. uint32_t cwmax;
  357. };
  358. struct ol_tx_wmm_param_t {
  359. struct ol_tx_ac_param_t ac[OL_TX_NUM_WMM_AC];
  360. };
  361. struct ieee80211_ba_parameterset {
  362. #if _BYTE_ORDER == _BIG_ENDIAN
  363. uint16_t buffersize:10, /* B6-15 buffer size */
  364. tid:4, /* B2-5 TID */
  365. bapolicy:1, /* B1 block ack policy */
  366. amsdusupported:1; /* B0 amsdu supported */
  367. #else
  368. uint16_t amsdusupported:1, /* B0 amsdu supported */
  369. bapolicy:1, /* B1 block ack policy */
  370. tid:4, /* B2-5 TID */
  371. buffersize:10; /* B6-15 buffer size */
  372. #endif
  373. } __packed;
  374. struct ieee80211_ba_seqctrl {
  375. #if _BYTE_ORDER == _BIG_ENDIAN
  376. uint16_t startseqnum:12, /* B4-15 starting sequence number */
  377. fragnum:4; /* B0-3 fragment number */
  378. #else
  379. uint16_t fragnum:4, /* B0-3 fragment number */
  380. startseqnum:12; /* B4-15 starting sequence number */
  381. #endif
  382. } __packed;
  383. struct ieee80211_delba_parameterset {
  384. #if _BYTE_ORDER == _BIG_ENDIAN
  385. uint16_t tid:4, /* B12-15 tid */
  386. initiator:1, /* B11 initiator */
  387. reserved0:11; /* B0-10 reserved */
  388. #else
  389. uint16_t reserved0:11, /* B0-10 reserved */
  390. initiator:1, /* B11 initiator */
  391. tid:4; /* B12-15 tid */
  392. #endif
  393. } __packed;
  394. /**
  395. * ol_txrx_vdev_peer_remove_cb - wma_remove_peer callback
  396. */
  397. typedef void (*ol_txrx_vdev_peer_remove_cb)(void *handle, uint8_t *bssid,
  398. uint8_t vdev_id, void *peer);
  399. /**
  400. * @typedef tx_pause_callback
  401. * @brief OSIF function registered with the data path
  402. */
  403. typedef void (*tx_pause_callback)(uint8_t vdev_id,
  404. enum netif_action_type action,
  405. enum netif_reason_type reason);
  406. typedef void (*ipa_uc_op_cb_type)(uint8_t *op_msg,
  407. void *osif_ctxt);
  408. /**
  409. * struct ol_rx_inv_peer_params - rx invalid peer data parameters
  410. * @vdev_id: Virtual device ID
  411. * @ra: RX data receiver MAC address
  412. * @ta: RX data transmitter MAC address
  413. */
  414. struct ol_rx_inv_peer_params {
  415. uint8_t vdev_id;
  416. uint8_t ra[QDF_MAC_ADDR_SIZE];
  417. uint8_t ta[QDF_MAC_ADDR_SIZE];
  418. };
  419. #endif /* __CDP_TXRX_MOB_DEF_H */