5G-Sim-V2I/N

Open Source 5G V2I / V2N Application-Level Simulation OMNeT++-framework. We tested the framework with Linux Mint 18.3, 19.3 and Ubuntu 18.04 (we use gcc/g++ in version 7.5 for compiling). We could also successfully test the framework on Windows 10. For our tests we used OMNeT++ version 5.6.2.

Features

• Covers the 5G User Plane (3GPP Release 15) for simulating use cases in the context of V2I / N.
• Measuring of several QoS-relevant parameters like packet delay, jitter, reliability and other at application layer.
• Allows simulating different parallel running applications in each vehicle (see default example).
• Comes by default with a motorway and an urban traffic scenario.
• Channel Models from ITU-Guidelines (ITU-R M.2412-0) / 3gpp Specification (38.901, RMa, UMa, UMi, InF) are included (see the folder channelConfigs under lteNR/simulationsNR/)
• Based on the well-known Frameworks SimuLTE/Simu5G, INET and Veins.

Prerequisites

• You need OMNeT++ (version 5.6.2, https://omnetpp.org/download/) for using this framework and the traffic simulator SUMO in version 1.8.0 (https://sumo.dlr.de/docs/index.html).
• Compile and build both and ensure each of them works.
• Download the framework from this site.

Installing

• Start OMNeT++ after building, create a new and empty workspace and import the 5G-SIM-folder by clicking File --> Import --> General --> Existing Projects into Workspace --> Choose the downloaded and extracted 5G-SIM-Folder --> Mark "Copy projects into Workspace".
• The framework consists of the Veins-Framework (folders Veins and Veins_inet3) in version 5.1 (https://veins.car2x.org/),
• The INET-framework (inet-folder) in Version 3.7.0 (https://inet.omnetpp.org/) --> Ensure that the inet_featuretool in the inet-folder has execute-privileges before compiling,
• The SimuLTE-framework (https://simulte.com/) in version 1.1.0 in the lteNR folder. All NR-relevant code is located in src/nr-folder.
• Push the compile button in the OMNeT++-Gui for building the framework.

Run the examples

• You have to start the sumo-listener (sumo-launchd.py) from the veins-folder via command line before starting the simulation. See the veins-tutorial (https://veins.car2x.org/tutorial/) for all necessary steps.
• In the lteNR-folder, the simulation examples for a motorway and an urban traffic scenario are available (in the simulationsNR-folder).
• In both scenarios you can simulate an example which runs four UDP-applications simultaneously in each car. For that, you just need to run the omnetpp.ini-files within the motorway and urban folder, respectively.

Post-processing

• Within the postProcessing-folder an R-Script is contained that can be used for plotting the KPIs packet delay, reliability and jitter from the default scenarios.
• You need the OMNeT++-R-Package for using the script with R Studio.
• See the OMNeT++-github-site (https://github.com/omnetpp/omnetpp-resultfiles) for further information how to install the package within R Studio.

See changeLog.txt for information about the latest changes. The current version is v0.4

Authors

• Thomas Deinlein - https://github.com/deinleinT [email protected]
• Please contact us via email if you have any questions.

Citation

If you use this framework, please cite it as follows:

T. DEINLEIN, R. GERMAN and A. DJANATLIEV, "5G-Sim-V2I/N: Towards a Simulation Framework for the Evaluation of 5G V2I/V2N Use Cases," 2020 European Conference on Networks and Communications (EuCNC), Dubrovnik, Croatia, 2020, pp. 353-357, DOI: 10.1109/EuCNC48522.2020.9200949.

Further publications

T. DEINLEIN, M. ROSHDI, T. NAN, T. HEYN, A. DJANATLIEV, and R. GERMAN , “On the Impact of priority-based MAC Layer Scheduling in 5G V2N multi-application Scenarios,” in 2021 13th IFIP Wireless and Mobile Networking Conference (WMNC). IEEE, 2021, pp. 63–70, ISBN: 978-3-903176-42-3, DOI: 10.23919/WMNC53478.2021.9619001.

T. DEINLEIN, A. BRUMMER, R. GERMAN , and A. DJANATLIEV, “On the Impact of Buildings on the LoS Evaluation in System-Level V2I/N Simulations,” in 2021 IEEE 94th Vehicular Technology Conference (VTC2021-Fall), IEEE, 2021, pp. 1–5, ISBN: 978-1-6654-1368-8, DOI: 10.1109/VTC2021-Fall52928.2021.9625489.

T. DEINLEIN, R. GERMAN, and A. DJANATLIEV, “Evaluation of the 5G Data Plane for Advanced Vehicular Use Cases with 5G-Sim-V2I/N,” in 2020 IEEE Vehicular Networking Conference (VNC), 2020, pp. 1–8, DOI: 10.1109/V-NC51378.2020.9318368.

T. DEINLEIN, R. GERMAN, and A. DJANATLIEV, “Simulative Comparison of 4G/5G ITU Channel Models in the Context of V2I,” in 2019 IEEE 90th Vehicular Technology Conference (VTC2019-Fall). IEEE, 9/22/2019 - 9/25/2019, pp. 1–5, DOI: 10.1109/VTCFall.2019.8891094.

License

See the LICENSE.txt file for details.