[[Include(WikiToC)]]

== Amarisoft 4G/5G SDR System ==



=== Description ===
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.
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.
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.

=== Prerequisites ===
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. 

=== Resources required ===
2 servers, 2 USRP N310s 
in [https://wiki.cosmos-lab.org/wiki/Architecture/Domains/cosmos_sb1 COSMOS SB1] domain

=== Tutorial Setup ===

Follow the steps below to gain access to the [wiki:/Architecture/Domains/cosmos_sb1 sandbox 1 console] and set up nodes with appropriate images. 
 1. If you don't have one already, sign up for a [https://www.cosmos-lab.org/portal-2/ COSMOS account]
 1. [wiki:/GettingStarted#MakeaReservation Create a resource reservation] on sandbox 1
 1. [wiki:/GettingStarted#LogintoyourReservation Login] into sandbox 1 console (console.sb1.cosmos-lab.org) with two SSH sessions. 
 1. Make sure all the resources in the domain are turned off:
{{{#!shell
omf tell -a offh -t system:topo:allres  
}}}
 For this tutorial we will be using the SB1 servers, srv1-lg1, srv2-lg1 and USRP N310s, sdr1-md1, sdr1-s1-lg1
 1. Load amarisoft-tutorial-cosmos.ndz on srv1-lg1,srv2-lg1.  
{{{#!shell
omf load -i amarisoft-tutorial-cosmos.ndz -t srv1-lg1,srv2-lg1
}}}
 1. Turn all the required resources on and check the status
{{{#!shell
omf tell -a on -t srv1-lg1,srv2-lg1,sdr1-md1,sdr1-s1-lg1
}}}
{{{#!shell
omf stat -t system:topo:allres
}}}
 1. ssh to the nodes, use option -Y for using GUI.