Changes between Version 40 and Version 41 of Tutorials/g0WmLTE/Tutorial5


Ignore:
Timestamp:
Nov 10, 2016, 6:47:31 PM (5 years ago)
Author:
msherman
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • Tutorials/g0WmLTE/Tutorial5

    v40 v41  
    11== !AmariSoft LTE ==
    22
    3 [[Include(Documentation/Short/Prereq)]]
    4 === Imaging ===
    5 The image used for this experiment is 'baseline.ndz'. In this tutorial we will use nodes equipped with Netgear AC341u LTE dongles. The basestation is Amarisoft running on Bsc03out.
    6 
    7 During a normal experiment using OMF, the following actions are scripted and automated. This is a look at the steps involved in something as simple as starting an LTE connection behind the scenes.
    8 
    9 You will run the following commands on node7-1, node1-7, and node19-3 in the Grid.
    10 
    11 After connecting to the grid console:
    12 1. {{{ omf load -i baseline.ndz -t node7-1.grid.orbit-lab.org }}}
    13 1. {{{ omf tell -a on -t node7-1.grid.orbit-lab.org }}}
    14  1. It will take roughly 60 seconds to come up.
    15 1. {{{ ssh root@node7-1.grid.orbit-lab.org }}}
    16 
    17 === Commands on the node ===
    18 
    19 ==== Loading the driver ====
    20 
    21 By Default Orbit nodes do not configure any wireless devices so the first thing, when manually configuring the device is to load the drivers; the following 2 lines will load the Sierra wireless Netgear LTE dongle:[[BR]]
    22 {{{
    23 modprobe GobiSerial
    24 modprobe GobiNet
    25 }}}
    26 
    27 ==== Connecting to the device ====
    28 Control of the device is done over the serial port that is created by the driver (in this case '''/dev/ttyUSB1''') through a sequence of AT commands and you can use your favorite serial port communication program to talk to it; in this tutorial we will use '''Minicom''. To start to program execute:
    29 
    30 {{{ minicom -D /dev/ttyUSB1 }}}
    31 
    32 ==== Managing the LTE connection ====
    33 
    34 Once in minicom, one can issue series of commands to the LTE modem typically consisting of:
    35 
    36 a.) Configure modem for pass-through mode:
    37 
    38 {{{ AT!ippassthrough? }}}
    39 
    40 It should return '''1''' . If it does not, run the following commands:
    41     1. {{{ AT!ippassthrough=1 }}}
    42     1. {{{ AT!entercnd="A710" }}}
    43     1. {{{ AT!dxcfg=profile,Autoconnect,Never }}}
    44     1. {{{ AT!reset }}}
    45 which will reset the modem.
    46 
    47 b.)
    48 
    49 {{{ AT!entercnd="A710" }}}
    50 
    51 You should see {{{ OK }}}
    52 
    53 c.) Connect to the basestation:
    54 
    55 {{{ AT!dxcfg=wwan,connect,11 }}}
    56 
    57 You should see {{{ OK }}} shortly followed by {{{ $QCRMCALL: 1, V4 }}}
    58 
    59 d.) Check the status of the connection:
    60 
    61 {{{ at!gstatus? }}}
    62 
    63 Will return a status like:
    64 {{{
    65 at!gstatus?                                                                                                         
    66 !GSTATUS:
    67 Current Time:  10049            Temperature: 42
    68 Bootup Time:   0                Mode:        ONLINE         
    69 System mode:   LTE              PS state:    Attached     
    70 LTE band:      B25              LTE bw:      10 MHz 
    71 LTE Rx chan:   8365             LTE Tx chan: 26365
    72 EMM state:     Registered       Normal Service
    73 RRC state:     RRC Connected 
    74 IMS reg state: No Srv 
    75 
    76 RSSI (dBm):    -83              Tx Power:    0
    77 RSRP (dBm):    -117             TAC:         0001 (1)
    78 RSRQ (dB):     -10              Cell ID:     01A2D001 (27447297)
    79 SINR (dB):      1.6
    80 }}}
    81 
    82 The LTE link is established. Exit Minicom by **PRESSING** {{{ Ctrl+A followed by x}}}, then {{{enter}}} to select '''OK''' option.
    83 
    84 ==== Testing the connection ====
    85 
    86 Once the modem is connected, IP address has to be assigned to the newly created Ethernet device (in this case '''eth2'''):
    87 
    88 {{{ dhcpcd eth2 }}}
    89 
    90 The node should get an address in the 192.168.3.0/24 subnet (any existing dhcpd instance on eth2 has to be killed). Once node gets IP address, routing tables need to be set so that some of traffic through will go out over the newly established link e.g. to send all the traffic through LTE link:
    91 
    92 {{{
    93 route add default eth2
    94 }}}
    95 
    96 Once routing tables are adjusted, ICMP can be used to test connectivity with the default gateway:
    97 {{{ ping 192.168.3.1 }}}
    98 resulting in:
    99 {{{
    100 root@node1-7:~# ping 192.168.3.1
    101 PING 192.168.3.1 (192.168.3.1) 56(84) bytes of data.
    102 64 bytes from 192.168.3.1: icmp_seq=1 ttl=64 time=44.9 ms
    103 64 bytes from 192.168.3.1: icmp_seq=2 ttl=64 time=42.8 ms
    104 }}}
    105 The ping can be canceled with {{{Ctrl+C}}}. More elaborate link performance test can be done by using '''iperf''' between multiple nodes that are connected to the basestation.
    106 
    107 ==== Reconnecting the client ====
    108 
    109 Use minicom (or any other serial port program) to issue a set of AT commands to reset the connection. Commands are:
    110 
    111 {{{
    112 AT!reset
    113 }}}
    114 
    115 (NOTE: after the AT!reset command the minicom will display the popup window that the connection was lost- one has to wait for the pop-up to go away before proceeding)
    116 
    117 {{{
    118 AT!entercnd="A710"
    119 AT!dxcfg=wwan,connect,11
    120 }}}
    121 
    122 The output should look like:
    123 {{{
    124 root@node1-7:~# minicom -D /dev/ttyUSB1
    125 
    126 Welcome to minicom 2.7
    127 
    128 OPTIONS: I18n
    129 Compiled on Jan  1 2014, 17:13:19.
    130 Port /dev/ttyUSB1, 06:02:02
    131 
    132 Press CTRL-A Z for help on special keys                 
    133                                                        
    134 AT                                                       
    135 OK                                                     
    136 AT!reset                                               
    137 OK
    138 AT!entercnd="A710"
    139 OK
    140 AT!dxcfg=wwan,connect,11
    141 OK
    142 
    143 $QCRMCALL: 1, V4
    144 at!gstatus?
    145 !GSTATUS: gets the IP address, de
    146 Current Time:  58               Temperature: 28     
    147 Bootup Time:   6                Mode:        ONLINE         
    148 System mode:   LTE              PS state:    Attached                           
    149 LTE band:      B25              LTE bw:      10 MHz                             
    150 LTE Rx chan:   8365             LTE Tx chan: 26365                             
    151 EMM state:     Registered       Normal Service                                 
    152 RRC state:     RRC Connected                                                   
    153 IMS reg state: No Srv                                                           
    154                                                                                
    155 RSSI (dBm):    -69              Tx Power:    -33                               
    156 RSRP (dBm):    -90              TAC:         0001 (1)                           
    157 RSRQ (dB):     -5               Cell ID:     01A2D001 (27447297)               
    158 SINR (dB):     21.2                                                             
    159                                                                                
    160                                                                                
    161 OK                                                                             
    162 }}}
    163 
    164 Once connection is reset, dhcp lease needs to be renewed and new default route added again; if there is already dhcpd session it needs to be terminated:
    165 
    166 {{{
    167 root@node1-7:~# dhcpcd eth2
    168 err, eth2: dhcpcd already running on pid 2071 (/var/run/dhcpcd-eth2.pid)
    169 root@node1-7:~# kill 2071
    170 root@node1-7:~# dhcpcd eth2
    171 root@node1-7:~# dhcpcd.sh: interface eth2 has been configured with new IP=192.168.3.2
    172 
    173 root@node1-7:~# route add default eth2
    174 root@node1-7:~#
    175 }}}
     3This tutorial shows how to connect a COTS UE, to the Amarisoft eNB and EPC.
    1764
    1775
    178 === Managing the basestation ===
     6[[Include(Tutorials/g0WmLTE/Tutorial3)]]
    1797
    180 Uses rest interface to manage the BS. To set the LTE connection bandwidth to 5 MHz issue the following commands on the console (not node):
     8=== Managing the Amarisoft eNB
     9
     10The BSControl service uses a REST interface to manage the BS. To set the LTE connection bandwidth to 5 MHz, issue the following commands on the console (not node):
    18111{{{
    18212wget http://bsc03out.orbit-lab.org:5054/bscontrol/bs/1/default_cell_parameters?n_rb_dl=25     
     
    18515
    18616Setting '''n_rb_dl''' to 50 sets it to 10 MHz while setting it to 100 sets the bandwidth to 20 MHz.
    187 After basestatin restart, most of the clients need to be also reconnected.
     17After basestation restart, most of the clients need to be also reconnected.
    18818
     19In order to use a different basestation, you will need to run the following command to disable the Amarisoft eNB, and then run the appropriate commands to enable the new one.
     20{{{
     21wget http://bsc03out.orbit-lab.org:5054/bscontrol/bs/1/stop
     22}}}
     23