NS3 WiFiMode说明

WiFiMode官方文档介绍

代表单一传输模式
WifiMode由单个整数实现,用于在全局数组中查找相关传输模式的特性。
因此,保持WifiMode变量是非常便宜的。

源码分析

在/src/wifi/model/wifi-phy.cc中定义了OFDM DSSS HTMCS等一系列模式。

WifiMode
WifiPhy::GetOfdmRate6Mbps ()
{
  static WifiMode mode =
    WifiModeFactory::CreateWifiMode ("OfdmRate6Mbps",
                                     WIFI_MOD_CLASS_OFDM,
                                     true,
                                     WIFI_CODE_RATE_1_2,
                                     2);
  return mode;
}

WifiMode
WifiPhy::GetOfdmRate9Mbps ()
{
  static WifiMode mode =
    WifiModeFactory::CreateWifiMode ("OfdmRate9Mbps",
                                     WIFI_MOD_CLASS_OFDM,
                                     false,
                                     WIFI_CODE_RATE_3_4,
                                     2);
  return mode;
}

在这里就这几行代码稍稍分析一下。
WifiModeFactory的构造器函数如下:

WifiModeFactory::WifiModeFactory ()
{
}

但是这个构造函数是私有的,外界无法访问。

WifiModeFactory 对象的创建,可以通过下面的GetFactory方法:

WifiModeFactory *
WifiModeFactory::GetFactory (void)
{
  static bool isFirstTime = true;
  static WifiModeFactory factory;
  if (isFirstTime)
    {
      uint32_t uid = factory.AllocateUid ("Invalid-WifiMode");
      WifiModeItem *item = factory.Get (uid);
      item->uniqueUid = "Invalid-WifiMode";
      item->modClass = WIFI_MOD_CLASS_UNKNOWN;
      item->constellationSize = 0;
      item->codingRate = WIFI_CODE_RATE_UNDEFINED;
      item->isMandatory = false;
      item->mcsValue = 0;
      isFirstTime = false;
    }
  return &factory;
}

可以发现,上面的静态方法中factory静态变量,仅被初始化一次,全局访问这一个静态变量。

WifiModeItem 是结构体。

  struct WifiModeItem
  {
    std::string uniqueUid;
    enum WifiModulationClass modClass;
    uint16_t constellationSize;
    enum WifiCodeRate codingRate;
    bool isMandatory;
    uint8_t mcsValue;
  };

有了上面的准备工作,重点看下面的CreateWifiMode 方法:

WifiMode
WifiModeFactory::CreateWifiMode (std::string uniqueName,
                                 enum WifiModulationClass modClass,
                                 bool isMandatory,
                                 enum WifiCodeRate codingRate,
                                 uint16_t constellationSize)
{
  WifiModeFactory *factory = GetFactory ();
  uint32_t uid = factory->AllocateUid (uniqueName);
  WifiModeItem *item = factory->Get (uid);
  item->uniqueUid = uniqueName;
  item->modClass = modClass;
  //The modulation class for this WifiMode must be valid.
  NS_ASSERT (modClass != WIFI_MOD_CLASS_UNKNOWN);
  item->codingRate = codingRate;

  if ((codingRate == WIFI_CODE_RATE_UNDEFINED) &&
               modClass != WIFI_MOD_CLASS_DSSS &&
               modClass != WIFI_MOD_CLASS_HR_DSSS)
    {
      NS_FATAL_ERROR ("Error in creation of WifiMode named " << uniqueName << std::endl
                                                             << "Code rate must be WIFI_CODE_RATE_UNDEFINED iff
                                                                 Modulation Class is WIFI_MOD_CLASS_DSSS or 
                                                                 WIFI_MOD_CLASS_HR_DSSS");
    }

  item->constellationSize = constellationSize;
  item->isMandatory = isMandatory;

  NS_ASSERT (modClass != WIFI_MOD_CLASS_HT && modClass != WIFI_MOD_CLASS_VHT);
  //fill unused mcs item with a dummy value
  item->mcsValue = 0;

  return WifiMode (uid);
}

CreateWifiMode 方法首先通过GetFactory 方法创建一个WifiModeFactory 对象,利用AllocateUid 方法产生一个唯一的uid,通过唯一的uid产生一个WifiModeItem 结构体,结构体对象中保存了WiFimode中的参数。

由于uid唯一的,WiFiMode对象只需要保存uid的值,就可以通过uid值传递给WifiModeFactory 对象,得到WifiModeItem 结构体,而该结构体保存了WiFimode中的参数。

上面的CreateWifiMode 方法中使用到的AllocateUid 方法和Get 方法如下:

uint32_t
WifiModeFactory::AllocateUid (std::string uniqueUid)
{
  uint32_t j = 0;
  for (WifiModeItemList::const_iterator i = m_itemList.begin ();
       i != m_itemList.end (); i++)
    {
      if (i->uniqueUid == uniqueUid)
        {
          return j;
        }
      j++;
    }
  uint32_t uid = m_itemList.size ();
  m_itemList.push_back (WifiModeItem ());
  return uid;
}

struct WifiModeFactory::WifiModeItem *
WifiModeFactory::Get (uint32_t uid)
{
  NS_ASSERT (uid < m_itemList.size ());
  return &m_itemList[uid];
}

其中的m_itemList对象就是一个列表,保存了每一个结构体对象,结构体对象保存了WiFimode的相应的参数。

AllocateUid 方法设计的非常巧妙,返回的uid的值就是对应的结构器在m_itemList中的位置。所以可通过将uid传递给Get方法,从m_itemList列表中获取到对应的结构体对象。

WifiMode::WifiMode (uint32_t uid)
  : m_uid (uid)
{
}

WifiMode对象通过这个构造函数,只需要保存uid的值,就可以通过下面的代码:

struct WifiModeFactory::WifiModeItem *item = WifiModeFactory::GetFactory ()->Get (m_uid);

仅仅通过这一行代码就可以获取到WifiModeItem 结构体对象,获取到wifimode的参数。

推荐阅读更多精彩内容

  • 国家电网公司企业标准(Q/GDW)- 面向对象的用电信息数据交换协议 - 报批稿:20170802 前言: 排版 ...
    庭说阅读 8,392评论 6 13
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 29,694评论 18 399
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 128,898评论 18 137
  • 今天是姐姐出嫁的日子。 昨天晚上来迎亲,大家都很开心。但我却看出妈妈心里的不舍。没有太多的,笑容。其实我们都知道并...
    cai小梅阅读 350评论 0 2
  • 据佛罗里达州大学的一项调查显示,在国家或者国际赛事之间或者之后的很短一段时间内,人们被送去急救室的几率是平时的十倍...
    问暖健康阅读 68评论 0 0
  • 她穿着背带裤,偶尔一条肩上的背带会掉下来,她就伸出白嫩的小手穿好。 她笑起来很美,无论是抿嘴笑还是露齿笑。 我更喜...
    风兮兮__阅读 141评论 0 1
  • 我甘愿做剧情的配角, 乐意退在别人的身后, 让自己处于备战状态, 为所有事情尽心尽力。 起初会被认为傻白愣, 但坚...
    真真而来阅读 43评论 0 1
  • 最近在我的朋友圈里好多人在转发一个公益众筹的活动,对象是我之前公司的同事。在临近生产前身体不舒服,经检查后被告知患...
    小主儿吉祥阅读 449评论 0 4