[[Include(WikiToC)]] == Spectrum visualization with Fosphor (In Progress) == === Description === This tutorial illustrates use of [https://archive.fosdem.org/2015/schedule/event/rfnocfosphor/attachments/slides/804/export/events/attachments/rfnocfosphor/slides/804/fosdem2015_rfnoc_fosphor.pdf RFNoC Fosphor block for spectrum visualization]. RFNoC Fosphor block is the FPGA accelerated version of [https://projects.osmocom.org/projects/sdr/wiki/Fosphor gr-fosphor (CPU/GPU version)]. As any other RFNoC blocks, RFNoC Fosphor can be instantiated on 3rd generation USRP devices, and can be used in conjunction with gnuradio-companion(GRC) on the host computer. This tutorial demonstrates GRC RFNoC Fosphor application on USRP-2974 in [COSMOS testbed wiki:Hardware/sdr/usrp2974]. Running a GRC application on a testbed node requires using graphical user interface(GUI) over SSH. This tutorial also illustrates use of [https://mobaxterm.mobatek.net/ MobaXterm] and jumphost to setup X forwarding for accessing GUI over SSH. === Prerequisites === In order to access the test bed, create a reservation 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 [wiki:GettingStarted getting started] page to get started. === Resources required === 1 USRP-2974 (sdr2-md1 or sdr2-s1-lg1) on COSMOS SB1. === Tutorial Setup === Follow the steps below to gain access to the [wiki:/hardware/Domains/sb1 sandbox 1 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 sandbox 1 1. [wiki:/GettingStarted#LogintoyourReservation Login] into sandbox 1 console (console.sb1.cosmos-lab.org) with an SSH session. SSH session for COSMOS SB1 with MobaXterm can be setup as shown, with remote host = console.sb1.cosmos-lab.org, and username = your COSMOS username. X11 forwarding is enabled to access GUI. [[Image(mobaxterm_sb1_session.JPG, width=600px)]] 1. Make sure all the nodes and devices used in the experiment are turned off: {{{#!shell omf tell -a offh -t sdr2-s1-lg1 }}} 1. Load rfnoc_fosphor_3_15.ndz on sdr2-s1-lg1. {{{#!shell omf load -i rfnoc_fosphor_3_15.ndz -t sdr2-s1-lg1 }}} 1. Turn the SDR on and check the status {{{#!shell omf tell -a on -t sdr2-s1-lg1 }}} {{{#!shell omf stat -t sdr2-s1-lg1 }}} 1. Log into the SDR with -Y for X11 forwarding {{{#!shell ssh root@sdr2-s1-lg1 -Y }}} ==== Configure !MobaXterm for node access ==== Another way to access the SDR is to set up a MobaXterm session directly to the SDR, with the console as the jump host. As shown in the pictures below, for the SSH session, use remote host = sdr2-s1-lg1.sb1.cosmos-lab.org username = root. Enable X11 forwarding in advanced settings. Set up jump host in network settings, with gateway host = console.sb1.cosmos-lab.org, username = your cosmos username. [[Image(nodessh.JPG, width=600px)]] [[Image(jumphost.png, width=600px)]] The following is displayed when this session runs. {{{#!shell ┌────────────────────────────────────────────────────────────────────┐ │ • MobaXterm 20.6 • │ │ (SSH client, X-server and networking tools) │ │ │ │ ➤ SSH session to root@sdr2-s1-lg1.sb1.cosmos-lab.org │ │ • SSH gateway : ✔ (myusername@console.sb1.cosmos-lab.org) │ │ • SSH compression : ✔ │ │ • SSH-browser : ✔ │ │ • X11-forwarding : ✔ (remote display is forwarded through SSH) │ │ • DISPLAY : ✔ (automatically set on remote server) │ │ │ │ ➤ For more info, ctrl+click on help or visit our website │ └────────────────────────────────────────────────────────────────────┘ Last login: Fri Dec 11 04:49:36 2020 from 10.106.0.21 root@sdr2-s1-lg1:~# }}} === Experiment Execution === ==== RFNoC Fosphor FPGA image ==== Custom USRP-2974 FPGA image /bit/rfnoc3_15_fosphor_x310.lvbitx will be used for this tutorial. To use this image with a UHD or GRC application use the fpga-path argument as shown below. {{{#!shell uhd_usrp_probe --args="resource=RIO0,fpga-path=/root/bit/rfnoc3_15_fosphor_x310.lvbitx" }}} Following are the blocks in rfnoc3_15_fosphor_x310.lvbitx {{{#!shell | | _____________________________________________________ | | / | | | RFNoC blocks on this device: | | | | | | * DmaFIFO_0 | | | * Radio_0 | | | * Radio_1 | | | * DDC_0 | | | * DUC_0 | | | * FFT_0 | | | * Window_0 | | | * FIR_0 | | | * SigGen_0 | | | * KeepOneInN_0 | | | * fosphor_0 | | | * FIFO_0 | | | * FIFO_1 }}} ==== Run rfnoc-fosphor GRC application ==== {{{#!shell gnuradio-companion /root/gr-ettus/examples/rfnoc/rfnoc_fosphor.grc }}} {{{#!shell root@sdr2-s1-lg1:~# gnuradio-companion /root/gr-ettus/examples/rfnoc/rfnoc_fosphor.grc <<< Welcome to GNU Radio Companion 3.7.14.0 >>> Block paths: /usr/local/share/gnuradio/grc/blocks Loading: "/root/gr-ettus/examples/rfnoc/rfnoc_fosphor.grc" >>> Done }}} With X11 forwarding enabled, GRC should show up as below. Set Device Arguments in the Device3 block to "resource=RIO0,fpga-path=/root/bit/rfnoc3_15_fosphor_x310.lvbitx". [[Image(rfnoc_fosphor_grc.jpg, width=800px)]] Set center frequency, bandwidth and run the application to see spectrum display. [[Image(rfnoc_fosphor_display.jpg, width=800px)]]