wiki:Tutorials/g0WmLTE/Tutorial4-OAI/Tutorial0

Version 4 (modified by seskar, 8 years ago) ( diff )

—

Basic OAI Tutorial

  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

Two nodes…

Objective

Primary objective is to establish the LTE connection between the SDR based UE and eNB. In order to that we need to prepare configuration files on two nodes: node9-1 and node6-20.

The code was compiled with USRP support i.e. with: 

cd trunk/targets/bin; build_oai.bash -l ENB -c -w USRP

More details on various build options are available on ​OpenAirInterface build page.

In this tutorial we will use nodes with USRP b310 and have the basestation on node9-1 and modem on node6-20.

Prepare the nodes

  1. Load the image with the OpenAirInterface code on the nodes that have USRP B210 attached. After imaging the nodes are turned off automatically.
  2. Turn ON the nodes that successfully imaged (give them some time and check their status with omf stat before proceeding).

Execute the experiment

  1. ssh into nodes: Open the two ssh sessions from the console to the two nodes
No image "node9-1.png" attached to Tutorials/g0WmLTE/Tutorial4-OAI/Tutorial0 No image "node6-20.png" attached to Tutorials/g0WmLTE/Tutorial4-OAI/Tutorial0
  1. Prepare configuration files: Make sure to have correct parameters in oai.conf file in roots home directory on the node (/root) as follows:
    1. Operating frequency band parameters:
      1. E-UTRA band
      2. Corresponding duplex mode (e.g. FDD/TDD),
      3. Downlink frequency [Hz], uplink frequency offset [Hz] (which is given in reference to the downlink frequency).
      4. LTE bandwidth: N_RB_DL = {6,15,25,50,75,100} corresponding to bandwidth = {1.4,3,5,10,15,20} MHz For example: 
            ////////// Physical parameters:
    component_carriers = (
                         {
                           frame_type                                         = "FDD";
                           eutra_band                                         = 7;
                           downlink_frequency                                 = 2660000000L;
                           uplink_frequency_offset                            = -120000000;
                           N_RB_DL                                            = 25; #N_RB_DL choice: 6,15,25,50,75,100
                         }
                         );
        In this example, LTE operates in E-UTRA band 7 which allows the FDD mode. LTE operates at 5 MHz bandwidth around downlink and uplink center frequencies which are at 2660 MHz and 2540 MHz, respectively.

Parameters in oai.conf can be varied as long as they are within predefined set of values which can be found in file ~/rel_0.1_26.10.2014/openair2/ENB_APP/enb_config.c or ~/trunk/openair2/ENB_APP/enb_config.c

  1. Make sure to have correct IP address configuration for parameters "ENB_IPV4_ADDRESS_FOR_S1_MME" and "ENB_IPV4_ADDRESS_FOR_S1U" to match node numbers. For example, for nodeX-Y, these IP address parameters become as "10.10.X.Y/16". So for our basestation node the relevant sections in the oai.conf file in /root directory on the nodes we should look like (we don't want MME support and have to adjust the ip addresses to match what we have on the control interface of the node): 
        ////////// MME parameters:
    mme_ip_address      = ( { ipv4       = "10.10.0.100";
                              ipv6       = "10:10:0::100";
                              active     = "no";
                              preference = "ipv4";
                            }
                          );

    NETWORK_INTERFACES : 
    {
        ENB_INTERFACE_NAME_FOR_S1_MME            = "eth1";
        ENB_IPV4_ADDRESS_FOR_S1_MME              = "10.10.9.1/24";

        ENB_INTERFACE_NAME_FOR_S1U               = "eth1";
        ENB_IPV4_ADDRESS_FOR_S1U                 = "10.10.9.1/24";
        ENB_PORT_FOR_S1U                         = 2152; # Spec 2152
    };
  1. Run the lte-softmodem: Depending on whether you want to run it with or without mme, execute lte-softmodem on corresponding nodes:
On the eNB node (node9-1) On the UE node (node6-20)
w/o MME lte-softmodem-nomme -Ooai.conf -V lte-softmodem -U -Ooai.conf -C 2660000000 -V
w MME lte-softmodem -Ooai.conf -V lte-softmodem -U -Ooai.conf -C 2660000000 -V

If the above commands are executed with the "-d" flag and if X11 forwarding is enabled for the current ssh session, the signal tracer will pop out as shown in Figure 1 (not that this requires relatively high bandwidth).

The command line parameters of lte-softmodem

Relevant (i.e. for USRP command line parameters for the lte-softmodem command are:

  • -O file: eNB configuration file (this is the preferred way to pass basic parameters and there are several examples in $OPENAIR_TARGETS/PROJECTS/GENERIC-LTE_EPC/CONF/
  • -g LEVEL: set the level of debug for the log generation (-g7 is quite high and useful to trace bugs in the procedures/protocols, -g9 even dumps packets at all levels of the protocol stack)
  • -d: enables xforms signal tracer
  • -U: start as UE (default: eNB)
  • -C freq: set carrier frequency to f0 for all chains (extension to independent frequencies trivial)
  • -V: enables the VCD debugging tool (this is a temporal event tracer, which is useful for real-time debugging using GTKWave)
  • -K file: ITTI logfile. ITTI is an intertask tracing utility which helps debugging with an EPC. It can traces all exchanges between RRC↔S1AP, RRC↔PDCP, PDCP↔S1
  • -S: do not exit for the missing slots, instead increment the counter.
  • —debug-ue-prach: only send prach but do not connect
  • —no-L2-connect: only runs rx, does not send prach

More details on running lte-softmodem are available on ​OpenAirInterface real-time LTE softmodem page.

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.
  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.
    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.
  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

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

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
  2. Turn the node on
  3. SSH to the node
  4. cd /opt
  5. Run ./setup.sh --build_enb_ue
  6. 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
    2. 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.
    3. 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";
  7. 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

Note: See TracWiki for help on using the wiki.