=== Under Construction ===
=== Basic OAI Tutorial ===

[[TOC(noheading, Tutorials/g0WmLTE*, depth=3)]]

==== Objective ====
This objective of this tutorial is to establish a LTE connection between the SDR based  UE and eNB. In order to that we need to prepare configuration files on two nodes in sandbox 1, node1-1 and node1-2.

------------------------------

The image was built following the tutorial available at:
[https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/HowToConnectOAIENBWithOAIUEWithoutS1Interface OAI no S1]


==== Prepare the nodes ====

1. Load the two images with the OAI code to nodes 1-1 and 1-2. This enables running the experiment with no compilation needed. [[Include(Documentation/Short/LoadImage)]][[CollapsibleEnd]] 
 1. Load the eNB image to node1-1.
  1. {{{omf load -t node1-1 -i mf-oai-enb.ndz}}}
 1. Load the UE image to node1-2.
  1. {{{omf load -t node1-2 -i mf-oai-ue.ndz}}}
1. Turn ON the nodes that successfully imaged (give them some time and check their status with '''omf stat''' before proceeding). [[CollapsibleStart(omf tell -a on -t system:topo:imaged)]][[Include(Documentation/Short/TellOn)]][[CollapsibleEnd]]

==== Execute the experiment ====


[[CollapsibleStart(If you intend to use graphical user interface please make sure to install appropriate tools on your local machine and configure X11 forwarding.)]]
  [[Include(Documentation/bAccountManagement/fRemoteX)]]
  [[CollapsibleEnd]]
------------------------

==== Quickstart Option ====
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.
1. Turn the nodes on.
 * {{{omf tell -a on -t node1-1,node1-2}}}
1. Open a terminal to each node. You must enable X11 Forwarding to see the GUI and statistics screens.
 1. You will need at lease one terminal per node, for the statistics screens. Even more if you want to run additional commands. For details, refer to the Remote Graphical Access section.
1. On the first node, execute script {{{./CompandRuneNB}}}
1. On the second node, execute script {{{./CompandRunUE}}}
1. For subsequent runs, execute {{{./runeNB}}} or {{{./runUE}}} instead, to avoid recompiling.
1. These scripts will create interface {{{oai0}}} and assign an address.
 1. Use {{{ifconfig}}} or {{{ip a}}} to see the address assigned.
 1. By default the eNB has address 10.0.1.1, and the UE has addresss 10.0.1.9, but you should double check.
1. 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}}}

In your terminals, you will see the following screens upon successful script execution.

[[Image(eNB.png, width=600)]] [[Image(UE.png, width=600)]]

==== OAI eNB in ORBIT
UNDER DEVELOPMENT

1. Load image lte-edge.ndz to a node with a b210
 1. This can be found from the status page
1. Turn the node on
1. SSH to the node
1. {{{ cd /opt }}}
1. Run {{{ ./setup.sh --build_enb_ue }}}
1. Edit the configuration file to match the needed IP using the editor of your choice (example vim)
 1. {{{ vim ./conf/enb.band25.tm1.usrpb210.conf }}}
 1. The MME ip address is on the line 
{{{
mme_ip_address      = ( { ipv4       = "10.3.0.21";
}}}
  1. Do not change this unless you are using a custom MME, rather than the ORBIT hosted one, or are tunneling.
 1. Set the following four lines to match the interface you will use to connect to the MME. In this example it is set to use eth1 on node8-7.grid.orbit-lab.org.
{{{ 
ENB_INTERFACE_NAME_FOR_S1_MME            = "eth0";
ENB_IPV4_ADDRESS_FOR_S1_MME              = "10.40.4.5/16";
ENB_INTERFACE_NAME_FOR_S1U               = "eth0";
ENB_IPV4_ADDRESS_FOR_S1U                 = "10.40.4.5/16"; 
}}}
1. Run the eNB {{{ ./openairinterface5g/cmake_targets/lte_build_oai/build/lte-softmodem -O ./conf/enb.band25.tm1.usrpb210.conf }}}
 1. Some options to append
  1. -d : shows visual displays