Path: blob/main/sys/contrib/dev/athk/ath11k/hal_rx.h
106880 views
/* SPDX-License-Identifier: BSD-3-Clause-Clear */1/*2* Copyright (c) 2018-2019 The Linux Foundation. All rights reserved.3* Copyright (c) 2021-2023 Qualcomm Innovation Center, Inc. All rights reserved.4*/56#ifndef ATH11K_HAL_RX_H7#define ATH11K_HAL_RX_H89struct hal_rx_wbm_rel_info {10u32 cookie;11enum hal_wbm_rel_src_module err_rel_src;12enum hal_reo_dest_ring_push_reason push_reason;13u32 err_code;14bool first_msdu;15bool last_msdu;16};1718#define HAL_INVALID_PEERID 0xffff19#define VHT_SIG_SU_NSS_MASK 0x72021#define HAL_RX_MAX_MCS 1222#define HAL_RX_MAX_NSS 82324struct hal_rx_mon_status_tlv_hdr {25u32 hdr;26u8 value[];27};2829enum hal_rx_su_mu_coding {30HAL_RX_SU_MU_CODING_BCC,31HAL_RX_SU_MU_CODING_LDPC,32HAL_RX_SU_MU_CODING_MAX,33};3435enum hal_rx_gi {36HAL_RX_GI_0_8_US,37HAL_RX_GI_0_4_US,38HAL_RX_GI_1_6_US,39HAL_RX_GI_3_2_US,40HAL_RX_GI_MAX,41};4243enum hal_rx_bw {44HAL_RX_BW_20MHZ,45HAL_RX_BW_40MHZ,46HAL_RX_BW_80MHZ,47HAL_RX_BW_160MHZ,48HAL_RX_BW_MAX,49};5051enum hal_rx_preamble {52HAL_RX_PREAMBLE_11A,53HAL_RX_PREAMBLE_11B,54HAL_RX_PREAMBLE_11N,55HAL_RX_PREAMBLE_11AC,56HAL_RX_PREAMBLE_11AX,57HAL_RX_PREAMBLE_MAX,58};5960enum hal_rx_reception_type {61HAL_RX_RECEPTION_TYPE_SU,62HAL_RX_RECEPTION_TYPE_MU_MIMO,63HAL_RX_RECEPTION_TYPE_MU_OFDMA,64HAL_RX_RECEPTION_TYPE_MU_OFDMA_MIMO,65HAL_RX_RECEPTION_TYPE_MAX,66};6768#define HAL_RX_FCS_LEN 46970enum hal_rx_mon_status {71HAL_RX_MON_STATUS_PPDU_NOT_DONE,72HAL_RX_MON_STATUS_PPDU_DONE,73HAL_RX_MON_STATUS_BUF_DONE,74};7576struct hal_rx_user_status {77u32 mcs:4,78nss:3,79ofdma_info_valid:1,80dl_ofdma_ru_start_index:7,81dl_ofdma_ru_width:7,82dl_ofdma_ru_size:8;83u32 ul_ofdma_user_v0_word0;84u32 ul_ofdma_user_v0_word1;85u32 ast_index;86u32 tid;87u16 tcp_msdu_count;88u16 udp_msdu_count;89u16 other_msdu_count;90u16 frame_control;91u8 frame_control_info_valid;92u8 data_sequence_control_info_valid;93u16 first_data_seq_ctrl;94u32 preamble_type;95u16 ht_flags;96u16 vht_flags;97u16 he_flags;98u8 rs_flags;99u32 mpdu_cnt_fcs_ok;100u32 mpdu_cnt_fcs_err;101u32 mpdu_fcs_ok_bitmap[8];102u32 mpdu_ok_byte_count;103u32 mpdu_err_byte_count;104};105106#define HAL_TLV_STATUS_PPDU_NOT_DONE HAL_RX_MON_STATUS_PPDU_NOT_DONE107#define HAL_TLV_STATUS_PPDU_DONE HAL_RX_MON_STATUS_PPDU_DONE108#define HAL_TLV_STATUS_BUF_DONE HAL_RX_MON_STATUS_BUF_DONE109110struct hal_sw_mon_ring_entries {111dma_addr_t mon_dst_paddr;112dma_addr_t mon_status_paddr;113u32 mon_dst_sw_cookie;114u32 mon_status_sw_cookie;115void *dst_buf_addr_info;116void *status_buf_addr_info;117u16 ppdu_id;118u8 status_buf_count;119u8 msdu_cnt;120bool end_of_ppdu;121bool drop_ppdu;122};123124struct hal_rx_mon_ppdu_info {125u32 ppdu_id;126u32 ppdu_ts;127u32 num_mpdu_fcs_ok;128u32 num_mpdu_fcs_err;129u32 preamble_type;130u16 chan_num;131u16 tcp_msdu_count;132u16 tcp_ack_msdu_count;133u16 udp_msdu_count;134u16 other_msdu_count;135u16 peer_id;136u8 rate;137u8 mcs;138u8 nss;139u8 bw;140u8 vht_flag_values1;141u8 vht_flag_values2;142u8 vht_flag_values3[4];143u8 vht_flag_values4;144u8 vht_flag_values5;145u16 vht_flag_values6;146u8 is_stbc;147u8 gi;148u8 ldpc;149u8 beamformed;150u8 rssi_comb;151u8 rssi_chain_pri20[HAL_RX_MAX_NSS];152u16 tid;153u16 ht_flags;154u16 vht_flags;155u16 he_flags;156u16 he_mu_flags;157u8 dcm;158u8 ru_alloc;159u8 reception_type;160u64 tsft;161u64 rx_duration;162u16 frame_control;163u32 ast_index;164u8 rs_fcs_err;165u8 rs_flags;166u8 cck_flag;167u8 ofdm_flag;168u8 ulofdma_flag;169u8 frame_control_info_valid;170u16 he_per_user_1;171u16 he_per_user_2;172u8 he_per_user_position;173u8 he_per_user_known;174u16 he_flags1;175u16 he_flags2;176u8 he_RU[4];177u16 he_data1;178u16 he_data2;179u16 he_data3;180u16 he_data4;181u16 he_data5;182u16 he_data6;183u32 ppdu_len;184u32 prev_ppdu_id;185u32 device_id;186u16 first_data_seq_ctrl;187u8 monitor_direct_used;188u8 data_sequence_control_info_valid;189u8 ltf_size;190u8 rxpcu_filter_pass;191char rssi_chain[8][8];192struct hal_rx_user_status userstats;193};194195#define HAL_RX_PPDU_START_INFO0_PPDU_ID GENMASK(15, 0)196197struct hal_rx_ppdu_start {198__le32 info0;199__le32 chan_num;200__le32 ppdu_start_ts;201} __packed;202203#define HAL_RX_PPDU_END_USER_STATS_INFO0_MPDU_CNT_FCS_ERR GENMASK(25, 16)204205#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)210211#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)213214#define HAL_RX_PPDU_END_USER_STATS_INFO3_QOS_CTRL GENMASK(31, 16)215216#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)218219#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)221222#define HAL_RX_PPDU_END_USER_STATS_INFO7_TID_BITMAP GENMASK(15, 0)223#define HAL_RX_PPDU_END_USER_STATS_INFO7_TID_EOSP_BITMAP GENMASK(31, 16)224225#define HAL_RX_PPDU_END_USER_STATS_INFO8_MPDU_OK_BYTE_COUNT GENMASK(24, 0)226#define HAL_RX_PPDU_END_USER_STATS_INFO9_MPDU_ERR_BYTE_COUNT GENMASK(24, 0)227228struct hal_rx_ppdu_end_user_stats {229__le32 rsvd0[2];230__le32 info0;231__le32 info1;232__le32 info2;233__le32 info3;234__le32 ht_ctrl;235__le32 rsvd1[2];236__le32 info4;237__le32 info5;238__le32 info6;239__le32 info7;240__le32 rsvd2[4];241__le32 info8;242__le32 rsvd3;243__le32 info9;244__le32 rsvd4[2];245__le32 info10;246} __packed;247248struct hal_rx_ppdu_end_user_stats_ext {249u32 info0;250u32 info1;251u32 info2;252u32 info3;253u32 info4;254u32 info5;255u32 info6;256} __packed;257258#define HAL_RX_HT_SIG_INFO_INFO0_MCS GENMASK(6, 0)259#define HAL_RX_HT_SIG_INFO_INFO0_BW BIT(7)260261#define HAL_RX_HT_SIG_INFO_INFO1_STBC GENMASK(5, 4)262#define HAL_RX_HT_SIG_INFO_INFO1_FEC_CODING BIT(6)263#define HAL_RX_HT_SIG_INFO_INFO1_GI BIT(7)264265struct hal_rx_ht_sig_info {266__le32 info0;267__le32 info1;268} __packed;269270#define HAL_RX_LSIG_B_INFO_INFO0_RATE GENMASK(3, 0)271#define HAL_RX_LSIG_B_INFO_INFO0_LEN GENMASK(15, 4)272273struct hal_rx_lsig_b_info {274__le32 info0;275} __packed;276277#define HAL_RX_LSIG_A_INFO_INFO0_RATE GENMASK(3, 0)278#define HAL_RX_LSIG_A_INFO_INFO0_LEN GENMASK(16, 5)279#define HAL_RX_LSIG_A_INFO_INFO0_PKT_TYPE GENMASK(27, 24)280281struct hal_rx_lsig_a_info {282__le32 info0;283} __packed;284285#define HAL_RX_VHT_SIG_A_INFO_INFO0_BW GENMASK(1, 0)286#define HAL_RX_VHT_SIG_A_INFO_INFO0_STBC BIT(3)287#define HAL_RX_VHT_SIG_A_INFO_INFO0_GROUP_ID GENMASK(9, 4)288#define HAL_RX_VHT_SIG_A_INFO_INFO0_NSTS GENMASK(21, 10)289290#define HAL_RX_VHT_SIG_A_INFO_INFO1_GI_SETTING GENMASK(1, 0)291#define HAL_RX_VHT_SIG_A_INFO_INFO1_SU_MU_CODING BIT(2)292#define HAL_RX_VHT_SIG_A_INFO_INFO1_MCS GENMASK(7, 4)293#define HAL_RX_VHT_SIG_A_INFO_INFO1_BEAMFORMED BIT(8)294295struct hal_rx_vht_sig_a_info {296__le32 info0;297__le32 info1;298} __packed;299300enum hal_rx_vht_sig_a_gi_setting {301HAL_RX_VHT_SIG_A_NORMAL_GI = 0,302HAL_RX_VHT_SIG_A_SHORT_GI = 1,303HAL_RX_VHT_SIG_A_SHORT_GI_AMBIGUITY = 3,304};305306#define HAL_RX_SU_MU_CODING_LDPC 0x01307308#define HE_GI_0_8 0309#define HE_GI_0_4 1310#define HE_GI_1_6 2311#define HE_GI_3_2 3312313#define HE_LTF_1_X 0314#define HE_LTF_2_X 1315#define HE_LTF_4_X 2316#define HE_LTF_UNKNOWN 3317318#define HAL_RX_HE_SIG_A_SU_INFO_INFO0_TRANSMIT_MCS GENMASK(6, 3)319#define HAL_RX_HE_SIG_A_SU_INFO_INFO0_DCM BIT(7)320#define HAL_RX_HE_SIG_A_SU_INFO_INFO0_TRANSMIT_BW GENMASK(20, 19)321#define HAL_RX_HE_SIG_A_SU_INFO_INFO0_CP_LTF_SIZE GENMASK(22, 21)322#define HAL_RX_HE_SIG_A_SU_INFO_INFO0_NSTS GENMASK(25, 23)323#define HAL_RX_HE_SIG_A_SU_INFO_INFO0_BSS_COLOR GENMASK(13, 8)324#define HAL_RX_HE_SIG_A_SU_INFO_INFO0_SPATIAL_REUSE GENMASK(18, 15)325#define HAL_RX_HE_SIG_A_SU_INFO_INFO0_FORMAT_IND BIT(0)326#define HAL_RX_HE_SIG_A_SU_INFO_INFO0_BEAM_CHANGE BIT(1)327#define HAL_RX_HE_SIG_A_SU_INFO_INFO0_DL_UL_FLAG BIT(2)328329#define HAL_RX_HE_SIG_A_SU_INFO_INFO1_TXOP_DURATION GENMASK(6, 0)330#define HAL_RX_HE_SIG_A_SU_INFO_INFO1_CODING BIT(7)331#define HAL_RX_HE_SIG_A_SU_INFO_INFO1_LDPC_EXTRA BIT(8)332#define HAL_RX_HE_SIG_A_SU_INFO_INFO1_STBC BIT(9)333#define HAL_RX_HE_SIG_A_SU_INFO_INFO1_TXBF BIT(10)334#define HAL_RX_HE_SIG_A_SU_INFO_INFO1_PKT_EXT_FACTOR GENMASK(12, 11)335#define HAL_RX_HE_SIG_A_SU_INFO_INFO1_PKT_EXT_PE_DISAM BIT(13)336#define HAL_RX_HE_SIG_A_SU_INFO_INFO1_DOPPLER_IND BIT(15)337338struct hal_rx_he_sig_a_su_info {339__le32 info0;340__le32 info1;341} __packed;342343#define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_UL_FLAG BIT(1)344#define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_MCS_OF_SIGB GENMASK(3, 1)345#define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_DCM_OF_SIGB BIT(4)346#define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_BSS_COLOR GENMASK(10, 5)347#define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_SPATIAL_REUSE GENMASK(14, 11)348#define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_TRANSMIT_BW GENMASK(17, 15)349#define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_NUM_SIGB_SYMB GENMASK(21, 18)350#define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_COMP_MODE_SIGB BIT(22)351#define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_CP_LTF_SIZE GENMASK(24, 23)352#define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO0_DOPPLER_INDICATION BIT(25)353354#define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO1_TXOP_DURATION GENMASK(6, 0)355#define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO1_CODING BIT(7)356#define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO1_NUM_LTF_SYMB GENMASK(10, 8)357#define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO1_LDPC_EXTRA BIT(11)358#define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO1_STBC BIT(12)359#define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO1_TXBF BIT(10)360#define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO1_PKT_EXT_FACTOR GENMASK(14, 13)361#define HAL_RX_HE_SIG_A_MU_DL_INFO_INFO1_PKT_EXT_PE_DISAM BIT(15)362363struct hal_rx_he_sig_a_mu_dl_info {364__le32 info0;365__le32 info1;366} __packed;367368#define HAL_RX_HE_SIG_B1_MU_INFO_INFO0_RU_ALLOCATION GENMASK(7, 0)369370struct hal_rx_he_sig_b1_mu_info {371__le32 info0;372} __packed;373374#define HAL_RX_HE_SIG_B2_MU_INFO_INFO0_STA_ID GENMASK(10, 0)375#define HAL_RX_HE_SIG_B2_MU_INFO_INFO0_STA_MCS GENMASK(18, 15)376#define HAL_RX_HE_SIG_B2_MU_INFO_INFO0_STA_CODING BIT(20)377#define HAL_RX_HE_SIG_B2_MU_INFO_INFO0_STA_NSTS GENMASK(31, 29)378379struct hal_rx_he_sig_b2_mu_info {380__le32 info0;381} __packed;382383#define HAL_RX_HE_SIG_B2_OFDMA_INFO_INFO0_STA_ID GENMASK(10, 0)384#define HAL_RX_HE_SIG_B2_OFDMA_INFO_INFO0_STA_NSTS GENMASK(13, 11)385#define HAL_RX_HE_SIG_B2_OFDMA_INFO_INFO0_STA_TXBF BIT(19)386#define HAL_RX_HE_SIG_B2_OFDMA_INFO_INFO0_STA_MCS GENMASK(18, 15)387#define HAL_RX_HE_SIG_B2_OFDMA_INFO_INFO0_STA_DCM BIT(19)388#define HAL_RX_HE_SIG_B2_OFDMA_INFO_INFO0_STA_CODING BIT(20)389390struct hal_rx_he_sig_b2_ofdma_info {391__le32 info0;392} __packed;393394#define HAL_RX_PHYRX_RSSI_LEGACY_INFO_INFO0_RSSI_COMB GENMASK(15, 8)395396#define HAL_RX_PHYRX_RSSI_PREAMBLE_PRI20 GENMASK(7, 0)397398struct hal_rx_phyrx_chain_rssi {399__le32 rssi_2040;400__le32 rssi_80;401} __packed;402403struct hal_rx_phyrx_rssi_legacy_info {404__le32 rsvd[3];405struct hal_rx_phyrx_chain_rssi pre_rssi[HAL_RX_MAX_NSS];406struct hal_rx_phyrx_chain_rssi preamble[HAL_RX_MAX_NSS];407__le32 info0;408} __packed;409410#define HAL_RX_MPDU_INFO_INFO0_PEERID GENMASK(31, 16)411#define HAL_RX_MPDU_INFO_INFO0_PEERID_WCN6855 GENMASK(15, 0)412#define HAL_RX_MPDU_INFO_INFO1_MPDU_LEN GENMASK(13, 0)413414struct hal_rx_mpdu_info_ipq8074 {415__le32 rsvd0;416__le32 info0;417__le32 rsvd1[11];418__le32 info1;419__le32 rsvd2[9];420} __packed;421422struct hal_rx_mpdu_info_qcn9074 {423__le32 rsvd0[10];424__le32 info0;425__le32 rsvd1[2];426__le32 info1;427__le32 rsvd2[9];428} __packed;429430struct hal_rx_mpdu_info_wcn6855 {431__le32 rsvd0[8];432__le32 info0;433__le32 rsvd1[14];434} __packed;435436struct hal_rx_mpdu_info {437union {438struct hal_rx_mpdu_info_ipq8074 ipq8074;439struct hal_rx_mpdu_info_qcn9074 qcn9074;440struct hal_rx_mpdu_info_wcn6855 wcn6855;441} u;442} __packed;443444#define HAL_RX_PPDU_END_DURATION GENMASK(23, 0)445struct hal_rx_ppdu_end_duration {446__le32 rsvd0[9];447__le32 info0;448__le32 rsvd1[4];449} __packed;450451struct hal_rx_rxpcu_classification_overview {452u32 rsvd0;453} __packed;454455struct hal_rx_msdu_desc_info {456u32 msdu_flags;457u16 msdu_len; /* 14 bits for length */458};459460#define HAL_RX_NUM_MSDU_DESC 6461struct hal_rx_msdu_list {462struct hal_rx_msdu_desc_info msdu_info[HAL_RX_NUM_MSDU_DESC];463u32 sw_cookie[HAL_RX_NUM_MSDU_DESC];464u8 rbm[HAL_RX_NUM_MSDU_DESC];465};466467void ath11k_hal_reo_status_queue_stats(struct ath11k_base *ab, u32 *reo_desc,468struct hal_reo_status *status);469void ath11k_hal_reo_flush_queue_status(struct ath11k_base *ab, u32 *reo_desc,470struct hal_reo_status *status);471void ath11k_hal_reo_flush_cache_status(struct ath11k_base *ab, u32 *reo_desc,472struct hal_reo_status *status);473void ath11k_hal_reo_flush_cache_status(struct ath11k_base *ab, u32 *reo_desc,474struct hal_reo_status *status);475void ath11k_hal_reo_unblk_cache_status(struct ath11k_base *ab, u32 *reo_desc,476struct hal_reo_status *status);477void ath11k_hal_reo_flush_timeout_list_status(struct ath11k_base *ab,478u32 *reo_desc,479struct hal_reo_status *status);480void ath11k_hal_reo_desc_thresh_reached_status(struct ath11k_base *ab,481u32 *reo_desc,482struct hal_reo_status *status);483void ath11k_hal_reo_update_rx_reo_queue_status(struct ath11k_base *ab,484u32 *reo_desc,485struct hal_reo_status *status);486int ath11k_hal_reo_process_status(u8 *reo_desc, u8 *status);487void ath11k_hal_rx_msdu_link_info_get(void *link_desc, u32 *num_msdus,488u32 *msdu_cookies,489enum hal_rx_buf_return_buf_manager *rbm);490void ath11k_hal_rx_msdu_link_desc_set(struct ath11k_base *ab, void *desc,491void *link_desc,492enum hal_wbm_rel_bm_act action);493void ath11k_hal_rx_buf_addr_info_set(void *desc, dma_addr_t paddr,494u32 cookie, u8 manager);495void ath11k_hal_rx_buf_addr_info_get(void *desc, dma_addr_t *paddr,496u32 *cookie, u8 *rbm);497int ath11k_hal_desc_reo_parse_err(struct ath11k_base *ab, u32 *rx_desc,498dma_addr_t *paddr, u32 *desc_bank);499int ath11k_hal_wbm_desc_parse_err(struct ath11k_base *ab, void *desc,500struct hal_rx_wbm_rel_info *rel_info);501void ath11k_hal_rx_reo_ent_paddr_get(struct ath11k_base *ab, void *desc,502dma_addr_t *paddr, u32 *desc_bank);503void ath11k_hal_rx_reo_ent_buf_paddr_get(void *rx_desc,504dma_addr_t *paddr, u32 *sw_cookie,505void **pp_buf_addr_info, u8 *rbm,506u32 *msdu_cnt);507void508ath11k_hal_rx_sw_mon_ring_buf_paddr_get(void *rx_desc,509struct hal_sw_mon_ring_entries *sw_mon_ent);510enum hal_rx_mon_status511ath11k_hal_rx_parse_mon_status(struct ath11k_base *ab,512struct hal_rx_mon_ppdu_info *ppdu_info,513struct sk_buff *skb);514515#define REO_QUEUE_DESC_MAGIC_DEBUG_PATTERN_0 0xDDBEEF516#define REO_QUEUE_DESC_MAGIC_DEBUG_PATTERN_1 0xADBEEF517#define REO_QUEUE_DESC_MAGIC_DEBUG_PATTERN_2 0xBDBEEF518#define REO_QUEUE_DESC_MAGIC_DEBUG_PATTERN_3 0xCDBEEF519#endif520521522