|  | 1 | [[Include(WikiToC)]] | 
          
            |  | 2 |  | 
          
            |  | 3 | == Amarisoft 4G/5G SDR System == | 
          
            |  | 4 |  | 
          
            |  | 5 |  | 
          
            |  | 6 |  | 
          
            |  | 7 | === Description === | 
          
            |  | 8 | This tutorial contains instructions for running the [https://www.amarisoft.com/ amarisoft] 5G NR base station and UE simulator on USRP N310s in COSMOS SB1. | 
          
            |  | 9 | Amarisoft provides software based gNB, 5GCore (eNB,EPC) that run on commodity off-the-shelf devices. The software generates and sends baseband signals to the RF front-end for digital to analog conversion. Various RF front-ends are supported, including USRP N310, USRP X310. | 
          
            |  | 10 | In this tutorial, we run 5GCore, gNB on a server+USRP N310, and the UE simulator on another server+USRP N310 in COSMOS SB1, in stand-alone (SA) mode. The UE simulator can simulate one or more UEs, enabling experiments with large number of users connected to a base station. | 
          
            |  | 11 |  | 
          
            |  | 12 | === Prerequisites === | 
          
            |  | 13 | In order to access the test bed, create a reservation and have it approved by the reservation service. Access to the resources is granted after the reservation is confirmed. Please follow the process shown on the COSMOS [wiki:GettingStarted getting started] page to get started. | 
          
            |  | 14 |  | 
          
            |  | 15 | === Resources required === | 
          
            |  | 16 | 2 servers, 2 USRP N310s | 
          
            |  | 17 | in [https://wiki.cosmos-lab.org/wiki/Architecture/Domains/cosmos_sb1 COSMOS SB1] domain | 
          
            |  | 18 |  | 
          
            |  | 19 | === Tutorial Setup === | 
          
            |  | 20 |  | 
          
            |  | 21 | Follow the steps below to gain access to the [wiki:/Architecture/Domains/cosmos_sb1 sandbox 1 console] and set up nodes with appropriate images. | 
          
            |  | 22 | 1. If you don't have one already, sign up for a [https://www.cosmos-lab.org/portal-2/ COSMOS account] | 
          
            |  | 23 | 1. [wiki:/GettingStarted#MakeaReservation Create a resource reservation] on sandbox 1 | 
          
            |  | 24 | 1. [wiki:/GettingStarted#LogintoyourReservation Login] into sandbox 1 console (console.sb1.cosmos-lab.org) with two SSH sessions. | 
          
            |  | 25 | 1. Make sure all the resources in the domain are turned off: | 
          
            |  | 26 | {{{#!shell | 
          
            |  | 27 | omf tell -a offh -t system:topo:allres | 
          
            |  | 28 | }}} | 
          
            |  | 29 | For this tutorial we will be using the SB1 servers, srv1-lg1, srv2-lg1 and USRP N310s, sdr1-md1, sdr1-s1-lg1 | 
          
            |  | 30 | 1. Load amarisoft-tutorial-cosmos.ndz on srv1-lg1,srv2-lg1. | 
          
            |  | 31 | {{{#!shell | 
          
            |  | 32 | omf load -i amarisoft-tutorial-cosmos.ndz -t srv1-lg1,srv2-lg1 | 
          
            |  | 33 | }}} | 
          
            |  | 34 | 1. Turn all the required resources on and check the status | 
          
            |  | 35 | {{{#!shell | 
          
            |  | 36 | omf tell -a on -t srv1-lg1,srv2-lg1,sdr1-md1,sdr1-s1-lg1 | 
          
            |  | 37 | }}} | 
          
            |  | 38 | {{{#!shell | 
          
            |  | 39 | omf stat -t system:topo:allres | 
          
            |  | 40 | }}} | 
          
            |  | 41 | 1. ssh to the nodes, use option -Y for using GUI. |