27 #include <ns3/object.h> 
   28 #include <ns3/spectrum-interference.h> 
   29 #include <ns3/spectrum-error-model.h> 
   32 #include <ns3/simulator.h> 
   33 #include <ns3/packet.h> 
   35 #include "ns3/radio-bearer-stats-calculator.h" 
   36 #include <ns3/constant-position-mobility-model.h> 
   37 #include <ns3/eps-bearer.h> 
   38 #include <ns3/node-container.h> 
   39 #include <ns3/mobility-helper.h> 
   40 #include <ns3/net-device-container.h> 
   41 #include <ns3/lte-ue-net-device.h> 
   42 #include <ns3/lte-enb-net-device.h> 
   43 #include <ns3/lte-ue-rrc.h> 
   44 #include <ns3/lte-helper.h> 
   45 #include "ns3/string.h" 
   46 #include "ns3/double.h" 
   47 #include <ns3/lte-enb-phy.h> 
   48 #include <ns3/lte-ue-phy.h> 
   49 #include <ns3/boolean.h> 
   59   : 
TestSuite (
"lte-fdbet-ff-mac-scheduler", SYSTEM)
 
   61   NS_LOG_INFO (
"creating LenaTestFdBetFfMacSchedulerSuite");
 
   63   bool errorModel = 
false;
 
  154   std::vector<double> dist;
 
  156   dist.push_back (4800);    
 
  157   dist.push_back (6000);    
 
  158   dist.push_back (10000);    
 
  159   dist.push_back (20000);    
 
  160   std::vector<uint32_t> estAchievableRateDl;
 
  161   estAchievableRateDl.push_back (2196000);
 
  162   estAchievableRateDl.push_back (1383000);
 
  163   estAchievableRateDl.push_back (775000);
 
  164   estAchievableRateDl.push_back (421000);
 
  165   estAchievableRateDl.push_back (421000);
 
  166   std::vector<uint32_t> estThrFdBetUl;
 
  167   estThrFdBetUl.push_back (469000); 
 
  168   estThrFdBetUl.push_back (157000); 
 
  169   estThrFdBetUl.push_back (125000); 
 
  170   estThrFdBetUl.push_back (85000);  
 
  171   estThrFdBetUl.push_back (26000);  
 
  184   std::ostringstream oss;
 
  185   oss << nUser << 
" UEs, distance " << dist << 
" m";
 
  190   : 
TestCase (BuildNameString (nUser, dist)),
 
  193     m_thrRefDl (thrRefDl),
 
  194     m_thrRefUl (thrRefUl),
 
  195     m_errorModelEnabled (errorModelEnabled)
 
  246   lteHelper->
Attach (ueDevs, enbDevs.
Get (0));
 
  255   enbPhy->SetAttribute (
"TxPower", 
DoubleValue (30.0));
 
  256   enbPhy->SetAttribute (
"NoiseFigure", 
DoubleValue (5.0));
 
  259   for (
int i = 0; i < 
m_nUser; i++)
 
  265       uePhy->SetAttribute (
"TxPower", 
DoubleValue (23.0));
 
  266       uePhy->SetAttribute (
"NoiseFigure", 
DoubleValue (9.0));
 
  269   double statsStartTime = 0.300; 
 
  270   double statsDuration = 0.6;
 
  271   double tolerance = 0.1;
 
  272   Simulator::Stop (
Seconds (statsStartTime + statsDuration - 0.000001));
 
  286   std::vector <uint64_t> dlDataRxed;
 
  287   for (
int i = 0; i < 
m_nUser; i++)
 
  293       dlDataRxed.push_back (rlcStats->
GetDlRxData (imsi, lcId));
 
  294       NS_LOG_INFO (
"\tUser " << i << 
" imsi " << imsi << 
" bytes rxed " << (
double)dlDataRxed.at (i) << 
"  thr " << (double)dlDataRxed.at (i) / statsDuration << 
" ref " << 
m_thrRefDl);
 
  302   for (
int i = 0; i < 
m_nUser; i++)
 
  311   std::vector <uint64_t> ulDataRxed;
 
  312   for (
int i = 0; i < 
m_nUser; i++)
 
  318       ulDataRxed.push_back (rlcStats->
GetUlRxData (imsi, lcId));
 
  319       NS_LOG_INFO (
"\tUser " << i << 
" imsi " << imsi << 
" bytes rxed " << (
double)ulDataRxed.at (i) << 
"  thr " << (double)ulDataRxed.at (i) / statsDuration << 
" ref " << 
m_thrRefUl);
 
  327   for (
int i = 0; i < 
m_nUser; i++)
 
  331   Simulator::Destroy ();
 
  343   std::ostringstream oss;
 
  344   oss << 
"distances (m) = [ " ;
 
  345   for (std::vector<double>::iterator it = dist.begin (); it != dist.end (); ++it)
 
  355   : 
TestCase (BuildNameString (dist.size (), dist)),
 
  356     m_nUser (dist.size ()),
 
  358     m_achievableRateDl (achievableRateDl),
 
  359     m_estThrFdBetUl (estThrFdBetUl),
 
  360     m_errorModelEnabled (errorModelEnabled)
 
  410   lteHelper->
Attach (ueDevs, enbDevs.
Get (0));
 
  419   enbPhy->SetAttribute (
"TxPower", 
DoubleValue (30.0));
 
  420   enbPhy->SetAttribute (
"NoiseFigure", 
DoubleValue (5.0));
 
  423   for (
int i = 0; i < 
m_nUser; i++)
 
  429       uePhy->SetAttribute (
"TxPower", 
DoubleValue (23.0));
 
  430       uePhy->SetAttribute (
"NoiseFigure", 
DoubleValue (9.0));
 
  434   double statsStartTime = 0.300; 
 
  435   double statsDuration = 0.4;
 
  436   double tolerance = 0.1;
 
  437   Simulator::Stop (
Seconds (statsStartTime + statsDuration - 0.000001));
 
  447   NS_LOG_INFO (
"DL - Test with " << m_nUser << 
" user(s)");
 
  448   std::vector <uint64_t> dlDataRxed;
 
  449   double totalData = 0;
 
  450   double estTotalThr = 0;
 
  452   for (
int i = 0; i < 
m_nUser; i++)
 
  458       dlDataRxed.push_back (rlcStats->
GetDlRxData (imsi, lcId));
 
  459       totalData += (double)dlDataRxed.at (i);
 
  461       NS_LOG_INFO (
"\tUser " << i << 
" dist " << 
m_dist.at (i) << 
" imsi " << imsi << 
" bytes rxed " << (double)dlDataRxed.at (i) << 
"  thr " << (double)dlDataRxed.at (i) / statsDuration << 
" ref " << 
m_nUser);
 
  464   estTotalThr = m_nUser * (1 / estTotalThr);
 
  465   estUeThr = estTotalThr / 
m_nUser;
 
  470   for (
int i = 0; i < 
m_nUser; i++)
 
  472       double thrRatio = (double) 1 / m_nUser;
 
  473       double estThrRatio = (double)dlDataRxed.at (i) / totalData;
 
  474       NS_LOG_INFO (
"\tUser " << i << 
" thrRatio " << thrRatio << 
" estThrRatio " << estThrRatio);
 
  476       NS_TEST_ASSERT_MSG_EQ_TOL ((
double)dlDataRxed.at (i) / statsDuration, estUeThr, estUeThr * tolerance, 
" Unfair Throughput!");
 
  485   std::vector <uint64_t> ulDataRxed;
 
  486   for (
int i = 0; i < 
m_nUser; i++)
 
  492       ulDataRxed.push_back (rlcStats->
GetUlRxData (imsi, lcId));
 
  493       NS_LOG_INFO (
"\tUser " << i << 
" dist " << 
m_dist.at (i) << 
" bytes rxed " << (double)ulDataRxed.at (i) << 
"  thr " << (double)ulDataRxed.at (i) / statsDuration << 
" ref " << (double)
m_estThrFdBetUl.at (i));
 
  496   Simulator::Destroy ();
 
virtual ~LenaFdBetFfMacSchedulerTestCase1()
 
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
 
AttributeValue implementation for Boolean. 
 
NetDeviceContainer InstallEnbDevice(NodeContainer c)
Create a set of eNodeB devices. 
 
bool m_errorModelEnabled
specifies whether the error model is enabled 
 
Ptr< T > GetObject(void) const 
Get a pointer to the requested aggregated Object. 
 
Hold variables of type string. 
 
Ptr< NetDevice > Get(uint32_t i) const 
Get the Ptr stored in this container at a given index. 
 
LenaFdBetFfMacSchedulerTestCase2(std::vector< double > dist, std::vector< uint32_t > achievableRateDl, std::vector< uint32_t > estThrFdBetUl, bool errorModelEnabled)
Constructor. 
 
virtual ~LenaFdBetFfMacSchedulerTestCase2()
 
Ptr< LteEnbPhy > GetPhy(void) const 
 
Mobility model for which the current position does not change once it has been set and until it is se...
 
void Attach(NetDeviceContainer ueDevices)
Enables automatic attachment of a set of UE devices to a suitable cell using Idle mode initial cell s...
 
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name. 
 
void EnableRlcTraces(void)
Enable trace sinks for RLC layer. 
 
#define NS_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO. 
 
uint16_t m_nUser
number of UE nodes 
 
uint16_t m_nUser
number of UE nodes 
 
static std::string BuildNameString(uint16_t nUser, double dist)
Builds the test name string based on provided parameter values. 
 
void ActivateDataRadioBearer(NetDeviceContainer ueDevices, EpsBearer bearer)
Activate a Data Radio Bearer on a given UE devices (for LTE-only simulation). 
 
This system test program creates different test cases with a single eNB and several UEs...
 
LenaFdBetFfMacSchedulerTestCase1(uint16_t nUser, double dist, double thrRefDl, double thrRefUl, bool errorModelEnabled)
Constructor. 
 
void SetSchedulerType(std::string type)
Set the type of scheduler to be used by eNodeB devices. 
 
double m_dist
distance between the nodes 
 
This class contains the specification of EPS Bearers. 
 
void Install(Ptr< Node > node) const 
"Layout" a single node according to the current position allocator type. 
 
AttributeValue implementation for Time. 
 
bool m_errorModelEnabled
error model enabled? 
 
void AddTestCase(TestCase *testCase, TestDuration duration=QUICK)
Add an individual child TestCase to this test suite. 
 
uint64_t GetDlRxData(uint64_t imsi, uint8_t lcid)
Gets the number of received downlink data bytes. 
 
holds a vector of ns3::NetDevice pointers 
 
Test case is simillar to the one defined in LenaFdBetFfMacSchedulerTestCase1, with the difference tha...
 
#define NS_TEST_ASSERT_MSG_EQ_TOL(actual, limit, tol, msg)
Test that actual and expected (limit) values are equal to plus or minus some tolerance and report and...
 
virtual void DoRun(void)
Implementation to actually run this TestCase. 
 
static LenaTestFdBetFfMacSchedulerSuite lenaTestFdBetFfMacSchedulerSuite
 
Every class exported by the ns3 library is enclosed in the ns3 namespace. 
 
keep track of a set of node pointers. 
 
void SetMobilityModel(std::string type, std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue(), std::string n8="", const AttributeValue &v8=EmptyAttributeValue(), std::string n9="", const AttributeValue &v9=EmptyAttributeValue())
 
std::vector< double > m_dist
distance between the nodes 
 
void SetPosition(const Vector &position)
 
double m_thrRefDl
DL throughput reference. 
 
Ptr< RadioBearerStatsCalculator > GetRlcStats(void)
 
NetDeviceContainer InstallUeDevice(NodeContainer c)
Create a set of UE devices. 
 
Helper class used to assign positions and mobility models to nodes. 
 
uint64_t GetUlRxData(uint64_t imsi, uint8_t lcid)
Gets the number of received uplink data bytes. 
 
Test suite for FDBetFfMacScheduler test case. 
 
double m_thrRefUl
UL throughput reference. 
 
Ptr< Node > Get(uint32_t i) const 
Get the Ptr stored in this container at a given index. 
 
Time Seconds(double value)
Construct a Time in the indicated unit. 
 
void SetDefault(std::string name, const AttributeValue &value)
 
std::vector< uint32_t > m_achievableRateDl
DL achievable rate. 
 
void Create(uint32_t n)
Create n nodes and append pointers to them to the end of this NodeContainer. 
 
void EnableMacTraces(void)
Enable trace sinks for MAC layer. 
 
Ptr< LteUePhy > GetPhy(void) const 
Get the Phy. 
 
virtual void DoRun(void)
Implementation to actually run this TestCase. 
 
This class can be used to hold variables of floating point type such as 'double' or 'float'...
 
LenaTestFdBetFfMacSchedulerSuite()
 
void SetAttribute(std::string name, const AttributeValue &value)
Set a single attribute, raising fatal errors if unsuccessful. 
 
The eNodeB device implementation. 
 
static std::string BuildNameString(uint16_t nUser, std::vector< double > dist)
Builds the test name string based on provided parameter values. 
 
std::vector< uint32_t > m_estThrFdBetUl
estimated throughput FDBET UL 
 
The LteUeNetDevice class implements the UE net device.