ieee80211_radiotap.h

  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 */
 26struct 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
 55static_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 */
 62enum 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 */
101enum 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 */
112enum 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 */
123enum ieee80211_radiotap_rx_flags {
124	IEEE80211_RADIOTAP_F_RX_BADPLCP = 0x0002,
125};
126
127/* for IEEE80211_RADIOTAP_TX_FLAGS */
128enum 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 */
138enum 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
147enum 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 */
165enum 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 */
177enum 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
189enum 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
198enum 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
205enum 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
213struct 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 */
224enum 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
237enum 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
243struct ieee80211_radiotap_he {
244	__le16 data1, data2, data3, data4, data5, data6;
245};
246
247enum 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
337struct ieee80211_radiotap_he_mu {
338	__le16 flags1, flags2;
339	u8 ru_ch1[4];
340	u8 ru_ch2[4];
341};
342
343enum 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
369enum ieee80211_radiotap_lsig_data1 {
370	IEEE80211_RADIOTAP_LSIG_DATA1_RATE_KNOWN		= 0x0001,
371	IEEE80211_RADIOTAP_LSIG_DATA1_LENGTH_KNOWN		= 0x0002,
372};
373
374enum ieee80211_radiotap_lsig_data2 {
375	IEEE80211_RADIOTAP_LSIG_DATA2_RATE			= 0x000f,
376	IEEE80211_RADIOTAP_LSIG_DATA2_LENGTH			= 0xfff0,
377};
378
379struct ieee80211_radiotap_lsig {
380	__le16 data1, data2;
381};
382
383enum 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
389struct 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 */
403struct 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 */
417struct 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 */
426struct 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 */
435struct 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 */
445enum 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
469enum 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
537enum 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
554enum 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
576enum 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
591enum 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 */
610static 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 */