src/nepi/resources/ns3/ns3wifimac.py

   1 #
   2 #    NEPI, a framework to manage network experiments
   3 #    Copyright (C) 2014 INRIA
   4 #
   5 #    This program is free software: you can redistribute it and/or modify
   6 #    it under the terms of the GNU General Public License version 2 as
   7 #    published by the Free Software Foundation;
   8 #
   9 #    This program is distributed in the hope that it will be useful,
  10 #    but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 #    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 #    GNU General Public License for more details.
  13 #
  14 #    You should have received a copy of the GNU General Public License
  15 #    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  16 #
  17 # Author: Alina Quereilhac <alina.quereilhac@inria.fr>
  18
  19 from nepi.execution.attribute import Attribute, Flags, Types
  20 from nepi.execution.resource import clsinit_copy
  21 from nepi.resources.ns3.ns3base import NS3Base
  22 from nepi.resources.ns3.ns3wifinetdevice import WIFI_STANDARDS
  23
  24 @clsinit_copy
  25 class NS3BaseWifiMac(NS3Base):
  26     _rtype = "abstract::ns3::WifiMac"
  27
  28     @classmethod
  29     def _register_attributes(cls):
  30         standard = Attribute("Standard", "Wireless standard",
  31                 default = "WIFI_PHY_STANDARD_80211a",
  32                 allowed = WIFI_STANDARDS.keys(),
  33                 type = Types.Enumerate,
  34                 flags = Flags.Design)
  35
  36         cls._register_attribute(standard)
  37
  38     @property
  39     def node(self):
  40         return self.device.node
  41
  42     @property
  43     def device(self):
  44         from nepi.resources.ns3.ns3wifinetdevice import NS3BaseWifiNetDevice
  45         devices = self.get_connected(NS3BaseWifiNetDevice.get_rtype())
  46
  47         if not devices:
  48             msg = "WifiMac not connected to device"
  49             self.error(msg)
  50             raise RuntimeError(msg)
  51
  52         return devices[0]
  53
  54     @property
  55     def _rms_to_wait(self):
  56         rms = set()
  57         rms.add(self.device)
  58         return rms
  59
  60     def _connect_object(self):
  61         device = self.device
  62         if device.uuid not in self.connected:
  63             self._connected.add(device.uuid)
  64
  65             self.simulation.invoke(device.uuid, "SetMac", self.uuid)
  66
  67             standard = self.get("Standard")
  68             self.simulation.invoke(self.uuid, "ConfigureStandard", WIFI_STANDARDS[standard])
  69
  70             # Delayed configuration of MAC address
  71             mac = device.get("mac")
  72             if mac:
  73                 mac_uuid = self.simulation.create("Mac48Address", mac)
  74             else:
  75                 mac_uuid = self.simulation.invoke("singleton::Mac48Address", "Allocate")
  76
  77             self.simulation.invoke(self.uuid, "SetAddress", mac_uuid)
  78
  79