Changes between Initial Version and Version 1 of WirelessVT2016/SoftLTE


Ignore:
Timestamp:
05/30/16 21:00:30 (5 years ago)
Author:
agosain@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WirelessVT2016/SoftLTE

    v1 v1  
     1== !OpenAirInterface LTE ==
     2
     3[[Include(Documentation/Short/Prereq)]]
     4
     5This tutorial also assumes basic familiarity with [http://en.wikipedia.org/wiki/LTE_%28telecommunication%29 LTE standard]. It uses [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 tutorial given here is based on the [https://twiki.eurecom.fr/twiki/bin/view/OpenAirInterface/OpenAirLXRT OAI_real-time_LTEsoftmodem] tutorial.
     6
     7The image used for this experiment is oai-trunk-head.ndz. Image uses Ubunutu 14.04 and has low-latency 3.19 kernel install and UHD drivers needed for B210/X310 USRPs (UHD 3.8.2)). This image was derived from vanilla image ubuntu-14-04-64bit-3.19-lowlatency.ndz (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.
     8
     9Two 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]:
     10
     11 * '''oai-master.ndz''' - master branch clone from git in /root
     12
     13 * '''oai-develop.ndz''' - develop branch clone from git in /root
     14
     15The 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. 
     16
     17Update 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.
     18
     19
     20[[CollapsibleStart(If you intend to use graphical user interface please make sure to install appropriate tools on your local machine and configure X11 forwarding.)]]
     21  [[Include(Documentation/bAccountManagement/fRemoteX)]]
     22  [[CollapsibleEnd]]
     23------------------------
     24
     25=== Quickstart Option ===
     26We 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.
     27
     281. To proceed, after having a reservation, load the following image.
     29 * {{{omf load -t node1-1,node1-2 -i oai-dev.ndz}}}
     30 * The nodes will automatically turn off when imaging is completed.
     311. Turn the nodes on.
     32 * {{{omf tell -a on -t node1-1,node1-2}}}
     331. Open a terminal to each node. You must enable X11 Forwarding to see the GUI and statistics screens.
     341. On the first node, execute script {{{./CompandRuneNB}}}
     351. On the second node, execute script {{{./CompandRunUE}}}
     361. For subsequent runs, execute {{{./runeNB}}} or {{{./runUE}}} instead, to avoid recompiling.
     371. These scripts will create interface {{{oai0}}} and assign an address.
     38 1. Use {{{ifconfig}}} or {{{ip a}}} to see the address assigned.
     39 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.
     401. You should be able to ping from one node to the other on these addresses.
     41 1. From UE, {{{ping 10.0.1.1}}} or to see live statistics {{{mtr 10.0.1.1}}}
     421. For throughput testing
     43 1. On the eNB, execute {{{iperf -s}}}
     44 1. On the UE, execute {{{iperf -c 10.0.1.1}}}
     45
     46
     47--------------------------------
     48
     49The code was compiled with USRP support i.e. with:
     50{{{
     51cd trunk/targets/bin; build_oai.bash -l ENB -c -w USRP
     52}}}
     53More details on various build options are available on [https://twiki.eurecom.fr/twiki/bin/view/OpenAirInterface/AutoBuild OpenAirInterface build page].
     54
     55In this tutorial we will use nodes with USRP b310 and have the basestation on node9-1 and modem on node6-20.
     56
     57
     58
     59
     60=== Prepare the nodes ===
     61
     62 1. Load the image with the !OpenAirInterface code on the nodes that have USRP B210 attached. After imaging the nodes are '''turned off automatically'''. [[CollapsibleStart(omf load -t inventory:topo:B210 -i oai-master.ndz)]] [[Include(Documentation/Short/LoadImage)]][[CollapsibleEnd]]
     63 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]]
     64
     65=== Execute the experiment ===
     66
     67Primary objective is to establish the LTE connection between the UE and eNB. In order to that we need to prepare configuration files on two nodes: node9-1 and node6-20.
     68  1. '''ssh into nodes:''' Open the two ssh sessions from the console to the two nodes
     69|| [[Image(node9-1.png, width=200)]] || [[Image(node6-20.png, width=200)]] ||
     70  2. '''Prepare configuration files:''' Make sure to have correct parameters in oai.conf file in roots home directory on the node (/root) as follows:
     71     i. Operating frequency band parameters:
     72          a. E-UTRA band
     73          b. Corresponding duplex mode (e.g. FDD/TDD),
     74          c. Downlink frequency [Hz], uplink frequency offset [Hz] (which is given in reference to the downlink frequency).
     75          d. LTE bandwidth: N_RB_DL = {6,15,25,50,75,100} corresponding to bandwidth = {1.4,3,5,10,15,20} MHz
     76          For example:
     77          {{{
     78    ////////// Physical parameters:
     79    component_carriers = (
     80                         {
     81                           frame_type                                         = "FDD";
     82                           eutra_band                                         = 7;
     83                           downlink_frequency                                 = 2660000000L;
     84                           uplink_frequency_offset                            = -120000000;
     85                           N_RB_DL                                            = 25; #N_RB_DL choice: 6,15,25,50,75,100
     86                         }
     87                         );
     88          }}}
     89          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.
     90
     91          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
     92
     93     ii. 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):
     94     {{{
     95    ////////// MME parameters:
     96    mme_ip_address      = ( { ipv4       = "10.10.0.100";
     97                              ipv6       = "10:10:0::100";
     98                              active     = "no";
     99                              preference = "ipv4";
     100                            }
     101                          );
     102
     103    NETWORK_INTERFACES :
     104    {
     105        ENB_INTERFACE_NAME_FOR_S1_MME            = "eth1";
     106        ENB_IPV4_ADDRESS_FOR_S1_MME              = "10.10.9.1/24";
     107
     108        ENB_INTERFACE_NAME_FOR_S1U               = "eth1";
     109        ENB_IPV4_ADDRESS_FOR_S1U                 = "10.10.9.1/24";
     110        ENB_PORT_FOR_S1U                         = 2152; # Spec 2152
     111    };
     112     }}}
     113  3. '''Run the lte-softmodem:''' Depending on whether you want to run it with or without mme, execute lte-softmodem on corresponding nodes:
     114
     115 || || On the eNB node (node9-1) || On the UE node (node6-20)  ||
     116 || w/o MME || {{{ lte-softmodem-nomme -Ooai.conf -V}}} || {{{ lte-softmodem -U -Ooai.conf -C 2660000000 -V}}} ||
     117 || w MME || {{{ lte-softmodem -Ooai.conf -V}}} || {{{ lte-softmodem -U -Ooai.conf -C 2660000000 -V}}} ||
     118
     119If 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).
     120[[Image(Scope.png, width=300)]] ||
     121
     122[[CollapsibleStart(The output on both consoles should look something like this:)]]
     123{{{
     124[RRC][I][eNB 0] Init (UE State = RRC_IDLE)...
     125[RRC][I][eNB 0] Checking release
     126[RRC][I][eNB 0] Rel8 RRC
     127[RRC][I][eNB 0] Configuration SIB2/3
     128[MAC][I][rrc_mac_config_req] [CONFIG][eNB 0] Configuring MAC/PHY
     129[MAC][I][rrc_mac_config_req] [CONFIG]SIB2/3 Contents (partial)
     130[MAC][I][rrc_mac_config_req] [CONFIG]pusch_config_common.n_SB = 1
     131[MAC][I][rrc_mac_config_req] [CONFIG]pusch_config_common.hoppingMode = 0
     132[MAC][I][rrc_mac_config_req] [CONFIG]pusch_config_common.pusch_HoppingOffset = 0
     133[MAC][I][rrc_mac_config_req] [CONFIG]pusch_config_common.enable64QAM = 0
     134[MAC][I][rrc_mac_config_req] [CONFIG]pusch_config_common.groupHoppingEnabled = 1
     135[MAC][I][rrc_mac_config_req] [CONFIG]pusch_config_common.groupAssignmentPUSCH = 0
     136[MAC][I][rrc_mac_config_req] [CONFIG]pusch_config_common.sequenceHoppingEnabled = 0
     137[MAC][I][rrc_mac_config_req] [CONFIG]pusch_config_common.cyclicShift  = 1
     138[RRC][I][eNB 0] OPENAIR RRC IN....
     139[SCTP][I][sctp_handle_new_association_req] Setsockopt SOL_SOCKET socket bound to : eth1
     140[SCTP][I][sctp_handle_new_association_req] Converted ipv4 address 10.10.0.100 to network type
     141[SCTP][I][sctp_handle_new_association_req] connectx assoc_id  1 in progress..., used 1 addresses
     142[SCTP][I][sctp_handle_new_association_req] Inserted new descriptor for sd 56 in list, nb elements 1, assoc_id 1
     143[SCTP][I][sctp_eNB_flush_sockets] Found data for descriptor 56
     144[SCTP][I][sctp_eNB_read_from_socket] Received notification for sd 56, type 32769
     145[SCTP][I][sctp_eNB_read_from_socket] Client association changed: 0
     146[SCTP][I][sctp_get_peeraddresses] ----------------------
     147[SCTP][I][sctp_get_peeraddresses] Peer addresses:
     148[SCTP][I][sctp_get_peeraddresses]     - [10.10.0.100]
     149[SCTP][I][sctp_get_peeraddresses] ----------------------
     150[SCTP][I][sctp_get_sockinfo] ----------------------
     151[SCTP][I][sctp_get_sockinfo] SCTP Status:
     152[SCTP][I][sctp_get_sockinfo] assoc id .....: 1
     153[SCTP][I][sctp_get_sockinfo] state ........: 3
     154[SCTP][I][sctp_get_sockinfo] instrms ......: 8
     155[SCTP][I][sctp_get_sockinfo] outstrms .....: 64
     156[SCTP][I][sctp_get_sockinfo] fragmentation : 1452
     157[SCTP][I][sctp_get_sockinfo] pending data .: 0
     158[SCTP][I][sctp_get_sockinfo] unack data ...: 0
     159[SCTP][I][sctp_get_sockinfo] rwnd .........: 106496
     160[SCTP][I][sctp_get_sockinfo] peer info     :
     161[SCTP][I][sctp_get_sockinfo]     state ....: 2
     162[SCTP][I][sctp_get_sockinfo]     cwnd .....: 4380
     163[SCTP][I][sctp_get_sockinfo]     srtt .....: 0
     164[SCTP][I][sctp_get_sockinfo]     rto ......: 3000
     165[SCTP][I][sctp_get_sockinfo]     mtu ......: 1500
     166[SCTP][I][sctp_get_sockinfo] ----------------------
     167[SCTP][I][sctp_eNB_read_from_socket] Comm up notified for sd 56, assigned assoc_id 1
     168[S1AP][I][s1ap_eNB_generate_s1_setup_request] 3584 -> 00e000
     169[SCTP][I][sctp_send_data] Successfully sent 53 bytes on stream 0 for assoc_id 1
     170[SCTP][I][sctp_eNB_flush_sockets] Found data for descriptor 56
     171[SCTP][I][sctp_eNB_read_from_socket] Received notification for sd 56, type 32777
     172[SCTP][I][sctp_eNB_flush_sockets] Found data for descriptor 56
     173[SCTP][I][sctp_eNB_read_from_socket] [1][56] Msg of length 27 received from port 36412, on stream 0, PPID 18
     174[S1AP][I][s1ap_decode_s1ap_s1setupresponseies] Decoding message S1ap_S1SetupResponseIEs (/root/trunk/targets/RT/USER/objs/openair-cn/S1AP/s1ap_decoder.c:3544)
     175[ENB_APP][I][eNB_app_task] [eNB 0] Received S1AP_REGISTER_ENB_CNF: associated MME 1
     176Waiting for eNB application to be ready
     177[HW][I][SCHED] eNB TX thread 0 started on CPU 5
     178[HW][I][SCHED][eNB] eNB RX thread 0 started on CPU 0
     179[HW][I][SCHED] eNB TX thread 1 started on CPU 0
     180[HW][I][SCHED][eNB] eNB RX thread 1 started on CPU 5
     181[HW][I][SCHED] eNB TX thread 2 started on CPU 2
     182[HW][I][SCHED][eNB] eNB RX thread 2 started on CPU 0
     183[HW][I][SCHED] eNB TX thread 3 started on CPU 5
     184[HW][I][SCHED][eNB] eNB RX thread 3 started on CPU 5
     185[HW][I][SCHED] eNB TX thread 4 started on CPU 4
     186[HW][I][SCHED][eNB] eNB RX thread 4 started on CPU 1
     187[HW][I][SCHED] eNB TX thread 5 started on CPU 4
     188[HW][I][SCHED][eNB] eNB RX thread 5 started on CPU 4
     189[HW][I][SCHED] eNB TX thread 6 started on CPU 0
     190[HW][I][SCHED][eNB] eNB RX thread 6 started on CPU 1
     191[HW][I][SCHED] eNB TX thread 7 started on CPU 1
     192[HW][I][SCHED][eNB] eNB RX thread 7 started on CPU 0
     193[HW][I][SCHED] eNB TX thread 8 started on CPU 1
     194[HW][I][SCHED][eNB] eNB RX thread 8 started on CPU 0
     195[HW][I][SCHED] eNB TX thread 9 started on CPU 0
     196[HW][I][SCHED][eNB] eNB RX thread 9 started on CPU 1
     197Creating main eNB_thread
     198[SCHED][eNB] Started eNB main thread on CPU 4
     199eNB_thread: mlockall in ...
     200eNB_thread: mlockall out ...
     201waiting for sync (eNB_thread)
     202TYPE <CTRL-C> TO TERMINATE
     203Entering ITTI signals handler
     204
     205}}}
     206[[CollapsibleEnd]]
     207
     208
     209=== The command line parameters of lte-softmodem ===
     210Relevant (i.e. for USRP command line parameters for the lte-softmodem command are:
     211 * -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/
     212 * -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)
     213 * -d: enables xforms signal tracer
     214 * -U: start as UE (default: eNB)
     215 * -C freq: set carrier frequency to f0 for all chains (extension to independent frequencies trivial)
     216 * -V: enables the VCD debugging tool (this is a temporal event tracer, which is useful for real-time debugging using GTKWave)
     217 * -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
     218 * -S: do not exit for the missing slots, instead increment the counter.
     219 * --debug-ue-prach: only send prach but do not connect
     220 * --no-L2-connect: only runs rx, does not send prach
     221
     222More details on running lte-softmodem are available on [https://twiki.eurecom.fr/twiki/bin/view/OpenAirInterface/OpenAirLXRT OpenAirInterface real-time LTE softmodem page].