[[Include(WikiToC)]]

== Getting Started with COSMOS SDR Resources ==

=== Description ===
In this tutorial we'll demonstrate how to run a basic wireless experiment using software defined radios in the COSMOS testbed. Two COSMOS nodes will be used: one to transmit a signal, and the other to receive it.

=== Prerequisites ===
All tutorials on the COSMOS wiki assume that you have already created a user account through [https://www.orbit-lab.org/userManagement/register the new user registration form].

In order to access the test bed, create a reservation on [https://wiki.cosmos-lab.org/cPanel/controlPanel/start the online scheduler] and have it approved by the reservation service. Access to the resources are granted after the reservation is confirmed. Please see the page describing [wiki:CosmosOverview/Workflow the COSMOS work flow page] for more information. 

=== Resources required ===
For this example we used two USRP 2974 SDRs on [wiki:Architecture/Domains/cosmos_sb1 sandbox 1]. These SDRs have an onboard SOM with an i7 processor, which is the device you're loading the orbit image onto and connecting to over ssh. They also have an fpga connected to the four antennas. We won't have to worry about the specifics of the USRP for this tutorial but you can look at the links on [https://www.ettus.com/all-products/usrp-2974/ this page] for more information. 

=== Tutorial Setup ===
 Follow the steps below to gain access to this console and set up your node with an appropriate image. 
 1. [GettingStarted#MakeaReservation Create a resource reservation] for sandbox 1.
 2. Once reservation is approved, [wiki:GettingStarted#LogintoyourReservation login into the console] using ssh. Since you are using sandbox 1, you will ssh to 
 {{{#!shell
 YOUR_USERNAME@console.sb1.cosmos-lab.org
 }}}
 3. Use OMF commands to [GettingStarted#ControlResourceswithOMF load the baseline-uhd.sdr image] on your resources.
 {{{#!shell
 omf load -i baseline-uhd.ndz -t sdr2-s1-lg1,sdr2-md1
 }}}
 1. Once the nodes are successfully imaged, turn them on and check the status
 {{{#!shell
 omf tell -a on -t sdr2-s1-lg1,sdr2-md1
 }}}
 {{{#!shell
 omf stat -t sdr2-s1-lg1,sdr2-md1
 }}}
 1. After waiting for the nodes to power up and boot, you will be able to ssh to them from the console: 
 {{{#!shell
 ssh root@sdr2-s1-lg1
 }}}
 NOTE: for some nodes, such as the server machines, it can take several minutes for a node to finish the booting process. This is normal, and you'll have to wait until the nodes is fully booted before you can ssh to it.
 1. Once you have an ssh session on either machine, you can verify that it is the proper type of node by looking at the output of lshw:
 [[Image(lshw.png)]]