Your First Flowgraph

From GNU Radio
Jump to navigation Jump to search

Template:TutorialNavigation

This tutorial will guide you through creating and running your first flowgraph in GNURadio. This guide assumes you have already installed GNURadio. You can find the installation instructions here: Installing GNURadio

Starting GNURadio Companion

The GNURadio Companion (GRC) is a visual editor for assembling and flowgraphs. GRC uses .grc files which are then translated into Python .py flowgraphs.

Open a terminal by pressing CTRL + ALT + T or by right-clicking on the desktop and selecting Open in Terminal:

OpenTerminal.png

In the terminal, type:

$ gnuradio-companion &

The GRC window will then appear:

NewGRCFlowgraph.png


Double click the Options block on the upper left hand corner and name your flowgraph by editing the Id and Title entries:

NameYourFlowgraph.png

The Id will be the filename of the Python flowgraph which in this case will be sineWaveFlowgraph.py. The Title entry is a description of the flowgraph. Click OK to save your changes.

Click File : Save to save your GRC Flowgraph.

GRCClickSave.png


You will then need to enter a name for your .grc file which is sineWaveGRC.grc to distinguish it from the .py flowgraph.

EnterGRCName.png

Now that the GRC file is named and saved, blocks can be added to create your first flowgraph.

Adding Blocks

GNURadio comes with a large pre-existing library of signal processing blocks. The blocks can be browsed using the arrows in the right hand column, or you may search for blocks by using CTRL+F or by selecting the magnifying glass (highlighted in red):

SearchBlockLibrary.png

Search for the Signal Source block and then drag and drop it into the GRC workspace:

SearchSignalSourceBlock.png

Now search for Throttle, QT GUI Frequency Sink and QT GUI Time Sink. Drag and drop each of the blocks into the workspace so the flowgraph looks like the following:

UnconnectedFlowgraph.png

The Signal Source block will create a complex sinusoid, QT GUI Frequency Sink will display the magnitude of the frequency spectrum of the complex sinusoid and QT GUI Time Sink will display the time domain. The Throttle block is used for flow control in the absence of radio hardware.

The blocks need to be connected. First click the output of Signal Source (highlighted in red) and then click the input to the Throttle (highlighted in orange).

MakeFirstConnection.png

You will notice that the Signal Source block text has changed from red to black. The red text shows a user that a block still has an input or output that needs to be connected before the flowgraph can be run. Now connect the throttle output to the frequency sink and time sink:

ConnectedFlowgraph.png

Running The Flowgraph

Press the Play button (highlighted in red) to run the flowgraph:

RunFlowgraphButton.png

A new window will pop-up displaying the signal in the time domain and frequency domain:

FrequencySinkTimeSink.png

Success! Your flowgraph is now running.

Opening your file browser shows that that there are two files, sineWaveGRC.grc which is a file that contains the information for the visual display of the flowgraph in GRC, and sineWaveFlowgraph.py which contains the actual Python-based flowgraph code.

GRCandPy.png

Continue onto the next tutorial which describes Variables in Flowgraphs.