xref: /OK3568_Linux_fs/external/rkwifibt/drivers/bcmdhd/include/bcmwifi_radiotap.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)

/*
 * 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_ */