View on GitHub

LTE User Plane Simulation Model for INET & OMNeT++

Download this project as a tar.gz file

Frequently Asked Questions

Q: How do I get involved?

A: Cool! You have some choices here:

If you already developed new functionalities for SimuLTE (or you are planning to do so) and you would like to integrate them in the repository, please contact us
If you have any SimuLTE-related research project or research article, and you want it to be published here, please contact us
If you just want to start contributing to the SimuLTE project, we suggest you to start by taking a look at the code on the GitHub repository, and possibly sharing your ideas with the community via the OMNeT++ Google Group.

The SimuLTE community is proud of you!

Q: How can I set the number of available Resource Blocks in Downlink/Uplink?

A: It can be set via the numRbDl/numRbUl parameters of the deployer. For example you can both values in .ini file as follows

**.deployer.numRbDl = 6
**.deployer.numRbUl = 6

Q: How can I select the serving eNB for a UE?

A: It can be selected using the macCellId and masterId parameters of the UE node. For example lets suppose we have 2 UEs (ue1 and ue2) and two eNB (enb1 and enb2). We can connect ue1 with enb1 and ue2 with enb2 usign the following code in an .ini file:

**.ue1.macCellId = 1
**.ue1.masterId  = 1

**.ue2.macCellId = 2
**.ue2.masterId  = 2

NOTE that ids are assigned to the eNBs progressively, according to their creation order in the network file.
For more info on this topic, you may want to take a look at the tutorial "Simulating more than one cell"

Q: I need to measure channel utilization (or something alike) and packet loss for the LTE network. Are there any parameters in SimuLTE which provide this information?

A: There are two main metrics you may be interested in:
Channel utilization: look at cellBlocksUtilizationDl for a percentage of used RBs over the total in downlink. As an alternative avgServedBlocksDl gives you the average per-TTI number of used RBs. (same think applies in uplink, adding the suffix UL instead of DL)
Packet Loss: as far as it is concerned you are probably looking for HARQ errors (i.e. error due to decoding). Those statistics are stored into harqErrorRateDl, which gives you a percentage of errors due to HARQ, over the total of transport blocks received. If you need more detailed information, look at harqErrorRate_1st_Dl , harqErrorRate_2nd_Dl, etc. which gives you the same information as above, but related to 1st HARQ transmissions, 2nd transmissions and so on.