== !OpenAirInterface LTE == [[Include(Documentation/Short/Prereq)]] This 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/HowToConnectOAIENBWithOAIUEWithoutS1Interface] tutorial. The image used for this experiment is oai-nos1.ndz. Image uses Ubunutu 14.04 and has low-latency 3.13 kernel install and UHD drivers needed for B210/X310 USRPs (UHD 3.8.2)) as well as the !OpenAirInteface source code installed in /root/openairinterface5g/. More details on various build options are available on [https://twiki.eurecom.fr/twiki/bin/view/OpenAirInterface/AutoBuild OpenAirInterface build page]. In this tutorial we will use nodes equipped with USRP B210 and have the basestation on node1-1 and modem on node1-2 on sandbox 1. === Prepare the nodes === 1. Load the image with the !OpenAirInterface code on the nodes. After imaging the nodes are '''turned off automatically'''. [[CollapsibleStart(omf load -i oai-nos1.ndz -t all)]] [[Include(Documentation/Short/LoadImage)]][[CollapsibleEnd]] 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 all)]][[Include(Documentation/Short/TellOn)]][[CollapsibleEnd]] === Execute the experiment === Primary objective is to establish the LTE connection between the UE and eNB. 1. '''ssh into nodes:''' Open two ssh sessions from the console to the two nodes || [[Image(node1-1.png, width=200)]] || [[Image(node1-2.png, width=200)]] || 2. '''Prepare configuration files:''' The configuration file used for eNB is ''enb.band5.tm1.usrpb210.conf'', located at ''/root/openinterface5g/targets/PROJECTS/GENERIC-LTE-EPC/CONF/''. Another configuration may be used, or a new configuration file can be created using one of the existing ones, so that the parameters can be adjusted. 3. '''Run the lte-softmodem:''' The following commands need to be run in order the execute the LTE softmodem. By default, the IP address of eNB is 10.0.1.1, and the IP of UE is 10.0.1.9. These parameters can be changed in ''/root/openinterface5g/targets/bin/init_nas_nos1''. i. On both nodes, run {{{ source /root/openairinterface5g/targets/bin/init_nas_nos1 }}} ii. On eNB (node1-1), run {{{ sh /root/openairinterface5g/targets/bin/init_nas_nos1 eNB /root/openairinterface5g/targets/bin/lte-softmodem-nos1.Rel10 -d -O /root/conf/enb.band5.tm1.usrpb210.conf 2>&1 | tee ENB.log }}} Depending on whether you want to run it with or without the graphical analyzer, execute lte-softmodem on corresponding nodes: || || On the eNB node (node1-1) || On the UE node (node1-2) || || w/o || {{{ 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). [[Image(Scope.png, width=300)]] || [[CollapsibleStart(The output on both consoles should look something like this:)]] {{{ [RRC][I][eNB 0] Init (UE State = RRC_IDLE)... [RRC][I][eNB 0] Checking release [RRC][I][eNB 0] Rel8 RRC [RRC][I][eNB 0] Configuration SIB2/3 [MAC][I][rrc_mac_config_req] [CONFIG][eNB 0] Configuring MAC/PHY [MAC][I][rrc_mac_config_req] [CONFIG]SIB2/3 Contents (partial) [MAC][I][rrc_mac_config_req] [CONFIG]pusch_config_common.n_SB = 1 [MAC][I][rrc_mac_config_req] [CONFIG]pusch_config_common.hoppingMode = 0 [MAC][I][rrc_mac_config_req] [CONFIG]pusch_config_common.pusch_HoppingOffset = 0 [MAC][I][rrc_mac_config_req] [CONFIG]pusch_config_common.enable64QAM = 0 [MAC][I][rrc_mac_config_req] [CONFIG]pusch_config_common.groupHoppingEnabled = 1 [MAC][I][rrc_mac_config_req] [CONFIG]pusch_config_common.groupAssignmentPUSCH = 0 [MAC][I][rrc_mac_config_req] [CONFIG]pusch_config_common.sequenceHoppingEnabled = 0 [MAC][I][rrc_mac_config_req] [CONFIG]pusch_config_common.cyclicShift = 1 [RRC][I][eNB 0] OPENAIR RRC IN.... [SCTP][I][sctp_handle_new_association_req] Setsockopt SOL_SOCKET socket bound to : eth1 [SCTP][I][sctp_handle_new_association_req] Converted ipv4 address 10.10.0.100 to network type [SCTP][I][sctp_handle_new_association_req] connectx assoc_id 1 in progress..., used 1 addresses [SCTP][I][sctp_handle_new_association_req] Inserted new descriptor for sd 56 in list, nb elements 1, assoc_id 1 [SCTP][I][sctp_eNB_flush_sockets] Found data for descriptor 56 [SCTP][I][sctp_eNB_read_from_socket] Received notification for sd 56, type 32769 [SCTP][I][sctp_eNB_read_from_socket] Client association changed: 0 [SCTP][I][sctp_get_peeraddresses] ---------------------- [SCTP][I][sctp_get_peeraddresses] Peer addresses: [SCTP][I][sctp_get_peeraddresses] - [10.10.0.100] [SCTP][I][sctp_get_peeraddresses] ---------------------- [SCTP][I][sctp_get_sockinfo] ---------------------- [SCTP][I][sctp_get_sockinfo] SCTP Status: [SCTP][I][sctp_get_sockinfo] assoc id .....: 1 [SCTP][I][sctp_get_sockinfo] state ........: 3 [SCTP][I][sctp_get_sockinfo] instrms ......: 8 [SCTP][I][sctp_get_sockinfo] outstrms .....: 64 [SCTP][I][sctp_get_sockinfo] fragmentation : 1452 [SCTP][I][sctp_get_sockinfo] pending data .: 0 [SCTP][I][sctp_get_sockinfo] unack data ...: 0 [SCTP][I][sctp_get_sockinfo] rwnd .........: 106496 [SCTP][I][sctp_get_sockinfo] peer info : [SCTP][I][sctp_get_sockinfo] state ....: 2 [SCTP][I][sctp_get_sockinfo] cwnd .....: 4380 [SCTP][I][sctp_get_sockinfo] srtt .....: 0 [SCTP][I][sctp_get_sockinfo] rto ......: 3000 [SCTP][I][sctp_get_sockinfo] mtu ......: 1500 [SCTP][I][sctp_get_sockinfo] ---------------------- [SCTP][I][sctp_eNB_read_from_socket] Comm up notified for sd 56, assigned assoc_id 1 [S1AP][I][s1ap_eNB_generate_s1_setup_request] 3584 -> 00e000 [SCTP][I][sctp_send_data] Successfully sent 53 bytes on stream 0 for assoc_id 1 [SCTP][I][sctp_eNB_flush_sockets] Found data for descriptor 56 [SCTP][I][sctp_eNB_read_from_socket] Received notification for sd 56, type 32777 [SCTP][I][sctp_eNB_flush_sockets] Found data for descriptor 56 [SCTP][I][sctp_eNB_read_from_socket] [1][56] Msg of length 27 received from port 36412, on stream 0, PPID 18 [S1AP][I][s1ap_decode_s1ap_s1setupresponseies] Decoding message S1ap_S1SetupResponseIEs (/root/trunk/targets/RT/USER/objs/openair-cn/S1AP/s1ap_decoder.c:3544) [ENB_APP][I][eNB_app_task] [eNB 0] Received S1AP_REGISTER_ENB_CNF: associated MME 1 Waiting for eNB application to be ready [HW][I][SCHED] eNB TX thread 0 started on CPU 5 [HW][I][SCHED][eNB] eNB RX thread 0 started on CPU 0 [HW][I][SCHED] eNB TX thread 1 started on CPU 0 [HW][I][SCHED][eNB] eNB RX thread 1 started on CPU 5 [HW][I][SCHED] eNB TX thread 2 started on CPU 2 [HW][I][SCHED][eNB] eNB RX thread 2 started on CPU 0 [HW][I][SCHED] eNB TX thread 3 started on CPU 5 [HW][I][SCHED][eNB] eNB RX thread 3 started on CPU 5 [HW][I][SCHED] eNB TX thread 4 started on CPU 4 [HW][I][SCHED][eNB] eNB RX thread 4 started on CPU 1 [HW][I][SCHED] eNB TX thread 5 started on CPU 4 [HW][I][SCHED][eNB] eNB RX thread 5 started on CPU 4 [HW][I][SCHED] eNB TX thread 6 started on CPU 0 [HW][I][SCHED][eNB] eNB RX thread 6 started on CPU 1 [HW][I][SCHED] eNB TX thread 7 started on CPU 1 [HW][I][SCHED][eNB] eNB RX thread 7 started on CPU 0 [HW][I][SCHED] eNB TX thread 8 started on CPU 1 [HW][I][SCHED][eNB] eNB RX thread 8 started on CPU 0 [HW][I][SCHED] eNB TX thread 9 started on CPU 0 [HW][I][SCHED][eNB] eNB RX thread 9 started on CPU 1 Creating main eNB_thread [SCHED][eNB] Started eNB main thread on CPU 4 eNB_thread: mlockall in ... eNB_thread: mlockall out ... waiting for sync (eNB_thread) TYPE TO TERMINATE Entering ITTI signals handler }}} [[CollapsibleEnd]] === 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 [https://twiki.eurecom.fr/twiki/bin/view/OpenAirInterface/OpenAirLXRT OpenAirInterface real-time LTE softmodem page].