xref: /wlan-driver/fw-api/hw/qcn9000/sw_monitor_ring.h (revision 5113495b16420b49004c444715d2daae2066e7dc) 
1*5113495bSYour Name /*
2*5113495bSYour Name  * Copyright (c) 2020, The Linux Foundation. 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 _SW_MONITOR_RING_H_
18*5113495bSYour Name #define _SW_MONITOR_RING_H_
19*5113495bSYour Name #if !defined(__ASSEMBLER__)
20*5113495bSYour Name #endif
21*5113495bSYour Name 
22*5113495bSYour Name #include "rx_mpdu_details.h"
23*5113495bSYour Name #include "buffer_addr_info.h"
24*5113495bSYour Name 
25*5113495bSYour Name // ################ START SUMMARY #################
26*5113495bSYour Name //
27*5113495bSYour Name //	Dword	Fields
28*5113495bSYour Name //	0-3	struct rx_mpdu_details reo_level_mpdu_frame_info;
29*5113495bSYour Name //	4-5	struct buffer_addr_info status_buff_addr_info;
30*5113495bSYour Name //	6	rxdma_push_reason[1:0], rxdma_error_code[6:2], mpdu_fragment_number[10:7], frameless_bar[11], status_buf_count[15:12], end_of_ppdu[16], reserved_6a[31:17]
31*5113495bSYour Name //	7	phy_ppdu_id[15:0], reserved_7a[19:16], ring_id[27:20], looping_count[31:28]
32*5113495bSYour Name //
33*5113495bSYour Name // ################ END SUMMARY #################
34*5113495bSYour Name 
35*5113495bSYour Name #define NUM_OF_DWORDS_SW_MONITOR_RING 8
36*5113495bSYour Name 
37*5113495bSYour Name struct sw_monitor_ring {
38*5113495bSYour Name     struct            rx_mpdu_details                       reo_level_mpdu_frame_info;
39*5113495bSYour Name     struct            buffer_addr_info                       status_buff_addr_info;
40*5113495bSYour Name              uint32_t rxdma_push_reason               :  2, //[1:0]
41*5113495bSYour Name                       rxdma_error_code                :  5, //[6:2]
42*5113495bSYour Name                       mpdu_fragment_number            :  4, //[10:7]
43*5113495bSYour Name                       frameless_bar                   :  1, //[11]
44*5113495bSYour Name                       status_buf_count                :  4, //[15:12]
45*5113495bSYour Name                       end_of_ppdu                     :  1, //[16]
46*5113495bSYour Name                       reserved_6a                     : 15; //[31:17]
47*5113495bSYour Name              uint32_t phy_ppdu_id                     : 16, //[15:0]
48*5113495bSYour Name                       reserved_7a                     :  4, //[19:16]
49*5113495bSYour Name                       ring_id                         :  8, //[27:20]
50*5113495bSYour Name                       looping_count                   :  4; //[31:28]
51*5113495bSYour Name };
52*5113495bSYour Name 
53*5113495bSYour Name /*
54*5113495bSYour Name 
55*5113495bSYour Name struct rx_mpdu_details reo_level_mpdu_frame_info
56*5113495bSYour Name 
57*5113495bSYour Name 			Consumer: SW
58*5113495bSYour Name 
59*5113495bSYour Name 			Producer: RXDMA
60*5113495bSYour Name 
61*5113495bSYour Name 
62*5113495bSYour Name 
63*5113495bSYour Name 			Details related to the MPDU being pushed to SW, valid
64*5113495bSYour Name 			only if end_of_ppdu is set to 0
65*5113495bSYour Name 
66*5113495bSYour Name struct buffer_addr_info status_buff_addr_info
67*5113495bSYour Name 
68*5113495bSYour Name 			Consumer: SW
69*5113495bSYour Name 
70*5113495bSYour Name 			Producer: RXDMA
71*5113495bSYour Name 
72*5113495bSYour Name 
73*5113495bSYour Name 
74*5113495bSYour Name 			Details of the physical address of the first status
75*5113495bSYour Name 			buffer used for the PPDU (either the PPDU that included the
76*5113495bSYour Name 			MPDU being pushed to SW if end_of_ppdu = 0, or the PPDU
77*5113495bSYour Name 			whose end is indicated through end_of_ppdu = 1)
78*5113495bSYour Name 
79*5113495bSYour Name rxdma_push_reason
80*5113495bSYour Name 
81*5113495bSYour Name 			Indicates why RXDMA pushed the frame to this ring
82*5113495bSYour Name 
83*5113495bSYour Name 
84*5113495bSYour Name 
85*5113495bSYour Name 			<enum 0 rxdma_error_detected> RXDMA detected an error an
86*5113495bSYour Name 			pushed this frame to this queue
87*5113495bSYour Name 
88*5113495bSYour Name 			<enum 1 rxdma_routing_instruction> RXDMA pushed the
89*5113495bSYour Name 			frame to this queue per received routing instructions. No
90*5113495bSYour Name 			error within RXDMA was detected
91*5113495bSYour Name 
92*5113495bSYour Name 			<enum 2 rxdma_rx_flush> RXDMA received an RX_FLUSH. As a
93*5113495bSYour Name 			result the MSDU link descriptor might not have the
94*5113495bSYour Name 			last_msdu_in_mpdu_flag set, but instead WBM might just see a
95*5113495bSYour Name 			NULL pointer in the MSDU link descriptor. This is to be
96*5113495bSYour Name 			considered a normal condition for this scenario.
97*5113495bSYour Name 
98*5113495bSYour Name 
99*5113495bSYour Name 
100*5113495bSYour Name 			<legal 0 - 2>
101*5113495bSYour Name 
102*5113495bSYour Name rxdma_error_code
103*5113495bSYour Name 
104*5113495bSYour Name 			Field only valid when rxdma_push_reason is set to
105*5113495bSYour Name 			'rxdma_error_detected.'
106*5113495bSYour Name 
107*5113495bSYour Name 
108*5113495bSYour Name 
109*5113495bSYour Name 			<enum 0 rxdma_overflow_err>MPDU frame is not complete
110*5113495bSYour Name 			due to a FIFO overflow error in RXPCU.
111*5113495bSYour Name 
112*5113495bSYour Name 			<enum 1 rxdma_mpdu_length_err>MPDU frame is not complete
113*5113495bSYour Name 			due to receiving incomplete MPDU from the PHY
114*5113495bSYour Name 
115*5113495bSYour Name 
116*5113495bSYour Name 			<enum 3 rxdma_decrypt_err>CRYPTO reported a decryption
117*5113495bSYour Name 			error or CRYPTO received an encrypted frame, but did not get
118*5113495bSYour Name 			a valid corresponding key id in the peer entry.
119*5113495bSYour Name 
120*5113495bSYour Name 			<enum 4 rxdma_tkip_mic_err>CRYPTO reported a TKIP MIC
121*5113495bSYour Name 			error
122*5113495bSYour Name 
123*5113495bSYour Name 			<enum 5 rxdma_unecrypted_err>CRYPTO reported an
124*5113495bSYour Name 			unencrypted frame error when encrypted was expected
125*5113495bSYour Name 
126*5113495bSYour Name 			<enum 6 rxdma_msdu_len_err>RX OLE reported an MSDU
127*5113495bSYour Name 			length error
128*5113495bSYour Name 
129*5113495bSYour Name 			<enum 7 rxdma_msdu_limit_err>RX OLE reported that max
130*5113495bSYour Name 			number of MSDUs allowed in an MPDU got exceeded
131*5113495bSYour Name 
132*5113495bSYour Name 			<enum 8 rxdma_wifi_parse_err>RX OLE reported a parsing
133*5113495bSYour Name 			error
134*5113495bSYour Name 
135*5113495bSYour Name 			<enum 9 rxdma_amsdu_parse_err>RX OLE reported an A-MSDU
136*5113495bSYour Name 			parsing error
137*5113495bSYour Name 
138*5113495bSYour Name 			<enum 10 rxdma_sa_timeout_err>RX OLE reported a timeout
139*5113495bSYour Name 			during SA search
140*5113495bSYour Name 
141*5113495bSYour Name 			<enum 11 rxdma_da_timeout_err>RX OLE reported a timeout
142*5113495bSYour Name 			during DA search
143*5113495bSYour Name 
144*5113495bSYour Name 			<enum 12 rxdma_flow_timeout_err>RX OLE reported a
145*5113495bSYour Name 			timeout during flow search
146*5113495bSYour Name 
147*5113495bSYour Name 			<enum 13 rxdma_flush_request>RXDMA received a flush
148*5113495bSYour Name 			request
149*5113495bSYour Name 
150*5113495bSYour Name 			<enum 14 rxdma_amsdu_fragment_err>Rx PCU reported A-MSDU
151*5113495bSYour Name 			present as well as a fragmented MPDU. A-MSDU defragmentation
152*5113495bSYour Name 			is not supported in Lithium SW so this is treated as an
153*5113495bSYour Name 			error.
154*5113495bSYour Name 
155*5113495bSYour Name mpdu_fragment_number
156*5113495bSYour Name 
157*5113495bSYour Name 			Field only valid when Reo_level_mpdu_frame_info.
158*5113495bSYour Name 			Rx_mpdu_desc_info_details.Fragment_flag is set and
159*5113495bSYour Name 			end_of_ppdu is set to 0.
160*5113495bSYour Name 
161*5113495bSYour Name 
162*5113495bSYour Name 
163*5113495bSYour Name 			The fragment number from the 802.11 header.
164*5113495bSYour Name 
165*5113495bSYour Name 
166*5113495bSYour Name 
167*5113495bSYour Name 			Note that the sequence number is embedded in the field:
168*5113495bSYour Name 			Reo_level_mpdu_frame_info. Rx_mpdu_desc_info_details.
169*5113495bSYour Name 			Mpdu_sequence_number
170*5113495bSYour Name 
171*5113495bSYour Name 
172*5113495bSYour Name 
173*5113495bSYour Name 			<legal all>
174*5113495bSYour Name 
175*5113495bSYour Name frameless_bar
176*5113495bSYour Name 
177*5113495bSYour Name 			When set, this SW monitor ring struct contains BAR info
178*5113495bSYour Name 			from a multi TID BAR frame. The original multi TID BAR frame
179*5113495bSYour Name 			itself contained all the REO info for the first TID, but all
180*5113495bSYour Name 			the subsequent TID info and their linkage to the REO
181*5113495bSYour Name 			descriptors is passed down as 'frameless' BAR info.
182*5113495bSYour Name 
183*5113495bSYour Name 
184*5113495bSYour Name 
185*5113495bSYour Name 			The only fields valid in this descriptor when this bit
186*5113495bSYour Name 			is within the
187*5113495bSYour Name 
188*5113495bSYour Name 			Reo_level_mpdu_frame_info:
189*5113495bSYour Name 
190*5113495bSYour Name 			   Within Rx_mpdu_desc_info_details:
191*5113495bSYour Name 
192*5113495bSYour Name 			Mpdu_Sequence_number
193*5113495bSYour Name 
194*5113495bSYour Name 			BAR_frame
195*5113495bSYour Name 
196*5113495bSYour Name 			Peer_meta_data
197*5113495bSYour Name 
198*5113495bSYour Name 			All other fields shall be set to 0.
199*5113495bSYour Name 
200*5113495bSYour Name 
201*5113495bSYour Name 
202*5113495bSYour Name 			<legal all>
203*5113495bSYour Name 
204*5113495bSYour Name status_buf_count
205*5113495bSYour Name 
206*5113495bSYour Name 			A count of status buffers used so far for the PPDU
207*5113495bSYour Name 			(either the PPDU that included the MPDU being pushed to SW
208*5113495bSYour Name 			if end_of_ppdu = 0, or the PPDU whose end is indicated
209*5113495bSYour Name 			through end_of_ppdu = 1)
210*5113495bSYour Name 
211*5113495bSYour Name end_of_ppdu
212*5113495bSYour Name 
213*5113495bSYour Name 			Pine RXDMA can be configured to generate a separate
214*5113495bSYour Name 			'SW_MONITOR_RING' descriptor at the end of a PPDU (either
215*5113495bSYour Name 			through an 'RX_PPDU_END' TLV or through an 'RX_FLUSH') to
216*5113495bSYour Name 			demarcate PPDUs.
217*5113495bSYour Name 
218*5113495bSYour Name 
219*5113495bSYour Name 
220*5113495bSYour Name 			For such a descriptor, this bit is set to 1 and fields
221*5113495bSYour Name 			Reo_level_mpdu_frame_info, mpdu_fragment_number and
222*5113495bSYour Name 			Frameless_bar are all set to 0.
223*5113495bSYour Name 
224*5113495bSYour Name 
225*5113495bSYour Name 
226*5113495bSYour Name 			Otherwise this bit is set to 0.
227*5113495bSYour Name 
228*5113495bSYour Name reserved_6a
229*5113495bSYour Name 
230*5113495bSYour Name 			<legal 0>
231*5113495bSYour Name 
232*5113495bSYour Name phy_ppdu_id
233*5113495bSYour Name 
234*5113495bSYour Name 			A PPDU counter value that PHY increments for every PPDU
235*5113495bSYour Name 			received
236*5113495bSYour Name 
237*5113495bSYour Name 			The counter value wraps around. Pine RXDMA can be
238*5113495bSYour Name 			configured to copy this from the RX_PPDU_START TLV for every
239*5113495bSYour Name 			output descriptor.
240*5113495bSYour Name 
241*5113495bSYour Name 
242*5113495bSYour Name 
243*5113495bSYour Name 			<legal all>
244*5113495bSYour Name 
245*5113495bSYour Name reserved_7a
246*5113495bSYour Name 
247*5113495bSYour Name 			<legal 0>
248*5113495bSYour Name 
249*5113495bSYour Name ring_id
250*5113495bSYour Name 
251*5113495bSYour Name 			Consumer: SW/REO/DEBUG
252*5113495bSYour Name 
253*5113495bSYour Name 			Producer: SRNG (of RXDMA)
254*5113495bSYour Name 
255*5113495bSYour Name 
256*5113495bSYour Name 
257*5113495bSYour Name 			For debugging.
258*5113495bSYour Name 
259*5113495bSYour Name 			This field is filled in by the SRNG module.
260*5113495bSYour Name 
261*5113495bSYour Name 			It help to identify the ring that is being looked <legal
262*5113495bSYour Name 			all>
263*5113495bSYour Name 
264*5113495bSYour Name looping_count
265*5113495bSYour Name 
266*5113495bSYour Name 			Consumer: SW/REO/DEBUG
267*5113495bSYour Name 
268*5113495bSYour Name 			Producer: SRNG (of RXDMA)
269*5113495bSYour Name 
270*5113495bSYour Name 
271*5113495bSYour Name 
272*5113495bSYour Name 			For debugging.
273*5113495bSYour Name 
274*5113495bSYour Name 			This field is filled in by the SRNG module.
275*5113495bSYour Name 
276*5113495bSYour Name 
277*5113495bSYour Name 
278*5113495bSYour Name 			A count value that indicates the number of times the
279*5113495bSYour Name 			producer of entries into this Ring has looped around the
280*5113495bSYour Name 			ring.
281*5113495bSYour Name 
282*5113495bSYour Name 			At initialization time, this value is set to 0. On the
283*5113495bSYour Name 			first loop, this value is set to 1. After the max value is
284*5113495bSYour Name 			reached allowed by the number of bits for this field, the
285*5113495bSYour Name 			count value continues with 0 again.
286*5113495bSYour Name 
287*5113495bSYour Name 
288*5113495bSYour Name 
289*5113495bSYour Name 			In case SW is the consumer of the ring entries, it can
290*5113495bSYour Name 			use this field to figure out up to where the producer of
291*5113495bSYour Name 			entries has created new entries. This eliminates the need to
292*5113495bSYour Name 			check where the head pointer' of the ring is located once
293*5113495bSYour Name 			the SW starts processing an interrupt indicating that new
294*5113495bSYour Name 			entries have been put into this ring...
295*5113495bSYour Name 
296*5113495bSYour Name 
297*5113495bSYour Name 
298*5113495bSYour Name 			Also note that SW if it wants only needs to look at the
299*5113495bSYour Name 			LSB bit of this count value.
300*5113495bSYour Name 
301*5113495bSYour Name 			<legal all>
302*5113495bSYour Name */
303*5113495bSYour Name 
304*5113495bSYour Name 
305*5113495bSYour Name  /* EXTERNAL REFERENCE : struct rx_mpdu_details reo_level_mpdu_frame_info */
306*5113495bSYour Name 
307*5113495bSYour Name 
308*5113495bSYour Name  /* EXTERNAL REFERENCE : struct buffer_addr_info msdu_link_desc_addr_info */
309*5113495bSYour Name 
310*5113495bSYour Name 
311*5113495bSYour Name /* Description		SW_MONITOR_RING_0_REO_LEVEL_MPDU_FRAME_INFO_MSDU_LINK_DESC_ADDR_INFO_BUFFER_ADDR_31_0
312*5113495bSYour Name 
313*5113495bSYour Name 			Address (lower 32 bits) of the MSDU buffer OR
314*5113495bSYour Name 			MSDU_EXTENSION descriptor OR Link Descriptor
315*5113495bSYour Name 
316*5113495bSYour Name 
317*5113495bSYour Name 
318*5113495bSYour Name 			In case of 'NULL' pointer, this field is set to 0
319*5113495bSYour Name 
320*5113495bSYour Name 			<legal all>
321*5113495bSYour Name */
322*5113495bSYour Name #define SW_MONITOR_RING_0_REO_LEVEL_MPDU_FRAME_INFO_MSDU_LINK_DESC_ADDR_INFO_BUFFER_ADDR_31_0_OFFSET 0x00000000
323*5113495bSYour Name #define SW_MONITOR_RING_0_REO_LEVEL_MPDU_FRAME_INFO_MSDU_LINK_DESC_ADDR_INFO_BUFFER_ADDR_31_0_LSB 0
324*5113495bSYour Name #define SW_MONITOR_RING_0_REO_LEVEL_MPDU_FRAME_INFO_MSDU_LINK_DESC_ADDR_INFO_BUFFER_ADDR_31_0_MASK 0xffffffff
325*5113495bSYour Name 
326*5113495bSYour Name /* Description		SW_MONITOR_RING_1_REO_LEVEL_MPDU_FRAME_INFO_MSDU_LINK_DESC_ADDR_INFO_BUFFER_ADDR_39_32
327*5113495bSYour Name 
328*5113495bSYour Name 			Address (upper 8 bits) of the MSDU buffer OR
329*5113495bSYour Name 			MSDU_EXTENSION descriptor OR Link Descriptor
330*5113495bSYour Name 
331*5113495bSYour Name 
332*5113495bSYour Name 
333*5113495bSYour Name 			In case of 'NULL' pointer, this field is set to 0
334*5113495bSYour Name 
335*5113495bSYour Name 			<legal all>
336*5113495bSYour Name */
337*5113495bSYour Name #define SW_MONITOR_RING_1_REO_LEVEL_MPDU_FRAME_INFO_MSDU_LINK_DESC_ADDR_INFO_BUFFER_ADDR_39_32_OFFSET 0x00000004
338*5113495bSYour Name #define SW_MONITOR_RING_1_REO_LEVEL_MPDU_FRAME_INFO_MSDU_LINK_DESC_ADDR_INFO_BUFFER_ADDR_39_32_LSB 0
339*5113495bSYour Name #define SW_MONITOR_RING_1_REO_LEVEL_MPDU_FRAME_INFO_MSDU_LINK_DESC_ADDR_INFO_BUFFER_ADDR_39_32_MASK 0x000000ff
340*5113495bSYour Name 
341*5113495bSYour Name /* Description		SW_MONITOR_RING_1_REO_LEVEL_MPDU_FRAME_INFO_MSDU_LINK_DESC_ADDR_INFO_RETURN_BUFFER_MANAGER
342*5113495bSYour Name 
343*5113495bSYour Name 			Consumer: WBM
344*5113495bSYour Name 
345*5113495bSYour Name 			Producer: SW/FW
346*5113495bSYour Name 
347*5113495bSYour Name 
348*5113495bSYour Name 
349*5113495bSYour Name 			In case of 'NULL' pointer, this field is set to 0
350*5113495bSYour Name 
351*5113495bSYour Name 
352*5113495bSYour Name 
353*5113495bSYour Name 			Indicates to which buffer manager the buffer OR
354*5113495bSYour Name 			MSDU_EXTENSION descriptor OR link descriptor that is being
355*5113495bSYour Name 			pointed to shall be returned after the frame has been
356*5113495bSYour Name 			processed. It is used by WBM for routing purposes.
357*5113495bSYour Name 
358*5113495bSYour Name 
359*5113495bSYour Name 
360*5113495bSYour Name 			<enum 0 WBM_IDLE_BUF_LIST> This buffer shall be returned
361*5113495bSYour Name 			to the WMB buffer idle list
362*5113495bSYour Name 
363*5113495bSYour Name 			<enum 1 WBM_IDLE_DESC_LIST> This buffer shall be
364*5113495bSYour Name 			returned to the WMB idle link descriptor idle list
365*5113495bSYour Name 
366*5113495bSYour Name 			<enum 2 FW_BM> This buffer shall be returned to the FW
367*5113495bSYour Name 
368*5113495bSYour Name 			<enum 3 SW0_BM> This buffer shall be returned to the SW,
369*5113495bSYour Name 			ring 0
370*5113495bSYour Name 
371*5113495bSYour Name 			<enum 4 SW1_BM> This buffer shall be returned to the SW,
372*5113495bSYour Name 			ring 1
373*5113495bSYour Name 
374*5113495bSYour Name 			<enum 5 SW2_BM> This buffer shall be returned to the SW,
375*5113495bSYour Name 			ring 2
376*5113495bSYour Name 
377*5113495bSYour Name 			<enum 6 SW3_BM> This buffer shall be returned to the SW,
378*5113495bSYour Name 			ring 3
379*5113495bSYour Name 
380*5113495bSYour Name 			<enum 7 SW4_BM> This buffer shall be returned to the SW,
381*5113495bSYour Name 			ring 4
382*5113495bSYour Name 
383*5113495bSYour Name 
384*5113495bSYour Name 
385*5113495bSYour Name 			<legal all>
386*5113495bSYour Name */
387*5113495bSYour Name #define SW_MONITOR_RING_1_REO_LEVEL_MPDU_FRAME_INFO_MSDU_LINK_DESC_ADDR_INFO_RETURN_BUFFER_MANAGER_OFFSET 0x00000004
388*5113495bSYour Name #define SW_MONITOR_RING_1_REO_LEVEL_MPDU_FRAME_INFO_MSDU_LINK_DESC_ADDR_INFO_RETURN_BUFFER_MANAGER_LSB 8
389*5113495bSYour Name #define SW_MONITOR_RING_1_REO_LEVEL_MPDU_FRAME_INFO_MSDU_LINK_DESC_ADDR_INFO_RETURN_BUFFER_MANAGER_MASK 0x00000700
390*5113495bSYour Name 
391*5113495bSYour Name /* Description		SW_MONITOR_RING_1_REO_LEVEL_MPDU_FRAME_INFO_MSDU_LINK_DESC_ADDR_INFO_SW_BUFFER_COOKIE
392*5113495bSYour Name 
393*5113495bSYour Name 			Cookie field exclusively used by SW.
394*5113495bSYour Name 
395*5113495bSYour Name 
396*5113495bSYour Name 
397*5113495bSYour Name 			In case of 'NULL' pointer, this field is set to 0
398*5113495bSYour Name 
399*5113495bSYour Name 
400*5113495bSYour Name 
401*5113495bSYour Name 			HW ignores the contents, accept that it passes the
402*5113495bSYour Name 			programmed value on to other descriptors together with the
403*5113495bSYour Name 			physical address
404*5113495bSYour Name 
405*5113495bSYour Name 
406*5113495bSYour Name 
407*5113495bSYour Name 			Field can be used by SW to for example associate the
408*5113495bSYour Name 			buffers physical address with the virtual address
409*5113495bSYour Name 
410*5113495bSYour Name 			The bit definitions as used by SW are within SW HLD
411*5113495bSYour Name 			specification
412*5113495bSYour Name 
413*5113495bSYour Name 
414*5113495bSYour Name 
415*5113495bSYour Name 			NOTE:
416*5113495bSYour Name 
417*5113495bSYour Name 			The three most significant bits can have a special
418*5113495bSYour Name 			meaning in case this struct is embedded in a TX_MPDU_DETAILS
419*5113495bSYour Name 			STRUCT, and field transmit_bw_restriction is set
420*5113495bSYour Name 
421*5113495bSYour Name 
422*5113495bSYour Name 
423*5113495bSYour Name 			In case of NON punctured transmission:
424*5113495bSYour Name 
425*5113495bSYour Name 			Sw_buffer_cookie[20:19] = 2'b00: 20 MHz TX only
426*5113495bSYour Name 
427*5113495bSYour Name 			Sw_buffer_cookie[20:19] = 2'b01: 40 MHz TX only
428*5113495bSYour Name 
429*5113495bSYour Name 			Sw_buffer_cookie[20:19] = 2'b10: 80 MHz TX only
430*5113495bSYour Name 
431*5113495bSYour Name 			Sw_buffer_cookie[20:19] = 2'b11: 160 MHz TX only
432*5113495bSYour Name 
433*5113495bSYour Name 
434*5113495bSYour Name 
435*5113495bSYour Name 			In case of punctured transmission:
436*5113495bSYour Name 
437*5113495bSYour Name 			Sw_buffer_cookie[20:18] = 3'b000: pattern 0 only
438*5113495bSYour Name 
439*5113495bSYour Name 			Sw_buffer_cookie[20:18] = 3'b001: pattern 1 only
440*5113495bSYour Name 
441*5113495bSYour Name 			Sw_buffer_cookie[20:18] = 3'b010: pattern 2 only
442*5113495bSYour Name 
443*5113495bSYour Name 			Sw_buffer_cookie[20:18] = 3'b011: pattern 3 only
444*5113495bSYour Name 
445*5113495bSYour Name 			Sw_buffer_cookie[20:18] = 3'b100: pattern 4 only
446*5113495bSYour Name 
447*5113495bSYour Name 			Sw_buffer_cookie[20:18] = 3'b101: pattern 5 only
448*5113495bSYour Name 
449*5113495bSYour Name 			Sw_buffer_cookie[20:18] = 3'b110: pattern 6 only
450*5113495bSYour Name 
451*5113495bSYour Name 			Sw_buffer_cookie[20:18] = 3'b111: pattern 7 only
452*5113495bSYour Name 
453*5113495bSYour Name 
454*5113495bSYour Name 
455*5113495bSYour Name 			Note: a punctured transmission is indicated by the
456*5113495bSYour Name 			presence of TLV TX_PUNCTURE_SETUP embedded in the scheduler
457*5113495bSYour Name 			TLV
458*5113495bSYour Name 
459*5113495bSYour Name 
460*5113495bSYour Name 
461*5113495bSYour Name 			<legal all>
462*5113495bSYour Name */
463*5113495bSYour Name #define SW_MONITOR_RING_1_REO_LEVEL_MPDU_FRAME_INFO_MSDU_LINK_DESC_ADDR_INFO_SW_BUFFER_COOKIE_OFFSET 0x00000004
464*5113495bSYour Name #define SW_MONITOR_RING_1_REO_LEVEL_MPDU_FRAME_INFO_MSDU_LINK_DESC_ADDR_INFO_SW_BUFFER_COOKIE_LSB 11
465*5113495bSYour Name #define SW_MONITOR_RING_1_REO_LEVEL_MPDU_FRAME_INFO_MSDU_LINK_DESC_ADDR_INFO_SW_BUFFER_COOKIE_MASK 0xfffff800
466*5113495bSYour Name 
467*5113495bSYour Name  /* EXTERNAL REFERENCE : struct rx_mpdu_desc_info rx_mpdu_desc_info_details */
468*5113495bSYour Name 
469*5113495bSYour Name 
470*5113495bSYour Name /* Description		SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_MSDU_COUNT
471*5113495bSYour Name 
472*5113495bSYour Name 			Consumer: REO/SW/FW
473*5113495bSYour Name 
474*5113495bSYour Name 			Producer: RXDMA
475*5113495bSYour Name 
476*5113495bSYour Name 
477*5113495bSYour Name 
478*5113495bSYour Name 			The number of MSDUs within the MPDU
479*5113495bSYour Name 
480*5113495bSYour Name 			<legal all>
481*5113495bSYour Name */
482*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_MSDU_COUNT_OFFSET 0x00000008
483*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_MSDU_COUNT_LSB 0
484*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_MSDU_COUNT_MASK 0x000000ff
485*5113495bSYour Name 
486*5113495bSYour Name /* Description		SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_MPDU_SEQUENCE_NUMBER
487*5113495bSYour Name 
488*5113495bSYour Name 			Consumer: REO/SW/FW
489*5113495bSYour Name 
490*5113495bSYour Name 			Producer: RXDMA
491*5113495bSYour Name 
492*5113495bSYour Name 
493*5113495bSYour Name 
494*5113495bSYour Name 			The field can have two different meanings based on the
495*5113495bSYour Name 			setting of field 'BAR_frame':
496*5113495bSYour Name 
497*5113495bSYour Name 
498*5113495bSYour Name 
499*5113495bSYour Name 			'BAR_frame' is NOT set:
500*5113495bSYour Name 
501*5113495bSYour Name 			The MPDU sequence number of the received frame.
502*5113495bSYour Name 
503*5113495bSYour Name 
504*5113495bSYour Name 
505*5113495bSYour Name 			'BAR_frame' is set.
506*5113495bSYour Name 
507*5113495bSYour Name 			The MPDU Start sequence number from the BAR frame
508*5113495bSYour Name 
509*5113495bSYour Name 			<legal all>
510*5113495bSYour Name */
511*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_MPDU_SEQUENCE_NUMBER_OFFSET 0x00000008
512*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_MPDU_SEQUENCE_NUMBER_LSB 8
513*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_MPDU_SEQUENCE_NUMBER_MASK 0x000fff00
514*5113495bSYour Name 
515*5113495bSYour Name /* Description		SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_FRAGMENT_FLAG
516*5113495bSYour Name 
517*5113495bSYour Name 			Consumer: REO/SW/FW
518*5113495bSYour Name 
519*5113495bSYour Name 			Producer: RXDMA
520*5113495bSYour Name 
521*5113495bSYour Name 
522*5113495bSYour Name 
523*5113495bSYour Name 			When set, this MPDU is a fragment and REO should forward
524*5113495bSYour Name 			this fragment MPDU to the REO destination ring without any
525*5113495bSYour Name 			reorder checks, pn checks or bitmap update. This implies
526*5113495bSYour Name 			that REO is forwarding the pointer to the MSDU link
527*5113495bSYour Name 			descriptor. The destination ring is coming from a
528*5113495bSYour Name 			programmable register setting in REO
529*5113495bSYour Name 
530*5113495bSYour Name 
531*5113495bSYour Name 
532*5113495bSYour Name 			<legal all>
533*5113495bSYour Name */
534*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_FRAGMENT_FLAG_OFFSET 0x00000008
535*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_FRAGMENT_FLAG_LSB 20
536*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_FRAGMENT_FLAG_MASK 0x00100000
537*5113495bSYour Name 
538*5113495bSYour Name /* Description		SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_MPDU_RETRY_BIT
539*5113495bSYour Name 
540*5113495bSYour Name 			Consumer: REO/SW/FW
541*5113495bSYour Name 
542*5113495bSYour Name 			Producer: RXDMA
543*5113495bSYour Name 
544*5113495bSYour Name 
545*5113495bSYour Name 
546*5113495bSYour Name 			The retry bit setting from the MPDU header of the
547*5113495bSYour Name 			received frame
548*5113495bSYour Name 
549*5113495bSYour Name 			<legal all>
550*5113495bSYour Name */
551*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_MPDU_RETRY_BIT_OFFSET 0x00000008
552*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_MPDU_RETRY_BIT_LSB 21
553*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_MPDU_RETRY_BIT_MASK 0x00200000
554*5113495bSYour Name 
555*5113495bSYour Name /* Description		SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_AMPDU_FLAG
556*5113495bSYour Name 
557*5113495bSYour Name 			Consumer: REO/SW/FW
558*5113495bSYour Name 
559*5113495bSYour Name 			Producer: RXDMA
560*5113495bSYour Name 
561*5113495bSYour Name 
562*5113495bSYour Name 
563*5113495bSYour Name 			When set, the MPDU was received as part of an A-MPDU.
564*5113495bSYour Name 
565*5113495bSYour Name 			<legal all>
566*5113495bSYour Name */
567*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_AMPDU_FLAG_OFFSET 0x00000008
568*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_AMPDU_FLAG_LSB 22
569*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_AMPDU_FLAG_MASK 0x00400000
570*5113495bSYour Name 
571*5113495bSYour Name /* Description		SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_BAR_FRAME
572*5113495bSYour Name 
573*5113495bSYour Name 			Consumer: REO/SW/FW
574*5113495bSYour Name 
575*5113495bSYour Name 			Producer: RXDMA
576*5113495bSYour Name 
577*5113495bSYour Name 
578*5113495bSYour Name 
579*5113495bSYour Name 			When set, the received frame is a BAR frame. After
580*5113495bSYour Name 			processing, this frame shall be pushed to SW or deleted.
581*5113495bSYour Name 
582*5113495bSYour Name 			<legal all>
583*5113495bSYour Name */
584*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_BAR_FRAME_OFFSET 0x00000008
585*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_BAR_FRAME_LSB 23
586*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_BAR_FRAME_MASK 0x00800000
587*5113495bSYour Name 
588*5113495bSYour Name /* Description		SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_PN_FIELDS_CONTAIN_VALID_INFO
589*5113495bSYour Name 
590*5113495bSYour Name 			Consumer: REO/SW/FW
591*5113495bSYour Name 
592*5113495bSYour Name 			Producer: RXDMA
593*5113495bSYour Name 
594*5113495bSYour Name 
595*5113495bSYour Name 
596*5113495bSYour Name 			Copied here by RXDMA from RX_MPDU_END
597*5113495bSYour Name 
598*5113495bSYour Name 			When not set, REO will Not perform a PN sequence number
599*5113495bSYour Name 			check
600*5113495bSYour Name */
601*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_PN_FIELDS_CONTAIN_VALID_INFO_OFFSET 0x00000008
602*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_PN_FIELDS_CONTAIN_VALID_INFO_LSB 24
603*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_PN_FIELDS_CONTAIN_VALID_INFO_MASK 0x01000000
604*5113495bSYour Name 
605*5113495bSYour Name /* Description		SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_SA_IS_VALID
606*5113495bSYour Name 
607*5113495bSYour Name 			When set, OLE found a valid SA entry for all MSDUs in
608*5113495bSYour Name 			this MPDU
609*5113495bSYour Name 
610*5113495bSYour Name 			<legal all>
611*5113495bSYour Name */
612*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_SA_IS_VALID_OFFSET 0x00000008
613*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_SA_IS_VALID_LSB 25
614*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_SA_IS_VALID_MASK 0x02000000
615*5113495bSYour Name 
616*5113495bSYour Name /* Description		SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_SA_IDX_TIMEOUT
617*5113495bSYour Name 
618*5113495bSYour Name 			When set, at least 1 MSDU within the MPDU has an
619*5113495bSYour Name 			unsuccessful MAC source address search due to the expiration
620*5113495bSYour Name 			of the search timer.
621*5113495bSYour Name 
622*5113495bSYour Name 			<legal all>
623*5113495bSYour Name */
624*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_SA_IDX_TIMEOUT_OFFSET 0x00000008
625*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_SA_IDX_TIMEOUT_LSB 26
626*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_SA_IDX_TIMEOUT_MASK 0x04000000
627*5113495bSYour Name 
628*5113495bSYour Name /* Description		SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_DA_IS_VALID
629*5113495bSYour Name 
630*5113495bSYour Name 			When set, OLE found a valid DA entry for all MSDUs in
631*5113495bSYour Name 			this MPDU
632*5113495bSYour Name 
633*5113495bSYour Name 			<legal all>
634*5113495bSYour Name */
635*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_DA_IS_VALID_OFFSET 0x00000008
636*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_DA_IS_VALID_LSB 27
637*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_DA_IS_VALID_MASK 0x08000000
638*5113495bSYour Name 
639*5113495bSYour Name /* Description		SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_DA_IS_MCBC
640*5113495bSYour Name 
641*5113495bSYour Name 			Field Only valid if da_is_valid is set
642*5113495bSYour Name 
643*5113495bSYour Name 
644*5113495bSYour Name 
645*5113495bSYour Name 			When set, at least one of the DA addresses is a
646*5113495bSYour Name 			Multicast or Broadcast address.
647*5113495bSYour Name 
648*5113495bSYour Name 			<legal all>
649*5113495bSYour Name */
650*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_DA_IS_MCBC_OFFSET 0x00000008
651*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_DA_IS_MCBC_LSB 28
652*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_DA_IS_MCBC_MASK 0x10000000
653*5113495bSYour Name 
654*5113495bSYour Name /* Description		SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_DA_IDX_TIMEOUT
655*5113495bSYour Name 
656*5113495bSYour Name 			When set, at least 1 MSDU within the MPDU has an
657*5113495bSYour Name 			unsuccessful MAC destination address search due to the
658*5113495bSYour Name 			expiration of the search timer.
659*5113495bSYour Name 
660*5113495bSYour Name 			<legal all>
661*5113495bSYour Name */
662*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_DA_IDX_TIMEOUT_OFFSET 0x00000008
663*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_DA_IDX_TIMEOUT_LSB 29
664*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_DA_IDX_TIMEOUT_MASK 0x20000000
665*5113495bSYour Name 
666*5113495bSYour Name /* Description		SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_RAW_MPDU
667*5113495bSYour Name 
668*5113495bSYour Name 			Field only valid when first_msdu_in_mpdu_flag is set.
669*5113495bSYour Name 
670*5113495bSYour Name 
671*5113495bSYour Name 
672*5113495bSYour Name 			When set, the contents in the MSDU buffer contains a
673*5113495bSYour Name 			'RAW' MPDU. This 'RAW' MPDU might be spread out over
674*5113495bSYour Name 			multiple MSDU buffers.
675*5113495bSYour Name 
676*5113495bSYour Name 			<legal all>
677*5113495bSYour Name */
678*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_RAW_MPDU_OFFSET 0x00000008
679*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_RAW_MPDU_LSB 30
680*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_RAW_MPDU_MASK 0x40000000
681*5113495bSYour Name 
682*5113495bSYour Name /* Description		SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_MORE_FRAGMENT_FLAG
683*5113495bSYour Name 
684*5113495bSYour Name 			The More Fragment bit setting from the MPDU header of
685*5113495bSYour Name 			the received frame
686*5113495bSYour Name 
687*5113495bSYour Name 
688*5113495bSYour Name 
689*5113495bSYour Name 			<legal all>
690*5113495bSYour Name */
691*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_MORE_FRAGMENT_FLAG_OFFSET 0x00000008
692*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_MORE_FRAGMENT_FLAG_LSB 31
693*5113495bSYour Name #define SW_MONITOR_RING_2_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_MORE_FRAGMENT_FLAG_MASK 0x80000000
694*5113495bSYour Name 
695*5113495bSYour Name /* Description		SW_MONITOR_RING_3_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_PEER_META_DATA
696*5113495bSYour Name 
697*5113495bSYour Name 			Meta data that SW has programmed in the Peer table entry
698*5113495bSYour Name 			of the transmitting STA.
699*5113495bSYour Name 
700*5113495bSYour Name 			<legal all>
701*5113495bSYour Name */
702*5113495bSYour Name #define SW_MONITOR_RING_3_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_PEER_META_DATA_OFFSET 0x0000000c
703*5113495bSYour Name #define SW_MONITOR_RING_3_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_PEER_META_DATA_LSB 0
704*5113495bSYour Name #define SW_MONITOR_RING_3_REO_LEVEL_MPDU_FRAME_INFO_RX_MPDU_DESC_INFO_DETAILS_PEER_META_DATA_MASK 0xffffffff
705*5113495bSYour Name 
706*5113495bSYour Name  /* EXTERNAL REFERENCE : struct buffer_addr_info status_buff_addr_info */
707*5113495bSYour Name 
708*5113495bSYour Name 
709*5113495bSYour Name /* Description		SW_MONITOR_RING_4_STATUS_BUFF_ADDR_INFO_BUFFER_ADDR_31_0
710*5113495bSYour Name 
711*5113495bSYour Name 			Address (lower 32 bits) of the MSDU buffer OR
712*5113495bSYour Name 			MSDU_EXTENSION descriptor OR Link Descriptor
713*5113495bSYour Name 
714*5113495bSYour Name 
715*5113495bSYour Name 
716*5113495bSYour Name 			In case of 'NULL' pointer, this field is set to 0
717*5113495bSYour Name 
718*5113495bSYour Name 			<legal all>
719*5113495bSYour Name */
720*5113495bSYour Name #define SW_MONITOR_RING_4_STATUS_BUFF_ADDR_INFO_BUFFER_ADDR_31_0_OFFSET 0x00000010
721*5113495bSYour Name #define SW_MONITOR_RING_4_STATUS_BUFF_ADDR_INFO_BUFFER_ADDR_31_0_LSB 0
722*5113495bSYour Name #define SW_MONITOR_RING_4_STATUS_BUFF_ADDR_INFO_BUFFER_ADDR_31_0_MASK 0xffffffff
723*5113495bSYour Name 
724*5113495bSYour Name /* Description		SW_MONITOR_RING_5_STATUS_BUFF_ADDR_INFO_BUFFER_ADDR_39_32
725*5113495bSYour Name 
726*5113495bSYour Name 			Address (upper 8 bits) of the MSDU buffer OR
727*5113495bSYour Name 			MSDU_EXTENSION descriptor OR Link Descriptor
728*5113495bSYour Name 
729*5113495bSYour Name 
730*5113495bSYour Name 
731*5113495bSYour Name 			In case of 'NULL' pointer, this field is set to 0
732*5113495bSYour Name 
733*5113495bSYour Name 			<legal all>
734*5113495bSYour Name */
735*5113495bSYour Name #define SW_MONITOR_RING_5_STATUS_BUFF_ADDR_INFO_BUFFER_ADDR_39_32_OFFSET 0x00000014
736*5113495bSYour Name #define SW_MONITOR_RING_5_STATUS_BUFF_ADDR_INFO_BUFFER_ADDR_39_32_LSB 0
737*5113495bSYour Name #define SW_MONITOR_RING_5_STATUS_BUFF_ADDR_INFO_BUFFER_ADDR_39_32_MASK 0x000000ff
738*5113495bSYour Name 
739*5113495bSYour Name /* Description		SW_MONITOR_RING_5_STATUS_BUFF_ADDR_INFO_RETURN_BUFFER_MANAGER
740*5113495bSYour Name 
741*5113495bSYour Name 			Consumer: WBM
742*5113495bSYour Name 
743*5113495bSYour Name 			Producer: SW/FW
744*5113495bSYour Name 
745*5113495bSYour Name 
746*5113495bSYour Name 
747*5113495bSYour Name 			In case of 'NULL' pointer, this field is set to 0
748*5113495bSYour Name 
749*5113495bSYour Name 
750*5113495bSYour Name 
751*5113495bSYour Name 			Indicates to which buffer manager the buffer OR
752*5113495bSYour Name 			MSDU_EXTENSION descriptor OR link descriptor that is being
753*5113495bSYour Name 			pointed to shall be returned after the frame has been
754*5113495bSYour Name 			processed. It is used by WBM for routing purposes.
755*5113495bSYour Name 
756*5113495bSYour Name 
757*5113495bSYour Name 
758*5113495bSYour Name 			<enum 0 WBM_IDLE_BUF_LIST> This buffer shall be returned
759*5113495bSYour Name 			to the WMB buffer idle list
760*5113495bSYour Name 
761*5113495bSYour Name 			<enum 1 WBM_IDLE_DESC_LIST> This buffer shall be
762*5113495bSYour Name 			returned to the WMB idle link descriptor idle list
763*5113495bSYour Name 
764*5113495bSYour Name 			<enum 2 FW_BM> This buffer shall be returned to the FW
765*5113495bSYour Name 
766*5113495bSYour Name 			<enum 3 SW0_BM> This buffer shall be returned to the SW,
767*5113495bSYour Name 			ring 0
768*5113495bSYour Name 
769*5113495bSYour Name 			<enum 4 SW1_BM> This buffer shall be returned to the SW,
770*5113495bSYour Name 			ring 1
771*5113495bSYour Name 
772*5113495bSYour Name 			<enum 5 SW2_BM> This buffer shall be returned to the SW,
773*5113495bSYour Name 			ring 2
774*5113495bSYour Name 
775*5113495bSYour Name 			<enum 6 SW3_BM> This buffer shall be returned to the SW,
776*5113495bSYour Name 			ring 3
777*5113495bSYour Name 
778*5113495bSYour Name 			<enum 7 SW4_BM> This buffer shall be returned to the SW,
779*5113495bSYour Name 			ring 4
780*5113495bSYour Name 
781*5113495bSYour Name 
782*5113495bSYour Name 
783*5113495bSYour Name 			<legal all>
784*5113495bSYour Name */
785*5113495bSYour Name #define SW_MONITOR_RING_5_STATUS_BUFF_ADDR_INFO_RETURN_BUFFER_MANAGER_OFFSET 0x00000014
786*5113495bSYour Name #define SW_MONITOR_RING_5_STATUS_BUFF_ADDR_INFO_RETURN_BUFFER_MANAGER_LSB 8
787*5113495bSYour Name #define SW_MONITOR_RING_5_STATUS_BUFF_ADDR_INFO_RETURN_BUFFER_MANAGER_MASK 0x00000700
788*5113495bSYour Name 
789*5113495bSYour Name /* Description		SW_MONITOR_RING_5_STATUS_BUFF_ADDR_INFO_SW_BUFFER_COOKIE
790*5113495bSYour Name 
791*5113495bSYour Name 			Cookie field exclusively used by SW.
792*5113495bSYour Name 
793*5113495bSYour Name 
794*5113495bSYour Name 
795*5113495bSYour Name 			In case of 'NULL' pointer, this field is set to 0
796*5113495bSYour Name 
797*5113495bSYour Name 
798*5113495bSYour Name 
799*5113495bSYour Name 			HW ignores the contents, accept that it passes the
800*5113495bSYour Name 			programmed value on to other descriptors together with the
801*5113495bSYour Name 			physical address
802*5113495bSYour Name 
803*5113495bSYour Name 
804*5113495bSYour Name 
805*5113495bSYour Name 			Field can be used by SW to for example associate the
806*5113495bSYour Name 			buffers physical address with the virtual address
807*5113495bSYour Name 
808*5113495bSYour Name 			The bit definitions as used by SW are within SW HLD
809*5113495bSYour Name 			specification
810*5113495bSYour Name 
811*5113495bSYour Name 
812*5113495bSYour Name 
813*5113495bSYour Name 			NOTE:
814*5113495bSYour Name 
815*5113495bSYour Name 			The three most significant bits can have a special
816*5113495bSYour Name 			meaning in case this struct is embedded in a TX_MPDU_DETAILS
817*5113495bSYour Name 			STRUCT, and field transmit_bw_restriction is set
818*5113495bSYour Name 
819*5113495bSYour Name 
820*5113495bSYour Name 
821*5113495bSYour Name 			In case of NON punctured transmission:
822*5113495bSYour Name 
823*5113495bSYour Name 			Sw_buffer_cookie[20:19] = 2'b00: 20 MHz TX only
824*5113495bSYour Name 
825*5113495bSYour Name 			Sw_buffer_cookie[20:19] = 2'b01: 40 MHz TX only
826*5113495bSYour Name 
827*5113495bSYour Name 			Sw_buffer_cookie[20:19] = 2'b10: 80 MHz TX only
828*5113495bSYour Name 
829*5113495bSYour Name 			Sw_buffer_cookie[20:19] = 2'b11: 160 MHz TX only
830*5113495bSYour Name 
831*5113495bSYour Name 
832*5113495bSYour Name 
833*5113495bSYour Name 			In case of punctured transmission:
834*5113495bSYour Name 
835*5113495bSYour Name 			Sw_buffer_cookie[20:18] = 3'b000: pattern 0 only
836*5113495bSYour Name 
837*5113495bSYour Name 			Sw_buffer_cookie[20:18] = 3'b001: pattern 1 only
838*5113495bSYour Name 
839*5113495bSYour Name 			Sw_buffer_cookie[20:18] = 3'b010: pattern 2 only
840*5113495bSYour Name 
841*5113495bSYour Name 			Sw_buffer_cookie[20:18] = 3'b011: pattern 3 only
842*5113495bSYour Name 
843*5113495bSYour Name 			Sw_buffer_cookie[20:18] = 3'b100: pattern 4 only
844*5113495bSYour Name 
845*5113495bSYour Name 			Sw_buffer_cookie[20:18] = 3'b101: pattern 5 only
846*5113495bSYour Name 
847*5113495bSYour Name 			Sw_buffer_cookie[20:18] = 3'b110: pattern 6 only
848*5113495bSYour Name 
849*5113495bSYour Name 			Sw_buffer_cookie[20:18] = 3'b111: pattern 7 only
850*5113495bSYour Name 
851*5113495bSYour Name 
852*5113495bSYour Name 
853*5113495bSYour Name 			Note: a punctured transmission is indicated by the
854*5113495bSYour Name 			presence of TLV TX_PUNCTURE_SETUP embedded in the scheduler
855*5113495bSYour Name 			TLV
856*5113495bSYour Name 
857*5113495bSYour Name 
858*5113495bSYour Name 
859*5113495bSYour Name 			<legal all>
860*5113495bSYour Name */
861*5113495bSYour Name #define SW_MONITOR_RING_5_STATUS_BUFF_ADDR_INFO_SW_BUFFER_COOKIE_OFFSET 0x00000014
862*5113495bSYour Name #define SW_MONITOR_RING_5_STATUS_BUFF_ADDR_INFO_SW_BUFFER_COOKIE_LSB 11
863*5113495bSYour Name #define SW_MONITOR_RING_5_STATUS_BUFF_ADDR_INFO_SW_BUFFER_COOKIE_MASK 0xfffff800
864*5113495bSYour Name 
865*5113495bSYour Name /* Description		SW_MONITOR_RING_6_RXDMA_PUSH_REASON
866*5113495bSYour Name 
867*5113495bSYour Name 			Indicates why RXDMA pushed the frame to this ring
868*5113495bSYour Name 
869*5113495bSYour Name 
870*5113495bSYour Name 
871*5113495bSYour Name 			<enum 0 rxdma_error_detected> RXDMA detected an error an
872*5113495bSYour Name 			pushed this frame to this queue
873*5113495bSYour Name 
874*5113495bSYour Name 			<enum 1 rxdma_routing_instruction> RXDMA pushed the
875*5113495bSYour Name 			frame to this queue per received routing instructions. No
876*5113495bSYour Name 			error within RXDMA was detected
877*5113495bSYour Name 
878*5113495bSYour Name 			<enum 2 rxdma_rx_flush> RXDMA received an RX_FLUSH. As a
879*5113495bSYour Name 			result the MSDU link descriptor might not have the
880*5113495bSYour Name 			last_msdu_in_mpdu_flag set, but instead WBM might just see a
881*5113495bSYour Name 			NULL pointer in the MSDU link descriptor. This is to be
882*5113495bSYour Name 			considered a normal condition for this scenario.
883*5113495bSYour Name 
884*5113495bSYour Name 
885*5113495bSYour Name 
886*5113495bSYour Name 			<legal 0 - 2>
887*5113495bSYour Name */
888*5113495bSYour Name #define SW_MONITOR_RING_6_RXDMA_PUSH_REASON_OFFSET                   0x00000018
889*5113495bSYour Name #define SW_MONITOR_RING_6_RXDMA_PUSH_REASON_LSB                      0
890*5113495bSYour Name #define SW_MONITOR_RING_6_RXDMA_PUSH_REASON_MASK                     0x00000003
891*5113495bSYour Name 
892*5113495bSYour Name /* Description		SW_MONITOR_RING_6_RXDMA_ERROR_CODE
893*5113495bSYour Name 
894*5113495bSYour Name 			Field only valid when rxdma_push_reason is set to
895*5113495bSYour Name 			'rxdma_error_detected.'
896*5113495bSYour Name 
897*5113495bSYour Name 
898*5113495bSYour Name 
899*5113495bSYour Name 			<enum 0 rxdma_overflow_err>MPDU frame is not complete
900*5113495bSYour Name 			due to a FIFO overflow error in RXPCU.
901*5113495bSYour Name 
902*5113495bSYour Name 			<enum 1 rxdma_mpdu_length_err>MPDU frame is not complete
903*5113495bSYour Name 			due to receiving incomplete MPDU from the PHY
904*5113495bSYour Name 
905*5113495bSYour Name 
906*5113495bSYour Name 			<enum 3 rxdma_decrypt_err>CRYPTO reported a decryption
907*5113495bSYour Name 			error or CRYPTO received an encrypted frame, but did not get
908*5113495bSYour Name 			a valid corresponding key id in the peer entry.
909*5113495bSYour Name 
910*5113495bSYour Name 			<enum 4 rxdma_tkip_mic_err>CRYPTO reported a TKIP MIC
911*5113495bSYour Name 			error
912*5113495bSYour Name 
913*5113495bSYour Name 			<enum 5 rxdma_unecrypted_err>CRYPTO reported an
914*5113495bSYour Name 			unencrypted frame error when encrypted was expected
915*5113495bSYour Name 
916*5113495bSYour Name 			<enum 6 rxdma_msdu_len_err>RX OLE reported an MSDU
917*5113495bSYour Name 			length error
918*5113495bSYour Name 
919*5113495bSYour Name 			<enum 7 rxdma_msdu_limit_err>RX OLE reported that max
920*5113495bSYour Name 			number of MSDUs allowed in an MPDU got exceeded
921*5113495bSYour Name 
922*5113495bSYour Name 			<enum 8 rxdma_wifi_parse_err>RX OLE reported a parsing
923*5113495bSYour Name 			error
924*5113495bSYour Name 
925*5113495bSYour Name 			<enum 9 rxdma_amsdu_parse_err>RX OLE reported an A-MSDU
926*5113495bSYour Name 			parsing error
927*5113495bSYour Name 
928*5113495bSYour Name 			<enum 10 rxdma_sa_timeout_err>RX OLE reported a timeout
929*5113495bSYour Name 			during SA search
930*5113495bSYour Name 
931*5113495bSYour Name 			<enum 11 rxdma_da_timeout_err>RX OLE reported a timeout
932*5113495bSYour Name 			during DA search
933*5113495bSYour Name 
934*5113495bSYour Name 			<enum 12 rxdma_flow_timeout_err>RX OLE reported a
935*5113495bSYour Name 			timeout during flow search
936*5113495bSYour Name 
937*5113495bSYour Name 			<enum 13 rxdma_flush_request>RXDMA received a flush
938*5113495bSYour Name 			request
939*5113495bSYour Name 
940*5113495bSYour Name 			<enum 14 rxdma_amsdu_fragment_err>Rx PCU reported A-MSDU
941*5113495bSYour Name 			present as well as a fragmented MPDU. A-MSDU defragmentation
942*5113495bSYour Name 			is not supported in Lithium SW so this is treated as an
943*5113495bSYour Name 			error.
944*5113495bSYour Name */
945*5113495bSYour Name #define SW_MONITOR_RING_6_RXDMA_ERROR_CODE_OFFSET                    0x00000018
946*5113495bSYour Name #define SW_MONITOR_RING_6_RXDMA_ERROR_CODE_LSB                       2
947*5113495bSYour Name #define SW_MONITOR_RING_6_RXDMA_ERROR_CODE_MASK                      0x0000007c
948*5113495bSYour Name 
949*5113495bSYour Name /* Description		SW_MONITOR_RING_6_MPDU_FRAGMENT_NUMBER
950*5113495bSYour Name 
951*5113495bSYour Name 			Field only valid when Reo_level_mpdu_frame_info.
952*5113495bSYour Name 			Rx_mpdu_desc_info_details.Fragment_flag is set and
953*5113495bSYour Name 			end_of_ppdu is set to 0.
954*5113495bSYour Name 
955*5113495bSYour Name 
956*5113495bSYour Name 
957*5113495bSYour Name 			The fragment number from the 802.11 header.
958*5113495bSYour Name 
959*5113495bSYour Name 
960*5113495bSYour Name 
961*5113495bSYour Name 			Note that the sequence number is embedded in the field:
962*5113495bSYour Name 			Reo_level_mpdu_frame_info. Rx_mpdu_desc_info_details.
963*5113495bSYour Name 			Mpdu_sequence_number
964*5113495bSYour Name 
965*5113495bSYour Name 
966*5113495bSYour Name 
967*5113495bSYour Name 			<legal all>
968*5113495bSYour Name */
969*5113495bSYour Name #define SW_MONITOR_RING_6_MPDU_FRAGMENT_NUMBER_OFFSET                0x00000018
970*5113495bSYour Name #define SW_MONITOR_RING_6_MPDU_FRAGMENT_NUMBER_LSB                   7
971*5113495bSYour Name #define SW_MONITOR_RING_6_MPDU_FRAGMENT_NUMBER_MASK                  0x00000780
972*5113495bSYour Name 
973*5113495bSYour Name /* Description		SW_MONITOR_RING_6_FRAMELESS_BAR
974*5113495bSYour Name 
975*5113495bSYour Name 			When set, this SW monitor ring struct contains BAR info
976*5113495bSYour Name 			from a multi TID BAR frame. The original multi TID BAR frame
977*5113495bSYour Name 			itself contained all the REO info for the first TID, but all
978*5113495bSYour Name 			the subsequent TID info and their linkage to the REO
979*5113495bSYour Name 			descriptors is passed down as 'frameless' BAR info.
980*5113495bSYour Name 
981*5113495bSYour Name 
982*5113495bSYour Name 
983*5113495bSYour Name 			The only fields valid in this descriptor when this bit
984*5113495bSYour Name 			is within the
985*5113495bSYour Name 
986*5113495bSYour Name 			Reo_level_mpdu_frame_info:
987*5113495bSYour Name 
988*5113495bSYour Name 			   Within Rx_mpdu_desc_info_details:
989*5113495bSYour Name 
990*5113495bSYour Name 			Mpdu_Sequence_number
991*5113495bSYour Name 
992*5113495bSYour Name 			BAR_frame
993*5113495bSYour Name 
994*5113495bSYour Name 			Peer_meta_data
995*5113495bSYour Name 
996*5113495bSYour Name 			All other fields shall be set to 0.
997*5113495bSYour Name 
998*5113495bSYour Name 
999*5113495bSYour Name 
1000*5113495bSYour Name 			<legal all>
1001*5113495bSYour Name */
1002*5113495bSYour Name #define SW_MONITOR_RING_6_FRAMELESS_BAR_OFFSET                       0x00000018
1003*5113495bSYour Name #define SW_MONITOR_RING_6_FRAMELESS_BAR_LSB                          11
1004*5113495bSYour Name #define SW_MONITOR_RING_6_FRAMELESS_BAR_MASK                         0x00000800
1005*5113495bSYour Name 
1006*5113495bSYour Name /* Description		SW_MONITOR_RING_6_STATUS_BUF_COUNT
1007*5113495bSYour Name 
1008*5113495bSYour Name 			A count of status buffers used so far for the PPDU
1009*5113495bSYour Name 			(either the PPDU that included the MPDU being pushed to SW
1010*5113495bSYour Name 			if end_of_ppdu = 0, or the PPDU whose end is indicated
1011*5113495bSYour Name 			through end_of_ppdu = 1)
1012*5113495bSYour Name */
1013*5113495bSYour Name #define SW_MONITOR_RING_6_STATUS_BUF_COUNT_OFFSET                    0x00000018
1014*5113495bSYour Name #define SW_MONITOR_RING_6_STATUS_BUF_COUNT_LSB                       12
1015*5113495bSYour Name #define SW_MONITOR_RING_6_STATUS_BUF_COUNT_MASK                      0x0000f000
1016*5113495bSYour Name 
1017*5113495bSYour Name /* Description		SW_MONITOR_RING_6_END_OF_PPDU
1018*5113495bSYour Name 
1019*5113495bSYour Name 			Pine RXDMA can be configured to generate a separate
1020*5113495bSYour Name 			'SW_MONITOR_RING' descriptor at the end of a PPDU (either
1021*5113495bSYour Name 			through an 'RX_PPDU_END' TLV or through an 'RX_FLUSH') to
1022*5113495bSYour Name 			demarcate PPDUs.
1023*5113495bSYour Name 
1024*5113495bSYour Name 
1025*5113495bSYour Name 
1026*5113495bSYour Name 			For such a descriptor, this bit is set to 1 and fields
1027*5113495bSYour Name 			Reo_level_mpdu_frame_info, mpdu_fragment_number and
1028*5113495bSYour Name 			Frameless_bar are all set to 0.
1029*5113495bSYour Name 
1030*5113495bSYour Name 
1031*5113495bSYour Name 
1032*5113495bSYour Name 			Otherwise this bit is set to 0.
1033*5113495bSYour Name */
1034*5113495bSYour Name #define SW_MONITOR_RING_6_END_OF_PPDU_OFFSET                         0x00000018
1035*5113495bSYour Name #define SW_MONITOR_RING_6_END_OF_PPDU_LSB                            16
1036*5113495bSYour Name #define SW_MONITOR_RING_6_END_OF_PPDU_MASK                           0x00010000
1037*5113495bSYour Name 
1038*5113495bSYour Name /* Description		SW_MONITOR_RING_6_RESERVED_6A
1039*5113495bSYour Name 
1040*5113495bSYour Name 			<legal 0>
1041*5113495bSYour Name */
1042*5113495bSYour Name #define SW_MONITOR_RING_6_RESERVED_6A_OFFSET                         0x00000018
1043*5113495bSYour Name #define SW_MONITOR_RING_6_RESERVED_6A_LSB                            17
1044*5113495bSYour Name #define SW_MONITOR_RING_6_RESERVED_6A_MASK                           0xfffe0000
1045*5113495bSYour Name 
1046*5113495bSYour Name /* Description		SW_MONITOR_RING_7_PHY_PPDU_ID
1047*5113495bSYour Name 
1048*5113495bSYour Name 			A PPDU counter value that PHY increments for every PPDU
1049*5113495bSYour Name 			received
1050*5113495bSYour Name 
1051*5113495bSYour Name 			The counter value wraps around. Pine RXDMA can be
1052*5113495bSYour Name 			configured to copy this from the RX_PPDU_START TLV for every
1053*5113495bSYour Name 			output descriptor.
1054*5113495bSYour Name 
1055*5113495bSYour Name 
1056*5113495bSYour Name 
1057*5113495bSYour Name 			<legal all>
1058*5113495bSYour Name */
1059*5113495bSYour Name #define SW_MONITOR_RING_7_PHY_PPDU_ID_OFFSET                         0x0000001c
1060*5113495bSYour Name #define SW_MONITOR_RING_7_PHY_PPDU_ID_LSB                            0
1061*5113495bSYour Name #define SW_MONITOR_RING_7_PHY_PPDU_ID_MASK                           0x0000ffff
1062*5113495bSYour Name 
1063*5113495bSYour Name /* Description		SW_MONITOR_RING_7_RESERVED_7A
1064*5113495bSYour Name 
1065*5113495bSYour Name 			<legal 0>
1066*5113495bSYour Name */
1067*5113495bSYour Name #define SW_MONITOR_RING_7_RESERVED_7A_OFFSET                         0x0000001c
1068*5113495bSYour Name #define SW_MONITOR_RING_7_RESERVED_7A_LSB                            16
1069*5113495bSYour Name #define SW_MONITOR_RING_7_RESERVED_7A_MASK                           0x000f0000
1070*5113495bSYour Name 
1071*5113495bSYour Name /* Description		SW_MONITOR_RING_7_RING_ID
1072*5113495bSYour Name 
1073*5113495bSYour Name 			Consumer: SW/REO/DEBUG
1074*5113495bSYour Name 
1075*5113495bSYour Name 			Producer: SRNG (of RXDMA)
1076*5113495bSYour Name 
1077*5113495bSYour Name 
1078*5113495bSYour Name 
1079*5113495bSYour Name 			For debugging.
1080*5113495bSYour Name 
1081*5113495bSYour Name 			This field is filled in by the SRNG module.
1082*5113495bSYour Name 
1083*5113495bSYour Name 			It help to identify the ring that is being looked <legal
1084*5113495bSYour Name 			all>
1085*5113495bSYour Name */
1086*5113495bSYour Name #define SW_MONITOR_RING_7_RING_ID_OFFSET                             0x0000001c
1087*5113495bSYour Name #define SW_MONITOR_RING_7_RING_ID_LSB                                20
1088*5113495bSYour Name #define SW_MONITOR_RING_7_RING_ID_MASK                               0x0ff00000
1089*5113495bSYour Name 
1090*5113495bSYour Name /* Description		SW_MONITOR_RING_7_LOOPING_COUNT
1091*5113495bSYour Name 
1092*5113495bSYour Name 			Consumer: SW/REO/DEBUG
1093*5113495bSYour Name 
1094*5113495bSYour Name 			Producer: SRNG (of RXDMA)
1095*5113495bSYour Name 
1096*5113495bSYour Name 
1097*5113495bSYour Name 
1098*5113495bSYour Name 			For debugging.
1099*5113495bSYour Name 
1100*5113495bSYour Name 			This field is filled in by the SRNG module.
1101*5113495bSYour Name 
1102*5113495bSYour Name 
1103*5113495bSYour Name 
1104*5113495bSYour Name 			A count value that indicates the number of times the
1105*5113495bSYour Name 			producer of entries into this Ring has looped around the
1106*5113495bSYour Name 			ring.
1107*5113495bSYour Name 
1108*5113495bSYour Name 			At initialization time, this value is set to 0. On the
1109*5113495bSYour Name 			first loop, this value is set to 1. After the max value is
1110*5113495bSYour Name 			reached allowed by the number of bits for this field, the
1111*5113495bSYour Name 			count value continues with 0 again.
1112*5113495bSYour Name 
1113*5113495bSYour Name 
1114*5113495bSYour Name 
1115*5113495bSYour Name 			In case SW is the consumer of the ring entries, it can
1116*5113495bSYour Name 			use this field to figure out up to where the producer of
1117*5113495bSYour Name 			entries has created new entries. This eliminates the need to
1118*5113495bSYour Name 			check where the head pointer' of the ring is located once
1119*5113495bSYour Name 			the SW starts processing an interrupt indicating that new
1120*5113495bSYour Name 			entries have been put into this ring...
1121*5113495bSYour Name 
1122*5113495bSYour Name 
1123*5113495bSYour Name 
1124*5113495bSYour Name 			Also note that SW if it wants only needs to look at the
1125*5113495bSYour Name 			LSB bit of this count value.
1126*5113495bSYour Name 
1127*5113495bSYour Name 			<legal all>
1128*5113495bSYour Name */
1129*5113495bSYour Name #define SW_MONITOR_RING_7_LOOPING_COUNT_OFFSET                       0x0000001c
1130*5113495bSYour Name #define SW_MONITOR_RING_7_LOOPING_COUNT_LSB                          28
1131*5113495bSYour Name #define SW_MONITOR_RING_7_LOOPING_COUNT_MASK                         0xf0000000
1132*5113495bSYour Name 
1133*5113495bSYour Name 
1134*5113495bSYour Name #endif // _SW_MONITOR_RING_H_
1135