Changes between Version 3 and Version 4 of Tutorials/4G5G/amarisoftcotsue


Ignore:
Timestamp:
Nov 15, 2022, 4:40:08 PM (18 months ago)
Author:
prasanthi
Comment:

—

Legend:

Unmodified
Added
Removed
Modified

  • Tutorials/4G5G/amarisoftcotsue

    v3 v4  
    99Amarisoft provides software based gNB, 5GCore (eNB,EPC), and UE simulator that run on commodity off-the-shelf devices. A typical software-based cellular basestation/UE consists of a host PC and an SDR, where host PC is used for processing the baseband signals sent to and received from the SDR. Amarisoft supports various SDRs including USRPs such as N310, X310.
    1010In this tutorial, we run 5GCore, gNB(SA) on a host server+USRP N310 in COSMOS SB1. The UEs used in this experiment are
     11
    11121)SIMCOM SIM8200EA-M2 USB modem on sdr1-in3.sb1.cosmos
     13
    12142)OnePlus8T KB2005 phone (remotely accessible on srv1-in3.sb1.cosmos)
    1315
    … …  
    1719
    1820=== Resources required ===
    19 2 servers, 1 USRP N310s
     211 server, 1 USRP N310 for the base station and sdr1-in3 or srv1-in3 to access the UE.
    2022in [https://wiki.cosmos-lab.org/wiki/Architecture/Domains/cosmos_sb1 COSMOS SB1] domain
    2123
    … …  
    2527 1. If you don't have one already, sign up for a [https://www.cosmos-lab.org/portal-2/ COSMOS account]
    2628 1. [wiki:/GettingStarted#MakeaReservation Create a resource reservation] on sandbox 1
    27  1. [wiki:/GettingStarted#LogintoyourReservation Login] into sandbox 1 console (console.sb1.cosmos-lab.org) with two SSH sessions.
     29 1. [wiki:/GettingStarted#LogintoyourReservation Login] into sandbox 1 console (console.sb1.cosmos-lab.org).
    2830 1. Make sure all the resources in the domain are turned off:
    2931{{{#!shell
    3032omf tell -a offh -t system:topo:allres 
    3133}}}
    32  In this tutorial, for the Amarisoft base station we will be using the SB1 server srv2-lg1, and the USRP N310 sdr1-md1.
     34 In this tutorial, for the Amarisoft base station we will be using the SB1 server srv2-lg1, and the USRP N310 sdr1-s1-lg1.
    3335 1. Load amarisoft-tutorial-cosmos.ndz on srv2-lg1. 
    3436{{{#!shell
    35 omf load -i amarisoft-tutorial-cosmos.ndz -t srv1-lg1,srv2-lg1
     37omf load -i amarisoft-tutorial-cosmos.ndz -t srv2-lg1
     38}}}
     39 1. To access the UE, Waveshare SIM8200 USB modem connected to sdr1-in3, load the image waveshare-sim8200.ndz on sdr1-in3. This image has the SIMCOM network drivers installed to control the modem.
     40{{{#!shell
     41omf load -i waveshare-sim8200.ndz -t sdr1-in3
     42}}}
     43 1. To access the phones connected to srv1-in3, load the image vysor-cosmos.ndz on srv1-in3. This image has [Vysor https://www.vysor.io/] and chrome remote desktop client installed in order to provide remote access to the phones.
     44{{{#!shell
     45omf load -i vysor-cosmos.ndz -t srv1-in3
    3646}}}
    3747 1. Turn all the required resources on and check the status
    3848{{{#!shell
    39 omf tell -a on -t srv1-lg1,srv2-lg1,sdr1-md1,sdr1-s1-lg1
     49omf tell -a on -t srv2-lg1,sdr1-s1-lg1,sdr1-in3,srv1-in3
    4050}}}
    4151{{{#!shell
    4252omf stat -t system:topo:allres
    4353}}}
    44  1. ssh to the nodes, use option -Y for using GUI.
    45 
    4654
    4755=== Tutorial Execution ===
    48 [[CollapsibleStart(Check the USRPs)]]
    49 * Upon logging into the nodes, run eth_config.sh script on both the nodes. This sets up the 10G data interfaces DATA1, DATA2. After running the script, you should see that the data interfaces have the appropriate IP addresses assigned, as per this [https://wiki.cosmos-lab.org/wiki/Architecture/Domains/cosmos_sb1#IPAddressAssignment table]. The nodes should then be able to access the USRP N310s sdr1-s1-lg1 and sdr1-md1 which can be checked by running uhd_find_devices.
     56[[CollapsibleStart(Check the USRP)]]
     57* Log in to the server srv2-lg1 with 2 SSH sessions.
     58{{{#!shell
     59ssh root@srv2-lg1
     60}}}
     61* Upon logging into the server, run eth_config.sh. This sets up the 10G data interfaces DATA1, DATA2. After running the script, you should see that the data interfaces have the appropriate IP addresses assigned, as per this [https://wiki.cosmos-lab.org/wiki/Architecture/Domains/cosmos_sb1#IPAddressAssignment table]. The server should then be able to access the USRP N310 sdr1-md1 which can be checked by running uhd_find_devices.
    5062
    5163{{{#!td
    5264   {{{#!shell
    53 root@srv1-lg1:~# ./eth_config.sh
     65root@srv2-lg1:~# ./eth_config.sh
    5466   }}}
    5567
    5668   {{{#!shell
    57 root@srv1-lg1:~# ifconfig DATA1
     69root@srv2-lg1:~# ifconfig DATA1
    5870DATA1: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 9000
    59         inet 10.38.1.1  netmask 255.255.0.0  broadcast 10.38.255.255
    60         inet6 fe80::1e34:daff:fe42:c3c  prefixlen 64  scopeid 0x20<link>
    61         ether 1c:34:da:42:0c:3c  txqueuelen 1000  (Ethernet)
    62         RX packets 61195963  bytes 199994153268 (199.9 GB)
    63         RX errors 0  dropped 6680  overruns 0  frame 0
    64         TX packets 58734853  bytes 190912589303 (190.9 GB)
     71        inet 10.38.1.2  netmask 255.255.0.0  broadcast 10.38.255.255
     72        inet6 fe80::ba59:9fff:fedd:bd94  prefixlen 64  scopeid 0x20<link>
     73        ether b8:59:9f:dd:bd:94  txqueuelen 1000  (Ethernet)
     74        RX packets 2764979088  bytes 8198039666643 (8.1 TB)
     75        RX errors 0  dropped 295845  overruns 0  frame 0
     76        TX packets 3653147129  bytes 11884176775843 (11.8 TB)
    6577        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0
    6678
    67 
    68 root@srv1-lg1:~# ifconfig DATA2
     79root@srv2-lg1:~# ifconfig DATA2
    6980DATA2: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 9000
    70         inet 10.39.1.1  netmask 255.255.0.0  broadcast 10.39.255.255
    71         inet6 fe80::1e34:daff:fe42:c3d  prefixlen 64  scopeid 0x20<link>
    72         ether 1c:34:da:42:0c:3d  txqueuelen 1000  (Ethernet)
    73         RX packets 7378  bytes 651944 (651.9 KB)
    74         RX errors 0  dropped 6682  overruns 0  frame 0
    75         TX packets 282  bytes 82239 (82.2 KB)
     81        inet 10.39.1.2  netmask 255.255.0.0  broadcast 10.39.255.255
     82        inet6 fe80::ba59:9fff:fedd:bd95  prefixlen 64  scopeid 0x20<link>
     83        ether b8:59:9f:dd:bd:95  txqueuelen 1000  (Ethernet)
     84        RX packets 334886  bytes 31982544 (31.9 MB)
     85        RX errors 0  dropped 295867  overruns 0  frame 0
     86        TX packets 10148  bytes 3378247 (3.3 MB)
    7687        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0
    77 
    7888   }}}
    7989}}}
    8090{{{#!td
    8191   {{{#!shell
    82 root@srv1-lg1:~# uhd_find_devices
     92root@srv2-lg1:~# uhd_find_devices
    8393[INFO] [UHD] linux; GNU C++ version 7.5.0; Boost_106501; UHD_3.15.0.0-release
    8494--------------------------------------------------
    … …  
    94104    product: n310
    95105    type: n3xx
    96 --------------------------------------------------
    97 -- UHD Device 1
    98 --------------------------------------------------
    99 Device Address:
    100     serial: 3196937
    101     addr: 10.38.3.1
    102     claimed: False
    103     mgmt_addr: 10.37.3.1
    104     mgmt_addr: 10.38.3.1
    105     mgmt_addr: 10.39.3.1
    106     product: n310
    107     type: n3xx
    108 
    109106   }}}
    110107}}}
     108* Notice the IP addresses of the N310 - 10.37.2.1 is the 1G management interface, where as the other 2 are 10G data interfaces.
    111109[[CollapsibleEnd]]
    112110
    113111[[CollapsibleStart(Run MME)]]
    114 * We are going to run the MME, gNodeB on srv1-lg1 and the UE simulator on srv2-lg1.
    115 * Run the Amarisoft MME on srv1-lg1. Run lte_init.sh to setup IP forwarding so that the UEs can connect to the Internet, once they establish a connection with the base station. 
     112* We are going to run the MME, gNodeB on srv2-lg1.
     113* Run the Amarisoft MME on srv2-lg1. Run lte_init.sh to setup IP forwarding so that the UEs can connect to the Internet, once they establish a connection with the base station. 
    116114  This network uses PLMN 310014 (USA Test network) as configured in mme.cfg.
    117115{{{#!shell
    118 root@srv1-lg1:~# cd /opt/amarisoft/ltemme-linux-2021-09-18
    119 root@srv1-lg1:/opt/amarisoft/ltemme-linux-2021-09-18# ./lte_init.sh
     116root@srv2-lg1:~# cd /opt/amarisoft/ltemme-linux-2022-09-16
     117root@srv2-lg1:/opt/amarisoft/ltemme-linux-2022-09-16# ./lte_init.sh
    120118Select CTRL default interface
    121 root@srv1-lg1:/opt/amarisoft/ltemme-linux-2021-09-18# ./ltemme config/mme.cfg
    122 Core version 2021-09-18, Copyright (C) 2012-2021 Amarisoft
     119Configure NAT for CTRL
     120net.ipv4.tcp_congestion_control = bbr
     121net.core.rmem_max = 50000000
     122net.core.wmem_max = 5000000
     123root@srv2-lg1:/opt/amarisoft/ltemme-linux-2022-09-16# ./ltemme config/mme.cfg
     124Core version 2022-09-16, Copyright (C) 2012-2022 Amarisoft
    123125This software is licensed to Rutgers University (The State University of New Jersey).
    124126License server: license.orbit-lab.org (0b-b4-46-dc-2f-83-58-cb)
    125 Support and software update available until 2022-08-18.
     127Support and software update available until 2023-08-18.
    126128
    127129(mme)
    128 
    129130}}}
    130131* Type 'help' at the prompt to explore the available mme commands.
    131132[[CollapsibleEnd]]
    132133
    133 [[CollapsibleStart(Run eNodeB/gNodeB)]]
    134 * Run Amarisoft 5G NR Stand alone gNodeB as shown below by passing the gNodeB configuration file as an argument. The configuration file defines SDR(USRP N310) address, operating band, bandwidth and other parameters. To run 4G LTE eNodeB, please use enb-n310.cfg
     134[[CollapsibleStart(Run gNodeB)]]
     135* Run Amarisoft 5G NR Stand alone gNodeB as shown below by passing the gNodeB configuration file as an argument. The configuration file defines SDR(USRP N310) address, operating band, bandwidth and other parameters.
    135136{{{#!shell
    136137root@srv1-lg1:~# cd /opt/amarisoft/lteenb-linux-2021-09-18