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