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