wiki:WirelessVT2016/SoftLTE

OpenAirInterface LTE

This tutorial also assumes basic familiarity with LTE standard. It uses OpenAirInterface open source software implementation of LTE basestation (eNodeB or eNB) and modem (user equipment or UE) developed at Eurecom. The tutorial given here is based on the OAI_real-time_LTEsoftmodem tutorial.

The image used for this experiment is oai-trunk-head.ndz. Image uses Ubunutu 14.04 and has low-latency 3.19 kernel install and UHD drivers needed for B210/X310 USRPs (UHD 3.8.2)). This image was derived from vanilla image ubuntu-14-04-64bit-3.19-lowlatency.ndz (that was created based on OpenAir instructions) from ubutbu-14-04-64bit.ndz (baseline.ndz). In addition to installation steps in OpenAir documentation, once low latency kernel was installed, drivers for Broadcom and Netgear devices? had to be manually re-installed.

Two images were created based on git cloning instructions and compiling instructions:

  • oai-master.ndz - master branch clone from git in /root
  • oai-develop.ndz - develop branch clone from git in /root

The openair-cn (EPC) was installed with default passwords of oai and default choice of "N" for optional packages (freeDiameter, asn1c pach and xtables_addons_oai). xtables_addons_oai was pulled out of git but not installed.

Update for oai-develop.ndz: The openair-cn (EPC) was installed with default passwords of oai and default choice of "Y" for optional packages (freeDiameter, asn1c pach and xtables_addons_oai). xtables_addons_oai was pulled out of git and installed.


Quickstart Option

Note If you intend to use graphical user interface please make sure to install appropriate tools on your local machine and configure X11 forwarding

We have an image available, named oai-dev.ndz. It has all the necessary driver and software pre-installed, and two scripts available to immediately boot up the eNB and UE. This quickstart assumes use of Sandbox1, nodes 1-1, and 1-2.

  1. To proceed, after having a reservation, load the following image.
    • omf load -t node1-1,node1-2 -i oai-dev.ndz
    • The nodes will automatically turn off when imaging is completed.
  2. Turn the nodes on.
    • omf tell -a on -t node1-1,node1-2
  3. Open a terminal to each node. You must enable X11 Forwarding to see the GUI and statistics screens.
  4. On the first node, execute script ./CompandRuneNB
  5. On the second node, execute script ./CompandRunUE
  6. For subsequent runs, execute ./runeNB or ./runUE instead, to avoid recompiling.
  7. These scripts will create interface oai0 and assign an address.
    1. Use ifconfig or ip a to see the address assigned.
    2. By default the eNB has address 10.0.1.1, and the UE has addresss 10.0.1.9, but you should double check.
  8. You should be able to ping from one node to the other on these addresses.
    1. From UE, ping 10.0.1.1 or to see live statistics mtr 10.0.1.1
  9. For throughput testing
    1. On the eNB, execute iperf -s
    2. On the UE, execute iperf -c 10.0.1.1

Sample output looks like:

Last modified 3 years ago Last modified on 06/01/16 14:34:05

Attachments (1)

Download all attachments as: .zip