1 /* SPDX-License-Identifier: BSD-3-Clause-Clear */
3 * Copyright (c) 2018-2019 The Linux Foundation. All rights reserved.
6 #ifndef ATH11K_HAL_RX_H
7 #define ATH11K_HAL_RX_H
9 struct hal_rx_wbm_rel_info {
11 enum hal_wbm_rel_src_module err_rel_src;
12 enum hal_reo_dest_ring_push_reason push_reason;
18 #define HAL_INVALID_PEERID 0xffff
19 #define VHT_SIG_SU_NSS_MASK 0x7
21 #define HAL_RX_MAX_MCS 12
22 #define HAL_RX_MAX_NSS 8
24 struct hal_rx_mon_status_tlv_hdr {
29 enum hal_rx_su_mu_coding {
30 HAL_RX_SU_MU_CODING_BCC,
31 HAL_RX_SU_MU_CODING_LDPC,
32 HAL_RX_SU_MU_CODING_MAX,
51 enum hal_rx_preamble {
60 enum hal_rx_reception_type {
61 HAL_RX_RECEPTION_TYPE_SU,
62 HAL_RX_RECEPTION_TYPE_MU_MIMO,
63 HAL_RX_RECEPTION_TYPE_MU_OFDMA,
64 HAL_RX_RECEPTION_TYPE_MU_OFDMA_MIMO,
65 HAL_RX_RECEPTION_TYPE_MAX,
68 #define HAL_RX_FCS_LEN 4
70 enum hal_rx_mon_status {
71 HAL_RX_MON_STATUS_PPDU_NOT_DONE,
72 HAL_RX_MON_STATUS_PPDU_DONE,
73 HAL_RX_MON_STATUS_BUF_DONE,
76 struct hal_rx_user_status {
80 dl_ofdma_ru_start_index:7,
83 u32 ul_ofdma_user_v0_word0;
84 u32 ul_ofdma_user_v0_word1;
91 u8 frame_control_info_valid;
92 u8 data_sequence_control_info_valid;
93 u16 first_data_seq_ctrl;
100 u32 mpdu_cnt_fcs_err;
101 u32 mpdu_fcs_ok_bitmap[8];
102 u32 mpdu_ok_byte_count;
103 u32 mpdu_err_byte_count;
106 #define HAL_TLV_STATUS_PPDU_NOT_DONE HAL_RX_MON_STATUS_PPDU_NOT_DONE
107 #define HAL_TLV_STATUS_PPDU_DONE HAL_RX_MON_STATUS_PPDU_DONE
108 #define HAL_TLV_STATUS_BUF_DONE HAL_RX_MON_STATUS_BUF_DONE
110 struct hal_sw_mon_ring_entries {
111 dma_addr_t mon_dst_paddr;
112 dma_addr_t mon_status_paddr;
113 u32 mon_dst_sw_cookie;
114 u32 mon_status_sw_cookie;
115 void *dst_buf_addr_info;
116 void *status_buf_addr_info;
124 struct hal_rx_mon_ppdu_info {
128 u32 num_mpdu_fcs_err;
132 u16 tcp_ack_msdu_count;
134 u16 other_msdu_count;
142 u8 vht_flag_values3[4];
145 u16 vht_flag_values6;
151 u8 rssi_chain_pri20[HAL_RX_MAX_NSS];
169 u8 frame_control_info_valid;
172 u8 he_per_user_position;
173 u8 he_per_user_known;
186 u16 first_data_seq_ctrl;
187 u8 monitor_direct_used;
188 u8 data_sequence_control_info_valid;
190 u8 rxpcu_filter_pass;
191 char rssi_chain[8][8];
192 struct hal_rx_user_status userstats;
195 #define HAL_RX_PPDU_START_INFO0_PPDU_ID GENMASK(15, 0)
197 struct hal_rx_ppdu_start {
200 __le32 ppdu_start_ts;
203 #define HAL_RX_PPDU_END_USER_STATS_INFO0_MPDU_CNT_FCS_ERR GENMASK(25, 16)
205 #define HAL_RX_PPDU_END_USER_STATS_INFO1_MPDU_CNT_FCS_OK GENMASK(8, 0)
206 #define HAL_RX_PPDU_END_USER_STATS_INFO1_FC_VALID BIT(9)
207 #define HAL_RX_PPDU_END_USER_STATS_INFO1_QOS_CTRL_VALID BIT(10)
208 #define HAL_RX_PPDU_END_USER_STATS_INFO1_HT_CTRL_VALID BIT(11)
209 #define HAL_RX_PPDU_END_USER_STATS_INFO1_PKT_TYPE GENMASK(23, 20)
211 #define HAL_RX_PPDU_END_USER_STATS_INFO2_AST_INDEX GENMASK(15, 0)
212 #define HAL_RX_PPDU_END_USER_STATS_INFO2_FRAME_CTRL GENMASK(31, 16)
214 #define HAL_RX_PPDU_END_USER_STATS_INFO3_QOS_CTRL GENMASK(31, 16)
216 #define HAL_RX_PPDU_END_USER_STATS_INFO4_UDP_MSDU_CNT GENMASK(15, 0)
217 #define HAL_RX_PPDU_END_USER_STATS_INFO4_TCP_MSDU_CNT GENMASK(31, 16)
219 #define HAL_RX_PPDU_END_USER_STATS_INFO5_OTHER_MSDU_CNT GENMASK(15, 0)
220 #define HAL_RX_PPDU_END_USER_STATS_INFO5_TCP_ACK_MSDU_CNT GENMASK(31, 16)
222 #define HAL_RX_PPDU_END_USER_STATS_INFO6_TID_BITMAP GENMASK(15, 0)
223 #define HAL_RX_PPDU_END_USER_STATS_INFO6_TID_EOSP_BITMAP GENMASK(31, 16)
225 #define HAL_RX_PPDU_END_USER_STATS_RSVD2_6_MPDU_OK_BYTE_COUNT GENMASK(24, 0)
226 #define HAL_RX_PPDU_END_USER_STATS_RSVD2_8_MPDU_ERR_BYTE_COUNT GENMASK(24, 0)
228 struct hal_rx_ppdu_end_user_stats {
242 struct hal_rx_ppdu_end_user_stats_ext {
252 #define HAL_RX_HT_SIG_INFO_INFO0_MCS GENMASK(6, 0)
253 #define HAL_RX_HT_SIG_INFO_INFO0_BW BIT(7)
255 #define HAL_RX_HT_SIG_INFO_INFO1_STBC GENMASK(5, 4)
256 #define HAL_RX_HT_SIG_INFO_INFO1_FEC_CODING BIT(6)
257 #define HAL_RX_HT_SIG_INFO_INFO1_GI BIT(7)
259 struct hal_rx_ht_sig_info {
264 #define HAL_RX_LSIG_B_INFO_INFO0_RATE GENMASK(3, 0)
265 #define HAL_RX_LSIG_B_INFO_INFO0_LEN GENMASK(15, 4)
267 struct hal_rx_lsig_b_info {
271 #define HAL_RX_LSIG_A_INFO_INFO0_RATE GENMASK(3, 0)
272 #define HAL_RX_LSIG_A_INFO_INFO0_LEN GENMASK(16, 5)
273 #define HAL_RX_LSIG_A_INFO_INFO0_PKT_TYPE GENMASK(27, 24)
275 struct hal_rx_lsig_a_info {
279 #define HAL_RX_VHT_SIG_A_INFO_INFO0_BW GENMASK(1, 0)
280 #define HAL_RX_VHT_SIG_A_INFO_INFO0_STBC BIT(3)
281 #define HAL_RX_VHT_SIG_A_INFO_INFO0_GROUP_ID GENMASK(9, 4)
282 #define HAL_RX_VHT_SIG_A_INFO_INFO0_NSTS GENMASK(21, 10)
284 #define HAL_RX_VHT_SIG_A_INFO_INFO1_GI_SETTING GENMASK(1, 0)
285 #define HAL_RX_VHT_SIG_A_INFO_INFO1_SU_MU_CODING BIT(2)
286 #define HAL_RX_VHT_SIG_A_INFO_INFO1_MCS GENMASK(7, 4)
287 #define HAL_RX_VHT_SIG_A_INFO_INFO1_BEAMFORMED BIT(8)
289 struct hal_rx_vht_sig_a_info {
294 enum hal_rx_vht_sig_a_gi_setting {
295 HAL_RX_VHT_SIG_A_NORMAL_GI = 0,
296 HAL_RX_VHT_SIG_A_SHORT_GI = 1,
297 HAL_RX_VHT_SIG_A_SHORT_GI_AMBIGUITY = 3,
300 #define HAL_RX_SU_MU_CODING_LDPC 0x01
310 #define HE_LTF_UNKNOWN 3
312 #define HAL_RX_HE_SIG_A_SU_INFO_INFO0_TRANSMIT_MCS GENMASK(6, 3)
313 #define HAL_RX_HE_SIG_A_SU_INFO_INFO0_DCM BIT(7)
314 #define HAL_RX_HE_SIG_A_SU_INFO_INFO0_TRANSMIT_BW GENMASK(20, 19)
315 #define HAL_RX_HE_SIG_A_SU_INFO_INFO0_CP_LTF_SIZE GENMASK(22, 21)
316 #define HAL_RX_HE_SIG_A_SU_INFO_INFO0_NSTS GENMASK(25, 23)
317 #define HAL_RX_HE_SIG_A_SU_INFO_INFO0_BSS_COLOR GENMASK(13, 8)
318 #define HAL_RX_HE_SIG_A_SU_INFO_INFO0_SPATIAL_REUSE GENMASK(18, 15)
319 #define HAL_RX_HE_SIG_A_SU_INFO_INFO0_FORMAT_IND BIT(0)
320 #define HAL_RX_HE_SIG_A_SU_INFO_INFO0_BEAM_CHANGE BIT(1)
321 #define HAL_RX_HE_SIG_A_SU_INFO_INFO0_DL_UL_FLAG BIT(2)
323 #define HAL_RX_HE_SIG_A_SU_INFO_INFO1_TXOP_DURATION GENMASK(6, 0)
324 #define HAL_RX_HE_SIG_A_SU_INFO_INFO1_CODING BIT(7)
325 #define HAL_RX_HE_SIG_A_SU_INFO_INFO1_LDPC_EXTRA BIT(8)
326 #define HAL_RX_HE_SIG_A_SU_INFO_INFO1_STBC BIT(9)
327 #define HAL_RX_HE_SIG_A_SU_INFO_INFO1_TXBF BIT(10)
328 #define HAL_RX_HE_SIG_A_SU_INFO_INFO1_PKT_EXT_FACTOR GENMASK(12, 11)
329 #define HAL_RX_HE_SIG_A_SU_INFO_INFO1_PKT_EXT_PE_DISAM BIT(13)
330 #define HAL_RX_HE_SIG_A_SU_INFO_INFO1_DOPPLER_IND BIT(15)
332 struct hal_rx_he_sig_a_su_info {
337 #define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_UL_FLAG BIT(1)
338 #define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_MCS_OF_SIGB GENMASK(3, 1)
339 #define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_DCM_OF_SIGB BIT(4)
340 #define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_BSS_COLOR GENMASK(10, 5)
341 #define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_SPATIAL_REUSE GENMASK(14, 11)
342 #define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_TRANSMIT_BW GENMASK(17, 15)
343 #define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_NUM_SIGB_SYMB GENMASK(21, 18)
344 #define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_COMP_MODE_SIGB BIT(22)
345 #define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_CP_LTF_SIZE GENMASK(24, 23)
346 #define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_DOPPLER_INDICATION BIT(25)
348 #define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO1_TXOP_DURATION GENMASK(6, 0)
349 #define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO1_CODING BIT(7)
350 #define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO1_NUM_LTF_SYMB GENMASK(10, 8)
351 #define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO1_LDPC_EXTRA BIT(11)
352 #define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO1_STBC BIT(12)
353 #define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO1_TXBF BIT(10)
354 #define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO1_PKT_EXT_FACTOR GENMASK(14, 13)
355 #define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO1_PKT_EXT_PE_DISAM BIT(15)
357 struct hal_rx_he_sig_a_mu_dl_info {
362 #define HAL_RX_HE_SIG_B1_MU_INFO_INFO0_RU_ALLOCATION GENMASK(7, 0)
364 struct hal_rx_he_sig_b1_mu_info {
368 #define HAL_RX_HE_SIG_B2_MU_INFO_INFO0_STA_ID GENMASK(10, 0)
369 #define HAL_RX_HE_SIG_B2_MU_INFO_INFO0_STA_MCS GENMASK(18, 15)
370 #define HAL_RX_HE_SIG_B2_MU_INFO_INFO0_STA_CODING BIT(20)
371 #define HAL_RX_HE_SIG_B2_MU_INFO_INFO0_STA_NSTS GENMASK(31, 29)
373 struct hal_rx_he_sig_b2_mu_info {
377 #define HAL_RX_HE_SIG_B2_OFDMA_INFO_INFO0_STA_ID GENMASK(10, 0)
378 #define HAL_RX_HE_SIG_B2_OFDMA_INFO_INFO0_STA_NSTS GENMASK(13, 11)
379 #define HAL_RX_HE_SIG_B2_OFDMA_INFO_INFO0_STA_TXBF BIT(19)
380 #define HAL_RX_HE_SIG_B2_OFDMA_INFO_INFO0_STA_MCS GENMASK(18, 15)
381 #define HAL_RX_HE_SIG_B2_OFDMA_INFO_INFO0_STA_DCM BIT(19)
382 #define HAL_RX_HE_SIG_B2_OFDMA_INFO_INFO0_STA_CODING BIT(20)
384 struct hal_rx_he_sig_b2_ofdma_info {
388 #define HAL_RX_PHYRX_RSSI_LEGACY_INFO_INFO1_RSSI_COMB GENMASK(15, 8)
390 #define HAL_RX_PHYRX_RSSI_PREAMBLE_PRI20 GENMASK(7, 0)
392 struct hal_rx_phyrx_chain_rssi {
397 struct hal_rx_phyrx_rssi_legacy_info {
399 struct hal_rx_phyrx_chain_rssi pre_rssi[HAL_RX_MAX_NSS];
400 struct hal_rx_phyrx_chain_rssi preamble[HAL_RX_MAX_NSS];
404 #define HAL_RX_MPDU_INFO_INFO0_PEERID GENMASK(31, 16)
405 #define HAL_RX_MPDU_INFO_INFO0_PEERID_WCN6855 GENMASK(15, 0)
406 #define HAL_RX_MPDU_INFO_INFO1_MPDU_LEN GENMASK(13, 0)
408 struct hal_rx_mpdu_info {
416 struct hal_rx_mpdu_info_wcn6855 {
422 #define HAL_RX_PPDU_END_DURATION GENMASK(23, 0)
423 struct hal_rx_ppdu_end_duration {
429 struct hal_rx_rxpcu_classification_overview {
433 struct hal_rx_msdu_desc_info {
435 u16 msdu_len; /* 14 bits for length */
438 #define HAL_RX_NUM_MSDU_DESC 6
439 struct hal_rx_msdu_list {
440 struct hal_rx_msdu_desc_info msdu_info[HAL_RX_NUM_MSDU_DESC];
441 u32 sw_cookie[HAL_RX_NUM_MSDU_DESC];
442 u8 rbm[HAL_RX_NUM_MSDU_DESC];
445 void ath11k_hal_reo_status_queue_stats(struct ath11k_base *ab, u32 *reo_desc,
446 struct hal_reo_status *status);
447 void ath11k_hal_reo_flush_queue_status(struct ath11k_base *ab, u32 *reo_desc,
448 struct hal_reo_status *status);
449 void ath11k_hal_reo_flush_cache_status(struct ath11k_base *ab, u32 *reo_desc,
450 struct hal_reo_status *status);
451 void ath11k_hal_reo_flush_cache_status(struct ath11k_base *ab, u32 *reo_desc,
452 struct hal_reo_status *status);
453 void ath11k_hal_reo_unblk_cache_status(struct ath11k_base *ab, u32 *reo_desc,
454 struct hal_reo_status *status);
455 void ath11k_hal_reo_flush_timeout_list_status(struct ath11k_base *ab,
457 struct hal_reo_status *status);
458 void ath11k_hal_reo_desc_thresh_reached_status(struct ath11k_base *ab,
460 struct hal_reo_status *status);
461 void ath11k_hal_reo_update_rx_reo_queue_status(struct ath11k_base *ab,
463 struct hal_reo_status *status);
464 int ath11k_hal_reo_process_status(u8 *reo_desc, u8 *status);
465 void ath11k_hal_rx_msdu_link_info_get(void *link_desc, u32 *num_msdus,
467 enum hal_rx_buf_return_buf_manager *rbm);
468 void ath11k_hal_rx_msdu_link_desc_set(struct ath11k_base *ab, void *desc,
470 enum hal_wbm_rel_bm_act action);
471 void ath11k_hal_rx_buf_addr_info_set(void *desc, dma_addr_t paddr,
472 u32 cookie, u8 manager);
473 void ath11k_hal_rx_buf_addr_info_get(void *desc, dma_addr_t *paddr,
474 u32 *cookie, u8 *rbm);
475 int ath11k_hal_desc_reo_parse_err(struct ath11k_base *ab, u32 *rx_desc,
476 dma_addr_t *paddr, u32 *desc_bank);
477 int ath11k_hal_wbm_desc_parse_err(struct ath11k_base *ab, void *desc,
478 struct hal_rx_wbm_rel_info *rel_info);
479 void ath11k_hal_rx_reo_ent_paddr_get(struct ath11k_base *ab, void *desc,
480 dma_addr_t *paddr, u32 *desc_bank);
481 void ath11k_hal_rx_reo_ent_buf_paddr_get(void *rx_desc,
482 dma_addr_t *paddr, u32 *sw_cookie,
483 void **pp_buf_addr_info, u8 *rbm,
486 ath11k_hal_rx_sw_mon_ring_buf_paddr_get(void *rx_desc,
487 struct hal_sw_mon_ring_entries *sw_mon_ent);
488 enum hal_rx_mon_status
489 ath11k_hal_rx_parse_mon_status(struct ath11k_base *ab,
490 struct hal_rx_mon_ppdu_info *ppdu_info,
491 struct sk_buff *skb);
493 #define REO_QUEUE_DESC_MAGIC_DEBUG_PATTERN_0 0xDDBEEF
494 #define REO_QUEUE_DESC_MAGIC_DEBUG_PATTERN_1 0xADBEEF
495 #define REO_QUEUE_DESC_MAGIC_DEBUG_PATTERN_2 0xBDBEEF
496 #define REO_QUEUE_DESC_MAGIC_DEBUG_PATTERN_3 0xCDBEEF