!!!WARNING: THIS IS AN OLD VERSION OF OUR 802.11AH MODULE, VISIT https://github.com/imec-idlab/IEEE-802.11ah-ns-3 FOR THE LATEST RELEASE!!!
This repository hosts an implementation of the IEEE802.11ah (Wi-Fi HaLow) protocol for the NS-3 network simulator. It comes pre-packaged with NS-3 version 3.23 and an example showing how to use and configure it. For more details about our implementation and supported features, please visit our webpage. If you have questions or want to contribute, plese send us an email.
If you use our work, please use the following citation to refer to it:
Le Tian, Sébastien Deronne, Steven Latré, Jeroen Famaey. Implementation and validation of an IEEE 802.11ah module for NS-3. Workshop on ns-3 (WNS3), Seattle, USA, 2016.
- Download source code from our github repository.
- Change into /802.11ah-ns3/ns-3 directory.
- Build and run:
./waf configure
./waf
./waf --run "scratch/s1g-mac-test --NRawSta=30 --NGroup=1 --SlotFormat=0 --NRawSlotCount=162 --NRawSlotNum=5 --DataMode="OfdmRate650KbpsBW2MHz" --datarate=0.65 --bandWidth=2 --rho="50" --simulationTime=60 --payloadSize=256 --BeaconInterval=100000 --UdpInterval=0.1 --Nsta=30 --file="./TestMac/mac-sta.txt" --pcapfile="./TestMac/mac-sta" --seed=1"Note: if errors related to nullptr arise when compiling, CXXFLAGS should be included into the "./waf configure" command,as follows:
CXXFLAGS="-std=c++0x" ./waf configure --disable-examples --disable-tests
Moreover, there are some parameters which can be changed inside the script file "s1g-mac-test.cc", some of which are described below.
The current configuration is used in outdoor macro scenarios, users can change these parameters to test other scenarios as well. More information can be found at our website.
channel.AddPropagationLoss ("ns3::LogDistancePropagationLossModel","Exponent", DoubleValue(3.76) ,"ReferenceLoss", DoubleValue(8.0), "ReferenceDistance", DoubleValue(1.0));Users can change vaule of "MaxPacketNumber" and "MaxDelaysend" attributes according to their own requirements.
Config::Set ("/NodeList/*/DeviceList/0/$ns3::WifiNetDevice/Mac/$ns3::RegularWifiMac/BE_EdcaTxopN/Queue/MaxPacketNumber", UintegerValue(60000));
Config::Set ("/NodeList/*/DeviceList/0/$ns3::WifiNetDevice/Mac/$ns3::RegularWifiMac/BE_EdcaTxopN/Queue/MaxDelay", TimeValue (NanoSeconds (6000000000000)));An example is included in the script file "./ns-3/scratch/s1g-mac-test.cc". Users can use the file "s1g-mac-test.cc" to simulate the RAW feature of 802.11ah with different Wi-Fi modes. A topology in which stations are distributed randomly within a "rho" meters distance of the access point (AP) is created. Subsequently, the stations are associated with the AP using the new fast association mechanism. Then, all stations generate packets and send them to the AP in their assigned RAW slots. Finally, after "SimulationTime" seconds, all stations stop generating new packets and finish after sending all packets still in their transmit buffer.
- NRawSta: Number of stations supporting RAW.
- NGroup: Number of RAW groups.
- NRawSlotNum: Number of slots per RAW group.
- SlotFormat: Format of RAW slot count.
- NRawSlotCount: Used to calculate number of RAW slot duration.
Notes:
- NGroup, stations are divided evenly among each RAW groups
- RAW slot duration = 500 us + NRawSlotCount * 120 us, NRawSlotCount is y = 11(8) bits length when SlotFormat is set to 1(0), and NRawSlotNum is (14 - y) bits length.
- DataMode: Data mode.
- datarate: Data rate of data mode.
- bandWidth: BandWidth of data mode.
Note: Relation between the above 3 parameters and MCS is described in file "MCStoWifiMode".
- SimulationTime: Simulatiom time in seconds after all stations get associated with AP.
- payloadSize: Size of payload.
- BeaconInterval: Beacon interval time in us.
- UdpInterval: Traffic mode, station send one packet every UdpInterval seconds.
- Nsta: Number of total stations.
- rho: Maximal distance between AP and stations.
- file: Path of files containing result information.
- pcapfile: Pcap file path.
- seed: Seed of RandomVariableStream.