/* * Copyright (c) 2016-2017 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. */ // $ATH_LICENSE_HW_HDR_C$ // // DO NOT EDIT! This file is automatically generated // These definitions are tied to a particular hardware layout #ifndef _RX_MSDU_START_H_ #define _RX_MSDU_START_H_ #if !defined(__ASSEMBLER__) #endif // ################ START SUMMARY ################# // // Dword Fields // 0 rxpcu_mpdu_filter_in_category[1:0], sw_frame_group_id[8:2], reserved_0[15:9], phy_ppdu_id[31:16] // 1 msdu_length[13:0], reserved_1a[14], ipsec_esp[15], l3_offset[22:16], ipsec_ah[23], l4_offset[31:24] // 2 msdu_number[7:0], decap_format[9:8], ipv4_proto[10], ipv6_proto[11], tcp_proto[12], udp_proto[13], ip_frag[14], tcp_only_ack[15], da_is_bcast_mcast[16], toeplitz_hash[17], reserved_2a[23:18], ip4_protocol_ip6_next_header[31:24] // 3 toeplitz_hash_2_or_4[31:0] // 4 flow_id_toeplitz[31:0] // 5 user_rssi[7:0], pkt_type[11:8], stbc[12], sgi[14:13], rate_mcs[18:15], receive_bandwidth[20:19], reception_type[22:21], nss[25:23], reserved_5[31:26] // 6 ppdu_start_timestamp[31:0] // 7 sw_phy_meta_data[31:0] // // ################ END SUMMARY ################# #define NUM_OF_DWORDS_RX_MSDU_START 8 struct rx_msdu_start { uint32_t rxpcu_mpdu_filter_in_category : 2, //[1:0] sw_frame_group_id : 7, //[8:2] reserved_0 : 7, //[15:9] phy_ppdu_id : 16; //[31:16] uint32_t msdu_length : 14, //[13:0] reserved_1a : 1, //[14] ipsec_esp : 1, //[15] l3_offset : 7, //[22:16] ipsec_ah : 1, //[23] l4_offset : 8; //[31:24] uint32_t msdu_number : 8, //[7:0] decap_format : 2, //[9:8] ipv4_proto : 1, //[10] ipv6_proto : 1, //[11] tcp_proto : 1, //[12] udp_proto : 1, //[13] ip_frag : 1, //[14] tcp_only_ack : 1, //[15] da_is_bcast_mcast : 1, //[16] toeplitz_hash : 1, //[17] reserved_2a : 6, //[23:18] ip4_protocol_ip6_next_header : 8; //[31:24] uint32_t toeplitz_hash_2_or_4 : 32; //[31:0] uint32_t flow_id_toeplitz : 32; //[31:0] uint32_t user_rssi : 8, //[7:0] pkt_type : 4, //[11:8] stbc : 1, //[12] sgi : 2, //[14:13] rate_mcs : 4, //[18:15] receive_bandwidth : 2, //[20:19] reception_type : 2, //[22:21] nss : 3, //[25:23] reserved_5 : 6; //[31:26] uint32_t ppdu_start_timestamp : 32; //[31:0] uint32_t sw_phy_meta_data : 32; //[31:0] }; /* rxpcu_mpdu_filter_in_category Field indicates what the reason was that this MPDU frame was allowed to come into the receive path by RXPCU This MPDU passed the normal frame filter programming of rxpcu This MPDU did NOT pass the regular frame filter and would have been dropped, were it not for the frame fitting into the 'monitor_client' category. This MPDU did NOT pass the regular frame filter and also did not pass the rxpcu_monitor_client filter. It would have been dropped accept that it did pass the 'monitor_other' category. sw_frame_group_id SW processes frames based on certain classifications. This field indicates to what sw classification this MPDU is mapped. The classification is given in priority order This includes mpdus of type Data Null as well as QoS Data Null This covers type 3 and protocol version != 0 reserved_0 phy_ppdu_id A ppdu counter value that PHY increments for every PPDU received. The counter value wraps around msdu_length MSDU length in bytes after decapsulation. This field is still valid for MPDU frames without reserved_1a ipsec_esp Set if IPv4/v6 packet is using IPsec ESP l3_offset Depending upon mode bit, this field either indicates the L3 offset in bytes from the start of the RX_HEADER or the IP offset in bytes from the start of the packet after decapsulation.  The latter is only valid if ipv4_proto or ipv6_proto is set. ipsec_ah Set if IPv4/v6 packet is using IPsec AH l4_offset Depending upon mode bit, this field either indicates the L4 offset nin bytes from the start of RX_HEADER(only valid if either ipv4_proto or ipv6_proto is set to 1) or indicates the offset in bytes to the start of TCP or UDP header from the start of the IP header after decapsulation(Only valid if tcp_proto or udp_proto is set).  The value 0 indicates that the offset is longer than 127 bytes. msdu_number Indicates the MSDU number within a MPDU. This value is reset to zero at the start of each MPDU. If the number of MSDU exceeds 255 this number will wrap using modulo 256. decap_format Indicates the format after decapsulation: No encapsulation Ethernet 2 (DIX) or 802.3 (uses SNAP/LLC) DO NOT USE. Indicate Ethernet ipv4_proto Set if L2 layer indicates IPv4 protocol. ipv6_proto Set if L2 layer indicates IPv6 protocol. tcp_proto Set if the ipv4_proto or ipv6_proto are set and the IP protocol indicates TCP. udp_proto Set if the ipv4_proto or ipv6_proto are set and the IP protocol indicates UDP. ip_frag Indicates that either the IP More frag bit is set or IP frag number is non-zero. If set indicates that this is a fragmented IP packet. tcp_only_ack Set if only the TCP Ack bit is set in the TCP flags and if the TCP payload is 0. da_is_bcast_mcast The destination address is broadcast or multicast. toeplitz_hash Actual choosen Hash. 0 -> Toeplitz hash of 2-tuple (IP source address, IP destination address)1 -> Toeplitz hash of 4-tuple (IP source address, IP destination address, L4 (TCP/UDP) source port, L4 (TCP/UDP) destination port) reserved_2a ip4_protocol_ip6_next_header For IPv4 this is the 8 bit protocol field (when ipv4_proto is set). For IPv6 this is the 8 bit next_header field (when ipv6_proto is set). toeplitz_hash_2_or_4 Controlled by RxOLE register - If register bit set to 0, Toeplitz hash is computed over 2-tuple IPv4 or IPv6 src/dest addresses; otherwise, toeplitz hash is computed over 4-tuple IPv4 or IPv6 src/dest addresses and src/dest ports flow_id_toeplitz Toeplitz hash of 5-tuple {IP source address, IP destination address, IP source port, IP destination port, L4 protocol} in case of non-IPSec. In case of IPSec - Toeplitz hash of 4-tuple {IP source address, IP destination address, SPI, L4 protocol} The relevant Toeplitz key registers are provided in RxOLE's instance of common parser module. These registers are separate from the Toeplitz keys used by ASE/FSE modules inside RxOLE.The actual value will be passed on from common parser module to RxOLE in one of the WHO_* TLVs. user_rssi RSSI for this user pkt_type Packet type: 802.11a PPDU type 802.11b PPDU type 802.11n Mixed Mode PPDU type 802.11ac PPDU type 802.11ax PPDU type stbc When set, use STBC transmission rates sgi Field only valid when pkt type is HT, VHT or HE. Legacy normal GI. Can also be used for HE Legacy short GI. Can also be used for HE HE related GI HE related GI rate_mcs For details, refer to MCS_TYPE description receive_bandwidth Full receive Bandwidth reception_type Indicates what type of reception this is. nss Field only valid when Reception_type = reception_type_MU_MIMO or reception_type_MU_OFDMA_MIMO Number of Spatial Streams occupied by the User Single spatial stream 2 spatial streams 3 spatial streams 4 spatial streams 5 spatial streams 6 spatial streams 7 spatial streams 8 spatial streams reserved_5 ppdu_start_timestamp Timestamp that indicates when the PPDU that contained this MPDU started on the medium. sw_phy_meta_data SW programmed Meta data provided by the PHY. Can be used for SW to indicate the channel the device is on. */ /* Description RX_MSDU_START_0_RXPCU_MPDU_FILTER_IN_CATEGORY Field indicates what the reason was that this MPDU frame was allowed to come into the receive path by RXPCU This MPDU passed the normal frame filter programming of rxpcu This MPDU did NOT pass the regular frame filter and would have been dropped, were it not for the frame fitting into the 'monitor_client' category. This MPDU did NOT pass the regular frame filter and also did not pass the rxpcu_monitor_client filter. It would have been dropped accept that it did pass the 'monitor_other' category. */ #define RX_MSDU_START_0_RXPCU_MPDU_FILTER_IN_CATEGORY_OFFSET 0x00000000 #define RX_MSDU_START_0_RXPCU_MPDU_FILTER_IN_CATEGORY_LSB 0 #define RX_MSDU_START_0_RXPCU_MPDU_FILTER_IN_CATEGORY_MASK 0x00000003 /* Description RX_MSDU_START_0_SW_FRAME_GROUP_ID SW processes frames based on certain classifications. This field indicates to what sw classification this MPDU is mapped. The classification is given in priority order This includes mpdus of type Data Null as well as QoS Data Null This covers type 3 and protocol version != 0 */ #define RX_MSDU_START_0_SW_FRAME_GROUP_ID_OFFSET 0x00000000 #define RX_MSDU_START_0_SW_FRAME_GROUP_ID_LSB 2 #define RX_MSDU_START_0_SW_FRAME_GROUP_ID_MASK 0x000001fc /* Description RX_MSDU_START_0_RESERVED_0 */ #define RX_MSDU_START_0_RESERVED_0_OFFSET 0x00000000 #define RX_MSDU_START_0_RESERVED_0_LSB 9 #define RX_MSDU_START_0_RESERVED_0_MASK 0x0000fe00 /* Description RX_MSDU_START_0_PHY_PPDU_ID A ppdu counter value that PHY increments for every PPDU received. The counter value wraps around */ #define RX_MSDU_START_0_PHY_PPDU_ID_OFFSET 0x00000000 #define RX_MSDU_START_0_PHY_PPDU_ID_LSB 16 #define RX_MSDU_START_0_PHY_PPDU_ID_MASK 0xffff0000 /* Description RX_MSDU_START_1_MSDU_LENGTH MSDU length in bytes after decapsulation. This field is still valid for MPDU frames without */ #define RX_MSDU_START_1_MSDU_LENGTH_OFFSET 0x00000004 #define RX_MSDU_START_1_MSDU_LENGTH_LSB 0 #define RX_MSDU_START_1_MSDU_LENGTH_MASK 0x00003fff /* Description RX_MSDU_START_1_RESERVED_1A */ #define RX_MSDU_START_1_RESERVED_1A_OFFSET 0x00000004 #define RX_MSDU_START_1_RESERVED_1A_LSB 14 #define RX_MSDU_START_1_RESERVED_1A_MASK 0x00004000 /* Description RX_MSDU_START_1_IPSEC_ESP Set if IPv4/v6 packet is using IPsec ESP */ #define RX_MSDU_START_1_IPSEC_ESP_OFFSET 0x00000004 #define RX_MSDU_START_1_IPSEC_ESP_LSB 15 #define RX_MSDU_START_1_IPSEC_ESP_MASK 0x00008000 /* Description RX_MSDU_START_1_L3_OFFSET Depending upon mode bit, this field either indicates the L3 offset in bytes from the start of the RX_HEADER or the IP offset in bytes from the start of the packet after decapsulation.  The latter is only valid if ipv4_proto or ipv6_proto is set. */ #define RX_MSDU_START_1_L3_OFFSET_OFFSET 0x00000004 #define RX_MSDU_START_1_L3_OFFSET_LSB 16 #define RX_MSDU_START_1_L3_OFFSET_MASK 0x007f0000 /* Description RX_MSDU_START_1_IPSEC_AH Set if IPv4/v6 packet is using IPsec AH */ #define RX_MSDU_START_1_IPSEC_AH_OFFSET 0x00000004 #define RX_MSDU_START_1_IPSEC_AH_LSB 23 #define RX_MSDU_START_1_IPSEC_AH_MASK 0x00800000 /* Description RX_MSDU_START_1_L4_OFFSET Depending upon mode bit, this field either indicates the L4 offset nin bytes from the start of RX_HEADER(only valid if either ipv4_proto or ipv6_proto is set to 1) or indicates the offset in bytes to the start of TCP or UDP header from the start of the IP header after decapsulation(Only valid if tcp_proto or udp_proto is set).  The value 0 indicates that the offset is longer than 127 bytes. */ #define RX_MSDU_START_1_L4_OFFSET_OFFSET 0x00000004 #define RX_MSDU_START_1_L4_OFFSET_LSB 24 #define RX_MSDU_START_1_L4_OFFSET_MASK 0xff000000 /* Description RX_MSDU_START_2_MSDU_NUMBER Indicates the MSDU number within a MPDU. This value is reset to zero at the start of each MPDU. If the number of MSDU exceeds 255 this number will wrap using modulo 256. */ #define RX_MSDU_START_2_MSDU_NUMBER_OFFSET 0x00000008 #define RX_MSDU_START_2_MSDU_NUMBER_LSB 0 #define RX_MSDU_START_2_MSDU_NUMBER_MASK 0x000000ff /* Description RX_MSDU_START_2_DECAP_FORMAT Indicates the format after decapsulation: No encapsulation Ethernet 2 (DIX) or 802.3 (uses SNAP/LLC) DO NOT USE. Indicate Ethernet */ #define RX_MSDU_START_2_DECAP_FORMAT_OFFSET 0x00000008 #define RX_MSDU_START_2_DECAP_FORMAT_LSB 8 #define RX_MSDU_START_2_DECAP_FORMAT_MASK 0x00000300 /* Description RX_MSDU_START_2_IPV4_PROTO Set if L2 layer indicates IPv4 protocol. */ #define RX_MSDU_START_2_IPV4_PROTO_OFFSET 0x00000008 #define RX_MSDU_START_2_IPV4_PROTO_LSB 10 #define RX_MSDU_START_2_IPV4_PROTO_MASK 0x00000400 /* Description RX_MSDU_START_2_IPV6_PROTO Set if L2 layer indicates IPv6 protocol. */ #define RX_MSDU_START_2_IPV6_PROTO_OFFSET 0x00000008 #define RX_MSDU_START_2_IPV6_PROTO_LSB 11 #define RX_MSDU_START_2_IPV6_PROTO_MASK 0x00000800 /* Description RX_MSDU_START_2_TCP_PROTO Set if the ipv4_proto or ipv6_proto are set and the IP protocol indicates TCP. */ #define RX_MSDU_START_2_TCP_PROTO_OFFSET 0x00000008 #define RX_MSDU_START_2_TCP_PROTO_LSB 12 #define RX_MSDU_START_2_TCP_PROTO_MASK 0x00001000 /* Description RX_MSDU_START_2_UDP_PROTO Set if the ipv4_proto or ipv6_proto are set and the IP protocol indicates UDP. */ #define RX_MSDU_START_2_UDP_PROTO_OFFSET 0x00000008 #define RX_MSDU_START_2_UDP_PROTO_LSB 13 #define RX_MSDU_START_2_UDP_PROTO_MASK 0x00002000 /* Description RX_MSDU_START_2_IP_FRAG Indicates that either the IP More frag bit is set or IP frag number is non-zero. If set indicates that this is a fragmented IP packet. */ #define RX_MSDU_START_2_IP_FRAG_OFFSET 0x00000008 #define RX_MSDU_START_2_IP_FRAG_LSB 14 #define RX_MSDU_START_2_IP_FRAG_MASK 0x00004000 /* Description RX_MSDU_START_2_TCP_ONLY_ACK Set if only the TCP Ack bit is set in the TCP flags and if the TCP payload is 0. */ #define RX_MSDU_START_2_TCP_ONLY_ACK_OFFSET 0x00000008 #define RX_MSDU_START_2_TCP_ONLY_ACK_LSB 15 #define RX_MSDU_START_2_TCP_ONLY_ACK_MASK 0x00008000 /* Description RX_MSDU_START_2_DA_IS_BCAST_MCAST The destination address is broadcast or multicast. */ #define RX_MSDU_START_2_DA_IS_BCAST_MCAST_OFFSET 0x00000008 #define RX_MSDU_START_2_DA_IS_BCAST_MCAST_LSB 16 #define RX_MSDU_START_2_DA_IS_BCAST_MCAST_MASK 0x00010000 /* Description RX_MSDU_START_2_TOEPLITZ_HASH Actual choosen Hash. 0 -> Toeplitz hash of 2-tuple (IP source address, IP destination address)1 -> Toeplitz hash of 4-tuple (IP source address, IP destination address, L4 (TCP/UDP) source port, L4 (TCP/UDP) destination port) */ #define RX_MSDU_START_2_TOEPLITZ_HASH_OFFSET 0x00000008 #define RX_MSDU_START_2_TOEPLITZ_HASH_LSB 17 #define RX_MSDU_START_2_TOEPLITZ_HASH_MASK 0x00020000 /* Description RX_MSDU_START_2_RESERVED_2A */ #define RX_MSDU_START_2_RESERVED_2A_OFFSET 0x00000008 #define RX_MSDU_START_2_RESERVED_2A_LSB 18 #define RX_MSDU_START_2_RESERVED_2A_MASK 0x00fc0000 /* Description RX_MSDU_START_2_IP4_PROTOCOL_IP6_NEXT_HEADER For IPv4 this is the 8 bit protocol field (when ipv4_proto is set). For IPv6 this is the 8 bit next_header field (when ipv6_proto is set). */ #define RX_MSDU_START_2_IP4_PROTOCOL_IP6_NEXT_HEADER_OFFSET 0x00000008 #define RX_MSDU_START_2_IP4_PROTOCOL_IP6_NEXT_HEADER_LSB 24 #define RX_MSDU_START_2_IP4_PROTOCOL_IP6_NEXT_HEADER_MASK 0xff000000 /* Description RX_MSDU_START_3_TOEPLITZ_HASH_2_OR_4 Controlled by RxOLE register - If register bit set to 0, Toeplitz hash is computed over 2-tuple IPv4 or IPv6 src/dest addresses; otherwise, toeplitz hash is computed over 4-tuple IPv4 or IPv6 src/dest addresses and src/dest ports */ #define RX_MSDU_START_3_TOEPLITZ_HASH_2_OR_4_OFFSET 0x0000000c #define RX_MSDU_START_3_TOEPLITZ_HASH_2_OR_4_LSB 0 #define RX_MSDU_START_3_TOEPLITZ_HASH_2_OR_4_MASK 0xffffffff /* Description RX_MSDU_START_4_FLOW_ID_TOEPLITZ Toeplitz hash of 5-tuple {IP source address, IP destination address, IP source port, IP destination port, L4 protocol} in case of non-IPSec. In case of IPSec - Toeplitz hash of 4-tuple {IP source address, IP destination address, SPI, L4 protocol} The relevant Toeplitz key registers are provided in RxOLE's instance of common parser module. These registers are separate from the Toeplitz keys used by ASE/FSE modules inside RxOLE.The actual value will be passed on from common parser module to RxOLE in one of the WHO_* TLVs. */ #define RX_MSDU_START_4_FLOW_ID_TOEPLITZ_OFFSET 0x00000010 #define RX_MSDU_START_4_FLOW_ID_TOEPLITZ_LSB 0 #define RX_MSDU_START_4_FLOW_ID_TOEPLITZ_MASK 0xffffffff /* Description RX_MSDU_START_5_USER_RSSI RSSI for this user */ #define RX_MSDU_START_5_USER_RSSI_OFFSET 0x00000014 #define RX_MSDU_START_5_USER_RSSI_LSB 0 #define RX_MSDU_START_5_USER_RSSI_MASK 0x000000ff /* Description RX_MSDU_START_5_PKT_TYPE Packet type: 802.11a PPDU type 802.11b PPDU type 802.11n Mixed Mode PPDU type 802.11ac PPDU type 802.11ax PPDU type */ #define RX_MSDU_START_5_PKT_TYPE_OFFSET 0x00000014 #define RX_MSDU_START_5_PKT_TYPE_LSB 8 #define RX_MSDU_START_5_PKT_TYPE_MASK 0x00000f00 /* Description RX_MSDU_START_5_STBC When set, use STBC transmission rates */ #define RX_MSDU_START_5_STBC_OFFSET 0x00000014 #define RX_MSDU_START_5_STBC_LSB 12 #define RX_MSDU_START_5_STBC_MASK 0x00001000 /* Description RX_MSDU_START_5_SGI Field only valid when pkt type is HT, VHT or HE. Legacy normal GI. Can also be used for HE Legacy short GI. Can also be used for HE HE related GI HE related GI */ #define RX_MSDU_START_5_SGI_OFFSET 0x00000014 #define RX_MSDU_START_5_SGI_LSB 13 #define RX_MSDU_START_5_SGI_MASK 0x00006000 /* Description RX_MSDU_START_5_RATE_MCS For details, refer to MCS_TYPE description */ #define RX_MSDU_START_5_RATE_MCS_OFFSET 0x00000014 #define RX_MSDU_START_5_RATE_MCS_LSB 15 #define RX_MSDU_START_5_RATE_MCS_MASK 0x00078000 /* Description RX_MSDU_START_5_RECEIVE_BANDWIDTH Full receive Bandwidth */ #define RX_MSDU_START_5_RECEIVE_BANDWIDTH_OFFSET 0x00000014 #define RX_MSDU_START_5_RECEIVE_BANDWIDTH_LSB 19 #define RX_MSDU_START_5_RECEIVE_BANDWIDTH_MASK 0x00180000 /* Description RX_MSDU_START_5_RECEPTION_TYPE Indicates what type of reception this is. */ #define RX_MSDU_START_5_RECEPTION_TYPE_OFFSET 0x00000014 #define RX_MSDU_START_5_RECEPTION_TYPE_LSB 21 #define RX_MSDU_START_5_RECEPTION_TYPE_MASK 0x00600000 /* Description RX_MSDU_START_5_NSS Field only valid when Reception_type = reception_type_MU_MIMO or reception_type_MU_OFDMA_MIMO Number of Spatial Streams occupied by the User Single spatial stream 2 spatial streams 3 spatial streams 4 spatial streams 5 spatial streams 6 spatial streams 7 spatial streams 8 spatial streams */ #define RX_MSDU_START_5_NSS_OFFSET 0x00000014 #define RX_MSDU_START_5_NSS_LSB 23 #define RX_MSDU_START_5_NSS_MASK 0x03800000 /* Description RX_MSDU_START_5_RESERVED_5 */ #define RX_MSDU_START_5_RESERVED_5_OFFSET 0x00000014 #define RX_MSDU_START_5_RESERVED_5_LSB 26 #define RX_MSDU_START_5_RESERVED_5_MASK 0xfc000000 /* Description RX_MSDU_START_6_PPDU_START_TIMESTAMP Timestamp that indicates when the PPDU that contained this MPDU started on the medium. */ #define RX_MSDU_START_6_PPDU_START_TIMESTAMP_OFFSET 0x00000018 #define RX_MSDU_START_6_PPDU_START_TIMESTAMP_LSB 0 #define RX_MSDU_START_6_PPDU_START_TIMESTAMP_MASK 0xffffffff /* Description RX_MSDU_START_7_SW_PHY_META_DATA SW programmed Meta data provided by the PHY. Can be used for SW to indicate the channel the device is on. */ #define RX_MSDU_START_7_SW_PHY_META_DATA_OFFSET 0x0000001c #define RX_MSDU_START_7_SW_PHY_META_DATA_LSB 0 #define RX_MSDU_START_7_SW_PHY_META_DATA_MASK 0xffffffff #endif // _RX_MSDU_START_H_