This document is not meant to be a complete tutorial on GnuRadio, but to help you start to play around GnuRadio on Orbit Sandbox and to share my experiences on exploring this wonderful toy. 


== What you need to know? ==
 

Before you jump into GnuRadio on Orbit, you should have a clear picture on what GnuRadio is. An excellent starting reading material is Eric Blossom’s Exploring GNU Radio:[http://www.gnu.org/software/gnuradio/doc/exploring-gnuradio.html]. Eric is the founder of the whole GNU Radio project. Make sure you understand the data flow paths, including the receive path and the transmit path, understand the role that the USRP plays. USRP is a flexible USB device that connects the PC to the RF world. USRP has one motherboard, which connected to the PC via USB 2.0 and can support up to four daughterboard. Each daughterboard has RF ends that can either transmit or receive waveform from the air. There are different types of daughterboard supporting a variety radio range, e.g. for example, Flex400 supports both transmit and receive in the frequency band 400MHz to 500 Mhz. You need to refresh your memory on the sample theory. 

To program GnuRadio, you need to build a radio by creating a graph (as in graph theory) where the vertices are signal processing blocks and the edges represent the data flow between them. The signal processing blocks are implemented in C++. The graphs are constructed and run in Python. If you are not familiar with C++ or Python, find a tutorial online and learn it. 


== What is on Orbit Sandbox5? ==

Sandbox5 consists of two nodes, i.e. node1-1 and node1-2. Each individual node is connected to one Gnuradio motherboard, and each motherboard in turn has two BasicRX and two BasicTX mounted on it, as show in the following picture.

The frequency that the BasicTX operates on ranges from 2 MHz to 200 MHz, and the BasicRX can receive from 2 MHz to 300+ MHz. 

Since there is no way to put a matching antenna on BasicTX/BasicRX, the two BasicTX/BasicRX daughterboard are connected through two wires, which means the waveform transmitted from BasicTX to BasicRX doesn’t go through air but the two wires. For right now, the TX_B port of the BasicTX on node1-1is wired to the RX_B on the BasicRX on node1-2, and the the TX_A of the BasicTX on node1-1 is wired to the RX_B on the BasicRX mounted on node1-2. Therefore, make sure you have node1-1 as the transmitter and have node 1-2 be the receiver. 

{{{
Since there is NO sound card on each node, you cannot run the example, dial_tone.py.
}}}


== Make sandbox5 ready, step by step ==
I assume you’ve read the tutorial about Orbit, and you know how to reserve a time slot, how to log into the nodes, and how to image the nodes. (Otherwise read [wiki:HowToGetStarted Getting Started].)

To load the nodes with the right image:

 * Step 1: Login to the console
    {{{
          ssh username@ console.sb5.orbit-lab.org
    }}}
 * Step 2: image the nodes
    {{{
          imageNodes [1,1],[1,2] gnuradio.gdz
    }}}
 * Step 3: Power up node1-1 and node1-2
    {{{
          wget -O - -q 'http://cmc:5012/cmc/on?x=1&y=1'
          wget -O - -q 'http://cmc:5012/cmc/on?x=1&y=2'
    }}}
  * Step 4: Log onto the node
    {{{
          ssh root@node1-1
	  ssh root@node1-2
    }}}

  * Step 5: copy [http://www.orbit-lab.org/attachment/wiki/Documentation/GNURadio/usrp_siggen_multiple_sine.py usrp_siggen_multiple_sine.py] to node1-1 (transmitter)
 
  * Step 6: copy [http://www.orbit-lab.org/attachment/wiki/Documentation/GNURadio/usrp1_rx_cfile.py.py usrp1_rx_cfile.py] to node1-2 (receiver)

== Let’s start to run examples ==

 1. '''Receiver only''' The transmitter doesn't send any thing, only the receiver receives. In this case, what the receiver receives is white noise. 
   {{{
      ./usrp1_rx_cfile.py -f 10e3 -N21000 -g 10 rx_10k_1.dat
   }}}
    * '-f 10e3': tells the GnuRadio to listen to the frequency band 10kHz.
    * '-N21000': sample 21000 data points.
    * '-g 10': set the gain to 10.
    * 'rx_10k_1.data': set the file name that will store the data samples.


    Using the matlab script [http://www.orbit-lab.org/attachment/wiki/Documentation/GNURadio/plot_sig.m plot_sig], you can get the following figure