== !OpenAirInterface LTE Tutorials == [[TOC(noheading, Tutorials/g0WmLTE*, depth=3)]] [[Include(Documentation/Short/Prereq)]] This set of tutorials also assumes basic familiarity with [http://en.wikipedia.org/wiki/LTE_%28telecommunication%29 LTE standard]. They are using [http://www.openairinterface.org/ OpenAirInterface] open source software implementation of LTE basestation (eNodeB or eNB) and modem (user equipment or UE) developed at [http://www.eurecom.fr/en 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 [https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/OpenAirKernelMainSetup OpenAir instructions]) from ubutbu-14-04-64bit.ndz (baseline.ndz). In addition to installation steps in !OpenAir documentation, once low latency kernel was installed, [wiki:Software/hDrivers drivers for Broadcom and Netgear devices] had to be manually re-installed. Two images were created based on [https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/GetSources git cloning instructions] and [https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/AutoBuild 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.: * [wiki:./Tutorial0 Basic OAI Tutorial] * [wiki:./Tutorial1 OAI Remote Radio Head (RRH)] * [wiki:./Tutorial2 OAI RRH in ORBIT with eNB Baseband in GENI]