Building GNU Radio¶
To build and install GNU Radio, you may either download a release tarball, or you may use the git client software to check out code from our git repository. Some operating systems may have binary installation packages available; see Operating System Specific Instructions below.
To checkout the latest stable release code, go to:
To instead checkout the latest code from the development trunk, enter this on the command line:
$ git clone http://gnuradio.org/git/gnuradio.git
In general, if you are developing GNU Radio applications which need to depend on the stability of the features and API of GNU Radio components, it is recommended that you use the 3.3 stable release series.
To get a handle on what's going on, clone the repository (if you haven't already), then run "qgit" or one of the other git viewers on it. It will show you all of the branching and merging, diffs, etc.
First, ensure that you've fulfilled the dependencies specified in the top-level
Most GNU/Linux systems come with our dependencies already packaged.
You may need to install them off of your install CD/DVD or over the net.
See below for Operating System specific notes.
To compile, there are 5 steps. Start by cd'ing to the gnuradio directory, then complete the
$ ./bootstrap # Do NOT perform this step if you are building from a tarball. $ ./configure $ make $ make check $ sudo make install
This will perform all configuration checks and select for build, test, and installation all components that pass.
For finer control, read the instructions at BuildConfiguration.
Dealing with Old Build Problems¶
1) Uninstall gnuradio:
$ sudo make uninstall
2) To restore the original git files from any added files during an old build:
$ git clean -d -x -f
Then you can bootstrap, configure, make, etc.
Generating GNURadio Documentation¶
By default, gnuradio will automatically builds documentation if doxygen and xmlto programs are installed prior to installing gnuradio, so make sure they are installed in your system. Doxygen is used to build the gnuradio C++ API documentation. The generated documents can be found and browsed at docs/doxygen/html/index.html. The xmlto is used to convert the extra documentation xml files (found in usrp, gr-trellis,..etc folders) to html files.
Operating System Specific Instructions¶
This section links to guides which go into more specific detail for a given operating system, outlining how to fulfill the build prerequisites, any non-standard build steps that must be taken, and general configuration issues. If a given operating system has binary installation packages or another automated way to build GNU Radio, it will be listed here.
- Mac OS X
- NetBSD (likely also appropriate for DragonflyBSD and helpful for OpenBSD and FreeBSD)
Installation on the Play Station 3¶
Build Script for Ubuntu and Fedora¶
The majority of users of GNU Radio tend to run either Fedora or Ubuntu, this script provides an easy way to install GNU Radio and the UHD packages along with their required dependencies for these OSes. The script will work for Fedora 12-15 and Ubuntu 9.04 to 10.10. Right click and save as the following link:
Thanks to Marcus Leech for putting this together and hosting it.
USRP FPGA Firmware¶
To compile the verilog source code for the fpga firmware for the usrp you need Altera Quartus II Web Edition. This is only needed if you change the verilog code, since the distribution contains precompiled versions of this firmware.