NS3 Simulation

hybrid-virtual-routing, for VLC-RF Backended Wi-Fi Relay Network

Tech-Tag: ns3 rapidjson root-tree

Framework

• describe the network from-top-to-bottom in JSON format, self-recursive and iterable

• Demo

  graph TB
  	subgraph GroupB
  		A1[Router1]-.VLC.->B1_0[Relay_1_0]
  		B1_0-.WiFi.->A1
  		A1-.VLC.->B1_1[Relay_1_1]
  		B1_1-.WiFi.->A1
  	end
  	subgraph GroupA
  		A0[Router0]-.VLC.->B0_0[Relay_0_0]
  		B0_0-.WiFi.->A0
  		A0-.VLC.->B0_1[Relay_0_1]
  		B0_1-.WiFi.->A0
  	end
  	B0_0---C0[UE Group]
  	B0_1---C1[UE Group]
  	B1_0---C2[UE Group]
  	B1_1---C3[UE Group]
  

Howto

1. build ns3 following official tutorial;

2. ln -s <this-repo-full-path> <your-ns3-full-path>/examples/main

3. add following code in your ~/.zshrc or ~/.bashrc :

   # Waf section
   WAF_PATH=<your-ns3-full-path>
   WAF_EDITOR=<your-prefered-editor>
   export PATH=$WAF_PATH:$PATH
   
   function wafls() {
   	ls $WAF_PATH/$1 ${${*}#${1}}
   }
   
   function wafcd() {
   	cd $WAF_PATH/$1 ${${*}#${1}}
   }
   
   function wafed() {
   	$WAF_EDITOR $WAF_PATH/$1 ${${*}#${1}}
   }
   
   function wafbuild() {
   	local pwd_tmp=$PWD
   	cd $WAF_PATH &&	./waf
   	cd $pwd_tmp
   }
   
   function wafrun() {
   	local pwd_tmp=$PWD
   	cd $WAF_PATH &&	waf --run $*
   	cd $pwd_tmp
   }
   
   function wafgdb() {
   	local pwd_tmp=$PWD
   	cd $WAF_PATH &&	waf --run $1 --command-template="gdb ${${*}#${1}}"
   	cd $pwd_tmp
   }
   
   function wafpcap_mv() {
   	rm -rf ./$1-\*.pcap && mv -f $WAF_PATH/$1-*.pcap ./$1-pcap/
   }

   source the configuration file

4. wafrun main to run the main simulation

Todo

• Network JSON Parse
• Static Routing Strategy
• Performance Analysis Callback
• Wi-Fi Collision Container