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