SysSAloha Class Reference

This is the main simulation class. More...

#include <SlottedAloha.h>

Inherits DESystem.

Inheritance diagram for SysSAloha:

[legend]Collaboration diagram for SysSAloha:

[legend]List of all members.

Public Member Functions
	SysSAloha (ParamManager *_Param, GlobalProbeManager *_Results, ProbeManager *_ProbeMg)
	the DESystem subclass constructor must have those 3 parameters. NePSing will provide the right values.
void	Initialize ()
	the DESystem subclass Initialize() must be here.
virtual	~SysSAloha ()
	the subclass destructor is optional.
Static Public Member Functions
void	setup (ParamManager *Param, GlobalProbeManager *Results)
	the DESystem subclass setup() must have those 2 parameters. NePSing will provide the right values.

---

Detailed Description

This is the main simulation class.

This class is a subclass of DESystem. It does nothing but:

1. create the entities of the simulation, i.e., the various terminals
2. initialize each of them
3. launch the first events

In a simulator there must be only one class derived by DESystem and it should looks like this one.

NePSing will create only one intance of this class at the simulation start and will destroy it when the simulation will end.

All the simulation elements should be dynamically created or there should be a cleanup system in the respectives Initalize() functions, as a simulation could be used in multirun mode.

Definition at line 38 of file SlottedAloha.h.

---

Constructor & Destructor Documentation

SysSAloha::SysSAloha (  ParamManager *  _Param, GlobalProbeManager *  _Results, ProbeManager *  _ProbeMgr )

the DESystem subclass constructor must have those 3 parameters. NePSing will provide the right values. In the contructor we will only have to set up the default value of the various variables. The main due-to of this function is to propagate its 3 parameters to the DESystem constructor and to feed the DESystem constructor with the DETime construction paramteres, i.e.: TimeResolution Ticks per Step Step per BigStep BigStep per SuperStep note here the use of the stringToULL() function to convert the time length of a Step form a 'natural' format (i.e., in seconds) to the needed format, as is expanded according to the TimeResolution. Since in this simulator we will only use the Step structure, we will pass 1 to the last 2 parameters. Parameters: _Param  Parameter manager _Results  Global probe manager _ProbeMgr  Probe manager Definition at line 26 of file SlottedAloha.cpp. References stringToULL(). : DESystem(_Param, _Results, _ProbeMgr, get<IntParameter,int>(_Param, "TimeResolution", "SAloha", ""), stringToULL( get<StringParameter,string>(_Param, "SlotTime", "SAloha", ""), get<IntParameter,int>(_Param, "TimeResolution", "SAloha", "") ), 1, 1) { // remember to clean the pointers to dynamical objects AND // to instantiate them in the Initialize() function, NOT here! ap = 0; PktGen = 0; }

Here is the call graph for this function:

SysSAloha::~SysSAloha (   )  [virtual]

the subclass destructor is optional. Your O.S. sould take care of this, as this destuctor is only called when the program exits, but... Definition at line 102 of file SlottedAloha.cpp. { if( ap ) delete ap; if( PktGen ) delete PktGen; }

---

Member Function Documentation

void SysSAloha::Initialize (   )  [virtual]

the DESystem subclass Initialize() must be here. Initialize() is the core of this class, as here you'll want to create your first objects. The only thing you must do is to call the DESystem::Initialize() function. Sorry but I haven't found any reliable way to do it outside of here. Reimplemented from DESystem. Definition at line 80 of file SlottedAloha.cpp. References DevPktGen::Initialize(), DevAP::Initialize(), and DESystem::Initialize(). { DESystem::Initialize(); // the Access Point is created here. Remember that Initialize() could be called multiple times, // so you need to destroy old objects before creating a new one. if( ap ) delete ap; ap = new DevAP(this); ap->Initialize(); // the Packets Manager. // Since Pkts are created dynamically, a manager is the obvious choice. if( PktGen ) delete PktGen; PktGen = new DevPktGen(this, ap); PktGen->Initialize(); }

Here is the call graph for this function:

void SysSAloha::setup (  ParamManager *  Param, GlobalProbeManager *  Results )  [static]

the DESystem subclass setup() must have those 2 parameters. NePSing will provide the right values. Setup function should only do 3 things (rather important, indeed): setup the parameters of the simulation, CALL the custom classes Setup() funtions, override NePSing parameters defaults (if you need to). Point 2 is of paramount importance, as noone will call those funtions if you don't do it here. Parameters: Param  Parameter manager Results  Global probe manager Definition at line 50 of file SlottedAloha.cpp. References ParamManager::addClass(), ParamManager::addParameter(), ParamManager::setDefault(), DevAP::setup(), DevPktGen::setup(), and DevPkt::setup(). { // general parameters, remember that the division between classes is only for your own convenience, // as you can read any parameter from any class if you want. Param->addClass ("SAloha", "SAloha system"); Param->addParameter ("SAloha", new IntParameter("TimeResolution", "Risoluzione temporale", "-6", "(0,inf)" )); Param->addParameter ("SAloha", new StringParameter("SlotTime", "Length of a slot", "1", "(0,inf)" )); Param->addParameter ("SAloha", new DETimeParameter("RoundTripDelay", "Round trip delay", "1.1", "(0,inf)" )); // remember to call you classes Setup() functions ! DevPkt::setup(Param, Results); DevPktGen::setup(Param, Results); DevAP::setup(Param, Results); // this is optional, but sometimes very useful :) Param->setDefault("BaseFileName", "results/"); Param->setDefault("TimeResolution", "-6"); Param->setDefault("SimulationTime", "100000"); Param->setDefault("WriteStatsInterval", "10000"); Param->setDefault("DebugPrintInterval", "10000"); }

Here is the call graph for this function:

---

The documentation for this class was generated from the following files:

• SlottedAloha.h
• SlottedAloha.cpp

---