[[Include(WikiToC)]] == GNURadio CFO Estimation tutorial == === Description === This tutorial illustrates the use of GNURadio flowgraphs to estimate the Carrier Frequency offset between a pair of USRPs in COSMOS, ORBIT testbeds. === 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 === 2 USRPs in COSMOS or ORBIT testbed, 2 host nodes, and 2 mmWave devices(if using mmWave) are required. This page uses the 28GHz IBM mmWave devices in [https://wiki.cosmos-lab.org/wiki/Architecture/Domains/cosmos_sb1 sb1.cosmos-lab.org]. As shown in the [https://wiki.cosmos-lab.org/wiki/Tutorials/Wireless/mmwavePaamBasics basic tutorial for IBM 28GHz devices], the current connections in SB1 are as shown in this [https://wiki.cosmos-lab.org/wiki/Architecture/Domains/cosmos_sb1#RFPathConfigurationsformmWaveDevelopmentPlatforms diagram] * {{{sdr1-in1}}} RF2 TX/RX -- {{{rfdev4-in1}}} all ICs/TX/H, {{{sdr1-in1}}} RF2 RX2 -- {{{rfdev4-in1}}} all ICs/RX/H * {{{sdr1-in1}}} RF3 TX/RX -- {{{rfdev4-in1}}} all ICs/TX/V, {{{sdr1-in1}}} RF3 RX2 -- {{{rfdev4-in1}}} all ICs/RX/V * {{{sdr1-in2}}} RF2 TX/RX -- {{{rfdev4-in2}}} all ICs/TX/H, {{{sdr1-in2}}} RF2 RX2 -- {{{rfdev4-in2}}} all ICs/RX/H * {{{sdr1-in2}}} RF3 TX/RX -- {{{rfdev4-in2}}} all ICs/TX/V, {{{sdr1-in2}}} RF2 RX2 -- {{{rfdev4-in2}}} all ICs/RX/V Hence, the resources required to execute this tutorial are rfdev4-in1, rfdev4-in2 (IBM PAAMs), sdr1-in1, sdr1-in2 (USRP N310s), srv1-lg1, srv2-lg1 in sb1.cosmos-lab.org. === 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 SB1 1. [Documentation/Short/Login Login] into sandbox console ({{{console.sb1.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-in1,sdr1-in2,rfdev4-in1,rfdev4-in2,srv1-lg1,srv2-lg1 }}} 1. Use the {{{gnuradio_ofdm.ndz}}} node image with Ubuntu 20.04, UHD 4.4, gnuradio 3.9, and a grc example used in this tutorial. Load {{{gnuradio_ofdm.ndz}}} on the servers. {{{#!shell omf load -i gnuradio_ofdm.ndz -t srv1-lg1,srv2-lg1 }}} 1. Turn all the required resources on and check the status of all the resources. Use the following commands . {{{#!shell omf tell -a on -t sdr1-in1,sdr1-in2,rfdev4-in1,rfdev4-in2,srv1-lg1,srv2-lg1 }}} {{{#!shell omf stat -t all }}} 1. {{{ssh}}} to the servers with option -Y for using GUI with gnuradio. {{{#!shell ssh -Y root@srv1-lg1 }}} {{{#!shell ssh -Y root@srv2-lg1 }}} === Experiment Execution === ==== Find and prepare USRPs ==== * Upon logging into the servers, run eth_config_sb1.sh script on each of the servers. This sets up the 10G data interfaces DATA1, DATA2. After running the script, you should see that the data interfaces have the appropriate IP addresses assigned, as per the table for [https://wiki.cosmos-lab.org/wiki/Architecture/Domains/cosmos_sb1#IPAddressAssignment SB1]. {{{#!shell root@srv1-lg1:~# ./eth_config_sb1.sh root@srv1-lg1:~# ip addr 2: DATA1: mtu 9000 qdisc mq state UP group default qlen 1000 link/ether 1c:34:da:42:0c:3c brd ff:ff:ff:ff:ff:ff inet 10.38.1.1/16 scope global DATA1 valid_lft forever preferred_lft forever inet6 fe80::1e34:daff:fe42:c3c/64 scope link valid_lft forever preferred_lft forever 3: DATA2: mtu 9000 qdisc mq state UP group default qlen 1000 link/ether 1c:34:da:42:0c:3d brd ff:ff:ff:ff:ff:ff inet 10.39.1.1/16 scope global DATA2 valid_lft forever preferred_lft forever inet6 fe80::1e34:daff:fe42:c3d/64 scope link valid_lft forever preferred_lft forever }}} * Run {{{und_find_devices}}} to make sure that both USRP N310s can be reached from both the servers: {{{#!shell root@srv1-lg1:~# uhd_find_devices [INFO] [UHD] linux; GNU C++ version 9.4.0; Boost_107100; UHD_4.4.0.0-0ubuntu1~focal1 -------------------------------------------------- -- UHD Device 0 -------------------------------------------------- Device Address: serial: 3176DEB addr: 10.39.6.1 claimed: False fpga: XG mgmt_addr: 10.37.6.1 mgmt_addr: 10.38.6.1 mgmt_addr: 10.39.6.1 name: ni-n3xx-3176DEB product: n310 type: n3xx -------------------------------------------------- -- UHD Device 2 -------------------------------------------------- Device Address: serial: 3176DFA addr: 10.39.6.2 claimed: False fpga: HG mgmt_addr: 10.37.6.2 mgmt_addr: 10.39.6.2 name: ni-n3xx-3176DFA product: n310 type: n3xx }}} ==== Configure IBM 28GHz PAAM ==== COSMOS uses a RESTful [https://wiki.cosmos-lab.org/wiki/Resources/Services/ArrayMgmt service for IBM PAAM management] The service can be used for * Dynamic array management - where the user connects to the antenna using {{{connect}}} command, dynamically steers the antenna during the experiment using {{{steer}}} command, and disconnects once the experiment is done. * Static array management - where the user can connect, steer and disconnect using a single command, {{{configure}}} Details and examples for the above are provided at the [https://wiki.cosmos-lab.org/wiki/Resources/Services/ArrayMgmt array management page]. For this experiment, we use static array management commands as shown below. First, start PAAM #1 (rfdev4-in1) in TX mode with H-polarization using 16 antenna elements on all the ICs, and configure the TX beamforming direction to be in the broadside (0,0). Check the current consumption on 2v7_0,1,2,3 to make sure all the ICs have been successfully initialized. {{{#!shell root@console:~# curl "http://am1.orbit-lab.org:5054/array_mgmt/configure?dev_name=rfdev4-in1.sb1.cosmos-lab.org&ics=all&num_elements=16&txrx=tx&pol=h&theta=0&phi=0" }}} {{{#!shell }}} Similarly, start PAAM #2 (rfdev4-in2) in RX mode with H-polarization using 16 antenna elements on all the ICs, and configure the RX beamforming direction to be in the broadside (0,0). Check the current consumption to make sure the ICs have been successfully initialized. {{{#!shell root@console:~# curl "http://am1.orbit-lab.org:5054/array_mgmt/configure?dev_name=rfdev4-in2.sb1.cosmos-lab.org&ics=all&num_elements=16&txrx=rx&pol=h&theta=0&phi=0" }}} {{{#!shell }}} ==== Run the experiment ==== * Transmit an OFDM waveform from sdr1-in1+rfdev4-in1 by running the flowgraph TX_OFDM.grc on srv1-lg1. Launch gnuradio-companion on srv1-lg1 {{{#!shell root@srv1-lg1:~# cd GNURadioOFDMExample/ root@srv1-lg1:~/GNURadioOFDMExample# gnuradio-companion TX_OFDM.grc }}} * Please make sure the USRP sink (TX) in TX_OFDM.grc is configured with sdr1-in1 ("addr=10.39.6.1"). Set the carrier frequency to 3GHz (3e9) and the subdev to be "B:0" (RF3). In this flowgraph, the sampling rate is set to 62.5 MSPS and the number of OFDM subcarriers set to 64. So the maximum CFO that can be detected is 62.5/(2*64) = 0.488 MHz. || [[Image(usrp_sink_tx_ofdm.PNG, 400px)]] || * Receive the OFDM waveform on sdr1-in2+rfdev4-in2 by running the flowgraph RX_OFDM_CFO_estimation.grc on srv2-lg1. Launch gnuradio-companion on srv1-lg1 {{{#!shell root@srv2-lg1:~# cd GNURadioOFDMExample/ root@srv2-lg1:~/GNURadioOFDMExample# gnuradio-companion RX_OFDM_CFO_estimation.grc }}} * Please make sure the USRP source (RX) in RX_OFDM_CFO_estimation.grc is configured with sdr1-in2("addr=10.39.6.2"). Set the carrier frequency to 3GHz (3e9) and the subdev to be "B:0" (RF3). || [[Image(usrp_source_rx_ofdm.PNG, 400px)]] || * Start both the flowgraphs to see receive IQ samples and per packet estimated CFO value at the receiver. || [[Image(RX_OFDM_CFO_capture.PNG, 600px)]] ||