wiki:Tutorials/g0WmLTE/Tutorial6

Version 2 (modified by stojadin, 3 years ago) ( diff )

—

OpenAirInterface 5G Tutorials

  1. WiMAX and LTE Tutorials
    1. Basic WiMax Operations
      1. Prerequisites
      2. Experiment: Image and Ping Nodes Over !WiMAX Interface
      3. About the Base Station
      4. Interacting with the Base Station
      5. Restoring the Base Station to Defaults
      6. Loading a Default Image
      7. Manually Confirming Settings
      8. Connect to the WiMAX Network
      9. Assign an IP Address
      10. Repeat for Other Nodes
      11. Recommended Settings for IP Addresses
      12. Testing Connection
      13. Troubleshooting Connectivity Problems
    1. WiMAX "Hello World" Tutorial
      1. Experimental Scenario
      2. Experiment Description
    1. OMF Based WiMAX Experiment
      1. Prerequisites
      2. About This Experiment
      3. The Code
      4. Dissecting the Experiment
      5. Launch Experiment
      6. Troubleshooting Runtime Problems
      7. Retrieving Results
      8. Final Observations
    1. Basic LTE Tutorial
      1. Objective
      2. Set up
    1. OpenAirInterface LTE Tutorials
      1. Basic OAI Tutorial
      1. OAI Remote Radio Head (RRH)
      1. OAI RRH on ORBIT with eNB Baseband Running on GENI
    1. AmariSoft LTE
      1. Managing the Amarisoft eNB
    1. OpenAirInterface 5G Tutorials
    1. LTE interoperability
      1. Nexus 5, Nexus 5x configuration notes
      2. Notes
      3. OAI eNB with Amarisoft EPC
      4. Amarisoft eNB and EPC
      5. OAI eNB and EPC

Prerequisites

This tutorial series assumes you have an ​ORBIT account, have ​scheduled a session on the ORBIT testbed, are familiar with ​SSH'ing into the testbed itself, and are familiar with the ​basics of running ORBIT experiments. If you have not done these things yet, you may wish to do so before taking a look at this slightly more advanced experiment. If you are unfamiliar with or are entirely new to ORBIT, you may wish to start ​here.

This set of tutorials also assumes basic familiarity with ​LTE standard. They are using ​OpenAirInterface open source software implementation of LTE basestation (eNodeB or eNB) and modem (user equipment or UE) developed at ​Eurecom.

The images used for these experiment are based on Ubunutu 14.04 and have low-latency 3.19 kernel (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.

Build and Execution Scripts

In the image oai-rrh.ndz, scripts are available to compile and execute components. They are divided into three categories

  • Build: pulls from master, then compiles component
  • Quickbuild: compiles component without pull
  • Run: Runs component
  • Available components are split eNB, Remote Radio Head(RRH), and combined eNB
  • Sample config files are available in the ~/conf directory

Each of the build scripts is a simple wrapper around the OAI autobuild script, specifying common options. The run scripts execute the compiled component with common options.

Configuration Files

The run scripts reference the config files in ~/conf. These config files MUST be updated with the latest versions after any operation involving a git pull, as the configuration syntax is not stable across git versions.

Our COTS devices support only bands 25 and 41, and so the new configuration files must be modified to these frequencies. For band25, the band7 file is used as a template. For band41, the band38 file is used as a template. This is functional, but not entirely correct, as calibration must still be done for the new frequencies.

OAI Tutorials

The following basic tutorials based of the OAI source code are available. Note, a git pull was run before saving the images used in the below tutorials. To execute them, run the supplied scripts without pulling changes from openairinterface, as the necessary instructions or config files may change.:

Note: See TracWiki for help on using the wiki.