LXR linux/include/net/ieee80211

   1/*
   2 * Copyright (c) 2017           Intel Deutschland GmbH
   3 *
   4 * Permission to use, copy, modify, and/or distribute this software for any
   5 * purpose with or without fee is hereby granted, provided that the above
   6 * copyright notice and this permission notice appear in all copies.
   7 *
   8 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
   9 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  10 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  11 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  12 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  13 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  14 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  15 */
  16#ifndef __RADIOTAP_H
  17#define __RADIOTAP_H
  18
  19#include <linux/kernel.h>
  20#include <asm/unaligned.h>
  21
  22/**
  23 * struct ieee82011_radiotap_header - base radiotap header
  24 */
  25struct ieee80211_radiotap_header {
  26        /**
  27         * @it_version: radiotap version, always 0
  28         */
  29        uint8_t it_version;
  30
  31        /**
  32         * @it_pad: padding (or alignment)
  33         */
  34        uint8_t it_pad;
  35
  36        /**
  37         * @it_len: overall radiotap header length
  38         */
  39        __le16 it_len;
  40
  41        /**
  42         * @it_present: (first) present word
  43         */
  44        __le32 it_present;
  45} __packed;
  46
  47/* version is always 0 */
  48#define PKTHDR_RADIOTAP_VERSION 0
  49
  50/* see the radiotap website for the descriptions */
  51enum ieee80211_radiotap_presence {
  52        IEEE80211_RADIOTAP_TSFT = 0,
  53        IEEE80211_RADIOTAP_FLAGS = 1,
  54        IEEE80211_RADIOTAP_RATE = 2,
  55        IEEE80211_RADIOTAP_CHANNEL = 3,
  56        IEEE80211_RADIOTAP_FHSS = 4,
  57        IEEE80211_RADIOTAP_DBM_ANTSIGNAL = 5,
  58        IEEE80211_RADIOTAP_DBM_ANTNOISE = 6,
  59        IEEE80211_RADIOTAP_LOCK_QUALITY = 7,
  60        IEEE80211_RADIOTAP_TX_ATTENUATION = 8,
  61        IEEE80211_RADIOTAP_DB_TX_ATTENUATION = 9,
  62        IEEE80211_RADIOTAP_DBM_TX_POWER = 10,
  63        IEEE80211_RADIOTAP_ANTENNA = 11,
  64        IEEE80211_RADIOTAP_DB_ANTSIGNAL = 12,
  65        IEEE80211_RADIOTAP_DB_ANTNOISE = 13,
  66        IEEE80211_RADIOTAP_RX_FLAGS = 14,
  67        IEEE80211_RADIOTAP_TX_FLAGS = 15,
  68        IEEE80211_RADIOTAP_RTS_RETRIES = 16,
  69        IEEE80211_RADIOTAP_DATA_RETRIES = 17,
  70        /* 18 is XChannel, but it's not defined yet */
  71        IEEE80211_RADIOTAP_MCS = 19,
  72        IEEE80211_RADIOTAP_AMPDU_STATUS = 20,
  73        IEEE80211_RADIOTAP_VHT = 21,
  74        IEEE80211_RADIOTAP_TIMESTAMP = 22,
  75
  76        /* valid in every it_present bitmap, even vendor namespaces */
  77        IEEE80211_RADIOTAP_RADIOTAP_NAMESPACE = 29,
  78        IEEE80211_RADIOTAP_VENDOR_NAMESPACE = 30,
  79        IEEE80211_RADIOTAP_EXT = 31
  80};
  81
  82/* for IEEE80211_RADIOTAP_FLAGS */
  83enum ieee80211_radiotap_flags {
  84        IEEE80211_RADIOTAP_F_CFP = 0x01,
  85        IEEE80211_RADIOTAP_F_SHORTPRE = 0x02,
  86        IEEE80211_RADIOTAP_F_WEP = 0x04,
  87        IEEE80211_RADIOTAP_F_FRAG = 0x08,
  88        IEEE80211_RADIOTAP_F_FCS = 0x10,
  89        IEEE80211_RADIOTAP_F_DATAPAD = 0x20,
  90        IEEE80211_RADIOTAP_F_BADFCS = 0x40,
  91};
  92
  93/* for IEEE80211_RADIOTAP_CHANNEL */
  94enum ieee80211_radiotap_channel_flags {
  95        IEEE80211_CHAN_CCK = 0x0020,
  96        IEEE80211_CHAN_OFDM = 0x0040,
  97        IEEE80211_CHAN_2GHZ = 0x0080,
  98        IEEE80211_CHAN_5GHZ = 0x0100,
  99        IEEE80211_CHAN_DYN = 0x0400,
 100        IEEE80211_CHAN_HALF = 0x4000,
 101        IEEE80211_CHAN_QUARTER = 0x8000,
 102};
 103
 104/* for IEEE80211_RADIOTAP_RX_FLAGS */
 105enum ieee80211_radiotap_rx_flags {
 106        IEEE80211_RADIOTAP_F_RX_BADPLCP = 0x0002,
 107};
 108
 109/* for IEEE80211_RADIOTAP_TX_FLAGS */
 110enum ieee80211_radiotap_tx_flags {
 111        IEEE80211_RADIOTAP_F_TX_FAIL = 0x0001,
 112        IEEE80211_RADIOTAP_F_TX_CTS = 0x0002,
 113        IEEE80211_RADIOTAP_F_TX_RTS = 0x0004,
 114        IEEE80211_RADIOTAP_F_TX_NOACK = 0x0008,
 115};
 116
 117/* for IEEE80211_RADIOTAP_MCS "have" flags */
 118enum ieee80211_radiotap_mcs_have {
 119        IEEE80211_RADIOTAP_MCS_HAVE_BW = 0x01,
 120        IEEE80211_RADIOTAP_MCS_HAVE_MCS = 0x02,
 121        IEEE80211_RADIOTAP_MCS_HAVE_GI = 0x04,
 122        IEEE80211_RADIOTAP_MCS_HAVE_FMT = 0x08,
 123        IEEE80211_RADIOTAP_MCS_HAVE_FEC = 0x10,
 124        IEEE80211_RADIOTAP_MCS_HAVE_STBC = 0x20,
 125};
 126
 127enum ieee80211_radiotap_mcs_flags {
 128        IEEE80211_RADIOTAP_MCS_BW_MASK = 0x03,
 129        IEEE80211_RADIOTAP_MCS_BW_20 = 0,
 130        IEEE80211_RADIOTAP_MCS_BW_40 = 1,
 131        IEEE80211_RADIOTAP_MCS_BW_20L = 2,
 132        IEEE80211_RADIOTAP_MCS_BW_20U = 3,
 133
 134        IEEE80211_RADIOTAP_MCS_SGI = 0x04,
 135        IEEE80211_RADIOTAP_MCS_FMT_GF = 0x08,
 136        IEEE80211_RADIOTAP_MCS_FEC_LDPC = 0x10,
 137        IEEE80211_RADIOTAP_MCS_STBC_MASK = 0x60,
 138        IEEE80211_RADIOTAP_MCS_STBC_1 = 1,
 139        IEEE80211_RADIOTAP_MCS_STBC_2 = 2,
 140        IEEE80211_RADIOTAP_MCS_STBC_3 = 3,
 141        IEEE80211_RADIOTAP_MCS_STBC_SHIFT = 5,
 142};
 143
 144/* for IEEE80211_RADIOTAP_AMPDU_STATUS */
 145enum ieee80211_radiotap_ampdu_flags {
 146        IEEE80211_RADIOTAP_AMPDU_REPORT_ZEROLEN = 0x0001,
 147        IEEE80211_RADIOTAP_AMPDU_IS_ZEROLEN = 0x0002,
 148        IEEE80211_RADIOTAP_AMPDU_LAST_KNOWN = 0x0004,
 149        IEEE80211_RADIOTAP_AMPDU_IS_LAST = 0x0008,
 150        IEEE80211_RADIOTAP_AMPDU_DELIM_CRC_ERR = 0x0010,
 151        IEEE80211_RADIOTAP_AMPDU_DELIM_CRC_KNOWN = 0x0020,
 152};
 153
 154/* for IEEE80211_RADIOTAP_VHT */
 155enum ieee80211_radiotap_vht_known {
 156        IEEE80211_RADIOTAP_VHT_KNOWN_STBC = 0x0001,
 157        IEEE80211_RADIOTAP_VHT_KNOWN_TXOP_PS_NA = 0x0002,
 158        IEEE80211_RADIOTAP_VHT_KNOWN_GI = 0x0004,
 159        IEEE80211_RADIOTAP_VHT_KNOWN_SGI_NSYM_DIS = 0x0008,
 160        IEEE80211_RADIOTAP_VHT_KNOWN_LDPC_EXTRA_OFDM_SYM = 0x0010,
 161        IEEE80211_RADIOTAP_VHT_KNOWN_BEAMFORMED = 0x0020,
 162        IEEE80211_RADIOTAP_VHT_KNOWN_BANDWIDTH = 0x0040,
 163        IEEE80211_RADIOTAP_VHT_KNOWN_GROUP_ID = 0x0080,
 164        IEEE80211_RADIOTAP_VHT_KNOWN_PARTIAL_AID = 0x0100,
 165};
 166
 167enum ieee80211_radiotap_vht_flags {
 168        IEEE80211_RADIOTAP_VHT_FLAG_STBC = 0x01,
 169        IEEE80211_RADIOTAP_VHT_FLAG_TXOP_PS_NA = 0x02,
 170        IEEE80211_RADIOTAP_VHT_FLAG_SGI = 0x04,
 171        IEEE80211_RADIOTAP_VHT_FLAG_SGI_NSYM_M10_9 = 0x08,
 172        IEEE80211_RADIOTAP_VHT_FLAG_LDPC_EXTRA_OFDM_SYM = 0x10,
 173        IEEE80211_RADIOTAP_VHT_FLAG_BEAMFORMED = 0x20,
 174};
 175
 176enum ieee80211_radiotap_vht_coding {
 177        IEEE80211_RADIOTAP_CODING_LDPC_USER0 = 0x01,
 178        IEEE80211_RADIOTAP_CODING_LDPC_USER1 = 0x02,
 179        IEEE80211_RADIOTAP_CODING_LDPC_USER2 = 0x04,
 180        IEEE80211_RADIOTAP_CODING_LDPC_USER3 = 0x08,
 181};
 182
 183/* for IEEE80211_RADIOTAP_TIMESTAMP */
 184enum ieee80211_radiotap_timestamp_unit_spos {
 185        IEEE80211_RADIOTAP_TIMESTAMP_UNIT_MASK = 0x000F,
 186        IEEE80211_RADIOTAP_TIMESTAMP_UNIT_MS = 0x0000,
 187        IEEE80211_RADIOTAP_TIMESTAMP_UNIT_US = 0x0001,
 188        IEEE80211_RADIOTAP_TIMESTAMP_UNIT_NS = 0x0003,
 189        IEEE80211_RADIOTAP_TIMESTAMP_SPOS_MASK = 0x00F0,
 190        IEEE80211_RADIOTAP_TIMESTAMP_SPOS_BEGIN_MDPU = 0x0000,
 191        IEEE80211_RADIOTAP_TIMESTAMP_SPOS_PLCP_SIG_ACQ = 0x0010,
 192        IEEE80211_RADIOTAP_TIMESTAMP_SPOS_EO_PPDU = 0x0020,
 193        IEEE80211_RADIOTAP_TIMESTAMP_SPOS_EO_MPDU = 0x0030,
 194        IEEE80211_RADIOTAP_TIMESTAMP_SPOS_UNKNOWN = 0x00F0,
 195};
 196
 197enum ieee80211_radiotap_timestamp_flags {
 198        IEEE80211_RADIOTAP_TIMESTAMP_FLAG_64BIT = 0x00,
 199        IEEE80211_RADIOTAP_TIMESTAMP_FLAG_32BIT = 0x01,
 200        IEEE80211_RADIOTAP_TIMESTAMP_FLAG_ACCURACY = 0x02,
 201};
 202
 203/**
 204 * ieee80211_get_radiotap_len - get radiotap header length
 205 */
 206static inline u16 ieee80211_get_radiotap_len(const char *data)
 207{
 208        struct ieee80211_radiotap_header *hdr = (void *)data;
 209
 210        return get_unaligned_le16(&hdr->it_len);
 211}
 212
 213#endif /* __RADIOTAP_H */
 214