[[Include(WikiToC)]]

= IBM 28GHz PAAM: Integration with USRPs with MIMO capability  =

=== Description ===
In this tutorial, we demonstrate the integration of IBM 28GHz PAAM boars with USRPs. We present the MIMO capability with real-time baseband processing using the system.

* The instructions for the RENEW Platform Agora software can be found [https://github.com/Agora-wireless/Agora/tree/develop here] under [https://docs.renew-wireless.org/license/ RENEW license].
* The COSMOS team contributes to adding the UHD support for the Agora software under the [https://github.com/EttusResearch/uhd/blob/master/LICENSE.md UHD license]. We thank the RENEW team for their support and help throughout the process.

Authors: \\
Zhenzhou (Tom) Qi, Duke University <zhenzhou.qi[at]duke[dot]edu> \\
Tingjun Chen, Duke University <tingjun.chen[at]duke[dot]edu>

Last updated: July 5, 2023

=== Prerequisites ===

In order to access COSMOS-SB2, create a reservation in COSMOS testbed 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}}} in SB2)
* 2 IBM 28GHz PAAMs ({{{rfdev2-1}}} and {{{rfdev2-2}}} in SB2 )
* 1 Server ({{{srv1-lg1}}})

The current hardware connection in SB2 as shown below
* {{{sdr1-s1-lg1}}} RF2 TX/RX -- {{{rfdev2-1}}} IC0/TX/H, {{{sdr1-s1-lg1}}} RF2 RX2 -- {{{rfdev2-1}}} IC1/RX/H
* {{{sdr1-s1-lg1}}} RF3 TX/RX -- {{{rfdev2-1}}} IC0/TX/V, {{{sdr1-s1-lg1}}} RF3 RX2 -- {{{rfdev2-1}}} IC1/RX/V
* {{{sdr1-md1}}} RF2 TX/RX -- {{{rfdev2-2}}} IC0/TX/H, {{{sdr1-md1}}} RF2 RX2 -- {{{rfdev2-2}}} IC1/RX/H
* {{{sdr1-md1}}} RF3 TX/RX -- {{{rfdev2-2}}} IC0/TX/V, {{{sdr1-md1}}} RF2 RX2 -- {{{rfdev2-2}}} IC1/RX/V

|| [[Image(PAAM-2_2 .png, 600px)]] ||


=== Tutorial Setup ===

Follow the steps below to gain access to the sandbox 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 sandbox console {{{console.sb2.cosmos-lab.org}}}) with one SSH sessions. 
 1. Make sure all the nodes and devices used in the experiment are turned off. Use the following command for SB2
    {{{#!shell
    omf tell -a offh -t sdr1-s1-lg1,sdr1-md1,rfdev2-1,rfdev2-2,srv1-lg1
    }}}
 1. Use the {{{IBMPAAM-USRP-RT-Baseband.ndz}}} node image with Ubuntu 20.04, UHD 4.1.0. Load {{{IBMPAAM-USRP-RT-Baseband.ndz}}} on the server.  
    {{{#!shell
    omf load -i IBMPAAM-USRP-RT-Baseband.ndz -t srv1-lg1
    }}}
 1. Turn all the required resources on and check the status of all the resources. Use the following commands for SB2.
    {{{#!shell
    omf tell -a on -t sdr1-s1-lg1,sdr1-md1,rfdev2-1,rfdev2-2,srv1-lg1
    }}}
    {{{#!shell
    omf stat -t all
    }}}
 1. {{{ssh}}} to the server with option -Y for using GUI for our live demo. 
    {{{#!shell
    ssh -Y root@srv1-lg1
    }}}