= IBM 28GHz PAAM Basics =

=== Description ===

In this tutorial, we demonstrate the basic use of the IBM 28GHz phased array antenna modules (PAAMs) with USRP N310 software-defined radios (SDRs) in the [https://wiki.cosmos-lab.org/wiki/Architecture/Domains/cosmos_sb2 COSMOS Sandbox2 (sb2)].

Author: Tingjun Chen, Duke University / Columbia University (tingjun.chen [at] duke [dot] edu)

Last updated: Apr. 11, 2021

=== Prerequisites ===

In order to access sb2, create a reservation in sb2 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 getting [https://wiki.cosmos-lab.org/wiki/GettingStarted started page] to get started.

=== Resources Required ===

* 2 USRP N310 SDRs ({{{sdr1-s1-lg1}}} and {{{sdr1-md1}}})
* 2 IBM 28GHz PAAMs ({{{rfdev2-1}}} and {{{rfdev2-2}}})
* 1 Server ({{{srv1-lg1}}})

=== Tutorial Setup ===

Follow the steps below to gain access to the sb2 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 COSMOS sb2
 1. [Documentation/Short/Login Login] into sb2 console ({{{console.sb2.cosmos-lab.org}}}) with two SSH sessions. 
 1. Make sure all the nodes and devices used in the experiment are turned off:
{{{#!shell
omf tell -a offh -t sdr1-s1-lg1,sdr1-md1,rfdev2-1,rfdev2-2,srv1-lg1
}}}
 1. Use the {{{baseline-28ghz-paam.ndz}}} node image with Ubuntu 18.04, UHD 3.15, gnuradio 3.8, and the IBM 28GHz PAAM API. Load {{{baseline-28ghz-paam.ndz}}} on the server.  
{{{#!shell
omf load -i baseline-28ghz-paam.ndz -t srv1-lg1
}}}
 1. Turn all the required resources on and check the status of all resources
{{{#!shell
omf tell -a on -t sdr1-s1-lg1,sdr1-md1,rfdev2-1,rfdev2-2,srv1-lg1
}}}
{{{#!shell
omf stat -t system:topo:allres
}}}
 1. {{{ssh}}} to the the same server from two terminals, use option -Y for using GUI.
{{{#!shell
[Terminal 1] ssh -Y root@srv1-lg1
}}}