xref: /wlan-driver/fw-api/hw/qca6290/11ax/v2/he_sig_a_su_info.h (revision 5113495b16420b49004c444715d2daae2066e7dc) 
1*5113495bSYour Name /*
2*5113495bSYour Name  * Copyright (c) 2016-2018 The Linux Foundation. All rights reserved.
3*5113495bSYour Name  *
4*5113495bSYour Name  * Permission to use, copy, modify, and/or distribute this software for
5*5113495bSYour Name  * any purpose with or without fee is hereby granted, provided that the
6*5113495bSYour Name  * above copyright notice and this permission notice appear in all
7*5113495bSYour Name  * copies.
8*5113495bSYour Name  *
9*5113495bSYour Name  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
10*5113495bSYour Name  * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
11*5113495bSYour Name  * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
12*5113495bSYour Name  * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
13*5113495bSYour Name  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
14*5113495bSYour Name  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
15*5113495bSYour Name  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
16*5113495bSYour Name  * PERFORMANCE OF THIS SOFTWARE.
17*5113495bSYour Name  */
18*5113495bSYour Name 
19*5113495bSYour Name #ifndef _HE_SIG_A_SU_INFO_H_
20*5113495bSYour Name #define _HE_SIG_A_SU_INFO_H_
21*5113495bSYour Name #if !defined(__ASSEMBLER__)
22*5113495bSYour Name #endif
23*5113495bSYour Name 
24*5113495bSYour Name 
25*5113495bSYour Name // ################ START SUMMARY #################
26*5113495bSYour Name //
27*5113495bSYour Name //	Dword	Fields
28*5113495bSYour Name //	0	format_indication[0], beam_change[1], dl_ul_flag[2], transmit_mcs[6:3], dcm[7], bss_color_id[13:8], reserved_0a[14], spatial_reuse[18:15], transmit_bw[20:19], cp_ltf_size[22:21], nsts[25:23], reserved_0b[31:26]
29*5113495bSYour Name //	1	txop_duration[6:0], coding[7], ldpc_extra_symbol[8], stbc[9], txbf[10], packet_extension_a_factor[12:11], packet_extension_pe_disambiguity[13], reserved_1a[14], doppler_indication[15], crc[19:16], tail[25:20], dot11ax_su_extended[26], dot11ax_ext_ru_size[30:27], rx_ndp[31]
30*5113495bSYour Name //
31*5113495bSYour Name // ################ END SUMMARY #################
32*5113495bSYour Name 
33*5113495bSYour Name #define NUM_OF_DWORDS_HE_SIG_A_SU_INFO 2
34*5113495bSYour Name 
35*5113495bSYour Name struct he_sig_a_su_info {
36*5113495bSYour Name              uint32_t format_indication               :  1, //[0]
37*5113495bSYour Name                       beam_change                     :  1, //[1]
38*5113495bSYour Name                       dl_ul_flag                      :  1, //[2]
39*5113495bSYour Name                       transmit_mcs                    :  4, //[6:3]
40*5113495bSYour Name                       dcm                             :  1, //[7]
41*5113495bSYour Name                       bss_color_id                    :  6, //[13:8]
42*5113495bSYour Name                       reserved_0a                     :  1, //[14]
43*5113495bSYour Name                       spatial_reuse                   :  4, //[18:15]
44*5113495bSYour Name                       transmit_bw                     :  2, //[20:19]
45*5113495bSYour Name                       cp_ltf_size                     :  2, //[22:21]
46*5113495bSYour Name                       nsts                            :  3, //[25:23]
47*5113495bSYour Name                       reserved_0b                     :  6; //[31:26]
48*5113495bSYour Name              uint32_t txop_duration                   :  7, //[6:0]
49*5113495bSYour Name                       coding                          :  1, //[7]
50*5113495bSYour Name                       ldpc_extra_symbol               :  1, //[8]
51*5113495bSYour Name                       stbc                            :  1, //[9]
52*5113495bSYour Name                       txbf                            :  1, //[10]
53*5113495bSYour Name                       packet_extension_a_factor       :  2, //[12:11]
54*5113495bSYour Name                       packet_extension_pe_disambiguity:  1, //[13]
55*5113495bSYour Name                       reserved_1a                     :  1, //[14]
56*5113495bSYour Name                       doppler_indication              :  1, //[15]
57*5113495bSYour Name                       crc                             :  4, //[19:16]
58*5113495bSYour Name                       tail                            :  6, //[25:20]
59*5113495bSYour Name                       dot11ax_su_extended             :  1, //[26]
60*5113495bSYour Name                       dot11ax_ext_ru_size             :  4, //[30:27]
61*5113495bSYour Name                       rx_ndp                          :  1; //[31]
62*5113495bSYour Name };
63*5113495bSYour Name 
64*5113495bSYour Name /*
65*5113495bSYour Name 
66*5113495bSYour Name format_indication
67*5113495bSYour Name 
68*5113495bSYour Name 			<enum 0 HE_SIGA_FORMAT_HE_TRIG>
69*5113495bSYour Name 
70*5113495bSYour Name 			<enum 1 HE_SIGA_FORMAT_SU_OR_EXT_SU>
71*5113495bSYour Name 
72*5113495bSYour Name 			<legal all>
73*5113495bSYour Name 
74*5113495bSYour Name beam_change
75*5113495bSYour Name 
76*5113495bSYour Name 			Indicates whether spatial mapping is changed between
77*5113495bSYour Name 			legacy and HE portion of preamble. If not, channel
78*5113495bSYour Name 			estimation can include legacy preamble to improve accuracy
79*5113495bSYour Name 
80*5113495bSYour Name 			<legal all>
81*5113495bSYour Name 
82*5113495bSYour Name dl_ul_flag
83*5113495bSYour Name 
84*5113495bSYour Name 			Differentiates between DL and UL transmission
85*5113495bSYour Name 
86*5113495bSYour Name 
87*5113495bSYour Name 
88*5113495bSYour Name 			<enum 0 DL_UL_FLAG_IS_DL_OR_TDLS>
89*5113495bSYour Name 
90*5113495bSYour Name 			<enum 1 DL_UL_FLAG_IS_UL>
91*5113495bSYour Name 
92*5113495bSYour Name 			<legal all>
93*5113495bSYour Name 
94*5113495bSYour Name transmit_mcs
95*5113495bSYour Name 
96*5113495bSYour Name 			Indicates the data MCS
97*5113495bSYour Name 
98*5113495bSYour Name 
99*5113495bSYour Name 
100*5113495bSYour Name 			Field Used by MAC HW
101*5113495bSYour Name 
102*5113495bSYour Name 			<legal all>
103*5113495bSYour Name 
104*5113495bSYour Name dcm
105*5113495bSYour Name 
106*5113495bSYour Name 
107*5113495bSYour Name 			0: No DCM
108*5113495bSYour Name 
109*5113495bSYour Name 			1:DCM
110*5113495bSYour Name 
111*5113495bSYour Name 			<legal all>
112*5113495bSYour Name 
113*5113495bSYour Name bss_color_id
114*5113495bSYour Name 
115*5113495bSYour Name 			BSS color ID
116*5113495bSYour Name 
117*5113495bSYour Name 
118*5113495bSYour Name 
119*5113495bSYour Name 			Field Used by MAC HW
120*5113495bSYour Name 
121*5113495bSYour Name 			<legal all>
122*5113495bSYour Name 
123*5113495bSYour Name reserved_0a
124*5113495bSYour Name 
125*5113495bSYour Name 			Note: spec indicates this shall be set to 1
126*5113495bSYour Name 
127*5113495bSYour Name 			<legal 1>
128*5113495bSYour Name 
129*5113495bSYour Name spatial_reuse
130*5113495bSYour Name 
131*5113495bSYour Name 			Spatial reuse
132*5113495bSYour Name 
133*5113495bSYour Name 
134*5113495bSYour Name 
135*5113495bSYour Name 			For 20MHz one SR field corresponding to entire 20MHz
136*5113495bSYour Name 			(other 3 fields indicate identical values)
137*5113495bSYour Name 
138*5113495bSYour Name 			For 40MHz two SR fields for each 20MHz (other 2 fields
139*5113495bSYour Name 			indicate identical values)
140*5113495bSYour Name 
141*5113495bSYour Name 			For 80MHz four SR fields for each 20MHz
142*5113495bSYour Name 
143*5113495bSYour Name 			For 160MHz four SR fields for each 40MHz
144*5113495bSYour Name 
145*5113495bSYour Name 			<legal all>
146*5113495bSYour Name 
147*5113495bSYour Name transmit_bw
148*5113495bSYour Name 
149*5113495bSYour Name 			Bandwidth of the PPDU.
150*5113495bSYour Name 
151*5113495bSYour Name 
152*5113495bSYour Name 
153*5113495bSYour Name 			For HE SU PPDU
154*5113495bSYour Name 
155*5113495bSYour Name 
156*5113495bSYour Name 			<enum 0 HE_SIG_A_BW20> 20 Mhz
157*5113495bSYour Name 
158*5113495bSYour Name 			<enum 1 HE_SIG_A_BW40> 40 Mhz
159*5113495bSYour Name 
160*5113495bSYour Name 			<enum 2 HE_SIG_A_BW80> 80 Mhz
161*5113495bSYour Name 
162*5113495bSYour Name 			<enum 3 HE_SIG_A_BW160> 160 MHz or 80+80 MHz
163*5113495bSYour Name 
164*5113495bSYour Name 
165*5113495bSYour Name 
166*5113495bSYour Name 			For HE Extended Range SU PPDU
167*5113495bSYour Name 
168*5113495bSYour Name 			Set to 0 for 242-tone RU
169*5113495bSYour Name 			 Set to 1 for right 106-tone RU within the primary 20 MHz
170*5113495bSYour Name 
171*5113495bSYour Name 
172*5113495bSYour Name 
173*5113495bSYour Name 			On RX side, Field Used by MAC HW
174*5113495bSYour Name 
175*5113495bSYour Name 			<legal all>
176*5113495bSYour Name 
177*5113495bSYour Name cp_ltf_size
178*5113495bSYour Name 
179*5113495bSYour Name 			Indicates the CP and HE-LTF type
180*5113495bSYour Name 
181*5113495bSYour Name 
182*5113495bSYour Name 			<legal all>
183*5113495bSYour Name 
184*5113495bSYour Name nsts
185*5113495bSYour Name 
186*5113495bSYour Name 
187*5113495bSYour Name 
188*5113495bSYour Name 
189*5113495bSYour Name 			For HE SU PPDU
190*5113495bSYour Name 
191*5113495bSYour Name 
192*5113495bSYour Name 
193*5113495bSYour Name 			For HE Extended Range PPDU
194*5113495bSYour Name 
195*5113495bSYour Name 			<legal all>
196*5113495bSYour Name 
197*5113495bSYour Name reserved_0b
198*5113495bSYour Name 
199*5113495bSYour Name 			<legal 0>
200*5113495bSYour Name 
201*5113495bSYour Name txop_duration
202*5113495bSYour Name 
203*5113495bSYour Name 			Indicates the remaining time in the current TXOP
204*5113495bSYour Name 
205*5113495bSYour Name 
206*5113495bSYour Name 
207*5113495bSYour Name 			Field Used by MAC HW
208*5113495bSYour Name 
209*5113495bSYour Name 			 <legal all>
210*5113495bSYour Name 
211*5113495bSYour Name coding
212*5113495bSYour Name 
213*5113495bSYour Name 			Distinguishes between BCC and LDPC coding.
214*5113495bSYour Name 
215*5113495bSYour Name 
216*5113495bSYour Name 
217*5113495bSYour Name 			0: BCC
218*5113495bSYour Name 
219*5113495bSYour Name 			1: LDPC
220*5113495bSYour Name 
221*5113495bSYour Name 			<legal all>
222*5113495bSYour Name 
223*5113495bSYour Name ldpc_extra_symbol
224*5113495bSYour Name 
225*5113495bSYour Name 			If LDPC,
226*5113495bSYour Name 
227*5113495bSYour Name 			  0: LDPC extra symbol not present
228*5113495bSYour Name 
229*5113495bSYour Name 			  1: LDPC extra symbol present
230*5113495bSYour Name 
231*5113495bSYour Name 			Else
232*5113495bSYour Name 
233*5113495bSYour Name 			  Set to 1
234*5113495bSYour Name 
235*5113495bSYour Name 			<legal all>
236*5113495bSYour Name 
237*5113495bSYour Name stbc
238*5113495bSYour Name 
239*5113495bSYour Name 			Indicates whether STBC is applied
240*5113495bSYour Name 
241*5113495bSYour Name 			0: No STBC
242*5113495bSYour Name 
243*5113495bSYour Name 			1: STBC
244*5113495bSYour Name 
245*5113495bSYour Name 			<legal all>
246*5113495bSYour Name 
247*5113495bSYour Name txbf
248*5113495bSYour Name 
249*5113495bSYour Name 			Indicates whether beamforming is applied
250*5113495bSYour Name 
251*5113495bSYour Name 			0: No beamforming
252*5113495bSYour Name 
253*5113495bSYour Name 			1: beamforming
254*5113495bSYour Name 
255*5113495bSYour Name 			<legal all>
256*5113495bSYour Name 
257*5113495bSYour Name packet_extension_a_factor
258*5113495bSYour Name 
259*5113495bSYour Name 			Common trigger info
260*5113495bSYour Name 
261*5113495bSYour Name 
262*5113495bSYour Name 
263*5113495bSYour Name 			the packet extension duration of the trigger-based PPDU
264*5113495bSYour Name 			response with these two bits indicating the a-factor
265*5113495bSYour Name 
266*5113495bSYour Name 
267*5113495bSYour Name 
268*5113495bSYour Name 			<enum 0 a_factor_4>
269*5113495bSYour Name 
270*5113495bSYour Name 			<enum 1 a_factor_1>
271*5113495bSYour Name 
272*5113495bSYour Name 			<enum 2 a_factor_2>
273*5113495bSYour Name 
274*5113495bSYour Name 			<enum 3 a_factor_3>
275*5113495bSYour Name 
276*5113495bSYour Name 
277*5113495bSYour Name 
278*5113495bSYour Name 			<legal all>
279*5113495bSYour Name 
280*5113495bSYour Name packet_extension_pe_disambiguity
281*5113495bSYour Name 
282*5113495bSYour Name 			Common trigger info
283*5113495bSYour Name 
284*5113495bSYour Name 
285*5113495bSYour Name 
286*5113495bSYour Name 			the packet extension duration of the trigger-based PPDU
287*5113495bSYour Name 			response with this bit indicating the PE-Disambiguity
288*5113495bSYour Name 
289*5113495bSYour Name 			<legal all>
290*5113495bSYour Name 
291*5113495bSYour Name reserved_1a
292*5113495bSYour Name 
293*5113495bSYour Name 			Note: per standard, set to 1
294*5113495bSYour Name 
295*5113495bSYour Name 			<legal 1>
296*5113495bSYour Name 
297*5113495bSYour Name doppler_indication
298*5113495bSYour Name 
299*5113495bSYour Name 			0: No Doppler support
300*5113495bSYour Name 
301*5113495bSYour Name 			1: Doppler support
302*5113495bSYour Name 
303*5113495bSYour Name 			<legal all>
304*5113495bSYour Name 
305*5113495bSYour Name crc
306*5113495bSYour Name 
307*5113495bSYour Name 			CRC for HE-SIG-A contents.
308*5113495bSYour Name 
309*5113495bSYour Name 			<legal all>
310*5113495bSYour Name 
311*5113495bSYour Name tail
312*5113495bSYour Name 
313*5113495bSYour Name 			<legal 0>
314*5113495bSYour Name 
315*5113495bSYour Name dot11ax_su_extended
316*5113495bSYour Name 
317*5113495bSYour Name 			TX side:
318*5113495bSYour Name 
319*5113495bSYour Name 			Set to 0
320*5113495bSYour Name 
321*5113495bSYour Name 
322*5113495bSYour Name 
323*5113495bSYour Name 			RX side:
324*5113495bSYour Name 
325*5113495bSYour Name 			On RX side, evaluated by MAC HW. This is the only way
326*5113495bSYour Name 			for MAC RX to know that this was an HE_SIG_A_SU received in
327*5113495bSYour Name 			'extended' format
328*5113495bSYour Name 
329*5113495bSYour Name 
330*5113495bSYour Name 
331*5113495bSYour Name 
332*5113495bSYour Name 			<legal all>
333*5113495bSYour Name 
334*5113495bSYour Name dot11ax_ext_ru_size
335*5113495bSYour Name 
336*5113495bSYour Name 			TX side:
337*5113495bSYour Name 
338*5113495bSYour Name 			Set to 0
339*5113495bSYour Name 
340*5113495bSYour Name 
341*5113495bSYour Name 
342*5113495bSYour Name 			RX side:
343*5113495bSYour Name 
344*5113495bSYour Name 			Field only contains valid info when dot11ax_su_extended
345*5113495bSYour Name 			is set.
346*5113495bSYour Name 
347*5113495bSYour Name 
348*5113495bSYour Name 
349*5113495bSYour Name 			On RX side, evaluated by MAC HW. This is the only way
350*5113495bSYour Name 			for MAC RX to know what the number of based RUs was in this
351*5113495bSYour Name 			extended range reception. It is used by the MAC to determine
352*5113495bSYour Name 			the RU size for the response...
353*5113495bSYour Name 
354*5113495bSYour Name 			<legal all>
355*5113495bSYour Name 
356*5113495bSYour Name rx_ndp
357*5113495bSYour Name 
358*5113495bSYour Name 			TX side:
359*5113495bSYour Name 
360*5113495bSYour Name 			Set to 0
361*5113495bSYour Name 
362*5113495bSYour Name 
363*5113495bSYour Name 
364*5113495bSYour Name 			RX side:Valid on RX side only, and looked at by MAC HW
365*5113495bSYour Name 
366*5113495bSYour Name 
367*5113495bSYour Name 
368*5113495bSYour Name 			When set, PHY has received (expected) NDP frame
369*5113495bSYour Name 
370*5113495bSYour Name 			<legal all>
371*5113495bSYour Name */
372*5113495bSYour Name 
373*5113495bSYour Name 
374*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_0_FORMAT_INDICATION
375*5113495bSYour Name 
376*5113495bSYour Name 			<enum 0 HE_SIGA_FORMAT_HE_TRIG>
377*5113495bSYour Name 
378*5113495bSYour Name 			<enum 1 HE_SIGA_FORMAT_SU_OR_EXT_SU>
379*5113495bSYour Name 
380*5113495bSYour Name 			<legal all>
381*5113495bSYour Name */
382*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_FORMAT_INDICATION_OFFSET                  0x00000000
383*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_FORMAT_INDICATION_LSB                     0
384*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_FORMAT_INDICATION_MASK                    0x00000001
385*5113495bSYour Name 
386*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_0_BEAM_CHANGE
387*5113495bSYour Name 
388*5113495bSYour Name 			Indicates whether spatial mapping is changed between
389*5113495bSYour Name 			legacy and HE portion of preamble. If not, channel
390*5113495bSYour Name 			estimation can include legacy preamble to improve accuracy
391*5113495bSYour Name 
392*5113495bSYour Name 			<legal all>
393*5113495bSYour Name */
394*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_BEAM_CHANGE_OFFSET                        0x00000000
395*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_BEAM_CHANGE_LSB                           1
396*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_BEAM_CHANGE_MASK                          0x00000002
397*5113495bSYour Name 
398*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_0_DL_UL_FLAG
399*5113495bSYour Name 
400*5113495bSYour Name 			Differentiates between DL and UL transmission
401*5113495bSYour Name 
402*5113495bSYour Name 
403*5113495bSYour Name 
404*5113495bSYour Name 			<enum 0 DL_UL_FLAG_IS_DL_OR_TDLS>
405*5113495bSYour Name 
406*5113495bSYour Name 			<enum 1 DL_UL_FLAG_IS_UL>
407*5113495bSYour Name 
408*5113495bSYour Name 			<legal all>
409*5113495bSYour Name */
410*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_DL_UL_FLAG_OFFSET                         0x00000000
411*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_DL_UL_FLAG_LSB                            2
412*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_DL_UL_FLAG_MASK                           0x00000004
413*5113495bSYour Name 
414*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_0_TRANSMIT_MCS
415*5113495bSYour Name 
416*5113495bSYour Name 			Indicates the data MCS
417*5113495bSYour Name 
418*5113495bSYour Name 
419*5113495bSYour Name 
420*5113495bSYour Name 			Field Used by MAC HW
421*5113495bSYour Name 
422*5113495bSYour Name 			<legal all>
423*5113495bSYour Name */
424*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_TRANSMIT_MCS_OFFSET                       0x00000000
425*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_TRANSMIT_MCS_LSB                          3
426*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_TRANSMIT_MCS_MASK                         0x00000078
427*5113495bSYour Name 
428*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_0_DCM
429*5113495bSYour Name 
430*5113495bSYour Name 
431*5113495bSYour Name 			0: No DCM
432*5113495bSYour Name 
433*5113495bSYour Name 			1:DCM
434*5113495bSYour Name 
435*5113495bSYour Name 			<legal all>
436*5113495bSYour Name */
437*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_DCM_OFFSET                                0x00000000
438*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_DCM_LSB                                   7
439*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_DCM_MASK                                  0x00000080
440*5113495bSYour Name 
441*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_0_BSS_COLOR_ID
442*5113495bSYour Name 
443*5113495bSYour Name 			BSS color ID
444*5113495bSYour Name 
445*5113495bSYour Name 
446*5113495bSYour Name 
447*5113495bSYour Name 			Field Used by MAC HW
448*5113495bSYour Name 
449*5113495bSYour Name 			<legal all>
450*5113495bSYour Name */
451*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_BSS_COLOR_ID_OFFSET                       0x00000000
452*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_BSS_COLOR_ID_LSB                          8
453*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_BSS_COLOR_ID_MASK                         0x00003f00
454*5113495bSYour Name 
455*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_0_RESERVED_0A
456*5113495bSYour Name 
457*5113495bSYour Name 			Note: spec indicates this shall be set to 1
458*5113495bSYour Name 
459*5113495bSYour Name 			<legal 1>
460*5113495bSYour Name */
461*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_RESERVED_0A_OFFSET                        0x00000000
462*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_RESERVED_0A_LSB                           14
463*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_RESERVED_0A_MASK                          0x00004000
464*5113495bSYour Name 
465*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_0_SPATIAL_REUSE
466*5113495bSYour Name 
467*5113495bSYour Name 			Spatial reuse
468*5113495bSYour Name 
469*5113495bSYour Name 
470*5113495bSYour Name 
471*5113495bSYour Name 			For 20MHz one SR field corresponding to entire 20MHz
472*5113495bSYour Name 			(other 3 fields indicate identical values)
473*5113495bSYour Name 
474*5113495bSYour Name 			For 40MHz two SR fields for each 20MHz (other 2 fields
475*5113495bSYour Name 			indicate identical values)
476*5113495bSYour Name 
477*5113495bSYour Name 			For 80MHz four SR fields for each 20MHz
478*5113495bSYour Name 
479*5113495bSYour Name 			For 160MHz four SR fields for each 40MHz
480*5113495bSYour Name 
481*5113495bSYour Name 			<legal all>
482*5113495bSYour Name */
483*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_SPATIAL_REUSE_OFFSET                      0x00000000
484*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_SPATIAL_REUSE_LSB                         15
485*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_SPATIAL_REUSE_MASK                        0x00078000
486*5113495bSYour Name 
487*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_0_TRANSMIT_BW
488*5113495bSYour Name 
489*5113495bSYour Name 			Bandwidth of the PPDU.
490*5113495bSYour Name 
491*5113495bSYour Name 
492*5113495bSYour Name 
493*5113495bSYour Name 			For HE SU PPDU
494*5113495bSYour Name 
495*5113495bSYour Name 
496*5113495bSYour Name 			<enum 0 HE_SIG_A_BW20> 20 Mhz
497*5113495bSYour Name 
498*5113495bSYour Name 			<enum 1 HE_SIG_A_BW40> 40 Mhz
499*5113495bSYour Name 
500*5113495bSYour Name 			<enum 2 HE_SIG_A_BW80> 80 Mhz
501*5113495bSYour Name 
502*5113495bSYour Name 			<enum 3 HE_SIG_A_BW160> 160 MHz or 80+80 MHz
503*5113495bSYour Name 
504*5113495bSYour Name 
505*5113495bSYour Name 
506*5113495bSYour Name 			For HE Extended Range SU PPDU
507*5113495bSYour Name 
508*5113495bSYour Name 			Set to 0 for 242-tone RU
509*5113495bSYour Name 			 Set to 1 for right 106-tone RU within the primary 20 MHz
510*5113495bSYour Name 
511*5113495bSYour Name 
512*5113495bSYour Name 
513*5113495bSYour Name 			On RX side, Field Used by MAC HW
514*5113495bSYour Name 
515*5113495bSYour Name 			<legal all>
516*5113495bSYour Name */
517*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_TRANSMIT_BW_OFFSET                        0x00000000
518*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_TRANSMIT_BW_LSB                           19
519*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_TRANSMIT_BW_MASK                          0x00180000
520*5113495bSYour Name 
521*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_0_CP_LTF_SIZE
522*5113495bSYour Name 
523*5113495bSYour Name 			Indicates the CP and HE-LTF type
524*5113495bSYour Name 
525*5113495bSYour Name 			<legal all>
526*5113495bSYour Name */
527*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_CP_LTF_SIZE_OFFSET                        0x00000000
528*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_CP_LTF_SIZE_LSB                           21
529*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_CP_LTF_SIZE_MASK                          0x00600000
530*5113495bSYour Name 
531*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_0_NSTS
532*5113495bSYour Name 
533*5113495bSYour Name 
534*5113495bSYour Name 
535*5113495bSYour Name 
536*5113495bSYour Name 			For HE SU PPDU
537*5113495bSYour Name 
538*5113495bSYour Name 
539*5113495bSYour Name 
540*5113495bSYour Name 			For HE Extended Range PPDU
541*5113495bSYour Name 
542*5113495bSYour Name 			<legal all>
543*5113495bSYour Name */
544*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_NSTS_OFFSET                               0x00000000
545*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_NSTS_LSB                                  23
546*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_NSTS_MASK                                 0x03800000
547*5113495bSYour Name 
548*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_0_RESERVED_0B
549*5113495bSYour Name 
550*5113495bSYour Name 			<legal 0>
551*5113495bSYour Name */
552*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_RESERVED_0B_OFFSET                        0x00000000
553*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_RESERVED_0B_LSB                           26
554*5113495bSYour Name #define HE_SIG_A_SU_INFO_0_RESERVED_0B_MASK                          0xfc000000
555*5113495bSYour Name 
556*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_1_TXOP_DURATION
557*5113495bSYour Name 
558*5113495bSYour Name 			Indicates the remaining time in the current TXOP
559*5113495bSYour Name 
560*5113495bSYour Name 
561*5113495bSYour Name 
562*5113495bSYour Name 			Field Used by MAC HW
563*5113495bSYour Name 
564*5113495bSYour Name 			 <legal all>
565*5113495bSYour Name */
566*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_TXOP_DURATION_OFFSET                      0x00000004
567*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_TXOP_DURATION_LSB                         0
568*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_TXOP_DURATION_MASK                        0x0000007f
569*5113495bSYour Name 
570*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_1_CODING
571*5113495bSYour Name 
572*5113495bSYour Name 			Distinguishes between BCC and LDPC coding.
573*5113495bSYour Name 
574*5113495bSYour Name 
575*5113495bSYour Name 
576*5113495bSYour Name 			0: BCC
577*5113495bSYour Name 
578*5113495bSYour Name 			1: LDPC
579*5113495bSYour Name 
580*5113495bSYour Name 			<legal all>
581*5113495bSYour Name */
582*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_CODING_OFFSET                             0x00000004
583*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_CODING_LSB                                7
584*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_CODING_MASK                               0x00000080
585*5113495bSYour Name 
586*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_1_LDPC_EXTRA_SYMBOL
587*5113495bSYour Name 
588*5113495bSYour Name 			If LDPC,
589*5113495bSYour Name 
590*5113495bSYour Name 			  0: LDPC extra symbol not present
591*5113495bSYour Name 
592*5113495bSYour Name 			  1: LDPC extra symbol present
593*5113495bSYour Name 
594*5113495bSYour Name 			Else
595*5113495bSYour Name 
596*5113495bSYour Name 			  Set to 1
597*5113495bSYour Name 
598*5113495bSYour Name 			<legal all>
599*5113495bSYour Name */
600*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_LDPC_EXTRA_SYMBOL_OFFSET                  0x00000004
601*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_LDPC_EXTRA_SYMBOL_LSB                     8
602*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_LDPC_EXTRA_SYMBOL_MASK                    0x00000100
603*5113495bSYour Name 
604*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_1_STBC
605*5113495bSYour Name 
606*5113495bSYour Name 			Indicates whether STBC is applied
607*5113495bSYour Name 
608*5113495bSYour Name 			0: No STBC
609*5113495bSYour Name 
610*5113495bSYour Name 			1: STBC
611*5113495bSYour Name 
612*5113495bSYour Name 			<legal all>
613*5113495bSYour Name */
614*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_STBC_OFFSET                               0x00000004
615*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_STBC_LSB                                  9
616*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_STBC_MASK                                 0x00000200
617*5113495bSYour Name 
618*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_1_TXBF
619*5113495bSYour Name 
620*5113495bSYour Name 			Indicates whether beamforming is applied
621*5113495bSYour Name 
622*5113495bSYour Name 			0: No beamforming
623*5113495bSYour Name 
624*5113495bSYour Name 			1: beamforming
625*5113495bSYour Name 
626*5113495bSYour Name 			<legal all>
627*5113495bSYour Name */
628*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_TXBF_OFFSET                               0x00000004
629*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_TXBF_LSB                                  10
630*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_TXBF_MASK                                 0x00000400
631*5113495bSYour Name 
632*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_1_PACKET_EXTENSION_A_FACTOR
633*5113495bSYour Name 
634*5113495bSYour Name 			Common trigger info
635*5113495bSYour Name 
636*5113495bSYour Name 
637*5113495bSYour Name 
638*5113495bSYour Name 			the packet extension duration of the trigger-based PPDU
639*5113495bSYour Name 			response with these two bits indicating the a-factor
640*5113495bSYour Name 
641*5113495bSYour Name 
642*5113495bSYour Name 
643*5113495bSYour Name 			<enum 0 a_factor_4>
644*5113495bSYour Name 
645*5113495bSYour Name 			<enum 1 a_factor_1>
646*5113495bSYour Name 
647*5113495bSYour Name 			<enum 2 a_factor_2>
648*5113495bSYour Name 
649*5113495bSYour Name 			<enum 3 a_factor_3>
650*5113495bSYour Name 
651*5113495bSYour Name 
652*5113495bSYour Name 
653*5113495bSYour Name 			<legal all>
654*5113495bSYour Name */
655*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_PACKET_EXTENSION_A_FACTOR_OFFSET          0x00000004
656*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_PACKET_EXTENSION_A_FACTOR_LSB             11
657*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_PACKET_EXTENSION_A_FACTOR_MASK            0x00001800
658*5113495bSYour Name 
659*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_1_PACKET_EXTENSION_PE_DISAMBIGUITY
660*5113495bSYour Name 
661*5113495bSYour Name 			Common trigger info
662*5113495bSYour Name 
663*5113495bSYour Name 
664*5113495bSYour Name 
665*5113495bSYour Name 			the packet extension duration of the trigger-based PPDU
666*5113495bSYour Name 			response with this bit indicating the PE-Disambiguity
667*5113495bSYour Name 
668*5113495bSYour Name 			<legal all>
669*5113495bSYour Name */
670*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_PACKET_EXTENSION_PE_DISAMBIGUITY_OFFSET   0x00000004
671*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_PACKET_EXTENSION_PE_DISAMBIGUITY_LSB      13
672*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_PACKET_EXTENSION_PE_DISAMBIGUITY_MASK     0x00002000
673*5113495bSYour Name 
674*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_1_RESERVED_1A
675*5113495bSYour Name 
676*5113495bSYour Name 			Note: per standard, set to 1
677*5113495bSYour Name 
678*5113495bSYour Name 			<legal 1>
679*5113495bSYour Name */
680*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_RESERVED_1A_OFFSET                        0x00000004
681*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_RESERVED_1A_LSB                           14
682*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_RESERVED_1A_MASK                          0x00004000
683*5113495bSYour Name 
684*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_1_DOPPLER_INDICATION
685*5113495bSYour Name 
686*5113495bSYour Name 			0: No Doppler support
687*5113495bSYour Name 
688*5113495bSYour Name 			1: Doppler support
689*5113495bSYour Name 
690*5113495bSYour Name 			<legal all>
691*5113495bSYour Name */
692*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_DOPPLER_INDICATION_OFFSET                 0x00000004
693*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_DOPPLER_INDICATION_LSB                    15
694*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_DOPPLER_INDICATION_MASK                   0x00008000
695*5113495bSYour Name 
696*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_1_CRC
697*5113495bSYour Name 
698*5113495bSYour Name 			CRC for HE-SIG-A contents.
699*5113495bSYour Name 
700*5113495bSYour Name 			<legal all>
701*5113495bSYour Name */
702*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_CRC_OFFSET                                0x00000004
703*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_CRC_LSB                                   16
704*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_CRC_MASK                                  0x000f0000
705*5113495bSYour Name 
706*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_1_TAIL
707*5113495bSYour Name 
708*5113495bSYour Name 			<legal 0>
709*5113495bSYour Name */
710*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_TAIL_OFFSET                               0x00000004
711*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_TAIL_LSB                                  20
712*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_TAIL_MASK                                 0x03f00000
713*5113495bSYour Name 
714*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_1_DOT11AX_SU_EXTENDED
715*5113495bSYour Name 
716*5113495bSYour Name 			TX side:
717*5113495bSYour Name 
718*5113495bSYour Name 			Set to 0
719*5113495bSYour Name 
720*5113495bSYour Name 
721*5113495bSYour Name 
722*5113495bSYour Name 			RX side:
723*5113495bSYour Name 
724*5113495bSYour Name 			On RX side, evaluated by MAC HW. This is the only way
725*5113495bSYour Name 			for MAC RX to know that this was an HE_SIG_A_SU received in
726*5113495bSYour Name 			'extended' format
727*5113495bSYour Name 
728*5113495bSYour Name 
729*5113495bSYour Name 
730*5113495bSYour Name 
731*5113495bSYour Name 			<legal all>
732*5113495bSYour Name */
733*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_DOT11AX_SU_EXTENDED_OFFSET                0x00000004
734*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_DOT11AX_SU_EXTENDED_LSB                   26
735*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_DOT11AX_SU_EXTENDED_MASK                  0x04000000
736*5113495bSYour Name 
737*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_1_DOT11AX_EXT_RU_SIZE
738*5113495bSYour Name 
739*5113495bSYour Name 			TX side:
740*5113495bSYour Name 
741*5113495bSYour Name 			Set to 0
742*5113495bSYour Name 
743*5113495bSYour Name 
744*5113495bSYour Name 
745*5113495bSYour Name 			RX side:
746*5113495bSYour Name 
747*5113495bSYour Name 			Field only contains valid info when dot11ax_su_extended
748*5113495bSYour Name 			is set.
749*5113495bSYour Name 
750*5113495bSYour Name 
751*5113495bSYour Name 
752*5113495bSYour Name 			On RX side, evaluated by MAC HW. This is the only way
753*5113495bSYour Name 			for MAC RX to know what the number of based RUs was in this
754*5113495bSYour Name 			extended range reception. It is used by the MAC to determine
755*5113495bSYour Name 			the RU size for the response...
756*5113495bSYour Name 
757*5113495bSYour Name 			<legal all>
758*5113495bSYour Name */
759*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_DOT11AX_EXT_RU_SIZE_OFFSET                0x00000004
760*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_DOT11AX_EXT_RU_SIZE_LSB                   27
761*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_DOT11AX_EXT_RU_SIZE_MASK                  0x78000000
762*5113495bSYour Name 
763*5113495bSYour Name /* Description		HE_SIG_A_SU_INFO_1_RX_NDP
764*5113495bSYour Name 
765*5113495bSYour Name 			TX side:
766*5113495bSYour Name 
767*5113495bSYour Name 			Set to 0
768*5113495bSYour Name 
769*5113495bSYour Name 
770*5113495bSYour Name 
771*5113495bSYour Name 			RX side:Valid on RX side only, and looked at by MAC HW
772*5113495bSYour Name 
773*5113495bSYour Name 
774*5113495bSYour Name 
775*5113495bSYour Name 			When set, PHY has received (expected) NDP frame
776*5113495bSYour Name 
777*5113495bSYour Name 			<legal all>
778*5113495bSYour Name */
779*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_RX_NDP_OFFSET                             0x00000004
780*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_RX_NDP_LSB                                31
781*5113495bSYour Name #define HE_SIG_A_SU_INFO_1_RX_NDP_MASK                               0x80000000
782*5113495bSYour Name 
783*5113495bSYour Name 
784*5113495bSYour Name #endif // _HE_SIG_A_SU_INFO_H_
785