Consolidated Logic wants to make the installation process as easy as possible on your Linux client. The following has been tested on an Ubuntu 14.04 installation. This guide will get you up and running with GNU Radio, GNU Radio Companion, and and the publically available RFNoC signal processing component library.

A script that performs all of the following steps can be found here. Alternatively, you can follow the step-by-step procedure:

First, you will need a few Linux packages. If you are using the apt package manager, use the following command:

    sudo apt-get install build-essential git vim python-pip libusb-dev libftdi-dev

After installing pip, get the python dependencies:

    sudo pip install paramiko scp sh

This installation uses GNU Radio’s Pybombs utility. Pybombs is a tool that makes installing GNU Radio and GNU Radio add-ons (called Out-Of-Tree modules) easy and streamlined. Pybombs does this by using recipe files that contain the dependencies of a given O-o-T module or GNU Radio itself.

You can either download Pybombs here, or you can clone pybombs:

    git clone --recursive

Before begining the installation process, you will need to download Consolidated Logic custom recipes. They are available here:

Alternatively, you can get these recipes by:

    cd pybombs/recipes/
    rm uhd.lwr gr-ettus.lwr gr-rda.lwr xc3sprog.lwr rda-cc-apps.lwr

To use Pybombs, go to your Pybombs root folder {Pybombs Path}/pybombs/ and run:

    ./pybombs install gr-rda
      ./pybombs install rda-cc-apps Component Creation Applications

    This will take some time. Pybombs will automatically fetch the dependecies of gr-rda, including the specific rfnoc-devel branch of UHD and gr-ettus. Be sure to check back though occasionally to see if anything failed. Remember, you can join our mailing list to contact us for support.

    If you have problems with your installation, here are some suggestions:

      The first time you run pybombs, it will ask you some options including a makewidth. Using multiple cores with Pybombs can sometimes create some compilations and installation errors of GNU Radio and it's dependencies, so just use a makewidth of 1.
      Sometimes GNURadio is not able to find the UHD tools. Try reinstalling UHD and rebuilding GNU Radio again. Sometimes it just works the 2nd time.
      The rda-cc-apps pybombs recipe sometimes fails. Change directory into the pybombs/src/rda-cc-apps directory and try a manual CMAKE. This will fail, which is okay. Then go back out and try pybombs again. This should work.

    If that was successful, then congradulations! But, we're not quite done yet. To create your own custom RFNoC blocks we recommend building all of your components with our helpful Component Creation Template that serves as an environment for component creation. This is a git repo you can clone, but place it outside of the PyBombs directory structure.

      git clone

    Now you've downloaded everything. The next step is setting up your environment. Pybombs makes this easy. Go back to your pybombs directory and run

      ./pybombs env

    This generates a script in the pybombs target directory

    The gr-rda O-o-T module also requires you to set some seperate environment variables that didn't fit quite right into the normal Pybombs environment setup. An example of these setting these variables can be found in target/share/gr-rda/examples/ These variables are:

      CL_WORKDIR = defined directory where runtime assembly can work. Sending data to and from the server and building things for you.
      RDA_LIB_ROOT = this should point to your Client Component Template.
      PYBOMBS_ROOT = pybombs root, the directory where you cloned pybombs.

    That's it for installation. Next verify that all packages and repositories are installed properly. To test the JTAG downloader, go to the Hardware Sanity Check

    Finally, before you can actually use the service in GNU Radio, you need to register for a Consolidated Logic account.

    Create a project for the USRP X310 and download your Keyfile for the project. This is required for using the cloud application. Detailed instructions on this process can be found here.

    That's all. If the installation was successful you're on to creating your first design.

    Join the Consolidated Logic Mailing List

    Be the first to find out about the new and exciting capabilities yet to come!