xref: /wlan-driver/fw-api/hw/qca8074/v2/he_sig_a_mu_ul_info.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 // $ATH_LICENSE_HW_HDR_C$
18*5113495bSYour Name //
19*5113495bSYour Name // DO NOT EDIT!  This file is automatically generated
20*5113495bSYour Name //               These definitions are tied to a particular hardware layout
21*5113495bSYour Name 
22*5113495bSYour Name 
23*5113495bSYour Name #ifndef _HE_SIG_A_MU_UL_INFO_H_
24*5113495bSYour Name #define _HE_SIG_A_MU_UL_INFO_H_
25*5113495bSYour Name #if !defined(__ASSEMBLER__)
26*5113495bSYour Name #endif
27*5113495bSYour Name 
28*5113495bSYour Name 
29*5113495bSYour Name // ################ START SUMMARY #################
30*5113495bSYour Name //
31*5113495bSYour Name //	Dword	Fields
32*5113495bSYour Name //	0	format_indication[0], bss_color_id[6:1], spatial_reuse[22:7], reserved_0a[23], transmit_bw[25:24], reserved_0b[31:26]
33*5113495bSYour Name //	1	txop_duration[6:0], reserved_1a[15:7], crc[19:16], tail[25:20], reserved_1b[31:26]
34*5113495bSYour Name //
35*5113495bSYour Name // ################ END SUMMARY #################
36*5113495bSYour Name 
37*5113495bSYour Name #define NUM_OF_DWORDS_HE_SIG_A_MU_UL_INFO 2
38*5113495bSYour Name 
39*5113495bSYour Name struct he_sig_a_mu_ul_info {
40*5113495bSYour Name              uint32_t format_indication               :  1, //[0]
41*5113495bSYour Name                       bss_color_id                    :  6, //[6:1]
42*5113495bSYour Name                       spatial_reuse                   : 16, //[22:7]
43*5113495bSYour Name                       reserved_0a                     :  1, //[23]
44*5113495bSYour Name                       transmit_bw                     :  2, //[25:24]
45*5113495bSYour Name                       reserved_0b                     :  6; //[31:26]
46*5113495bSYour Name              uint32_t txop_duration                   :  7, //[6:0]
47*5113495bSYour Name                       reserved_1a                     :  9, //[15:7]
48*5113495bSYour Name                       crc                             :  4, //[19:16]
49*5113495bSYour Name                       tail                            :  6, //[25:20]
50*5113495bSYour Name                       reserved_1b                     :  6; //[31:26]
51*5113495bSYour Name };
52*5113495bSYour Name 
53*5113495bSYour Name /*
54*5113495bSYour Name 
55*5113495bSYour Name format_indication
56*5113495bSYour Name 
57*5113495bSYour Name 			Indicates whether the transmission is SU PPDU or a
58*5113495bSYour Name 			trigger based UL MU PDDU
59*5113495bSYour Name 
60*5113495bSYour Name 			<enum 0 HE_SIGA_FORMAT_HE_TRIG>
61*5113495bSYour Name 
62*5113495bSYour Name 			<enum 1 HE_SIGA_FORMAT_SU_OR_EXT_SU>
63*5113495bSYour Name 
64*5113495bSYour Name 			<legal all>
65*5113495bSYour Name 
66*5113495bSYour Name bss_color_id
67*5113495bSYour Name 
68*5113495bSYour Name 			BSS color ID
69*5113495bSYour Name 
70*5113495bSYour Name 			<legal all>
71*5113495bSYour Name 
72*5113495bSYour Name spatial_reuse
73*5113495bSYour Name 
74*5113495bSYour Name 			Spatial reuse
75*5113495bSYour Name 
76*5113495bSYour Name 
77*5113495bSYour Name 
78*5113495bSYour Name 			<legal all>
79*5113495bSYour Name 
80*5113495bSYour Name reserved_0a
81*5113495bSYour Name 
82*5113495bSYour Name 			Note: spec indicates this shall be set to 1
83*5113495bSYour Name 
84*5113495bSYour Name 			<legal 1>
85*5113495bSYour Name 
86*5113495bSYour Name transmit_bw
87*5113495bSYour Name 
88*5113495bSYour Name 			Bandwidth of the PPDU.
89*5113495bSYour Name 
90*5113495bSYour Name 
91*5113495bSYour Name 
92*5113495bSYour Name 			<enum 0 HE_SIG_A_MU_UL_BW20> 20 Mhz
93*5113495bSYour Name 
94*5113495bSYour Name 			<enum 1 HE_SIG_A_MU_UL_BW40> 40 Mhz
95*5113495bSYour Name 
96*5113495bSYour Name 			<enum 2 HE_SIG_A_MU_UL_BW80> 80 Mhz
97*5113495bSYour Name 
98*5113495bSYour Name 			<enum 3 HE_SIG_A_MU_UL_BW160> 160 MHz or 80+80 MHz
99*5113495bSYour Name 
100*5113495bSYour Name 
101*5113495bSYour Name 
102*5113495bSYour Name 			On RX side, Field Used by MAC HW
103*5113495bSYour Name 
104*5113495bSYour Name 			<legal 0-3>
105*5113495bSYour Name 
106*5113495bSYour Name reserved_0b
107*5113495bSYour Name 
108*5113495bSYour Name 			<legal 0>
109*5113495bSYour Name 
110*5113495bSYour Name txop_duration
111*5113495bSYour Name 
112*5113495bSYour Name 			Indicates the remaining time in the current TXOP <legal
113*5113495bSYour Name 			all>
114*5113495bSYour Name 
115*5113495bSYour Name reserved_1a
116*5113495bSYour Name 
117*5113495bSYour Name 			Set to value indicated in the trigger frame
118*5113495bSYour Name 
119*5113495bSYour Name 			<legal 255>
120*5113495bSYour Name 
121*5113495bSYour Name crc
122*5113495bSYour Name 
123*5113495bSYour Name 			CRC for HE-SIG-A contents.
124*5113495bSYour Name 
125*5113495bSYour Name 			This CRC may also cover some fields of L-SIG (TBD)
126*5113495bSYour Name 
127*5113495bSYour Name 			<legal all>
128*5113495bSYour Name 
129*5113495bSYour Name tail
130*5113495bSYour Name 
131*5113495bSYour Name 			BCC encoding (similar to VHT-SIG-A) with 6 tail bits is
132*5113495bSYour Name 			used
133*5113495bSYour Name 
134*5113495bSYour Name 			<legal 0>
135*5113495bSYour Name 
136*5113495bSYour Name reserved_1b
137*5113495bSYour Name 
138*5113495bSYour Name 			<legal 0>
139*5113495bSYour Name */
140*5113495bSYour Name 
141*5113495bSYour Name 
142*5113495bSYour Name /* Description		HE_SIG_A_MU_UL_INFO_0_FORMAT_INDICATION
143*5113495bSYour Name 
144*5113495bSYour Name 			Indicates whether the transmission is SU PPDU or a
145*5113495bSYour Name 			trigger based UL MU PDDU
146*5113495bSYour Name 
147*5113495bSYour Name 			<enum 0 HE_SIGA_FORMAT_HE_TRIG>
148*5113495bSYour Name 
149*5113495bSYour Name 			<enum 1 HE_SIGA_FORMAT_SU_OR_EXT_SU>
150*5113495bSYour Name 
151*5113495bSYour Name 			<legal all>
152*5113495bSYour Name */
153*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_0_FORMAT_INDICATION_OFFSET               0x00000000
154*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_0_FORMAT_INDICATION_LSB                  0
155*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_0_FORMAT_INDICATION_MASK                 0x00000001
156*5113495bSYour Name 
157*5113495bSYour Name /* Description		HE_SIG_A_MU_UL_INFO_0_BSS_COLOR_ID
158*5113495bSYour Name 
159*5113495bSYour Name 			BSS color ID
160*5113495bSYour Name 
161*5113495bSYour Name 			<legal all>
162*5113495bSYour Name */
163*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_0_BSS_COLOR_ID_OFFSET                    0x00000000
164*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_0_BSS_COLOR_ID_LSB                       1
165*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_0_BSS_COLOR_ID_MASK                      0x0000007e
166*5113495bSYour Name 
167*5113495bSYour Name /* Description		HE_SIG_A_MU_UL_INFO_0_SPATIAL_REUSE
168*5113495bSYour Name 
169*5113495bSYour Name 			Spatial reuse
170*5113495bSYour Name 
171*5113495bSYour Name 
172*5113495bSYour Name 
173*5113495bSYour Name 			<legal all>
174*5113495bSYour Name */
175*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_0_SPATIAL_REUSE_OFFSET                   0x00000000
176*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_0_SPATIAL_REUSE_LSB                      7
177*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_0_SPATIAL_REUSE_MASK                     0x007fff80
178*5113495bSYour Name 
179*5113495bSYour Name /* Description		HE_SIG_A_MU_UL_INFO_0_RESERVED_0A
180*5113495bSYour Name 
181*5113495bSYour Name 			Note: spec indicates this shall be set to 1
182*5113495bSYour Name 
183*5113495bSYour Name 			<legal 1>
184*5113495bSYour Name */
185*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_0_RESERVED_0A_OFFSET                     0x00000000
186*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_0_RESERVED_0A_LSB                        23
187*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_0_RESERVED_0A_MASK                       0x00800000
188*5113495bSYour Name 
189*5113495bSYour Name /* Description		HE_SIG_A_MU_UL_INFO_0_TRANSMIT_BW
190*5113495bSYour Name 
191*5113495bSYour Name 			Bandwidth of the PPDU.
192*5113495bSYour Name 
193*5113495bSYour Name 
194*5113495bSYour Name 
195*5113495bSYour Name 			<enum 0 HE_SIG_A_MU_UL_BW20> 20 Mhz
196*5113495bSYour Name 
197*5113495bSYour Name 			<enum 1 HE_SIG_A_MU_UL_BW40> 40 Mhz
198*5113495bSYour Name 
199*5113495bSYour Name 			<enum 2 HE_SIG_A_MU_UL_BW80> 80 Mhz
200*5113495bSYour Name 
201*5113495bSYour Name 			<enum 3 HE_SIG_A_MU_UL_BW160> 160 MHz or 80+80 MHz
202*5113495bSYour Name 
203*5113495bSYour Name 
204*5113495bSYour Name 
205*5113495bSYour Name 			On RX side, Field Used by MAC HW
206*5113495bSYour Name 
207*5113495bSYour Name 			<legal 0-3>
208*5113495bSYour Name */
209*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_0_TRANSMIT_BW_OFFSET                     0x00000000
210*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_0_TRANSMIT_BW_LSB                        24
211*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_0_TRANSMIT_BW_MASK                       0x03000000
212*5113495bSYour Name 
213*5113495bSYour Name /* Description		HE_SIG_A_MU_UL_INFO_0_RESERVED_0B
214*5113495bSYour Name 
215*5113495bSYour Name 			<legal 0>
216*5113495bSYour Name */
217*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_0_RESERVED_0B_OFFSET                     0x00000000
218*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_0_RESERVED_0B_LSB                        26
219*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_0_RESERVED_0B_MASK                       0xfc000000
220*5113495bSYour Name 
221*5113495bSYour Name /* Description		HE_SIG_A_MU_UL_INFO_1_TXOP_DURATION
222*5113495bSYour Name 
223*5113495bSYour Name 			Indicates the remaining time in the current TXOP <legal
224*5113495bSYour Name 			all>
225*5113495bSYour Name */
226*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_1_TXOP_DURATION_OFFSET                   0x00000004
227*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_1_TXOP_DURATION_LSB                      0
228*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_1_TXOP_DURATION_MASK                     0x0000007f
229*5113495bSYour Name 
230*5113495bSYour Name /* Description		HE_SIG_A_MU_UL_INFO_1_RESERVED_1A
231*5113495bSYour Name 
232*5113495bSYour Name 			Set to value indicated in the trigger frame
233*5113495bSYour Name 
234*5113495bSYour Name 			<legal 255>
235*5113495bSYour Name */
236*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_1_RESERVED_1A_OFFSET                     0x00000004
237*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_1_RESERVED_1A_LSB                        7
238*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_1_RESERVED_1A_MASK                       0x0000ff80
239*5113495bSYour Name 
240*5113495bSYour Name /* Description		HE_SIG_A_MU_UL_INFO_1_CRC
241*5113495bSYour Name 
242*5113495bSYour Name 			CRC for HE-SIG-A contents.
243*5113495bSYour Name 
244*5113495bSYour Name 			This CRC may also cover some fields of L-SIG (TBD)
245*5113495bSYour Name 
246*5113495bSYour Name 			<legal all>
247*5113495bSYour Name */
248*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_1_CRC_OFFSET                             0x00000004
249*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_1_CRC_LSB                                16
250*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_1_CRC_MASK                               0x000f0000
251*5113495bSYour Name 
252*5113495bSYour Name /* Description		HE_SIG_A_MU_UL_INFO_1_TAIL
253*5113495bSYour Name 
254*5113495bSYour Name 			BCC encoding (similar to VHT-SIG-A) with 6 tail bits is
255*5113495bSYour Name 			used
256*5113495bSYour Name 
257*5113495bSYour Name 			<legal 0>
258*5113495bSYour Name */
259*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_1_TAIL_OFFSET                            0x00000004
260*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_1_TAIL_LSB                               20
261*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_1_TAIL_MASK                              0x03f00000
262*5113495bSYour Name 
263*5113495bSYour Name /* Description		HE_SIG_A_MU_UL_INFO_1_RESERVED_1B
264*5113495bSYour Name 
265*5113495bSYour Name 			<legal 0>
266*5113495bSYour Name */
267*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_1_RESERVED_1B_OFFSET                     0x00000004
268*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_1_RESERVED_1B_LSB                        26
269*5113495bSYour Name #define HE_SIG_A_MU_UL_INFO_1_RESERVED_1B_MASK                       0xfc000000
270*5113495bSYour Name 
271*5113495bSYour Name 
272*5113495bSYour Name #endif // _HE_SIG_A_MU_UL_INFO_H_
273