[[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)]] ||

The required software components used in this demo are already loaded to the {{{IBMPAAM-USRP-RT-Baseband.ndz}}} node image, the node image includes:
* Ubuntu 20.04, UHD 4.1.0
* PAAM Control to initialize the PAAM boards to integrate with USRPs. 
* Agora-UHD: An UHD-integrated real-time baseband processing pipeline. Please refer to **{{{Cubic23}}} branch** at [https://github.com/Agora-wireless/Agora/tree/Cubic23/ here] for more information.
* Real-time visualization for the real-time DSP pipeline. 

=== 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 **four** SSH sessions. 
 1. In **terminal 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. 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
    }}}


=== Experiment Execution ===
==== Find and prepare USRPs  ====
* Upon logging into the server, run eth_config.sh script. This sets up the 10G data interfaces eno1, eno2. After running the script, you should see that the data interfaces have the appropriate IP addresses assigned, as per the tables for [https://wiki.cosmos-lab.org/wiki/Architecture/Domains/cosmos_sb1#IPAddressAssignment SB1] and [https://wiki.cosmos-lab.org/wiki/Architecture/Domains/cosmos_sb2#IPAddressAssignment SB2]. 
   SB1
   {{{#!shell
root@srv1-lg1:~# ./eth_config.sh
root@srv1-lg1:~# ifconfig eno1
eno1: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 9000
        inet 10.38.1.1  netmask 255.255.0.0  broadcast 10.38.255.255
        inet6 fe80::1e34:daff:fe42:c3c  prefixlen 64  scopeid 0x20<link>
        ether 1c:34:da:42:0c:3c  txqueuelen 1000  (Ethernet)
        RX packets 712  bytes 74814 (74.8 KB)
        RX errors 0  dropped 595  overruns 0  frame 0
        TX packets 42  bytes 9132 (9.1 KB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0
root@srv1-lg1:~# ifconfig eno2
eno2: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 9000
        inet 10.39.1.1  netmask 255.255.0.0  broadcast 10.39.255.255
        inet6 fe80::1e34:daff:fe42:c3d  prefixlen 64  scopeid 0x20<link>
        ether 1c:34:da:42:0c:3d  txqueuelen 1000  (Ethernet)
        RX packets 643  bytes 51548 (51.5 KB)
        RX errors 0  dropped 599  overruns 0  frame 0
        TX packets 42  bytes 9132 (9.1 KB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0
   }}}