wiki:Tutorials/Wireless/BasicUsage2

Version 2 (modified by nilanjan, 4 years ago) ( diff )

—

Site Navigation

  1. COSMOS Testbed Overview
    1. Concepts
    1. Testbed Workflow
    1. Availability and Resource Status
    1. Events and Conferences
  6. Getting Started
    1. Make an Account
    2. Create and Configure SSH Keys
    3. Make a Reservation
    4. Log in to your Reservation
    5. Control Resources with OMF
    6. Run a Hello World Experiment
    7. Get Help and Support
  7. User Guide
    1. Policies
    1. Account Creation
    1. Scheduling and Reservations
    1. Disk Images
    1. Frequently Asked Questions
    1. Resource Control with OMF
    1. Remote Access
    1. Chrome Remote Desktop Setup Page
    1. Measurement & Result Collection
    1. Storage
    1. Support
    1. Contributing to the Wiki
  20. Tutorials
    1. SDR and Wireless
    2. Optical Networking
    3. Wired Networking
    4. Edge Computing
    5. 4G/5G Systems
    6. Orchestration Platforms
  21. Architecture
    1. Data Flow
    1. Deployment Map
    1. Domains
    1. Naming Convention
    1. Networks
    1. Optical
  28. Resources, Services and APIs
    1. RF Control
    2. SDR Control
    3. Compute Control
    4. Network Control
    5. Optical Control
  29. Datasets
  30. Hardware Info
    1. Cameras
    1. Compute
    1. Network
    1. Nodes
    1. Optical
    1. RF Subsystems
    1. Antennas
    1. Full-Duplex Radio
    1. RF Front End
    1. Software Defined Radios (SDR)
  41. RF Policies & Compliance
    1. Outdoor Radio Frequency Allocation
    2. Program Experiment License
    3. Spectrum Monitoring
    4. Emergency Stop Procedures
    5. Network and Platform Security

Basic usage

Description

In this tutorial we'll demonstrate how to navigate from the COSMOS sandbox to a single SDR on a node and run an application to read samples from the SDR.

Prerequisites

In order to access the test bed, create a reservation and have it approved by the reservation service. Access to the resources are granted after the reservation is confirmed. Please follow the process shown on the COSMOS work flow page to get started.

Resources required

This tutorial can be run from sb1.cosmos-lab.org using one SDR - either a PCIe-based USRP 2974 or the network based N310.

Tutorial Setup

Follow the steps below to gain access to this console and set up your node with an appropriate image.

  1. Sign up for a ​COSMOS account.
  2. Create a resource reservation for sandbox 1.
  3. Once reservation is approved, login into the console.
  4. Use OMF commands to load baseline-uhd.ndz image on your resource. Based on the type of SDR used follow the corresponding column.

USRP2974

N310 

omf load -i baseline-uhd.ndz -t sdr2-s1-lg1

omf load -i baseline-uhd.ndz -t srv1-lg1
  1. Once the node is successfully imaged, turn it on and check the status.

USRP2974

N310 

omf tell -a on -t sdr2-s1-lg1
omf stat -t sdr2-s1-lg1

omf tell -a on -t srv1-lg1
omf stat -t srv1-lg1
  1. After giving it some time to power up and boot, ssh to the node

USRP2974

N310 

ssh root@sdr2-s1-lg1

When opening a terminal into console.sb1.cosmos-lab.org set up a tunnel from localhost:5002 to sdr2-s1-lg1.sb1.cosmos-lab.org:9002. This will be used by the web app to connect to a server running on the USRP 2974(Krypton)'s host. 

ssh root@srv1-lg1

When opening a terminal into console.sb1.cosmos-lab.org set up a tunnel from localhost:5002 to srv1-lg1.sb1.cosmos-lab.org:9002. This will be used by the web app to connect to a server running on the srv1-lg1.

Experiment Execution

Configure and detect the radio

The USRP 2974 is a PCIe based SDR while the N310 is network based. The instructions are slightly different for setting up communications to each type of SDR. Please follow the appropriate column.

USRP2974

N310

  • The USRP 2974 requires a PCIe driver to control the FPGA with the embedded PC. In the provided images, this will load automatically on boot. If it has issues, you can run it manually via 
    systemctl restart niusrprio.service

Detailed steps for driver installation and radio detection are on the Krypton usage page. There is also a trouble shooting section at the bottom on that page to update the Krypton's internal firmware if necessary.

  • Run uhd_find_devices' and check if the X310 is detected 
    uhd_find_devices --args="type=x300"
  • Use the uhd_usrp_probe command to get more details on the x300. Specifying resource=rio0 ensures only the directly connected radio is probed, instead of the radios on the network. 
    uhd_usrp_probe --args="resource=rio0,type=x300"
  • The N310 requires a network interface for control. Setting up this interface is done with the standard network tools. Detailed instructions are provided on the N310 usage page.
  • Display all the network interfaces 
    ifconfig -a
  • Configure the interface and network buffers 
    ifconfig eno1 10.115.1.1 netmask 255.255.0.0 mtu 8000
sysctl -w net.core.wmem_max=62500000
sysctl -w net.core.rmem_max=62500000
  • Run uhd_find_devices' to find all the network based SDRs 
    uhd_find_devices --args="type=n3xx"
  • Use the uhd_usrp_probe command to get more details. 
    uhd_usrp_probe --args="mgmt_addr=10.113.2.1,addr=10.115.2.1"

Configure and run the application

  • Go back to SandBox1 console, download the application source code from the attachment section below and copy it to the SDR. 
    username@console:~$ wget https://wiki.cosmos-lab.org/raw-attachment/wiki/Tutorials/Wireless/BasicUsage/spectrum_view.tar.gz
username@console:~$ scp spectrum_view.tar.gz root@sdr2-s1-lg1:~/
  • Untar the source code. 
    root@sdr2-s1-lg1:~# tar -zxvf spectrum_view.tar.gz
root@sdr2-s1-lg1:~# cd SPECTRUM_VIEW
  • Please refer to the README file in SPECTRUM_VIEW directory for instructions on compiling and running the application. Before compiling install a few required libraries. 
    root@sdr2-s1-lg1:~/SPECTRUM_VIEW# apt update
root@sdr2-s1-lg1:~/SPECTRUM_VIEW# apt-get -y install libboost-program-options-dev libboost-system-dev libboost-thread-dev libboost-filesystem-dev libboost-regex-dev liblog4cxx-dev cmake libfftw3-dev libxml2-dev libpopt-dev libsqlite3-dev pkg-config libxml2-utils gnulib
  • Now compile and make the websocket library. 
    root@sdr2-s1-lg1:~/SPECTRUM_VIEW# make websock
  • Lastly compile the application - this will generate the executable app_read_sdr_samples that reads samples from the SDR. 
    root@sdr2-s1-lg1:~/SPECTRUM_VIEW# make
  • Run the application - this will start a server that listens for commands to configure the radio and stream received spectrum samples. 
    root@sdr2-s1-lg1:~/SPECTRUM_VIEW# ./app_read_sdr_samples
. INFO  21:17:51.808 (main.cpp:649) - Starting command server at 5180
 INFO  21:17:51.808 (main.cpp:171) - Starting websock server at 9002
.....

Visualize spectrum samples

  • Download the spectrum visualizer web client to your desktop. It is all in another zip file - spectrum_view.zip. Unzip this folder and open spectrum_view.html in a Chrome browser.

When the viewer is first opened, the page display should be similar to the following

USRP2974

N310

  • Set the localhost field to localhost:5002. (Recall from the set up section to create a tunnel from localhost:5002 to sdr2-s1-lg1.sb1.cosmos-lab.org:9002 since the app_read_sdr_samples application has a websock server listening on that address:port.)

Set the device type field to type=x300.

  • Set the localhost field to localhost:5002. (Recall from the set up section to create a tunnel from localhost:5002 to srv1-lg1.sb1.cosmos-lab.org:9002 since the app_read_sdr_samples application has a websock server listening on that address:port.)

Set the device type field to type=n3xx.

Click the connect button once and a "Websocket Connection" statement should be output by the application.

Now click on make to create a device handle.

The RF radio parameters are already populated with default values for 2.4 GHz WIFI band. To view other active spectrum bands change the RATE, FREQ, GAIN fields.

RF Parameter value description
RATE 25e6 Sampling rate
FREQ 2400e6 Center frequency
GAIN 30 Receive gain

Then click on Submit to update the SDR.

Click on the Halted button to begin streaming samples from the radio to the browser. The button should change to Running'. This should display the spectrum if all went well.

Troubleshooting

Note: See TracWiki for help on using the wiki.