=== 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. ==== Quickstart Option We have a pair of images available. 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. The image was built following the tutorial available at: [https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/HowToConnectOAIENBWithOAIUEWithoutS1Interface OAI Gitlab tutorial, no S1 interface] [[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]] ===== 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. 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 the nodes on. 1. {{{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. ===== Execute the experiment 1. On node1-1, execute script {{{./run_enb.sh}}} 1. Wait for the visualization to appear. 1. On node1-2, execute script {{{./run_ue.sh}}} 1. Wait for the visualization to appear. 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 address 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}}} 1. As you send traffic, you should see the visualization change, showing a larger constellation as below. [[Image(enb.png, 800px)]] [[Image(ue.png, 400px)]]