Zheng Peng's Wiki - User contributions [en]

Install and run Aqua-Sim-NG code

2018-08-17T13:51:54Z

Dmitrii:

== How-To build ns-3 + aqua-sim==

* download and unpack ns-3.27 source code:

<code>wget http://www.nsnam.org/release/ns-allinone-3.27.tar.bz2</code>

<code>tar xjf ns-allinone-3.27.tar.bz2</code>

'''Note:''' Aqua-Sim-NG has been tested with ns-3.27. The higher versions of ns-3 (i.e., 3.28, 3.29) might not be compilable with aqua-sim modules.

* get aqua-sim source code:

- move to ../src directory of ns-3:

<code>cd "ns-3_working_dir/ns-3.27/src/"</code>

- for multichannel MAC development:

<code>git clone https://github.com/dugdmitry/aqua-sim-ng.git</code>

- original version from main repository:

<code>git clone https://github.com/rmartin5/aqua-sim-ng.git</code>

* build ns-3 with aqua-sim source code:

- change to ns-3 working directory:

<code>cd "ns-3_working_dir/ns-3.27/</code>

- configure and build using "waf":

<code>./waf clean</code>

<code>./waf configure --build-profile=debug --enable-examples</code>

<code>./waf</code>

== How-To run examples ==

After building ns-3 + aqua-sim, simulation scripts can be run using <code>./waf --run 'script_name'</code> command.

The scripts are located in <code>/scratch</code> folder, and also in <code>examples</code> folders of the corresponding ns-3 models, located in <code>src/</code>.

E.g., the corresponding examples of aqua-sim models are located in <code>../src/aqua-sim-ng/examples/</code>

'''Note:''' Names of the scripts to execute may differ from the names of the corresponding .cc files.

For example, in order to run "../src/aqua-sim-ng/examples/multichannel_mac_example.cc" script, the following command should be executed:

<code>./waf --run ./waf --run MultichannelMacExample</code>

'script_source_name.cc' and corresponding 'script_name' mapping can be found in "../src/model_name/examples/wscript" file.

=== Running multichannel MAC example ===

<code>./waf --run "MultichannelMacExample --packetSize=50 --channelId=1 --RngRun=11"</code>

The command above will run a script for multichannel MAC example, with OnOffApplication's packet size of 50 Bytes,
on channel 1.

'RngRun' parameter defines a seed value of the pseudo-random generator during the script execution. Simulation results can be repeated using the same 'RngRun' value.

Install and run Aqua-Sim-NG code

2018-08-17T13:41:45Z

Dmitrii: /* How-To */

== How-To build ns-3 + aqua-sim==

* download and unpack ns-3.27 source code:

<code>wget http://www.nsnam.org/release/ns-allinone-3.27.tar.bz2</code>

<code>tar xjf ns-allinone-3.27.tar.bz2</code>

'''Note:''' Aqua-Sim-NG has been tested with ns-3.27. The higher versions of ns-3 (i.e., 3.28, 3.29) might not be compilable with aqua-sim modules.

* get aqua-sim source code:

- move to ../src directory of ns-3:

<code>cd "ns-3_working_dir/ns-3.27/src/"</code>

- for multichannel MAC development:

<code>git clone https://github.com/dugdmitry/aqua-sim-ng.git</code>

- original version from main repository:

<code>git clone https://github.com/rmartin5/aqua-sim-ng.git</code>

* build ns-3 with aqua-sim source code:

- change to ns-3 working directory:

<code>cd "ns-3_working_dir/ns-3.27/</code>

- configure and build using "waf":

<code>./waf clean</code>

<code>./waf configure --build-profile=debug --enable-examples</code>

<code>./waf</code>

== How-To run examples ==

After building ns-3 + aqua-sim, simulation scripts can be run using <code>./waf --run 'script_name'</code> command.

The scripts are located in "/scratch" folder, and also in "examples" folders of the corresponding ns-3 models, located in "src/" folder.

E.g., the corresponding examples of aqua-sim models are located in <code>../src/aqua-sim-ng/examples/</code>

'''Note:''' Names of the scripts to execute may differ from the names of the corresponding .cc files.

For example, in order to run "../src/aqua-sim-ng/examples/multichannel_mac_example.cc" script, the following command should be executed:

<code>./waf --run ./waf --run MultichannelMacExample</code>

'script_source_name.cc' and corresponding 'script_name' mapping can be found in "../src/model_name/examples/wscript" file.

Install and run Aqua-Sim-NG code

2018-08-17T13:21:01Z

Dmitrii: Created page with "== How-To == * download and unpack ns-3.27 source code: <code>wget http://www.nsnam.org/release/ns-allinone-3.27.tar.bz2</code> <code>tar xjf ns-allinone-3.27.tar.bz2</code..."

== How-To ==

* download and unpack ns-3.27 source code:

<code>wget http://www.nsnam.org/release/ns-allinone-3.27.tar.bz2</code>

<code>tar xjf ns-allinone-3.27.tar.bz2</code>

'''Note:''' Aqua-Sim-NG has been tested with ns-3.27. The higher versions of ns-3 (i.e., 3.28, 3.29) might not be compilable with aqua-sim modules.

* get aqua-sim source code:

- move to ../src directory of ns-3:

<code>cd "ns-3_working_dir/src/"</code>

- for multichannel MAC development:

<code>git clone https://github.com/dugdmitry/aqua-sim-ng.git</code>

- original version from main repository:

<code>git clone https://github.com/rmartin5/aqua-sim-ng.git</code>

* build ns-3 with aqua-sim source code:

Main Page

2018-08-17T10:51:01Z

Dmitrii:

[[Aqua-Net]]

[[Aqua-Sim]]

[[Aqua-3D]]

[[Aqua-Sim NG]]

[[Aqua-Lab]]

[[Aqua-OS]]

[[Aqua-fModem]]

== Current Development ==

[[Aqua-Sim-NG multichannel MAC implementation]]

[[Install and run Aqua-Sim-NG code]]

Main Page

2018-08-17T10:50:49Z

Dmitrii:

Aqua-Sim-NG multichannel MAC implementation

2018-08-08T11:12:43Z

Dmitrii:

== Multichannel MAC implementation ==

* new <code>aqua-sim-mac-multichannel</code> module:

Modified <code>TxProcess</code> and <code>RecvProcess</code> methods of the <code>AquaSimMac</code> base class. Added channel division on N number of subchannels, depending on given bandwidth. By default, the following bandwidth is used and the following subchannels are created:

* bandwidth: 10 - 40 kHz
* step frequency: 3 kHz
* N of subchannels: 10

The following <code>channel_id:frequency</code> map is generated:

<channel_1 : 10 kHz>, <channel_2 : 13 kHz>, …, <channel_10 : 37 kHz>

* modified <code>aqua-sim-phy-cmn</code> module:

Modified <code>recv()</code> method of <code>AquaSimPhyCmn</code> class, which is used for both transmission and reception of the scheduled packet. The modified <code>recv()</code> method has a new argument - frequency, and is executed by upper multichannel-mac module, depending on the selected channel_id.

* modified <code>aqua-sim-channel</code> module:

Modified <code>SendUp()</code> method of <code>AquaSimChannel</code> class. Now this method gets a frequency value of the incoming packet, using <code>AquaSimPacketStamp</code> class and inserts it into the <code>::Recv()</code> method of the <code>AquaSimPhyCmn</code> upon execution in the Scheduler.

== Initial tests ==

For the initial tests the following simulation scenario was used:

“node_1 (sender)” <— 10m distance —> “node_2 (sink)”

The following stack was used on both nodes: - OnOffApplication — OffTime: 0, OnTime: 1 - Routing — Dummy (for MAC layer testing) - MultichannelMac — default bandwidth (10 - 40 kHz), 10 subchannels, 3kHz frequency step - PhyCmn — modified PhyCmn module

Some other parameters: - Simulation time: 10 seconds - Transmission range: 100 meters (for Phy module) - Distance: 10 meters (Mobility model)

In all tests a throughput was measured by defining an application data rate, higher than possible capacity of the given channel:

'''80 kbps''' <code>dataRate</code> parameter of <code>OnOffApplication</code>. Thus, the throughput was measured by counting a total amount of received packets:

throughput = total_received_packets * packet_size * 8 / 10, [bps]

where: 10 - simulation time, seconds.

=== 1-st test ===

A single channel was used during entire simulation. - channel_id: 1, frequency: 10 kHz.

The throughput was measured, depending on varying packet length. The result is plotted on Fig.1.

[[File:throughput_1_channel.png]] Fig.1

Corresponding sent/received packet count is illustrated on Fig.2.

[[File:packet_count_1_channel.png]] Fig.2

=== 2-nd test ===

During the simulation, various channels were used in the following “round-robin” way:

* 1_packet: channel_1 (10kHz)
* 2_packet: channel_2 (13kHz)
* 3_packet: channel_3 (16kHz)
* 4_packet: channel_4 (19kHz)
* 5_packet: channel_5 (22kHz)
* 6_packet: channel_6 (25kHz)
* 7_packet: channel_7 (28kHz)
* 8_packet: channel_8 (31kHz)
* 9_packet: channel_9 (34kHz)
* 10_packet: channel_11 (37kHz)
* 11_packet: channel_1 (10kHz)
* …. etc.

The throughput is plotted on Fig.3.

[[File:throughput_n_channels.png]] Fig.3

Corresponding sent/received packet count is illustrated on Fig.4.

[[File:packet_count_n_channels.png]] Fig.4

Code of simulation script can be found here:

[https://github.com/dugdmitry/aqua-sim-ng/blob/master/examples/multichannel_mac_example.cc multichannel_mac_example.cc]

Aqua-Sim-NG multichannel MAC implementation

2018-08-08T11:11:21Z

Dmitrii:

Aqua-Sim-NG multichannel MAC implementation

2018-08-08T11:10:48Z

Dmitrii:

== Multichannel MAC implementation ==

* new <code>aqua-sim-mac-multichannel</code> module:

Modified <code>TxProcess</code> and <code>RecvProcess</code> methods of the <code>AquaSimMac</code> base class. Added channel division on N number of subchannels, depending on given bandwidth. By default, the following bandwidth is used and the following subchannels are created:

* bandwidth: 10 - 40 kHz
* step frequency: 3 kHz
* N of subchannels: 10

The following <code>channel_id:frequency</code> map is generated:

<channel_1 : 10 kHz>, <channel_2 : 13 kHz>, …, <channel_10 : 37 kHz>

* modified <code>aqua-sim-phy-cmn</code> module:

Modified <code>recv()</code> method of <code>AquaSimPhyCmn</code> class, which is used for both transmission and reception of the scheduled packet. The modified <code>recv()</code> method has a new argument - frequency, and is executed by upper multichannel-mac module, depending on the selected channel_id.

* modified <code>aqua-sim-channel</code> module:

Modified <code>SendUp()</code> method of <code>AquaSimChannel</code> class. Now this method gets a frequency value of the incoming packet, using <code>AquaSimPacketStamp</code> class and inserts it into the <code>::Recv()</code> method of the <code>AquaSimPhyCmn</code> upon execution in the Scheduler.

== Initial tests ==

For the initial tests the following simulation scenario was used:

“node_1 (sender)” <— 10m distance —> “node_2 (sink)”

The following stack was used on both nodes: - OnOffApplication — OffTime: 0, OnTime: 1 - Routing — Dummy (for MAC layer testing) - MultichannelMac — default bandwidth (10 - 40 kHz), 10 subchannels, 3kHz frequency step - PhyCmn — modified PhyCmn module

Some other parameters: - Simulation time: 10 seconds - Transmission range: 100 meters (for Phy module) - Distance: 10 meters (Mobility model)

In all tests a throughput was measured by defining an application data rate, higher than possible capacity of the given channel:

'''80 kbps''' <code>dataRate</code> parameter of <code>OnOffApplication</code>. Thus, the throughput was measured by counting a total amount of received packets:

throughput = total_received_packets * packet_size * 8 / 10, [bps]

where: 10 - simulation time, seconds.

=== 1-st test ===

A single channel was used during entire simulation. - channel_id: 1, frequency: 10 kHz.

The throughput was measured, depending on varying packet length. The result is plotted on Fig.1.

[[File:throughput_1_channel.png]] Fig.1

Corresponding sent/received packet count is illustrated on Fig.2.

[[File:packet_count_1_channel.png]] Fig.2

=== 2-nd test ===

During the simulation, various channels were used in the following “round-robin” way:

* 1_packet: channel_1 (10kHz)
* 2_packet: channel_2 (13kHz)
* 3_packet: channel_3 (16kHz)
* 4_packet: channel_4 (19kHz)
* 5_packet: channel_5 (22kHz)
* 6_packet: channel_6 (25kHz)
* 7_packet: channel_7 (28kHz)
* 8_packet: channel_8 (31kHz)
* 9_packet: channel_9 (34kHz)
* 10_packet: channel_11 (37kHz)
* 11_packet: channel_1 (10kHz)
* …. etc.

The throughput is plotted on Fig.3.

[[File:throughput_n_channels.png]] Fig.3

Corresponding sent/received packet count is illustrated on Fig.4.

[[File:packet_count_n_channels.png]] Fig.4

Code of simulation script can be found here:

[[https://github.com/dugdmitry/aqua-sim-ng/blob/master/examples/multichannel_mac_example.cc]]

Aqua-Sim-NG multichannel MAC implementation

2018-08-08T11:09:39Z

Dmitrii:

== Multichannel MAC implementation ==

* new <code>aqua-sim-mac-multichannel</code> module:

Modified <code>TxProcess</code> and <code>RecvProcess</code> methods of the <code>AquaSimMac</code> base class. Added channel division on N number of subchannels, depending on given bandwidth. By default, the following bandwidth is used and the following subchannels are created:

* bandwidth: 10 - 40 kHz
* step frequency: 3 kHz
* N of subchannels: 10

The following <code>channel_id:frequency</code> map is generated:

<channel_1 : 10 kHz>, <channel_2 : 13 kHz>, …, <channel_10 : 37 kHz>

* modified <code>aqua-sim-phy-cmn</code> module:

Modified <code>recv()</code> method of <code>AquaSimPhyCmn</code> class, which is used for both transmission and reception of the scheduled packet. The modified <code>recv()</code> method has a new argument - frequency, and is executed by upper multichannel-mac module, depending on the selected channel_id.

* modified <code>aqua-sim-channel</code> module:

Modified <code>SendUp()</code> method of <code>AquaSimChannel</code> class. Now this method gets a frequency value of the incoming packet, using <code>AquaSimPacketStamp</code> class and inserts it into the <code>::Recv()</code> method of the <code>AquaSimPhyCmn</code> upon execution in the Scheduler.

== Initial tests ==

For the initial tests the following simulation scenario was used:

“node_1 (sender)” <— 10m distance —> “node_2 (sink)”

The following stack was used on both nodes: - OnOffApplication — OffTime: 0, OnTime: 1 - Routing — Dummy (for MAC layer testing) - MultichannelMac — default bandwidth (10 - 40 kHz), 10 subchannels, 3kHz frequency step - PhyCmn — modified PhyCmn module

Some other parameters: - Simulation time: 10 seconds - Transmission range: 100 meters (for Phy module) - Distance: 10 meters (Mobility model)

In all tests a throughput was measured by defining an application data rate, higher than possible capacity of the given channel:

'''80 kbps''' <code>dataRate</code> parameter of <code>OnOffApplication</code>. Thus, the throughput was measured by counting a total amount of received packets:

throughput = total_received_packets * packet_size * 8 / 10, [bps]

where: 10 - simulation time, seconds.

=== 1-st test ===

A single channel was used during entire simulation. - channel_id: 1, frequency: 10 kHz.

The throughput was measured, depending on varying packet length. The result is plotted on Fig.1.

[[File:throughput_1_channel.png]]

Corresponding sent/received packet count is illustrated on Fig.2.

[[File:packet_count_1_channel,png]] Fig.2

=== 2-nd test ===

During the simulation, various channels were used in the following “round-robin” way:

* 1_packet: channel_1 (10kHz)
* 2_packet: channel_2 (13kHz)
* 3_packet: channel_3 (16kHz)
* 4_packet: channel_4 (19kHz)
* 5_packet: channel_5 (22kHz)
* 6_packet: channel_6 (25kHz)
* 7_packet: channel_7 (28kHz)
* 8_packet: channel_8 (31kHz)
* 9_packet: channel_9 (34kHz)
* 10_packet: channel_11 (37kHz)
* 11_packet: channel_1 (10kHz)
* …. etc.

The throughput is plotted on Fig.3.

[[File:throughput_n_channels,png]] Fig.3

Corresponding sent/received packet count is illustrated on Fig.4.

[[File:packet_count_n_channels.png]] Fig.4

Code of simulation script can be found here:

[[https://github.com/dugdmitry/aqua-sim-ng/blob/master/examples/multichannel_mac_example.cc]]

File:Packet count n channels.png

2018-08-08T11:05:53Z

Dmitrii:

File:Packet count 1 channel.png

2018-08-08T11:05:35Z

Dmitrii:

File:Throughput n channels.png

2018-08-08T11:05:12Z

Dmitrii:

File:Throughput 1 channel.png

2018-08-08T11:04:25Z

Dmitrii:

Aqua-Sim-NG multichannel MAC implementation

2018-08-08T10:52:12Z

Dmitrii: Created page with "== Multichannel MAC implementation == * new <code>aqua-sim-mac-multichannel</code> module: Modified <code>TxProcess</code> and <code>RecvProcess</code> methods of the <code>..."

== Multichannel MAC implementation ==

* new <code>aqua-sim-mac-multichannel</code> module:

Modified <code>TxProcess</code> and <code>RecvProcess</code> methods of the <code>AquaSimMac</code> base class. Added channel division on N number of subchannels, depending on given bandwidth. By default, the following bandwidth is used and the following subchannels are created:

* bandwidth: 10 - 40 kHz
* step frequency: 3 kHz
* N of subchannels: 10

The following <code>channel_id:frequency</code> map is generated:

<channel_1 : 10 kHz>, <channel_2 : 13 kHz>, …, <channel_10 : 37 kHz>

* modified <code>aqua-sim-phy-cmn</code> module:

Modified <code>recv()</code> method of <code>AquaSimPhyCmn</code> class, which is used for both transmission and reception of the scheduled packet. The modified <code>recv()</code> method has a new argument - frequency, and is executed by upper multichannel-mac module, depending on the selected channel_id.

* modified <code>aqua-sim-channel</code> module:

Modified <code>SendUp()</code> method of <code>AquaSimChannel</code> class. Now this method gets a frequency value of the incoming packet, using <code>AquaSimPacketStamp</code> class and inserts it into the <code>::Recv()</code> method of the <code>AquaSimPhyCmn</code> upon execution in the Scheduler.

== Initial tests ==

For the initial tests the following simulation scenario was used:

“node_1 (sender)” <— 10m distance —> “node_2 (sink)”

The following stack was used on both nodes: - OnOffApplication — OffTime: 0, OnTime: 1 - Routing — Dummy (for MAC layer testing) - MultichannelMac — default bandwidth (10 - 40 kHz), 10 subchannels, 3kHz frequency step - PhyCmn — modified PhyCmn module

Some other parameters: - Simulation time: 10 seconds - Transmission range: 100 meters (for Phy module) - Distance: 10 meters (Mobility model)

In all tests a throughput was measured by defining an application data rate, higher than possible capacity of the given channel:

'''80 kbps''' <code>dataRate</code> parameter of <code>OnOffApplication</code>. Thus, the throughput was measured by counting a total amount of received packets:

throughput = total_received_packets * packet_size * 8 / 10, [bps]

where: 10 - simulation time, seconds.

=== 1-st test ===

A single channel was used during entire simulation. - channel_id: 1, frequency: 10 kHz.

The throughput was measured, depending on varying packet length. The result is plotted on Fig.1.

[[File:https://github.com/dugdmitry/aqua-sim-ng/blob/master/multichannel_tests/images/throughput_1_channel.svg|throughput_1_channel]] Fig.1

Corresponding sent/received packet count is illustrated on Fig.2.

[[File:https://github.com/dugdmitry/aqua-sim-ng/blob/master/multichannel_tests/images/packet_count_1_channel.svg|packet_count_1_channel]] Fig.2

Main Page

2018-08-08T10:39:21Z

Dmitrii:

[[Aqua-Net]]

[[Aqua-Sim]]

[[Aqua-3D]]

[[Aqua-Sim NG]]

[[Aqua-Lab]]

[[Aqua-OS]]

[[Aqua-fModem]]

== Current Development ==

[[Aqua-Sim-NG multichannel MAC implementation]]