xref: /linux/include/net/ieee80211_radiotap.h (revision 8f7aa3d3c7323f4ca2768a9e74ebbe359c4f8f88)
1 /*
2  * Copyright (c) 2017		Intel Deutschland GmbH
3  * Copyright (c) 2018-2019, 2021-2022, 2025 Intel Corporation
4  *
5  * Permission to use, copy, modify, and/or distribute this software for any
6  * purpose with or without fee is hereby granted, provided that the above
7  * copyright notice and this permission notice appear in all copies.
8  *
9  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16  */
17 #ifndef __RADIOTAP_H
18 #define __RADIOTAP_H
19 
20 #include <linux/kernel.h>
21 #include <linux/unaligned.h>
22 
23 /**
24  * struct ieee80211_radiotap_header - base radiotap header
25  */
26 struct ieee80211_radiotap_header {
27 	__struct_group(ieee80211_radiotap_header_fixed, hdr, __packed,
28 		/**
29 		 * @it_version: radiotap version, always 0
30 		 */
31 		uint8_t it_version;
32 
33 		/**
34 		 * @it_pad: padding (or alignment)
35 		 */
36 		uint8_t it_pad;
37 
38 		/**
39 		 * @it_len: overall radiotap header length
40 		 */
41 		__le16 it_len;
42 
43 		/**
44 		 * @it_present: (first) present word
45 		 */
46 		__le32 it_present;
47 	);
48 
49 	/**
50 	 * @it_optional: all remaining presence bitmaps
51 	 */
52 	__le32 it_optional[];
53 } __packed;
54 
55 static_assert(offsetof(struct ieee80211_radiotap_header, it_optional) == sizeof(struct ieee80211_radiotap_header_fixed),
56 	      "struct member likely outside of __struct_group()");
57 
58 /* version is always 0 */
59 #define PKTHDR_RADIOTAP_VERSION	0
60 
61 /* see the radiotap website for the descriptions */
62 enum ieee80211_radiotap_presence {
63 	IEEE80211_RADIOTAP_TSFT = 0,
64 	IEEE80211_RADIOTAP_FLAGS = 1,
65 	IEEE80211_RADIOTAP_RATE = 2,
66 	IEEE80211_RADIOTAP_CHANNEL = 3,
67 	IEEE80211_RADIOTAP_FHSS = 4,
68 	IEEE80211_RADIOTAP_DBM_ANTSIGNAL = 5,
69 	IEEE80211_RADIOTAP_DBM_ANTNOISE = 6,
70 	IEEE80211_RADIOTAP_LOCK_QUALITY = 7,
71 	IEEE80211_RADIOTAP_TX_ATTENUATION = 8,
72 	IEEE80211_RADIOTAP_DB_TX_ATTENUATION = 9,
73 	IEEE80211_RADIOTAP_DBM_TX_POWER = 10,
74 	IEEE80211_RADIOTAP_ANTENNA = 11,
75 	IEEE80211_RADIOTAP_DB_ANTSIGNAL = 12,
76 	IEEE80211_RADIOTAP_DB_ANTNOISE = 13,
77 	IEEE80211_RADIOTAP_RX_FLAGS = 14,
78 	IEEE80211_RADIOTAP_TX_FLAGS = 15,
79 	IEEE80211_RADIOTAP_RTS_RETRIES = 16,
80 	IEEE80211_RADIOTAP_DATA_RETRIES = 17,
81 	/* 18 is XChannel, but it's not defined yet */
82 	IEEE80211_RADIOTAP_MCS = 19,
83 	IEEE80211_RADIOTAP_AMPDU_STATUS = 20,
84 	IEEE80211_RADIOTAP_VHT = 21,
85 	IEEE80211_RADIOTAP_TIMESTAMP = 22,
86 	IEEE80211_RADIOTAP_HE = 23,
87 	IEEE80211_RADIOTAP_HE_MU = 24,
88 	IEEE80211_RADIOTAP_ZERO_LEN_PSDU = 26,
89 	IEEE80211_RADIOTAP_LSIG = 27,
90 	IEEE80211_RADIOTAP_TLV = 28,
91 
92 	/* valid in every it_present bitmap, even vendor namespaces */
93 	IEEE80211_RADIOTAP_RADIOTAP_NAMESPACE = 29,
94 	IEEE80211_RADIOTAP_VENDOR_NAMESPACE = 30,
95 	IEEE80211_RADIOTAP_EXT = 31,
96 	IEEE80211_RADIOTAP_EHT_USIG = 33,
97 	IEEE80211_RADIOTAP_EHT = 34,
98 };
99 
100 /* for IEEE80211_RADIOTAP_FLAGS */
101 enum ieee80211_radiotap_flags {
102 	IEEE80211_RADIOTAP_F_CFP = 0x01,
103 	IEEE80211_RADIOTAP_F_SHORTPRE = 0x02,
104 	IEEE80211_RADIOTAP_F_WEP = 0x04,
105 	IEEE80211_RADIOTAP_F_FRAG = 0x08,
106 	IEEE80211_RADIOTAP_F_FCS = 0x10,
107 	IEEE80211_RADIOTAP_F_DATAPAD = 0x20,
108 	IEEE80211_RADIOTAP_F_BADFCS = 0x40,
109 };
110 
111 /* for IEEE80211_RADIOTAP_CHANNEL */
112 enum ieee80211_radiotap_channel_flags {
113 	IEEE80211_CHAN_CCK = 0x0020,
114 	IEEE80211_CHAN_OFDM = 0x0040,
115 	IEEE80211_CHAN_2GHZ = 0x0080,
116 	IEEE80211_CHAN_5GHZ = 0x0100,
117 	IEEE80211_CHAN_DYN = 0x0400,
118 	IEEE80211_CHAN_HALF = 0x4000,
119 	IEEE80211_CHAN_QUARTER = 0x8000,
120 };
121 
122 /* for IEEE80211_RADIOTAP_RX_FLAGS */
123 enum ieee80211_radiotap_rx_flags {
124 	IEEE80211_RADIOTAP_F_RX_BADPLCP = 0x0002,
125 };
126 
127 /* for IEEE80211_RADIOTAP_TX_FLAGS */
128 enum ieee80211_radiotap_tx_flags {
129 	IEEE80211_RADIOTAP_F_TX_FAIL = 0x0001,
130 	IEEE80211_RADIOTAP_F_TX_CTS = 0x0002,
131 	IEEE80211_RADIOTAP_F_TX_RTS = 0x0004,
132 	IEEE80211_RADIOTAP_F_TX_NOACK = 0x0008,
133 	IEEE80211_RADIOTAP_F_TX_NOSEQNO = 0x0010,
134 	IEEE80211_RADIOTAP_F_TX_ORDER = 0x0020,
135 };
136 
137 /* for IEEE80211_RADIOTAP_MCS "have" flags */
138 enum ieee80211_radiotap_mcs_have {
139 	IEEE80211_RADIOTAP_MCS_HAVE_BW = 0x01,
140 	IEEE80211_RADIOTAP_MCS_HAVE_MCS = 0x02,
141 	IEEE80211_RADIOTAP_MCS_HAVE_GI = 0x04,
142 	IEEE80211_RADIOTAP_MCS_HAVE_FMT = 0x08,
143 	IEEE80211_RADIOTAP_MCS_HAVE_FEC = 0x10,
144 	IEEE80211_RADIOTAP_MCS_HAVE_STBC = 0x20,
145 };
146 
147 enum ieee80211_radiotap_mcs_flags {
148 	IEEE80211_RADIOTAP_MCS_BW_MASK = 0x03,
149 	IEEE80211_RADIOTAP_MCS_BW_20 = 0,
150 	IEEE80211_RADIOTAP_MCS_BW_40 = 1,
151 	IEEE80211_RADIOTAP_MCS_BW_20L = 2,
152 	IEEE80211_RADIOTAP_MCS_BW_20U = 3,
153 
154 	IEEE80211_RADIOTAP_MCS_SGI = 0x04,
155 	IEEE80211_RADIOTAP_MCS_FMT_GF = 0x08,
156 	IEEE80211_RADIOTAP_MCS_FEC_LDPC = 0x10,
157 	IEEE80211_RADIOTAP_MCS_STBC_MASK = 0x60,
158 	IEEE80211_RADIOTAP_MCS_STBC_1 = 1,
159 	IEEE80211_RADIOTAP_MCS_STBC_2 = 2,
160 	IEEE80211_RADIOTAP_MCS_STBC_3 = 3,
161 	IEEE80211_RADIOTAP_MCS_STBC_SHIFT = 5,
162 };
163 
164 /* for IEEE80211_RADIOTAP_AMPDU_STATUS */
165 enum ieee80211_radiotap_ampdu_flags {
166 	IEEE80211_RADIOTAP_AMPDU_REPORT_ZEROLEN = 0x0001,
167 	IEEE80211_RADIOTAP_AMPDU_IS_ZEROLEN = 0x0002,
168 	IEEE80211_RADIOTAP_AMPDU_LAST_KNOWN = 0x0004,
169 	IEEE80211_RADIOTAP_AMPDU_IS_LAST = 0x0008,
170 	IEEE80211_RADIOTAP_AMPDU_DELIM_CRC_ERR = 0x0010,
171 	IEEE80211_RADIOTAP_AMPDU_DELIM_CRC_KNOWN = 0x0020,
172 	IEEE80211_RADIOTAP_AMPDU_EOF = 0x0040,
173 	IEEE80211_RADIOTAP_AMPDU_EOF_KNOWN = 0x0080,
174 };
175 
176 /* for IEEE80211_RADIOTAP_VHT */
177 enum ieee80211_radiotap_vht_known {
178 	IEEE80211_RADIOTAP_VHT_KNOWN_STBC = 0x0001,
179 	IEEE80211_RADIOTAP_VHT_KNOWN_TXOP_PS_NA = 0x0002,
180 	IEEE80211_RADIOTAP_VHT_KNOWN_GI = 0x0004,
181 	IEEE80211_RADIOTAP_VHT_KNOWN_SGI_NSYM_DIS = 0x0008,
182 	IEEE80211_RADIOTAP_VHT_KNOWN_LDPC_EXTRA_OFDM_SYM = 0x0010,
183 	IEEE80211_RADIOTAP_VHT_KNOWN_BEAMFORMED = 0x0020,
184 	IEEE80211_RADIOTAP_VHT_KNOWN_BANDWIDTH = 0x0040,
185 	IEEE80211_RADIOTAP_VHT_KNOWN_GROUP_ID = 0x0080,
186 	IEEE80211_RADIOTAP_VHT_KNOWN_PARTIAL_AID = 0x0100,
187 };
188 
189 enum ieee80211_radiotap_vht_flags {
190 	IEEE80211_RADIOTAP_VHT_FLAG_STBC = 0x01,
191 	IEEE80211_RADIOTAP_VHT_FLAG_TXOP_PS_NA = 0x02,
192 	IEEE80211_RADIOTAP_VHT_FLAG_SGI = 0x04,
193 	IEEE80211_RADIOTAP_VHT_FLAG_SGI_NSYM_M10_9 = 0x08,
194 	IEEE80211_RADIOTAP_VHT_FLAG_LDPC_EXTRA_OFDM_SYM = 0x10,
195 	IEEE80211_RADIOTAP_VHT_FLAG_BEAMFORMED = 0x20,
196 };
197 
198 enum ieee80211_radiotap_vht_coding {
199 	IEEE80211_RADIOTAP_CODING_LDPC_USER0 = 0x01,
200 	IEEE80211_RADIOTAP_CODING_LDPC_USER1 = 0x02,
201 	IEEE80211_RADIOTAP_CODING_LDPC_USER2 = 0x04,
202 	IEEE80211_RADIOTAP_CODING_LDPC_USER3 = 0x08,
203 };
204 
205 enum ieee80211_radiotap_vht_bandwidth {
206 	/* Note: more values are defined but can't really be used */
207 	IEEE80211_RADIOTAP_VHT_BW_20		= 0,
208 	IEEE80211_RADIOTAP_VHT_BW_40		= 1,
209 	IEEE80211_RADIOTAP_VHT_BW_80		= 4,
210 	IEEE80211_RADIOTAP_VHT_BW_160		= 11,
211 };
212 
213 struct ieee80211_radiotap_vht {
214 	__le16 known;
215 	u8 flags;
216 	u8 bandwidth;
217 	u8 mcs_nss[4];
218 	u8 coding;
219 	u8 group_id;
220 	__le16 partial_aid;
221 } __packed;
222 
223 /* for IEEE80211_RADIOTAP_TIMESTAMP */
224 enum ieee80211_radiotap_timestamp_unit_spos {
225 	IEEE80211_RADIOTAP_TIMESTAMP_UNIT_MASK = 0x000F,
226 	IEEE80211_RADIOTAP_TIMESTAMP_UNIT_MS = 0x0000,
227 	IEEE80211_RADIOTAP_TIMESTAMP_UNIT_US = 0x0001,
228 	IEEE80211_RADIOTAP_TIMESTAMP_UNIT_NS = 0x0003,
229 	IEEE80211_RADIOTAP_TIMESTAMP_SPOS_MASK = 0x00F0,
230 	IEEE80211_RADIOTAP_TIMESTAMP_SPOS_BEGIN_MDPU = 0x0000,
231 	IEEE80211_RADIOTAP_TIMESTAMP_SPOS_PLCP_SIG_ACQ = 0x0010,
232 	IEEE80211_RADIOTAP_TIMESTAMP_SPOS_EO_PPDU = 0x0020,
233 	IEEE80211_RADIOTAP_TIMESTAMP_SPOS_EO_MPDU = 0x0030,
234 	IEEE80211_RADIOTAP_TIMESTAMP_SPOS_UNKNOWN = 0x00F0,
235 };
236 
237 enum ieee80211_radiotap_timestamp_flags {
238 	IEEE80211_RADIOTAP_TIMESTAMP_FLAG_64BIT = 0x00,
239 	IEEE80211_RADIOTAP_TIMESTAMP_FLAG_32BIT = 0x01,
240 	IEEE80211_RADIOTAP_TIMESTAMP_FLAG_ACCURACY = 0x02,
241 };
242 
243 struct ieee80211_radiotap_he {
244 	__le16 data1, data2, data3, data4, data5, data6;
245 };
246 
247 enum ieee80211_radiotap_he_bits {
248 	IEEE80211_RADIOTAP_HE_DATA1_FORMAT_MASK		= 3,
249 	IEEE80211_RADIOTAP_HE_DATA1_FORMAT_SU		= 0,
250 	IEEE80211_RADIOTAP_HE_DATA1_FORMAT_EXT_SU	= 1,
251 	IEEE80211_RADIOTAP_HE_DATA1_FORMAT_MU		= 2,
252 	IEEE80211_RADIOTAP_HE_DATA1_FORMAT_TRIG		= 3,
253 
254 	IEEE80211_RADIOTAP_HE_DATA1_BSS_COLOR_KNOWN	= 0x0004,
255 	IEEE80211_RADIOTAP_HE_DATA1_BEAM_CHANGE_KNOWN	= 0x0008,
256 	IEEE80211_RADIOTAP_HE_DATA1_UL_DL_KNOWN		= 0x0010,
257 	IEEE80211_RADIOTAP_HE_DATA1_DATA_MCS_KNOWN	= 0x0020,
258 	IEEE80211_RADIOTAP_HE_DATA1_DATA_DCM_KNOWN	= 0x0040,
259 	IEEE80211_RADIOTAP_HE_DATA1_CODING_KNOWN	= 0x0080,
260 	IEEE80211_RADIOTAP_HE_DATA1_LDPC_XSYMSEG_KNOWN	= 0x0100,
261 	IEEE80211_RADIOTAP_HE_DATA1_STBC_KNOWN		= 0x0200,
262 	IEEE80211_RADIOTAP_HE_DATA1_SPTL_REUSE_KNOWN	= 0x0400,
263 	IEEE80211_RADIOTAP_HE_DATA1_SPTL_REUSE2_KNOWN	= 0x0800,
264 	IEEE80211_RADIOTAP_HE_DATA1_SPTL_REUSE3_KNOWN	= 0x1000,
265 	IEEE80211_RADIOTAP_HE_DATA1_SPTL_REUSE4_KNOWN	= 0x2000,
266 	IEEE80211_RADIOTAP_HE_DATA1_BW_RU_ALLOC_KNOWN	= 0x4000,
267 	IEEE80211_RADIOTAP_HE_DATA1_DOPPLER_KNOWN	= 0x8000,
268 
269 	IEEE80211_RADIOTAP_HE_DATA2_PRISEC_80_KNOWN	= 0x0001,
270 	IEEE80211_RADIOTAP_HE_DATA2_GI_KNOWN		= 0x0002,
271 	IEEE80211_RADIOTAP_HE_DATA2_NUM_LTF_SYMS_KNOWN	= 0x0004,
272 	IEEE80211_RADIOTAP_HE_DATA2_PRE_FEC_PAD_KNOWN	= 0x0008,
273 	IEEE80211_RADIOTAP_HE_DATA2_TXBF_KNOWN		= 0x0010,
274 	IEEE80211_RADIOTAP_HE_DATA2_PE_DISAMBIG_KNOWN	= 0x0020,
275 	IEEE80211_RADIOTAP_HE_DATA2_TXOP_KNOWN		= 0x0040,
276 	IEEE80211_RADIOTAP_HE_DATA2_MIDAMBLE_KNOWN	= 0x0080,
277 	IEEE80211_RADIOTAP_HE_DATA2_RU_OFFSET		= 0x3f00,
278 	IEEE80211_RADIOTAP_HE_DATA2_RU_OFFSET_KNOWN	= 0x4000,
279 	IEEE80211_RADIOTAP_HE_DATA2_PRISEC_80_SEC	= 0x8000,
280 
281 	IEEE80211_RADIOTAP_HE_DATA3_BSS_COLOR		= 0x003f,
282 	IEEE80211_RADIOTAP_HE_DATA3_BEAM_CHANGE		= 0x0040,
283 	IEEE80211_RADIOTAP_HE_DATA3_UL_DL		= 0x0080,
284 	IEEE80211_RADIOTAP_HE_DATA3_DATA_MCS		= 0x0f00,
285 	IEEE80211_RADIOTAP_HE_DATA3_DATA_DCM		= 0x1000,
286 	IEEE80211_RADIOTAP_HE_DATA3_CODING		= 0x2000,
287 	IEEE80211_RADIOTAP_HE_DATA3_LDPC_XSYMSEG	= 0x4000,
288 	IEEE80211_RADIOTAP_HE_DATA3_STBC		= 0x8000,
289 
290 	IEEE80211_RADIOTAP_HE_DATA4_SU_MU_SPTL_REUSE	= 0x000f,
291 	IEEE80211_RADIOTAP_HE_DATA4_MU_STA_ID		= 0x7ff0,
292 	IEEE80211_RADIOTAP_HE_DATA4_TB_SPTL_REUSE1	= 0x000f,
293 	IEEE80211_RADIOTAP_HE_DATA4_TB_SPTL_REUSE2	= 0x00f0,
294 	IEEE80211_RADIOTAP_HE_DATA4_TB_SPTL_REUSE3	= 0x0f00,
295 	IEEE80211_RADIOTAP_HE_DATA4_TB_SPTL_REUSE4	= 0xf000,
296 
297 	IEEE80211_RADIOTAP_HE_DATA5_DATA_BW_RU_ALLOC	= 0x000f,
298 		IEEE80211_RADIOTAP_HE_DATA5_DATA_BW_RU_ALLOC_20MHZ	= 0,
299 		IEEE80211_RADIOTAP_HE_DATA5_DATA_BW_RU_ALLOC_40MHZ	= 1,
300 		IEEE80211_RADIOTAP_HE_DATA5_DATA_BW_RU_ALLOC_80MHZ	= 2,
301 		IEEE80211_RADIOTAP_HE_DATA5_DATA_BW_RU_ALLOC_160MHZ	= 3,
302 		IEEE80211_RADIOTAP_HE_DATA5_DATA_BW_RU_ALLOC_26T	= 4,
303 		IEEE80211_RADIOTAP_HE_DATA5_DATA_BW_RU_ALLOC_52T	= 5,
304 		IEEE80211_RADIOTAP_HE_DATA5_DATA_BW_RU_ALLOC_106T	= 6,
305 		IEEE80211_RADIOTAP_HE_DATA5_DATA_BW_RU_ALLOC_242T	= 7,
306 		IEEE80211_RADIOTAP_HE_DATA5_DATA_BW_RU_ALLOC_484T	= 8,
307 		IEEE80211_RADIOTAP_HE_DATA5_DATA_BW_RU_ALLOC_996T	= 9,
308 		IEEE80211_RADIOTAP_HE_DATA5_DATA_BW_RU_ALLOC_2x996T	= 10,
309 
310 	IEEE80211_RADIOTAP_HE_DATA5_GI			= 0x0030,
311 		IEEE80211_RADIOTAP_HE_DATA5_GI_0_8			= 0,
312 		IEEE80211_RADIOTAP_HE_DATA5_GI_1_6			= 1,
313 		IEEE80211_RADIOTAP_HE_DATA5_GI_3_2			= 2,
314 
315 	IEEE80211_RADIOTAP_HE_DATA5_LTF_SIZE		= 0x00c0,
316 		IEEE80211_RADIOTAP_HE_DATA5_LTF_SIZE_UNKNOWN		= 0,
317 		IEEE80211_RADIOTAP_HE_DATA5_LTF_SIZE_1X			= 1,
318 		IEEE80211_RADIOTAP_HE_DATA5_LTF_SIZE_2X			= 2,
319 		IEEE80211_RADIOTAP_HE_DATA5_LTF_SIZE_4X			= 3,
320 	IEEE80211_RADIOTAP_HE_DATA5_NUM_LTF_SYMS	= 0x0700,
321 	IEEE80211_RADIOTAP_HE_DATA5_PRE_FEC_PAD		= 0x3000,
322 	IEEE80211_RADIOTAP_HE_DATA5_TXBF		= 0x4000,
323 	IEEE80211_RADIOTAP_HE_DATA5_PE_DISAMBIG		= 0x8000,
324 
325 	IEEE80211_RADIOTAP_HE_DATA6_NSTS		= 0x000f,
326 	IEEE80211_RADIOTAP_HE_DATA6_DOPPLER		= 0x0010,
327 	IEEE80211_RADIOTAP_HE_DATA6_TB_PPDU_BW_KNOWN	= 0x0020,
328 	IEEE80211_RADIOTAP_HE_DATA6_TB_PPDU_BW		= 0x00c0,
329 		IEEE80211_RADIOTAP_HE_DATA6_TB_PPDU_BW_20MHZ	= 0,
330 		IEEE80211_RADIOTAP_HE_DATA6_TB_PPDU_BW_40MHZ	= 1,
331 		IEEE80211_RADIOTAP_HE_DATA6_TB_PPDU_BW_80MHZ	= 2,
332 		IEEE80211_RADIOTAP_HE_DATA6_TB_PPDU_BW_160MHZ	= 3,
333 	IEEE80211_RADIOTAP_HE_DATA6_TXOP		= 0x7f00,
334 	IEEE80211_RADIOTAP_HE_DATA6_MIDAMBLE_PDCTY	= 0x8000,
335 };
336 
337 struct ieee80211_radiotap_he_mu {
338 	__le16 flags1, flags2;
339 	u8 ru_ch1[4];
340 	u8 ru_ch2[4];
341 };
342 
343 enum ieee80211_radiotap_he_mu_bits {
344 	IEEE80211_RADIOTAP_HE_MU_FLAGS1_SIG_B_MCS		= 0x000f,
345 	IEEE80211_RADIOTAP_HE_MU_FLAGS1_SIG_B_MCS_KNOWN		= 0x0010,
346 	IEEE80211_RADIOTAP_HE_MU_FLAGS1_SIG_B_DCM		= 0x0020,
347 	IEEE80211_RADIOTAP_HE_MU_FLAGS1_SIG_B_DCM_KNOWN		= 0x0040,
348 	IEEE80211_RADIOTAP_HE_MU_FLAGS1_CH2_CTR_26T_RU_KNOWN	= 0x0080,
349 	IEEE80211_RADIOTAP_HE_MU_FLAGS1_CH1_RU_KNOWN		= 0x0100,
350 	IEEE80211_RADIOTAP_HE_MU_FLAGS1_CH2_RU_KNOWN		= 0x0200,
351 	IEEE80211_RADIOTAP_HE_MU_FLAGS1_CH1_CTR_26T_RU_KNOWN	= 0x1000,
352 	IEEE80211_RADIOTAP_HE_MU_FLAGS1_CH1_CTR_26T_RU		= 0x2000,
353 	IEEE80211_RADIOTAP_HE_MU_FLAGS1_SIG_B_COMP_KNOWN	= 0x4000,
354 	IEEE80211_RADIOTAP_HE_MU_FLAGS1_SIG_B_SYMS_USERS_KNOWN	= 0x8000,
355 
356 	IEEE80211_RADIOTAP_HE_MU_FLAGS2_BW_FROM_SIG_A_BW	= 0x0003,
357 		IEEE80211_RADIOTAP_HE_MU_FLAGS2_BW_FROM_SIG_A_BW_20MHZ	= 0x0000,
358 		IEEE80211_RADIOTAP_HE_MU_FLAGS2_BW_FROM_SIG_A_BW_40MHZ	= 0x0001,
359 		IEEE80211_RADIOTAP_HE_MU_FLAGS2_BW_FROM_SIG_A_BW_80MHZ	= 0x0002,
360 		IEEE80211_RADIOTAP_HE_MU_FLAGS2_BW_FROM_SIG_A_BW_160MHZ	= 0x0003,
361 	IEEE80211_RADIOTAP_HE_MU_FLAGS2_BW_FROM_SIG_A_BW_KNOWN	= 0x0004,
362 	IEEE80211_RADIOTAP_HE_MU_FLAGS2_SIG_B_COMP		= 0x0008,
363 	IEEE80211_RADIOTAP_HE_MU_FLAGS2_SIG_B_SYMS_USERS	= 0x00f0,
364 	IEEE80211_RADIOTAP_HE_MU_FLAGS2_PUNC_FROM_SIG_A_BW	= 0x0300,
365 	IEEE80211_RADIOTAP_HE_MU_FLAGS2_PUNC_FROM_SIG_A_BW_KNOWN= 0x0400,
366 	IEEE80211_RADIOTAP_HE_MU_FLAGS2_CH2_CTR_26T_RU		= 0x0800,
367 };
368 
369 enum ieee80211_radiotap_lsig_data1 {
370 	IEEE80211_RADIOTAP_LSIG_DATA1_RATE_KNOWN		= 0x0001,
371 	IEEE80211_RADIOTAP_LSIG_DATA1_LENGTH_KNOWN		= 0x0002,
372 };
373 
374 enum ieee80211_radiotap_lsig_data2 {
375 	IEEE80211_RADIOTAP_LSIG_DATA2_RATE			= 0x000f,
376 	IEEE80211_RADIOTAP_LSIG_DATA2_LENGTH			= 0xfff0,
377 };
378 
379 struct ieee80211_radiotap_lsig {
380 	__le16 data1, data2;
381 };
382 
383 enum ieee80211_radiotap_zero_len_psdu_type {
384 	IEEE80211_RADIOTAP_ZERO_LEN_PSDU_SOUNDING		= 0,
385 	IEEE80211_RADIOTAP_ZERO_LEN_PSDU_NOT_CAPTURED		= 1,
386 	IEEE80211_RADIOTAP_ZERO_LEN_PSDU_VENDOR			= 0xff,
387 };
388 
389 struct ieee80211_radiotap_tlv {
390 	__le16 type;
391 	__le16 len;
392 	u8 data[];
393 } __packed;
394 
395 /**
396  * struct ieee80211_radiotap_vendor_content - radiotap vendor data content
397  * @oui: radiotap vendor namespace OUI
398  * @oui_subtype: radiotap vendor sub namespace
399  * @vendor_type: radiotap vendor type
400  * @reserved: should always be set to zero (to avoid leaking memory)
401  * @data: the actual vendor namespace data
402  */
403 struct ieee80211_radiotap_vendor_content {
404 	u8 oui[3];
405 	u8 oui_subtype;
406 	__le16 vendor_type;
407 	__le16 reserved;
408 	u8 data[];
409 } __packed;
410 
411 /**
412  * struct ieee80211_radiotap_vendor_tlv - vendor radiotap data information
413  * @type: should always be set to IEEE80211_RADIOTAP_VENDOR_NAMESPACE
414  * @len: length of data
415  * @content: vendor content see @ieee80211_radiotap_vendor_content
416  */
417 struct ieee80211_radiotap_vendor_tlv {
418 	__le16 type; /* IEEE80211_RADIOTAP_VENDOR_NAMESPACE */
419 	__le16 len;
420 	struct ieee80211_radiotap_vendor_content content;
421 };
422 
423 /* ieee80211_radiotap_eht_usig - content of U-SIG tlv (type 33)
424  * see www.radiotap.org/fields/U-SIG.html for details
425  */
426 struct ieee80211_radiotap_eht_usig {
427 	__le32 common;
428 	__le32 value;
429 	__le32 mask;
430 } __packed;
431 
432 /* ieee80211_radiotap_eht - content of EHT tlv (type 34)
433  * see www.radiotap.org/fields/EHT.html for details
434  */
435 struct ieee80211_radiotap_eht {
436 	__le32 known;
437 	__le32 data[9];
438 	__le32 user_info[];
439 } __packed;
440 
441 /* Known field for EHT TLV
442  * The ending defines for what the field applies as following
443  * O - OFDMA (including TB), M - MU-MIMO, S - EHT sounding.
444  */
445 enum ieee80211_radiotap_eht_known {
446 	IEEE80211_RADIOTAP_EHT_KNOWN_SPATIAL_REUSE		= 0x00000002,
447 	IEEE80211_RADIOTAP_EHT_KNOWN_GI				= 0x00000004,
448 	IEEE80211_RADIOTAP_EHT_KNOWN_EHT_LTF			= 0x00000010,
449 	IEEE80211_RADIOTAP_EHT_KNOWN_LDPC_EXTRA_SYM_OM		= 0x00000020,
450 	IEEE80211_RADIOTAP_EHT_KNOWN_PRE_PADD_FACOR_OM		= 0x00000040,
451 	IEEE80211_RADIOTAP_EHT_KNOWN_PE_DISAMBIGUITY_OM		= 0x00000080,
452 	IEEE80211_RADIOTAP_EHT_KNOWN_DISREGARD_O		= 0x00000100,
453 	IEEE80211_RADIOTAP_EHT_KNOWN_DISREGARD_S		= 0x00000200,
454 	IEEE80211_RADIOTAP_EHT_KNOWN_CRC1			= 0x00002000,
455 	IEEE80211_RADIOTAP_EHT_KNOWN_TAIL1			= 0x00004000,
456 	IEEE80211_RADIOTAP_EHT_KNOWN_CRC2_O			= 0x00008000,
457 	IEEE80211_RADIOTAP_EHT_KNOWN_TAIL2_O			= 0x00010000,
458 	IEEE80211_RADIOTAP_EHT_KNOWN_NSS_S			= 0x00020000,
459 	IEEE80211_RADIOTAP_EHT_KNOWN_BEAMFORMED_S		= 0x00040000,
460 	IEEE80211_RADIOTAP_EHT_KNOWN_NR_NON_OFDMA_USERS_M	= 0x00080000,
461 	IEEE80211_RADIOTAP_EHT_KNOWN_ENCODING_BLOCK_CRC_M	= 0x00100000,
462 	IEEE80211_RADIOTAP_EHT_KNOWN_ENCODING_BLOCK_TAIL_M	= 0x00200000,
463 	IEEE80211_RADIOTAP_EHT_KNOWN_RU_MRU_SIZE_OM		= 0x00400000,
464 	IEEE80211_RADIOTAP_EHT_KNOWN_RU_MRU_INDEX_OM		= 0x00800000,
465 	IEEE80211_RADIOTAP_EHT_KNOWN_RU_ALLOC_TB_FMT		= 0x01000000,
466 	IEEE80211_RADIOTAP_EHT_KNOWN_PRIMARY_80			= 0x02000000,
467 };
468 
469 enum ieee80211_radiotap_eht_data {
470 	/* Data 0 */
471 	IEEE80211_RADIOTAP_EHT_DATA0_SPATIAL_REUSE		= 0x00000078,
472 	IEEE80211_RADIOTAP_EHT_DATA0_GI				= 0x00000180,
473 	IEEE80211_RADIOTAP_EHT_DATA0_LTF			= 0x00000600,
474 	IEEE80211_RADIOTAP_EHT_DATA0_EHT_LTF			= 0x00003800,
475 	IEEE80211_RADIOTAP_EHT_DATA0_LDPC_EXTRA_SYM_OM		= 0x00004000,
476 	IEEE80211_RADIOTAP_EHT_DATA0_PRE_PADD_FACOR_OM		= 0x00018000,
477 	IEEE80211_RADIOTAP_EHT_DATA0_PE_DISAMBIGUITY_OM		= 0x00020000,
478 	IEEE80211_RADIOTAP_EHT_DATA0_DISREGARD_S		= 0x000c0000,
479 	IEEE80211_RADIOTAP_EHT_DATA0_DISREGARD_O		= 0x003c0000,
480 	IEEE80211_RADIOTAP_EHT_DATA0_CRC1_O			= 0x03c00000,
481 	IEEE80211_RADIOTAP_EHT_DATA0_TAIL1_O			= 0xfc000000,
482 	/* Data 1 */
483 	IEEE80211_RADIOTAP_EHT_DATA1_RU_SIZE			= 0x0000001f,
484 	IEEE80211_RADIOTAP_EHT_DATA1_RU_INDEX			= 0x00001fe0,
485 	IEEE80211_RADIOTAP_EHT_DATA1_RU_ALLOC_CC_1_1_1		= 0x003fe000,
486 	IEEE80211_RADIOTAP_EHT_DATA1_RU_ALLOC_CC_1_1_1_KNOWN	= 0x00400000,
487 	IEEE80211_RADIOTAP_EHT_DATA1_PRIMARY_80			= 0xc0000000,
488 	/* Data 2 */
489 	IEEE80211_RADIOTAP_EHT_DATA2_RU_ALLOC_CC_2_1_1		= 0x000001ff,
490 	IEEE80211_RADIOTAP_EHT_DATA2_RU_ALLOC_CC_2_1_1_KNOWN	= 0x00000200,
491 	IEEE80211_RADIOTAP_EHT_DATA2_RU_ALLOC_CC_1_1_2		= 0x0007fc00,
492 	IEEE80211_RADIOTAP_EHT_DATA2_RU_ALLOC_CC_1_1_2_KNOWN	= 0x00080000,
493 	IEEE80211_RADIOTAP_EHT_DATA2_RU_ALLOC_CC_2_1_2		= 0x1ff00000,
494 	IEEE80211_RADIOTAP_EHT_DATA2_RU_ALLOC_CC_2_1_2_KNOWN	= 0x20000000,
495 	/* Data 3 */
496 	IEEE80211_RADIOTAP_EHT_DATA3_RU_ALLOC_CC_1_2_1		= 0x000001ff,
497 	IEEE80211_RADIOTAP_EHT_DATA3_RU_ALLOC_CC_1_2_1_KNOWN	= 0x00000200,
498 	IEEE80211_RADIOTAP_EHT_DATA3_RU_ALLOC_CC_2_2_1		= 0x0007fc00,
499 	IEEE80211_RADIOTAP_EHT_DATA3_RU_ALLOC_CC_2_2_1_KNOWN	= 0x00080000,
500 	IEEE80211_RADIOTAP_EHT_DATA3_RU_ALLOC_CC_1_2_2		= 0x1ff00000,
501 	IEEE80211_RADIOTAP_EHT_DATA3_RU_ALLOC_CC_1_2_2_KNOWN	= 0x20000000,
502 	/* Data 4 */
503 	IEEE80211_RADIOTAP_EHT_DATA4_RU_ALLOC_CC_2_2_2		= 0x000001ff,
504 	IEEE80211_RADIOTAP_EHT_DATA4_RU_ALLOC_CC_2_2_2_KNOWN	= 0x00000200,
505 	IEEE80211_RADIOTAP_EHT_DATA4_RU_ALLOC_CC_1_2_3		= 0x0007fc00,
506 	IEEE80211_RADIOTAP_EHT_DATA4_RU_ALLOC_CC_1_2_3_KNOWN	= 0x00080000,
507 	IEEE80211_RADIOTAP_EHT_DATA4_RU_ALLOC_CC_2_2_3		= 0x1ff00000,
508 	IEEE80211_RADIOTAP_EHT_DATA4_RU_ALLOC_CC_2_2_3_KNOWN	= 0x20000000,
509 	/* Data 5 */
510 	IEEE80211_RADIOTAP_EHT_DATA5_RU_ALLOC_CC_1_2_4		= 0x000001ff,
511 	IEEE80211_RADIOTAP_EHT_DATA5_RU_ALLOC_CC_1_2_4_KNOWN	= 0x00000200,
512 	IEEE80211_RADIOTAP_EHT_DATA5_RU_ALLOC_CC_2_2_4		= 0x0007fc00,
513 	IEEE80211_RADIOTAP_EHT_DATA5_RU_ALLOC_CC_2_2_4_KNOWN	= 0x00080000,
514 	IEEE80211_RADIOTAP_EHT_DATA5_RU_ALLOC_CC_1_2_5		= 0x1ff00000,
515 	IEEE80211_RADIOTAP_EHT_DATA5_RU_ALLOC_CC_1_2_5_KNOWN	= 0x20000000,
516 	/* Data 6 */
517 	IEEE80211_RADIOTAP_EHT_DATA6_RU_ALLOC_CC_2_2_5		= 0x000001ff,
518 	IEEE80211_RADIOTAP_EHT_DATA6_RU_ALLOC_CC_2_2_5_KNOWN	= 0x00000200,
519 	IEEE80211_RADIOTAP_EHT_DATA6_RU_ALLOC_CC_1_2_6		= 0x0007fc00,
520 	IEEE80211_RADIOTAP_EHT_DATA6_RU_ALLOC_CC_1_2_6_KNOWN	= 0x00080000,
521 	IEEE80211_RADIOTAP_EHT_DATA6_RU_ALLOC_CC_2_2_6		= 0x1ff00000,
522 	IEEE80211_RADIOTAP_EHT_DATA6_RU_ALLOC_CC_2_2_6_KNOWN	= 0x20000000,
523 	/* Data 7 */
524 	IEEE80211_RADIOTAP_EHT_DATA7_CRC2_O			= 0x0000000f,
525 	IEEE80211_RADIOTAP_EHT_DATA7_TAIL_2_O			= 0x000003f0,
526 	IEEE80211_RADIOTAP_EHT_DATA7_NSS_S			= 0x0000f000,
527 	IEEE80211_RADIOTAP_EHT_DATA7_BEAMFORMED_S		= 0x00010000,
528 	IEEE80211_RADIOTAP_EHT_DATA7_NUM_OF_NON_OFDMA_USERS	= 0x000e0000,
529 	IEEE80211_RADIOTAP_EHT_DATA7_USER_ENCODING_BLOCK_CRC	= 0x00f00000,
530 	IEEE80211_RADIOTAP_EHT_DATA7_USER_ENCODING_BLOCK_TAIL	= 0x3f000000,
531 	/* Data 8 */
532 	IEEE80211_RADIOTAP_EHT_DATA8_RU_ALLOC_TB_FMT_PS_160	= 0x00000001,
533 	IEEE80211_RADIOTAP_EHT_DATA8_RU_ALLOC_TB_FMT_B0		= 0x00000002,
534 	IEEE80211_RADIOTAP_EHT_DATA8_RU_ALLOC_TB_FMT_B7_B1	= 0x000001fc,
535 };
536 
537 enum ieee80211_radiotap_eht_user_info {
538 	IEEE80211_RADIOTAP_EHT_USER_INFO_STA_ID_KNOWN		= 0x00000001,
539 	IEEE80211_RADIOTAP_EHT_USER_INFO_MCS_KNOWN		= 0x00000002,
540 	IEEE80211_RADIOTAP_EHT_USER_INFO_CODING_KNOWN		= 0x00000004,
541 	IEEE80211_RADIOTAP_EHT_USER_INFO_NSS_KNOWN_O		= 0x00000010,
542 	IEEE80211_RADIOTAP_EHT_USER_INFO_BEAMFORMING_KNOWN_O	= 0x00000020,
543 	IEEE80211_RADIOTAP_EHT_USER_INFO_SPATIAL_CONFIG_KNOWN_M	= 0x00000040,
544 	IEEE80211_RADIOTAP_EHT_USER_INFO_DATA_FOR_USER		= 0x00000080,
545 	IEEE80211_RADIOTAP_EHT_USER_INFO_STA_ID			= 0x0007ff00,
546 	IEEE80211_RADIOTAP_EHT_USER_INFO_CODING			= 0x00080000,
547 	IEEE80211_RADIOTAP_EHT_USER_INFO_MCS			= 0x00f00000,
548 	IEEE80211_RADIOTAP_EHT_USER_INFO_NSS_O			= 0x0f000000,
549 	IEEE80211_RADIOTAP_EHT_USER_INFO_BEAMFORMING_O		= 0x20000000,
550 	IEEE80211_RADIOTAP_EHT_USER_INFO_SPATIAL_CONFIG_M	= 0x3f000000,
551 	IEEE80211_RADIOTAP_EHT_USER_INFO_RESEVED_c0000000	= 0xc0000000,
552 };
553 
554 enum ieee80211_radiotap_eht_usig_common {
555 	IEEE80211_RADIOTAP_EHT_USIG_COMMON_PHY_VER_KNOWN	= 0x00000001,
556 	IEEE80211_RADIOTAP_EHT_USIG_COMMON_BW_KNOWN		= 0x00000002,
557 	IEEE80211_RADIOTAP_EHT_USIG_COMMON_UL_DL_KNOWN		= 0x00000004,
558 	IEEE80211_RADIOTAP_EHT_USIG_COMMON_BSS_COLOR_KNOWN	= 0x00000008,
559 	IEEE80211_RADIOTAP_EHT_USIG_COMMON_TXOP_KNOWN		= 0x00000010,
560 	IEEE80211_RADIOTAP_EHT_USIG_COMMON_BAD_USIG_CRC		= 0x00000020,
561 	IEEE80211_RADIOTAP_EHT_USIG_COMMON_VALIDATE_BITS_CHECKED = 0x00000040,
562 	IEEE80211_RADIOTAP_EHT_USIG_COMMON_VALIDATE_BITS_OK	= 0x00000080,
563 	IEEE80211_RADIOTAP_EHT_USIG_COMMON_PHY_VER		= 0x00007000,
564 	IEEE80211_RADIOTAP_EHT_USIG_COMMON_BW			= 0x00038000,
565 		IEEE80211_RADIOTAP_EHT_USIG_COMMON_BW_20MHZ		= 0,
566 		IEEE80211_RADIOTAP_EHT_USIG_COMMON_BW_40MHZ		= 1,
567 		IEEE80211_RADIOTAP_EHT_USIG_COMMON_BW_80MHZ		= 2,
568 		IEEE80211_RADIOTAP_EHT_USIG_COMMON_BW_160MHZ		= 3,
569 		IEEE80211_RADIOTAP_EHT_USIG_COMMON_BW_320MHZ_1		= 4,
570 		IEEE80211_RADIOTAP_EHT_USIG_COMMON_BW_320MHZ_2		= 5,
571 	IEEE80211_RADIOTAP_EHT_USIG_COMMON_UL_DL		= 0x00040000,
572 	IEEE80211_RADIOTAP_EHT_USIG_COMMON_BSS_COLOR		= 0x01f80000,
573 	IEEE80211_RADIOTAP_EHT_USIG_COMMON_TXOP			= 0xfe000000,
574 };
575 
576 enum ieee80211_radiotap_eht_usig_mu {
577 	/* MU-USIG-1 */
578 	IEEE80211_RADIOTAP_EHT_USIG1_MU_B20_B24_DISREGARD	= 0x0000001f,
579 	IEEE80211_RADIOTAP_EHT_USIG1_MU_B25_VALIDATE		= 0x00000020,
580 	/* MU-USIG-2 */
581 	IEEE80211_RADIOTAP_EHT_USIG2_MU_B0_B1_PPDU_TYPE		= 0x000000c0,
582 	IEEE80211_RADIOTAP_EHT_USIG2_MU_B2_VALIDATE		= 0x00000100,
583 	IEEE80211_RADIOTAP_EHT_USIG2_MU_B3_B7_PUNCTURED_INFO	= 0x00003e00,
584 	IEEE80211_RADIOTAP_EHT_USIG2_MU_B8_VALIDATE		= 0x00004000,
585 	IEEE80211_RADIOTAP_EHT_USIG2_MU_B9_B10_SIG_MCS		= 0x00018000,
586 	IEEE80211_RADIOTAP_EHT_USIG2_MU_B11_B15_EHT_SIG_SYMBOLS = 0x003e0000,
587 	IEEE80211_RADIOTAP_EHT_USIG2_MU_B16_B19_CRC		= 0x03c00000,
588 	IEEE80211_RADIOTAP_EHT_USIG2_MU_B20_B25_TAIL		= 0xfc000000,
589 };
590 
591 enum ieee80211_radiotap_eht_usig_tb {
592 	/* TB-USIG-1 */
593 	IEEE80211_RADIOTAP_EHT_USIG1_TB_B20_B25_DISREGARD	= 0x0000001f,
594 
595 	/* TB-USIG-2 */
596 	IEEE80211_RADIOTAP_EHT_USIG2_TB_B0_B1_PPDU_TYPE		= 0x000000c0,
597 	IEEE80211_RADIOTAP_EHT_USIG2_TB_B2_VALIDATE		= 0x00000100,
598 	IEEE80211_RADIOTAP_EHT_USIG2_TB_B3_B6_SPATIAL_REUSE_1	= 0x00001e00,
599 	IEEE80211_RADIOTAP_EHT_USIG2_TB_B7_B10_SPATIAL_REUSE_2	= 0x0001e000,
600 	IEEE80211_RADIOTAP_EHT_USIG2_TB_B11_B15_DISREGARD	= 0x003e0000,
601 	IEEE80211_RADIOTAP_EHT_USIG2_TB_B16_B19_CRC		= 0x03c00000,
602 	IEEE80211_RADIOTAP_EHT_USIG2_TB_B20_B25_TAIL		= 0xfc000000,
603 };
604 
605 /**
606  * ieee80211_get_radiotap_len - get radiotap header length
607  * @data: pointer to the header
608  * Return: the radiotap header length
609  */
610 static inline u16 ieee80211_get_radiotap_len(const char *data)
611 {
612 	const struct ieee80211_radiotap_header *hdr = (const void *)data;
613 
614 	return get_unaligned_le16(&hdr->it_len);
615 }
616 
617 #endif /* __RADIOTAP_H */
618