1*5113495bSYour Name /* 2*5113495bSYour Name * Copyright (c) 2023 Qualcomm Innovation Center, Inc. All rights reserved. 3*5113495bSYour Name * 4*5113495bSYour Name * Permission to use, copy, modify, and/or distribute this software for any 5*5113495bSYour Name * purpose with or without fee is hereby granted, provided that the above 6*5113495bSYour Name * copyright notice and this permission notice appear in all copies. 7*5113495bSYour Name * 8*5113495bSYour Name * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 9*5113495bSYour Name * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 10*5113495bSYour Name * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 11*5113495bSYour Name * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 12*5113495bSYour Name * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 13*5113495bSYour Name * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 14*5113495bSYour Name * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 15*5113495bSYour Name */ 16*5113495bSYour Name 17*5113495bSYour Name #ifndef _WBM_RELEASE_RING_TX_H_ 18*5113495bSYour Name #define _WBM_RELEASE_RING_TX_H_ 19*5113495bSYour Name #if !defined(__ASSEMBLER__) 20*5113495bSYour Name #endif 21*5113495bSYour Name 22*5113495bSYour Name #include "tx_rate_stats_info.h" 23*5113495bSYour Name #include "buffer_addr_info.h" 24*5113495bSYour Name #define NUM_OF_DWORDS_WBM_RELEASE_RING_TX 8 25*5113495bSYour Name 26*5113495bSYour Name 27*5113495bSYour Name struct wbm_release_ring_tx { 28*5113495bSYour Name #ifndef WIFI_BIT_ORDER_BIG_ENDIAN 29*5113495bSYour Name struct buffer_addr_info released_buff_or_desc_addr_info; 30*5113495bSYour Name uint32_t release_source_module : 3, // [2:0] 31*5113495bSYour Name bm_action : 3, // [5:3] 32*5113495bSYour Name buffer_or_desc_type : 3, // [8:6] 33*5113495bSYour Name first_msdu_index : 4, // [12:9] 34*5113495bSYour Name tqm_release_reason : 4, // [16:13] 35*5113495bSYour Name rbm_override_valid : 1, // [17:17] 36*5113495bSYour Name rbm_override : 4, // [21:18] 37*5113495bSYour Name reserved_2a : 7, // [28:22] 38*5113495bSYour Name cache_id : 1, // [29:29] 39*5113495bSYour Name cookie_conversion_status : 1, // [30:30] 40*5113495bSYour Name wbm_internal_error : 1; // [31:31] 41*5113495bSYour Name uint32_t tqm_status_number : 24, // [23:0] 42*5113495bSYour Name transmit_count : 7, // [30:24] 43*5113495bSYour Name sw_release_details_valid : 1; // [31:31] 44*5113495bSYour Name uint32_t ack_frame_rssi : 8, // [7:0] 45*5113495bSYour Name first_msdu : 1, // [8:8] 46*5113495bSYour Name last_msdu : 1, // [9:9] 47*5113495bSYour Name fw_tx_notify_frame : 3, // [12:10] 48*5113495bSYour Name buffer_timestamp : 19; // [31:13] 49*5113495bSYour Name struct tx_rate_stats_info tx_rate_stats; 50*5113495bSYour Name uint32_t sw_peer_id : 16, // [15:0] 51*5113495bSYour Name tid : 4, // [19:16] 52*5113495bSYour Name tqm_status_number_31_24 : 8, // [27:20] 53*5113495bSYour Name looping_count : 4; // [31:28] 54*5113495bSYour Name #else 55*5113495bSYour Name struct buffer_addr_info released_buff_or_desc_addr_info; 56*5113495bSYour Name uint32_t wbm_internal_error : 1, // [31:31] 57*5113495bSYour Name cookie_conversion_status : 1, // [30:30] 58*5113495bSYour Name cache_id : 1, // [29:29] 59*5113495bSYour Name reserved_2a : 7, // [28:22] 60*5113495bSYour Name rbm_override : 4, // [21:18] 61*5113495bSYour Name rbm_override_valid : 1, // [17:17] 62*5113495bSYour Name tqm_release_reason : 4, // [16:13] 63*5113495bSYour Name first_msdu_index : 4, // [12:9] 64*5113495bSYour Name buffer_or_desc_type : 3, // [8:6] 65*5113495bSYour Name bm_action : 3, // [5:3] 66*5113495bSYour Name release_source_module : 3; // [2:0] 67*5113495bSYour Name uint32_t sw_release_details_valid : 1, // [31:31] 68*5113495bSYour Name transmit_count : 7, // [30:24] 69*5113495bSYour Name tqm_status_number : 24; // [23:0] 70*5113495bSYour Name uint32_t buffer_timestamp : 19, // [31:13] 71*5113495bSYour Name fw_tx_notify_frame : 3, // [12:10] 72*5113495bSYour Name last_msdu : 1, // [9:9] 73*5113495bSYour Name first_msdu : 1, // [8:8] 74*5113495bSYour Name ack_frame_rssi : 8; // [7:0] 75*5113495bSYour Name struct tx_rate_stats_info tx_rate_stats; 76*5113495bSYour Name uint32_t looping_count : 4, // [31:28] 77*5113495bSYour Name tqm_status_number_31_24 : 8, // [27:20] 78*5113495bSYour Name tid : 4, // [19:16] 79*5113495bSYour Name sw_peer_id : 16; // [15:0] 80*5113495bSYour Name #endif 81*5113495bSYour Name }; 82*5113495bSYour Name 83*5113495bSYour Name 84*5113495bSYour Name /* Description RELEASED_BUFF_OR_DESC_ADDR_INFO 85*5113495bSYour Name 86*5113495bSYour Name Consumer: WBM/SW/FW 87*5113495bSYour Name Producer: SW/TQM/RXDMA/REO/SWITCH 88*5113495bSYour Name 89*5113495bSYour Name Details of the physical address of the buffer or link descriptor 90*5113495bSYour Name that is being released. Note that within this descriptor, 91*5113495bSYour Name WBM will look at the 'owner' of the released buffer/descriptor 92*5113495bSYour Name and forward it to SW/FW is WBM is not the owner. 93*5113495bSYour Name */ 94*5113495bSYour Name 95*5113495bSYour Name 96*5113495bSYour Name /* Description BUFFER_ADDR_31_0 97*5113495bSYour Name 98*5113495bSYour Name Address (lower 32 bits) of the MSDU buffer OR MSDU_EXTENSION 99*5113495bSYour Name descriptor OR Link Descriptor 100*5113495bSYour Name 101*5113495bSYour Name In case of 'NULL' pointer, this field is set to 0 102*5113495bSYour Name <legal all> 103*5113495bSYour Name */ 104*5113495bSYour Name 105*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASED_BUFF_OR_DESC_ADDR_INFO_BUFFER_ADDR_31_0_OFFSET 0x00000000 106*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASED_BUFF_OR_DESC_ADDR_INFO_BUFFER_ADDR_31_0_LSB 0 107*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASED_BUFF_OR_DESC_ADDR_INFO_BUFFER_ADDR_31_0_MSB 31 108*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASED_BUFF_OR_DESC_ADDR_INFO_BUFFER_ADDR_31_0_MASK 0xffffffff 109*5113495bSYour Name 110*5113495bSYour Name 111*5113495bSYour Name /* Description BUFFER_ADDR_39_32 112*5113495bSYour Name 113*5113495bSYour Name Address (upper 8 bits) of the MSDU buffer OR MSDU_EXTENSION 114*5113495bSYour Name descriptor OR Link Descriptor 115*5113495bSYour Name 116*5113495bSYour Name In case of 'NULL' pointer, this field is set to 0 117*5113495bSYour Name <legal all> 118*5113495bSYour Name */ 119*5113495bSYour Name 120*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASED_BUFF_OR_DESC_ADDR_INFO_BUFFER_ADDR_39_32_OFFSET 0x00000004 121*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASED_BUFF_OR_DESC_ADDR_INFO_BUFFER_ADDR_39_32_LSB 0 122*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASED_BUFF_OR_DESC_ADDR_INFO_BUFFER_ADDR_39_32_MSB 7 123*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASED_BUFF_OR_DESC_ADDR_INFO_BUFFER_ADDR_39_32_MASK 0x000000ff 124*5113495bSYour Name 125*5113495bSYour Name 126*5113495bSYour Name /* Description RETURN_BUFFER_MANAGER 127*5113495bSYour Name 128*5113495bSYour Name Consumer: WBM 129*5113495bSYour Name Producer: SW/FW 130*5113495bSYour Name 131*5113495bSYour Name In case of 'NULL' pointer, this field is set to 0 132*5113495bSYour Name 133*5113495bSYour Name Indicates to which buffer manager the buffer OR MSDU_EXTENSION 134*5113495bSYour Name descriptor OR link descriptor that is being pointed to 135*5113495bSYour Name shall be returned after the frame has been processed. It 136*5113495bSYour Name is used by WBM for routing purposes. 137*5113495bSYour Name 138*5113495bSYour Name <enum 0 WBM_IDLE_BUF_LIST> This buffer shall be returned 139*5113495bSYour Name to the WMB buffer idle list 140*5113495bSYour Name <enum 1 WBM_CHIP0_IDLE_DESC_LIST> This buffer shall be returned 141*5113495bSYour Name to the WBM idle link descriptor idle list, where the chip 142*5113495bSYour Name 0 WBM is chosen in case of a multi-chip config 143*5113495bSYour Name <enum 2 WBM_CHIP1_IDLE_DESC_LIST> This buffer shall be returned 144*5113495bSYour Name to the chip 1 WBM idle link descriptor idle list 145*5113495bSYour Name <enum 3 WBM_CHIP2_IDLE_DESC_LIST> This buffer shall be returned 146*5113495bSYour Name to the chip 2 WBM idle link descriptor idle list 147*5113495bSYour Name <enum 12 WBM_CHIP3_IDLE_DESC_LIST> This buffer shall be 148*5113495bSYour Name returned to chip 3 WBM idle link descriptor idle list 149*5113495bSYour Name <enum 4 FW_BM> This buffer shall be returned to the FW 150*5113495bSYour Name <enum 5 SW0_BM> This buffer shall be returned to the SW, 151*5113495bSYour Name ring 0 152*5113495bSYour Name <enum 6 SW1_BM> This buffer shall be returned to the SW, 153*5113495bSYour Name ring 1 154*5113495bSYour Name <enum 7 SW2_BM> This buffer shall be returned to the SW, 155*5113495bSYour Name ring 2 156*5113495bSYour Name <enum 8 SW3_BM> This buffer shall be returned to the SW, 157*5113495bSYour Name ring 3 158*5113495bSYour Name <enum 9 SW4_BM> This buffer shall be returned to the SW, 159*5113495bSYour Name ring 4 160*5113495bSYour Name <enum 10 SW5_BM> This buffer shall be returned to the SW, 161*5113495bSYour Name ring 5 162*5113495bSYour Name <enum 11 SW6_BM> This buffer shall be returned to the SW, 163*5113495bSYour Name ring 6 164*5113495bSYour Name 165*5113495bSYour Name <legal 0-12> 166*5113495bSYour Name */ 167*5113495bSYour Name 168*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASED_BUFF_OR_DESC_ADDR_INFO_RETURN_BUFFER_MANAGER_OFFSET 0x00000004 169*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASED_BUFF_OR_DESC_ADDR_INFO_RETURN_BUFFER_MANAGER_LSB 8 170*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASED_BUFF_OR_DESC_ADDR_INFO_RETURN_BUFFER_MANAGER_MSB 11 171*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASED_BUFF_OR_DESC_ADDR_INFO_RETURN_BUFFER_MANAGER_MASK 0x00000f00 172*5113495bSYour Name 173*5113495bSYour Name 174*5113495bSYour Name /* Description SW_BUFFER_COOKIE 175*5113495bSYour Name 176*5113495bSYour Name Cookie field exclusively used by SW. 177*5113495bSYour Name 178*5113495bSYour Name In case of 'NULL' pointer, this field is set to 0 179*5113495bSYour Name 180*5113495bSYour Name HW ignores the contents, accept that it passes the programmed 181*5113495bSYour Name value on to other descriptors together with the physical 182*5113495bSYour Name address 183*5113495bSYour Name 184*5113495bSYour Name Field can be used by SW to for example associate the buffers 185*5113495bSYour Name physical address with the virtual address 186*5113495bSYour Name The bit definitions as used by SW are within SW HLD specification 187*5113495bSYour Name 188*5113495bSYour Name 189*5113495bSYour Name NOTE1: 190*5113495bSYour Name The three most significant bits can have a special meaning 191*5113495bSYour Name in case this struct is embedded in a TX_MPDU_DETAILS STRUCT, 192*5113495bSYour Name and field transmit_bw_restriction is set 193*5113495bSYour Name 194*5113495bSYour Name In case of NON punctured transmission: 195*5113495bSYour Name Sw_buffer_cookie[19:17] = 3'b000: 20 MHz TX only 196*5113495bSYour Name Sw_buffer_cookie[19:17] = 3'b001: 40 MHz TX only 197*5113495bSYour Name Sw_buffer_cookie[19:17] = 3'b010: 80 MHz TX only 198*5113495bSYour Name Sw_buffer_cookie[19:17] = 3'b011: 160 MHz TX only 199*5113495bSYour Name Sw_buffer_cookie[19:17] = 3'b101: 240 MHz TX only 200*5113495bSYour Name Sw_buffer_cookie[19:17] = 3'b100: 320 MHz TX only 201*5113495bSYour Name Sw_buffer_cookie[19:18] = 2'b11: reserved 202*5113495bSYour Name 203*5113495bSYour Name In case of punctured transmission: 204*5113495bSYour Name Sw_buffer_cookie[19:16] = 4'b0000: pattern 0 only 205*5113495bSYour Name Sw_buffer_cookie[19:16] = 4'b0001: pattern 1 only 206*5113495bSYour Name Sw_buffer_cookie[19:16] = 4'b0010: pattern 2 only 207*5113495bSYour Name Sw_buffer_cookie[19:16] = 4'b0011: pattern 3 only 208*5113495bSYour Name Sw_buffer_cookie[19:16] = 4'b0100: pattern 4 only 209*5113495bSYour Name Sw_buffer_cookie[19:16] = 4'b0101: pattern 5 only 210*5113495bSYour Name Sw_buffer_cookie[19:16] = 4'b0110: pattern 6 only 211*5113495bSYour Name Sw_buffer_cookie[19:16] = 4'b0111: pattern 7 only 212*5113495bSYour Name Sw_buffer_cookie[19:16] = 4'b1000: pattern 8 only 213*5113495bSYour Name Sw_buffer_cookie[19:16] = 4'b1001: pattern 9 only 214*5113495bSYour Name Sw_buffer_cookie[19:16] = 4'b1010: pattern 10 only 215*5113495bSYour Name Sw_buffer_cookie[19:16] = 4'b1011: pattern 11 only 216*5113495bSYour Name Sw_buffer_cookie[19:18] = 2'b11: reserved 217*5113495bSYour Name 218*5113495bSYour Name Note: a punctured transmission is indicated by the presence 219*5113495bSYour Name of TLV TX_PUNCTURE_SETUP embedded in the scheduler TLV 220*5113495bSYour Name 221*5113495bSYour Name <legal all> 222*5113495bSYour Name */ 223*5113495bSYour Name 224*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASED_BUFF_OR_DESC_ADDR_INFO_SW_BUFFER_COOKIE_OFFSET 0x00000004 225*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASED_BUFF_OR_DESC_ADDR_INFO_SW_BUFFER_COOKIE_LSB 12 226*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASED_BUFF_OR_DESC_ADDR_INFO_SW_BUFFER_COOKIE_MSB 31 227*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASED_BUFF_OR_DESC_ADDR_INFO_SW_BUFFER_COOKIE_MASK 0xfffff000 228*5113495bSYour Name 229*5113495bSYour Name 230*5113495bSYour Name /* Description RELEASE_SOURCE_MODULE 231*5113495bSYour Name 232*5113495bSYour Name Indicates which module initiated the release of this buffer 233*5113495bSYour Name or descriptor 234*5113495bSYour Name 235*5113495bSYour Name <enum 1 release_source_RXDMA> DO NOT USE 236*5113495bSYour Name <enum 2 release_source_REO> DO NOT USE 237*5113495bSYour Name <enum 5 release_source_FW_RX> DO NOT USE 238*5113495bSYour Name <enum 4 release_source_SW_RX> DO NOT USE 239*5113495bSYour Name <enum 0 release_source_TQM> TQM released this buffer or 240*5113495bSYour Name descriptor 241*5113495bSYour Name <enum 3 release_source_FW_TX> FW released this buffer or 242*5113495bSYour Name descriptor 243*5113495bSYour Name <enum 6 release_source_SW_TX> SW released this buffer or 244*5113495bSYour Name descriptor 245*5113495bSYour Name <legal 0-6> 246*5113495bSYour Name */ 247*5113495bSYour Name 248*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASE_SOURCE_MODULE_OFFSET 0x00000008 249*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASE_SOURCE_MODULE_LSB 0 250*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASE_SOURCE_MODULE_MSB 2 251*5113495bSYour Name #define WBM_RELEASE_RING_TX_RELEASE_SOURCE_MODULE_MASK 0x00000007 252*5113495bSYour Name 253*5113495bSYour Name 254*5113495bSYour Name /* Description BM_ACTION 255*5113495bSYour Name 256*5113495bSYour Name Consumer: WBM/SW/FW 257*5113495bSYour Name Producer: SW/TQM/RXDMA/REO/SWITCH 258*5113495bSYour Name 259*5113495bSYour Name Field only valid when the field return_buffer_manager in 260*5113495bSYour Name the Released_buff_or_desc_addr_info indicates: 261*5113495bSYour Name WBM_IDLE_BUF_LIST or 262*5113495bSYour Name WBM_IDLE_DESC_LIST 263*5113495bSYour Name 264*5113495bSYour Name An MSDU extension descriptor shall never be marked as WBM 265*5113495bSYour Name being the 'owner', and thus WBM will forward it to FW/SW 266*5113495bSYour Name 267*5113495bSYour Name 268*5113495bSYour Name <enum 0 Put_in_idle_list> Put the buffer or descriptor back 269*5113495bSYour Name in the idle list. In case of MSDU or MDPU link descriptor, 270*5113495bSYour Name BM does not need to check to release any individual MSDU 271*5113495bSYour Name buffers 272*5113495bSYour Name 273*5113495bSYour Name <enum 1 release_msdu_list > This BM action can only be used 274*5113495bSYour Name in combination with buffer_or_desc_type being msdu_link_descriptor. 275*5113495bSYour Name Field first_msdu_index points out which MSDU pointer in 276*5113495bSYour Name the MSDU link descriptor is the first of an MPDU that is 277*5113495bSYour Name released. 278*5113495bSYour Name BM shall release all the MSDU buffers linked to this first 279*5113495bSYour Name MSDU buffer pointer. All related MSDU buffer pointer entries 280*5113495bSYour Name shall be set to value 0, which represents the 'NULL" pointer. 281*5113495bSYour Name When all MSDU buffer pointers in the MSDU link descriptor 282*5113495bSYour Name are 'NULL', the MSDU link descriptor itself shall also 283*5113495bSYour Name be released. 284*5113495bSYour Name 285*5113495bSYour Name <enum 2 Put_in_idle_list_expanded> CURRENTLY NOT IMPLEMENTED.... 286*5113495bSYour Name 287*5113495bSYour Name Put the buffer or descriptor back in the idle list. Only 288*5113495bSYour Name valid in combination with buffer_or_desc_type indicating 289*5113495bSYour Name MDPU_link_descriptor. 290*5113495bSYour Name BM shall release the MPDU link descriptor as well as all 291*5113495bSYour Name MSDUs that are linked to the MPDUs in this descriptor. 292*5113495bSYour Name 293*5113495bSYour Name 294*5113495bSYour Name <legal 0-2> 295*5113495bSYour Name */ 296*5113495bSYour Name 297*5113495bSYour Name #define WBM_RELEASE_RING_TX_BM_ACTION_OFFSET 0x00000008 298*5113495bSYour Name #define WBM_RELEASE_RING_TX_BM_ACTION_LSB 3 299*5113495bSYour Name #define WBM_RELEASE_RING_TX_BM_ACTION_MSB 5 300*5113495bSYour Name #define WBM_RELEASE_RING_TX_BM_ACTION_MASK 0x00000038 301*5113495bSYour Name 302*5113495bSYour Name 303*5113495bSYour Name /* Description BUFFER_OR_DESC_TYPE 304*5113495bSYour Name 305*5113495bSYour Name Consumer: WBM/SW/FW 306*5113495bSYour Name Producer: SW/TQM/RXDMA/REO/SWITCH 307*5113495bSYour Name 308*5113495bSYour Name Field only valid when WBM is marked as the return_buffer_manager 309*5113495bSYour Name in the Released_Buffer_address_info 310*5113495bSYour Name 311*5113495bSYour Name Indicates that type of buffer or descriptor is being released 312*5113495bSYour Name 313*5113495bSYour Name 314*5113495bSYour Name <enum 0 MSDU_rel_buffer> The address points to an MSDU buffer 315*5113495bSYour Name 316*5113495bSYour Name <enum 1 msdu_link_descriptor> The address points to an TX 317*5113495bSYour Name MSDU link descriptor 318*5113495bSYour Name <enum 2 mpdu_link_descriptor> The address points to an MPDU 319*5113495bSYour Name link descriptor 320*5113495bSYour Name <enum 3 msdu_ext_descriptor > The address points to an MSDU 321*5113495bSYour Name extension descriptor. 322*5113495bSYour Name In case BM finds this one in a release ring, it passes it 323*5113495bSYour Name on to FW... 324*5113495bSYour Name <enum 4 queue_ext_descriptor> The address points to an TQM 325*5113495bSYour Name queue extension descriptor. WBM should treat this is the 326*5113495bSYour Name same way as a link descriptor. That is, put the 128 byte 327*5113495bSYour Name buffer back in the link buffer idle list. 328*5113495bSYour Name 329*5113495bSYour Name <legal 0-4> 330*5113495bSYour Name */ 331*5113495bSYour Name 332*5113495bSYour Name #define WBM_RELEASE_RING_TX_BUFFER_OR_DESC_TYPE_OFFSET 0x00000008 333*5113495bSYour Name #define WBM_RELEASE_RING_TX_BUFFER_OR_DESC_TYPE_LSB 6 334*5113495bSYour Name #define WBM_RELEASE_RING_TX_BUFFER_OR_DESC_TYPE_MSB 8 335*5113495bSYour Name #define WBM_RELEASE_RING_TX_BUFFER_OR_DESC_TYPE_MASK 0x000001c0 336*5113495bSYour Name 337*5113495bSYour Name 338*5113495bSYour Name /* Description FIRST_MSDU_INDEX 339*5113495bSYour Name 340*5113495bSYour Name Consumer: WBM/SW/FW 341*5113495bSYour Name Producer: SW/TQM/RXDMA/REO/SWITCH 342*5113495bSYour Name 343*5113495bSYour Name Field only valid for the bm_action release_msdu_list. 344*5113495bSYour Name 345*5113495bSYour Name The index of the first MSDU in an MSDU link descriptor all 346*5113495bSYour Name belonging to the same MPDU. 347*5113495bSYour Name 348*5113495bSYour Name <legal 0-6> 349*5113495bSYour Name */ 350*5113495bSYour Name 351*5113495bSYour Name #define WBM_RELEASE_RING_TX_FIRST_MSDU_INDEX_OFFSET 0x00000008 352*5113495bSYour Name #define WBM_RELEASE_RING_TX_FIRST_MSDU_INDEX_LSB 9 353*5113495bSYour Name #define WBM_RELEASE_RING_TX_FIRST_MSDU_INDEX_MSB 12 354*5113495bSYour Name #define WBM_RELEASE_RING_TX_FIRST_MSDU_INDEX_MASK 0x00001e00 355*5113495bSYour Name 356*5113495bSYour Name 357*5113495bSYour Name /* Description TQM_RELEASE_REASON 358*5113495bSYour Name 359*5113495bSYour Name Consumer: WBM/SW/FW 360*5113495bSYour Name Producer: TQM 361*5113495bSYour Name 362*5113495bSYour Name Field only valid when Release_source_module is set to release_source_TQM 363*5113495bSYour Name 364*5113495bSYour Name 365*5113495bSYour Name (rr = Release Reason) 366*5113495bSYour Name <enum 0 tqm_rr_frame_acked> frame is removed because an 367*5113495bSYour Name ACK of BA for it was received 368*5113495bSYour Name <enum 1 tqm_rr_rem_cmd_rem> frame is removed because a remove 369*5113495bSYour Name command of type "Remove_mpdus" initiated by SW 370*5113495bSYour Name <enum 2 tqm_rr_rem_cmd_tx> frame is removed because a remove 371*5113495bSYour Name command of type "Remove_transmitted_mpdus" initiated by 372*5113495bSYour Name SW 373*5113495bSYour Name <enum 3 tqm_rr_rem_cmd_notx> frame is removed because a 374*5113495bSYour Name remove command of type "Remove_untransmitted_mpdus" initiated 375*5113495bSYour Name by SW 376*5113495bSYour Name <enum 4 tqm_rr_rem_cmd_aged> frame is removed because a 377*5113495bSYour Name remove command of type "Remove_aged_mpdus" or "Remove_aged_msdus" 378*5113495bSYour Name initiated by SW 379*5113495bSYour Name <enum 5 tqm_fw_reason1> frame is removed because a remove 380*5113495bSYour Name command where fw indicated that remove reason is fw_reason1 381*5113495bSYour Name 382*5113495bSYour Name <enum 6 tqm_fw_reason2> frame is removed because a remove 383*5113495bSYour Name command where fw indicated that remove reason is fw_reason1 384*5113495bSYour Name 385*5113495bSYour Name <enum 7 tqm_fw_reason3> frame is removed because a remove 386*5113495bSYour Name command where fw indicated that remove reason is fw_reason1 387*5113495bSYour Name 388*5113495bSYour Name <enum 8 tqm_rr_rem_cmd_disable_queue> frame is removed because 389*5113495bSYour Name a remove command of type "remove_mpdus_and_disable_queue" 390*5113495bSYour Name or "remove_msdus_and_disable_flow" initiated by SW 391*5113495bSYour Name <enum 9 tqm_rr_rem_cmd_till_nonmatching> frame is removed 392*5113495bSYour Name because remove command of type "remove_till_nonmatching_mpdu" 393*5113495bSYour Name initiated by SW 394*5113495bSYour Name <enum 10 tqm_rr_drop_threshold> frame is dropped at TQM 395*5113495bSYour Name entrance due to one of slow/medium/hard drop threshold criteria 396*5113495bSYour Name 397*5113495bSYour Name <enum 11 tqm_rr_link_desc_unavailable> frame is dropped 398*5113495bSYour Name at TQM entrance due to the WBM2TQM_LINK_RING having fewer 399*5113495bSYour Name descriptors than a threshold programmed in TQM 400*5113495bSYour Name <enum 12 tqm_rr_drop_or_invalid_msdu> frame is dropped at 401*5113495bSYour Name TQM entrance due to 'TQM_Drop_frame' being set or "null" 402*5113495bSYour Name MSDU flow pointer or MSDU flow pointer 'Flow_valid' being 403*5113495bSYour Name zero or MSDU length being zero 404*5113495bSYour Name <enum 13 tqm_rr_multicast_drop> frame is dropped at TQM 405*5113495bSYour Name entrance due to 'TQM_Drop_frame' being set with 'TCL_drop_reason' 406*5113495bSYour Name set to TCL_multicast_drop_for_vdev. 407*5113495bSYour Name <enum 14 tqm_rr_vdev_mismatch_drop> frame is dropped at 408*5113495bSYour Name TQM entrance due to 'TQM_Drop_frame' being set with 'TCL_drop_reason' 409*5113495bSYour Name set to TCL_vdev_id_mismatch_drop. 410*5113495bSYour Name 411*5113495bSYour Name <legal 0-14> 412*5113495bSYour Name */ 413*5113495bSYour Name 414*5113495bSYour Name #define WBM_RELEASE_RING_TX_TQM_RELEASE_REASON_OFFSET 0x00000008 415*5113495bSYour Name #define WBM_RELEASE_RING_TX_TQM_RELEASE_REASON_LSB 13 416*5113495bSYour Name #define WBM_RELEASE_RING_TX_TQM_RELEASE_REASON_MSB 16 417*5113495bSYour Name #define WBM_RELEASE_RING_TX_TQM_RELEASE_REASON_MASK 0x0001e000 418*5113495bSYour Name 419*5113495bSYour Name 420*5113495bSYour Name /* Description RBM_OVERRIDE_VALID 421*5113495bSYour Name 422*5113495bSYour Name This is set to 0 for Tx cases not involving reinjection, 423*5113495bSYour Name and set to 1 for TQM release cases requiring FW reinjection 424*5113495bSYour Name 425*5113495bSYour Name When set to 1, WBM releases the MSDU buffers to FW and overrides 426*5113495bSYour Name the tx_rate_stats field with words 2 and 3 of the 'TX_MSDU_DETAILS' 427*5113495bSYour Name structure, for FW reinjection of these MSDUs 428*5113495bSYour Name 429*5113495bSYour Name <legal 0-1> 430*5113495bSYour Name */ 431*5113495bSYour Name 432*5113495bSYour Name #define WBM_RELEASE_RING_TX_RBM_OVERRIDE_VALID_OFFSET 0x00000008 433*5113495bSYour Name #define WBM_RELEASE_RING_TX_RBM_OVERRIDE_VALID_LSB 17 434*5113495bSYour Name #define WBM_RELEASE_RING_TX_RBM_OVERRIDE_VALID_MSB 17 435*5113495bSYour Name #define WBM_RELEASE_RING_TX_RBM_OVERRIDE_VALID_MASK 0x00020000 436*5113495bSYour Name 437*5113495bSYour Name 438*5113495bSYour Name /* Description RBM_OVERRIDE 439*5113495bSYour Name 440*5113495bSYour Name Field only valid when rbm_override_valid = 1 441*5113495bSYour Name 442*5113495bSYour Name WBM releases the MSDU buffers to FW and overrides the tx_rate_stats 443*5113495bSYour Name field with words 2 and 3 of the 'TX_MSDU_DETAILS' structure, 444*5113495bSYour Name for FW reinjection of these MSDUs. 445*5113495bSYour Name 446*5113495bSYour Name */ 447*5113495bSYour Name 448*5113495bSYour Name #define WBM_RELEASE_RING_TX_RBM_OVERRIDE_OFFSET 0x00000008 449*5113495bSYour Name #define WBM_RELEASE_RING_TX_RBM_OVERRIDE_LSB 18 450*5113495bSYour Name #define WBM_RELEASE_RING_TX_RBM_OVERRIDE_MSB 21 451*5113495bSYour Name #define WBM_RELEASE_RING_TX_RBM_OVERRIDE_MASK 0x003c0000 452*5113495bSYour Name 453*5113495bSYour Name 454*5113495bSYour Name /* Description RESERVED_2A 455*5113495bSYour Name 456*5113495bSYour Name <legal 0> 457*5113495bSYour Name */ 458*5113495bSYour Name 459*5113495bSYour Name #define WBM_RELEASE_RING_TX_RESERVED_2A_OFFSET 0x00000008 460*5113495bSYour Name #define WBM_RELEASE_RING_TX_RESERVED_2A_LSB 22 461*5113495bSYour Name #define WBM_RELEASE_RING_TX_RESERVED_2A_MSB 28 462*5113495bSYour Name #define WBM_RELEASE_RING_TX_RESERVED_2A_MASK 0x1fc00000 463*5113495bSYour Name 464*5113495bSYour Name 465*5113495bSYour Name /* Description CACHE_ID 466*5113495bSYour Name 467*5113495bSYour Name To improve WBM performance, out-of-order completions may 468*5113495bSYour Name be allowed to process multiple MPDUs in parallel. 469*5113495bSYour Name 470*5113495bSYour Name The MSDUs released from each cache would be in order so 'First_msdu' 471*5113495bSYour Name and this field together can be used by SW to reorder the 472*5113495bSYour Name completions back to the original order by keeping all MSDUs 473*5113495bSYour Name of an MPDU from one cache together before switching to 474*5113495bSYour Name the next MPDU (from either cache). 475*5113495bSYour Name <legal all> 476*5113495bSYour Name */ 477*5113495bSYour Name 478*5113495bSYour Name #define WBM_RELEASE_RING_TX_CACHE_ID_OFFSET 0x00000008 479*5113495bSYour Name #define WBM_RELEASE_RING_TX_CACHE_ID_LSB 29 480*5113495bSYour Name #define WBM_RELEASE_RING_TX_CACHE_ID_MSB 29 481*5113495bSYour Name #define WBM_RELEASE_RING_TX_CACHE_ID_MASK 0x20000000 482*5113495bSYour Name 483*5113495bSYour Name 484*5113495bSYour Name /* Description COOKIE_CONVERSION_STATUS 485*5113495bSYour Name 486*5113495bSYour Name 0: 'Sw_buffer_cookie' not converted to 'Buffer_virt_addr' 487*5113495bSYour Name 488*5113495bSYour Name 1: 'Sw_buffer_cookie' coverted to 'Buffer_virt_addr' 489*5113495bSYour Name <legal 0> 490*5113495bSYour Name */ 491*5113495bSYour Name 492*5113495bSYour Name #define WBM_RELEASE_RING_TX_COOKIE_CONVERSION_STATUS_OFFSET 0x00000008 493*5113495bSYour Name #define WBM_RELEASE_RING_TX_COOKIE_CONVERSION_STATUS_LSB 30 494*5113495bSYour Name #define WBM_RELEASE_RING_TX_COOKIE_CONVERSION_STATUS_MSB 30 495*5113495bSYour Name #define WBM_RELEASE_RING_TX_COOKIE_CONVERSION_STATUS_MASK 0x40000000 496*5113495bSYour Name 497*5113495bSYour Name 498*5113495bSYour Name /* Description WBM_INTERNAL_ERROR 499*5113495bSYour Name 500*5113495bSYour Name Can only be set by WBM. 501*5113495bSYour Name 502*5113495bSYour Name Is set when WBM got a buffer pointer but the action was 503*5113495bSYour Name to push it to the idle link descriptor ring or do link related 504*5113495bSYour Name activity 505*5113495bSYour Name OR 506*5113495bSYour Name Is set when WBM got a link buffer pointer but the action 507*5113495bSYour Name was to push it to the buffer descriptor ring 508*5113495bSYour Name 509*5113495bSYour Name <legal all> 510*5113495bSYour Name */ 511*5113495bSYour Name 512*5113495bSYour Name #define WBM_RELEASE_RING_TX_WBM_INTERNAL_ERROR_OFFSET 0x00000008 513*5113495bSYour Name #define WBM_RELEASE_RING_TX_WBM_INTERNAL_ERROR_LSB 31 514*5113495bSYour Name #define WBM_RELEASE_RING_TX_WBM_INTERNAL_ERROR_MSB 31 515*5113495bSYour Name #define WBM_RELEASE_RING_TX_WBM_INTERNAL_ERROR_MASK 0x80000000 516*5113495bSYour Name 517*5113495bSYour Name 518*5113495bSYour Name /* Description TQM_STATUS_NUMBER 519*5113495bSYour Name 520*5113495bSYour Name Field only valid when Release_source_module is set to release_source_TQM 521*5113495bSYour Name 522*5113495bSYour Name 523*5113495bSYour Name The value in this field is equal to value of the 'TQM_CMD_Number' 524*5113495bSYour Name field from the TQM command or the 'TQM_add_cmd_Number' field 525*5113495bSYour Name from the TQM entrance ring descriptor LSB 24-bits. 526*5113495bSYour Name 527*5113495bSYour Name This field helps to correlate the statuses with the TQM 528*5113495bSYour Name commands. 529*5113495bSYour Name 530*5113495bSYour Name NOTE that SW could program this number to be equal to the 531*5113495bSYour Name PPDU_ID number in case direct correlation with the PPDU 532*5113495bSYour Name ID is desired 533*5113495bSYour Name 534*5113495bSYour Name <legal all> 535*5113495bSYour Name */ 536*5113495bSYour Name 537*5113495bSYour Name #define WBM_RELEASE_RING_TX_TQM_STATUS_NUMBER_OFFSET 0x0000000c 538*5113495bSYour Name #define WBM_RELEASE_RING_TX_TQM_STATUS_NUMBER_LSB 0 539*5113495bSYour Name #define WBM_RELEASE_RING_TX_TQM_STATUS_NUMBER_MSB 23 540*5113495bSYour Name #define WBM_RELEASE_RING_TX_TQM_STATUS_NUMBER_MASK 0x00ffffff 541*5113495bSYour Name 542*5113495bSYour Name 543*5113495bSYour Name /* Description TRANSMIT_COUNT 544*5113495bSYour Name 545*5113495bSYour Name Field only valid when Release_source_module is set to release_source_TQM 546*5113495bSYour Name 547*5113495bSYour Name 548*5113495bSYour Name The number of times this frame has been transmitted 549*5113495bSYour Name */ 550*5113495bSYour Name 551*5113495bSYour Name #define WBM_RELEASE_RING_TX_TRANSMIT_COUNT_OFFSET 0x0000000c 552*5113495bSYour Name #define WBM_RELEASE_RING_TX_TRANSMIT_COUNT_LSB 24 553*5113495bSYour Name #define WBM_RELEASE_RING_TX_TRANSMIT_COUNT_MSB 30 554*5113495bSYour Name #define WBM_RELEASE_RING_TX_TRANSMIT_COUNT_MASK 0x7f000000 555*5113495bSYour Name 556*5113495bSYour Name 557*5113495bSYour Name /* Description SW_RELEASE_DETAILS_VALID 558*5113495bSYour Name 559*5113495bSYour Name Consumer: SW 560*5113495bSYour Name Producer: WBM 561*5113495bSYour Name 562*5113495bSYour Name When set, some WBM specific release info for SW is valid. 563*5113495bSYour Name 564*5113495bSYour Name This is set when WMB got a 'release_msdu_list' command from 565*5113495bSYour Name TQM and the return buffer manager is not WMB. WBM will 566*5113495bSYour Name then de-aggregate all the MSDUs and pass them one at a time 567*5113495bSYour Name on to the 'buffer owner' 568*5113495bSYour Name 569*5113495bSYour Name <legal all> 570*5113495bSYour Name */ 571*5113495bSYour Name 572*5113495bSYour Name #define WBM_RELEASE_RING_TX_SW_RELEASE_DETAILS_VALID_OFFSET 0x0000000c 573*5113495bSYour Name #define WBM_RELEASE_RING_TX_SW_RELEASE_DETAILS_VALID_LSB 31 574*5113495bSYour Name #define WBM_RELEASE_RING_TX_SW_RELEASE_DETAILS_VALID_MSB 31 575*5113495bSYour Name #define WBM_RELEASE_RING_TX_SW_RELEASE_DETAILS_VALID_MASK 0x80000000 576*5113495bSYour Name 577*5113495bSYour Name 578*5113495bSYour Name /* Description ACK_FRAME_RSSI 579*5113495bSYour Name 580*5113495bSYour Name This field is only valid when the source is TQM. 581*5113495bSYour Name 582*5113495bSYour Name If this frame is removed as the result of the reception 583*5113495bSYour Name of an ACK or BA, this field indicates the RSSI of the received 584*5113495bSYour Name ACK or BA frame. 585*5113495bSYour Name 586*5113495bSYour Name When the frame is removed as result of a direct remove command 587*5113495bSYour Name from the SW, this field is set to 0x0 (which is never 588*5113495bSYour Name a valid value when real RSSI is available) 589*5113495bSYour Name 590*5113495bSYour Name <legal all> 591*5113495bSYour Name */ 592*5113495bSYour Name 593*5113495bSYour Name #define WBM_RELEASE_RING_TX_ACK_FRAME_RSSI_OFFSET 0x00000010 594*5113495bSYour Name #define WBM_RELEASE_RING_TX_ACK_FRAME_RSSI_LSB 0 595*5113495bSYour Name #define WBM_RELEASE_RING_TX_ACK_FRAME_RSSI_MSB 7 596*5113495bSYour Name #define WBM_RELEASE_RING_TX_ACK_FRAME_RSSI_MASK 0x000000ff 597*5113495bSYour Name 598*5113495bSYour Name 599*5113495bSYour Name /* Description FIRST_MSDU 600*5113495bSYour Name 601*5113495bSYour Name Field only valid when SW_release_details_valid is set. 602*5113495bSYour Name 603*5113495bSYour Name Consumer: SW 604*5113495bSYour Name Producer: WBM 605*5113495bSYour Name 606*5113495bSYour Name When set, this MSDU is the first MSDU pointed to in the 'release_msdu_list' 607*5113495bSYour Name command. 608*5113495bSYour Name 609*5113495bSYour Name First_msdu ≠ last_msdu indicates the MSDU was part of 610*5113495bSYour Name an A-MSDU. 611*5113495bSYour Name <legal all> 612*5113495bSYour Name */ 613*5113495bSYour Name 614*5113495bSYour Name #define WBM_RELEASE_RING_TX_FIRST_MSDU_OFFSET 0x00000010 615*5113495bSYour Name #define WBM_RELEASE_RING_TX_FIRST_MSDU_LSB 8 616*5113495bSYour Name #define WBM_RELEASE_RING_TX_FIRST_MSDU_MSB 8 617*5113495bSYour Name #define WBM_RELEASE_RING_TX_FIRST_MSDU_MASK 0x00000100 618*5113495bSYour Name 619*5113495bSYour Name 620*5113495bSYour Name /* Description LAST_MSDU 621*5113495bSYour Name 622*5113495bSYour Name Field only valid when SW_release_details_valid is set. 623*5113495bSYour Name 624*5113495bSYour Name Consumer: SW 625*5113495bSYour Name Producer: WBM 626*5113495bSYour Name 627*5113495bSYour Name When set, this MSDU is the last MSDU pointed to in the 'release_msdu_list' 628*5113495bSYour Name command. 629*5113495bSYour Name 630*5113495bSYour Name First_msdu ≠ last_msdu indicates the MSDU was part of 631*5113495bSYour Name an A-MSDU. 632*5113495bSYour Name <legal all> 633*5113495bSYour Name */ 634*5113495bSYour Name 635*5113495bSYour Name #define WBM_RELEASE_RING_TX_LAST_MSDU_OFFSET 0x00000010 636*5113495bSYour Name #define WBM_RELEASE_RING_TX_LAST_MSDU_LSB 9 637*5113495bSYour Name #define WBM_RELEASE_RING_TX_LAST_MSDU_MSB 9 638*5113495bSYour Name #define WBM_RELEASE_RING_TX_LAST_MSDU_MASK 0x00000200 639*5113495bSYour Name 640*5113495bSYour Name 641*5113495bSYour Name /* Description FW_TX_NOTIFY_FRAME 642*5113495bSYour Name 643*5113495bSYour Name Field only valid when SW_release_details_valid is set. 644*5113495bSYour Name 645*5113495bSYour Name Consumer: SW 646*5113495bSYour Name Producer: WBM 647*5113495bSYour Name 648*5113495bSYour Name This is the FW_tx_notify_frame field from the TX_MSDU_DETAILS 649*5113495bSYour Name for this frame from the MSDU link descriptor 650*5113495bSYour Name <legal all> 651*5113495bSYour Name */ 652*5113495bSYour Name 653*5113495bSYour Name #define WBM_RELEASE_RING_TX_FW_TX_NOTIFY_FRAME_OFFSET 0x00000010 654*5113495bSYour Name #define WBM_RELEASE_RING_TX_FW_TX_NOTIFY_FRAME_LSB 10 655*5113495bSYour Name #define WBM_RELEASE_RING_TX_FW_TX_NOTIFY_FRAME_MSB 12 656*5113495bSYour Name #define WBM_RELEASE_RING_TX_FW_TX_NOTIFY_FRAME_MASK 0x00001c00 657*5113495bSYour Name 658*5113495bSYour Name 659*5113495bSYour Name /* Description BUFFER_TIMESTAMP 660*5113495bSYour Name 661*5113495bSYour Name Field only valid when SW_release_details_valid is set. 662*5113495bSYour Name 663*5113495bSYour Name Consumer: SW 664*5113495bSYour Name Producer: WBM 665*5113495bSYour Name 666*5113495bSYour Name This is the Buffer_timestamp field from the TX_MSDU_DETAILS 667*5113495bSYour Name for this frame from the MSDU link descriptor. 668*5113495bSYour Name 669*5113495bSYour Name Timestamp in units determined by the UMCMN 'TX_TIMESTAMP_RESOLUTION_SELECT' 670*5113495bSYour Name register 671*5113495bSYour Name 672*5113495bSYour Name <legal all> 673*5113495bSYour Name */ 674*5113495bSYour Name 675*5113495bSYour Name #define WBM_RELEASE_RING_TX_BUFFER_TIMESTAMP_OFFSET 0x00000010 676*5113495bSYour Name #define WBM_RELEASE_RING_TX_BUFFER_TIMESTAMP_LSB 13 677*5113495bSYour Name #define WBM_RELEASE_RING_TX_BUFFER_TIMESTAMP_MSB 31 678*5113495bSYour Name #define WBM_RELEASE_RING_TX_BUFFER_TIMESTAMP_MASK 0xffffe000 679*5113495bSYour Name 680*5113495bSYour Name 681*5113495bSYour Name /* Description TX_RATE_STATS 682*5113495bSYour Name 683*5113495bSYour Name Consumer: TQM/SW 684*5113495bSYour Name Producer: SW/SCH(from TXPCU, PDG) /WBM (from RXDMA) 685*5113495bSYour Name 686*5113495bSYour Name Details for command execution tracking purposes. 687*5113495bSYour Name */ 688*5113495bSYour Name 689*5113495bSYour Name 690*5113495bSYour Name /* Description TX_RATE_STATS_INFO_VALID 691*5113495bSYour Name 692*5113495bSYour Name When set all other fields in this STRUCT contain valid info. 693*5113495bSYour Name 694*5113495bSYour Name 695*5113495bSYour Name When clear, none of the other fields contain valid info. 696*5113495bSYour Name 697*5113495bSYour Name <legal all> 698*5113495bSYour Name */ 699*5113495bSYour Name 700*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TX_RATE_STATS_INFO_VALID_OFFSET 0x00000014 701*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TX_RATE_STATS_INFO_VALID_LSB 0 702*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TX_RATE_STATS_INFO_VALID_MSB 0 703*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TX_RATE_STATS_INFO_VALID_MASK 0x00000001 704*5113495bSYour Name 705*5113495bSYour Name 706*5113495bSYour Name /* Description TRANSMIT_BW 707*5113495bSYour Name 708*5113495bSYour Name Field only valid when Tx_rate_stats_info_valid is set 709*5113495bSYour Name 710*5113495bSYour Name Indicates the BW of the upcoming transmission that shall 711*5113495bSYour Name likely start in about 3 -4 us on the medium 712*5113495bSYour Name 713*5113495bSYour Name <enum 0 20_mhz>20 Mhz BW 714*5113495bSYour Name <enum 1 40_mhz>40 Mhz BW 715*5113495bSYour Name <enum 2 80_mhz>80 Mhz BW 716*5113495bSYour Name <enum 3 160_mhz>160 Mhz BW 717*5113495bSYour Name <enum 4 320_mhz>320 Mhz BW 718*5113495bSYour Name <enum 5 240_mhz>240 Mhz BW 719*5113495bSYour Name */ 720*5113495bSYour Name 721*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_BW_OFFSET 0x00000014 722*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_BW_LSB 1 723*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_BW_MSB 3 724*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_BW_MASK 0x0000000e 725*5113495bSYour Name 726*5113495bSYour Name 727*5113495bSYour Name /* Description TRANSMIT_PKT_TYPE 728*5113495bSYour Name 729*5113495bSYour Name Field only valid when Tx_rate_stats_info_valid is set 730*5113495bSYour Name 731*5113495bSYour Name Field filled in by PDG. 732*5113495bSYour Name Not valid when in SW transmit mode 733*5113495bSYour Name 734*5113495bSYour Name The packet type 735*5113495bSYour Name <enum 0 dot11a>802.11a PPDU type 736*5113495bSYour Name <enum 1 dot11b>802.11b PPDU type 737*5113495bSYour Name <enum 2 dot11n_mm>802.11n Mixed Mode PPDU type 738*5113495bSYour Name <enum 3 dot11ac>802.11ac PPDU type 739*5113495bSYour Name <enum 4 dot11ax>802.11ax PPDU type 740*5113495bSYour Name <enum 5 dot11ba>802.11ba (WUR) PPDU type 741*5113495bSYour Name <enum 6 dot11be>802.11be PPDU type 742*5113495bSYour Name <enum 7 dot11az>802.11az (ranging) PPDU type 743*5113495bSYour Name <enum 8 dot11n_gf>802.11n Green Field PPDU type (unsupported 744*5113495bSYour Name & aborted) 745*5113495bSYour Name */ 746*5113495bSYour Name 747*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_PKT_TYPE_OFFSET 0x00000014 748*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_PKT_TYPE_LSB 4 749*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_PKT_TYPE_MSB 7 750*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_PKT_TYPE_MASK 0x000000f0 751*5113495bSYour Name 752*5113495bSYour Name 753*5113495bSYour Name /* Description TRANSMIT_STBC 754*5113495bSYour Name 755*5113495bSYour Name Field only valid when Tx_rate_stats_info_valid is set 756*5113495bSYour Name 757*5113495bSYour Name Field filled in by PDG. 758*5113495bSYour Name Not valid when in SW transmit mode 759*5113495bSYour Name 760*5113495bSYour Name When set, STBC transmission rate was used. 761*5113495bSYour Name */ 762*5113495bSYour Name 763*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_STBC_OFFSET 0x00000014 764*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_STBC_LSB 8 765*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_STBC_MSB 8 766*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_STBC_MASK 0x00000100 767*5113495bSYour Name 768*5113495bSYour Name 769*5113495bSYour Name /* Description TRANSMIT_LDPC 770*5113495bSYour Name 771*5113495bSYour Name Field only valid when Tx_rate_stats_info_valid is set 772*5113495bSYour Name 773*5113495bSYour Name Field filled in by PDG. 774*5113495bSYour Name Not valid when in SW transmit mode 775*5113495bSYour Name 776*5113495bSYour Name When set, use LDPC transmission rates 777*5113495bSYour Name */ 778*5113495bSYour Name 779*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_LDPC_OFFSET 0x00000014 780*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_LDPC_LSB 9 781*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_LDPC_MSB 9 782*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_LDPC_MASK 0x00000200 783*5113495bSYour Name 784*5113495bSYour Name 785*5113495bSYour Name /* Description TRANSMIT_SGI 786*5113495bSYour Name 787*5113495bSYour Name Field only valid when Tx_rate_stats_info_valid is set 788*5113495bSYour Name 789*5113495bSYour Name Field filled in by PDG. 790*5113495bSYour Name Not valid when in SW transmit mode 791*5113495bSYour Name 792*5113495bSYour Name Specify the right GI for HE-Ranging NDPs (11az)/Short NDP. 793*5113495bSYour Name 794*5113495bSYour Name 795*5113495bSYour Name <enum 0 0_8_us_sgi > Legacy normal GI. Can also be used 796*5113495bSYour Name for HE 797*5113495bSYour Name <enum 1 0_4_us_sgi > Legacy short GI. Can also be used 798*5113495bSYour Name for HE 799*5113495bSYour Name <enum 2 1_6_us_sgi > HE related GI 800*5113495bSYour Name <enum 3 3_2_us_sgi > HE related GI 801*5113495bSYour Name <legal 0 - 3> 802*5113495bSYour Name */ 803*5113495bSYour Name 804*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_SGI_OFFSET 0x00000014 805*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_SGI_LSB 10 806*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_SGI_MSB 11 807*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_SGI_MASK 0x00000c00 808*5113495bSYour Name 809*5113495bSYour Name 810*5113495bSYour Name /* Description TRANSMIT_MCS 811*5113495bSYour Name 812*5113495bSYour Name Field only valid when Tx_rate_stats_info_valid is set 813*5113495bSYour Name 814*5113495bSYour Name Field filled in by PDG. 815*5113495bSYour Name Not valid when in SW transmit mode 816*5113495bSYour Name 817*5113495bSYour Name For details, refer to MCS_TYPE description 818*5113495bSYour Name <legal all> 819*5113495bSYour Name */ 820*5113495bSYour Name 821*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_MCS_OFFSET 0x00000014 822*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_MCS_LSB 12 823*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_MCS_MSB 15 824*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_MCS_MASK 0x0000f000 825*5113495bSYour Name 826*5113495bSYour Name 827*5113495bSYour Name /* Description OFDMA_TRANSMISSION 828*5113495bSYour Name 829*5113495bSYour Name Field only valid when Tx_rate_stats_info_valid is set 830*5113495bSYour Name 831*5113495bSYour Name Field filled in by PDG. 832*5113495bSYour Name 833*5113495bSYour Name Set when the transmission was an OFDMA transmission (DL 834*5113495bSYour Name or UL). 835*5113495bSYour Name <legal all> 836*5113495bSYour Name */ 837*5113495bSYour Name 838*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_OFDMA_TRANSMISSION_OFFSET 0x00000014 839*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_OFDMA_TRANSMISSION_LSB 16 840*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_OFDMA_TRANSMISSION_MSB 16 841*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_OFDMA_TRANSMISSION_MASK 0x00010000 842*5113495bSYour Name 843*5113495bSYour Name 844*5113495bSYour Name /* Description TONES_IN_RU 845*5113495bSYour Name 846*5113495bSYour Name Field only valid when Tx_rate_stats_info_valid is set 847*5113495bSYour Name 848*5113495bSYour Name Field filled in by PDG. 849*5113495bSYour Name Not valid when in SW transmit mode 850*5113495bSYour Name 851*5113495bSYour Name The number of tones in the RU used. 852*5113495bSYour Name <legal all> 853*5113495bSYour Name */ 854*5113495bSYour Name 855*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TONES_IN_RU_OFFSET 0x00000014 856*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TONES_IN_RU_LSB 17 857*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TONES_IN_RU_MSB 28 858*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TONES_IN_RU_MASK 0x1ffe0000 859*5113495bSYour Name 860*5113495bSYour Name 861*5113495bSYour Name /* Description TRANSMIT_NSS 862*5113495bSYour Name 863*5113495bSYour Name Field only valid when Tx_rate_stats_info_valid is set 864*5113495bSYour Name 865*5113495bSYour Name Field filled in by PDG 866*5113495bSYour Name Not valid when in SW transmit mode 867*5113495bSYour Name 868*5113495bSYour Name The number of spatial streams used in the transmission 869*5113495bSYour Name 870*5113495bSYour Name <enum 0 1_spatial_stream>Single spatial stream 871*5113495bSYour Name <enum 1 2_spatial_streams>2 spatial streams 872*5113495bSYour Name <enum 2 3_spatial_streams>3 spatial streams 873*5113495bSYour Name <enum 3 4_spatial_streams>4 spatial streams 874*5113495bSYour Name <enum 4 5_spatial_streams>5 spatial streams 875*5113495bSYour Name <enum 5 6_spatial_streams>6 spatial streams 876*5113495bSYour Name <enum 6 7_spatial_streams>7 spatial streams 877*5113495bSYour Name <enum 7 8_spatial_streams>8 spatial streams 878*5113495bSYour Name */ 879*5113495bSYour Name 880*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_NSS_OFFSET 0x00000014 881*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_NSS_LSB 29 882*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_NSS_MSB 31 883*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_TRANSMIT_NSS_MASK 0xe0000000 884*5113495bSYour Name 885*5113495bSYour Name 886*5113495bSYour Name /* Description PPDU_TRANSMISSION_TSF 887*5113495bSYour Name 888*5113495bSYour Name Field only valid when Tx_rate_stats_info_valid is set 889*5113495bSYour Name 890*5113495bSYour Name Based on a HWSCH configuration register setting, this field 891*5113495bSYour Name either contains: 892*5113495bSYour Name 893*5113495bSYour Name Lower 32 bits of the TSF, snapshot of this value when transmission 894*5113495bSYour Name of the PPDU containing the frame finished. 895*5113495bSYour Name OR 896*5113495bSYour Name Lower 32 bits of the TSF, snapshot of this value when transmission 897*5113495bSYour Name of the PPDU containing the frame started 898*5113495bSYour Name 899*5113495bSYour Name <legal all> 900*5113495bSYour Name */ 901*5113495bSYour Name 902*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_PPDU_TRANSMISSION_TSF_OFFSET 0x00000018 903*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_PPDU_TRANSMISSION_TSF_LSB 0 904*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_PPDU_TRANSMISSION_TSF_MSB 31 905*5113495bSYour Name #define WBM_RELEASE_RING_TX_TX_RATE_STATS_PPDU_TRANSMISSION_TSF_MASK 0xffffffff 906*5113495bSYour Name 907*5113495bSYour Name 908*5113495bSYour Name /* Description SW_PEER_ID 909*5113495bSYour Name 910*5113495bSYour Name Field only valid when Release_source_module is set to release_source_TQM 911*5113495bSYour Name 912*5113495bSYour Name 913*5113495bSYour Name 1) Release of msdu buffer due to drop_frame = 1. Flow is 914*5113495bSYour Name not fetched and hence sw_peer_id and tid = 0 915*5113495bSYour Name buffer_or_desc_type = e_num 0 MSDU_rel_buffertqm_release_reason 916*5113495bSYour Name = e_num 1 tqm_rr_rem_cmd_rem 917*5113495bSYour Name 918*5113495bSYour Name 919*5113495bSYour Name 2) Release of msdu buffer due to Flow is not fetched and 920*5113495bSYour Name hence sw_peer_id and tid = 0 921*5113495bSYour Name buffer_or_desc_type = e_num 0 MSDU_rel_buffertqm_release_reason 922*5113495bSYour Name = e_num 1 tqm_rr_rem_cmd_rem 923*5113495bSYour Name 924*5113495bSYour Name 925*5113495bSYour Name 3) Release of msdu link due to remove_mpdu or acked_mpdu 926*5113495bSYour Name command. 927*5113495bSYour Name buffer_or_desc_type = e_num1 msdu_link_descriptortqm_release_reason 928*5113495bSYour Name can be:e_num 1 tqm_rr_rem_cmd_reme_num 2 tqm_rr_rem_cmd_tx 929*5113495bSYour Name 930*5113495bSYour Name e_num 3 tqm_rr_rem_cmd_notxe_num 4 tqm_rr_rem_cmd_aged (this 931*5113495bSYour Name e_num is used for REMOVE_MPDU as well as REMOVE_MSDU). 932*5113495bSYour Name 933*5113495bSYour Name Sw_peer_id from the TX_MSDU_FLOW descriptor or TX_MPDU_QUEUE 934*5113495bSYour Name descriptor 935*5113495bSYour Name <legal all> 936*5113495bSYour Name */ 937*5113495bSYour Name 938*5113495bSYour Name #define WBM_RELEASE_RING_TX_SW_PEER_ID_OFFSET 0x0000001c 939*5113495bSYour Name #define WBM_RELEASE_RING_TX_SW_PEER_ID_LSB 0 940*5113495bSYour Name #define WBM_RELEASE_RING_TX_SW_PEER_ID_MSB 15 941*5113495bSYour Name #define WBM_RELEASE_RING_TX_SW_PEER_ID_MASK 0x0000ffff 942*5113495bSYour Name 943*5113495bSYour Name 944*5113495bSYour Name /* Description TID 945*5113495bSYour Name 946*5113495bSYour Name Field only valid when Release_source_module is set to release_source_TQM 947*5113495bSYour Name 948*5113495bSYour Name 949*5113495bSYour Name 1) Release of msdu buffer due to drop_frame = 1. Flow is 950*5113495bSYour Name not fetched and hence sw_peer_id and tid = 0 951*5113495bSYour Name buffer_or_desc_type = e_num 0 MSDU_rel_buffertqm_release_reason 952*5113495bSYour Name = e_num 1 tqm_rr_rem_cmd_rem 953*5113495bSYour Name 954*5113495bSYour Name 955*5113495bSYour Name 2) Release of msdu buffer due to Flow is not fetched and 956*5113495bSYour Name hence sw_peer_id and tid = 0 957*5113495bSYour Name buffer_or_desc_type = e_num 0 MSDU_rel_buffertqm_release_reason 958*5113495bSYour Name = e_num 1 tqm_rr_rem_cmd_rem 959*5113495bSYour Name 960*5113495bSYour Name 961*5113495bSYour Name 3) Release of msdu link due to remove_mpdu or acked_mpdu 962*5113495bSYour Name command. 963*5113495bSYour Name buffer_or_desc_type = e_num1 msdu_link_descriptortqm_release_reason 964*5113495bSYour Name can be:e_num 1 tqm_rr_rem_cmd_reme_num 2 tqm_rr_rem_cmd_tx 965*5113495bSYour Name 966*5113495bSYour Name e_num 3 tqm_rr_rem_cmd_notxe_num 4 tqm_rr_rem_cmd_aged (this 967*5113495bSYour Name e_num is used for REMOVE_MPDU as well as REMOVE_MSDU). 968*5113495bSYour Name 969*5113495bSYour Name 970*5113495bSYour Name This field represents the TID from the TX_MSDU_FLOW descriptor 971*5113495bSYour Name or TX_MPDU_QUEUE descriptor 972*5113495bSYour Name 973*5113495bSYour Name <legal all> 974*5113495bSYour Name */ 975*5113495bSYour Name 976*5113495bSYour Name #define WBM_RELEASE_RING_TX_TID_OFFSET 0x0000001c 977*5113495bSYour Name #define WBM_RELEASE_RING_TX_TID_LSB 16 978*5113495bSYour Name #define WBM_RELEASE_RING_TX_TID_MSB 19 979*5113495bSYour Name #define WBM_RELEASE_RING_TX_TID_MASK 0x000f0000 980*5113495bSYour Name 981*5113495bSYour Name 982*5113495bSYour Name /* Description TQM_STATUS_NUMBER_31_24 983*5113495bSYour Name 984*5113495bSYour Name Field only valid when Release_source_module is set to release_source_TQM 985*5113495bSYour Name 986*5113495bSYour Name 987*5113495bSYour Name The value in this field is equal to value of the 'TQM_CMD_Number' 988*5113495bSYour Name field from the TQM command or the 'TQM_add_cmd_Number' field 989*5113495bSYour Name from the TQM entrance ring descriptor MSB 8-bits. 990*5113495bSYour Name 991*5113495bSYour Name This field helps to correlate the statuses with the TQM 992*5113495bSYour Name commands. 993*5113495bSYour Name 994*5113495bSYour Name <legal all> 995*5113495bSYour Name */ 996*5113495bSYour Name 997*5113495bSYour Name #define WBM_RELEASE_RING_TX_TQM_STATUS_NUMBER_31_24_OFFSET 0x0000001c 998*5113495bSYour Name #define WBM_RELEASE_RING_TX_TQM_STATUS_NUMBER_31_24_LSB 20 999*5113495bSYour Name #define WBM_RELEASE_RING_TX_TQM_STATUS_NUMBER_31_24_MSB 27 1000*5113495bSYour Name #define WBM_RELEASE_RING_TX_TQM_STATUS_NUMBER_31_24_MASK 0x0ff00000 1001*5113495bSYour Name 1002*5113495bSYour Name 1003*5113495bSYour Name /* Description LOOPING_COUNT 1004*5113495bSYour Name 1005*5113495bSYour Name Consumer: WBM/SW/FW 1006*5113495bSYour Name Producer: SW/TQM/RXDMA/REO/SWITCH 1007*5113495bSYour Name 1008*5113495bSYour Name If WBM_internal_error is set, this descriptor is sent to 1009*5113495bSYour Name the dedicated 'WBM_ERROR_RELEASE' ring and Looping_count 1010*5113495bSYour Name is used to indicate an error code. 1011*5113495bSYour Name 1012*5113495bSYour Name The values reported are documented further in the WBM MLD 1013*5113495bSYour Name doc. 1014*5113495bSYour Name 1015*5113495bSYour Name If WBM_internal_error is not set, the following holds. 1016*5113495bSYour Name 1017*5113495bSYour Name A count value that indicates the number of times the producer 1018*5113495bSYour Name of entries into the Buffer Manager Ring has looped around 1019*5113495bSYour Name the ring. 1020*5113495bSYour Name At initialization time, this value is set to 0. On the first 1021*5113495bSYour Name loop, this value is set to 1. After the max value is reached 1022*5113495bSYour Name allowed by the number of bits for this field, the count 1023*5113495bSYour Name value continues with 0 again. 1024*5113495bSYour Name 1025*5113495bSYour Name In case SW is the consumer of the ring entries, it can use 1026*5113495bSYour Name this field to figure out up to where the producer of entries 1027*5113495bSYour Name has created new entries. This eliminates the need to check 1028*5113495bSYour Name where the "head pointer' of the ring is located once the 1029*5113495bSYour Name SW starts processing an interrupt indicating that new entries 1030*5113495bSYour Name have been put into this ring... 1031*5113495bSYour Name 1032*5113495bSYour Name Also note that SW if it wants only needs to look at the 1033*5113495bSYour Name LSB bit of this count value. 1034*5113495bSYour Name <legal all> 1035*5113495bSYour Name */ 1036*5113495bSYour Name 1037*5113495bSYour Name #define WBM_RELEASE_RING_TX_LOOPING_COUNT_OFFSET 0x0000001c 1038*5113495bSYour Name #define WBM_RELEASE_RING_TX_LOOPING_COUNT_LSB 28 1039*5113495bSYour Name #define WBM_RELEASE_RING_TX_LOOPING_COUNT_MSB 31 1040*5113495bSYour Name #define WBM_RELEASE_RING_TX_LOOPING_COUNT_MASK 0xf0000000 1041*5113495bSYour Name 1042*5113495bSYour Name 1043*5113495bSYour Name 1044*5113495bSYour Name #endif // WBM_RELEASE_RING_TX 1045