SOURCEFORGE » RALF

h1. UHD and GNURadio installation

On one hand, the UHD(Universal Hardware Driver) driver is necessary in order to communicate with an USRP(Universal Software Radio Peripheral) device. On the other hand, the development environment GNURadio is also recommended in order to provide several signal processing building blocks operating in a pseudo-real-time fashion.

This documentation explains how to install both "UHD":http://code.ettus.com/redmine/ettus/projects/uhd/wiki and "GNURadio":http://gnuradio.org from the sources with the help of the "PyBombs":http://gnuradio.org/redmine/projects/pybombs/wiki script. The following prerequisites are assumed in the following:

* a GNU/Linux operating system ;

* a user account with administror rights (through sudo) ;

* an Internet connection (if necessary, set @http_proxy@ and @https_proxy@ environment variables appropriately).

h2. Downloading and configuring PyBombs

Installing and updating PIP

<pre>

sudo apt-get install python-pip

sudo pip install -U pip

sudo pip install PyBOMBS

</pre>

Installing PyBOMBS

<pre>

sudo pip install PyBOMBS

</pre>

Initiating the default prefix

<pre>

sudo pybombs prefix init /usr/local -a usrlocal

sudo pybombs config default_prefix /usr/local

</pre>

Adding recipes

<pre>

sudo pybombs recipes add gr-recipes git+https://github.com/gnuradio/gr-recipes.git

sudo pybombs recipes add gr-etcetera git+https://github.com/gnuradio/gr-etcetera.git

</pre>

Installing UHD, GNURadio and other packages

<pre>

sudo pybombs install uhd gnuradio

sudo ldconfig

</pre>

h2. UHD configuration

h3. Update the firmware database

In order to make sure that the firmwares are up-to-date, you can run the following instruction.

<pre>

sudo "/usr/local/lib/uhd/utils/uhd_images_downloader.py"

</pre>

h3. Setting up real-time scheduling

Since the UHD needs a high priority of execution, it is recommended to add the following line to @/etc/security/limits.conf@.

<pre>

@usrp            -       rtprio          99

</pre>

Hence, it necessary to create the group @usrp@ and add to this group any user willing to use the USRP hardware.

<pre>

sudo groupadd usrp

sudo adduser <my-login> usrp

</pre>

At this time, the user shall close and reopen his session. Inside a shell, he can also issue the following instruction

<pre>

su - <my-login>

</pre>

The system is now ready for adding an USRP (see documentation for the appropriate model...).