1 | | == GNURadio on SB3 == |
| 1 | = Working with USRP - Universal Software Radio Peripheral = |
| 2 | |
| 3 | == Description == |
| 4 | In this tutorial we'll use the 2 USRPs on Sandbox 3 to transmit and receive a single frequency over the air. The UHD (UniversalSoftwareRadioPeripheral Hardware Driver) is used to communicate with the USRPs. This driver is used standalone to configure and enable the USRP for communication. |
| 5 | |
| 6 | == Hardware / Software Resources utilized == |
| 7 | 1. Sandbox 3 - consists of two nodes (node1-1 & node1-2). Each node has a USRP2 connect via Ethernet. |
| 8 | 2. ''ubuntu-11-10-gnuradio.ndz'': disk image loaded onto nodes. This image has all the precompiled - software required to configure the USRPs and analyze recorded data. |
| 9 | 3. omf-5.2 / omf-5.3: used to image to nodes |
| 10 | 4. octave: GNU version of MATLAB |
| 11 | |
| 12 | == Set up == |
| 13 | * To get started first make a reservation on the [https://www.orbit-lab.org/schedule/ Orbit Scheduler] for using Sandbox 3 |
| 14 | |
| 15 | * After logging into sandbox 3 console, make sure both nodes are turned off |
| 16 | {{{ |
| 17 | nilanjan@console.sb3:~$ omf-5.2 tell offh all |
| 18 | }}} |
| 19 | |
| 20 | * Verify state of node before continuing. Make sure all nodes are in the POWEROFF state. |
| 21 | {{{ |
| 22 | nilanjan@console.sb3:~$ omf-5.2 stat |
| 23 | }}} |
| 24 | |
| 25 | * Image both nodes |
| 26 | {{{ |
| 27 | nilanjan@console.sb3:~$ omf-5.3 load -i ubuntu-11-10-gnuradio.ndz -t node1-1.sb3.orbit-lab.org,node1-2.sb3.orbit-lab.org |
| 28 | }}} |
| 29 | |
| 30 | * After nodes are imaged, verify that nodes are in POWEROFF state. Otherwise issue the following to turn them off for a reboot |
| 31 | {{{ |
| 32 | nilanjan@console.sb3:~$ nilanjan@console.sb3:~$ omf-5.2 tell offh all |
| 33 | }}} |
| 34 | |
| 35 | * Turn nodes back on and verify they are in POWERON state before proceeding |
| 36 | {{{ |
| 37 | nilanjan@console.sb3:~$ nilanjan@console.sb3:~$ omf-5.2 tell on all |
| 38 | }}} |
| 39 | |
| 40 | == Usage == |
| 41 | * Once nodes are imaged, ssh into each node. Use the USRP2 on node1-1 as the transmitter and USRP2 on node1-2 as receiver.[[BR]] |
| 42 | ssh into node1-1 |
| 43 | {{{ |
| 44 | nilanjan@console.sb3:~$ ssh root@node1-1 |
| 45 | root@node1-1:~# cd uhd/host/build/examples/ |
| 46 | }}} |
| 47 | |
| 48 | ssh into node1-2 |
| 49 | {{{ |
| 50 | nilanjan@console.sb3:~$ ssh root@node1-2 |
| 51 | root@node1-1:~# cd uhd/host/build/examples/ |
| 52 | }}} |
| 53 | |
| 54 | * The directory content like the following in both nodes |
| 55 | {{{ |
| 56 | root@node1-1:~/uhd/host/build/examples# ls |
| 57 | benchmark_rate latency_test rx_samples_to_file test_pps_input tx_waveforms |
| 58 | CMakeFiles Makefile rx_samples_to_udp tx_bursts |
| 59 | cmake_install.cmake network_relay rx_timed_samples tx_samples_from_file |
| 60 | CTestTestfile.cmake rx_multi_samples test_messages tx_timed_samples |
| 61 | }}} |