Building GNU Radio manually from source¶
This article assumes you are not using the build-gnuradio script which runs you through the build process automatically, and do not wish to install from a binary installation package. If you don't exactly know if this is correct for you, refer to the install guide first.
- Building GNU Radio manually from source
- I. Meet dependencies
- II. Get the source code
- III. Start the build process
- Dealing with Old Build Problems
- Generating GNURadio Documentation
- IV. Operating System Specific Instructions
- Installation on the Play Station 3
- USRP FPGA Firmware
- Current Known Build Problems
I. Meet dependencies¶
First, ensure that you've fulfilled the dependencies specified in the top-level: 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.
II. Get the source code¶
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. Please refer to the download page for pointers on where to get the code.
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.
III. Start the build process¶
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) If you got the code through git, 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 build 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.
IV. 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)
- FreeBSD
- Windows
Installation on the Play Station 3¶
- Fedora 8 (recommended)
- Fedora 7
- Fedora 6
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 pre-compiled versions of this firmware.
How to run Quartus II under Linux
Current Known Build Problems¶
Open build issues