src/nepi/resources/ns3/ns3wifiphy.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 NS3BaseWifiPhy(NS3Base):
  26     _rtype = "abstract::ns3::WifiPhy"
  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 = "WifiPhy not connected to device"
  49             self.error(msg)
  50             raise RuntimeError(msg)
  51
  52         return devices[0]
  53
  54     @property
  55     def channel(self):
  56         from nepi.resources.ns3.ns3wifichannel import NS3BaseWifiChannel
  57         channels = self.get_connected(NS3BaseWifiChannel.get_rtype())
  58
  59         if not channels:
  60             msg = "WifiPhy not connected to channel"
  61             self.error(msg)
  62             raise RuntimeError(msg)
  63
  64         return channels[0]
  65
  66     @property
  67     def _rms_to_wait(self):
  68         rms = set()
  69         rms.add(self.device)
  70         return rms
  71
  72     def _connect_object(self):
  73         device = self.device
  74         if device.uuid not in self.connected:
  75             self._connected.add(device.uuid)
  76
  77             self.simulation.invoke(self.uuid, "SetMobility", self.node.uuid)
  78
  79             standard = self.get("Standard")
  80             self.simulation.invoke(self.uuid, "ConfigureStandard", WIFI_STANDARDS[standard])
  81
  82             self.simulation.invoke(self.uuid, "SetDevice", device.uuid)
  83
  84             self.simulation.invoke(self.uuid, "SetChannel", self.channel.uuid)
  85
  86             self.simulation.invoke(device.uuid, "SetPhy", self.uuid)
  87