GNU Radio

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:

http://gnuradio.org/releases/gnuradio

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.2 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
http://gnuradio.org/redmine/repositories/changes/gnuradio/README.
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
following commands:

$ ./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.

Problems with configure¶

Some modules that I need will not be built¶

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.

• Linux
  • Arch
  • Debian
  • Fedora
  • Gentoo
  • Mandriva
  • SuSE
  • Ubuntu
• Mac OS X
• NetBSD (likely also appropriate for DragonflyBSD and helpful for OpenBSD and FreeBSD)
• Windows

Installation on the Play Station 3¶

• Linux
  • Fedora 7
  • Fedora 8 (recommended)

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.

How to run Quartus II under Linux

Current Known Build Problems¶

Open build issues