radiotap-header.h

Go to the documentation of this file.

/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
/*
 * Copyright (c) 2009 CTTC
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation;
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Include., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 * Authors: Nicola Baldo <nbaldo@cttc.es>
 *          Sébastien Deronne <sebastien.deronne@gmail.com>
 */

#ifndef RADIOTAP_HEADER_H
#define RADIOTAP_HEADER_H


#include <ns3/header.h>

namespace ns3 {

class RadiotapHeader : public Header
{
public:
  RadiotapHeader ();
  static TypeId GetTypeId (void);
  virtual TypeId GetInstanceTypeId (void) const;

  virtual uint32_t GetSerializedSize (void) const;

  virtual void Serialize (Buffer::Iterator start) const;

  virtual uint32_t Deserialize (Buffer::Iterator start);

  virtual void Print (std::ostream &os) const;

  void SetTsft (uint64_t tsft);

  uint64_t GetTsft (void) const;

  enum FrameFlag
  {
    FRAME_FLAG_NONE           = 0x00, 
    FRAME_FLAG_CFP            = 0x01, 
    FRAME_FLAG_SHORT_PREAMBLE = 0x02, 
    FRAME_FLAG_WEP            = 0x04, 
    FRAME_FLAG_FRAGMENTED     = 0x08, 
    FRAME_FLAG_FCS_INCLUDED   = 0x10, 
    FRAME_FLAG_DATA_PADDING   = 0x20, 
    FRAME_FLAG_BAD_FCS        = 0x40, 
    FRAME_FLAG_SHORT_GUARD    = 0x80  
  };

  void SetFrameFlags (uint8_t flags);

  uint8_t GetFrameFlags (void) const;

  void SetRate (uint8_t rate);

  uint8_t GetRate (void) const;

  enum ChannelFlags
  {
    CHANNEL_FLAG_NONE          = 0x0000, 
    CHANNEL_FLAG_TURBO         = 0x0010, 
    CHANNEL_FLAG_CCK           = 0x0020, 
    CHANNEL_FLAG_OFDM          = 0x0040, 
    CHANNEL_FLAG_SPECTRUM_2GHZ = 0x0080, 
    CHANNEL_FLAG_SPECTRUM_5GHZ = 0x0100, 
    CHANNEL_FLAG_PASSIVE       = 0x0200, 
    CHANNEL_FLAG_DYNAMIC       = 0x0400, 
    CHANNEL_FLAG_GFSK          = 0x0800  
  };

  void SetChannelFrequencyAndFlags (uint16_t frequency, uint16_t flags);

  uint16_t GetChannelFrequency (void) const;

  uint16_t GetChannelFlags (void) const;

  void SetAntennaSignalPower (double signal);

  uint8_t GetAntennaSignalPower (void) const;

  void SetAntennaNoisePower (double noise);

  uint8_t GetAntennaNoisePower (void) const;

  enum McsKnown
  {
    MCS_KNOWN_NONE           = 0x00, 
    MCS_KNOWN_BANDWIDTH      = 0x01, 
    MCS_KNOWN_INDEX          = 0x02, 
    MCS_KNOWN_GUARD_INTERVAL = 0x04, 
    MCS_KNOWN_HT_FORMAT      = 0x08, 
    MCS_KNOWN_FEC_TYPE       = 0x10, 
    MCS_KNOWN_STBC           = 0x20, 
    MCS_KNOWN_NESS           = 0x40, 
    MCS_KNOWN_NESS_BIT_1     = 0x80, 
  };

  enum McsFlags
  {
    MCS_FLAGS_NONE           = 0x00, 
    MCS_FLAGS_BANDWIDTH_40   = 0x01, 
    MCS_FLAGS_BANDWIDTH_20L  = 0x02, 
    MCS_FLAGS_BANDWIDTH_20U  = 0x03, 
    MCS_FLAGS_GUARD_INTERVAL = 0x04, 
    MCS_FLAGS_HT_GREENFIELD  = 0x08, 
    MCS_FLAGS_FEC_TYPE       = 0x10, 
    MCS_FLAGS_STBC_STREAMS   = 0x60, 
    MCS_FLAGS_NESS_BIT_0     = 0x80, 
  };

  void SetMcsFields (uint8_t known, uint8_t flags, uint8_t mcs);

  uint8_t GetMcsKnown (void) const;
  uint8_t GetMcsFlags (void) const;
  uint8_t GetMcsRate (void) const;

  enum AmpduFlags
  {
    A_MPDU_STATUS_NONE                = 0x00, 
    A_MPDU_STATUS_REPORT_ZERO_LENGTH  = 0x01, 
    A_MPDU_STATUS_IS_ZERO_LENGTH      = 0x02, 
    A_MPDU_STATUS_LAST_KNOWN          = 0x04, 
    A_MPDU_STATUS_LAST                = 0x08, 
    A_MPDU_STATUS_DELIMITER_CRC_ERROR = 0x10, 
    A_MPDU_STATUS_DELIMITER_CRC_KNOWN = 0x20  
  };

  void SetAmpduStatus (uint32_t referenceNumber, uint16_t flags, uint8_t crc);

  uint32_t GetAmpduStatusRef (void) const;
  uint16_t GetAmpduStatusFlags (void) const;

  enum VhtKnown
  {
    VHT_KNOWN_NONE                         = 0x0000, 
    VHT_KNOWN_STBC                         = 0x0001, 
    VHT_KNOWN_TXOP_PS_NOT_ALLOWED          = 0x0002, 
    VHT_KNOWN_GUARD_INTERVAL               = 0x0004, 
    VHT_KNOWN_SHORT_GI_NSYM_DISAMBIGUATION = 0x0008, 
    VHT_KNOWN_LDPC_EXTRA_OFDM_SYMBOL       = 0x0010, 
    VHT_KNOWN_BEAMFORMED                   = 0x0020, 
    VHT_KNOWN_BANDWIDTH                    = 0x0040, 
    VHT_KNOWN_GROUP_ID                     = 0x0080, 
    VHT_KNOWN_PARTIAL_AID                  = 0x0100, 
  };

  enum VhtFlags
  {
    VHT_FLAGS_NONE                         = 0x00, 
    VHT_FLAGS_STBC                         = 0x01, 
    VHT_FLAGS_TXOP_PS_NOT_ALLOWED          = 0x02, 
    VHT_FLAGS_GUARD_INTERVAL               = 0x04, 
    VHT_FLAGS_SHORT_GI_NSYM_DISAMBIGUATION = 0x08, 
    VHT_FLAGS_LDPC_EXTRA_OFDM_SYMBOL       = 0x10, 
    VHT_FLAGS_BEAMFORMED                   = 0x20, 
  };

  void SetVhtFields (uint16_t known, uint8_t flags,
                     uint8_t bandwidth, uint8_t mcs_nss [4],
                     uint8_t coding, uint8_t group_id,
                     uint16_t partial_aid);

  uint16_t GetVhtKnown (void) const;
  uint8_t GetVhtFlags (void) const;
  uint8_t GetVhtBandwidth (void) const;
  uint8_t GetVhtMcsNssUser1 () const;
  uint8_t GetVhtMcsNssUser2 () const;
  uint8_t GetVhtMcsNssUser3 () const;
  uint8_t GetVhtMcsNssUser4 () const;
  uint8_t GetVhtCoding (void) const;
  uint8_t GetVhtGroupId (void) const;
  uint8_t GetVhtPartialAid (void) const;


private:
  enum RadiotapFlags
  {
    RADIOTAP_TSFT              = 0x00000001,
    RADIOTAP_FLAGS             = 0x00000002,
    RADIOTAP_RATE              = 0x00000004,
    RADIOTAP_CHANNEL           = 0x00000008,
    RADIOTAP_FHSS              = 0x00000010,
    RADIOTAP_DBM_ANTSIGNAL     = 0x00000020,
    RADIOTAP_DBM_ANTNOISE      = 0x00000040,
    RADIOTAP_LOCK_QUALITY      = 0x00000080,
    RADIOTAP_TX_ATTENUATION    = 0x00000100,
    RADIOTAP_DB_TX_ATTENUATION = 0x00000200,
    RADIOTAP_DBM_TX_POWER      = 0x00000400,
    RADIOTAP_ANTENNA           = 0x00000800,
    RADIOTAP_DB_ANTSIGNAL      = 0x00001000,
    RADIOTAP_DB_ANTNOISE       = 0x00002000,
    RADIOTAP_RX_FLAGS          = 0x00004000,
    RADIOTAP_MCS               = 0x00080000,
    RADIOTAP_AMPDU_STATUS      = 0x00100000,
    RADIOTAP_VHT               = 0x00200000,
    RADIOTAP_EXT               = 0x10000000
  };

  uint16_t m_length;        
  uint32_t m_present;       

  uint64_t m_tsft;          
  uint8_t m_flags;          
  uint8_t m_rate;           
  uint8_t m_channelPad;     
  uint16_t m_channelFreq;   
  uint16_t m_channelFlags;  
  int8_t m_antennaSignal;   
  int8_t m_antennaNoise;    

  uint8_t m_mcsKnown; 
  uint8_t m_mcsFlags; 
  uint8_t m_mcsRate;  

  uint8_t m_ampduStatusPad;       
  uint32_t m_ampduStatusRef;      
  uint16_t m_ampduStatusFlags;    
  uint8_t m_ampduStatusCRC;       

  uint8_t m_vhtPad;         
  uint16_t m_vhtKnown;      
  uint8_t m_vhtFlags;       
  uint8_t m_vhtBandwidth;   
  uint8_t m_vhtMcsNss[4];   
  uint8_t m_vhtCoding;      
  uint8_t m_vhtGroupId;     
  uint16_t m_vhtPartialAid; 
};

} // namespace ns3

#endif /*  RADIOTAP_HEADER_H */