/*
|
* RadioTap utility routines for WL and Apps
|
* This header file housing the define and function prototype use by
|
* both the wl driver, tools & Apps.
|
*
|
* Copyright (C) 2020, Broadcom.
|
*
|
* Unless you and Broadcom execute a separate written software license
|
* agreement governing use of this software, this software is licensed to you
|
* under the terms of the GNU General Public License version 2 (the "GPL"),
|
* available at http://www.broadcom.com/licenses/GPLv2.php, with the
|
* following added to such license:
|
*
|
* As a special exception, the copyright holders of this software give you
|
* permission to link this software with independent modules, and to copy and
|
* distribute the resulting executable under terms of your choice, provided that
|
* you also meet, for each linked independent module, the terms and conditions of
|
* the license of that module. An independent module is a module which is not
|
* derived from this software. The special exception does not apply to any
|
* modifications of the software.
|
*
|
*
|
* <<Broadcom-WL-IPTag/Dual:>>
|
*/
|
|
#ifndef _BCMWIFI_RADIOTAP_H_
|
#define _BCMWIFI_RADIOTAP_H_
|
|
#include <ieee80211_radiotap.h>
|
#include <siutils.h>
|
#include <monitor.h>
|
#include <802.11.h>
|
#include <802.11ax.h>
|
#include "bcmwifi_monitor.h"
|
#include <bcmwifi_rspec.h>
|
#include <bcmwifi_rates.h>
|
|
/* This marks the start of a packed structure section. */
|
#include <packed_section_start.h>
|
/*
|
* RadioTap header specific implementation. Used by MacOS implementation only.
|
*/
|
BWL_PRE_PACKED_STRUCT struct wl_radiotap_hdr {
|
struct ieee80211_radiotap_header ieee_radiotap;
|
uint64 tsft;
|
uint8 flags;
|
union {
|
uint8 rate;
|
uint8 pad;
|
} u;
|
uint16 channel_freq;
|
uint16 channel_flags;
|
} BWL_POST_PACKED_STRUCT;
|
|
BWL_PRE_PACKED_STRUCT struct wl_radiotap_sna {
|
uint8 signal;
|
uint8 noise;
|
uint8 antenna;
|
} BWL_POST_PACKED_STRUCT;
|
|
BWL_PRE_PACKED_STRUCT struct wl_radiotap_xchan {
|
uint32 xchannel_flags;
|
uint16 xchannel_freq;
|
uint8 xchannel_channel;
|
uint8 xchannel_maxpower;
|
} BWL_POST_PACKED_STRUCT;
|
|
BWL_PRE_PACKED_STRUCT struct wl_radiotap_ampdu {
|
uint32 ref_num;
|
uint16 flags;
|
uint8 delimiter_crc;
|
uint8 reserved;
|
} BWL_POST_PACKED_STRUCT;
|
|
BWL_PRE_PACKED_STRUCT struct wl_htmcs {
|
uint8 mcs_known;
|
uint8 mcs_flags;
|
uint8 mcs_index;
|
uint8 pad; /* pad to 32 bit aligned */
|
} BWL_POST_PACKED_STRUCT;
|
|
BWL_PRE_PACKED_STRUCT struct wl_vhtmcs {
|
uint16 vht_known; /* IEEE80211_RADIOTAP_VHT */
|
uint8 vht_flags;
|
uint8 vht_bw;
|
uint8 vht_mcs_nss[4];
|
uint8 vht_coding;
|
uint8 vht_group_id;
|
uint16 vht_partial_aid;
|
} BWL_POST_PACKED_STRUCT;
|
|
BWL_PRE_PACKED_STRUCT struct wl_radiotap_ht_tail {
|
struct wl_radiotap_xchan xc;
|
struct wl_radiotap_ampdu ampdu;
|
union {
|
struct wl_htmcs ht;
|
struct wl_vhtmcs vht;
|
} u;
|
} BWL_POST_PACKED_STRUCT;
|
|
typedef struct bsd_header_rx {
|
struct wl_radiotap_hdr hdr;
|
/*
|
* include extra space beyond wl_radiotap_ht size
|
* (larger of two structs in union):
|
* signal/noise/ant plus max of 3 pad for xchannel
|
* tail struct (xchannel and MCS info)
|
*/
|
uint8 pad[3];
|
uint8 ht[sizeof(struct wl_radiotap_ht_tail)];
|
} bsd_header_rx_t;
|
|
typedef struct radiotap_parse {
|
struct ieee80211_radiotap_header *hdr;
|
void *fields;
|
uint fields_len;
|
uint idx;
|
uint offset;
|
} radiotap_parse_t;
|
|
struct rtap_field {
|
uint len;
|
uint align;
|
};
|
|
/* he radiotap - https://www.radiotap.org/fields/HE.html */
|
#define HE_RADIOTAP_BSS_COLOR_SHIFT 0u
|
#define HE_RADIOTAP_BEAM_CHANGE_SHIFT 6u
|
#define HE_RADIOTAP_DL_UL_SHIFT 7u
|
#define HE_RADIOTAP_MCS_SHIFT 8u
|
#define HE_RADIOTAP_DCM_SHIFT 12u
|
#define HE_RADIOTAP_CODING_SHIFT 13u
|
#define HE_RADIOTAP_LDPC_SHIFT 14u
|
#define HE_RADIOTAP_STBC_SHIFT 15u
|
#define HE_RADIOTAP_SR_SHIFT 0u
|
#define HE_RADIOTAP_STAID_SHIFT 4u
|
#define HE_RADIOTAP_SR1_SHIFT 0u
|
#define HE_RADIOTAP_SR2_SHIFT 4u
|
#define HE_RADIOTAP_SR3_SHIFT 8u
|
#define HE_RADIOTAP_SR4_SHIFT 12u
|
#define HE_RADIOTAP_BW_SHIFT 0u
|
#define HE_RADIOTAP_RU_ALLOC_SHIFT 0u
|
#define HE_RADIOTAP_GI_SHIFT 4u
|
#define HE_RADIOTAP_LTF_SIZE_SHIFT 6u
|
#define HE_RADIOTAP_NUM_LTF_SHIFT 8u
|
#define HE_RADIOTAP_PADDING_SHIFT 12u
|
#define HE_RADIOTAP_TXBF_SHIFT 14u
|
#define HE_RADIOTAP_PE_SHIFT 15u
|
#define HE_RADIOTAP_NSTS_SHIFT 0u
|
#define HE_RADIOTAP_DOPPLER_SHIFT 4u
|
#define HE_RADIOTAP_TXOP_SHIFT 8u
|
#define HE_RADIOTAP_MIDAMBLE_SHIFT 15u
|
#define HE_RADIOTAP_DOPPLER_SET_NSTS_SHIFT 0u
|
#define HE_RADIOTAP_DOPPLER_NOTSET_NSTS_SHIFT 0u
|
|
/* he mu radiotap - https://www.radiotap.org/fields/HE-MU.html */
|
#define HE_RADIOTAP_SIGB_MCS_SHIFT 0u
|
#define HE_RADIOTAP_SIGB_MCS_KNOWN_SHIFT 4u
|
#define HE_RADIOTAP_SIGB_DCM_SHIFT 5u
|
#define HE_RADIOTAP_SIGB_DCM_KNOWN_SHIFT 6u
|
#define HE_RADIOTAP_SIGB_COMP_KNOWN_SHIFT 14u
|
#define HE_RADIOTAP_SIGB_COMP_SHIFT 3u
|
#define HE_RADIOTAP_SIGB_SYMB_SHIFT 18u
|
#define HE_RADIOTAP_BW_SIGA_SHIFT 0u
|
#define HE_RADIOTAP_BW_SIGA_KNOWN_SHIFT 2u
|
#define HE_RADIOTAP_SIGB_SYM_MU_MIMO_USER_SHIFT 4u
|
#define HE_RADIOTAP_PRE_PUNCR_SIGA_SHIFT 8u
|
#define HE_RADIOTAP_PRE_PUNCR_SIGA_KNOWN_SHIFT 10u
|
|
#define WL_RADIOTAP_BRCM_SNS 0x01
|
#define WL_RADIOTAP_BRCM_MCS 0x00000001
|
#define WL_RADIOTAP_LEGACY_SNS 0x02
|
#define WL_RADIOTAP_LEGACY_VHT 0x00000001
|
#define WL_RADIOTAP_BRCM_PAD_SNS 0x3
|
|
#define IEEE80211_RADIOTAP_HTMOD_40 0x01
|
#define IEEE80211_RADIOTAP_HTMOD_SGI 0x02
|
#define IEEE80211_RADIOTAP_HTMOD_GF 0x04
|
#define IEEE80211_RADIOTAP_HTMOD_LDPC 0x08
|
#define IEEE80211_RADIOTAP_HTMOD_STBC_MASK 0x30
|
#define IEEE80211_RADIOTAP_HTMOD_STBC_SHIFT 4
|
|
/* Dyanmic bandwidth for VHT signaled in NONHT */
|
#define WL_RADIOTAP_F_NONHT_VHT_DYN_BW 0x01
|
/* VHT BW is valid in NONHT */
|
#define WL_RADIOTAP_F_NONHT_VHT_BW 0x02
|
|
typedef struct ieee80211_radiotap_header ieee80211_radiotap_header_t;
|
|
/* VHT information in non-HT frames; primarily VHT b/w signaling
|
* in frames received at legacy rates.
|
*/
|
BWL_PRE_PACKED_STRUCT struct wl_radiotap_nonht_vht {
|
uint8 len; /* length of the field excluding 'len' field */
|
uint8 flags;
|
uint8 bw;
|
uint8 PAD; /* Add a pad so the next vendor entry, if any, will be 16 bit aligned */
|
} BWL_POST_PACKED_STRUCT;
|
|
typedef struct wl_radiotap_nonht_vht wl_radiotap_nonht_vht_t;
|
|
BWL_PRE_PACKED_STRUCT struct wl_radiotap_basic {
|
uint32 tsft_l;
|
uint32 tsft_h;
|
uint8 flags;
|
uint8 rate; /* this field acts as a pad for non legacy packets */
|
uint16 channel_freq;
|
uint16 channel_flags;
|
uint8 signal;
|
uint8 noise;
|
int8 antenna;
|
} BWL_POST_PACKED_STRUCT;
|
|
typedef struct wl_radiotap_basic wl_radiotap_basic_t;
|
|
/* radiotap standard - non-HT, non-VHT information with Broadcom vendor namespace extension
|
* that includes VHT information.
|
* Used with monitor type 3 when received by HT/Legacy PHY and received rate is legacy.
|
* Struct ieee80211_radiotap_header is of variable length due to possible
|
* extra it_present bitmap fields.
|
* It should not be included as a static length field here
|
*/
|
BWL_PRE_PACKED_STRUCT struct wl_radiotap_legacy {
|
wl_radiotap_basic_t basic;
|
uint8 PAD;
|
} BWL_POST_PACKED_STRUCT;
|
|
typedef struct wl_radiotap_legacy wl_radiotap_legacy_t;
|
|
#define WL_RADIOTAP_LEGACY_SKIP_LEN htol16(sizeof(struct wl_radiotap_legacy) - \
|
OFFSETOF(struct wl_radiotap_legacy, nonht_vht))
|
|
#define WL_RADIOTAP_NONHT_VHT_LEN (sizeof(wl_radiotap_nonht_vht_t) - 1)
|
|
/* Radiotap standard that includes HT information. This is for use with monitor type 3
|
* whenever frame is received by HT-PHY, and received rate is non-VHT.
|
* Struct ieee80211_radiotap_header is of variable length due to possible
|
* extra it_present bitmap fields.
|
* It should not be included as a static length field here
|
*/
|
BWL_PRE_PACKED_STRUCT struct wl_radiotap_ht {
|
wl_radiotap_basic_t basic;
|
uint8 PAD[3];
|
uint32 xchannel_flags;
|
uint16 xchannel_freq;
|
uint8 xchannel_channel;
|
uint8 xchannel_maxpower;
|
uint8 mcs_known;
|
uint8 mcs_flags;
|
uint8 mcs_index;
|
uint8 PAD;
|
uint32 ampdu_ref_num; /* A-MPDU ID */
|
uint16 ampdu_flags; /* A-MPDU flags */
|
uint8 ampdu_delim_crc; /* Delimiter CRC if present in flags */
|
uint8 ampdu_reserved;
|
} BWL_POST_PACKED_STRUCT;
|
|
typedef struct wl_radiotap_ht wl_radiotap_ht_t;
|
|
/* Radiotap standard that includes VHT information.
|
* This is for use with monitor type 3 whenever frame is
|
* received by HT-PHY (VHT-PHY), and received rate is VHT.
|
* Struct ieee80211_radiotap_header is of variable length due to possible
|
* extra it_present bitmap fields.
|
* It should not be included as a static length field here
|
*/
|
BWL_PRE_PACKED_STRUCT struct wl_radiotap_vht {
|
wl_radiotap_basic_t basic;
|
uint8 PAD[3];
|
uint32 ampdu_ref_num; /* A-MPDU ID */
|
uint16 ampdu_flags; /* A-MPDU flags */
|
uint8 ampdu_delim_crc; /* Delimiter CRC if present in flags */
|
uint8 ampdu_reserved;
|
uint16 vht_known; /* IEEE80211_RADIOTAP_VHT */
|
uint8 vht_flags; /* IEEE80211_RADIOTAP_VHT */
|
uint8 vht_bw; /* IEEE80211_RADIOTAP_VHT */
|
uint8 vht_mcs_nss[4]; /* IEEE80211_RADIOTAP_VHT */
|
uint8 vht_coding; /* IEEE80211_RADIOTAP_VHT */
|
uint8 vht_group_id; /* IEEE80211_RADIOTAP_VHT */
|
uint16 vht_partial_aid; /* IEEE80211_RADIOTAP_VHT */
|
} BWL_POST_PACKED_STRUCT;
|
|
typedef struct wl_radiotap_vht wl_radiotap_vht_t;
|
|
/* Radiotap standard that includes HE information. */
|
BWL_PRE_PACKED_STRUCT struct wl_radiotap_he {
|
wl_radiotap_basic_t basic;
|
uint8 PAD[3];
|
uint32 ampdu_ref_num; /* A-MPDU ID */
|
uint16 ampdu_flags; /* A-MPDU flags */
|
uint8 ampdu_delim_crc; /* Delimiter CRC if present in flags */
|
uint8 ampdu_reserved;
|
uint16 data1;
|
uint16 data2;
|
uint16 data3;
|
uint16 data4;
|
uint16 data5;
|
uint16 data6;
|
} BWL_POST_PACKED_STRUCT;
|
|
typedef struct wl_radiotap_he wl_radiotap_he_t;
|
|
BWL_PRE_PACKED_STRUCT struct radiotap_vendor_ns {
|
uint8 vend_oui[3];
|
uint8 sns;
|
uint16 skip_len;
|
} BWL_POST_PACKED_STRUCT;
|
|
typedef struct radiotap_vendor_ns radiotap_vendor_ns_t;
|
|
#define WL_RADIOTAP_PRESENT_BASIC \
|
((1 << IEEE80211_RADIOTAP_TSFT) | \
|
(1 << IEEE80211_RADIOTAP_FLAGS) | \
|
(1 << IEEE80211_RADIOTAP_CHANNEL) | \
|
(1 << IEEE80211_RADIOTAP_DBM_ANTSIGNAL) | \
|
(1 << IEEE80211_RADIOTAP_DBM_ANTNOISE) | \
|
(1 << IEEE80211_RADIOTAP_ANTENNA))
|
|
#define WL_RADIOTAP_PRESENT_LEGACY \
|
WL_RADIOTAP_PRESENT_BASIC | \
|
(1 << IEEE80211_RADIOTAP_RATE)
|
|
#define WL_RADIOTAP_PRESENT_HT \
|
WL_RADIOTAP_PRESENT_BASIC | \
|
((1 << IEEE80211_RADIOTAP_XCHANNEL) | \
|
(1 << IEEE80211_RADIOTAP_MCS) | \
|
(1 << IEEE80211_RADIOTAP_AMPDU))
|
|
#define WL_RADIOTAP_PRESENT_VHT \
|
WL_RADIOTAP_PRESENT_BASIC | \
|
((1 << IEEE80211_RADIOTAP_AMPDU) | \
|
(1 << IEEE80211_RADIOTAP_VHT))
|
|
#define WL_RADIOTAP_PRESENT_HE \
|
WL_RADIOTAP_PRESENT_BASIC | \
|
((1 << IEEE80211_RADIOTAP_AMPDU) | \
|
(1 << IEEE80211_RADIOTAP_HE))
|
|
/* include/linux/if_arp.h
|
* #define ARPHRD_IEEE80211_PRISM 802 IEEE 802.11 + Prism2 header
|
* #define ARPHRD_IEEE80211_RADIOTAP 803 IEEE 802.11 + radiotap header
|
* include/net/ieee80211_radiotap.h
|
* radiotap structure
|
*/
|
|
#ifndef ARPHRD_IEEE80211_RADIOTAP
|
#define ARPHRD_IEEE80211_RADIOTAP 803
|
#endif
|
|
/* This marks the end of a packed structure section. */
|
#include <packed_section_end.h>
|
|
extern void wl_rtapParseInit(radiotap_parse_t *rtap, uint8 *rtap_header);
|
extern ratespec_t wl_calcRspecFromRTap(uint8 *rtap_header);
|
extern bool wl_rtapFlags(uint8 *rtap_header, uint8* flags);
|
extern uint wl_radiotap_rx(struct dot11_header *mac_header, wl_rxsts_t *rxsts,
|
bsd_header_rx_t *bsd_header);
|
extern uint wl_radiotap_rx_legacy(struct dot11_header *mac_header, wl_rxsts_t *rxsts,
|
ieee80211_radiotap_header_t* rtap_hdr);
|
extern uint wl_radiotap_rx_ht(struct dot11_header *mac_header, wl_rxsts_t *rxsts,
|
ieee80211_radiotap_header_t* rtap_hdr);
|
extern uint wl_radiotap_rx_vht(struct dot11_header *mac_header, wl_rxsts_t *rxsts,
|
ieee80211_radiotap_header_t* rtap_hdr);
|
extern uint wl_radiotap_rx_he(struct dot11_header *mac_header, wl_rxsts_t *rxsts,
|
ieee80211_radiotap_header_t* rtap_hdr);
|
extern uint wl_radiotap_rx_eht(struct dot11_header *mac_header, wl_rxsts_t *rxsts,
|
ieee80211_radiotap_header_t *rtap_hdr);
|
|
/* Legacy phy radiotap header may include VHT bw signaling VS element */
|
#define MAX_RADIOTAP_LEGACY_SIZE (sizeof(wl_radiotap_legacy_t) + \
|
sizeof(radiotap_vendor_ns_t) + sizeof(wl_radiotap_nonht_vht_t))
|
|
/* RadioTap header starts with a fixed struct ieee80211_radiotap_header,
|
* followed by variable fields for the 4 encodings supported, HE, VHT, HT, and Legacy
|
*/
|
#define MAX_RADIOTAP_SIZE (sizeof(struct ieee80211_radiotap_header) + \
|
MAX(sizeof(wl_radiotap_he_t), \
|
MAX(sizeof(wl_radiotap_vht_t), \
|
MAX(sizeof(wl_radiotap_ht_t), MAX_RADIOTAP_LEGACY_SIZE))))
|
#define MAX_MON_PKT_SIZE (4096 + MAX_RADIOTAP_SIZE)
|
|
#endif /* _BCMWIFI_RADIOTAP_H_ */
|
