How to use it

Komondor includes different ways of introducing information to generate WLANs, as well as to run several simulations with different inputs.

Inputs

The general information (which is shared between all the elements in the network) is introduced through the /input/input_system_conf.csv file. The information to be introduced in this file is:

Field	Type	Description
num_channels	int	Maximum number of channels allowed
basic_channel_bandwidth	int	Width of a single channel in MHz
pdf_backoff	int	Index of the Probability Density Function to be used to generate the Backoff
pdf_tx_time	int	Index of the the Probability Density Function to be used to generate the duration of a transmission (in case of using the theoretical approach)
packet_length	int	Length of data packets
ack_length	int	Length of the ACK packets
num_packets_aggregated	int	Number of data packets to be aggregated during a single transmission
path_loss_model	int	Index of the path-loss model
wavelength	int	Wavelength to be used to compute the tx time of a packet
noise_level	int	Constant noise level in dBm
cochannel_model	int	Index of the co-channel interferences model to be used
collisions_model	int	Index of the collisions model
SIFS	int	Duration of the SIFS interval in microseconds

• Congestion Window (CW):
• Logs flag: flag to generate logs (1) or not (0)

In order to generate WLANs, Komondor provides two different approaches: the first one (a.k.a. Full-mode) allows introducing the location of each device in the network, while the second one (a.k.a Partial-mode) generates Stations (STAs) randomly according to Access Points (APs) locations and minimum/maximum number of associated STAs allowed.

Full-mode

Komondor automatically triggers the Full-mode for generating the network if the name of the input file is "input_nodes_conf.csv", which must be located at the /input folder.

Field	Type	Description
node_code	int
node_type	int
wlan_code	int
destination_id	int
x	int
y	int
z	int
primary_channel	int
min_channel_allowed	int
max_channel_allowed	int
CW	int
tpc_min	int
tpc_default	int
tpc_max	int
cca_min	int
cca_default	int
cca_max	int
tx_antenna_gain	int
rx_antenna_gain	int
channel_bonding_model	int
modulation_default	int

Partial-mode

Similarly to the Full-mode, Partial-mode is triggered when the input file is named "input_aps_conf.csv", which must also be located at the /input folder.

Field	Type	Description
wlan_code	int
node_type	int
wlan_code	int
destination_id	int
AP_x	int
AP_y	int
AP_z	int
min_sta_number	int
max_sta_number	int
max_distance_sta	int
primary_channel	int
min_channel_allowed	int
max_channel_allowed	int
CW	int
tpc_min	int
tpc_default	int
tpc_max	int
cca_min	int
cca_default	int
cca_max	int
tx_antenna_gain	int
rx_antenna_gain	int
channel_bonding_model	int
modulation_default	int

Outputs

Compilation and execution

1. Use the build_local file to compile the code by introducing ".build_local" in the command line
2. Run the code as follows: