/* * Copyright (c) 2019, The Linux Foundation. All rights reserved. * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ #ifndef _RX_MPDU_DESC_INFO_H_ #define _RX_MPDU_DESC_INFO_H_ #if !defined(__ASSEMBLER__) #endif // ################ START SUMMARY ################# // // Dword Fields // 0 msdu_count[7:0], mpdu_sequence_number[19:8], fragment_flag[20], mpdu_retry_bit[21], ampdu_flag[22], bar_frame[23], pn_fields_contain_valid_info[24], sa_is_valid[25], sa_idx_timeout[26], da_is_valid[27], da_is_mcbc[28], da_idx_timeout[29], raw_mpdu[30], more_fragment_flag[31] // 1 peer_meta_data[31:0] // // ################ END SUMMARY ################# #define NUM_OF_DWORDS_RX_MPDU_DESC_INFO 2 struct rx_mpdu_desc_info { uint32_t msdu_count : 8, //[7:0] mpdu_sequence_number : 12, //[19:8] fragment_flag : 1, //[20] mpdu_retry_bit : 1, //[21] ampdu_flag : 1, //[22] bar_frame : 1, //[23] pn_fields_contain_valid_info : 1, //[24] sa_is_valid : 1, //[25] sa_idx_timeout : 1, //[26] da_is_valid : 1, //[27] da_is_mcbc : 1, //[28] da_idx_timeout : 1, //[29] raw_mpdu : 1, //[30] more_fragment_flag : 1; //[31] uint32_t peer_meta_data : 32; //[31:0] }; /* msdu_count Consumer: REO/SW/FW Producer: RXDMA The number of MSDUs within the MPDU mpdu_sequence_number Consumer: REO/SW/FW Producer: RXDMA The field can have two different meanings based on the setting of field 'BAR_frame': 'BAR_frame' is NOT set: The MPDU sequence number of the received frame. 'BAR_frame' is set. The MPDU Start sequence number from the BAR frame fragment_flag Consumer: REO/SW/FW Producer: RXDMA When set, this MPDU is a fragment and REO should forward this fragment MPDU to the REO destination ring without any reorder checks, pn checks or bitmap update. This implies that REO is forwarding the pointer to the MSDU link descriptor. The destination ring is coming from a programmable register setting in REO mpdu_retry_bit Consumer: REO/SW/FW Producer: RXDMA The retry bit setting from the MPDU header of the received frame ampdu_flag Consumer: REO/SW/FW Producer: RXDMA When set, the MPDU was received as part of an A-MPDU. bar_frame Consumer: REO/SW/FW Producer: RXDMA When set, the received frame is a BAR frame. After processing, this frame shall be pushed to SW or deleted. pn_fields_contain_valid_info Consumer: REO/SW/FW Producer: RXDMA Copied here by RXDMA from RX_MPDU_END When not set, REO will Not perform a PN sequence number check sa_is_valid When set, OLE found a valid SA entry for all MSDUs in this MPDU sa_idx_timeout When set, at least 1 MSDU within the MPDU has an unsuccessful MAC source address search due to the expiration of the search timer. da_is_valid When set, OLE found a valid DA entry for all MSDUs in this MPDU da_is_mcbc Field Only valid if da_is_valid is set When set, at least one of the DA addresses is a Multicast or Broadcast address. da_idx_timeout When set, at least 1 MSDU within the MPDU has an unsuccessful MAC destination address search due to the expiration of the search timer. raw_mpdu Field only valid when first_msdu_in_mpdu_flag is set. When set, the contents in the MSDU buffer contains a 'RAW' MPDU. This 'RAW' MPDU might be spread out over multiple MSDU buffers. more_fragment_flag The More Fragment bit setting from the MPDU header of the received frame peer_meta_data Meta data that SW has programmed in the Peer table entry of the transmitting STA. */ /* Description RX_MPDU_DESC_INFO_0_MSDU_COUNT Consumer: REO/SW/FW Producer: RXDMA The number of MSDUs within the MPDU */ #define RX_MPDU_DESC_INFO_0_MSDU_COUNT_OFFSET 0x00000000 #define RX_MPDU_DESC_INFO_0_MSDU_COUNT_LSB 0 #define RX_MPDU_DESC_INFO_0_MSDU_COUNT_MASK 0x000000ff /* Description RX_MPDU_DESC_INFO_0_MPDU_SEQUENCE_NUMBER Consumer: REO/SW/FW Producer: RXDMA The field can have two different meanings based on the setting of field 'BAR_frame': 'BAR_frame' is NOT set: The MPDU sequence number of the received frame. 'BAR_frame' is set. The MPDU Start sequence number from the BAR frame */ #define RX_MPDU_DESC_INFO_0_MPDU_SEQUENCE_NUMBER_OFFSET 0x00000000 #define RX_MPDU_DESC_INFO_0_MPDU_SEQUENCE_NUMBER_LSB 8 #define RX_MPDU_DESC_INFO_0_MPDU_SEQUENCE_NUMBER_MASK 0x000fff00 /* Description RX_MPDU_DESC_INFO_0_FRAGMENT_FLAG Consumer: REO/SW/FW Producer: RXDMA When set, this MPDU is a fragment and REO should forward this fragment MPDU to the REO destination ring without any reorder checks, pn checks or bitmap update. This implies that REO is forwarding the pointer to the MSDU link descriptor. The destination ring is coming from a programmable register setting in REO */ #define RX_MPDU_DESC_INFO_0_FRAGMENT_FLAG_OFFSET 0x00000000 #define RX_MPDU_DESC_INFO_0_FRAGMENT_FLAG_LSB 20 #define RX_MPDU_DESC_INFO_0_FRAGMENT_FLAG_MASK 0x00100000 /* Description RX_MPDU_DESC_INFO_0_MPDU_RETRY_BIT Consumer: REO/SW/FW Producer: RXDMA The retry bit setting from the MPDU header of the received frame */ #define RX_MPDU_DESC_INFO_0_MPDU_RETRY_BIT_OFFSET 0x00000000 #define RX_MPDU_DESC_INFO_0_MPDU_RETRY_BIT_LSB 21 #define RX_MPDU_DESC_INFO_0_MPDU_RETRY_BIT_MASK 0x00200000 /* Description RX_MPDU_DESC_INFO_0_AMPDU_FLAG Consumer: REO/SW/FW Producer: RXDMA When set, the MPDU was received as part of an A-MPDU. */ #define RX_MPDU_DESC_INFO_0_AMPDU_FLAG_OFFSET 0x00000000 #define RX_MPDU_DESC_INFO_0_AMPDU_FLAG_LSB 22 #define RX_MPDU_DESC_INFO_0_AMPDU_FLAG_MASK 0x00400000 /* Description RX_MPDU_DESC_INFO_0_BAR_FRAME Consumer: REO/SW/FW Producer: RXDMA When set, the received frame is a BAR frame. After processing, this frame shall be pushed to SW or deleted. */ #define RX_MPDU_DESC_INFO_0_BAR_FRAME_OFFSET 0x00000000 #define RX_MPDU_DESC_INFO_0_BAR_FRAME_LSB 23 #define RX_MPDU_DESC_INFO_0_BAR_FRAME_MASK 0x00800000 /* Description RX_MPDU_DESC_INFO_0_PN_FIELDS_CONTAIN_VALID_INFO Consumer: REO/SW/FW Producer: RXDMA Copied here by RXDMA from RX_MPDU_END When not set, REO will Not perform a PN sequence number check */ #define RX_MPDU_DESC_INFO_0_PN_FIELDS_CONTAIN_VALID_INFO_OFFSET 0x00000000 #define RX_MPDU_DESC_INFO_0_PN_FIELDS_CONTAIN_VALID_INFO_LSB 24 #define RX_MPDU_DESC_INFO_0_PN_FIELDS_CONTAIN_VALID_INFO_MASK 0x01000000 /* Description RX_MPDU_DESC_INFO_0_SA_IS_VALID When set, OLE found a valid SA entry for all MSDUs in this MPDU */ #define RX_MPDU_DESC_INFO_0_SA_IS_VALID_OFFSET 0x00000000 #define RX_MPDU_DESC_INFO_0_SA_IS_VALID_LSB 25 #define RX_MPDU_DESC_INFO_0_SA_IS_VALID_MASK 0x02000000 /* Description RX_MPDU_DESC_INFO_0_SA_IDX_TIMEOUT When set, at least 1 MSDU within the MPDU has an unsuccessful MAC source address search due to the expiration of the search timer. */ #define RX_MPDU_DESC_INFO_0_SA_IDX_TIMEOUT_OFFSET 0x00000000 #define RX_MPDU_DESC_INFO_0_SA_IDX_TIMEOUT_LSB 26 #define RX_MPDU_DESC_INFO_0_SA_IDX_TIMEOUT_MASK 0x04000000 /* Description RX_MPDU_DESC_INFO_0_DA_IS_VALID When set, OLE found a valid DA entry for all MSDUs in this MPDU */ #define RX_MPDU_DESC_INFO_0_DA_IS_VALID_OFFSET 0x00000000 #define RX_MPDU_DESC_INFO_0_DA_IS_VALID_LSB 27 #define RX_MPDU_DESC_INFO_0_DA_IS_VALID_MASK 0x08000000 /* Description RX_MPDU_DESC_INFO_0_DA_IS_MCBC Field Only valid if da_is_valid is set When set, at least one of the DA addresses is a Multicast or Broadcast address. */ #define RX_MPDU_DESC_INFO_0_DA_IS_MCBC_OFFSET 0x00000000 #define RX_MPDU_DESC_INFO_0_DA_IS_MCBC_LSB 28 #define RX_MPDU_DESC_INFO_0_DA_IS_MCBC_MASK 0x10000000 /* Description RX_MPDU_DESC_INFO_0_DA_IDX_TIMEOUT When set, at least 1 MSDU within the MPDU has an unsuccessful MAC destination address search due to the expiration of the search timer. */ #define RX_MPDU_DESC_INFO_0_DA_IDX_TIMEOUT_OFFSET 0x00000000 #define RX_MPDU_DESC_INFO_0_DA_IDX_TIMEOUT_LSB 29 #define RX_MPDU_DESC_INFO_0_DA_IDX_TIMEOUT_MASK 0x20000000 /* Description RX_MPDU_DESC_INFO_0_RAW_MPDU Field only valid when first_msdu_in_mpdu_flag is set. When set, the contents in the MSDU buffer contains a 'RAW' MPDU. This 'RAW' MPDU might be spread out over multiple MSDU buffers. */ #define RX_MPDU_DESC_INFO_0_RAW_MPDU_OFFSET 0x00000000 #define RX_MPDU_DESC_INFO_0_RAW_MPDU_LSB 30 #define RX_MPDU_DESC_INFO_0_RAW_MPDU_MASK 0x40000000 /* Description RX_MPDU_DESC_INFO_0_MORE_FRAGMENT_FLAG The More Fragment bit setting from the MPDU header of the received frame */ #define RX_MPDU_DESC_INFO_0_MORE_FRAGMENT_FLAG_OFFSET 0x00000000 #define RX_MPDU_DESC_INFO_0_MORE_FRAGMENT_FLAG_LSB 31 #define RX_MPDU_DESC_INFO_0_MORE_FRAGMENT_FLAG_MASK 0x80000000 /* Description RX_MPDU_DESC_INFO_1_PEER_META_DATA Meta data that SW has programmed in the Peer table entry of the transmitting STA. */ #define RX_MPDU_DESC_INFO_1_PEER_META_DATA_OFFSET 0x00000004 #define RX_MPDU_DESC_INFO_1_PEER_META_DATA_LSB 0 #define RX_MPDU_DESC_INFO_1_PEER_META_DATA_MASK 0xffffffff #endif // _RX_MPDU_DESC_INFO_H_